Merge git://git.kernel.org/pub/scm/linux/kernel/git/davem/net
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / sound / rockchip-i2s.txt
1 * Rockchip I2S controller
2
3 The I2S bus (Inter-IC sound bus) is a serial link for digital
4 audio data transfer between devices in the system.
5
6 Required properties:
7
8 - compatible: should be one of the following:
9    - "rockchip,rk3066-i2s": for rk3066
10    - "rockchip,rk3188-i2s", "rockchip,rk3066-i2s": for rk3188
11    - "rockchip,rk3288-i2s", "rockchip,rk3066-i2s": for rk3288
12    - "rockchip,rk3399-i2s", "rockchip,rk3066-i2s": for rk3399
13 - reg: physical base address of the controller and length of memory mapped
14   region.
15 - interrupts: should contain the I2S interrupt.
16 - dmas: DMA specifiers for tx and rx dma. See the DMA client binding,
17         Documentation/devicetree/bindings/dma/dma.txt
18 - dma-names: should include "tx" and "rx".
19 - clocks: a list of phandle + clock-specifer pairs, one for each entry in clock-names.
20 - clock-names: should contain the following:
21    - "i2s_hclk": clock for I2S BUS
22    - "i2s_clk" : clock for I2S controller
23 - rockchip,playback-channels: max playback channels, if not set, 8 channels default.
24 - rockchip,capture-channels: max capture channels, if not set, 2 channels default.
25
26 Required properties for controller which support multi channels
27 playback/capture:
28
29 - rockchip,grf: the phandle of the syscon node for GRF register.
30
31 Example for rk3288 I2S controller:
32
33 i2s@ff890000 {
34         compatible = "rockchip,rk3288-i2s", "rockchip,rk3066-i2s";
35         reg = <0xff890000 0x10000>;
36         interrupts = <GIC_SPI 85 IRQ_TYPE_LEVEL_HIGH>;
37         dmas = <&pdma1 0>, <&pdma1 1>;
38         dma-names = "tx", "rx";
39         clock-names = "i2s_hclk", "i2s_clk";
40         clocks = <&cru HCLK_I2S0>, <&cru SCLK_I2S0>;
41         rockchip,playback-channels = <8>;
42         rockchip,capture-channels = <2>;
43 };