xref: /netbsd-src/sys/arch/emips/include/bus.h (revision 97492ef8ca5312ac7b3728a7a1f05e69d4da5bdf)
1 /*	$NetBSD: bus.h,v 1.5 2021/01/23 19:38:07 christos Exp $	*/
2 
3 /*-
4  * Copyright (c) 1996, 1997, 1998, 2001 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  *
20  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 #ifndef _EMIPS_BUS_H_
34 #define _EMIPS_BUS_H_
35 
36 #include <mips/locore.h>
37 
38 /*
39  * Utility macros; do not use outside this file.
40  */
41 #define	__PB_TYPENAME_PREFIX(BITS)	___CONCAT(u_int,BITS)
42 #define	__PB_TYPENAME(BITS)		___CONCAT(__PB_TYPENAME_PREFIX(BITS),_t)
43 
44 /*
45  * Bus address and size types
46  */
47 typedef u_long bus_addr_t;
48 typedef u_long bus_size_t;
49 
50 #define PRIxBUSADDR	"lx"
51 #define PRIxBUSSIZE	"lx"
52 #define PRIuBUSSIZE	"lu"
53 /*
54  * Access methods for bus resources and address space.
55  */
56 typedef int	bus_space_tag_t;
57 typedef u_long	bus_space_handle_t;
58 
59 #define PRIxBSH		"lx"
60 
61 /*
62  *	int bus_space_map(bus_space_tag_t t, bus_addr_t addr,
63  *	    bus_size_t size, int flags, bus_space_handle_t *bshp);
64  *
65  * Map a region of bus space.
66  */
67 
68 #define	BUS_SPACE_MAP_CACHEABLE		0x01
69 #define	BUS_SPACE_MAP_LINEAR		0x02
70 #define	BUS_SPACE_MAP_PREFETCHABLE	0x04
71 
72 int	bus_space_map(bus_space_tag_t, bus_addr_t, bus_size_t,
73 	    int, bus_space_handle_t *);
74 
75 /*
76  *	void bus_space_unmap(bus_space_tag_t t,
77  *	    bus_space_handle_t bsh, bus_size_t size);
78  *
79  * Unmap a region of bus space.
80  */
81 
82 void	bus_space_unmap(bus_space_tag_t, bus_space_handle_t, bus_size_t);
83 
84 /*
85  *	int bus_space_subregion(bus_space_tag_t t,
86  *	    bus_space_handle_t bsh, bus_size_t offset, bus_size_t size,
87  *	    bus_space_handle_t *nbshp);
88  *
89  * Get a new handle for a subregion of an already-mapped area of bus space.
90  */
91 
92 int	bus_space_subregion(bus_space_tag_t t, bus_space_handle_t bsh,
93 	    bus_size_t offset, bus_size_t size, bus_space_handle_t *nbshp);
94 
95 /*
96  *	int bus_space_alloc(bus_space_tag_t t, bus_addr_t, rstart,
97  *	    bus_addr_t rend, bus_size_t size, bus_size_t align,
98  *	    bus_size_t boundary, int flags, bus_addr_t *addrp,
99  *	    bus_space_handle_t *bshp);
100  *
101  * Allocate a region of bus space.
102  */
103 
104 int	bus_space_alloc(bus_space_tag_t t, bus_addr_t rstart,
105 	    bus_addr_t rend, bus_size_t size, bus_size_t align,
106 	    bus_size_t boundary, int cacheable, bus_addr_t *addrp,
107 	    bus_space_handle_t *bshp);
108 
109 /*
110  *	int bus_space_free(bus_space_tag_t t,
111  *	    bus_space_handle_t bsh, bus_size_t size);
112  *
113  * Free a region of bus space.
114  */
115 
116 void	bus_space_free(bus_space_tag_t t, bus_space_handle_t bsh,
117 	    bus_size_t size);
118 
119 /*
120  *	void *bus_space_vaddr(bus_space_tag_t, bus_space_handle_t);
121  *
122  * Get the kernel virtual address for the mapped bus space.
123  * Only allowed for regions mapped with BUS_SPACE_MAP_LINEAR.
124  *  (XXX not enforced)
125  */
126 #define bus_space_vaddr(t, h) \
127 	((void *)(h))
128 
129 /*
130  *	u_intN_t bus_space_read_N(bus_space_tag_t tag,
131  *	    bus_space_handle_t bsh, bus_size_t offset);
132  *
133  * Read a 1, 2, 4, or 8 byte quantity from bus space
134  * described by tag/handle/offset.
135  */
136 
137 #define	bus_space_read_1(t, h, o)					\
138      ((void) t, (*(volatile u_int8_t *)((h) + (o))))
139 
140 #define	bus_space_read_2(t, h, o)					\
141      ((void) t, (*(volatile u_int16_t *)((h) + (o))))
142 
143 #define	bus_space_read_4(t, h, o)					\
144      ((void) t, (*(volatile u_int32_t *)((h) + (o))))
145 
146 /*
147  *	void bus_space_read_multi_N(bus_space_tag_t tag,
148  *	    bus_space_handle_t bsh, bus_size_t offset,
149  *	    u_intN_t *addr, size_t count);
150  *
151  * Read `count' 1, 2, 4, or 8 byte quantities from bus space
152  * described by tag/handle/offset and copy into buffer provided.
153  */
154 
155 #define __EMIPS_bus_space_read_multi(BYTES,BITS)			\
156 static __inline void __CONCAT(bus_space_read_multi_,BYTES)		\
157 (bus_space_tag_t, bus_space_handle_t, bus_size_t,			\
158 	__PB_TYPENAME(BITS) *, size_t);					\
159 									\
160 static __inline void							\
161 __CONCAT(bus_space_read_multi_,BYTES)(					\
162 	bus_space_tag_t t,						\
163 	bus_space_handle_t h,						\
164 	bus_size_t o,							\
165 	__PB_TYPENAME(BITS) *a,						\
166 	size_t c)							\
167 {									\
168 									\
169 	while (c--)							\
170 		*a++ = __CONCAT(bus_space_read_,BYTES)(t, h, o);	\
171 }
172 
173 __EMIPS_bus_space_read_multi(1,8)
174 __EMIPS_bus_space_read_multi(2,16)
175 __EMIPS_bus_space_read_multi(4,32)
176 
177 #undef __EMIPS_bus_space_read_multi
178 
179 /*
180  *	void bus_space_read_region_N(bus_space_tag_t tag,
181  *	    bus_space_handle_t bsh, bus_size_t offset,
182  *	    u_intN_t *addr, size_t count);
183  *
184  * Read `count' 1, 2, 4, or 8 byte quantities from bus space
185  * described by tag/handle and starting at `offset' and copy into
186  * buffer provided.
187  */
188 
189 #define __EMIPS_bus_space_read_region(BYTES,BITS)			\
190 static __inline void __CONCAT(bus_space_read_region_,BYTES)		\
191 	(bus_space_tag_t, bus_space_handle_t, bus_size_t,		\
192 	__PB_TYPENAME(BITS) *, size_t);					\
193 									\
194 static __inline void							\
195 __CONCAT(bus_space_read_region_,BYTES)(					\
196 	bus_space_tag_t t,						\
197 	bus_space_handle_t h,						\
198 	bus_size_t o,							\
199 	__PB_TYPENAME(BITS) *a,						\
200 	size_t c)							\
201 {									\
202 									\
203 	while (c--) {							\
204 		*a++ = __CONCAT(bus_space_read_,BYTES)(t, h, o);	\
205 		o += BYTES;						\
206 	}								\
207 }
208 
209 __EMIPS_bus_space_read_region(1,8)
210 __EMIPS_bus_space_read_region(2,16)
211 __EMIPS_bus_space_read_region(4,32)
212 
213 #undef __EMIPS_bus_space_read_region
214 
215 /*
216  *	void bus_space_write_N(bus_space_tag_t tag,
217  *	    bus_space_handle_t bsh, bus_size_t offset,
218  *	    u_intN_t value);
219  *
220  * Write the 1, 2, 4, or 8 byte value `value' to bus space
221  * described by tag/handle/offset.
222  */
223 
224 #define	bus_space_write_1(t, h, o, v)					\
225 do {									\
226 	(void) t;							\
227 	*(volatile u_int8_t *)((h) + (o)) = (v);			\
228 	wbflush();					/* XXX */	\
229 } while (0)
230 
231 #define	bus_space_write_2(t, h, o, v)					\
232 do {									\
233 	(void) t;							\
234 	*(volatile u_int16_t *)((h) + (o)) = (v);			\
235 	wbflush();					/* XXX */	\
236 } while (0)
237 
238 #define	bus_space_write_4(t, h, o, v)					\
239 do {									\
240 	(void) t;							\
241 	*(volatile u_int32_t *)((h) + (o)) = (v);			\
242 	wbflush();					/* XXX */	\
243 } while (0)
244 
245 /*
246  *	void bus_space_write_multi_N(bus_space_tag_t tag,
247  *	    bus_space_handle_t bsh, bus_size_t offset,
248  *	    const u_intN_t *addr, size_t count);
249  *
250  * Write `count' 1, 2, 4, or 8 byte quantities from the buffer
251  * provided to bus space described by tag/handle/offset.
252  */
253 
254 #define __EMIPS_bus_space_write_multi(BYTES,BITS)			\
255 static __inline void __CONCAT(bus_space_write_multi_,BYTES)		\
256 	(bus_space_tag_t, bus_space_handle_t, bus_size_t,		\
257 	__PB_TYPENAME(BITS) *, size_t);					\
258 									\
259 static __inline void							\
260 __CONCAT(bus_space_write_multi_,BYTES)(					\
261 	bus_space_tag_t t,						\
262 	bus_space_handle_t h,						\
263 	bus_size_t o,							\
264 	__PB_TYPENAME(BITS) *a,						\
265 	size_t c)							\
266 {									\
267 									\
268 	while (c--)							\
269 		__CONCAT(bus_space_write_,BYTES)(t, h, o, *a++);	\
270 }
271 
272 __EMIPS_bus_space_write_multi(1,8)
273 __EMIPS_bus_space_write_multi(2,16)
274 __EMIPS_bus_space_write_multi(4,32)
275 
276 #undef __EMIPS_bus_space_write_multi
277 
278 /*
279  *	void bus_space_write_region_N(bus_space_tag_t tag,
280  *	    bus_space_handle_t bsh, bus_size_t offset,
281  *	    const u_intN_t *addr, size_t count);
282  *
283  * Write `count' 1, 2, 4, or 8 byte quantities from the buffer provided
284  * to bus space described by tag/handle starting at `offset'.
285  */
286 
287 #define __EMIPS_bus_space_write_region(BYTES,BITS)			\
288 static __inline void __CONCAT(bus_space_write_region_,BYTES)		\
289 	(bus_space_tag_t, bus_space_handle_t, bus_size_t,		\
290 	__PB_TYPENAME(BITS) *, size_t);					\
291 									\
292 static __inline void							\
293 __CONCAT(bus_space_write_region_,BYTES)(				\
294 	bus_space_tag_t t,						\
295 	bus_space_handle_t h,						\
296 	bus_size_t o,							\
297 	__PB_TYPENAME(BITS) *a,						\
298 	size_t c)							\
299 {									\
300 									\
301 	while (c--) {							\
302 		__CONCAT(bus_space_write_,BYTES)(t, h, o, *a++);	\
303 		o += BYTES;						\
304 	}								\
305 }
306 
307 __EMIPS_bus_space_write_region(1,8)
308 __EMIPS_bus_space_write_region(2,16)
309 __EMIPS_bus_space_write_region(4,32)
310 
311 #undef __EMIPS_bus_space_write_region
312 
313 /*
314  *	void bus_space_set_multi_N(bus_space_tag_t tag,
315  *	    bus_space_handle_t bsh, bus_size_t offset, u_intN_t val,
316  *	    size_t count);
317  *
318  * Write the 1, 2, 4, or 8 byte value `val' to bus space described
319  * by tag/handle/offset `count' times.
320  */
321 
322 #define __EMIPS_bus_space_set_multi(BYTES,BITS)				\
323 static __inline void __CONCAT(bus_space_set_multi_,BYTES)		\
324 	(bus_space_tag_t, bus_space_handle_t, bus_size_t,		\
325 	__PB_TYPENAME(BITS), size_t);					\
326 									\
327 static __inline void							\
328 __CONCAT(bus_space_set_multi_,BYTES)(					\
329 	bus_space_tag_t t,						\
330 	bus_space_handle_t h,						\
331 	bus_size_t o,							\
332 	__PB_TYPENAME(BITS) v,						\
333 	size_t c)							\
334 {									\
335 									\
336 	while (c--)							\
337 		__CONCAT(bus_space_write_,BYTES)(t, h, o, v);		\
338 }
339 
340 __EMIPS_bus_space_set_multi(1,8)
341 __EMIPS_bus_space_set_multi(2,16)
342 __EMIPS_bus_space_set_multi(4,32)
343 
344 #undef __EMIPS_bus_space_set_multi
345 
346 /*
347  *	void bus_space_set_region_N(bus_space_tag_t tag,
348  *	    bus_space_handle_t bsh, bus_size_t offset, u_intN_t val,
349  *	    size_t count);
350  *
351  * Write `count' 1, 2, 4, or 8 byte value `val' to bus space described
352  * by tag/handle starting at `offset'.
353  */
354 
355 #define __EMIPS_bus_space_set_region(BYTES,BITS)			\
356 static __inline void __CONCAT(bus_space_set_region_,BYTES)		\
357 	(bus_space_tag_t, bus_space_handle_t, bus_size_t,		\
358 	__PB_TYPENAME(BITS), size_t);					\
359 									\
360 static __inline void							\
361 __CONCAT(bus_space_set_region_,BYTES)(					\
362 	bus_space_tag_t t,						\
363 	bus_space_handle_t h,						\
364 	bus_size_t o,							\
365 	__PB_TYPENAME(BITS) v,						\
366 	size_t c)							\
367 {									\
368 									\
369 	while (c--) {							\
370 		__CONCAT(bus_space_write_,BYTES)(t, h, o, v);		\
371 		o += BYTES;						\
372 	}								\
373 }
374 
375 __EMIPS_bus_space_set_region(1,8)
376 __EMIPS_bus_space_set_region(2,16)
377 __EMIPS_bus_space_set_region(4,32)
378 
379 #undef __EMIPS_bus_space_set_region
380 
381 /*
382  *	void bus_space_copy_region_N(bus_space_tag_t tag,
383  *	    bus_space_handle_t bsh1, bus_size_t off1,
384  *	    bus_space_handle_t bsh2, bus_size_t off2,
385  *	    bus_size_t count);
386  *
387  * Copy `count' 1, 2, 4, or 8 byte values from bus space starting
388  * at tag/bsh1/off1 to bus space starting at tag/bsh2/off2.
389  */
390 
391 #define	__EMIPS_copy_region(BYTES)					\
392 static __inline void __CONCAT(bus_space_copy_region_,BYTES)		\
393 	(bus_space_tag_t,						\
394 	    bus_space_handle_t bsh1, bus_size_t off1,			\
395 	    bus_space_handle_t bsh2, bus_size_t off2,			\
396 	    bus_size_t count);						\
397 									\
398 static __inline void							\
399 __CONCAT(bus_space_copy_region_,BYTES)(					\
400 	bus_space_tag_t t,						\
401 	bus_space_handle_t h1,						\
402 	bus_size_t o1,							\
403 	bus_space_handle_t h2,						\
404 	bus_size_t o2,							\
405 	bus_size_t c)							\
406 {									\
407 	bus_size_t o;							\
408 									\
409 	if ((h1 + o1) >= (h2 + o2)) {					\
410 		/* src after dest: copy forward */			\
411 		for (o = 0; c != 0; c--, o += BYTES)			\
412 			__CONCAT(bus_space_write_,BYTES)(t, h2, o2 + o,	\
413 			    __CONCAT(bus_space_read_,BYTES)(t, h1, o1 + o)); \
414 	} else {							\
415 		/* dest after src: copy backwards */			\
416 		for (o = (c - 1) * BYTES; c != 0; c--, o -= BYTES)	\
417 			__CONCAT(bus_space_write_,BYTES)(t, h2, o2 + o,	\
418 			    __CONCAT(bus_space_read_,BYTES)(t, h1, o1 + o)); \
419 	}								\
420 }
421 
422 __EMIPS_copy_region(1)
423 __EMIPS_copy_region(2)
424 __EMIPS_copy_region(4)
425 
426 #undef __EMIPS_copy_region
427 
428 /*
429  * Bus read/write barrier methods.
430  *
431  *	void bus_space_barrier(bus_space_tag_t tag,
432  *	    bus_space_handle_t bsh, bus_size_t offset,
433  *	    bus_size_t len, int flags);
434  *
435  * On the MIPS, we just flush the write buffer.
436  */
437 #define	bus_space_barrier(t, h, o, l, f)	\
438 	((void)((void)(t), (void)(h), (void)(o), (void)(l), (void)(f),	\
439 	 wbflush()))
440 #define	BUS_SPACE_BARRIER_READ	0x01		/* force read barrier */
441 #define	BUS_SPACE_BARRIER_WRITE	0x02		/* force write barrier */
442 
443 #undef __PB_TYPENAME_PREFIX
444 #undef __PB_TYPENAME
445 
446 #define BUS_SPACE_ALIGNED_POINTER(p, t) ALIGNED_POINTER(p, t)
447 
448 /*
449  * Flags used in various bus DMA methods.
450  */
451 #define	BUS_DMA_WAITOK		0x000	/* safe to sleep (pseudo-flag) */
452 #define	BUS_DMA_NOWAIT		0x001	/* not safe to sleep */
453 #define	BUS_DMA_ALLOCNOW	0x002	/* perform resource allocation now */
454 #define	BUS_DMA_COHERENT	0x004	/* hint: map memory DMA coherent */
455 #define	BUS_DMA_STREAMING	0x008	/* hint: sequential, unidirectional */
456 #define	BUS_DMA_BUS1		0x010	/* placeholders for bus functions... */
457 #define	BUS_DMA_BUS2		0x020
458 #define	BUS_DMA_BUS3		0x040
459 #define	BUS_DMA_BUS4		0x080
460 #define	BUS_DMA_READ		0x100	/* mapping is device -> memory only */
461 #define	BUS_DMA_WRITE		0x200	/* mapping is memory -> device only */
462 #define	BUS_DMA_NOCACHE		0x400	/* hint: map non-cached memory */
463 
464 #define	EMIPS_DMAMAP_COHERENT	0x10000	/* no cache flush necessary on sync */
465 
466 /* Forwards needed by prototypes below. */
467 struct mbuf;
468 struct uio;
469 
470 /*
471  * Operations performed by bus_dmamap_sync().
472  */
473 #define	BUS_DMASYNC_PREREAD	0x01	/* pre-read synchronization */
474 #define	BUS_DMASYNC_POSTREAD	0x02	/* post-read synchronization */
475 #define	BUS_DMASYNC_PREWRITE	0x04	/* pre-write synchronization */
476 #define	BUS_DMASYNC_POSTWRITE	0x08	/* post-write synchronization */
477 
478 typedef struct emips_bus_dma_tag		*bus_dma_tag_t;
479 typedef struct emips_bus_dmamap		*bus_dmamap_t;
480 
481 #define BUS_DMA_TAG_VALID(t)    ((t) != (bus_dma_tag_t)0)
482 
483 /*
484  *	bus_dma_segment_t
485  *
486  *	Describes a single contiguous DMA transaction.  Values
487  *	are suitable for programming into DMA registers.
488  */
489 struct emips_bus_dma_segment {
490 	bus_addr_t	ds_addr;	/* DMA address */
491 	bus_size_t	ds_len;		/* length of transfer */
492 	bus_addr_t	_ds_vaddr;	/* virtual address, 0 if invalid */
493 };
494 typedef struct emips_bus_dma_segment	bus_dma_segment_t;
495 
496 /*
497  *	bus_dma_tag_t
498  *
499  *	A machine-dependent opaque type describing the implementation of
500  *	DMA for a given bus.
501  */
502 
503 struct emips_bus_dma_tag {
504 	/*
505 	 * DMA mapping methods.
506 	 */
507 	int	(*_dmamap_create)(bus_dma_tag_t, bus_size_t, int,
508 		    bus_size_t, bus_size_t, int, bus_dmamap_t *);
509 	void	(*_dmamap_destroy)(bus_dma_tag_t, bus_dmamap_t);
510 	int	(*_dmamap_load)(bus_dma_tag_t, bus_dmamap_t, void *,
511 		    bus_size_t, struct proc *, int);
512 	int	(*_dmamap_load_mbuf)(bus_dma_tag_t, bus_dmamap_t,
513 		    struct mbuf *, int);
514 	int	(*_dmamap_load_uio)(bus_dma_tag_t, bus_dmamap_t,
515 		    struct uio *, int);
516 	int	(*_dmamap_load_raw)(bus_dma_tag_t, bus_dmamap_t,
517 		    bus_dma_segment_t *, int, bus_size_t, int);
518 	void	(*_dmamap_unload)(bus_dma_tag_t, bus_dmamap_t);
519 	void	(*_dmamap_sync)(bus_dma_tag_t, bus_dmamap_t,
520 		    bus_addr_t, bus_size_t, int);
521 
522 	/*
523 	 * DMA memory utility functions.
524 	 */
525 	int	(*_dmamem_alloc)(bus_dma_tag_t, bus_size_t, bus_size_t,
526 		    bus_size_t, bus_dma_segment_t *, int, int *, int);
527 	void	(*_dmamem_free)(bus_dma_tag_t,
528 		    bus_dma_segment_t *, int);
529 	int	(*_dmamem_map)(bus_dma_tag_t, bus_dma_segment_t *,
530 		    int, size_t, void **, int);
531 	void	(*_dmamem_unmap)(bus_dma_tag_t, void *, size_t);
532 	paddr_t	(*_dmamem_mmap)(bus_dma_tag_t, bus_dma_segment_t *,
533 		    int, off_t, int, int);
534 };
535 
536 #define	bus_dmamap_create(t, s, n, m, b, f, p)			\
537 	(*(t)->_dmamap_create)((t), (s), (n), (m), (b), (f), (p))
538 #define	bus_dmamap_destroy(t, p)				\
539 	(*(t)->_dmamap_destroy)((t), (p))
540 #define	bus_dmamap_load(t, m, b, s, p, f)			\
541 	(*(t)->_dmamap_load)((t), (m), (b), (s), (p), (f))
542 #define	bus_dmamap_load_mbuf(t, m, b, f)			\
543 	(*(t)->_dmamap_load_mbuf)((t), (m), (b), (f))
544 #define	bus_dmamap_load_uio(t, m, u, f)				\
545 	(*(t)->_dmamap_load_uio)((t), (m), (u), (f))
546 #define	bus_dmamap_load_raw(t, m, sg, n, s, f)			\
547 	(*(t)->_dmamap_load_raw)((t), (m), (sg), (n), (s), (f))
548 #define	bus_dmamap_unload(t, p)					\
549 	(*(t)->_dmamap_unload)((t), (p))
550 #define	bus_dmamap_sync(t, p, o, l, ops)			\
551 	(*(t)->_dmamap_sync)((t), (p), (o), (l), (ops))
552 
553 #define	bus_dmamem_alloc(t, s, a, b, sg, n, r, f)		\
554 	(*(t)->_dmamem_alloc)((t), (s), (a), (b), (sg), (n), (r), (f))
555 #define	bus_dmamem_free(t, sg, n)				\
556 	(*(t)->_dmamem_free)((t), (sg), (n))
557 #define	bus_dmamem_map(t, sg, n, s, k, f)			\
558 	(*(t)->_dmamem_map)((t), (sg), (n), (s), (k), (f))
559 #define	bus_dmamem_unmap(t, k, s)				\
560 	(*(t)->_dmamem_unmap)((t), (k), (s))
561 #define	bus_dmamem_mmap(t, sg, n, o, p, f)			\
562 	(*(t)->_dmamem_mmap)((t), (sg), (n), (o), (p), (f))
563 
564 #define bus_dmatag_subregion(t, mna, mxa, nt, f) EOPNOTSUPP
565 #define bus_dmatag_destroy(t)
566 
567 /*
568  *	bus_dmamap_t
569  *
570  *	Describes a DMA mapping.
571  */
572 struct emips_bus_dmamap {
573 	/*
574 	 * PRIVATE MEMBERS: not for use my machine-independent code.
575 	 */
576 	bus_size_t	_dm_size;	/* largest DMA transfer mappable */
577 	int		_dm_segcnt;	/* number of segs this map can map */
578 	bus_size_t	_dm_maxmaxsegsz; /* fixed largest possible segment */
579 	bus_size_t	_dm_boundary;	/* don't cross this */
580 	int		_dm_flags;	/* misc. flags */
581 	struct vmspace	*_dm_vmspace;	/* vmspace that owns the mapping */
582 
583 	/*
584 	 * PUBLIC MEMBERS: these are used by machine-independent code.
585 	 */
586 	bus_size_t	dm_maxsegsz;	/* largest possible segment */
587 	bus_size_t	dm_mapsize;	/* size of the mapping */
588 	int		dm_nsegs;	/* # valid segments in mapping */
589 	bus_dma_segment_t dm_segs[1];	/* segments; variable length */
590 };
591 
592 #ifdef _EMIPS_BUS_DMA_PRIVATE
593 void	emips_bus_dma_init(void);
594 
595 int	_bus_dmamap_create(bus_dma_tag_t, bus_size_t, int, bus_size_t,
596 	    bus_size_t, int, bus_dmamap_t *);
597 void	_bus_dmamap_destroy(bus_dma_tag_t, bus_dmamap_t);
598 int	_bus_dmamap_load(bus_dma_tag_t, bus_dmamap_t, void *,
599 	    bus_size_t, struct proc *, int);
600 int	_bus_dmamap_load_mbuf(bus_dma_tag_t, bus_dmamap_t,
601 	    struct mbuf *, int);
602 int	_bus_dmamap_load_uio(bus_dma_tag_t, bus_dmamap_t,
603 	    struct uio *, int);
604 int	_bus_dmamap_load_raw(bus_dma_tag_t, bus_dmamap_t,
605 	    bus_dma_segment_t *, int, bus_size_t, int);
606 void	_bus_dmamap_unload(bus_dma_tag_t, bus_dmamap_t);
607 void	_bus_dmamap_sync_r3k(bus_dma_tag_t, bus_dmamap_t, bus_addr_t,
608 	    bus_size_t, int);
609 void	_bus_dmamap_sync_r4k(bus_dma_tag_t, bus_dmamap_t, bus_addr_t,
610 	    bus_size_t, int);
611 
612 int	_bus_dmamem_alloc(bus_dma_tag_t tag, bus_size_t size,
613 	    bus_size_t alignment, bus_size_t boundary,
614 	    bus_dma_segment_t *segs, int nsegs, int *rsegs, int flags);
615 void	_bus_dmamem_free(bus_dma_tag_t tag, bus_dma_segment_t *segs,
616 	    int nsegs);
617 int	_bus_dmamem_map(bus_dma_tag_t tag, bus_dma_segment_t *segs,
618 	    int nsegs, size_t size, void **kvap, int flags);
619 void	_bus_dmamem_unmap(bus_dma_tag_t tag, void *kva,
620 	    size_t size);
621 paddr_t	_bus_dmamem_mmap(bus_dma_tag_t tag, bus_dma_segment_t *segs,
622 	    int nsegs, off_t off, int prot, int flags);
623 
624 int	_bus_dmamem_alloc_range(bus_dma_tag_t tag, bus_size_t size,
625 	    bus_size_t alignment, bus_size_t boundary,
626 	    bus_dma_segment_t *segs, int nsegs, int *rsegs, int flags,
627 	    vaddr_t low, vaddr_t high);
628 
629 extern struct emips_bus_dma_tag emips_default_bus_dma_tag;
630 #endif /* _EMIPS_BUS_DMA_PRIVATE */
631 
632 #endif /* !_EMIPS_BUS_H_ */
633