xref: /freebsd/sys/contrib/device-tree/Bindings/sound/st,stm32-sai.yaml (revision 354d7675fe12ace9cde344cb79c7ded792802f88) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/sound/st,stm32-sai.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: STMicroelectronics STM32 Serial Audio Interface (SAI)
8
9maintainers:
10  - Olivier Moysan <olivier.moysan@st.com>
11
12description:
13  The SAI interface (Serial Audio Interface) offers a wide set of audio
14  protocols as I2S standards, LSB or MSB-justified, PCM/DSP, TDM, and AC'97.
15  The SAI contains two independent audio sub-blocks. Each sub-block has
16  its own clock generator and I/O lines controller.
17
18properties:
19  compatible:
20    enum:
21      - st,stm32f4-sai
22      - st,stm32h7-sai
23
24  reg:
25    items:
26      - description: Base address and size of SAI common register set.
27      - description: Base address and size of SAI identification register set.
28    minItems: 1
29
30  ranges:
31    maxItems: 1
32
33  interrupts:
34    maxItems: 1
35
36  resets:
37    maxItems: 1
38
39  "#address-cells":
40    const: 1
41
42  "#size-cells":
43    const: 1
44
45  clocks:
46    maxItems: 3
47
48  clock-names:
49    maxItems: 3
50
51required:
52  - compatible
53  - reg
54  - ranges
55  - "#address-cells"
56  - "#size-cells"
57  - clocks
58  - clock-names
59
60patternProperties:
61  "^audio-controller@[0-9a-f]+$":
62    type: object
63    description:
64      Two subnodes corresponding to SAI sub-block instances A et B
65      can be defined. Subnode can be omitted for unsused sub-block.
66
67    properties:
68      compatible:
69        description: Compatible for SAI sub-block A or B.
70        pattern: "st,stm32-sai-sub-[ab]"
71
72      "#sound-dai-cells":
73        const: 0
74
75      reg:
76        maxItems: 1
77
78      clocks:
79        items:
80          - description: sai_ck clock feeding the internal clock generator.
81          - description: MCLK clock from a SAI set as master clock provider.
82        minItems: 1
83
84      clock-names:
85        items:
86          - const: sai_ck
87          - const: MCLK
88        minItems: 1
89
90      dmas:
91        maxItems: 1
92
93      dma-names:
94        description: |
95          rx: SAI sub-block is configured as a capture DAI.
96          tx: SAI sub-block is configured as a playback DAI.
97        enum: [ rx, tx ]
98
99      st,sync:
100        description:
101          Configure the SAI sub-block as slave of another SAI sub-block.
102          By default SAI sub-block is in asynchronous mode.
103          Must contain the phandle and index of the SAI sub-block providing
104          the synchronization.
105        allOf:
106          - $ref: /schemas/types.yaml#/definitions/phandle-array
107          - maxItems: 1
108
109      st,iec60958:
110        description:
111          If set, support S/PDIF IEC6958 protocol for playback.
112          IEC60958 protocol is not available for capture.
113          By default, custom protocol is assumed, meaning that protocol is
114          configured according to protocol defined in related DAI link node,
115          such as i2s, left justified, right justified, dsp and pdm protocols.
116        allOf:
117          - $ref: /schemas/types.yaml#/definitions/flag
118
119      "#clock-cells":
120        description: Configure the SAI device as master clock provider.
121        const: 0
122
123    required:
124      - compatible
125      - "#sound-dai-cells"
126      - reg
127      - clocks
128      - clock-names
129      - dmas
130      - dma-names
131
132allOf:
133  - if:
134      properties:
135        compatible:
136          contains:
137            const: st,stm32f4-sai
138
139  - then:
140      properties:
141        clocks:
142          items:
143            - description: x8k, SAI parent clock for sampling rates multiple of 8kHz.
144            - description: x11k, SAI parent clock for sampling rates multiple of 11.025kHz.
145
146        clock-names:
147          items:
148            - const: x8k
149            - const: x11k
150
151  - else:
152      properties:
153        clocks:
154          items:
155            - description: pclk feeds the peripheral bus interface.
156            - description: x8k, SAI parent clock for sampling rates multiple of 8kHz.
157            - description: x11k, SAI parent clock for sampling rates multiple of 11.025kHz.
158
159        clock-names:
160          items:
161            - const: pclk
162            - const: x8k
163            - const: x11k
164
165additionalProperties: false
166
167examples:
168  - |
169    #include <dt-bindings/interrupt-controller/arm-gic.h>
170    #include <dt-bindings/clock/stm32mp1-clks.h>
171    #include <dt-bindings/reset/stm32mp1-resets.h>
172    sai2: sai@4400b000 {
173      compatible = "st,stm32h7-sai";
174      #address-cells = <1>;
175      #size-cells = <1>;
176      ranges = <0 0x4400b000 0x400>;
177      reg = <0x4400b000 0x4>, <0x4400b3f0 0x10>;
178      clocks = <&rcc SAI2>, <&rcc PLL3_Q>, <&rcc PLL3_R>;
179      clock-names = "pclk", "x8k", "x11k";
180      pinctrl-names = "default", "sleep";
181      pinctrl-0 = <&sai2a_pins_a>, <&sai2b_pins_b>;
182      pinctrl-1 = <&sai2a_sleep_pins_a>, <&sai2b_sleep_pins_b>;
183
184      sai2a: audio-controller@4400b004 {
185        #sound-dai-cells = <0>;
186        compatible = "st,stm32-sai-sub-a";
187        reg = <0x4 0x1c>;
188        dmas = <&dmamux1 89 0x400 0x01>;
189        dma-names = "tx";
190        clocks = <&rcc SAI2_K>;
191        clock-names = "sai_ck";
192      };
193    };
194
195...
196