xref: /freebsd/sys/dev/firewire/fwdma.h (revision a0409676120c1e558d0ade943019934e0f15118d)
1 /*-
2  * SPDX-License-Identifier: BSD-4-Clause
3  *
4  * Copyright (C) 2003
5  * 	Hidetoshi Shimokawa. All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. All advertising materials mentioning features or use of this software
16  *    must display the following acknowledgement:
17  *
18  *	This product includes software developed by Hidetoshi Shimokawa.
19  *
20  * 4. Neither the name of the author nor the names of its contributors
21  *    may be used to endorse or promote products derived from this software
22  *    without specific prior written permission.
23  *
24  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
25  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
28  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34  * SUCH DAMAGE.
35  *
36  * $FreeBSD$
37  */
38 
39 struct fwdma_alloc {
40 	bus_dma_tag_t	dma_tag;
41 	bus_dmamap_t	dma_map;
42 	void 		*v_addr;
43 	bus_addr_t	bus_addr;
44 };
45 
46 struct fwdma_seg {
47 	bus_dmamap_t	dma_map;
48 	void 		*v_addr;
49 	bus_addr_t	bus_addr;
50 };
51 
52 struct fwdma_alloc_multi {
53 	bus_size_t	ssize;
54 	bus_size_t	esize;
55 	int		nseg;
56 	bus_dma_tag_t	dma_tag;
57 	struct fwdma_seg seg[0];
58 };
59 
60 static __inline void *
61 fwdma_v_addr(struct fwdma_alloc_multi *am, int index)
62 {
63 	bus_size_t ssize = am->ssize;
64 	int offset = am->esize * index;
65 
66 	return ((caddr_t)am->seg[offset / ssize].v_addr + (offset % ssize));
67 }
68 
69 static __inline bus_addr_t
70 fwdma_bus_addr(struct fwdma_alloc_multi *am, int index)
71 {
72 	bus_size_t ssize = am->ssize;
73 	int offset = am->esize * index;
74 
75 	return (am->seg[offset / ssize].bus_addr + (offset % ssize));
76 }
77 
78 static __inline void
79 fwdma_sync(struct fwdma_alloc *dma, bus_dmasync_op_t op)
80 {
81 	bus_dmamap_sync(dma->dma_tag, dma->dma_map, op);
82 }
83 
84 static __inline void
85 fwdma_sync_multiseg(struct fwdma_alloc_multi *am,
86     int start, int end, bus_dmasync_op_t op)
87 {
88 	struct fwdma_seg *seg, *eseg;
89 
90 	seg = &am->seg[am->esize * start / am->ssize];
91 	eseg = &am->seg[am->esize * end / am->ssize];
92 	for (; seg <= eseg; seg++)
93 		bus_dmamap_sync(am->dma_tag, seg->dma_map, op);
94 }
95 
96 static __inline void
97 fwdma_sync_multiseg_all(struct fwdma_alloc_multi *am, bus_dmasync_op_t op)
98 {
99 	struct fwdma_seg *seg;
100 	int i;
101 
102 	seg = &am->seg[0];
103 	for (i = 0; i < am->nseg; i++, seg++)
104 		bus_dmamap_sync(am->dma_tag, seg->dma_map, op);
105 }
106 
107 void *fwdma_malloc(struct firewire_comm *, int, bus_size_t, struct fwdma_alloc *, int);
108 void fwdma_free(struct firewire_comm *, struct fwdma_alloc *);
109 void *fwdma_malloc_size(bus_dma_tag_t, bus_dmamap_t *, bus_size_t, bus_addr_t *, int);
110 void fwdma_free_size(bus_dma_tag_t, bus_dmamap_t, void *, bus_size_t);
111 struct fwdma_alloc_multi *fwdma_malloc_multiseg(struct firewire_comm *,
112 	int, int, int, int);
113 void fwdma_free_multiseg(struct fwdma_alloc_multi *);
114 
115