Bindings/interconnect/qcom,sc7180.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,sc7180.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title:  Qualcomm SC7180 Network-On-Chip Interconnect
   8
   9 maintainers:
  10   - Odelu Kukatla <okukatla@codeaurora.org>
  11
  12 description: |
  13    SC7180 interconnect providers support system bandwidth requirements through
  14    RPMh hardware accelerators known as Bus Clock Manager (BCM). The provider is
  15    able to communicate with the BCM through the Resource State Coordinator (RSC)
  16    associated with each execution environment. Provider nodes must point to at
  17    least one RPMh device child node pertaining to their RSC and each provider
  18    can map to multiple RPMh resources.
  19
  20 properties:
  21   reg:
  22     maxItems: 1
  23
  24   compatible:
  25     enum:
  26       - qcom,sc7180-aggre1-noc
  27       - qcom,sc7180-aggre2-noc
  28       - qcom,sc7180-camnoc-virt
  29       - qcom,sc7180-compute-noc
  30       - qcom,sc7180-config-noc
  31       - qcom,sc7180-dc-noc
  32       - qcom,sc7180-gem-noc
  33       - qcom,sc7180-ipa-virt
  34       - qcom,sc7180-mc-virt
  35       - qcom,sc7180-mmss-noc
  36       - qcom,sc7180-npu-noc
  37       - qcom,sc7180-qup-virt
  38       - qcom,sc7180-system-noc
  39
  40   '#interconnect-cells':
  41     const: 1
  42
  43   qcom,bcm-voters:
  44     $ref: /schemas/types.yaml#/definitions/phandle-array
  45     description: |
  46       List of phandles to qcom,bcm-voter nodes that are required by
  47       this interconnect to send RPMh commands.
  48
  49   qcom,bcm-voter-names:
  50     $ref: /schemas/types.yaml#/definitions/string-array
  51     description: |
  52       Names for each of the qcom,bcm-voters specified.
  53
  54 required:
  55   - compatible
  56   - reg
  57   - '#interconnect-cells'
  58   - qcom,bcm-voters
  59
  60 additionalProperties: false
  61
  62 examples:
  63   - |
  64       #include <dt-bindings/interconnect/qcom,sc7180.h>
  65
  66       config_noc: interconnect@1500000 {
  67             compatible = "qcom,sc7180-config-noc";
  68             reg = <0x01500000 0x28000>;
  69             #interconnect-cells = <1>;
  70             qcom,bcm-voters = <&apps_bcm_voter>;
  71       };
  72
  73       system_noc: interconnect@1620000 {
  74             compatible = "qcom,sc7180-system-noc";
  75             reg = <0x01620000 0x17080>;
  76             #interconnect-cells = <1>;
  77             qcom,bcm-voters = <&apps_bcm_voter>;
  78       };
  79
  80       mmss_noc: interconnect@1740000 {
  81             compatible = "qcom,sc7180-mmss-noc";
  82             reg = <0x01740000 0x1c100>;
  83             #interconnect-cells = <1>;
  84             qcom,bcm-voters = <&apps_bcm_voter>;
  85       };