autoconf.h revision 1.3 1 /* $NetBSD: autoconf.h,v 1.3 1998/09/02 05:51:37 eeh Exp $ */
2
3 /*-
4 * Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Paul Kranenburg.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 * 3. All advertising materials mentioning features or use of this software
19 * must display the following acknowledgement:
20 * This product includes software developed by the NetBSD
21 * Foundation, Inc. and its contributors.
22 * 4. Neither the name of The NetBSD Foundation nor the names of its
23 * contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
25 *
26 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
27 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
28 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
29 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
30 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
31 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
32 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
33 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
34 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
35 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
36 * POSSIBILITY OF SUCH DAMAGE.
37 */
38
39 /*
40 * Copyright (c) 1992, 1993
41 * The Regents of the University of California. All rights reserved.
42 *
43 * This software was developed by the Computer Systems Engineering group
44 * at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
45 * contributed to Berkeley.
46 *
47 * All advertising materials mentioning features or use of this software
48 * must display the following acknowledgement:
49 * This product includes software developed by the University of
50 * California, Lawrence Berkeley Laboratory.
51 *
52 * Redistribution and use in source and binary forms, with or without
53 * modification, are permitted provided that the following conditions
54 * are met:
55 * 1. Redistributions of source code must retain the above copyright
56 * notice, this list of conditions and the following disclaimer.
57 * 2. Redistributions in binary form must reproduce the above copyright
58 * notice, this list of conditions and the following disclaimer in the
59 * documentation and/or other materials provided with the distribution.
60 * 3. All advertising materials mentioning features or use of this software
61 * must display the following acknowledgement:
62 * This product includes software developed by the University of
63 * California, Berkeley and its contributors.
64 * 4. Neither the name of the University nor the names of its contributors
65 * may be used to endorse or promote products derived from this software
66 * without specific prior written permission.
67 *
68 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
69 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
70 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
71 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
72 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
73 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
74 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
75 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
76 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
77 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
78 * SUCH DAMAGE.
79 *
80 * @(#)autoconf.h 8.2 (Berkeley) 9/30/93
81 */
82
83 /*
84 * Autoconfiguration information.
85 */
86
87 #include <machine/bus.h>
88 #include <sparc64/dev/upavar.h>
89 #include <sparc64/dev/sbusvar.h>
90
91 /* This is used to map device classes to IPLs */
92 struct intrmap {
93 char *in_class;
94 int in_lev;
95 };
96 extern struct intrmap intrmap[];
97
98 /* The "mainbus" on ultra desktops is actually the UPA bus. We need to
99 * separate this from peripheral buses like SBUS and PCI because each bus may
100 * have different ways of encoding properties, such as "reg" and "interrupts".
101 *
102 * Eventually I'll create a real UPA bus module to allow servers with multiple
103 * peripheral buses and things like FHC bus systems.
104 */
105
106 /*
107 * Attach arguments presented by mainbus_attach()
108 *
109 * Large fields first followed by smaller ones to minimize stack space used.
110 */
111 struct mainbus_attach_args {
112 bus_space_tag_t ma_bustag; /* parent bus tag */
113 bus_dma_tag_t ma_dmatag;
114 char *ma_name; /* PROM node name */
115 struct upa_reg *ma_reg; /* "reg" properties */
116 int *ma_address; /* "address" properties -- 32 bits */
117 int *ma_interrupts; /* "interrupts" properties */
118 struct bootpath *ma_bp; /* used for locating boot device */
119 int ma_node; /* PROM handle */
120 int ma_nreg; /* Counts for those properties */
121 int ma_naddress;
122 int ma_ninterrupts;
123 int ma_pri; /* priority (IPL) */
124 };
125
126 /* Attach arguments presented to devices by obio_attach() (sun4 only) */
127 struct obio4_attach_args {
128 int oba_placeholder;/* obio/sbus attach args sharing */
129 bus_space_tag_t oba_bustag; /* parent bus tag */
130 bus_dma_tag_t oba_dmatag;
131 bus_addr_t oba_paddr; /* register physical address */
132 int oba_pri; /* interrupt priority (IPL) */
133 struct bootpath *oba_bp; /* used for locating boot device */
134 };
135
136 union obio_attach_args {
137 /* sun4m obio space is treated like an sbus slot */
138 int uoba_isobio4;
139 struct sbus_attach_args uoba_sbus; /* Sbus view */
140 struct obio4_attach_args uoba_oba4; /* sun4 on-board view */
141 };
142
143 #define obio_bus_map(t, a, o, s, f, v, hp) \
144 bus_space_map2(t, 0, (long)(a) + o, s, f, (vaddr_t)v, hp)
145
146 /* obio specific bus flag */
147 #define OBIO_BUS_MAP_USE_ROM BUS_SPACE_MAP_BUS1
148
149 /* obio bus helper that finds ROM mappings; exported for autoconf.c */
150 int obio_find_rom_map __P((bus_addr_t, int,
151 bus_space_handle_t *));
152
153
154 /*
155 * The various getprop* functions obtain `properties' from the ROMs.
156 * getprop() obtains a property as a byte-sequence, and returns its
157 * length; the others convert or make some other guarantee.
158 */
159 long getproplen __P((int node, char *name));
160 int getprop __P((int node, char *name, void *buf, size_t bufsiz));
161 char *getpropstring __P((int node, char *name));
162 int getpropint __P((int node, char *name, int deflt));
163
164 /* Frequently used options node */
165 extern int optionsnode;
166
167 /* new interfaces: */
168 int getpropA __P((int, char *, size_t, int *, void **));
169 char *getpropstringA __P((int, char *, char *));
170
171 /*
172 * Helper routines to get some of the more common properties. These
173 * only get the first item in case the property value is an array.
174 * Drivers that "need to know it all" can call getprop() directly.
175 */
176 int getprop_reg1 __P((int, struct sbus_reg *));
177 int getprop_intr1 __P((int, int *));
178 int getprop_address1 __P((int, void **));
179
180
181 /*
182 * The matchbyname function is useful in drivers that are matched
183 * by romaux name, i.e., all `mainbus attached' devices. It expects
184 * its aux pointer to point to a pointer to the name (the address of
185 * a romaux structure suffices, for instance). (OBSOLETE)
186 */
187 struct device;
188 struct cfdata;
189 int matchbyname __P((struct device *, struct cfdata *cf, void *aux));
190
191 /*
192 * `clockfreq' produces a printable representation of a clock frequency
193 * (this is just a frill).
194 */
195 char *clockfreq __P((long freq));
196
197 #if 0
198 /*
199 * Memory description arrays. Shared between pmap.c and autoconf.c; no
200 * one else should use this (except maybe mem.c, e.g., if we fix the VM to
201 * handle discontiguous physical memory).
202 */
203 struct memarr {
204 u_int addr;
205 u_int len;
206 };
207 int makememarr(struct memarr *, int max, int which);
208 #define MEMARR_AVAILPHYS 0
209 #define MEMARR_TOTALPHYS 1
210
211 /* Pass a string to the FORTH interpreter. May fail silently. */
212 void rominterpret __P((char *));
213 #endif
214
215 /* Openprom V2 style boot path */
216 struct bootpath {
217 char name[16]; /* name of this node */
218 int val[3]; /* up to three optional values */
219 struct device *dev; /* device that recognised this component */
220 };
221 struct bootpath *bootpath_store __P((int, struct bootpath *));
222 int sd_crazymap __P((int));
223
224 /* Parse a disk string into a dev_t, return device struct pointer */
225 struct device *parsedisk __P((char *, int, int, dev_t *));
226
227 /* Establish a mountroot_hook, for benefit of floppy drive, mostly. */
228 void mountroot_hook_establish __P((void (*) __P((struct device *)),
229 struct device *));
230
231 void configure __P((void));
232 void bootstrap __P((int));
233 int firstchild __P((int));
234 int nextsibling __P((int));
235 void callrom __P((void));
236 void romboot __P((char *));
237 void romhalt __P((void));
238 struct device *getdevunit __P((char *, int));
239 void *findzs __P((int));
240 int romgetcursoraddr __P((int **, int **));
241 int findroot __P((void));
242 int findnode __P((int, const char *));
243 int opennode __P((char *));
244 int node_has_property __P((int, const char *));
245
246