Documentation/devicetree/bindings/sound/fsl,esai.txt

   1 Freescale Enhanced Serial Audio Interface (ESAI) Controller
   2
   3 The Enhanced Serial Audio Interface (ESAI) provides a full-duplex serial port
   4 for serial communication with a variety of serial devices, including industry
   5 standard codecs, Sony/Phillips Digital Interface (S/PDIF) transceivers, and
   6 other DSPs. It has up to six transmitters and four receivers.
   7
   8 Required properties:
   9
  10   - compatible          : Compatible list, should contain one of the following
  11                           compatibles:
  12                           "fsl,imx35-esai",
  13                           "fsl,vf610-esai",
  14                           "fsl,imx6ull-esai",
  15
  16   - reg                 : Offset and length of the register set for the device.
  17
  18   - interrupts          : Contains the spdif interrupt.
  19
  20   - dmas                : Generic dma devicetree binding as described in
  21                           Documentation/devicetree/bindings/dma/dma.txt.
  22
  23   - dma-names           : Two dmas have to be defined, "tx" and "rx".
  24
  25   - clocks              : Contains an entry for each entry in clock-names.
  26
  27   - clock-names         : Includes the following entries:
  28         "core"            The core clock used to access registers
  29         "extal"           The esai baud clock for esai controller used to
  30                           derive HCK, SCK and FS.
  31         "fsys"            The system clock derived from ahb clock used to
  32                           derive HCK, SCK and FS.
  33         "spba"            The spba clock is required when ESAI is placed as a
  34                           bus slave of the Shared Peripheral Bus and when two
  35                           or more bus masters (CPU, DMA or DSP) try to access
  36                           it. This property is optional depending on the SoC
  37                           design.
  38
  39   - fsl,fifo-depth      : The number of elements in the transmit and receive
  40                           FIFOs. This number is the maximum allowed value for
  41                           TFCR[TFWM] or RFCR[RFWM].
  42
  43   - fsl,esai-synchronous: This is a boolean property. If present, indicating
  44                           that ESAI would work in the synchronous mode, which
  45                           means all the settings for Receiving would be
  46                           duplicated from Transmition related registers.
  47
  48 Optional properties:
  49
  50   - big-endian          : If this property is absent, the native endian mode
  51                           will be in use as default, or the big endian mode
  52                           will be in use for all the device registers.
  53
  54 Example:
  55
  56 esai: esai@2024000 {
  57         compatible = "fsl,imx35-esai";
  58         reg = <0x02024000 0x4000>;
  59         interrupts = <0 51 0x04>;
  60         clocks = <&clks 208>, <&clks 118>, <&clks 208>;
  61         clock-names = "core", "extal", "fsys";
  62         dmas = <&sdma 23 21 0>, <&sdma 24 21 0>;
  63         dma-names = "rx", "tx";
  64         fsl,fifo-depth = <128>;
  65         fsl,esai-synchronous;
  66         big-endian;
  67 };