Mention branches and keyring.
[releases.git] / bindings / pinctrl / qcom,sm8650-lpass-lpi-pinctrl.yaml
1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/pinctrl/qcom,sm8650-lpass-lpi-pinctrl.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Qualcomm SM8650 SoC LPASS LPI TLMM
8
9 maintainers:
10   - Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
11   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
12
13 description:
14   Top Level Mode Multiplexer pin controller in the Low Power Audio SubSystem
15   (LPASS) Low Power Island (LPI) of Qualcomm SM8650 SoC.
16
17 properties:
18   compatible:
19     const: qcom,sm8650-lpass-lpi-pinctrl
20
21   reg:
22     items:
23       - description: LPASS LPI TLMM Control and Status registers
24
25   clocks:
26     items:
27       - description: LPASS Core voting clock
28       - description: LPASS Audio voting clock
29
30   clock-names:
31     items:
32       - const: core
33       - const: audio
34
35 patternProperties:
36   "-state$":
37     oneOf:
38       - $ref: "#/$defs/qcom-sm8650-lpass-state"
39       - patternProperties:
40           "-pins$":
41             $ref: "#/$defs/qcom-sm8650-lpass-state"
42         additionalProperties: false
43
44 $defs:
45   qcom-sm8650-lpass-state:
46     type: object
47     description:
48       Pinctrl node's client devices use subnodes for desired pin configuration.
49       Client device subnodes use below standard properties.
50     $ref: qcom,lpass-lpi-common.yaml#/$defs/qcom-tlmm-state
51     unevaluatedProperties: false
52
53     properties:
54       pins:
55         description:
56           List of gpio pins affected by the properties specified in this
57           subnode.
58         items:
59           pattern: "^gpio([0-9]|1[0-9]|2[0-2])$"
60
61       function:
62         enum: [ dmic1_clk, dmic1_data, dmic2_clk, dmic2_data, dmic3_clk,
63                 dmic3_data, dmic4_clk, dmic4_data, ext_mclk1_a, ext_mclk1_b,
64                 ext_mclk1_c, ext_mclk1_d, ext_mclk1_e, gpio, i2s0_clk,
65                 i2s0_data, i2s0_ws, i2s1_clk, i2s1_data, i2s1_ws, i2s2_clk,
66                 i2s2_data, i2s2_ws, i2s3_clk, i2s3_data, i2s3_ws, i2s4_clk,
67                 i2s4_data, i2s4_ws, qca_swr_clk, qca_swr_data, slimbus_clk,
68                 slimbus_data, swr_rx_clk, swr_rx_data, swr_tx_clk, swr_tx_data,
69                 wsa_swr_clk, wsa_swr_data, wsa2_swr_clk, wsa2_swr_data ]
70         description:
71           Specify the alternative function to be configured for the specified
72           pins.
73
74 allOf:
75   - $ref: qcom,lpass-lpi-common.yaml#
76
77 required:
78   - compatible
79   - reg
80   - clocks
81   - clock-names
82
83 unevaluatedProperties: false
84
85 examples:
86   - |
87     #include <dt-bindings/sound/qcom,q6dsp-lpass-ports.h>
88
89     lpass_tlmm: pinctrl@6e80000 {
90         compatible = "qcom,sm8650-lpass-lpi-pinctrl";
91         reg = <0x06e80000 0x20000>;
92
93         clocks = <&q6prmcc LPASS_HW_MACRO_VOTE LPASS_CLK_ATTRIBUTE_COUPLE_NO>,
94                  <&q6prmcc LPASS_HW_DCODEC_VOTE LPASS_CLK_ATTRIBUTE_COUPLE_NO>;
95         clock-names = "core", "audio";
96
97         gpio-controller;
98         #gpio-cells = <2>;
99         gpio-ranges = <&lpass_tlmm 0 0 23>;
100
101         tx-swr-sleep-clk-state {
102             pins = "gpio0";
103             function = "swr_tx_clk";
104             drive-strength = <2>;
105             bias-pull-down;
106         };
107     };