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,sc8180x-aggre1-noc
  53       - qcom,sc8180x-aggre2-noc
  54       - qcom,sc8180x-camnoc-virt
  55       - qcom,sc8180x-compute-noc
  56       - qcom,sc8180x-config-noc
  57       - qcom,sc8180x-dc-noc
  58       - qcom,sc8180x-gem-noc
  59       - qcom,sc8180x-ipa-virt
  60       - qcom,sc8180x-mc-virt
  61       - qcom,sc8180x-mmss-noc
  62       - qcom,sc8180x-system-noc
  63       - qcom,sdm845-aggre1-noc
  64       - qcom,sdm845-aggre2-noc
  65       - qcom,sdm845-config-noc
  66       - qcom,sdm845-dc-noc
  67       - qcom,sdm845-gladiator-noc
  68       - qcom,sdm845-mem-noc
  69       - qcom,sdm845-mmss-noc
  70       - qcom,sdm845-system-noc
  71       - qcom,sdx55-ipa-virt
  72       - qcom,sdx55-mc-virt
  73       - qcom,sdx55-mem-noc
  74       - qcom,sdx55-system-noc
  75       - qcom,sm8150-aggre1-noc
  76       - qcom,sm8150-aggre2-noc
  77       - qcom,sm8150-camnoc-noc
  78       - qcom,sm8150-compute-noc
  79       - qcom,sm8150-config-noc
  80       - qcom,sm8150-dc-noc
  81       - qcom,sm8150-gem-noc
  82       - qcom,sm8150-ipa-virt
  83       - qcom,sm8150-mc-virt
  84       - qcom,sm8150-mmss-noc
  85       - qcom,sm8150-system-noc
  86       - qcom,sm8250-aggre1-noc
  87       - qcom,sm8250-aggre2-noc
  88       - qcom,sm8250-compute-noc
  89       - qcom,sm8250-config-noc
  90       - qcom,sm8250-dc-noc
  91       - qcom,sm8250-gem-noc
  92       - qcom,sm8250-ipa-virt
  93       - qcom,sm8250-mc-virt
  94       - qcom,sm8250-mmss-noc
  95       - qcom,sm8250-npu-noc
  96       - qcom,sm8250-system-noc
  97       - qcom,sm8350-aggre1-noc
  98       - qcom,sm8350-aggre2-noc
  99       - qcom,sm8350-config-noc
 100       - qcom,sm8350-dc-noc
 101       - qcom,sm8350-gem-noc
 102       - qcom,sm8350-lpass-ag-noc
 103       - qcom,sm8350-mc-virt
 104       - qcom,sm8350-mmss-noc
 105       - qcom,sm8350-compute-noc
 106       - qcom,sm8350-system-noc
 107
 108   '#interconnect-cells':
 109     enum: [ 1, 2 ]
 110
 111   qcom,bcm-voters:
 112     $ref: /schemas/types.yaml#/definitions/phandle-array
 113     description: |
 114       List of phandles to qcom,bcm-voter nodes that are required by
 115       this interconnect to send RPMh commands.
 116
 117   qcom,bcm-voter-names:
 118     description: |
 119       Names for each of the qcom,bcm-voters specified.
 120
 121 required:
 122   - compatible
 123   - reg
 124   - '#interconnect-cells'
 125   - qcom,bcm-voters
 126
 127 additionalProperties: false
 128
 129 examples:
 130   - |
 131       #include <dt-bindings/interconnect/qcom,sdm845.h>
 132
 133       mem_noc: interconnect@1380000 {
 134              compatible = "qcom,sdm845-mem-noc";
 135              reg = <0x01380000 0x27200>;
 136              #interconnect-cells = <1>;
 137              qcom,bcm-voters = <&apps_bcm_voter>;
 138       };
 139
 140       mmss_noc: interconnect@1740000 {
 141              compatible = "qcom,sdm845-mmss-noc";
 142              reg = <0x01740000 0x1c1000>;
 143              #interconnect-cells = <1>;
 144              qcom,bcm-voter-names = "apps", "disp";
 145              qcom,bcm-voters = <&apps_bcm_voter>, <&disp_bcm_voter>;
 146       };