bus_defs.h revision 1.1.18.2 1 1.1.18.2 jdolecek /* $NetBSD: bus_defs.h,v 1.1.18.2 2017/12/03 11:36:34 jdolecek Exp $ */
2 1.1.18.2 jdolecek /* $OpenBSD: bus.h,v 1.1 1997/10/13 10:53:42 pefo Exp $ */
3 1.1.18.2 jdolecek
4 1.1.18.2 jdolecek /*-
5 1.1.18.2 jdolecek * Copyright (c) 1996, 1997, 1998 The NetBSD Foundation, Inc.
6 1.1.18.2 jdolecek * All rights reserved.
7 1.1.18.2 jdolecek *
8 1.1.18.2 jdolecek * This code is derived from software contributed to The NetBSD Foundation
9 1.1.18.2 jdolecek * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
10 1.1.18.2 jdolecek * NASA Ames Research Center.
11 1.1.18.2 jdolecek *
12 1.1.18.2 jdolecek * Redistribution and use in source and binary forms, with or without
13 1.1.18.2 jdolecek * modification, are permitted provided that the following conditions
14 1.1.18.2 jdolecek * are met:
15 1.1.18.2 jdolecek * 1. Redistributions of source code must retain the above copyright
16 1.1.18.2 jdolecek * notice, this list of conditions and the following disclaimer.
17 1.1.18.2 jdolecek * 2. Redistributions in binary form must reproduce the above copyright
18 1.1.18.2 jdolecek * notice, this list of conditions and the following disclaimer in the
19 1.1.18.2 jdolecek * documentation and/or other materials provided with the distribution.
20 1.1.18.2 jdolecek *
21 1.1.18.2 jdolecek * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
22 1.1.18.2 jdolecek * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
23 1.1.18.2 jdolecek * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24 1.1.18.2 jdolecek * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
25 1.1.18.2 jdolecek * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26 1.1.18.2 jdolecek * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27 1.1.18.2 jdolecek * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28 1.1.18.2 jdolecek * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 1.1.18.2 jdolecek * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30 1.1.18.2 jdolecek * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31 1.1.18.2 jdolecek * POSSIBILITY OF SUCH DAMAGE.
32 1.1.18.2 jdolecek */
33 1.1.18.2 jdolecek
34 1.1.18.2 jdolecek /*
35 1.1.18.2 jdolecek * Copyright (c) 1996 Charles M. Hannum. All rights reserved.
36 1.1.18.2 jdolecek * Copyright (c) 1996 Jason R. Thorpe. All rights reserved.
37 1.1.18.2 jdolecek * Copyright (c) 1996 Christopher G. Demetriou. All rights reserved.
38 1.1.18.2 jdolecek *
39 1.1.18.2 jdolecek * Redistribution and use in source and binary forms, with or without
40 1.1.18.2 jdolecek * modification, are permitted provided that the following conditions
41 1.1.18.2 jdolecek * are met:
42 1.1.18.2 jdolecek * 1. Redistributions of source code must retain the above copyright
43 1.1.18.2 jdolecek * notice, this list of conditions and the following disclaimer.
44 1.1.18.2 jdolecek * 2. Redistributions in binary form must reproduce the above copyright
45 1.1.18.2 jdolecek * notice, this list of conditions and the following disclaimer in the
46 1.1.18.2 jdolecek * documentation and/or other materials provided with the distribution.
47 1.1.18.2 jdolecek * 3. All advertising materials mentioning features or use of this software
48 1.1.18.2 jdolecek * must display the following acknowledgement:
49 1.1.18.2 jdolecek * This product includes software developed by Christopher G. Demetriou
50 1.1.18.2 jdolecek * for the NetBSD Project.
51 1.1.18.2 jdolecek * 4. The name of the author may not be used to endorse or promote products
52 1.1.18.2 jdolecek * derived from this software without specific prior written permission
53 1.1.18.2 jdolecek *
54 1.1.18.2 jdolecek * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
55 1.1.18.2 jdolecek * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
56 1.1.18.2 jdolecek * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
57 1.1.18.2 jdolecek * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
58 1.1.18.2 jdolecek * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
59 1.1.18.2 jdolecek * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
60 1.1.18.2 jdolecek * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
61 1.1.18.2 jdolecek * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
62 1.1.18.2 jdolecek * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
63 1.1.18.2 jdolecek * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
64 1.1.18.2 jdolecek */
65 1.1.18.2 jdolecek
66 1.1.18.2 jdolecek /*
67 1.1.18.2 jdolecek * Copyright (c) 1997 Per Fogelstrom. All rights reserved.
68 1.1.18.2 jdolecek * Copyright (c) 1996 Niklas Hallqvist. All rights reserved.
69 1.1.18.2 jdolecek *
70 1.1.18.2 jdolecek * Redistribution and use in source and binary forms, with or without
71 1.1.18.2 jdolecek * modification, are permitted provided that the following conditions
72 1.1.18.2 jdolecek * are met:
73 1.1.18.2 jdolecek * 1. Redistributions of source code must retain the above copyright
74 1.1.18.2 jdolecek * notice, this list of conditions and the following disclaimer.
75 1.1.18.2 jdolecek * 2. Redistributions in binary form must reproduce the above copyright
76 1.1.18.2 jdolecek * notice, this list of conditions and the following disclaimer in the
77 1.1.18.2 jdolecek * documentation and/or other materials provided with the distribution.
78 1.1.18.2 jdolecek * 3. All advertising materials mentioning features or use of this software
79 1.1.18.2 jdolecek * must display the following acknowledgement:
80 1.1.18.2 jdolecek * This product includes software developed by Christopher G. Demetriou
81 1.1.18.2 jdolecek * for the NetBSD Project.
82 1.1.18.2 jdolecek * 4. The name of the author may not be used to endorse or promote products
83 1.1.18.2 jdolecek * derived from this software without specific prior written permission
84 1.1.18.2 jdolecek *
85 1.1.18.2 jdolecek * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
86 1.1.18.2 jdolecek * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
87 1.1.18.2 jdolecek * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
88 1.1.18.2 jdolecek * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
89 1.1.18.2 jdolecek * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
90 1.1.18.2 jdolecek * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
91 1.1.18.2 jdolecek * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
92 1.1.18.2 jdolecek * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
93 1.1.18.2 jdolecek * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
94 1.1.18.2 jdolecek * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
95 1.1.18.2 jdolecek */
96 1.1.18.2 jdolecek
97 1.1.18.2 jdolecek #ifndef _OR1K_BUS_DEFS_H_
98 1.1.18.2 jdolecek #define _OR1K_BUS_DEFS_H_
99 1.1.18.2 jdolecek
100 1.1.18.2 jdolecek /*
101 1.1.18.2 jdolecek * Bus access types.
102 1.1.18.2 jdolecek */
103 1.1.18.2 jdolecek typedef uintptr_t bus_addr_t;
104 1.1.18.2 jdolecek typedef uintptr_t bus_size_t;
105 1.1.18.2 jdolecek
106 1.1.18.2 jdolecek typedef uintptr_t bus_space_handle_t;
107 1.1.18.2 jdolecek typedef const struct or1k_bus_space *bus_space_tag_t;
108 1.1.18.2 jdolecek
109 1.1.18.2 jdolecek struct extent;
110 1.1.18.2 jdolecek
111 1.1.18.2 jdolecek struct or1k_bus_space_scalar {
112 1.1.18.2 jdolecek uint8_t (*pbss_read_1)(bus_space_tag_t, bus_space_handle_t,
113 1.1.18.2 jdolecek bus_size_t);
114 1.1.18.2 jdolecek uint16_t (*pbss_read_2)(bus_space_tag_t, bus_space_handle_t,
115 1.1.18.2 jdolecek bus_size_t);
116 1.1.18.2 jdolecek uint32_t (*pbss_read_4)(bus_space_tag_t, bus_space_handle_t,
117 1.1.18.2 jdolecek bus_size_t);
118 1.1.18.2 jdolecek uint64_t (*pbss_read_8)(bus_space_tag_t, bus_space_handle_t,
119 1.1.18.2 jdolecek bus_size_t);
120 1.1.18.2 jdolecek
121 1.1.18.2 jdolecek void (*pbss_write_1)(bus_space_tag_t, bus_space_handle_t, bus_size_t,
122 1.1.18.2 jdolecek uint8_t);
123 1.1.18.2 jdolecek void (*pbss_write_2)(bus_space_tag_t, bus_space_handle_t, bus_size_t,
124 1.1.18.2 jdolecek uint16_t);
125 1.1.18.2 jdolecek void (*pbss_write_4)(bus_space_tag_t, bus_space_handle_t, bus_size_t,
126 1.1.18.2 jdolecek uint32_t);
127 1.1.18.2 jdolecek void (*pbss_write_8)(bus_space_tag_t, bus_space_handle_t, bus_size_t,
128 1.1.18.2 jdolecek uint64_t);
129 1.1.18.2 jdolecek };
130 1.1.18.2 jdolecek
131 1.1.18.2 jdolecek struct or1k_bus_space_group {
132 1.1.18.2 jdolecek void (*pbsg_read_1)(bus_space_tag_t, bus_space_handle_t,
133 1.1.18.2 jdolecek bus_size_t, uint8_t *, size_t);
134 1.1.18.2 jdolecek void (*pbsg_read_2)(bus_space_tag_t, bus_space_handle_t,
135 1.1.18.2 jdolecek bus_size_t, uint16_t *, size_t);
136 1.1.18.2 jdolecek void (*pbsg_read_4)(bus_space_tag_t, bus_space_handle_t,
137 1.1.18.2 jdolecek bus_size_t, uint32_t *, size_t);
138 1.1.18.2 jdolecek void (*pbsg_read_8)(bus_space_tag_t, bus_space_handle_t,
139 1.1.18.2 jdolecek bus_size_t, uint64_t *, size_t);
140 1.1.18.2 jdolecek
141 1.1.18.2 jdolecek void (*pbsg_write_1)(bus_space_tag_t, bus_space_handle_t,
142 1.1.18.2 jdolecek bus_size_t, const uint8_t *, size_t);
143 1.1.18.2 jdolecek void (*pbsg_write_2)(bus_space_tag_t, bus_space_handle_t,
144 1.1.18.2 jdolecek bus_size_t, const uint16_t *, size_t);
145 1.1.18.2 jdolecek void (*pbsg_write_4)(bus_space_tag_t, bus_space_handle_t,
146 1.1.18.2 jdolecek bus_size_t, const uint32_t *, size_t);
147 1.1.18.2 jdolecek void (*pbsg_write_8)(bus_space_tag_t, bus_space_handle_t,
148 1.1.18.2 jdolecek bus_size_t, const uint64_t *, size_t);
149 1.1.18.2 jdolecek };
150 1.1.18.2 jdolecek
151 1.1.18.2 jdolecek struct or1k_bus_space_set {
152 1.1.18.2 jdolecek void (*pbss_set_1)(bus_space_tag_t, bus_space_handle_t,
153 1.1.18.2 jdolecek bus_size_t, uint8_t, size_t);
154 1.1.18.2 jdolecek void (*pbss_set_2)(bus_space_tag_t, bus_space_handle_t,
155 1.1.18.2 jdolecek bus_size_t, uint16_t, size_t);
156 1.1.18.2 jdolecek void (*pbss_set_4)(bus_space_tag_t, bus_space_handle_t,
157 1.1.18.2 jdolecek bus_size_t, uint32_t, size_t);
158 1.1.18.2 jdolecek void (*pbss_set_8)(bus_space_tag_t, bus_space_handle_t,
159 1.1.18.2 jdolecek bus_size_t, uint64_t, size_t);
160 1.1.18.2 jdolecek };
161 1.1.18.2 jdolecek
162 1.1.18.2 jdolecek struct or1k_bus_space_copy {
163 1.1.18.2 jdolecek void (*pbsc_copy_1)(bus_space_tag_t, bus_space_handle_t,
164 1.1.18.2 jdolecek bus_size_t, bus_space_handle_t, bus_size_t, size_t);
165 1.1.18.2 jdolecek void (*pbsc_copy_2)(bus_space_tag_t, bus_space_handle_t,
166 1.1.18.2 jdolecek bus_size_t, bus_space_handle_t, bus_size_t, size_t);
167 1.1.18.2 jdolecek void (*pbsc_copy_4)(bus_space_tag_t, bus_space_handle_t,
168 1.1.18.2 jdolecek bus_size_t, bus_space_handle_t, bus_size_t, size_t);
169 1.1.18.2 jdolecek void (*pbsc_copy_8)(bus_space_tag_t, bus_space_handle_t,
170 1.1.18.2 jdolecek bus_size_t, bus_space_handle_t, bus_size_t, size_t);
171 1.1.18.2 jdolecek };
172 1.1.18.2 jdolecek
173 1.1.18.2 jdolecek struct or1k_bus_space {
174 1.1.18.2 jdolecek int pbs_flags;
175 1.1.18.2 jdolecek #define _BUS_SPACE_BIG_ENDIAN 0x00000100
176 1.1.18.2 jdolecek #define _BUS_SPACE_LITTLE_ENDIAN 0x00000000
177 1.1.18.2 jdolecek #define _BUS_SPACE_IO_TYPE 0x00000200
178 1.1.18.2 jdolecek #define _BUS_SPACE_MEM_TYPE 0x00000000
179 1.1.18.2 jdolecek #define _BUS_SPACE_STRIDE_MASK 0x0000001f
180 1.1.18.2 jdolecek bus_addr_t pbs_offset; /* offset to real start */
181 1.1.18.2 jdolecek bus_addr_t pbs_base; /* extent base */
182 1.1.18.2 jdolecek bus_addr_t pbs_limit; /* extent limit */
183 1.1.18.2 jdolecek struct extent *pbs_extent;
184 1.1.18.2 jdolecek
185 1.1.18.2 jdolecek paddr_t (*pbs_mmap)(bus_space_tag_t, bus_addr_t, off_t, int, int);
186 1.1.18.2 jdolecek int (*pbs_map)(bus_space_tag_t, bus_addr_t, bus_size_t, int,
187 1.1.18.2 jdolecek bus_space_handle_t *);
188 1.1.18.2 jdolecek void (*pbs_unmap)(bus_space_tag_t, bus_space_handle_t, bus_size_t);
189 1.1.18.2 jdolecek int (*pbs_alloc)(bus_space_tag_t, bus_addr_t, bus_addr_t, bus_size_t,
190 1.1.18.2 jdolecek bus_size_t align, bus_size_t, int, bus_addr_t *,
191 1.1.18.2 jdolecek bus_space_handle_t *);
192 1.1.18.2 jdolecek void (*pbs_free)(bus_space_tag_t, bus_space_handle_t, bus_size_t);
193 1.1.18.2 jdolecek int (*pbs_subregion)(bus_space_tag_t, bus_space_handle_t, bus_size_t,
194 1.1.18.2 jdolecek bus_size_t, bus_space_handle_t *);
195 1.1.18.2 jdolecek
196 1.1.18.2 jdolecek struct or1k_bus_space_scalar pbs_scalar;
197 1.1.18.2 jdolecek struct or1k_bus_space_scalar pbs_scalar_stream;
198 1.1.18.2 jdolecek const struct or1k_bus_space_group *pbs_multi;
199 1.1.18.2 jdolecek const struct or1k_bus_space_group *pbs_multi_stream;
200 1.1.18.2 jdolecek const struct or1k_bus_space_group *pbs_region;
201 1.1.18.2 jdolecek const struct or1k_bus_space_group *pbs_region_stream;
202 1.1.18.2 jdolecek const struct or1k_bus_space_set *pbs_set;
203 1.1.18.2 jdolecek const struct or1k_bus_space_set *pbs_set_stream;
204 1.1.18.2 jdolecek const struct or1k_bus_space_copy *pbs_copy;
205 1.1.18.2 jdolecek };
206 1.1.18.2 jdolecek
207 1.1.18.2 jdolecek #define _BUS_SPACE_STRIDE(t, o) \
208 1.1.18.2 jdolecek ((o) << ((t)->pbs_flags & _BUS_SPACE_STRIDE_MASK))
209 1.1.18.2 jdolecek #define _BUS_SPACE_UNSTRIDE(t, o) \
210 1.1.18.2 jdolecek ((o) >> ((t)->pbs_flags & _BUS_SPACE_STRIDE_MASK))
211 1.1.18.2 jdolecek
212 1.1.18.2 jdolecek #define BUS_SPACE_MAP_CACHEABLE 0x01
213 1.1.18.2 jdolecek #define BUS_SPACE_MAP_LINEAR 0x02
214 1.1.18.2 jdolecek #define BUS_SPACE_MAP_PREFETCHABLE 0x04
215 1.1.18.2 jdolecek
216 1.1.18.2 jdolecek int bus_space_init(struct or1k_bus_space *, const char *, void *, size_t);
217 1.1.18.2 jdolecek void bus_space_mallocok(void);
218 1.1.18.2 jdolecek
219 1.1.18.2 jdolecek /*
220 1.1.18.2 jdolecek * Access methods for bus resources
221 1.1.18.2 jdolecek */
222 1.1.18.2 jdolecek
223 1.1.18.2 jdolecek #define __BUS_SPACE_HAS_STREAM_METHODS
224 1.1.18.2 jdolecek
225 1.1.18.2 jdolecek #define BUS_SPACE_BARRIER_READ 0x01 /* force read barrier */
226 1.1.18.2 jdolecek #define BUS_SPACE_BARRIER_WRITE 0x02 /* force write barrier */
227 1.1.18.2 jdolecek
228 1.1.18.2 jdolecek #define BUS_SPACE_ALIGNED_POINTER(p, t) ALIGNED_POINTER(p, t)
229 1.1.18.2 jdolecek
230 1.1.18.2 jdolecek /*
231 1.1.18.2 jdolecek * Bus DMA methods.
232 1.1.18.2 jdolecek */
233 1.1.18.2 jdolecek
234 1.1.18.2 jdolecek /*
235 1.1.18.2 jdolecek * Flags used in various bus DMA methods.
236 1.1.18.2 jdolecek */
237 1.1.18.2 jdolecek #define BUS_DMA_WAITOK 0x000 /* safe to sleep (pseudo-flag) */
238 1.1.18.2 jdolecek #define BUS_DMA_NOWAIT 0x001 /* not safe to sleep */
239 1.1.18.2 jdolecek #define BUS_DMA_ALLOCNOW 0x002 /* perform resource allocation now */
240 1.1.18.2 jdolecek #define BUS_DMA_COHERENT 0x004 /* hint: map memory DMA coherent */
241 1.1.18.2 jdolecek #define BUS_DMA_STREAMING 0x008 /* hint: sequential, unidirectional */
242 1.1.18.2 jdolecek #define BUS_DMA_BUS1 0x010 /* placeholders for bus functions... */
243 1.1.18.2 jdolecek #define BUS_DMA_BUS2 0x020
244 1.1.18.2 jdolecek #define BUS_DMA_BUS3 0x040
245 1.1.18.2 jdolecek #define BUS_DMA_BUS4 0x080
246 1.1.18.2 jdolecek #define BUS_DMA_READ 0x100 /* mapping is device -> memory only */
247 1.1.18.2 jdolecek #define BUS_DMA_WRITE 0x200 /* mapping is memory -> device only */
248 1.1.18.2 jdolecek #define BUS_DMA_NOCACHE 0x400 /* hint: map non-cached memory */
249 1.1.18.2 jdolecek
250 1.1.18.2 jdolecek #ifndef BUS_DMA_DONTCACHE
251 1.1.18.2 jdolecek #define BUS_DMA_DONTCACHE BUS_DMA_NOCACHE
252 1.1.18.2 jdolecek #endif
253 1.1.18.2 jdolecek
254 1.1.18.2 jdolecek /* Forwards needed by prototypes below. */
255 1.1.18.2 jdolecek struct proc;
256 1.1.18.2 jdolecek struct mbuf;
257 1.1.18.2 jdolecek struct uio;
258 1.1.18.2 jdolecek
259 1.1.18.2 jdolecek /*
260 1.1.18.2 jdolecek * Operations performed by bus_dmamap_sync().
261 1.1.18.2 jdolecek */
262 1.1.18.2 jdolecek #define BUS_DMASYNC_PREREAD 0x01 /* pre-read synchronization */
263 1.1.18.2 jdolecek #define BUS_DMASYNC_POSTREAD 0x02 /* post-read synchronization */
264 1.1.18.2 jdolecek #define BUS_DMASYNC_PREWRITE 0x04 /* pre-write synchronization */
265 1.1.18.2 jdolecek #define BUS_DMASYNC_POSTWRITE 0x08 /* post-write synchronization */
266 1.1.18.2 jdolecek
267 1.1.18.2 jdolecek typedef struct or1k_bus_dma_tag *bus_dma_tag_t;
268 1.1.18.2 jdolecek typedef struct or1k_bus_dmamap *bus_dmamap_t;
269 1.1.18.2 jdolecek
270 1.1.18.2 jdolecek #define BUS_DMA_TAG_VALID(t) ((t) != (bus_dma_tag_t)0)
271 1.1.18.2 jdolecek
272 1.1.18.2 jdolecek /*
273 1.1.18.2 jdolecek * bus_dma_segment_t
274 1.1.18.2 jdolecek *
275 1.1.18.2 jdolecek * Describes a single contiguous DMA transaction. Values
276 1.1.18.2 jdolecek * are suitable for programming into DMA registers.
277 1.1.18.2 jdolecek */
278 1.1.18.2 jdolecek struct or1k_bus_dma_segment {
279 1.1.18.2 jdolecek bus_addr_t ds_addr; /* DMA address */
280 1.1.18.2 jdolecek bus_size_t ds_len; /* length of transfer */
281 1.1.18.2 jdolecek };
282 1.1.18.2 jdolecek typedef struct or1k_bus_dma_segment bus_dma_segment_t;
283 1.1.18.2 jdolecek
284 1.1.18.2 jdolecek /*
285 1.1.18.2 jdolecek * bus_dma_tag_t
286 1.1.18.2 jdolecek *
287 1.1.18.2 jdolecek * A machine-dependent opaque type describing the implementation of
288 1.1.18.2 jdolecek * DMA for a given bus.
289 1.1.18.2 jdolecek */
290 1.1.18.2 jdolecek
291 1.1.18.2 jdolecek struct or1k_bus_dma_tag {
292 1.1.18.2 jdolecek /*
293 1.1.18.2 jdolecek * The `bounce threshold' is checked while we are loading
294 1.1.18.2 jdolecek * the DMA map. If the physical address of the segment
295 1.1.18.2 jdolecek * exceeds the threshold, an error will be returned. The
296 1.1.18.2 jdolecek * caller can then take whatever action is necessary to
297 1.1.18.2 jdolecek * bounce the transfer. If this value is 0, it will be
298 1.1.18.2 jdolecek * ignored.
299 1.1.18.2 jdolecek */
300 1.1.18.2 jdolecek bus_addr_t _bounce_thresh;
301 1.1.18.2 jdolecek
302 1.1.18.2 jdolecek /*
303 1.1.18.2 jdolecek * DMA mapping methods.
304 1.1.18.2 jdolecek */
305 1.1.18.2 jdolecek int (*_dmamap_create) (bus_dma_tag_t, bus_size_t, int,
306 1.1.18.2 jdolecek bus_size_t, bus_size_t, int, bus_dmamap_t *);
307 1.1.18.2 jdolecek void (*_dmamap_destroy) (bus_dma_tag_t, bus_dmamap_t);
308 1.1.18.2 jdolecek int (*_dmamap_load) (bus_dma_tag_t, bus_dmamap_t, void *,
309 1.1.18.2 jdolecek bus_size_t, struct proc *, int);
310 1.1.18.2 jdolecek int (*_dmamap_load_mbuf) (bus_dma_tag_t, bus_dmamap_t,
311 1.1.18.2 jdolecek struct mbuf *, int);
312 1.1.18.2 jdolecek int (*_dmamap_load_uio) (bus_dma_tag_t, bus_dmamap_t,
313 1.1.18.2 jdolecek struct uio *, int);
314 1.1.18.2 jdolecek int (*_dmamap_load_raw) (bus_dma_tag_t, bus_dmamap_t,
315 1.1.18.2 jdolecek bus_dma_segment_t *, int, bus_size_t, int);
316 1.1.18.2 jdolecek void (*_dmamap_unload) (bus_dma_tag_t, bus_dmamap_t);
317 1.1.18.2 jdolecek void (*_dmamap_sync) (bus_dma_tag_t, bus_dmamap_t,
318 1.1.18.2 jdolecek bus_addr_t, bus_size_t, int);
319 1.1.18.2 jdolecek
320 1.1.18.2 jdolecek /*
321 1.1.18.2 jdolecek * DMA memory utility functions.
322 1.1.18.2 jdolecek */
323 1.1.18.2 jdolecek int (*_dmamem_alloc) (bus_dma_tag_t, bus_size_t, bus_size_t,
324 1.1.18.2 jdolecek bus_size_t, bus_dma_segment_t *, int, int *, int);
325 1.1.18.2 jdolecek void (*_dmamem_free) (bus_dma_tag_t,
326 1.1.18.2 jdolecek bus_dma_segment_t *, int);
327 1.1.18.2 jdolecek int (*_dmamem_map) (bus_dma_tag_t, bus_dma_segment_t *,
328 1.1.18.2 jdolecek int, size_t, void **, int);
329 1.1.18.2 jdolecek void (*_dmamem_unmap) (bus_dma_tag_t, void *, size_t);
330 1.1.18.2 jdolecek paddr_t (*_dmamem_mmap) (bus_dma_tag_t, bus_dma_segment_t *,
331 1.1.18.2 jdolecek int, off_t, int, int);
332 1.1.18.2 jdolecek
333 1.1.18.2 jdolecek #ifndef PHYS_TO_BUS_MEM
334 1.1.18.2 jdolecek bus_addr_t (*_dma_phys_to_bus_mem)(bus_dma_tag_t, bus_addr_t);
335 1.1.18.2 jdolecek #define PHYS_TO_BUS_MEM(t, addr) (*(t)->_dma_phys_to_bus_mem)((t), (addr))
336 1.1.18.2 jdolecek #endif
337 1.1.18.2 jdolecek #ifndef BUS_MEM_TO_PHYS
338 1.1.18.2 jdolecek bus_addr_t (*_dma_bus_mem_to_phys)(bus_dma_tag_t, bus_addr_t);
339 1.1.18.2 jdolecek #define BUS_MEM_TO_PHYS(t, addr) (*(t)->_dma_bus_mem_to_phys)((t), (addr))
340 1.1.18.2 jdolecek #endif
341 1.1.18.2 jdolecek };
342 1.1.18.2 jdolecek
343 1.1.18.2 jdolecek /*
344 1.1.18.2 jdolecek * bus_dmamap_t
345 1.1.18.2 jdolecek *
346 1.1.18.2 jdolecek * Describes a DMA mapping.
347 1.1.18.2 jdolecek */
348 1.1.18.2 jdolecek struct or1k_bus_dmamap {
349 1.1.18.2 jdolecek /*
350 1.1.18.2 jdolecek * PRIVATE MEMBERS: not for use my machine-independent code.
351 1.1.18.2 jdolecek */
352 1.1.18.2 jdolecek bus_size_t _dm_size; /* largest DMA transfer mappable */
353 1.1.18.2 jdolecek int _dm_segcnt; /* number of segs this map can map */
354 1.1.18.2 jdolecek bus_size_t _dm_maxmaxsegsz; /* fixed largest possible segment */
355 1.1.18.2 jdolecek bus_size_t _dm_boundary; /* don't cross this */
356 1.1.18.2 jdolecek bus_addr_t _dm_bounce_thresh; /* bounce threshold; see tag */
357 1.1.18.2 jdolecek int _dm_flags; /* misc. flags */
358 1.1.18.2 jdolecek
359 1.1.18.2 jdolecek void *_dm_cookie; /* cookie for bus-specific functions */
360 1.1.18.2 jdolecek
361 1.1.18.2 jdolecek /*
362 1.1.18.2 jdolecek * PUBLIC MEMBERS: these are used by machine-independent code.
363 1.1.18.2 jdolecek */
364 1.1.18.2 jdolecek bus_size_t dm_maxsegsz; /* largest possible segment */
365 1.1.18.2 jdolecek bus_size_t dm_mapsize; /* size of the mapping */
366 1.1.18.2 jdolecek int dm_nsegs; /* # valid segments in mapping */
367 1.1.18.2 jdolecek bus_dma_segment_t dm_segs[1]; /* segments; variable length */
368 1.1.18.2 jdolecek };
369 1.1.18.2 jdolecek
370 1.1.18.2 jdolecek #endif /* _OR1K_BUS_DEFS_H_ */
371