bindings/soundwire/qcom%2Csoundwire.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
11   - Srinivasa Rao Mandadapu <quic_srivasam@quicinc.com>
19       - qcom,soundwire-v1.3.0
20       - qcom,soundwire-v1.5.0
21       - qcom,soundwire-v1.5.1
22       - qcom,soundwire-v1.6.0
23       - qcom,soundwire-v1.7.0
24       - qcom,soundwire-v2.0.0
32       - description: specify the SoundWire controller core.
33       - description: specify the Soundwire controller wake IRQ.
35   interrupt-names:
38       - const: core
39       - const: wakeup
43       - description: iface clock
45   clock-names:
47       - const: iface
51       - description: SWR_AUDIO_CGCR RESET
53   reset-names:
55       - const: swr_audio_cgcr
57   '#sound-dai-cells':
60   '#address-cells':
63   '#size-cells':
66   wakeup-source: true
68   qcom,din-ports:
70     description: count of data in ports
72   qcom,dout-ports:
74     description: count of data out ports
76   qcom,ports-word-length:
77     $ref: /schemas/types.yaml#/definitions/uint8-array
86   qcom,ports-sinterval-low:
87     $ref: /schemas/types.yaml#/definitions/uint8-array
90       Out ports followed by In ports. Used for Sample Interval calculation.
97   qcom,ports-sinterval:
98     $ref: /schemas/types.yaml#/definitions/uint16-array
101       Out ports followed by In ports. Used for Sample Interval calculation.
108   qcom,ports-offset1:
109     $ref: /schemas/types.yaml#/definitions/uint8-array
112       Out ports followed by In ports.
119   qcom,ports-offset2:
120     $ref: /schemas/types.yaml#/definitions/uint8-array
122       Payload transport window offset2 of each data port.
123       Out ports followed by In ports.
130   qcom,ports-lane-control:
131     $ref: /schemas/types.yaml#/definitions/uint8-array
134       Out ports followed by In ports.
141   qcom,ports-block-pack-mode:
142     $ref: /schemas/types.yaml#/definitions/uint8-array
147       Out ports followed by In ports.
155         - minimum: 0
157         - const: 0xff
159   qcom,ports-hstart:
160     $ref: /schemas/types.yaml#/definitions/uint8-array
163       i.e. left edge of the Transport sub-frame for each port.
164       Out ports followed by In ports.
172         - minimum: 0
174         - const: 0xff
176   qcom,ports-hstop:
177     $ref: /schemas/types.yaml#/definitions/uint8-array
181       sub-frame for each port. Out ports followed by In ports.
189         - minimum: 0
191         - const: 0xff
193   qcom,ports-block-group-count:
194     $ref: /schemas/types.yaml#/definitions/uint8-array
197       into a payload. Out ports followed by In ports.
205         - minimum: 0
207         - const: 0xff
213   "^.*@[0-9a-f],[0-9a-f]$":
221         pattern: "^sdw[0-9a-f]{1}[0-9a-f]{4}[0-9a-f]{4}[0-9a-f]{2}$"
224   - compatible
225   - reg
226   - interrupts
227   - clocks
228   - clock-names
229   - '#sound-dai-cells'
230   - '#address-cells'
231   - '#size-cells'
232   - qcom,dout-ports
233   - qcom,din-ports
234   - qcom,ports-offset1
235   - qcom,ports-offset2
238   - required:
239       - qcom,ports-sinterval-low
240   - required:
241       - qcom,ports-sinterval
246   - |
247     #include <dt-bindings/interrupt-controller/arm-gic.h>
248     #include <dt-bindings/interrupt-controller/irq.h>
249     #include <dt-bindings/clock/qcom,lpassaudiocc-sc7280.h>
252         compatible = "qcom,soundwire-v1.6.0";
258         interrupt-names = "core", "wakeup";
261         clock-names = "iface";
263         qcom,din-ports = <0>;
264         qcom,dout-ports = <5>;
267         reset-names = "swr_audio_cgcr";
269         qcom,ports-word-length =        /bits/ 8 <0x01 0x07 0x04 0xff 0xff>;
270         qcom,ports-sinterval-low =      /bits/ 8 <0x03 0x3f 0x1f 0x03 0x03>;
271         qcom,ports-offset1 =            /bits/ 8 <0x00 0x00 0x0b 0x01 0x01>;
272         qcom,ports-offset2 =            /bits/ 8 <0x00 0x00 0x0b 0x00 0x00>;
273         qcom,ports-lane-control =       /bits/ 8 <0x01 0x00 0x00 0x00 0x00>;
274         qcom,ports-block-pack-mode =    /bits/ 8 <0xff 0x00 0x01 0xff 0xff>;
275         qcom,ports-hstart =             /bits/ 8 <0xff 0x03 0xff 0xff 0xff>;
276         qcom,ports-hstop =              /bits/ 8 <0xff 0x06 0xff 0xff 0xff>;
277         qcom,ports-block-group-count =  /bits/ 8 <0xff 0xff 0xff 0xff 0x00>;
279         #sound-dai-cells = <1>;
280         #address-cells = <2>;
281         #size-cells = <0>;
286             qcom,rx-port-mapping = <1 2 3 4 5>;