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