Documentation/devicetree/bindings/interconnect/qcom,rpmh.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/interconnect/qcom,rpmh.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Qualcomm RPMh Network-On-Chip Interconnect
   8
   9 maintainers:
  10   - Georgi Djakov <georgi.djakov@linaro.org>
  11   - Odelu Kukatla <okukatla@codeaurora.org>
  12
  13 description: |
  14    RPMh interconnect providers support system bandwidth requirements through
  15    RPMh hardware accelerators known as Bus Clock Manager (BCM). The provider is
  16    able to communicate with the BCM through the Resource State Coordinator (RSC)
  17    associated with each execution environment. Provider nodes must point to at
  18    least one RPMh device child node pertaining to their RSC and each provider
  19    can map to multiple RPMh resources.
  20
  21 properties:
  22   reg:
  23     maxItems: 1
  24
  25   compatible:
  26     enum:
  27       - qcom,sc7180-aggre1-noc
  28       - qcom,sc7180-aggre2-noc
  29       - qcom,sc7180-camnoc-virt
  30       - qcom,sc7180-compute-noc
  31       - qcom,sc7180-config-noc
  32       - qcom,sc7180-dc-noc
  33       - qcom,sc7180-gem-noc
  34       - qcom,sc7180-ipa-virt
  35       - qcom,sc7180-mc-virt
  36       - qcom,sc7180-mmss-noc
  37       - qcom,sc7180-npu-noc
  38       - qcom,sc7180-qup-virt
  39       - qcom,sc7180-system-noc
  40       - qcom,sc7280-aggre1-noc
  41       - qcom,sc7280-aggre2-noc
  42       - qcom,sc7280-clk-virt
  43       - qcom,sc7280-cnoc2
  44       - qcom,sc7280-cnoc3
  45       - qcom,sc7280-dc-noc
  46       - qcom,sc7280-gem-noc
  47       - qcom,sc7280-lpass-ag-noc
  48       - qcom,sc7280-mc-virt
  49       - qcom,sc7280-mmss-noc
  50       - qcom,sc7280-nsp-noc
  51       - qcom,sc7280-system-noc
  52       - qcom,sdm845-aggre1-noc
  53       - qcom,sdm845-aggre2-noc
  54       - qcom,sdm845-config-noc
  55       - qcom,sdm845-dc-noc
  56       - qcom,sdm845-gladiator-noc
  57       - qcom,sdm845-mem-noc
  58       - qcom,sdm845-mmss-noc
  59       - qcom,sdm845-system-noc
  60       - qcom,sdx55-ipa-virt
  61       - qcom,sdx55-mc-virt
  62       - qcom,sdx55-mem-noc
  63       - qcom,sdx55-system-noc
  64       - qcom,sm8150-aggre1-noc
  65       - qcom,sm8150-aggre2-noc
  66       - qcom,sm8150-camnoc-noc
  67       - qcom,sm8150-compute-noc
  68       - qcom,sm8150-config-noc
  69       - qcom,sm8150-dc-noc
  70       - qcom,sm8150-gem-noc
  71       - qcom,sm8150-ipa-virt
  72       - qcom,sm8150-mc-virt
  73       - qcom,sm8150-mmss-noc
  74       - qcom,sm8150-system-noc
  75       - qcom,sm8250-aggre1-noc
  76       - qcom,sm8250-aggre2-noc
  77       - qcom,sm8250-compute-noc
  78       - qcom,sm8250-config-noc
  79       - qcom,sm8250-dc-noc
  80       - qcom,sm8250-gem-noc
  81       - qcom,sm8250-ipa-virt
  82       - qcom,sm8250-mc-virt
  83       - qcom,sm8250-mmss-noc
  84       - qcom,sm8250-npu-noc
  85       - qcom,sm8250-system-noc
  86       - qcom,sm8350-aggre1-noc
  87       - qcom,sm8350-aggre2-noc
  88       - qcom,sm8350-config-noc
  89       - qcom,sm8350-dc-noc
  90       - qcom,sm8350-gem-noc
  91       - qcom,sm8350-lpass-ag-noc
  92       - qcom,sm8350-mc-virt
  93       - qcom,sm8350-mmss-noc
  94       - qcom,sm8350-compute-noc
  95       - qcom,sm8350-system-noc
  96
  97   '#interconnect-cells':
  98     enum: [ 1, 2 ]
  99
 100   qcom,bcm-voters:
 101     $ref: /schemas/types.yaml#/definitions/phandle-array
 102     description: |
 103       List of phandles to qcom,bcm-voter nodes that are required by
 104       this interconnect to send RPMh commands.
 105
 106   qcom,bcm-voter-names:
 107     description: |
 108       Names for each of the qcom,bcm-voters specified.
 109
 110 required:
 111   - compatible
 112   - reg
 113   - '#interconnect-cells'
 114   - qcom,bcm-voters
 115
 116 additionalProperties: false
 117
 118 examples:
 119   - |
 120       #include <dt-bindings/interconnect/qcom,sdm845.h>
 121
 122       mem_noc: interconnect@1380000 {
 123              compatible = "qcom,sdm845-mem-noc";
 124              reg = <0x01380000 0x27200>;
 125              #interconnect-cells = <1>;
 126              qcom,bcm-voters = <&apps_bcm_voter>;
 127       };
 128
 129       mmss_noc: interconnect@1740000 {
 130              compatible = "qcom,sdm845-mmss-noc";
 131              reg = <0x01740000 0x1c1000>;
 132              #interconnect-cells = <1>;
 133              qcom,bcm-voter-names = "apps", "disp";
 134              qcom,bcm-voters = <&apps_bcm_voter>, <&disp_bcm_voter>;
 135       };