Home | History | Annotate | Line # | Download | only in common
bus_dma.c revision 1.16
      1 /* $NetBSD: bus_dma.c,v 1.16 1998/02/24 07:38:03 thorpej Exp $ */
      2 
      3 /*-
      4  * Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
      9  * NASA Ames Research Center.
     10  *
     11  * Redistribution and use in source and binary forms, with or without
     12  * modification, are permitted provided that the following conditions
     13  * are met:
     14  * 1. Redistributions of source code must retain the above copyright
     15  *    notice, this list of conditions and the following disclaimer.
     16  * 2. Redistributions in binary form must reproduce the above copyright
     17  *    notice, this list of conditions and the following disclaimer in the
     18  *    documentation and/or other materials provided with the distribution.
     19  * 3. All advertising materials mentioning features or use of this software
     20  *    must display the following acknowledgement:
     21  *	This product includes software developed by the NetBSD
     22  *	Foundation, Inc. and its contributors.
     23  * 4. Neither the name of The NetBSD Foundation nor the names of its
     24  *    contributors may be used to endorse or promote products derived
     25  *    from this software without specific prior written permission.
     26  *
     27  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     28  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     29  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     30  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     31  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     32  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     33  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     34  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     35  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     36  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     37  * POSSIBILITY OF SUCH DAMAGE.
     38  */
     39 
     40 #include "opt_uvm.h"
     41 
     42 #include <sys/cdefs.h>			/* RCS ID & Copyright macro defns */
     43 
     44 __KERNEL_RCSID(0, "$NetBSD: bus_dma.c,v 1.16 1998/02/24 07:38:03 thorpej Exp $");
     45 
     46 #include <sys/param.h>
     47 #include <sys/systm.h>
     48 #include <sys/kernel.h>
     49 #include <sys/device.h>
     50 #include <sys/malloc.h>
     51 #include <sys/proc.h>
     52 #include <sys/mbuf.h>
     53 
     54 #include <vm/vm.h>
     55 #include <vm/vm_kern.h>
     56 #if defined(UVM)
     57 #include <uvm/uvm_extern.h>
     58 #endif
     59 
     60 #define _ALPHA_BUS_DMA_PRIVATE
     61 #include <machine/bus.h>
     62 #include <machine/intr.h>
     63 
     64 int	_bus_dmamap_load_buffer_direct_common __P((bus_dmamap_t,
     65 	    void *, bus_size_t, struct proc *, int, bus_addr_t,
     66 	    vm_offset_t *, int *, int));
     67 
     68 /*
     69  * Common function for DMA map creation.  May be called by bus-specific
     70  * DMA map creation functions.
     71  */
     72 int
     73 _bus_dmamap_create(t, size, nsegments, maxsegsz, boundary, flags, dmamp)
     74 	bus_dma_tag_t t;
     75 	bus_size_t size;
     76 	int nsegments;
     77 	bus_size_t maxsegsz;
     78 	bus_size_t boundary;
     79 	int flags;
     80 	bus_dmamap_t *dmamp;
     81 {
     82 	struct alpha_bus_dmamap *map;
     83 	void *mapstore;
     84 	size_t mapsize;
     85 
     86 	/*
     87 	 * Allcoate and initialize the DMA map.  The end of the map
     88 	 * is a variable-sized array of segments, so we allocate enough
     89 	 * room for them in one shot.
     90 	 *
     91 	 * Note we don't preserve the WAITOK or NOWAIT flags.  Preservation
     92 	 * of ALLOCNOW notifes others that we've reserved these resources,
     93 	 * and they are not to be freed.
     94 	 *
     95 	 * The bus_dmamap_t includes one bus_dma_segment_t, hence
     96 	 * the (nsegments - 1).
     97 	 */
     98 	mapsize = sizeof(struct alpha_bus_dmamap) +
     99 	    (sizeof(bus_dma_segment_t) * (nsegments - 1));
    100 	if ((mapstore = malloc(mapsize, M_DMAMAP,
    101 	    (flags & BUS_DMA_NOWAIT) ? M_NOWAIT : M_WAITOK)) == NULL)
    102 		return (ENOMEM);
    103 
    104 	bzero(mapstore, mapsize);
    105 	map = (struct alpha_bus_dmamap *)mapstore;
    106 	map->_dm_size = size;
    107 	map->_dm_segcnt = nsegments;
    108 	map->_dm_maxsegsz = maxsegsz;
    109 	map->_dm_boundary = boundary;
    110 	map->_dm_flags = flags & ~(BUS_DMA_WAITOK|BUS_DMA_NOWAIT);
    111 	map->dm_mapsize = 0;		/* no valid mappings */
    112 	map->dm_nsegs = 0;
    113 
    114 	*dmamp = map;
    115 	return (0);
    116 }
    117 
    118 /*
    119  * Common function for DMA map destruction.  May be called by bus-specific
    120  * DMA map destruction functions.
    121  */
    122 void
    123 _bus_dmamap_destroy(t, map)
    124 	bus_dma_tag_t t;
    125 	bus_dmamap_t map;
    126 {
    127 
    128 	free(map, M_DMAMAP);
    129 }
    130 
    131 /*
    132  * Utility function to load a linear buffer.  lastaddrp holds state
    133  * between invocations (for multiple-buffer loads).  segp contains
    134  * the starting segment on entrance, and the ending segment on exit.
    135  * first indicates if this is the first invocation of this function.
    136  */
    137 int
    138 _bus_dmamap_load_buffer_direct_common(map, buf, buflen, p, flags, wbase,
    139     lastaddrp, segp, first)
    140 	bus_dmamap_t map;
    141 	void *buf;
    142 	bus_size_t buflen;
    143 	struct proc *p;
    144 	int flags;
    145 	bus_addr_t wbase;
    146 	vm_offset_t *lastaddrp;
    147 	int *segp;
    148 	int first;
    149 {
    150 	bus_size_t sgsize;
    151 	vm_offset_t curaddr, lastaddr;
    152 	vm_offset_t vaddr = (vm_offset_t)buf;
    153 	int seg;
    154 
    155 	lastaddr = *lastaddrp;
    156 
    157 	for (seg = *segp; buflen > 0 && seg < map->_dm_segcnt; ) {
    158 		/*
    159 		 * Get the physical address for this segment.
    160 		 */
    161 		if (p != NULL)
    162 			curaddr = pmap_extract(p->p_vmspace->vm_map.pmap,
    163 			    vaddr);
    164 		else
    165 			curaddr = vtophys(vaddr);
    166 
    167 		curaddr |= wbase;
    168 
    169 		/*
    170 		 * Compute the segment size, and adjust counts.
    171 		 */
    172 		sgsize = NBPG - ((u_long)vaddr & PGOFSET);
    173 		if (buflen < sgsize)
    174 			sgsize = buflen;
    175 
    176 		/*
    177 		 * Insert chunk into a segment, coalescing with
    178 		 * the previous segment if possible.
    179 		 */
    180 		if (first) {
    181 			map->dm_segs[seg].ds_addr = curaddr;
    182 			map->dm_segs[seg].ds_len = sgsize;
    183 			first = 0;
    184 		} else {
    185 			if (curaddr == lastaddr &&
    186 			    (map->dm_segs[seg].ds_len + sgsize) <=
    187 			    map->_dm_maxsegsz)
    188 				map->dm_segs[seg].ds_len += sgsize;
    189 			else {
    190 				seg++;
    191 				map->dm_segs[seg].ds_addr = curaddr;
    192 				map->dm_segs[seg].ds_len = sgsize;
    193 			}
    194 		}
    195 
    196 		lastaddr = curaddr + sgsize;
    197 		vaddr += sgsize;
    198 		buflen -= sgsize;
    199 	}
    200 
    201 	*segp = seg;
    202 	*lastaddrp = lastaddr;
    203 
    204 	/*
    205 	 * Did we fit?
    206 	 */
    207 	if (buflen != 0) {
    208 		/*
    209 		 * XXX Should fall back on SGMAPs.
    210 		 */
    211 		return (EFBIG);		/* XXX better return value here? */
    212 	}
    213 	return (0);
    214 }
    215 
    216 /*
    217  * Common function for loading a direct-mapped DMA map with a linear
    218  * buffer.  Called by bus-specific DMA map load functions with the
    219  * OR value appropriate for indicating "direct-mapped" for that
    220  * chipset.
    221  */
    222 int
    223 _bus_dmamap_load_direct_common(t, map, buf, buflen, p, flags, wbase)
    224 	bus_dma_tag_t t;
    225 	bus_dmamap_t map;
    226 	void *buf;
    227 	bus_size_t buflen;
    228 	struct proc *p;
    229 	int flags;
    230 	bus_addr_t wbase;
    231 {
    232 	vm_offset_t lastaddr;
    233 	int seg, error;
    234 
    235 	/*
    236 	 * Make sure that on error condition we return "no valid mappings".
    237 	 */
    238 	map->dm_mapsize = 0;
    239 	map->dm_nsegs = 0;
    240 
    241 	if (buflen > map->_dm_size)
    242 		return (EINVAL);
    243 
    244 	seg = 0;
    245 	error = _bus_dmamap_load_buffer_direct_common(map, buf, buflen,
    246 	    p, flags, wbase, &lastaddr, &seg, 1);
    247 	if (error == 0) {
    248 		map->dm_mapsize = buflen;
    249 		map->dm_nsegs = seg + 1;
    250 	}
    251 	return (error);
    252 }
    253 
    254 /*
    255  * Like _bus_dmamap_load_direct_common(), but for mbufs.
    256  */
    257 int
    258 _bus_dmamap_load_mbuf_direct_common(t, map, m0, flags, wbase)
    259 	bus_dma_tag_t t;
    260 	bus_dmamap_t map;
    261 	struct mbuf *m0;
    262 	int flags;
    263 	bus_addr_t wbase;
    264 {
    265 	vm_offset_t lastaddr;
    266 	int seg, error, first;
    267 	struct mbuf *m;
    268 
    269 	/*
    270 	 * Make sure that on error condition we return "no valid mappings."
    271 	 */
    272 	map->dm_mapsize = 0;
    273 	map->dm_nsegs = 0;
    274 
    275 #ifdef DIAGNOSTIC
    276 	if ((m0->m_flags & M_PKTHDR) == 0)
    277 		panic("_bus_dmamap_load_mbuf_direct_common: no packet header");
    278 #endif
    279 
    280 	if (m0->m_pkthdr.len > map->_dm_size)
    281 		return (EINVAL);
    282 
    283 	first = 1;
    284 	seg = 0;
    285 	error = 0;
    286 	for (m = m0; m != NULL && error == 0; m = m->m_next) {
    287 		error = _bus_dmamap_load_buffer_direct_common(map,
    288 		    m->m_data, m->m_len, NULL, flags, wbase, &lastaddr,
    289 		    &seg, first);
    290 		first = 0;
    291 	}
    292 	if (error == 0) {
    293 		map->dm_mapsize = m0->m_pkthdr.len;
    294 		map->dm_nsegs = seg + 1;
    295 	}
    296 	return (error);
    297 }
    298 
    299 /*
    300  * Like _bus_dmamap_load_direct_common(), but for uios.
    301  */
    302 int
    303 _bus_dmamap_load_uio_direct_common(t, map, uio, flags, wbase)
    304 	bus_dma_tag_t t;
    305 	bus_dmamap_t map;
    306 	struct uio *uio;
    307 	int flags;
    308 	bus_addr_t wbase;
    309 {
    310 
    311 	panic("_bus_dmamap_load_uio_direct_common: not implemented");
    312 }
    313 
    314 /*
    315  * Like _bus_dmamap_load_direct_common(), but for raw memory.
    316  */
    317 int
    318 _bus_dmamap_load_raw_direct_common(t, map, segs, nsegs, size, flags, wbase)
    319 	bus_dma_tag_t t;
    320 	bus_dmamap_t map;
    321 	bus_dma_segment_t *segs;
    322 	int nsegs;
    323 	bus_size_t size;
    324 	int flags;
    325 	bus_addr_t wbase;
    326 {
    327 
    328 	panic("_bus_dmamap_load_raw_direct_common: not implemented");
    329 }
    330 
    331 /*
    332  * Common function for unloading a DMA map.  May be called by
    333  * chipset-specific DMA map unload functions.
    334  */
    335 void
    336 _bus_dmamap_unload(t, map)
    337 	bus_dma_tag_t t;
    338 	bus_dmamap_t map;
    339 {
    340 
    341 	/*
    342 	 * No resources to free; just mark the mappings as
    343 	 * invalid.
    344 	 */
    345 	map->dm_mapsize = 0;
    346 	map->dm_nsegs = 0;
    347 }
    348 
    349 /*
    350  * Common function for DMA map synchronization.  May be called
    351  * by chipset-specific DMA map synchronization functions.
    352  */
    353 void
    354 _bus_dmamap_sync(t, map, offset, len, ops)
    355 	bus_dma_tag_t t;
    356 	bus_dmamap_t map;
    357 	bus_addr_t offset;
    358 	bus_size_t len;
    359 	int ops;
    360 {
    361 
    362 	/*
    363 	 * Flush the store buffer.
    364 	 */
    365 	alpha_mb();
    366 }
    367 
    368 /*
    369  * Common function for DMA-safe memory allocation.  May be called
    370  * by bus-specific DMA memory allocation functions.
    371  */
    372 int
    373 _bus_dmamem_alloc(t, size, alignment, boundary, segs, nsegs, rsegs, flags)
    374 	bus_dma_tag_t t;
    375 	bus_size_t size, alignment, boundary;
    376 	bus_dma_segment_t *segs;
    377 	int nsegs;
    378 	int *rsegs;
    379 	int flags;
    380 {
    381 	extern vm_offset_t avail_start, avail_end;
    382 	vm_offset_t curaddr, lastaddr, high;
    383 	vm_page_t m;
    384 	struct pglist mlist;
    385 	int curseg, error;
    386 
    387 	/* Always round the size. */
    388 	size = round_page(size);
    389 
    390 	high = avail_end - PAGE_SIZE;
    391 
    392 	/*
    393 	 * Allocate pages from the VM system.
    394 	 */
    395 	TAILQ_INIT(&mlist);
    396 #if defined(UVM)
    397 	error = uvm_pglistalloc(size, avail_start, high, alignment, boundary,
    398 	    &mlist, nsegs, (flags & BUS_DMA_NOWAIT) == 0);
    399 #else
    400 	error = vm_page_alloc_memory(size, avail_start, high,
    401 	    alignment, boundary, &mlist, nsegs, (flags & BUS_DMA_NOWAIT) == 0);
    402 #endif
    403 	if (error)
    404 		return (error);
    405 
    406 	/*
    407 	 * Compute the location, size, and number of segments actually
    408 	 * returned by the VM code.
    409 	 */
    410 	m = mlist.tqh_first;
    411 	curseg = 0;
    412 	lastaddr = segs[curseg].ds_addr = VM_PAGE_TO_PHYS(m);
    413 	segs[curseg].ds_len = PAGE_SIZE;
    414 	m = m->pageq.tqe_next;
    415 
    416 	for (; m != NULL; m = m->pageq.tqe_next) {
    417 		curaddr = VM_PAGE_TO_PHYS(m);
    418 #ifdef DIAGNOSTIC
    419 		if (curaddr < avail_start || curaddr >= high) {
    420 			printf("vm_page_alloc_memory returned non-sensical"
    421 			    " address 0x%lx\n", curaddr);
    422 			panic("_bus_dmamem_alloc");
    423 		}
    424 #endif
    425 		if (curaddr == (lastaddr + PAGE_SIZE))
    426 			segs[curseg].ds_len += PAGE_SIZE;
    427 		else {
    428 			curseg++;
    429 			segs[curseg].ds_addr = curaddr;
    430 			segs[curseg].ds_len = PAGE_SIZE;
    431 		}
    432 		lastaddr = curaddr;
    433 	}
    434 
    435 	*rsegs = curseg + 1;
    436 
    437 	return (0);
    438 }
    439 
    440 /*
    441  * Common function for freeing DMA-safe memory.  May be called by
    442  * bus-specific DMA memory free functions.
    443  */
    444 void
    445 _bus_dmamem_free(t, segs, nsegs)
    446 	bus_dma_tag_t t;
    447 	bus_dma_segment_t *segs;
    448 	int nsegs;
    449 {
    450 	vm_page_t m;
    451 	bus_addr_t addr;
    452 	struct pglist mlist;
    453 	int curseg;
    454 
    455 	/*
    456 	 * Build a list of pages to free back to the VM system.
    457 	 */
    458 	TAILQ_INIT(&mlist);
    459 	for (curseg = 0; curseg < nsegs; curseg++) {
    460 		for (addr = segs[curseg].ds_addr;
    461 		    addr < (segs[curseg].ds_addr + segs[curseg].ds_len);
    462 		    addr += PAGE_SIZE) {
    463 			m = PHYS_TO_VM_PAGE(addr);
    464 			TAILQ_INSERT_TAIL(&mlist, m, pageq);
    465 		}
    466 	}
    467 
    468 #if defined(UVM)
    469 	uvm_pglistfree(&mlist);
    470 #else
    471 	vm_page_free_memory(&mlist);
    472 #endif
    473 }
    474 
    475 /*
    476  * Common function for mapping DMA-safe memory.  May be called by
    477  * bus-specific DMA memory map functions.
    478  */
    479 int
    480 _bus_dmamem_map(t, segs, nsegs, size, kvap, flags)
    481 	bus_dma_tag_t t;
    482 	bus_dma_segment_t *segs;
    483 	int nsegs;
    484 	size_t size;
    485 	caddr_t *kvap;
    486 	int flags;
    487 {
    488 	vm_offset_t va;
    489 	bus_addr_t addr;
    490 	int curseg;
    491 
    492 	/*
    493 	 * If we're only mapping 1 segment, use K0SEG, to avoid
    494 	 * TLB thrashing.
    495 	 */
    496 	if (nsegs == 1) {
    497 		*kvap = (caddr_t)ALPHA_PHYS_TO_K0SEG(segs[0].ds_addr);
    498 		return (0);
    499 	}
    500 
    501 	size = round_page(size);
    502 
    503 #if defined(UVM)
    504 	va = uvm_km_valloc(kernel_map, size);
    505 #else
    506 	va = kmem_alloc_pageable(kernel_map, size);
    507 #endif
    508 
    509 	if (va == 0)
    510 		return (ENOMEM);
    511 
    512 	*kvap = (caddr_t)va;
    513 
    514 	for (curseg = 0; curseg < nsegs; curseg++) {
    515 		for (addr = segs[curseg].ds_addr;
    516 		    addr < (segs[curseg].ds_addr + segs[curseg].ds_len);
    517 		    addr += NBPG, va += NBPG, size -= NBPG) {
    518 			if (size == 0)
    519 				panic("_bus_dmamem_map: size botch");
    520 			pmap_enter(pmap_kernel(), va, addr,
    521 			    VM_PROT_READ | VM_PROT_WRITE, TRUE);
    522 		}
    523 	}
    524 
    525 	return (0);
    526 }
    527 
    528 /*
    529  * Common function for unmapping DMA-safe memory.  May be called by
    530  * bus-specific DMA memory unmapping functions.
    531  */
    532 void
    533 _bus_dmamem_unmap(t, kva, size)
    534 	bus_dma_tag_t t;
    535 	caddr_t kva;
    536 	size_t size;
    537 {
    538 
    539 #ifdef DIAGNOSTIC
    540 	if ((u_long)kva & PGOFSET)
    541 		panic("_bus_dmamem_unmap");
    542 #endif
    543 
    544 	/*
    545 	 * Nothing to do if we mapped it with K0SEG.
    546 	 */
    547 	if (kva >= (caddr_t)ALPHA_K0SEG_BASE &&
    548 	    kva <= (caddr_t)ALPHA_K0SEG_END)
    549 		return;
    550 
    551 	size = round_page(size);
    552 #if defined(UVM)
    553 	uvm_km_free(kernel_map, (vm_offset_t)kva, size);
    554 #else
    555 	kmem_free(kernel_map, (vm_offset_t)kva, size);
    556 #endif
    557 }
    558 
    559 /*
    560  * Common functin for mmap(2)'ing DMA-safe memory.  May be called by
    561  * bus-specific DMA mmap(2)'ing functions.
    562  */
    563 int
    564 _bus_dmamem_mmap(t, segs, nsegs, off, prot, flags)
    565 	bus_dma_tag_t t;
    566 	bus_dma_segment_t *segs;
    567 	int nsegs, off, prot, flags;
    568 {
    569 	int i;
    570 
    571 	for (i = 0; i < nsegs; i++) {
    572 #ifdef DIAGNOSTIC
    573 		if (off & PGOFSET)
    574 			panic("_bus_dmamem_mmap: offset unaligned");
    575 		if (segs[i].ds_addr & PGOFSET)
    576 			panic("_bus_dmamem_mmap: segment unaligned");
    577 		if (segs[i].ds_len & PGOFSET)
    578 			panic("_bus_dmamem_mmap: segment size not multiple"
    579 			    " of page size");
    580 #endif
    581 		if (off >= segs[i].ds_len) {
    582 			off -= segs[i].ds_len;
    583 			continue;
    584 		}
    585 
    586 		return (alpha_btop((caddr_t)segs[i].ds_addr + off));
    587 	}
    588 
    589 	/* Page not found. */
    590 	return (-1);
    591 }
    592