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