sys/arch/sparc/include/autoconf.h

   1 /*      $NetBSD: autoconf.h,v 1.45 2008/02/12 17:30:58 joerg 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  *
  19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  29  * POSSIBILITY OF SUCH DAMAGE.
  30  */
  31
  32 /*
  33  * Copyright (c) 1992, 1993
  34  *      The Regents of the University of California.  All rights reserved.
  35  *
  36  * This software was developed by the Computer Systems Engineering group
  37  * at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
  38  * contributed to Berkeley.
  39  *
  40  * All advertising materials mentioning features or use of this software
  41  * must display the following acknowledgement:
  42  *      This product includes software developed by the University of
  43  *      California, Lawrence Berkeley Laboratory.
  44  *
  45  * Redistribution and use in source and binary forms, with or without
  46  * modification, are permitted provided that the following conditions
  47  * are met:
  48  * 1. Redistributions of source code must retain the above copyright
  49  *    notice, this list of conditions and the following disclaimer.
  50  * 2. Redistributions in binary form must reproduce the above copyright
  51  *    notice, this list of conditions and the following disclaimer in the
  52  *    documentation and/or other materials provided with the distribution.
  53  * 3. Neither the name of the University nor the names of its contributors
  54  *    may be used to endorse or promote products derived from this software
  55  *    without specific prior written permission.
  56  *
  57  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  58  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  59  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  60  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  61  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  62  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  63  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  64  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  65  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  66  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  67  * SUCH DAMAGE.
  68  *
  69  *      @(#)autoconf.h  8.2 (Berkeley) 9/30/93
  70  */
  71
  72 /*
  73  * Autoconfiguration information.
  74  */
  75
  76 #include <machine/bus.h>
  77 #include <machine/bsd_openprom.h>
  78 #include <machine/promlib.h>
  79 #include <dev/sbus/sbusvar.h>
  80
  81 /*
  82  * Most devices are configured according to information kept in
  83  * the FORTH PROMs.  In particular, we extract the `name', `reg',
  84  * and `address' properties of each device attached to the mainbus;
  85  * other drives may also use this information.  The mainbus itself
  86  * (which `is' the CPU, in some sense) gets just the node, with a
  87  * fake name ("mainbus").
  88  */
  89
  90 /* Device register space description */
  91 struct rom_reg {
  92         uint32_t        rr_iospace;     /* register space (obio, etc) */
  93         uint32_t        rr_paddr;       /* register physical address */
  94         uint32_t        rr_len;         /* register length */
  95 };
  96
  97 /* Interrupt information */
  98 struct rom_intr {
  99         uint32_t        int_pri;        /* priority (IPL) */
 100         uint32_t        int_vec;        /* vector (always 0?) */
 101 };
 102
 103 /* Address translation accross busses */
 104 struct rom_range {              /* Only used on v3 PROMs */
 105         uint32_t        cspace;         /* Client space */
 106         uint32_t        coffset;        /* Client offset */
 107         uint32_t        pspace;         /* Parent space */
 108         uint32_t        poffset;        /* Parent offset */
 109         uint32_t        size;           /* Size in bytes of this range */
 110 };
 111
 112 /* Attach arguments presented by mainbus_attach() */
 113 struct mainbus_attach_args {
 114         bus_space_tag_t ma_bustag;      /* parent bus tag */
 115         bus_dma_tag_t   ma_dmatag;
 116         const char      *ma_name;       /* PROM node name */
 117         int             ma_node;        /* PROM handle */
 118         bus_addr_t      ma_paddr;       /* register physical address */
 119         bus_size_t      ma_size;        /* register physical size */
 120         int             ma_pri;         /* priority (IPL) */
 121         void            *ma_promvaddr;  /* PROM virtual address, if any */
 122 };
 123
 124 /* Attach arguments presented to devices by obio_attach() (sun4 only) */
 125 struct obio4_attach_args {
 126         int             oba_placeholder;/* obio/sbus attach args sharing */
 127         bus_space_tag_t oba_bustag;     /* parent bus tag */
 128         bus_dma_tag_t   oba_dmatag;
 129         bus_addr_t      oba_paddr;      /* register physical address */
 130         int             oba_pri;        /* interrupt priority (IPL) */
 131 };
 132
 133 union obio_attach_args {
 134         /* sun4m obio space is treated like an sbus slot */
 135         int                             uoba_isobio4;
 136         struct sbus_attach_args         uoba_sbus;      /* Sbus view */
 137         struct obio4_attach_args        uoba_oba4;      /* sun4 on-board view */
 138 };
 139
 140 /* obio specific bus flag */
 141 #define OBIO_BUS_MAP_USE_ROM    BUS_SPACE_MAP_BUS1
 142
 143 /* obio bus helper that finds ROM mappings; exported for autoconf.c */
 144 int     obio_find_rom_map(bus_addr_t, int, bus_space_handle_t *);
 145
 146
 147 /*
 148  * The matchbyname function is useful in drivers that are matched
 149  * by romaux name, i.e., all `mainbus attached' devices.  It expects
 150  * its aux pointer to point to a pointer to the name (the address of
 151  * a romaux structure suffices, for instance). (OBSOLETE)
 152  */
 153 struct device;
 154 struct cfdata;
 155 int     matchbyname(struct device *, struct cfdata *cf, void *aux);
 156
 157 /*
 158  * `clockfreq' produces a printable representation of a clock frequency
 159  * (this is just a frill).
 160  */
 161 char    *clockfreq(int freq);
 162
 163 /* Openprom V2 style boot path */
 164 struct bootpath {
 165         char    name[16];       /* name of this node */
 166         int     val[3];         /* up to three optional values */
 167         struct device *dev;     /* device that recognised this component */
 168 };
 169
 170 /* Parse a disk string into a dev_t, return device struct pointer */
 171 struct  device *parsedisk(char *, int, int, dev_t *);
 172
 173 /* Establish a mountroot_hook, for benefit of floppy drive, mostly. */
 174 void    mountroot_hook_establish(void (*)(struct device *),
 175                                  struct device *);
 176
 177 void    bootstrap(void);
 178 int     romgetcursoraddr(int **, int **);