forge/linux-pinenote
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

ASoC: davinci-mcasp: Improve DT bindings document

Browse source 
Makes interrupts property optional as the interrupts are not currently
used by the driver and adds interrupt-names property to name listed
interrupts. Currently know interrupt names are "tx" and "rx".

- Improve tdm-slots propery description

- Improve op-mode property description

- Add pinctrl-names and pinctrl-0 properties

- Remove #address-cells and #size-cells as they are not needed.

- Bracket named interrupts property tuples for uniformity.

- Add missing "for" to serial-dir prop in DT bindings doc.

Signed-off-by: Jyri Sarha <jsarha@ti.com>
Signed-off-by: Mark Brown <broonie@linaro.org>
This commit is contained in:
Jyri Sarha 2013-10-18 18:37:45 +03:00 • committed by Mark Brown
commit 62561b39ea
1 changed files with 15 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

24
Documentation/devicetree/bindings/sound/davinci-mcasp-audio.txt
View file

@ -11,13 +11,14 @@ Required properties:
* "mpu" for the main registers (required). For compatibility with * "mpu" for the main registers (required). For compatibility with
existing software, it is recommended this is the first entry. existing software, it is recommended this is the first entry.
* "dat" for separate data port register access (optional). * "dat" for separate data port register access (optional).
- interrupts : Interrupt number for McASP - op-mode : I2S/DIT ops mode. 0 for I2S mode. 1 for DIT mode used for S/PDIF,
- op-mode : I2S/DIT ops mode. IEC60958-1, and AES-3 formats.
- tdm-slots : Slots for TDM operation. - tdm-slots : Slots for TDM operation. Indicates number of channels transmitted
or received over one serializer.
- num-serializer : Serializers used by McASP. - num-serializer : Serializers used by McASP.
- serial-dir : A list of serializer pin mode. The list number should be equal - serial-dir : A list of serializer configuration. Each entry is a number
to "num-serializer" parameter. Each entry is a number indication indication for serializer pin direction.
serializer pin direction. (0 - INACTIVE, 1 - TX, 2 - RX) (0 - INACTIVE, 1 - TX, 2 - RX)
- dmas: two element list of DMA controller phandles and DMA request line - dmas: two element list of DMA controller phandles and DMA request line
ordered pairs. ordered pairs.
- dma-names: identifier string for each DMA request line in the dmas property. - dma-names: identifier string for each DMA request line in the dmas property.
@ -31,16 +32,21 @@ Optional properties:
- rx-num-evt : FIFO levels. - rx-num-evt : FIFO levels.
- sram-size-playback : size of sram to be allocated during playback - sram-size-playback : size of sram to be allocated during playback
- sram-size-capture : size of sram to be allocated during capture - sram-size-capture : size of sram to be allocated during capture
- interrupts : Interrupt numbers for McASP, currently not used by the driver
- interrupt-names : Known interrupt names are "tx" and "rx"
- pinctrl-0: Should specify pin control group used for this controller.
- pinctrl-names: Should contain only one value - "default", for more details
please refer to pinctrl-bindings.txt
Example: Example:
mcasp0: mcasp0@1d00000 { mcasp0: mcasp0@1d00000 {
compatible = "ti,da830-mcasp-audio"; compatible = "ti,da830-mcasp-audio";
#address-cells = <1>;
#size-cells = <0>;
reg = <0x100000 0x3000>; reg = <0x100000 0x3000>;
reg-names "mpu"; reg-names "mpu";
interrupts = <82 83>; interrupts = <82>, <83>;
interrupts-names = "tx", "rx";
op-mode = <0>; /* MCASP_IIS_MODE */ op-mode = <0>; /* MCASP_IIS_MODE */
tdm-slots = <2>; tdm-slots = <2>;
num-serializer = <16>; num-serializer = <16>;