1624dcbdeSMarkus PargmannFreescale Synchronous Serial Interface 2624dcbdeSMarkus Pargmann 3624dcbdeSMarkus PargmannThe SSI is a serial device that communicates with audio codecs. It can 4624dcbdeSMarkus Pargmannbe programmed in AC97, I2S, left-justified, or right-justified modes. 5624dcbdeSMarkus Pargmann 6624dcbdeSMarkus PargmannRequired properties: 710901e53SMarkus Pargmann- compatible: Compatible list, should contain one of the following 810901e53SMarkus Pargmann compatibles: 910901e53SMarkus Pargmann fsl,mpc8610-ssi 1010901e53SMarkus Pargmann fsl,imx51-ssi 1110901e53SMarkus Pargmann fsl,imx35-ssi 1210901e53SMarkus Pargmann fsl,imx21-ssi 13624dcbdeSMarkus Pargmann- cell-index: The SSI, <0> = SSI1, <1> = SSI2, and so on. 14624dcbdeSMarkus Pargmann- reg: Offset and length of the register set for the device. 15624dcbdeSMarkus Pargmann- interrupts: <a b> where a is the interrupt number and b is a 16624dcbdeSMarkus Pargmann field that represents an encoding of the sense and 17624dcbdeSMarkus Pargmann level information for the interrupt. This should be 18624dcbdeSMarkus Pargmann encoded based on the information in section 2) 19624dcbdeSMarkus Pargmann depending on the type of interrupt controller you 20624dcbdeSMarkus Pargmann have. 21624dcbdeSMarkus Pargmann- fsl,fifo-depth: The number of elements in the transmit and receive FIFOs. 22624dcbdeSMarkus Pargmann This number is the maximum allowed value for SFCSR[TFWM0]. 233567de67SMarkus Pargmann - clocks: "ipg" - Required clock for the SSI unit 243567de67SMarkus Pargmann "baud" - Required clock for SSI master mode. Otherwise this 253567de67SMarkus Pargmann clock is not used 26624dcbdeSMarkus Pargmann 27cd7f0295SMarkus PargmannRequired are also ac97 link bindings if ac97 is used. See 28cd7f0295SMarkus PargmannDocumentation/devicetree/bindings/sound/soc-ac97link.txt for the necessary 29cd7f0295SMarkus Pargmannbindings. 30cd7f0295SMarkus Pargmann 31624dcbdeSMarkus PargmannOptional properties: 32624dcbdeSMarkus Pargmann- codec-handle: Phandle to a 'codec' node that defines an audio 33624dcbdeSMarkus Pargmann codec connected to this SSI. This node is typically 34624dcbdeSMarkus Pargmann a child of an I2C or other control node. 35de623eceSMarkus Pargmann- fsl,fiq-stream-filter: Bool property. Disabled DMA and use FIQ instead to 36de623eceSMarkus Pargmann filter the codec stream. This is necessary for some boards 37de623eceSMarkus Pargmann where an incompatible codec is connected to this SSI, e.g. 38de623eceSMarkus Pargmann on pca100 and pcm043. 393a5e517bSMarkus Pargmann- dmas: Generic dma devicetree binding as described in 403a5e517bSMarkus Pargmann Documentation/devicetree/bindings/dma/dma.txt. 413a5e517bSMarkus Pargmann- dma-names: Two dmas have to be defined, "tx" and "rx", if fsl,imx-fiq 423a5e517bSMarkus Pargmann is not defined. 43b93427b1SFabio Estevam- fsl,mode: The operating mode for the AC97 interface only. 443567de67SMarkus Pargmann "ac97-slave" - AC97 mode, SSI is clock slave 453567de67SMarkus Pargmann "ac97-master" - AC97 mode, SSI is clock master 4623aaf4ceSFabio Estevam- fsl,ssi-asynchronous: 4723aaf4ceSFabio Estevam If specified, the SSI is to be programmed in asynchronous 4823aaf4ceSFabio Estevam mode. In this mode, pins SRCK, STCK, SRFS, and STFS must 4923aaf4ceSFabio Estevam all be connected to valid signals. In synchronous mode, 5023aaf4ceSFabio Estevam SRCK and SRFS are ignored. Asynchronous mode allows 5123aaf4ceSFabio Estevam playback and capture to use different sample sizes and 5223aaf4ceSFabio Estevam sample rates. Some drivers may require that SRCK and STCK 5323aaf4ceSFabio Estevam be connected together, and SRFS and STFS be connected 5423aaf4ceSFabio Estevam together. This would still allow different sample sizes, 5523aaf4ceSFabio Estevam but not different sample rates. 5623aaf4ceSFabio Estevam- fsl,playback-dma: Phandle to a node for the DMA channel to use for 5723aaf4ceSFabio Estevam playback of audio. This is typically dictated by SOC 5823aaf4ceSFabio Estevam design. See the notes below. 5923aaf4ceSFabio Estevam Only used on Power Architecture. 6023aaf4ceSFabio Estevam- fsl,capture-dma: Phandle to a node for the DMA channel to use for 6123aaf4ceSFabio Estevam capture (recording) of audio. This is typically dictated 6223aaf4ceSFabio Estevam by SOC design. See the notes below. 6323aaf4ceSFabio Estevam Only used on Power Architecture. 64624dcbdeSMarkus Pargmann 65624dcbdeSMarkus PargmannChild 'codec' node required properties: 66624dcbdeSMarkus Pargmann- compatible: Compatible list, contains the name of the codec 67624dcbdeSMarkus Pargmann 68624dcbdeSMarkus PargmannChild 'codec' node optional properties: 69624dcbdeSMarkus Pargmann- clock-frequency: The frequency of the input clock, which typically comes 70624dcbdeSMarkus Pargmann from an on-board dedicated oscillator. 71624dcbdeSMarkus Pargmann 72624dcbdeSMarkus PargmannNotes on fsl,playback-dma and fsl,capture-dma: 73624dcbdeSMarkus Pargmann 74624dcbdeSMarkus PargmannOn SOCs that have an SSI, specific DMA channels are hard-wired for playback 75624dcbdeSMarkus Pargmannand capture. On the MPC8610, for example, SSI1 must use DMA channel 0 for 76624dcbdeSMarkus Pargmannplayback and DMA channel 1 for capture. SSI2 must use DMA channel 2 for 77624dcbdeSMarkus Pargmannplayback and DMA channel 3 for capture. The developer can choose which 78624dcbdeSMarkus PargmannDMA controller to use, but the channels themselves are hard-wired. The 79624dcbdeSMarkus Pargmannpurpose of these two properties is to represent this hardware design. 80624dcbdeSMarkus Pargmann 81624dcbdeSMarkus PargmannThe device tree nodes for the DMA channels that are referenced by 82624dcbdeSMarkus Pargmann"fsl,playback-dma" and "fsl,capture-dma" must be marked as compatible with 83624dcbdeSMarkus Pargmann"fsl,ssi-dma-channel". The SOC-specific compatible string (e.g. 84624dcbdeSMarkus Pargmann"fsl,mpc8610-dma-channel") can remain. If these nodes are left as 85624dcbdeSMarkus Pargmann"fsl,elo-dma-channel" or "fsl,eloplus-dma-channel", then the generic Elo DMA 86624dcbdeSMarkus Pargmanndrivers (fsldma) will attempt to use them, and it will conflict with the 87624dcbdeSMarkus Pargmannsound drivers. 88