Documentation/devicetree/bindings/clock/qcom,sc7280-lpasscorecc.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/clock/qcom,sc7280-lpasscorecc.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Qualcomm LPASS Core & Audio Clock Controller Binding for SC7280
   8
   9 maintainers:
  10   - Taniya Das <tdas@codeaurora.org>
  11
  12 description: |
  13   Qualcomm LPASS core and audio clock control module which supports the
  14   clocks and power domains on SC7280.
  15
  16   See also:
  17   - dt-bindings/clock/qcom,lpasscorecc-sc7280.h
  18   - dt-bindings/clock/qcom,lpassaudiocc-sc7280.h
  19
  20 properties:
  21   clocks: true
  22
  23   clock-names: true
  24
  25   compatible:
  26     enum:
  27       - qcom,sc7280-lpassaoncc
  28       - qcom,sc7280-lpassaudiocc
  29       - qcom,sc7280-lpasscorecc
  30       - qcom,sc7280-lpasshm
  31
  32   power-domains:
  33     maxItems: 1
  34
  35   '#clock-cells':
  36     const: 1
  37
  38   '#power-domain-cells':
  39     const: 1
  40
  41   reg:
  42     maxItems: 1
  43
  44   qcom,adsp-pil-mode:
  45     description:
  46       Indicates if the LPASS would be brought out of reset using
  47       peripheral loader.
  48     type: boolean
  49
  50 required:
  51   - compatible
  52   - reg
  53   - clocks
  54   - clock-names
  55   - '#clock-cells'
  56   - '#power-domain-cells'
  57
  58 additionalProperties: false
  59
  60 allOf:
  61   - if:
  62       properties:
  63         compatible:
  64           contains:
  65             const: qcom,sc7280-lpassaudiocc
  66
  67     then:
  68       properties:
  69         clocks:
  70           items:
  71             - description: Board XO source
  72             - description: LPASS_AON_CC_MAIN_RCG_CLK_SRC
  73
  74         clock-names:
  75           items:
  76             - const: bi_tcxo
  77             - const: lpass_aon_cc_main_rcg_clk_src
  78   - if:
  79       properties:
  80         compatible:
  81           contains:
  82             enum:
  83               - qcom,sc7280-lpassaoncc
  84
  85     then:
  86       properties:
  87         clocks:
  88           items:
  89             - description: Board XO source
  90             - description: Board XO active only source
  91             - description: LPASS_AON_CC_MAIN_RCG_CLK_SRC
  92
  93         clock-names:
  94           items:
  95             - const: bi_tcxo
  96             - const: bi_tcxo_ao
  97             - const: iface
  98
  99   - if:
 100       properties:
 101         compatible:
 102           contains:
 103             enum:
 104               - qcom,sc7280-lpasshm
 105               - qcom,sc7280-lpasscorecc
 106
 107     then:
 108       properties:
 109         clocks:
 110           items:
 111             - description: Board XO source
 112
 113         clock-names:
 114           items:
 115             - const: bi_tcxo
 116
 117 examples:
 118   - |
 119     #include <dt-bindings/clock/qcom,rpmh.h>
 120     #include <dt-bindings/clock/qcom,gcc-sc7280.h>
 121     #include <dt-bindings/clock/qcom,lpassaudiocc-sc7280.h>
 122     #include <dt-bindings/clock/qcom,lpasscorecc-sc7280.h>
 123     lpass_audiocc: clock-controller@3300000 {
 124       compatible = "qcom,sc7280-lpassaudiocc";
 125       reg = <0x3300000 0x30000>;
 126       clocks = <&rpmhcc RPMH_CXO_CLK>,
 127                <&lpass_aon LPASS_AON_CC_MAIN_RCG_CLK_SRC>;
 128       clock-names = "bi_tcxo", "lpass_aon_cc_main_rcg_clk_src";
 129       power-domains = <&lpass_aon LPASS_AON_CC_LPASS_AUDIO_HM_GDSC>;
 130       #clock-cells = <1>;
 131       #power-domain-cells = <1>;
 132     };
 133
 134   - |
 135     #include <dt-bindings/clock/qcom,rpmh.h>
 136     #include <dt-bindings/clock/qcom,gcc-sc7280.h>
 137     #include <dt-bindings/clock/qcom,lpassaudiocc-sc7280.h>
 138     #include <dt-bindings/clock/qcom,lpasscorecc-sc7280.h>
 139     lpass_hm: clock-controller@3c00000 {
 140       compatible = "qcom,sc7280-lpasshm";
 141       reg = <0x3c00000 0x28>;
 142       clocks = <&rpmhcc RPMH_CXO_CLK>;
 143       clock-names = "bi_tcxo";
 144       #clock-cells = <1>;
 145       #power-domain-cells = <1>;
 146     };
 147
 148   - |
 149     #include <dt-bindings/clock/qcom,rpmh.h>
 150     #include <dt-bindings/clock/qcom,gcc-sc7280.h>
 151     #include <dt-bindings/clock/qcom,lpassaudiocc-sc7280.h>
 152     #include <dt-bindings/clock/qcom,lpasscorecc-sc7280.h>
 153     lpasscore: clock-controller@3900000 {
 154       compatible = "qcom,sc7280-lpasscorecc";
 155       reg = <0x3900000 0x50000>;
 156       clocks = <&rpmhcc RPMH_CXO_CLK>;
 157       clock-names = "bi_tcxo";
 158       power-domains = <&lpass_hm LPASS_CORE_CC_LPASS_CORE_HM_GDSC>;
 159       #clock-cells = <1>;
 160       #power-domain-cells = <1>;
 161     };
 162
 163   - |
 164     #include <dt-bindings/clock/qcom,rpmh.h>
 165     #include <dt-bindings/clock/qcom,gcc-sc7280.h>
 166     #include <dt-bindings/clock/qcom,lpassaudiocc-sc7280.h>
 167     #include <dt-bindings/clock/qcom,lpasscorecc-sc7280.h>
 168     lpass_aon: clock-controller@3380000 {
 169       compatible = "qcom,sc7280-lpassaoncc";
 170       reg = <0x3380000 0x30000>;
 171       clocks = <&rpmhcc RPMH_CXO_CLK>, <&rpmhcc RPMH_CXO_CLK_A>,
 172                <&lpasscore LPASS_CORE_CC_CORE_CLK>;
 173       clock-names = "bi_tcxo", "bi_tcxo_ao","iface";
 174       qcom,adsp-pil-mode;
 175       #clock-cells = <1>;
 176       #power-domain-cells = <1>;
 177     };
 178
 179 ...