xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/sound/hisilicon,hi6210-i2s.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun* Hisilicon 6210 i2s controller
2*4882a593Smuzhiyun
3*4882a593SmuzhiyunRequired properties:
4*4882a593Smuzhiyun
5*4882a593Smuzhiyun- compatible: should be one of the following:
6*4882a593Smuzhiyun   - "hisilicon,hi6210-i2s"
7*4882a593Smuzhiyun- reg: physical base address of the i2s controller unit and length of
8*4882a593Smuzhiyun   memory mapped region.
9*4882a593Smuzhiyun- interrupts: should contain the i2s interrupt.
10*4882a593Smuzhiyun- clocks: a list of phandle + clock-specifier pairs, one for each entry
11*4882a593Smuzhiyun  in clock-names.
12*4882a593Smuzhiyun- clock-names: should contain following:
13*4882a593Smuzhiyun   - "dacodec"
14*4882a593Smuzhiyun   - "i2s-base"
15*4882a593Smuzhiyun- dmas: DMA specifiers for tx dma. See the DMA client binding,
16*4882a593Smuzhiyun  Documentation/devicetree/bindings/dma/dma.txt
17*4882a593Smuzhiyun- dma-names: should be "tx" and "rx"
18*4882a593Smuzhiyun- hisilicon,sysctrl-syscon: phandle to sysctrl syscon
19*4882a593Smuzhiyun- #sound-dai-cells: Should be set to 1 (for multi-dai)
20*4882a593Smuzhiyun   - The dai cell indexes reference the following interfaces:
21*4882a593Smuzhiyun       0: S2 interface
22*4882a593Smuzhiyun       (Currently that is the only one available, but more may be
23*4882a593Smuzhiyun        supported in the future)
24*4882a593Smuzhiyun
25*4882a593SmuzhiyunExample for the hi6210 i2s controller:
26*4882a593Smuzhiyun
27*4882a593Smuzhiyuni2s0: i2s@f7118000{
28*4882a593Smuzhiyun	compatible = "hisilicon,hi6210-i2s";
29*4882a593Smuzhiyun	reg = <0x0 0xf7118000 0x0 0x8000>; /* i2s unit */
30*4882a593Smuzhiyun	interrupts = <GIC_SPI 123 IRQ_TYPE_LEVEL_HIGH>; /* 155 "DigACodec_intr"-32 */
31*4882a593Smuzhiyun	clocks = <&sys_ctrl HI6220_DACODEC_PCLK>,
32*4882a593Smuzhiyun		 <&sys_ctrl HI6220_BBPPLL0_DIV>;
33*4882a593Smuzhiyun	clock-names = "dacodec", "i2s-base";
34*4882a593Smuzhiyun	dmas = <&dma0 15 &dma0 14>;
35*4882a593Smuzhiyun	dma-names = "rx", "tx";
36*4882a593Smuzhiyun	hisilicon,sysctrl-syscon = <&sys_ctrl>;
37*4882a593Smuzhiyun	#sound-dai-cells = <1>;
38*4882a593Smuzhiyun};
39*4882a593Smuzhiyun
40*4882a593SmuzhiyunThen when referencing the i2s controller:
41*4882a593Smuzhiyun	sound-dai = <&i2s0 0>; /* index 0 => S2 interface */
42*4882a593Smuzhiyun
43