Merge tag 'mvebu-fixes-3.19' of git://git.infradead.org/linux-mvebu into fixes
[linux-2.6-microblaze.git] / Documentation / devicetree / bindings / sound / davinci-mcasp-audio.txt
1 Texas Instruments McASP controller
2
3 Required properties:
4 - compatible :
5         "ti,dm646x-mcasp-audio" : for DM646x platforms
6         "ti,da830-mcasp-audio"  : for both DA830 & DA850 platforms
7         "ti,am33xx-mcasp-audio" : for AM33xx platforms (AM33xx, AM43xx, TI81xx)
8         "ti,dra7-mcasp-audio"   : for DRA7xx platforms
9
10 - reg : Should contain reg specifiers for the entries in the reg-names property.
11 - reg-names : Should contain:
12          * "mpu" for the main registers (required). For compatibility with
13            existing software, it is recommended this is the first entry.
14          * "dat" for separate data port register access (optional).
15 - op-mode : I2S/DIT ops mode. 0 for I2S mode. 1 for DIT mode used for S/PDIF,
16             IEC60958-1, and AES-3 formats.
17 - tdm-slots : Slots for TDM operation. Indicates number of channels transmitted
18               or received over one serializer.
19 - serial-dir : A list of serializer configuration. Each entry is a number
20                indication for serializer pin direction.
21                (0 - INACTIVE, 1 - TX, 2 - RX)
22 - dmas: two element list of DMA controller phandles and DMA request line
23         ordered pairs.
24 - dma-names: identifier string for each DMA request line in the dmas property.
25              These strings correspond 1:1 with the ordered pairs in dmas. The dma
26              identifiers must be "rx" and "tx".
27
28 Optional properties:
29
30 - ti,hwmods : Must be "mcasp<n>", n is controller instance starting 0
31 - tx-num-evt : FIFO levels.
32 - rx-num-evt : FIFO levels.
33 - sram-size-playback : size of sram to be allocated during playback
34 - sram-size-capture  : size of sram to be allocated during capture
35 - interrupts : Interrupt numbers for McASP
36 - interrupt-names : Known interrupt names are "tx" and "rx"
37 - pinctrl-0: Should specify pin control group used for this controller.
38 - pinctrl-names: Should contain only one value - "default", for more details
39                  please refer to pinctrl-bindings.txt
40 - fck_parent : Should contain a valid clock name which will be used as parent
41                for the McASP fck
42
43 Example:
44
45 mcasp0: mcasp0@1d00000 {
46         compatible = "ti,da830-mcasp-audio";
47         reg = <0x100000 0x3000>;
48         reg-names "mpu";
49         interrupts = <82>, <83>;
50         interrupt-names = "tx", "rx";
51         op-mode = <0>;          /* MCASP_IIS_MODE */
52         tdm-slots = <2>;
53         serial-dir = <
54                         0 0 0 0 /* 0: INACTIVE, 1: TX, 2: RX */
55                         0 0 0 0
56                         0 0 0 1
57                         2 0 0 0 >;
58         tx-num-evt = <1>;
59         rx-num-evt = <1>;
60 };