xref: /linux/Documentation/devicetree/bindings/soundwire/qcom,soundwire.yaml (revision 0ea5c948cb64bab5bc7a5516774eb8536f05aa0d)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/soundwire/qcom,soundwire.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Qualcomm SoundWire Controller
8
9maintainers:
10  - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
11  - Srinivasa Rao Mandadapu <quic_srivasam@quicinc.com>
12
13description:
14  The Qualcomm SoundWire controller along with its board specific bus parameters.
15
16properties:
17  compatible:
18    enum:
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
25
26  reg:
27    maxItems: 1
28
29  interrupts:
30    minItems: 1
31    items:
32      - description: specify the SoundWire controller core.
33      - description: specify the Soundwire controller wake IRQ.
34
35  interrupt-names:
36    minItems: 1
37    items:
38      - const: core
39      - const: wakeup
40
41  clocks:
42    items:
43      - description: iface clock
44
45  clock-names:
46    items:
47      - const: iface
48
49  resets:
50    items:
51      - description: SWR_AUDIO_CGCR RESET
52
53  reset-names:
54    items:
55      - const: swr_audio_cgcr
56
57  '#sound-dai-cells':
58    const: 1
59
60  '#address-cells':
61    const: 2
62
63  '#size-cells':
64    const: 0
65
66  wakeup-source: true
67
68  qcom,din-ports:
69    $ref: /schemas/types.yaml#/definitions/uint32
70    description: count of data in ports
71
72  qcom,dout-ports:
73    $ref: /schemas/types.yaml#/definitions/uint32
74    description: count of data out ports
75
76  qcom,ports-word-length:
77    $ref: /schemas/types.yaml#/definitions/uint8-array
78    description:
79      Size of payload channel sample.
80      Value of 0xff indicates that this option is not implemented
81      or applicable for the respective data port.
82      More info in MIPI Alliance SoundWire 1.0 Specifications.
83    minItems: 3
84    maxItems: 16
85
86  qcom,ports-sinterval-low:
87    $ref: /schemas/types.yaml#/definitions/uint8-array
88    description:
89      Sample interval (only lowest byte) of each data port.
90      Out ports followed by In ports. Used for Sample Interval calculation.
91      Value of 0xff indicates that this option is not implemented
92      or applicable for the respective data port.
93      More info in MIPI Alliance SoundWire 1.0 Specifications.
94    minItems: 3
95    maxItems: 16
96
97  qcom,ports-sinterval:
98    $ref: /schemas/types.yaml#/definitions/uint16-array
99    description:
100      Sample interval of each data port.
101      Out ports followed by In ports. Used for Sample Interval calculation.
102      Value of 0xffff indicates that this option is not implemented
103      or applicable for the respective data port.
104      More info in MIPI Alliance SoundWire 1.0 Specifications.
105    minItems: 3
106    maxItems: 16
107
108  qcom,ports-offset1:
109    $ref: /schemas/types.yaml#/definitions/uint8-array
110    description:
111      Payload transport window offset1 of each data port.
112      Out ports followed by In ports.
113      Value of 0xff indicates that this option is not implemented
114      or applicable for the respective data port.
115      More info in MIPI Alliance SoundWire 1.0 Specifications.
116    minItems: 3
117    maxItems: 16
118
119  qcom,ports-offset2:
120    $ref: /schemas/types.yaml#/definitions/uint8-array
121    description:
122      Payload transport window offset2 of each data port.
123      Out ports followed by In ports.
124      Value of 0xff indicates that this option is not implemented
125      or applicable for the respective data port.
126      More info in MIPI Alliance SoundWire 1.0 Specifications.
127    minItems: 3
128    maxItems: 16
129
130  qcom,ports-lane-control:
131    $ref: /schemas/types.yaml#/definitions/uint8-array
132    description:
133      Identify which data lane the data port uses.
134      Out ports followed by In ports.
135      Value of 0xff indicates that this option is not implemented
136      or applicable for the respective data port.
137      More info in MIPI Alliance SoundWire 1.0 Specifications.
138    minItems: 3
139    maxItems: 16
140
141  qcom,ports-block-pack-mode:
142    $ref: /schemas/types.yaml#/definitions/uint8-array
143    description:
144      Indicate the block packing mode.
145      0 to indicate Blocks are per Channel
146      1 to indicate Blocks are per Port.
147      Out ports followed by In ports.
148      Value of 0xff indicates that this option is not implemented
149      or applicable for the respective data port.
150      More info in MIPI Alliance SoundWire 1.0 Specifications.
151    minItems: 3
152    maxItems: 16
153    items:
154      oneOf:
155        - minimum: 0
156          maximum: 1
157        - const: 0xff
158
159  qcom,ports-hstart:
160    $ref: /schemas/types.yaml#/definitions/uint8-array
161    description:
162      Identifying lowerst numbered column in SoundWire Frame,
163      i.e. left edge of the Transport sub-frame for each port.
164      Out ports followed by In ports.
165      Value of 0xff indicates that this option is not implemented
166      or applicable for the respective data port.
167      More info in MIPI Alliance SoundWire 1.0 Specifications.
168    minItems: 3
169    maxItems: 16
170    items:
171      oneOf:
172        - minimum: 0
173          maximum: 15
174        - const: 0xff
175
176  qcom,ports-hstop:
177    $ref: /schemas/types.yaml#/definitions/uint8-array
178    description:
179      Identifying highest numbered column in SoundWire Frame,
180      i.e. the right edge of the Transport
181      sub-frame for each port. Out ports followed by In ports.
182      Value of 0xff indicates that this option is not implemented
183      or applicable for the respective data port.
184      More info in MIPI Alliance SoundWire 1.0 Specifications.
185    minItems: 3
186    maxItems: 16
187    items:
188      oneOf:
189        - minimum: 0
190          maximum: 15
191        - const: 0xff
192
193  qcom,ports-block-group-count:
194    $ref: /schemas/types.yaml#/definitions/uint8-array
195    description:
196      In range 1 to 4 to indicate how many sample intervals are combined
197      into a payload. Out ports followed by In ports.
198      Value of 0xff indicates that this option is not implemented
199      or applicable for the respective data port.
200      More info in MIPI Alliance SoundWire 1.0 Specifications.
201    minItems: 3
202    maxItems: 16
203    items:
204      oneOf:
205        - minimum: 0
206          maximum: 4
207        - const: 0xff
208
209  label:
210    maxItems: 1
211
212required:
213  - compatible
214  - reg
215  - interrupts
216  - clocks
217  - clock-names
218  - '#sound-dai-cells'
219  - '#address-cells'
220  - '#size-cells'
221  - qcom,dout-ports
222  - qcom,din-ports
223  - qcom,ports-offset1
224  - qcom,ports-offset2
225
226oneOf:
227  - required:
228      - qcom,ports-sinterval-low
229  - required:
230      - qcom,ports-sinterval
231
232allOf:
233  - $ref: soundwire-controller.yaml#
234
235unevaluatedProperties: false
236
237examples:
238  - |
239    #include <dt-bindings/interrupt-controller/arm-gic.h>
240    #include <dt-bindings/interrupt-controller/irq.h>
241    #include <dt-bindings/clock/qcom,lpassaudiocc-sc7280.h>
242
243    soundwire@3210000 {
244        compatible = "qcom,soundwire-v1.6.0";
245        reg = <0x03210000 0x2000>;
246
247        interrupts = <GIC_SPI 155 IRQ_TYPE_LEVEL_HIGH>,
248                     <&pdc 130 IRQ_TYPE_LEVEL_HIGH>;
249
250        interrupt-names = "core", "wakeup";
251
252        clocks = <&lpass_rx_macro>;
253        clock-names = "iface";
254
255        qcom,din-ports = <0>;
256        qcom,dout-ports = <5>;
257
258        resets = <&lpass_audiocc LPASS_AUDIO_SWR_RX_CGCR>;
259        reset-names = "swr_audio_cgcr";
260
261        qcom,ports-word-length =        /bits/ 8 <0x01 0x07 0x04 0xff 0xff>;
262        qcom,ports-sinterval-low =      /bits/ 8 <0x03 0x3f 0x1f 0x03 0x03>;
263        qcom,ports-offset1 =            /bits/ 8 <0x00 0x00 0x0b 0x01 0x01>;
264        qcom,ports-offset2 =            /bits/ 8 <0x00 0x00 0x0b 0x00 0x00>;
265        qcom,ports-lane-control =       /bits/ 8 <0x01 0x00 0x00 0x00 0x00>;
266        qcom,ports-block-pack-mode =    /bits/ 8 <0xff 0x00 0x01 0xff 0xff>;
267        qcom,ports-hstart =             /bits/ 8 <0xff 0x03 0xff 0xff 0xff>;
268        qcom,ports-hstop =              /bits/ 8 <0xff 0x06 0xff 0xff 0xff>;
269        qcom,ports-block-group-count =  /bits/ 8 <0xff 0xff 0xff 0xff 0x00>;
270
271        #sound-dai-cells = <1>;
272        #address-cells = <2>;
273        #size-cells = <0>;
274
275        codec@0,4 {
276            compatible = "sdw20217010d00";
277            reg = <0 4>;
278            qcom,rx-port-mapping = <1 2 3 4 5>;
279        };
280    };
281