include/linux/dma/imx-dma.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Copyright 2004-2009 Freescale Semiconductor, Inc. All Rights Reserved.
   4  */
   5
   6 #ifndef __LINUX_DMA_IMX_H
   7 #define __LINUX_DMA_IMX_H
   8
   9 #include <linux/scatterlist.h>
  10 #include <linux/device.h>
  11 #include <linux/dmaengine.h>
  12
  13 /*
  14  * This enumerates peripheral types. Used for SDMA.
  15  */
  16 enum sdma_peripheral_type {
  17         IMX_DMATYPE_SSI,        /* MCU domain SSI */
  18         IMX_DMATYPE_SSI_SP,     /* Shared SSI */
  19         IMX_DMATYPE_MMC,        /* MMC */
  20         IMX_DMATYPE_SDHC,       /* SDHC */
  21         IMX_DMATYPE_UART,       /* MCU domain UART */
  22         IMX_DMATYPE_UART_SP,    /* Shared UART */
  23         IMX_DMATYPE_FIRI,       /* FIRI */
  24         IMX_DMATYPE_CSPI,       /* MCU domain CSPI */
  25         IMX_DMATYPE_CSPI_SP,    /* Shared CSPI */
  26         IMX_DMATYPE_SIM,        /* SIM */
  27         IMX_DMATYPE_ATA,        /* ATA */
  28         IMX_DMATYPE_CCM,        /* CCM */
  29         IMX_DMATYPE_EXT,        /* External peripheral */
  30         IMX_DMATYPE_MSHC,       /* Memory Stick Host Controller */
  31         IMX_DMATYPE_MSHC_SP,    /* Shared Memory Stick Host Controller */
  32         IMX_DMATYPE_DSP,        /* DSP */
  33         IMX_DMATYPE_MEMORY,     /* Memory */
  34         IMX_DMATYPE_FIFO_MEMORY,/* FIFO type Memory */
  35         IMX_DMATYPE_SPDIF,      /* SPDIF */
  36         IMX_DMATYPE_IPU_MEMORY, /* IPU Memory */
  37         IMX_DMATYPE_ASRC,       /* ASRC */
  38         IMX_DMATYPE_ESAI,       /* ESAI */
  39         IMX_DMATYPE_SSI_DUAL,   /* SSI Dual FIFO */
  40         IMX_DMATYPE_ASRC_SP,    /* Shared ASRC */
  41         IMX_DMATYPE_SAI,        /* SAI */
  42         IMX_DMATYPE_MULTI_SAI,  /* MULTI FIFOs For Audio */
  43         IMX_DMATYPE_HDMI,       /* HDMI Audio */
  44 };
  45
  46 enum imx_dma_prio {
  47         DMA_PRIO_HIGH = 0,
  48         DMA_PRIO_MEDIUM = 1,
  49         DMA_PRIO_LOW = 2
  50 };
  51
  52 struct imx_dma_data {
  53         int dma_request; /* DMA request line */
  54         int dma_request2; /* secondary DMA request line */
  55         enum sdma_peripheral_type peripheral_type;
  56         int priority;
  57 };
  58
  59 static inline int imx_dma_is_ipu(struct dma_chan *chan)
  60 {
  61         return !strcmp(dev_name(chan->device->dev), "ipu-core");
  62 }
  63
  64 static inline int imx_dma_is_general_purpose(struct dma_chan *chan)
  65 {
  66         return !strcmp(chan->device->dev->driver->name, "imx-sdma") ||
  67                 !strcmp(chan->device->dev->driver->name, "imx-dma");
  68 }
  69
  70 /**
  71  * struct sdma_peripheral_config - SDMA config for audio
  72  * @n_fifos_src: Number of FIFOs for recording
  73  * @n_fifos_dst: Number of FIFOs for playback
  74  * @stride_fifos_src: FIFO address stride for recording, 0 means all FIFOs are
  75  *                    continuous, 1 means 1 word stride between FIFOs. All stride
  76  *                    between FIFOs should be same.
  77  * @stride_fifos_dst: FIFO address stride for playback
  78  * @words_per_fifo: numbers of words per FIFO fetch/fill, 1 means
  79  *                  one channel per FIFO, 2 means 2 channels per FIFO..
  80  *                  If 'n_fifos_src =  4' and 'words_per_fifo = 2', it
  81  *                  means the first two words(channels) fetch from FIFO0
  82  *                  and then jump to FIFO1 for next two words, and so on
  83  *                  after the last FIFO3 fetched, roll back to FIFO0.
  84  * @sw_done: Use software done. Needed for PDM (micfil)
  85  *
  86  * Some i.MX Audio devices (SAI, micfil) have multiple successive FIFO
  87  * registers. For multichannel recording/playback the SAI/micfil have
  88  * one FIFO register per channel and the SDMA engine has to read/write
  89  * the next channel from/to the next register and wrap around to the
  90  * first register when all channels are handled. The number of active
  91  * channels must be communicated to the SDMA engine using this struct.
  92  */
  93 struct sdma_peripheral_config {
  94         int n_fifos_src;
  95         int n_fifos_dst;
  96         int stride_fifos_src;
  97         int stride_fifos_dst;
  98         int words_per_fifo;
  99         bool sw_done;
 100 };
 101
 102 #endif /* __LINUX_DMA_IMX_H */