xref: /netbsd-src/sys/dev/usb/usb_mem.h (revision bdc22b2e01993381dcefeff2bc9b56ca75a4235c)
1 /*	$NetBSD: usb_mem.h,v 1.31 2016/04/23 10:15:32 skrll Exp $	*/
2 /*	$FreeBSD: src/sys/dev/usb/usb_mem.h,v 1.9 1999/11/17 22:33:47 n_hibma Exp $	*/
3 
4 /*
5  * Copyright (c) 1998 The NetBSD Foundation, Inc.
6  * All rights reserved.
7  *
8  * This code is derived from software contributed to The NetBSD Foundation
9  * by Lennart Augustsson (lennart@augustsson.net) at
10  * Carlstedt Research & Technology.
11  *
12  * Redistribution and use in source and binary forms, with or without
13  * modification, are permitted provided that the following conditions
14  * are met:
15  * 1. Redistributions of source code must retain the above copyright
16  *    notice, this list of conditions and the following disclaimer.
17  * 2. Redistributions in binary form must reproduce the above copyright
18  *    notice, this list of conditions and the following disclaimer in the
19  *    documentation and/or other materials provided with the distribution.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
22  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
23  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
25  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 typedef struct usb_dma_block {
35 	bus_dma_tag_t tag;
36 	bus_dmamap_t map;
37 	void *kaddr;
38 	bus_dma_segment_t *segs;
39 	int nsegs;
40 	int nsegs_alloc;
41 	size_t size;
42 	size_t align;
43 	int flags;
44 #define USB_DMA_FULLBLOCK	0x0001
45 	LIST_ENTRY(usb_dma_block) next;
46 } usb_dma_block_t;
47 
48 #define USBMALLOC_MULTISEG	1
49 
50 usbd_status	usb_allocmem(struct usbd_bus *, size_t, size_t, usb_dma_t *);
51 usbd_status	usb_allocmem_flags(struct usbd_bus *, size_t, size_t, usb_dma_t *,
52 			int);
53 void		usb_freemem(struct usbd_bus *, usb_dma_t *);
54 void		usb_syncmem(usb_dma_t *, bus_addr_t, bus_size_t, int);
55 
56 bus_addr_t	usb_dmaaddr(usb_dma_t *, unsigned int);
57 
58 #define DMAADDR(dma, o) usb_dmaaddr((dma), (o))
59 #define KERNADDR(dma, o) \
60 	((void *)((char *)(dma)->udma_block->kaddr + (dma)->udma_offs + (o)))
61