1 /* $NetBSD: bus.h,v 1.29 2014/01/03 00:33:06 rkujawa Exp $ */ 2 3 /* 4 * Copyright (c) 1996 Leo Weppelman. All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 19 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 20 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 21 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 22 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 23 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 24 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25 */ 26 27 #ifndef _AMIGA_BUS_H_ 28 #define _AMIGA_BUS_H_ 29 30 #include <sys/types.h> 31 32 /* for public use: */ 33 34 /* 35 * Memory addresses (in bus space) 36 */ 37 38 typedef u_int32_t bus_addr_t; 39 typedef u_int32_t bus_size_t; 40 41 /* 42 * Access methods for bus resources and address space. 43 */ 44 typedef struct bus_space_tag *bus_space_tag_t; 45 typedef u_long bus_space_handle_t; 46 47 /* unpublic, but needed by method implementors */ 48 49 /* 50 * Lazyness macros for function declarations. 51 */ 52 53 #define bsr(what, typ) \ 54 typ (what)(bus_space_handle_t, bus_addr_t) 55 56 #define bsw(what, typ) \ 57 void (what)(bus_space_handle_t, bus_addr_t, unsigned) 58 59 #define bsrm(what, typ) \ 60 void (what)(bus_space_handle_t, bus_size_t, typ *, bus_size_t) 61 62 #define bswm(what, typ) \ 63 void (what)(bus_space_handle_t, bus_size_t, const typ *, bus_size_t) 64 65 #define bssr(what, typ) \ 66 void (what)(bus_space_handle_t, bus_size_t, unsigned, bus_size_t) 67 68 #define bscr(what, typ) \ 69 void (what)(bus_space_handle_t, bus_size_t, \ 70 bus_space_handle_t, bus_size_t, bus_size_t) 71 72 /* 73 * Implementation specific structures. 74 * XXX Don't use outside of bus_space definitions! 75 * XXX maybe this should be encapsuled in a non-global .h file? 76 */ 77 78 struct bus_space_tag { 79 bus_addr_t base; 80 const struct amiga_bus_space_methods *absm; 81 }; 82 83 struct amiga_bus_space_methods { 84 85 /* map, unmap, etc */ 86 87 int (*bsm)(bus_space_tag_t, 88 bus_addr_t, bus_size_t, int, bus_space_handle_t *); 89 90 int (*bsms)(bus_space_handle_t, 91 bus_size_t, bus_size_t, bus_space_handle_t *); 92 93 void (*bsu)(bus_space_handle_t, bus_size_t); 94 95 /* placeholders for currently not implemented alloc and free */ 96 97 void *bsa; 98 void *bsf; 99 100 /* 8 bit methods */ 101 102 bsr(*bsr1, u_int8_t); 103 bsw(*bsw1, u_int8_t); 104 bsrm(*bsrm1, u_int8_t); 105 bswm(*bswm1, u_int8_t); 106 bsrm(*bsrr1, u_int8_t); 107 bswm(*bswr1, u_int8_t); 108 bssr(*bssr1, u_int8_t); 109 bscr(*bscr1, u_int8_t); 110 111 /* 16bit methods */ 112 113 bsr(*bsr2, u_int16_t); 114 bsw(*bsw2, u_int16_t); 115 bsr(*bsrs2, u_int16_t); 116 bsw(*bsws2, u_int16_t); 117 bsrm(*bsrm2, u_int16_t); 118 bswm(*bswm2, u_int16_t); 119 bsrm(*bsrms2, u_int16_t); 120 bswm(*bswms2, u_int16_t); 121 bsrm(*bsrr2, u_int16_t); 122 bswm(*bswr2, u_int16_t); 123 bsrm(*bsrrs2, u_int16_t); 124 bswm(*bswrs2, u_int16_t); 125 bssr(*bssr2, u_int16_t); 126 bscr(*bscr2, u_int16_t); 127 128 /* 32bit methods */ 129 130 bsr(*bsr4, u_int32_t); 131 bsw(*bsw4, u_int32_t); 132 bsr(*bsrs4, u_int32_t); 133 bsw(*bsws4, u_int32_t); 134 bsrm(*bsrm4, u_int32_t); 135 bswm(*bswm4, u_int32_t); 136 bsrm(*bsrms4, u_int32_t); 137 bswm(*bswms4, u_int32_t); 138 bsrm(*bsrr4, u_int32_t); 139 bswm(*bswr4, u_int32_t); 140 bsrm(*bsrrs4, u_int32_t); 141 bswm(*bswrs4, u_int32_t); 142 bssr(*bssr4, u_int32_t); 143 bscr(*bscr4, u_int32_t); 144 145 }; 146 147 /* 148 * Macro definition of map, unmap, etc. 149 */ 150 151 #define bus_space_map(t, o, s, f, hp) \ 152 ((t)->absm->bsm)((t), (o), (s), (f), (hp)) 153 154 #define bus_space_subregion(t, h, o, s, hp) \ 155 ((t)->absm->bsms)((h), (o), (s), (hp)) 156 157 #define bus_space_unmap(t, h, s) \ 158 ((t)->absm->bsu)((h), (s)) 159 160 /* 161 * Macro definition of _2 functions as indirect method array calls 162 */ 163 164 /* 0: Helper macros */ 165 166 #define dbsdr(n, t, h, o) ((t)->absm->n)((h), (o)) 167 #define dbsdw(n, t, h, o, v) ((t)->absm->n)((h), (o), (v)) 168 #define dbsm(n, t, h, o, p, c) ((t)->absm->n)((h), (o), (p), (c)) 169 #define dbss(n, t, h, o, v, c) ((t)->absm->n)((h), (o), (v), (c)) 170 #define dbsc(n, t, h, o, v, c) ((t)->absm->n)((h), (o), (v), (c)) 171 172 /* 1: byte-wide "functions" */ 173 174 #define bus_space_read_1(t, h, o) dbsdr(bsr1, t, h, o) 175 #define bus_space_write_1(t, h, o, v) dbsdw(bsw1, t, h, o, v) 176 177 #define bus_space_read_multi_1(t, h, o, p, c) dbsm(bsrm1, t, h, o, p, c) 178 #define bus_space_write_multi_1(t, h, o, p, c) dbsm(bswm1, t, h, o, p, c) 179 180 #define bus_space_read_region_1(t, h, o, p, c) dbsm(bsrr1, t, h, o, p, c) 181 #define bus_space_write_region_1(t, h, o, p, c) dbsm(bswr1, t, h, o, p, c) 182 183 #define bus_space_set_region_1(t, h, o, v, c) dbss(bssr1, t, h, o, v, c) 184 #define bus_space_copy_region_1(t, h, o, g, q, c) dbss(bscr1, t, h, o, g, q, c) 185 186 187 /* 2: word-wide "functions" */ 188 189 #define bus_space_read_2(t, h, o) dbsdr(bsr2, t, h, o) 190 #define bus_space_write_2(t, h, o, v) dbsdw(bsw2, t, h, o, v) 191 #define bus_space_read_stream_2(t, h, o) dbsdr(bsrs2, t, h, o) 192 #define bus_space_write_stream_2(t, h, o, v) dbsdw(bsws2, t, h, o, v) 193 194 #define bus_space_read_multi_2(t, h, o, p, c) dbsm(bsrm2, t, h, o, p, c) 195 #define bus_space_write_multi_2(t, h, o, p, c) dbsm(bswm2, t, h, o, p, c) 196 197 #define bus_space_read_multi_stream_2(t, h, o, p, c) \ 198 dbsm(bsrms2, t, h, o, p, c) 199 200 #define bus_space_write_multi_stream_2(t, h, o, p, c) \ 201 dbsm(bswms2, t, h, o, p, c) 202 203 #define bus_space_read_region_2(t, h, o, p, c) dbsm(bsrr2, t, h, o, p, c) 204 #define bus_space_write_region_2(t, h, o, p, c) dbsm(bswr2, t, h, o, p, c) 205 206 #define bus_space_read_region_stream_2(t, h, o, p, c) \ 207 dbsm(bsrrs2, t, h, o, p, c) 208 209 #define bus_space_write_region_stream_2(t, h, o, p, c) \ 210 dbsm(bswrs2, t, h, o, p, c) 211 212 #define bus_space_set_region_2(t, h, o, v, c) dbss(bssr2, t, h, o, v, c) 213 #define bus_space_copy_region_2(t, h, o, g, q, c) dbss(bscr2, t, h, o, g, q, c) 214 215 /* 4: long-wide "functions" */ 216 217 #define bus_space_read_4(t, h, o) dbsdr(bsr4, t, h, o) 218 #define bus_space_write_4(t, h, o, v) dbsdw(bsw4, t, h, o, v) 219 #define bus_space_read_stream_4(t, h, o) dbsdr(bsrs4, t, h, o) 220 #define bus_space_write_stream_4(t, h, o, v) dbsdw(bsws4, t, h, o, v) 221 222 #define bus_space_read_multi_4(t, h, o, p, c) dbsm(bsrm4, t, h, o, p, c) 223 #define bus_space_write_multi_4(t, h, o, p, c) dbsm(bswm4, t, h, o, p, c) 224 225 #define bus_space_read_multi_stream_4(t, h, o, p, c) \ 226 dbsm(bsrms4, t, h, o, p, c) 227 228 #define bus_space_write_multi_stream_4(t, h, o, p, c) \ 229 dbsm(bswms4, t, h, o, p, c) 230 231 #define bus_space_read_region_4(t, h, o, p, c) dbsm(bsrr4, t, h, o, p, c) 232 #define bus_space_write_region_4(t, h, o, p, c) dbsm(bswr4, t, h, o, p, c) 233 234 #define bus_space_read_region_stream_4(t, h, o, p, c) \ 235 dbsm(bsrrs4, t, h, o, p, c) 236 237 #define bus_space_write_region_stream_4(t, h, o, p, c) \ 238 dbsm(bswrs4, t, h, o, p, c) 239 240 #define bus_space_set_region_4(t, h, o, v, c) dbss(bssr4, t, h, o, v, c) 241 #define bus_space_copy_region_4(t, h, o, g, q, c) dbss(bscr4, t, h, o, g, q, c) 242 243 /* 244 * Bus read/write barrier methods. 245 * 246 * void bus_space_barrier(bus_space_tag_t tag, 247 * bus_space_handle_t bsh, bus_size_t offset, 248 * bus_size_t len, int flags); 249 * 250 * Note: the 680x0 does not currently require barriers, but we must 251 * provide the flags to MI code. 252 */ 253 void bus_space_barrier(bus_space_tag_t space, bus_space_handle_t handle, 254 bus_size_t offset, bus_size_t length, int flags); 255 256 #define BUS_SPACE_BARRIER_READ 0x01 /* force read barrier */ 257 #define BUS_SPACE_BARRIER_WRITE 0x02 /* force write barrier */ 258 259 #define BUS_SPACE_ALIGNED_POINTER(p, t) ALIGNED_POINTER(p, t) 260 261 #define __BUS_SPACE_HAS_STREAM_METHODS 262 263 paddr_t bus_space_mmap(bus_space_tag_t t, bus_addr_t addr, off_t off, int prot, 264 int flags); 265 266 #define BUS_SPACE_MAP_CACHEABLE 0x01 267 #define BUS_SPACE_MAP_LINEAR 0x02 268 #define BUS_SPACE_MAP_PREFETCHABLE 0x04 269 270 /* Instruction for enforcing reorder protection. Nothing for 68k. */ 271 #define amiga_bus_reorder_protect() 272 273 void * bus_space_vaddr(bus_space_tag_t space, bus_space_handle_t handle); 274 275 extern const struct amiga_bus_space_methods amiga_bus_stride_1; 276 extern const struct amiga_bus_space_methods amiga_bus_stride_1swap; 277 extern const struct amiga_bus_space_methods amiga_bus_stride_1swap_abs; 278 extern const struct amiga_bus_space_methods amiga_bus_stride_2; 279 extern const struct amiga_bus_space_methods amiga_bus_stride_4; 280 extern const struct amiga_bus_space_methods amiga_bus_stride_4swap; 281 extern const struct amiga_bus_space_methods amiga_bus_stride_16; 282 extern const struct amiga_bus_space_methods amiga_bus_stride_0x1000; 283 extern const struct amiga_bus_space_methods amiga_bus_stride_0x4000; 284 extern const struct amiga_bus_space_methods empb_bus_swap; 285 286 /* 287 * XXX 288 * amiga doesn't have actual bus_dma(9) implementation for PCI devices yet. 289 */ 290 #include <m68k/bus_dma.h> 291 292 #endif /* _AMIGA_BUS_H_ */ 293 294