2 * IBM PPC4xx DMA engine scatter/gather library
4 * Copyright 2002-2003 MontaVista Software Inc.
6 * Cleaned up and converted to new DCR access
7 * Matt Porter <mporter@kernel.crashing.org>
9 * Original code by Armin Kuster <akuster@mvista.com>
10 * and Pete Popov <ppopov@mvista.com>
12 * This program is free software; you can redistribute it and/or modify it
13 * under the terms of the GNU General Public License as published by the
14 * Free Software Foundation; either version 2 of the License, or (at your
15 * option) any later version.
17 * You should have received a copy of the GNU General Public License along
18 * with this program; if not, write to the Free Software Foundation, Inc.,
19 * 675 Mass Ave, Cambridge, MA 02139, USA.
22 #include <linux/kernel.h>
24 #include <linux/init.h>
25 #include <linux/module.h>
26 #include <linux/pci.h>
28 #include <asm/system.h>
30 #include <asm/ppc4xx_dma.h>
33 ppc4xx_set_sg_addr(int dmanr
, phys_addr_t sg_addr
)
35 if (dmanr
>= MAX_PPC4xx_DMA_CHANNELS
) {
36 printk("ppc4xx_set_sg_addr: bad channel: %d\n", dmanr
);
40 #ifdef PPC4xx_DMA_64BIT
41 mtdcr(DCRN_ASGH0
+ (dmanr
* 0x8), (u32
)(sg_addr
>> 32));
43 mtdcr(DCRN_ASG0
+ (dmanr
* 0x8), (u32
)sg_addr
);
47 * Add a new sgl descriptor to the end of a scatter/gather list
48 * which was created by alloc_dma_handle().
50 * For a memory to memory transfer, both dma addresses must be
51 * valid. For a peripheral to memory transfer, one of the addresses
52 * must be set to NULL, depending on the direction of the transfer:
53 * memory to peripheral: set dst_addr to NULL,
54 * peripheral to memory: set src_addr to NULL.
57 ppc4xx_add_dma_sgl(sgl_handle_t handle
, phys_addr_t src_addr
, phys_addr_t dst_addr
,
60 sgl_list_info_t
*psgl
= (sgl_list_info_t
*) handle
;
61 ppc_dma_ch_t
*p_dma_ch
;
64 printk("ppc4xx_add_dma_sgl: null handle\n");
65 return DMA_STATUS_BAD_HANDLE
;
68 if (psgl
->dmanr
>= MAX_PPC4xx_DMA_CHANNELS
) {
69 printk("ppc4xx_add_dma_sgl: bad channel: %d\n", psgl
->dmanr
);
70 return DMA_STATUS_BAD_CHANNEL
;
73 p_dma_ch
= &dma_channels
[psgl
->dmanr
];
78 unsigned int aligned
=
79 (unsigned) src_addr
| (unsigned) dst_addr
| count
;
80 switch (p_dma_ch
->pwidth
) {
96 printk("ppc4xx_add_dma_sgl: invalid bus width: 0x%x\n",
98 return DMA_STATUS_GENERAL_ERROR
;
102 ("Alignment warning: ppc4xx_add_dma_sgl src 0x%x dst 0x%x count 0x%x bus width var %d\n",
103 src_addr
, dst_addr
, count
, p_dma_ch
->pwidth
);
108 if ((unsigned) (psgl
->ptail
+ 1) >= ((unsigned) psgl
+ SGL_LIST_SIZE
)) {
109 printk("sgl handle out of memory \n");
110 return DMA_STATUS_OUT_OF_MEMORY
;
114 psgl
->phead
= (ppc_sgl_t
*)
115 ((unsigned) psgl
+ sizeof (sgl_list_info_t
));
116 psgl
->phead_dma
= psgl
->dma_addr
+ sizeof(sgl_list_info_t
);
117 psgl
->ptail
= psgl
->phead
;
118 psgl
->ptail_dma
= psgl
->phead_dma
;
120 if(p_dma_ch
->int_on_final_sg
) {
121 /* mask out all dma interrupts, except error, on tail
122 before adding new tail. */
123 psgl
->ptail
->control_count
&=
124 ~(SG_TCI_ENABLE
| SG_ETI_ENABLE
);
126 psgl
->ptail
->next
= psgl
->ptail_dma
+ sizeof(ppc_sgl_t
);
128 psgl
->ptail_dma
+= sizeof(ppc_sgl_t
);
131 psgl
->ptail
->control
= psgl
->control
;
132 psgl
->ptail
->src_addr
= src_addr
;
133 psgl
->ptail
->dst_addr
= dst_addr
;
134 psgl
->ptail
->control_count
= (count
>> p_dma_ch
->shift
) |
136 psgl
->ptail
->next
= (uint32_t) NULL
;
138 return DMA_STATUS_GOOD
;
142 * Enable (start) the DMA described by the sgl handle.
145 ppc4xx_enable_dma_sgl(sgl_handle_t handle
)
147 sgl_list_info_t
*psgl
= (sgl_list_info_t
*) handle
;
148 ppc_dma_ch_t
*p_dma_ch
;
152 printk("ppc4xx_enable_dma_sgl: null handle\n");
154 } else if (psgl
->dmanr
> (MAX_PPC4xx_DMA_CHANNELS
- 1)) {
155 printk("ppc4xx_enable_dma_sgl: bad channel in handle %d\n",
158 } else if (!psgl
->phead
) {
159 printk("ppc4xx_enable_dma_sgl: sg list empty\n");
163 p_dma_ch
= &dma_channels
[psgl
->dmanr
];
164 psgl
->ptail
->control_count
&= ~SG_LINK
; /* make this the last dscrptr */
165 sg_command
= mfdcr(DCRN_ASGC
);
167 ppc4xx_set_sg_addr(psgl
->dmanr
, psgl
->phead_dma
);
169 sg_command
|= SSG_ENABLE(psgl
->dmanr
);
171 mtdcr(DCRN_ASGC
, sg_command
); /* start transfer */
175 * Halt an active scatter/gather DMA operation.
178 ppc4xx_disable_dma_sgl(sgl_handle_t handle
)
180 sgl_list_info_t
*psgl
= (sgl_list_info_t
*) handle
;
184 printk("ppc4xx_enable_dma_sgl: null handle\n");
186 } else if (psgl
->dmanr
> (MAX_PPC4xx_DMA_CHANNELS
- 1)) {
187 printk("ppc4xx_enable_dma_sgl: bad channel in handle %d\n",
192 sg_command
= mfdcr(DCRN_ASGC
);
193 sg_command
&= ~SSG_ENABLE(psgl
->dmanr
);
194 mtdcr(DCRN_ASGC
, sg_command
); /* stop transfer */
198 * Returns number of bytes left to be transferred from the entire sgl list.
199 * *src_addr and *dst_addr get set to the source/destination address of
200 * the sgl descriptor where the DMA stopped.
202 * An sgl transfer must NOT be active when this function is called.
205 ppc4xx_get_dma_sgl_residue(sgl_handle_t handle
, phys_addr_t
* src_addr
,
206 phys_addr_t
* dst_addr
)
208 sgl_list_info_t
*psgl
= (sgl_list_info_t
*) handle
;
209 ppc_dma_ch_t
*p_dma_ch
;
210 ppc_sgl_t
*pnext
, *sgl_addr
;
214 printk("ppc4xx_get_dma_sgl_residue: null handle\n");
215 return DMA_STATUS_BAD_HANDLE
;
216 } else if (psgl
->dmanr
> (MAX_PPC4xx_DMA_CHANNELS
- 1)) {
217 printk("ppc4xx_get_dma_sgl_residue: bad channel in handle %d\n",
219 return DMA_STATUS_BAD_CHANNEL
;
222 sgl_addr
= (ppc_sgl_t
*) __va(mfdcr(DCRN_ASG0
+ (psgl
->dmanr
* 0x8)));
223 count_left
= mfdcr(DCRN_DMACT0
+ (psgl
->dmanr
* 0x8)) & SG_COUNT_MASK
;
226 printk("ppc4xx_get_dma_sgl_residue: sgl addr register is null\n");
232 ((unsigned) pnext
< ((unsigned) psgl
+ SGL_LIST_SIZE
) &&
238 if (pnext
== sgl_addr
) { /* found the sgl descriptor */
240 *src_addr
= pnext
->src_addr
;
241 *dst_addr
= pnext
->dst_addr
;
244 * Now search the remaining descriptors and add their count.
245 * We already have the remaining count from this descriptor in
250 while ((pnext
!= psgl
->ptail
) &&
251 ((unsigned) pnext
< ((unsigned) psgl
+ SGL_LIST_SIZE
))
253 count_left
+= pnext
->control_count
& SG_COUNT_MASK
;
256 if (pnext
!= psgl
->ptail
) { /* should never happen */
258 ("ppc4xx_get_dma_sgl_residue error (1) psgl->ptail 0x%x handle 0x%x\n",
259 (unsigned int) psgl
->ptail
, (unsigned int) handle
);
264 p_dma_ch
= &dma_channels
[psgl
->dmanr
];
265 return (count_left
<< p_dma_ch
->shift
); /* count in bytes */
268 /* this shouldn't happen */
270 ("get_dma_sgl_residue, unable to match current address 0x%x, handle 0x%x\n",
271 (unsigned int) sgl_addr
, (unsigned int) handle
);
276 *src_addr
= (phys_addr_t
) NULL
;
277 *dst_addr
= (phys_addr_t
) NULL
;
282 * Returns the address(es) of the buffer(s) contained in the head element of
283 * the scatter/gather list. The element is removed from the scatter/gather
284 * list and the next element becomes the head.
286 * This function should only be called when the DMA is not active.
289 ppc4xx_delete_dma_sgl_element(sgl_handle_t handle
, phys_addr_t
* src_dma_addr
,
290 phys_addr_t
* dst_dma_addr
)
292 sgl_list_info_t
*psgl
= (sgl_list_info_t
*) handle
;
295 printk("ppc4xx_delete_sgl_element: null handle\n");
296 return DMA_STATUS_BAD_HANDLE
;
297 } else if (psgl
->dmanr
> (MAX_PPC4xx_DMA_CHANNELS
- 1)) {
298 printk("ppc4xx_delete_sgl_element: bad channel in handle %d\n",
300 return DMA_STATUS_BAD_CHANNEL
;
304 printk("ppc4xx_delete_sgl_element: sgl list empty\n");
305 *src_dma_addr
= (phys_addr_t
) NULL
;
306 *dst_dma_addr
= (phys_addr_t
) NULL
;
307 return DMA_STATUS_SGL_LIST_EMPTY
;
310 *src_dma_addr
= (phys_addr_t
) psgl
->phead
->src_addr
;
311 *dst_dma_addr
= (phys_addr_t
) psgl
->phead
->dst_addr
;
313 if (psgl
->phead
== psgl
->ptail
) {
314 /* last descriptor on the list */
319 psgl
->phead_dma
+= sizeof(ppc_sgl_t
);
322 return DMA_STATUS_GOOD
;
327 * Create a scatter/gather list handle. This is simply a structure which
328 * describes a scatter/gather list.
330 * A handle is returned in "handle" which the driver should save in order to
331 * be able to access this list later. A chunk of memory will be allocated
332 * to be used by the API for internal management purposes, including managing
333 * the sg list and allocating memory for the sgl descriptors. One page should
334 * be more than enough for that purpose. Perhaps it's a bit wasteful to use
335 * a whole page for a single sg list, but most likely there will be only one
336 * sg list per channel.
339 * Each sgl descriptor has a copy of the DMA control word which the DMA engine
340 * loads in the control register. The control word has a "global" interrupt
341 * enable bit for that channel. Interrupts are further qualified by a few bits
342 * in the sgl descriptor count register. In order to setup an sgl, we have to
343 * know ahead of time whether or not interrupts will be enabled at the completion
344 * of the transfers. Thus, enable_dma_interrupt()/disable_dma_interrupt() MUST
345 * be called before calling alloc_dma_handle(). If the interrupt mode will never
346 * change after powerup, then enable_dma_interrupt()/disable_dma_interrupt()
347 * do not have to be called -- interrupts will be enabled or disabled based
348 * on how the channel was configured after powerup by the hw_init_dma_channel()
349 * function. Each sgl descriptor will be setup to interrupt if an error occurs;
350 * however, only the last descriptor will be setup to interrupt. Thus, an
351 * interrupt will occur (if interrupts are enabled) only after the complete
352 * sgl transfer is done.
355 ppc4xx_alloc_dma_handle(sgl_handle_t
* phandle
, unsigned int mode
, unsigned int dmanr
)
357 sgl_list_info_t
*psgl
=NULL
;
359 ppc_dma_ch_t
*p_dma_ch
= &dma_channels
[dmanr
];
361 uint32_t ctc_settings
;
364 if (dmanr
>= MAX_PPC4xx_DMA_CHANNELS
) {
365 printk("ppc4xx_alloc_dma_handle: invalid channel 0x%x\n", dmanr
);
366 return DMA_STATUS_BAD_CHANNEL
;
370 printk("ppc4xx_alloc_dma_handle: null handle pointer\n");
371 return DMA_STATUS_NULL_POINTER
;
374 /* Get a page of memory, which is zeroed out by consistent_alloc() */
375 ret
= dma_alloc_coherent(NULL
, DMA_PPC4xx_SIZE
, &dma_addr
, GFP_KERNEL
);
377 memset(ret
, 0, DMA_PPC4xx_SIZE
);
378 psgl
= (sgl_list_info_t
*) ret
;
382 *phandle
= (sgl_handle_t
) NULL
;
383 return DMA_STATUS_OUT_OF_MEMORY
;
386 psgl
->dma_addr
= dma_addr
;
390 * Modify and save the control word. These words will be
391 * written to each sgl descriptor. The DMA engine then
392 * loads this control word into the control register
393 * every time it reads a new descriptor.
395 psgl
->control
= p_dma_ch
->control
;
396 /* Clear all mode bits */
397 psgl
->control
&= ~(DMA_TM_MASK
| DMA_TD
);
398 /* Save control word and mode */
399 psgl
->control
|= (mode
| DMA_CE_ENABLE
);
401 /* In MM mode, we must set ETD/TCE */
402 if (mode
== DMA_MODE_MM
)
403 psgl
->control
|= DMA_ETD_OUTPUT
| DMA_TCE_ENABLE
;
405 if (p_dma_ch
->int_enable
) {
406 /* Enable channel interrupt */
407 psgl
->control
|= DMA_CIE_ENABLE
;
409 psgl
->control
&= ~DMA_CIE_ENABLE
;
412 sg_command
= mfdcr(DCRN_ASGC
);
413 sg_command
|= SSG_MASK_ENABLE(dmanr
);
415 /* Enable SGL control access */
416 mtdcr(DCRN_ASGC
, sg_command
);
417 psgl
->sgl_control
= SG_ERI_ENABLE
| SG_LINK
;
419 /* keep control count register settings */
420 ctc_settings
= mfdcr(DCRN_DMACT0
+ (dmanr
* 0x8))
421 & (DMA_CTC_BSIZ_MSK
| DMA_CTC_BTEN
); /*burst mode settings*/
422 psgl
->sgl_control
|= ctc_settings
;
424 if (p_dma_ch
->int_enable
) {
425 if (p_dma_ch
->tce_enable
)
426 psgl
->sgl_control
|= SG_TCI_ENABLE
;
428 psgl
->sgl_control
|= SG_ETI_ENABLE
;
431 *phandle
= (sgl_handle_t
) psgl
;
432 return DMA_STATUS_GOOD
;
436 * Destroy a scatter/gather list handle that was created by alloc_dma_handle().
437 * The list must be empty (contain no elements).
440 ppc4xx_free_dma_handle(sgl_handle_t handle
)
442 sgl_list_info_t
*psgl
= (sgl_list_info_t
*) handle
;
445 printk("ppc4xx_free_dma_handle: got NULL\n");
447 } else if (psgl
->phead
) {
448 printk("ppc4xx_free_dma_handle: list not empty\n");
450 } else if (!psgl
->dma_addr
) { /* should never happen */
451 printk("ppc4xx_free_dma_handle: no dma address\n");
455 dma_free_coherent(NULL
, DMA_PPC4xx_SIZE
, (void *) psgl
, 0);
458 EXPORT_SYMBOL(ppc4xx_alloc_dma_handle
);
459 EXPORT_SYMBOL(ppc4xx_free_dma_handle
);
460 EXPORT_SYMBOL(ppc4xx_add_dma_sgl
);
461 EXPORT_SYMBOL(ppc4xx_delete_dma_sgl_element
);
462 EXPORT_SYMBOL(ppc4xx_enable_dma_sgl
);
463 EXPORT_SYMBOL(ppc4xx_disable_dma_sgl
);
464 EXPORT_SYMBOL(ppc4xx_get_dma_sgl_residue
);