Documentation/devicetree/bindings/dma/fsl-imx-sdma.txt

   1 * Freescale Smart Direct Memory Access (SDMA) Controller for i.MX
   2
   3 Required properties:
   4 - compatible : Should be "fsl,imx31-sdma", "fsl,imx31-to1-sdma",
   5   "fsl,imx31-to2-sdma", "fsl,imx35-sdma", "fsl,imx35-to1-sdma",
   6   "fsl,imx35-to2-sdma", "fsl,imx51-sdma", "fsl,imx53-sdma" or
   7   "fsl,imx6q-sdma". The -to variants should be preferred since they
   8   allow to determnine the correct ROM script addresses needed for
   9   the driver to work without additional firmware.
  10 - reg : Should contain SDMA registers location and length
  11 - interrupts : Should contain SDMA interrupt
  12 - #dma-cells : Must be <3>.
  13   The first cell specifies the DMA request/event ID.  See details below
  14   about the second and third cell.
  15 - fsl,sdma-ram-script-name : Should contain the full path of SDMA RAM
  16   scripts firmware
  17
  18 The second cell of dma phandle specifies the peripheral type of DMA transfer.
  19 The full ID of peripheral types can be found below.
  20
  21         ID      transfer type
  22         ---------------------
  23         0       MCU domain SSI
  24         1       Shared SSI
  25         2       MMC
  26         3       SDHC
  27         4       MCU domain UART
  28         5       Shared UART
  29         6       FIRI
  30         7       MCU domain CSPI
  31         8       Shared CSPI
  32         9       SIM
  33         10      ATA
  34         11      CCM
  35         12      External peripheral
  36         13      Memory Stick Host Controller
  37         14      Shared Memory Stick Host Controller
  38         15      DSP
  39         16      Memory
  40         17      FIFO type Memory
  41         18      SPDIF
  42         19      IPU Memory
  43         20      ASRC
  44         21      ESAI
  45         22      SSI Dual FIFO   (needs firmware ver >= 2)
  46
  47 The third cell specifies the transfer priority as below.
  48
  49         ID      transfer priority
  50         -------------------------
  51         0       High
  52         1       Medium
  53         2       Low
  54
  55 Examples:
  56
  57 sdma@83fb0000 {
  58         compatible = "fsl,imx51-sdma", "fsl,imx35-sdma";
  59         reg = <0x83fb0000 0x4000>;
  60         interrupts = <6>;
  61         #dma-cells = <3>;
  62         fsl,sdma-ram-script-name = "sdma-imx51.bin";
  63 };
  64
  65 DMA clients connected to the i.MX SDMA controller must use the format
  66 described in the dma.txt file.
  67
  68 Examples:
  69
  70 ssi2: ssi@70014000 {
  71         compatible = "fsl,imx51-ssi", "fsl,imx21-ssi";
  72         reg = <0x70014000 0x4000>;
  73         interrupts = <30>;
  74         clocks = <&clks 49>;
  75         dmas = <&sdma 24 1 0>,
  76                <&sdma 25 1 0>;
  77         dma-names = "rx", "tx";
  78         fsl,fifo-depth = <15>;
  79 };