Documentation/devicetree/bindings/interconnect/qcom,sdm845.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,sdm845.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title:  Qualcomm SDM845 Network-On-Chip Interconnect
   8
   9 maintainers:
  10   - Georgi Djakov <georgi.djakov@linaro.org>
  11
  12 description: |
  13    SDM845 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,sdm845-aggre1-noc
  27       - qcom,sdm845-aggre2-noc
  28       - qcom,sdm845-config-noc
  29       - qcom,sdm845-dc-noc
  30       - qcom,sdm845-gladiator-noc
  31       - qcom,sdm845-mem-noc
  32       - qcom,sdm845-mmss-noc
  33       - qcom,sdm845-system-noc
  34
  35   '#interconnect-cells':
  36     const: 1
  37
  38   qcom,bcm-voters:
  39     $ref: /schemas/types.yaml#/definitions/phandle-array
  40     description: |
  41       List of phandles to qcom,bcm-voter nodes that are required by
  42       this interconnect to send RPMh commands.
  43
  44   qcom,bcm-voter-names:
  45     $ref: /schemas/types.yaml#/definitions/string-array
  46     description: |
  47       Names for each of the qcom,bcm-voters specified.
  48
  49 required:
  50   - compatible
  51   - reg
  52   - '#interconnect-cells'
  53   - qcom,bcm-voters
  54
  55 additionalProperties: false
  56
  57 examples:
  58   - |
  59       #include <dt-bindings/interconnect/qcom,sdm845.h>
  60
  61       mem_noc: interconnect@1380000 {
  62              compatible = "qcom,sdm845-mem-noc";
  63              reg = <0 0x01380000 0 0x27200>;
  64              #interconnect-cells = <1>;
  65              qcom,bcm-voters = <&apps_bcm_voter>;
  66       };
  67
  68       mmss_noc: interconnect@1740000 {
  69              compatible = "qcom,sdm845-mmss-noc";
  70              reg = <0 0x01740000 0 0x1c1000>;
  71              #interconnect-cells = <1>;
  72              qcom,bcm-voter-names = "apps", "disp";
  73              qcom,bcm-voters = <&apps_bcm_voter>, <&disp_bcm_voter>;
  74       };