2 * Driver for the Synopsys DesignWare AHB DMA Controller
4 * Copyright (C) 2005-2007 Atmel Corporation
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 as
8 * published by the Free Software Foundation.
11 #include <linux/dw_dmac.h>
13 #define DW_DMA_MAX_NR_CHANNELS 8
16 * Redefine this macro to handle differences between 32- and 64-bit
17 * addressing, big vs. little endian, etc.
19 #define DW_REG(name) u32 name; u32 __pad_##name
21 /* Hardware register definitions. */
22 struct dw_dma_chan_regs {
23 DW_REG(SAR); /* Source Address Register */
24 DW_REG(DAR); /* Destination Address Register */
25 DW_REG(LLP); /* Linked List Pointer */
26 u32 CTL_LO; /* Control Register Low */
27 u32 CTL_HI; /* Control Register High */
32 u32 CFG_LO; /* Configuration Register Low */
33 u32 CFG_HI; /* Configuration Register High */
38 struct dw_dma_irq_regs {
47 /* per-channel registers */
48 struct dw_dma_chan_regs CHAN[DW_DMA_MAX_NR_CHANNELS];
51 struct dw_dma_irq_regs RAW; /* r */
52 struct dw_dma_irq_regs STATUS; /* r (raw & mask) */
53 struct dw_dma_irq_regs MASK; /* rw (set = irq enabled) */
54 struct dw_dma_irq_regs CLEAR; /* w (ack, affects "raw") */
56 DW_REG(STATUS_INT); /* r */
58 /* software handshaking */
72 /* optional encoded params, 0x3c8..0x3 */
75 /* Bitfields in CTL_LO */
76 #define DWC_CTLL_INT_EN (1 << 0) /* irqs enabled? */
77 #define DWC_CTLL_DST_WIDTH(n) ((n)<<1) /* bytes per element */
78 #define DWC_CTLL_SRC_WIDTH(n) ((n)<<4)
79 #define DWC_CTLL_DST_INC (0<<7) /* DAR update/not */
80 #define DWC_CTLL_DST_DEC (1<<7)
81 #define DWC_CTLL_DST_FIX (2<<7)
82 #define DWC_CTLL_SRC_INC (0<<7) /* SAR update/not */
83 #define DWC_CTLL_SRC_DEC (1<<9)
84 #define DWC_CTLL_SRC_FIX (2<<9)
85 #define DWC_CTLL_DST_MSIZE(n) ((n)<<11) /* burst, #elements */
86 #define DWC_CTLL_SRC_MSIZE(n) ((n)<<14)
87 #define DWC_CTLL_S_GATH_EN (1 << 17) /* src gather, !FIX */
88 #define DWC_CTLL_D_SCAT_EN (1 << 18) /* dst scatter, !FIX */
89 #define DWC_CTLL_FC_M2M (0 << 20) /* mem-to-mem */
90 #define DWC_CTLL_FC_M2P (1 << 20) /* mem-to-periph */
91 #define DWC_CTLL_FC_P2M (2 << 20) /* periph-to-mem */
92 #define DWC_CTLL_FC_P2P (3 << 20) /* periph-to-periph */
93 /* plus 4 transfer types for peripheral-as-flow-controller */
94 #define DWC_CTLL_DMS(n) ((n)<<23) /* dst master select */
95 #define DWC_CTLL_SMS(n) ((n)<<25) /* src master select */
96 #define DWC_CTLL_LLP_D_EN (1 << 27) /* dest block chain */
97 #define DWC_CTLL_LLP_S_EN (1 << 28) /* src block chain */
99 /* Bitfields in CTL_HI */
100 #define DWC_CTLH_DONE 0x00001000
101 #define DWC_CTLH_BLOCK_TS_MASK 0x00000fff
103 /* Bitfields in CFG_LO. Platform-configurable bits are in <linux/dw_dmac.h> */
104 #define DWC_CFGL_CH_SUSP (1 << 8) /* pause xfer */
105 #define DWC_CFGL_FIFO_EMPTY (1 << 9) /* pause xfer */
106 #define DWC_CFGL_HS_DST (1 << 10) /* handshake w/dst */
107 #define DWC_CFGL_HS_SRC (1 << 11) /* handshake w/src */
108 #define DWC_CFGL_MAX_BURST(x) ((x) << 20)
109 #define DWC_CFGL_RELOAD_SAR (1 << 30)
110 #define DWC_CFGL_RELOAD_DAR (1 << 31)
112 /* Bitfields in CFG_HI. Platform-configurable bits are in <linux/dw_dmac.h> */
113 #define DWC_CFGH_DS_UPD_EN (1 << 5)
114 #define DWC_CFGH_SS_UPD_EN (1 << 6)
116 /* Bitfields in SGR */
117 #define DWC_SGR_SGI(x) ((x) << 0)
118 #define DWC_SGR_SGC(x) ((x) << 20)
120 /* Bitfields in DSR */
121 #define DWC_DSR_DSI(x) ((x) << 0)
122 #define DWC_DSR_DSC(x) ((x) << 20)
124 /* Bitfields in CFG */
125 #define DW_CFG_DMA_EN (1 << 0)
127 #define DW_REGLEN 0x400
130 DW_DMA_IS_CYCLIC = 0,
134 struct dma_chan chan;
135 void __iomem *ch_regs;
140 /* these other elements are all protected by lock */
142 dma_cookie_t completed;
143 struct list_head active_list;
144 struct list_head queue;
145 struct list_head free_list;
146 struct dw_cyclic_desc *cdesc;
148 unsigned int descs_allocated;
151 static inline struct dw_dma_chan_regs __iomem *
152 __dwc_regs(struct dw_dma_chan *dwc)
157 #define channel_readl(dwc, name) \
158 __raw_readl(&(__dwc_regs(dwc)->name))
159 #define channel_writel(dwc, name, val) \
160 __raw_writel((val), &(__dwc_regs(dwc)->name))
162 static inline struct dw_dma_chan *to_dw_dma_chan(struct dma_chan *chan)
164 return container_of(chan, struct dw_dma_chan, chan);
168 struct dma_device dma;
170 struct tasklet_struct tasklet;
175 struct dw_dma_chan chan[0];
178 static inline struct dw_dma_regs __iomem *__dw_regs(struct dw_dma *dw)
183 #define dma_readl(dw, name) \
184 __raw_readl(&(__dw_regs(dw)->name))
185 #define dma_writel(dw, name, val) \
186 __raw_writel((val), &(__dw_regs(dw)->name))
188 #define channel_set_bit(dw, reg, mask) \
189 dma_writel(dw, reg, ((mask) << 8) | (mask))
190 #define channel_clear_bit(dw, reg, mask) \
191 dma_writel(dw, reg, ((mask) << 8) | 0)
193 static inline struct dw_dma *to_dw_dma(struct dma_device *ddev)
195 return container_of(ddev, struct dw_dma, dma);
198 /* LLI == Linked List Item; a.k.a. DMA block descriptor */
200 /* values that are not changed by hardware */
203 dma_addr_t llp; /* chain to next lli */
205 /* values that may get written back: */
207 /* sstat and dstat can snapshot peripheral register state.
208 * silicon config may discard either or both...
215 /* FIRST values the hardware uses */
218 /* THEN values for driver housekeeping */
219 struct list_head desc_node;
220 struct dma_async_tx_descriptor txd;
224 static inline struct dw_desc *
225 txd_to_dw_desc(struct dma_async_tx_descriptor *txd)
227 return container_of(txd, struct dw_desc, txd);