2 * Copyright (c) 1997, 1998 Justin T. Gibbs.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions, and the following disclaimer,
10 * without modification, immediately at the beginning of the file.
11 * 2. The name of the author may not be used to endorse or promote products
12 * derived from this software without specific prior written permission.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
18 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * $FreeBSD: src/sys/i386/i386/busdma_machdep.c,v 1.16.2.2 2003/01/23 00:55:27 scottl Exp $
27 * $DragonFly: src/sys/i386/i386/Attic/busdma_machdep.c,v 1.3 2003/06/25 03:55:53 dillon Exp $
30 #include <sys/param.h>
31 #include <sys/systm.h>
32 #include <sys/malloc.h>
37 #include <vm/vm_page.h>
39 /* XXX needed for to access pmap to convert per-proc virtual to physical */
42 #include <vm/vm_map.h>
44 #include <machine/bus.h>
45 #include <machine/md_var.h>
47 #define MAX(a,b) (((a) > (b)) ? (a) : (b))
48 #define MIN(a,b) (((a) < (b)) ? (a) : (b))
49 #define MAX_BPAGES 128
57 bus_dma_filter_t *filter;
68 vm_offset_t vaddr; /* kva of bounce buffer */
69 bus_addr_t busaddr; /* Physical address */
70 vm_offset_t datavaddr; /* kva of client data */
71 bus_size_t datacount; /* client data count */
72 STAILQ_ENTRY(bounce_page) links;
75 int busdma_swi_pending;
77 static STAILQ_HEAD(bp_list, bounce_page) bounce_page_list;
78 static int free_bpages;
79 static int reserved_bpages;
80 static int active_bpages;
81 static int total_bpages;
82 static bus_addr_t bounce_lowaddr = BUS_SPACE_MAXADDR;
85 struct bp_list bpages;
89 void *buf; /* unmapped buffer pointer */
90 bus_size_t buflen; /* unmapped buffer length */
91 bus_dmamap_callback_t *callback;
93 STAILQ_ENTRY(bus_dmamap) links;
96 static STAILQ_HEAD(, bus_dmamap) bounce_map_waitinglist;
97 static STAILQ_HEAD(, bus_dmamap) bounce_map_callbacklist;
98 static struct bus_dmamap nobounce_dmamap;
100 static int alloc_bounce_pages(bus_dma_tag_t dmat, u_int numpages);
101 static int reserve_bounce_pages(bus_dma_tag_t dmat, bus_dmamap_t map);
102 static vm_offset_t add_bounce_page(bus_dma_tag_t dmat, bus_dmamap_t map,
103 vm_offset_t vaddr, bus_size_t size);
104 static void free_bounce_page(bus_dma_tag_t dmat, struct bounce_page *bpage);
105 static __inline int run_filter(bus_dma_tag_t dmat, bus_addr_t paddr);
108 run_filter(bus_dma_tag_t dmat, bus_addr_t paddr)
114 if (paddr > dmat->lowaddr
115 && paddr <= dmat->highaddr
116 && (dmat->filter == NULL
117 || (*dmat->filter)(dmat->filterarg, paddr) != 0))
121 } while (retval == 0 && dmat != NULL);
125 #define BUS_DMA_MIN_ALLOC_COMP BUS_DMA_BUS4
127 * Allocate a device specific dma_tag.
130 bus_dma_tag_create(bus_dma_tag_t parent, bus_size_t alignment,
131 bus_size_t boundary, bus_addr_t lowaddr,
132 bus_addr_t highaddr, bus_dma_filter_t *filter,
133 void *filterarg, bus_size_t maxsize, int nsegments,
134 bus_size_t maxsegsz, int flags, bus_dma_tag_t *dmat)
136 bus_dma_tag_t newtag;
139 /* Return a NULL tag on failure */
142 newtag = (bus_dma_tag_t)malloc(sizeof(*newtag), M_DEVBUF, M_NOWAIT);
146 newtag->parent = parent;
147 newtag->alignment = alignment;
148 newtag->boundary = boundary;
149 newtag->lowaddr = trunc_page((vm_offset_t)lowaddr) + (PAGE_SIZE - 1);
150 newtag->highaddr = trunc_page((vm_offset_t)highaddr) + (PAGE_SIZE - 1);
151 newtag->filter = filter;
152 newtag->filterarg = filterarg;
153 newtag->maxsize = maxsize;
154 newtag->nsegments = nsegments;
155 newtag->maxsegsz = maxsegsz;
156 newtag->flags = flags;
157 newtag->ref_count = 1; /* Count ourself */
158 newtag->map_count = 0;
160 /* Take into account any restrictions imposed by our parent tag */
161 if (parent != NULL) {
162 newtag->lowaddr = MIN(parent->lowaddr, newtag->lowaddr);
163 newtag->highaddr = MAX(parent->highaddr, newtag->highaddr);
165 * XXX Not really correct??? Probably need to honor boundary
166 * all the way up the inheritence chain.
168 newtag->boundary = MAX(parent->boundary, newtag->boundary);
169 if (newtag->filter == NULL) {
171 * Short circuit looking at our parent directly
172 * since we have encapsulated all of its information
174 newtag->filter = parent->filter;
175 newtag->filterarg = parent->filterarg;
176 newtag->parent = parent->parent;
178 if (newtag->parent != NULL) {
183 if (newtag->lowaddr < ptoa(Maxmem) && (flags & BUS_DMA_ALLOCNOW) != 0) {
186 if (lowaddr > bounce_lowaddr) {
188 * Go through the pool and kill any pages
189 * that don't reside below lowaddr.
191 panic("bus_dma_tag_create: page reallocation "
194 if (ptoa(total_bpages) < maxsize) {
197 pages = atop(maxsize) - total_bpages;
199 /* Add pages to our bounce pool */
200 if (alloc_bounce_pages(newtag, pages) < pages)
203 /* Performed initial allocation */
204 newtag->flags |= BUS_DMA_MIN_ALLOC_COMP;
208 free(newtag, M_DEVBUF);
216 bus_dma_tag_destroy(bus_dma_tag_t dmat)
220 if (dmat->map_count != 0)
223 while (dmat != NULL) {
224 bus_dma_tag_t parent;
226 parent = dmat->parent;
228 if (dmat->ref_count == 0) {
229 free(dmat, M_DEVBUF);
231 * Last reference count, so
232 * release our reference
233 * count on our parent.
244 * Allocate a handle for mapping from kva/uva/physical
245 * address space into bus device space.
248 bus_dmamap_create(bus_dma_tag_t dmat, int flags, bus_dmamap_t *mapp)
254 if (dmat->lowaddr < ptoa(Maxmem)) {
258 *mapp = (bus_dmamap_t)malloc(sizeof(**mapp), M_DEVBUF,
263 /* Initialize the new map */
264 bzero(*mapp, sizeof(**mapp));
265 STAILQ_INIT(&((*mapp)->bpages));
268 * Attempt to add pages to our pool on a per-instance
269 * basis up to a sane limit.
271 maxpages = MIN(MAX_BPAGES, Maxmem - atop(dmat->lowaddr));
272 if ((dmat->flags & BUS_DMA_MIN_ALLOC_COMP) == 0
273 || (dmat->map_count > 0
274 && total_bpages < maxpages)) {
277 if (dmat->lowaddr > bounce_lowaddr) {
279 * Go through the pool and kill any pages
280 * that don't reside below lowaddr.
282 panic("bus_dmamap_create: page reallocation "
285 pages = atop(dmat->maxsize);
286 pages = MIN(maxpages - total_bpages, pages);
287 error = alloc_bounce_pages(dmat, pages);
289 if ((dmat->flags & BUS_DMA_MIN_ALLOC_COMP) == 0) {
291 dmat->flags |= BUS_DMA_MIN_ALLOC_COMP;
305 * Destroy a handle for mapping from kva/uva/physical
306 * address space into bus device space.
309 bus_dmamap_destroy(bus_dma_tag_t dmat, bus_dmamap_t map)
312 if (STAILQ_FIRST(&map->bpages) != NULL)
322 * Allocate a piece of memory that can be efficiently mapped into
323 * bus device space based on the constraints lited in the dma tag.
324 * A dmamap to for use with dmamap_load is also allocated.
327 bus_dmamem_alloc(bus_dma_tag_t dmat, void** vaddr, int flags,
330 /* If we succeed, no mapping/bouncing will be required */
333 if ((dmat->maxsize <= PAGE_SIZE) && dmat->lowaddr >= ptoa(Maxmem)) {
334 *vaddr = malloc(dmat->maxsize, M_DEVBUF,
335 (flags & BUS_DMA_NOWAIT) ? M_NOWAIT : M_WAITOK);
338 * XXX Use Contigmalloc until it is merged into this facility
339 * and handles multi-seg allocations. Nobody is doing
340 * multi-seg allocations yet though.
342 *vaddr = contigmalloc(dmat->maxsize, M_DEVBUF,
343 (flags & BUS_DMA_NOWAIT) ? M_NOWAIT : M_WAITOK,
344 0ul, dmat->lowaddr, dmat->alignment? dmat->alignment : 1ul,
353 * Free a piece of memory and it's allociated dmamap, that was allocated
354 * via bus_dmamem_alloc. Make the same choice for free/contigfree.
357 bus_dmamem_free(bus_dma_tag_t dmat, void *vaddr, bus_dmamap_t map)
360 * dmamem does not need to be bounced, so the map should be
364 panic("bus_dmamem_free: Invalid map freed\n");
365 if ((dmat->maxsize <= PAGE_SIZE) && dmat->lowaddr >= ptoa(Maxmem))
366 free(vaddr, M_DEVBUF);
368 contigfree(vaddr, dmat->maxsize, M_DEVBUF);
371 #define BUS_DMAMAP_NSEGS ((BUS_SPACE_MAXSIZE / PAGE_SIZE) + 1)
374 * Map the buffer buf into bus space using the dmamap map.
377 bus_dmamap_load(bus_dma_tag_t dmat, bus_dmamap_t map, void *buf,
378 bus_size_t buflen, bus_dmamap_callback_t *callback,
379 void *callback_arg, int flags)
384 bus_dma_segment_t dm_segments[dmat->nsegments];
386 bus_dma_segment_t dm_segments[BUS_DMAMAP_NSEGS];
388 bus_dma_segment_t *sg;
391 vm_offset_t nextpaddr;
394 map = &nobounce_dmamap;
398 * If we are being called during a callback, pagesneeded will
399 * be non-zero, so we can avoid doing the work twice.
401 if (dmat->lowaddr < ptoa(Maxmem) && map->pagesneeded == 0) {
402 vm_offset_t vendaddr;
405 * Count the number of bounce pages
406 * needed in order to complete this transfer
408 vaddr = trunc_page((vm_offset_t)buf);
409 vendaddr = (vm_offset_t)buf + buflen;
411 while (vaddr < vendaddr) {
412 paddr = pmap_kextract(vaddr);
413 if (run_filter(dmat, paddr) != 0) {
421 /* Reserve Necessary Bounce Pages */
422 if (map->pagesneeded != 0) {
426 if (reserve_bounce_pages(dmat, map) != 0) {
428 /* Queue us for resources */
431 map->buflen = buflen;
432 map->callback = callback;
433 map->callback_arg = callback_arg;
435 STAILQ_INSERT_TAIL(&bounce_map_waitinglist, map, links);
438 return (EINPROGRESS);
443 vaddr = (vm_offset_t)buf;
444 sg = &dm_segments[0];
452 paddr = pmap_kextract(vaddr);
453 size = PAGE_SIZE - (paddr & PAGE_MASK);
457 if (map->pagesneeded != 0 && run_filter(dmat, paddr)) {
458 paddr = add_bounce_page(dmat, map, vaddr, size);
461 if (sg->ds_len == 0) {
464 } else if (paddr == nextpaddr) {
467 /* Go to the next segment */
470 if (seg > dmat->nsegments)
476 nextpaddr = paddr + size;
479 } while (buflen > 0);
482 printf("bus_dmamap_load: Too many segs! buf_len = 0x%lx\n",
487 (*callback)(callback_arg, dm_segments, seg, error);
493 * Utility function to load a linear buffer. lastaddrp holds state
494 * between invocations (for multiple-buffer loads). segp contains
495 * the starting segment on entrace, and the ending segment on exit.
496 * first indicates if this is the first invocation of this function.
499 _bus_dmamap_load_buffer(bus_dma_tag_t dmat,
500 bus_dma_segment_t segs[],
501 void *buf, bus_size_t buflen,
504 vm_offset_t *lastaddrp,
509 bus_addr_t curaddr, lastaddr, baddr, bmask;
510 vm_offset_t vaddr = (vm_offset_t)buf;
514 if (td->td_proc != NULL)
515 pmap = vmspace_pmap(td->td_proc->p_vmspace);
519 lastaddr = *lastaddrp;
520 bmask = ~(dmat->boundary - 1);
522 for (seg = *segp; buflen > 0 ; ) {
524 * Get the physical address for this segment.
527 curaddr = pmap_extract(pmap, vaddr);
529 curaddr = pmap_kextract(vaddr);
532 * Compute the segment size, and adjust counts.
534 sgsize = PAGE_SIZE - ((u_long)curaddr & PAGE_MASK);
539 * Make sure we don't cross any boundaries.
541 if (dmat->boundary > 0) {
542 baddr = (curaddr + dmat->boundary) & bmask;
543 if (sgsize > (baddr - curaddr))
544 sgsize = (baddr - curaddr);
548 * Insert chunk into a segment, coalescing with
549 * previous segment if possible.
552 segs[seg].ds_addr = curaddr;
553 segs[seg].ds_len = sgsize;
556 if (curaddr == lastaddr &&
557 (segs[seg].ds_len + sgsize) <= dmat->maxsegsz &&
558 (dmat->boundary == 0 ||
559 (segs[seg].ds_addr & bmask) == (curaddr & bmask)))
560 segs[seg].ds_len += sgsize;
562 if (++seg >= dmat->nsegments)
564 segs[seg].ds_addr = curaddr;
565 segs[seg].ds_len = sgsize;
569 lastaddr = curaddr + sgsize;
575 *lastaddrp = lastaddr;
580 return (buflen != 0 ? EFBIG : 0); /* XXX better return value here? */
584 * Like _bus_dmamap_load(), but for mbufs.
587 bus_dmamap_load_mbuf(bus_dma_tag_t dmat, bus_dmamap_t map,
589 bus_dmamap_callback2_t *callback, void *callback_arg,
593 bus_dma_segment_t dm_segments[dmat->nsegments];
595 bus_dma_segment_t dm_segments[BUS_DMAMAP_NSEGS];
599 KASSERT(dmat->lowaddr >= ptoa(Maxmem) || map != NULL,
600 ("bus_dmamap_load_mbuf: No support for bounce pages!"));
601 KASSERT(m0->m_flags & M_PKTHDR,
602 ("bus_dmamap_load_mbuf: no packet header"));
606 if (m0->m_pkthdr.len <= dmat->maxsize) {
608 vm_offset_t lastaddr = 0;
611 for (m = m0; m != NULL && error == 0; m = m->m_next) {
612 error = _bus_dmamap_load_buffer(dmat,
615 NULL, flags, &lastaddr, &nsegs, first);
623 /* force "no valid mappings" in callback */
624 (*callback)(callback_arg, dm_segments, 0, 0, error);
626 (*callback)(callback_arg, dm_segments,
627 nsegs+1, m0->m_pkthdr.len, error);
633 * Like _bus_dmamap_load(), but for uios.
636 bus_dmamap_load_uio(bus_dma_tag_t dmat, bus_dmamap_t map,
638 bus_dmamap_callback2_t *callback, void *callback_arg,
641 vm_offset_t lastaddr;
643 bus_dma_segment_t dm_segments[dmat->nsegments];
645 bus_dma_segment_t dm_segments[BUS_DMAMAP_NSEGS];
647 int nsegs, error, first, i;
650 struct thread *td = NULL;
652 KASSERT(dmat->lowaddr >= ptoa(Maxmem) || map != NULL,
653 ("bus_dmamap_load_uio: No support for bounce pages!"));
655 resid = uio->uio_resid;
658 if (uio->uio_segflg == UIO_USERSPACE) {
660 KASSERT(td != NULL && td->td_proc != NULL,
661 ("bus_dmamap_load_uio: USERSPACE but no proc"));
667 for (i = 0; i < uio->uio_iovcnt && resid != 0 && !error; i++) {
669 * Now at the first iovec to load. Load each iovec
670 * until we have exhausted the residual count.
673 resid < iov[i].iov_len ? resid : iov[i].iov_len;
674 caddr_t addr = (caddr_t) iov[i].iov_base;
676 error = _bus_dmamap_load_buffer(dmat,
679 td, flags, &lastaddr, &nsegs, first);
686 /* force "no valid mappings" in callback */
687 (*callback)(callback_arg, dm_segments, 0, 0, error);
689 (*callback)(callback_arg, dm_segments,
690 nsegs+1, uio->uio_resid, error);
696 * Release the mapping held by map.
699 _bus_dmamap_unload(bus_dma_tag_t dmat, bus_dmamap_t map)
701 struct bounce_page *bpage;
703 while ((bpage = STAILQ_FIRST(&map->bpages)) != NULL) {
704 STAILQ_REMOVE_HEAD(&map->bpages, links);
705 free_bounce_page(dmat, bpage);
710 _bus_dmamap_sync(bus_dma_tag_t dmat, bus_dmamap_t map, bus_dmasync_op_t op)
712 struct bounce_page *bpage;
714 if ((bpage = STAILQ_FIRST(&map->bpages)) != NULL) {
717 * Handle data bouncing. We might also
718 * want to add support for invalidating
719 * the caches on broken hardware
722 case BUS_DMASYNC_PREWRITE:
723 while (bpage != NULL) {
724 bcopy((void *)bpage->datavaddr,
725 (void *)bpage->vaddr,
727 bpage = STAILQ_NEXT(bpage, links);
731 case BUS_DMASYNC_POSTREAD:
732 while (bpage != NULL) {
733 bcopy((void *)bpage->vaddr,
734 (void *)bpage->datavaddr,
736 bpage = STAILQ_NEXT(bpage, links);
739 case BUS_DMASYNC_PREREAD:
740 case BUS_DMASYNC_POSTWRITE:
748 alloc_bounce_pages(bus_dma_tag_t dmat, u_int numpages)
753 if (total_bpages == 0) {
754 STAILQ_INIT(&bounce_page_list);
755 STAILQ_INIT(&bounce_map_waitinglist);
756 STAILQ_INIT(&bounce_map_callbacklist);
759 while (numpages > 0) {
760 struct bounce_page *bpage;
763 bpage = (struct bounce_page *)malloc(sizeof(*bpage), M_DEVBUF,
768 bzero(bpage, sizeof(*bpage));
769 bpage->vaddr = (vm_offset_t)contigmalloc(PAGE_SIZE, M_DEVBUF,
774 if (bpage->vaddr == NULL) {
775 free(bpage, M_DEVBUF);
778 bpage->busaddr = pmap_kextract(bpage->vaddr);
780 STAILQ_INSERT_TAIL(&bounce_page_list, bpage, links);
791 reserve_bounce_pages(bus_dma_tag_t dmat, bus_dmamap_t map)
795 pages = MIN(free_bpages, map->pagesneeded - map->pagesreserved);
796 free_bpages -= pages;
797 reserved_bpages += pages;
798 map->pagesreserved += pages;
799 pages = map->pagesneeded - map->pagesreserved;
805 add_bounce_page(bus_dma_tag_t dmat, bus_dmamap_t map, vm_offset_t vaddr,
809 struct bounce_page *bpage;
811 if (map->pagesneeded == 0)
812 panic("add_bounce_page: map doesn't need any pages");
815 if (map->pagesreserved == 0)
816 panic("add_bounce_page: map doesn't need any pages");
817 map->pagesreserved--;
820 bpage = STAILQ_FIRST(&bounce_page_list);
822 panic("add_bounce_page: free page list is empty");
824 STAILQ_REMOVE_HEAD(&bounce_page_list, links);
829 bpage->datavaddr = vaddr;
830 bpage->datacount = size;
831 STAILQ_INSERT_TAIL(&(map->bpages), bpage, links);
832 return (bpage->busaddr);
836 free_bounce_page(bus_dma_tag_t dmat, struct bounce_page *bpage)
839 struct bus_dmamap *map;
841 bpage->datavaddr = 0;
842 bpage->datacount = 0;
845 STAILQ_INSERT_HEAD(&bounce_page_list, bpage, links);
848 if ((map = STAILQ_FIRST(&bounce_map_waitinglist)) != NULL) {
849 if (reserve_bounce_pages(map->dmat, map) == 0) {
850 STAILQ_REMOVE_HEAD(&bounce_map_waitinglist, links);
851 STAILQ_INSERT_TAIL(&bounce_map_callbacklist,
853 busdma_swi_pending = 1;
864 struct bus_dmamap *map;
867 while ((map = STAILQ_FIRST(&bounce_map_callbacklist)) != NULL) {
868 STAILQ_REMOVE_HEAD(&bounce_map_callbacklist, links);
870 bus_dmamap_load(map->dmat, map, map->buf, map->buflen,
871 map->callback, map->callback_arg, /*flags*/0);