Merge tag 'efi-urgent' into x86/urgent
[firefly-linux-kernel-4.4.55.git] / Documentation / devicetree / bindings / sound / fsl-sai.txt
1 Freescale Synchronous Audio Interface (SAI).
2
3 The SAI is based on I2S module that used communicating with audio codecs,
4 which provides a synchronous audio interface that supports fullduplex
5 serial interfaces with frame synchronization such as I2S, AC97, TDM, and
6 codec/DSP interfaces.
7
8
9 Required properties:
10 - compatible: Compatible list, contains "fsl,vf610-sai".
11 - reg: Offset and length of the register set for the device.
12 - clocks: Must contain an entry for each entry in clock-names.
13 - clock-names : Must include the "sai" entry.
14 - dmas : Generic dma devicetree binding as described in
15   Documentation/devicetree/bindings/dma/dma.txt.
16 - dma-names : Two dmas have to be defined, "tx" and "rx".
17 - pinctrl-names: Must contain a "default" entry.
18 - pinctrl-NNN: One property must exist for each entry in pinctrl-names.
19   See ../pinctrl/pinctrl-bindings.txt for details of the property values.
20 - big-endian-regs: If this property is absent, the little endian mode will
21   be in use as default, or the big endian mode will be in use for all the
22   device registers.
23 - big-endian-data: If this property is absent, the little endian mode will
24   be in use as default, or the big endian mode will be in use for all the
25   fifo data.
26
27 Example:
28 sai2: sai@40031000 {
29               compatible = "fsl,vf610-sai";
30               reg = <0x40031000 0x1000>;
31               pinctrl-names = "default";
32               pinctrl-0 = <&pinctrl_sai2_1>;
33               clocks = <&clks VF610_CLK_SAI2>;
34               clock-names = "sai";
35               dma-names = "tx", "rx";
36               dmas = <&edma0 0 VF610_EDMA_MUXID0_SAI2_TX>,
37                    <&edma0 0 VF610_EDMA_MUXID0_SAI2_RX>;
38               big-endian-regs;
39               big-endian-data;
40 };