xref: /netbsd-src/sys/dev/usb/usb_mem.h (revision 82d56013d7b633d116a93943de88e08335357a7c)
1 /*	$NetBSD: usb_mem.h,v 1.34 2021/01/05 18:00:21 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	__BIT(0)
45 #define USB_DMA_COHERENT	__BIT(1)
46 
47 	LIST_ENTRY(usb_dma_block) next;
48 } usb_dma_block_t;
49 
50 #define USBMALLOC_MULTISEG	__BIT(0)
51 #define USBMALLOC_COHERENT	__BIT(1)
52 #define USBMALLOC_ZERO		__BIT(2)
53 
54 int		usb_allocmem(struct usbd_bus *, size_t, size_t, u_int, usb_dma_t *);
55 void		usb_freemem(struct usbd_bus *, usb_dma_t *);
56 void		usb_syncmem(usb_dma_t *, bus_addr_t, bus_size_t, int);
57 
58 bus_addr_t	usb_dmaaddr(usb_dma_t *, unsigned int);
59 
60 #define DMAADDR(dma, o) usb_dmaaddr((dma), (o))
61 #define KERNADDR(dma, o) \
62 	((void *)((char *)(dma)->udma_block->kaddr + (dma)->udma_offs + (o)))
63