Home | History | Annotate | Line # | Download | only in include
autoconf.h revision 1.1.1.1.2.1
      1 /*	$NetBSD: autoconf.h,v 1.1.1.1.2.1 1998/07/30 14:03:52 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 /* Attach arguments presented by mainbus_attach() */
    107 struct mainbus_attach_args {
    108 	bus_space_tag_t	ma_bustag;	/* parent bus tag */
    109 	bus_dma_tag_t	ma_dmatag;
    110 	char		*ma_name;	/* PROM node name */
    111 	int		ma_node;	/* PROM handle */
    112 	struct upa_reg	*ma_reg;	/* "reg" properties */
    113 	int		ma_nreg;
    114 	void*		*ma_address;	/* "address" properties */
    115 	int		ma_naddress;
    116 	int		*ma_interrupts;	/* "interrupts" properties */
    117 	int		ma_ninterrupts;
    118 	int		ma_pri;		/* priority (IPL) */
    119 	struct bootpath *ma_bp;		/* used for locating boot device */
    120 };
    121 
    122 /* Attach arguments presented to devices by obio_attach() (sun4 only) */
    123 struct obio4_attach_args {
    124 	int		oba_placeholder;/* obio/sbus attach args sharing */
    125 	bus_space_tag_t	oba_bustag;	/* parent bus tag */
    126 	bus_dma_tag_t	oba_dmatag;
    127 	bus_addr_t	oba_paddr;	/* register physical address */
    128 	int		oba_pri;	/* interrupt priority (IPL) */
    129 	struct bootpath *oba_bp;	/* used for locating boot device */
    130 };
    131 
    132 union obio_attach_args {
    133 	/* sun4m obio space is treated like an sbus slot */
    134 	int				uoba_isobio4;
    135 	struct sbus_attach_args		uoba_sbus;	/* Sbus view */
    136 	struct obio4_attach_args	uoba_oba4;	/* sun4 on-board view */
    137 };
    138 
    139 #define obio_bus_map(t, a, o, s, f, v, hp)		\
    140 	bus_space_map2(t, 0, (long)(a) + o, s, f, (vaddr_t)v, hp)
    141 
    142 /* obio specific bus flag */
    143 #define OBIO_BUS_MAP_USE_ROM	BUS_SPACE_MAP_BUS1
    144 
    145 /* obio bus helper that finds ROM mappings; exported for autoconf.c */
    146 int	obio_find_rom_map __P((bus_addr_t, int,
    147 				bus_space_handle_t *));
    148 
    149 
    150 /*
    151  * The various getprop* functions obtain `properties' from the ROMs.
    152  * getprop() obtains a property as a byte-sequence, and returns its
    153  * length; the others convert or make some other guarantee.
    154  */
    155 int	getproplen __P((int node, char *name));
    156 int	getprop __P((int node, char *name, void *buf, int bufsiz));
    157 char	*getpropstring __P((int node, char *name));
    158 int	getpropint __P((int node, char *name, int deflt));
    159 
    160 /* Frequently used options node */
    161 extern int optionsnode;
    162 
    163 	/* new interfaces: */
    164 int	getpropA __P((int, char *, int, int *, void **));
    165 char	*getpropstringA __P((int, char *, char *));
    166 
    167 /*
    168  * Helper routines to get some of the more common properties. These
    169  * only get the first item in case the property value is an array.
    170  * Drivers that "need to know it all" can call getprop() directly.
    171  */
    172 int	getprop_reg1 __P((int, struct sbus_reg *));
    173 int	getprop_intr1 __P((int, int *));
    174 int	getprop_address1 __P((int, void **));
    175 
    176 
    177 /*
    178  * The matchbyname function is useful in drivers that are matched
    179  * by romaux name, i.e., all `mainbus attached' devices.  It expects
    180  * its aux pointer to point to a pointer to the name (the address of
    181  * a romaux structure suffices, for instance). (OBSOLETE)
    182  */
    183 struct device;
    184 struct cfdata;
    185 int	matchbyname __P((struct device *, struct cfdata *cf, void *aux));
    186 
    187 /*
    188  * `clockfreq' produces a printable representation of a clock frequency
    189  * (this is just a frill).
    190  */
    191 char	*clockfreq __P((int freq));
    192 
    193 #if 0
    194 /*
    195  * Memory description arrays.  Shared between pmap.c and autoconf.c; no
    196  * one else should use this (except maybe mem.c, e.g., if we fix the VM to
    197  * handle discontiguous physical memory).
    198  */
    199 struct memarr {
    200 	u_int	addr;
    201 	u_int	len;
    202 };
    203 int	makememarr(struct memarr *, int max, int which);
    204 #define	MEMARR_AVAILPHYS	0
    205 #define	MEMARR_TOTALPHYS	1
    206 
    207 /* Pass a string to the FORTH interpreter.  May fail silently. */
    208 void	rominterpret __P((char *));
    209 #endif
    210 
    211 /* Openprom V2 style boot path */
    212 struct bootpath {
    213 	char	name[16];	/* name of this node */
    214 	int	val[3];		/* up to three optional values */
    215 	struct device *dev;	/* device that recognised this component */
    216 };
    217 struct bootpath	*bootpath_store __P((int, struct bootpath *));
    218 int		sd_crazymap __P((int));
    219 
    220 /* Parse a disk string into a dev_t, return device struct pointer */
    221 struct	device *parsedisk __P((char *, int, int, dev_t *));
    222 
    223 /* Establish a mountroot_hook, for benefit of floppy drive, mostly. */
    224 void	mountroot_hook_establish __P((void (*) __P((struct device *)),
    225 				      struct device *));
    226 
    227 void	configure __P((void));
    228 void	bootstrap __P((int));
    229 int	firstchild __P((int));
    230 int	nextsibling __P((int));
    231 void	callrom __P((void));
    232 void	romboot __P((char *));
    233 void	romhalt __P((void));
    234 struct device *getdevunit __P((char *, int));
    235 void	*findzs __P((int));
    236 int	romgetcursoraddr __P((int **, int **));
    237 int	findroot __P((void));
    238 int	findnode __P((int, const char *));
    239 int	opennode __P((char *));
    240 int	node_has_property __P((int, const char *));
    241 
    242