1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
4 $id: http://devicetree.org/schemas/sound/st,stm32-sai.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: STMicroelectronics STM32 Serial Audio Interface (SAI)
10 - Olivier Moysan <olivier.moysan@st.com>
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.
26 - description: Base address and size of SAI common register set.
27 - description: Base address and size of SAI identification register set.
62 "^audio-controller@[0-9a-f]+$":
65 Two subnodes corresponding to SAI sub-block instances A et B
66 can be defined. Subnode can be omitted for unsused sub-block.
70 description: Compatible for SAI sub-block A or B.
71 pattern: "st,stm32-sai-sub-[ab]"
81 - description: sai_ck clock feeding the internal clock generator.
82 - description: MCLK clock from a SAI set as master clock provider.
98 rx: SAI sub-block is configured as a capture DAI.
99 tx: SAI sub-block is configured as a playback DAI.
104 Configure the SAI sub-block as slave of another SAI sub-block.
105 By default SAI sub-block is in asynchronous mode.
106 Must contain the phandle and index of the SAI sub-block providing
109 - $ref: /schemas/types.yaml#/definitions/phandle-array
114 If set, support S/PDIF IEC6958 protocol for playback.
115 IEC60958 protocol is not available for capture.
116 By default, custom protocol is assumed, meaning that protocol is
117 configured according to protocol defined in related DAI link node,
118 such as i2s, left justified, right justified, dsp and pdm protocols.
120 - $ref: /schemas/types.yaml#/definitions/flag
123 description: Configure the SAI device as master clock provider.
140 const: st,stm32f4-sai
146 - description: x8k, SAI parent clock for sampling rates multiple of 8kHz.
147 - description: x11k, SAI parent clock for sampling rates multiple of 11.025kHz.
158 - description: pclk feeds the peripheral bus interface.
159 - description: x8k, SAI parent clock for sampling rates multiple of 8kHz.
160 - description: x11k, SAI parent clock for sampling rates multiple of 11.025kHz.
168 additionalProperties: false
172 #include <dt-bindings/interrupt-controller/arm-gic.h>
173 #include <dt-bindings/clock/stm32mp1-clks.h>
174 #include <dt-bindings/reset/stm32mp1-resets.h>
176 compatible = "st,stm32h7-sai";
177 #address-cells = <1>;
179 ranges = <0 0x4400b000 0x400>;
180 reg = <0x4400b000 0x4>, <0x4400b3f0 0x10>;
181 clocks = <&rcc SAI2>, <&rcc PLL3_Q>, <&rcc PLL3_R>;
182 clock-names = "pclk", "x8k", "x11k";
183 pinctrl-names = "default", "sleep";
184 pinctrl-0 = <&sai2a_pins_a>, <&sai2b_pins_b>;
185 pinctrl-1 = <&sai2a_sleep_pins_a>, <&sai2b_sleep_pins_b>;
188 sai2a: audio-controller@4400b004 {
189 #sound-dai-cells = <0>;
190 compatible = "st,stm32-sai-sub-a";
192 dmas = <&dmamux1 89 0x400 0x01>;
194 clocks = <&rcc SAI2_K>;
195 clock-names = "sai_ck";