3 * include/linux/coh901318.h
6 * Copyright (C) 2007-2009 ST-Ericsson
7 * License terms: GNU General Public License (GPL) version 2
8 * DMA driver for COH 901 318
15 #include <linux/device.h>
16 #include <linux/dmaengine.h>
18 #define MAX_DMA_PACKET_SIZE_SHIFT 11
19 #define MAX_DMA_PACKET_SIZE (1 << MAX_DMA_PACKET_SIZE_SHIFT)
22 * struct coh901318_lli - linked list item for DMAC
23 * @control: control settings for DMAC
24 * @src_addr: transfer source address
25 * @dst_addr: transfer destination address
26 * @link_addr: physical address to next lli
27 * @virt_link_addr: virtual addres of next lli (only used by pool_free)
28 * @phy_this: physical address of current lli (only used by pool_free)
30 struct coh901318_lli {
40 * struct coh901318_params - parameters for DMAC configuration
41 * @config: DMA config register
42 * @ctrl_lli_last: DMA control register for the last lli in the list
43 * @ctrl_lli: DMA control register for an lli
44 * @ctrl_lli_chained: DMA control register for a chained lli
46 struct coh901318_params {
53 * struct coh_dma_channel - dma channel base
54 * @name: ascii name of dma channel
55 * @number: channel id number
56 * @desc_nbr_max: number of preallocated descriptors
57 * @priority_high: prio of channel, 0 low otherwise high.
58 * @param: configuration parameters
59 * @dev_addr: physical address of periphal connected to channel
61 struct coh_dma_channel {
64 const int desc_nbr_max;
65 const int priority_high;
66 const struct coh901318_params param;
67 const dma_addr_t dev_addr;
71 * dma_access_memory_state_t - register dma for memory access
73 * @dev: The dma device
74 * @active: 1 means dma intends to access memory
75 * 0 means dma wont access memory
77 typedef void (*dma_access_memory_state_t)(struct device *dev,
81 * struct powersave - DMA power save structure
82 * @lock: lock protecting data in this struct
83 * @started_channels: bit mask indicating active dma channels
90 * struct coh901318_platform - platform arch structure
91 * @chans_slave: specifying dma slave channels
92 * @chans_memcpy: specifying dma memcpy channels
93 * @access_memory_state: requesting DMA memeory access (on / off)
94 * @chan_conf: dma channel configurations
95 * @max_channels: max number of dma chanenls
97 struct coh901318_platform {
98 const int *chans_slave;
99 const int *chans_memcpy;
100 const dma_access_memory_state_t access_memory_state;
101 const struct coh_dma_channel *chan_conf;
102 const int max_channels;
106 * coh901318_get_bytes_left() - Get number of bytes left on a current transfer
107 * @chan: dma channel handle
108 * return number of bytes left, or negative on error
110 u32 coh901318_get_bytes_left(struct dma_chan *chan);
113 * coh901318_stop() - Stops dma transfer
114 * @chan: dma channel handle
115 * return 0 on success otherwise negative value
117 void coh901318_stop(struct dma_chan *chan);
120 * coh901318_continue() - Resumes a stopped dma transfer
121 * @chan: dma channel handle
122 * return 0 on success otherwise negative value
124 void coh901318_continue(struct dma_chan *chan);
127 * coh901318_filter_id() - DMA channel filter function
128 * @chan: dma channel handle
129 * @chan_id: id of dma channel to be filter out
131 * In dma_request_channel() it specifies what channel id to be requested
133 bool coh901318_filter_id(struct dma_chan *chan, void *chan_id);
136 * DMA Controller - this access the static mappings of the coh901318 dma.
140 #define COH901318_MOD32_MASK (0x1F)
141 #define COH901318_WORD_MASK (0xFFFFFFFF)
142 /* INT_STATUS - Interrupt Status Registers 32bit (R/-) */
143 #define COH901318_INT_STATUS1 (0x0000)
144 #define COH901318_INT_STATUS2 (0x0004)
145 /* TC_INT_STATUS - Terminal Count Interrupt Status Registers 32bit (R/-) */
146 #define COH901318_TC_INT_STATUS1 (0x0008)
147 #define COH901318_TC_INT_STATUS2 (0x000C)
148 /* TC_INT_CLEAR - Terminal Count Interrupt Clear Registers 32bit (-/W) */
149 #define COH901318_TC_INT_CLEAR1 (0x0010)
150 #define COH901318_TC_INT_CLEAR2 (0x0014)
151 /* RAW_TC_INT_STATUS - Raw Term Count Interrupt Status Registers 32bit (R/-) */
152 #define COH901318_RAW_TC_INT_STATUS1 (0x0018)
153 #define COH901318_RAW_TC_INT_STATUS2 (0x001C)
154 /* BE_INT_STATUS - Bus Error Interrupt Status Registers 32bit (R/-) */
155 #define COH901318_BE_INT_STATUS1 (0x0020)
156 #define COH901318_BE_INT_STATUS2 (0x0024)
157 /* BE_INT_CLEAR - Bus Error Interrupt Clear Registers 32bit (-/W) */
158 #define COH901318_BE_INT_CLEAR1 (0x0028)
159 #define COH901318_BE_INT_CLEAR2 (0x002C)
160 /* RAW_BE_INT_STATUS - Raw Term Count Interrupt Status Registers 32bit (R/-) */
161 #define COH901318_RAW_BE_INT_STATUS1 (0x0030)
162 #define COH901318_RAW_BE_INT_STATUS2 (0x0034)
165 * CX_CFG - Channel Configuration Registers 32bit (R/W)
167 #define COH901318_CX_CFG (0x0100)
168 #define COH901318_CX_CFG_SPACING (0x04)
169 /* Channel enable activates tha dma job */
170 #define COH901318_CX_CFG_CH_ENABLE (0x00000001)
171 #define COH901318_CX_CFG_CH_DISABLE (0x00000000)
173 #define COH901318_CX_CFG_RM_MASK (0x00000006)
174 #define COH901318_CX_CFG_RM_MEMORY_TO_MEMORY (0x0 << 1)
175 #define COH901318_CX_CFG_RM_PRIMARY_TO_MEMORY (0x1 << 1)
176 #define COH901318_CX_CFG_RM_MEMORY_TO_PRIMARY (0x1 << 1)
177 #define COH901318_CX_CFG_RM_PRIMARY_TO_SECONDARY (0x3 << 1)
178 #define COH901318_CX_CFG_RM_SECONDARY_TO_PRIMARY (0x3 << 1)
179 /* Linked channel request field. RM must == 11 */
180 #define COH901318_CX_CFG_LCRF_SHIFT 3
181 #define COH901318_CX_CFG_LCRF_MASK (0x000001F8)
182 #define COH901318_CX_CFG_LCR_DISABLE (0x00000000)
183 /* Terminal Counter Interrupt Request Mask */
184 #define COH901318_CX_CFG_TC_IRQ_ENABLE (0x00000200)
185 #define COH901318_CX_CFG_TC_IRQ_DISABLE (0x00000000)
186 /* Bus Error interrupt Mask */
187 #define COH901318_CX_CFG_BE_IRQ_ENABLE (0x00000400)
188 #define COH901318_CX_CFG_BE_IRQ_DISABLE (0x00000000)
191 * CX_STAT - Channel Status Registers 32bit (R/-)
193 #define COH901318_CX_STAT (0x0200)
194 #define COH901318_CX_STAT_SPACING (0x04)
195 #define COH901318_CX_STAT_RBE_IRQ_IND (0x00000008)
196 #define COH901318_CX_STAT_RTC_IRQ_IND (0x00000004)
197 #define COH901318_CX_STAT_ACTIVE (0x00000002)
198 #define COH901318_CX_STAT_ENABLED (0x00000001)
201 * CX_CTRL - Channel Control Registers 32bit (R/W)
203 #define COH901318_CX_CTRL (0x0400)
204 #define COH901318_CX_CTRL_SPACING (0x10)
205 /* Transfer Count Enable */
206 #define COH901318_CX_CTRL_TC_ENABLE (0x00001000)
207 #define COH901318_CX_CTRL_TC_DISABLE (0x00000000)
208 /* Transfer Count Value 0 - 4095 */
209 #define COH901318_CX_CTRL_TC_VALUE_MASK (0x00000FFF)
211 #define COH901318_CX_CTRL_BURST_COUNT_MASK (0x0000E000)
212 #define COH901318_CX_CTRL_BURST_COUNT_64_BYTES (0x7 << 13)
213 #define COH901318_CX_CTRL_BURST_COUNT_48_BYTES (0x6 << 13)
214 #define COH901318_CX_CTRL_BURST_COUNT_32_BYTES (0x5 << 13)
215 #define COH901318_CX_CTRL_BURST_COUNT_16_BYTES (0x4 << 13)
216 #define COH901318_CX_CTRL_BURST_COUNT_8_BYTES (0x3 << 13)
217 #define COH901318_CX_CTRL_BURST_COUNT_4_BYTES (0x2 << 13)
218 #define COH901318_CX_CTRL_BURST_COUNT_2_BYTES (0x1 << 13)
219 #define COH901318_CX_CTRL_BURST_COUNT_1_BYTE (0x0 << 13)
220 /* Source bus size */
221 #define COH901318_CX_CTRL_SRC_BUS_SIZE_MASK (0x00030000)
222 #define COH901318_CX_CTRL_SRC_BUS_SIZE_32_BITS (0x2 << 16)
223 #define COH901318_CX_CTRL_SRC_BUS_SIZE_16_BITS (0x1 << 16)
224 #define COH901318_CX_CTRL_SRC_BUS_SIZE_8_BITS (0x0 << 16)
225 /* Source address increment */
226 #define COH901318_CX_CTRL_SRC_ADDR_INC_ENABLE (0x00040000)
227 #define COH901318_CX_CTRL_SRC_ADDR_INC_DISABLE (0x00000000)
228 /* Destination Bus Size */
229 #define COH901318_CX_CTRL_DST_BUS_SIZE_MASK (0x00180000)
230 #define COH901318_CX_CTRL_DST_BUS_SIZE_32_BITS (0x2 << 19)
231 #define COH901318_CX_CTRL_DST_BUS_SIZE_16_BITS (0x1 << 19)
232 #define COH901318_CX_CTRL_DST_BUS_SIZE_8_BITS (0x0 << 19)
233 /* Destination address increment */
234 #define COH901318_CX_CTRL_DST_ADDR_INC_ENABLE (0x00200000)
235 #define COH901318_CX_CTRL_DST_ADDR_INC_DISABLE (0x00000000)
236 /* Master Mode (Master2 is only connected to MSL) */
237 #define COH901318_CX_CTRL_MASTER_MODE_MASK (0x00C00000)
238 #define COH901318_CX_CTRL_MASTER_MODE_M2R_M1W (0x3 << 22)
239 #define COH901318_CX_CTRL_MASTER_MODE_M1R_M2W (0x2 << 22)
240 #define COH901318_CX_CTRL_MASTER_MODE_M2RW (0x1 << 22)
241 #define COH901318_CX_CTRL_MASTER_MODE_M1RW (0x0 << 22)
242 /* Terminal Count flag to PER enable */
243 #define COH901318_CX_CTRL_TCP_ENABLE (0x01000000)
244 #define COH901318_CX_CTRL_TCP_DISABLE (0x00000000)
245 /* Terminal Count flags to CPU enable */
246 #define COH901318_CX_CTRL_TC_IRQ_ENABLE (0x02000000)
247 #define COH901318_CX_CTRL_TC_IRQ_DISABLE (0x00000000)
248 /* Hand shake to peripheral */
249 #define COH901318_CX_CTRL_HSP_ENABLE (0x04000000)
250 #define COH901318_CX_CTRL_HSP_DISABLE (0x00000000)
251 #define COH901318_CX_CTRL_HSS_ENABLE (0x08000000)
252 #define COH901318_CX_CTRL_HSS_DISABLE (0x00000000)
254 #define COH901318_CX_CTRL_DDMA_MASK (0x30000000)
255 #define COH901318_CX_CTRL_DDMA_LEGACY (0x0 << 28)
256 #define COH901318_CX_CTRL_DDMA_DEMAND_DMA1 (0x1 << 28)
257 #define COH901318_CX_CTRL_DDMA_DEMAND_DMA2 (0x2 << 28)
258 /* Primary Request Data Destination */
259 #define COH901318_CX_CTRL_PRDD_MASK (0x40000000)
260 #define COH901318_CX_CTRL_PRDD_DEST (0x1 << 30)
261 #define COH901318_CX_CTRL_PRDD_SOURCE (0x0 << 30)
264 * CX_SRC_ADDR - Channel Source Address Registers 32bit (R/W)
266 #define COH901318_CX_SRC_ADDR (0x0404)
267 #define COH901318_CX_SRC_ADDR_SPACING (0x10)
270 * CX_DST_ADDR - Channel Destination Address Registers 32bit R/W
272 #define COH901318_CX_DST_ADDR (0x0408)
273 #define COH901318_CX_DST_ADDR_SPACING (0x10)
276 * CX_LNK_ADDR - Channel Link Address Registers 32bit (R/W)
278 #define COH901318_CX_LNK_ADDR (0x040C)
279 #define COH901318_CX_LNK_ADDR_SPACING (0x10)
280 #define COH901318_CX_LNK_LINK_IMMEDIATE (0x00000001)
281 #endif /* COH901318_H */