2 * Copyright 1998 Massachusetts Institute of Technology
3 * Copyright 2001 by Thomas Moestl <tmm@FreeBSD.org>.
4 * Copyright 2006 by Marius Strobl <marius@FreeBSD.org>.
7 * Permission to use, copy, modify, and distribute this software and
8 * its documentation for any purpose and without fee is hereby
9 * granted, provided that both the above copyright notice and this
10 * permission notice appear in all copies, that both the above
11 * copyright notice and this permission notice appear in all
12 * supporting documentation, and that the name of M.I.T. not be used
13 * in advertising or publicity pertaining to distribution of the
14 * software without specific, written prior permission. M.I.T. makes
15 * no representations about the suitability of this software for any
16 * purpose. It is provided "as is" without express or implied
19 * THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''. M.I.T. DISCLAIMS
20 * ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE,
21 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
22 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT
23 * SHALL M.I.T. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
26 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
27 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
28 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
29 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 * from: FreeBSD: src/sys/i386/i386/nexus.c,v 1.43 2001/02/09
35 #include <sys/cdefs.h>
36 __FBSDID("$FreeBSD$");
38 #include <sys/param.h>
39 #include <sys/systm.h>
41 #include <sys/kernel.h>
42 #include <sys/malloc.h>
43 #include <sys/module.h>
46 #include <dev/ofw/ofw_bus.h>
47 #include <dev/ofw/ofw_bus_subr.h>
48 #include <dev/ofw/openfirm.h>
50 #include <machine/bus.h>
51 #include <machine/bus_common.h>
52 #include <machine/intr_machdep.h>
53 #include <machine/nexusvar.h>
54 #include <machine/ofw_nexus.h>
55 #include <machine/resource.h>
56 #include <machine/ver.h>
61 * The nexus (which is a pseudo-bus actually) iterates over the nodes that
62 * hang from the Open Firmware root node and adds them as devices to this bus
63 * (except some special nodes which are excluded) so that drivers can be
66 * Additionally, interrupt setup/teardown and some resource management are
69 * Maybe this code should get into dev/ofw to some extent, as some of it should
70 * work for all Open Firmware based machines...
73 struct nexus_devinfo {
74 struct ofw_bus_devinfo ndi_obdinfo;
75 struct resource_list ndi_rl;
79 struct rman sc_intr_rman;
80 struct rman sc_mem_rman;
83 static device_probe_t nexus_probe;
84 static device_attach_t nexus_attach;
85 static bus_print_child_t nexus_print_child;
86 static bus_add_child_t nexus_add_child;
87 static bus_probe_nomatch_t nexus_probe_nomatch;
88 static bus_setup_intr_t nexus_setup_intr;
89 static bus_teardown_intr_t nexus_teardown_intr;
90 static bus_alloc_resource_t nexus_alloc_resource;
91 static bus_activate_resource_t nexus_activate_resource;
92 static bus_deactivate_resource_t nexus_deactivate_resource;
93 static bus_adjust_resource_t nexus_adjust_resource;
94 static bus_release_resource_t nexus_release_resource;
95 static bus_get_resource_list_t nexus_get_resource_list;
97 static bus_bind_intr_t nexus_bind_intr;
99 static bus_describe_intr_t nexus_describe_intr;
100 static bus_get_dma_tag_t nexus_get_dma_tag;
101 static bus_get_bus_tag_t nexus_get_bus_tag;
102 static ofw_bus_get_devinfo_t nexus_get_devinfo;
104 static int nexus_inlist(const char *, const char *const *);
105 static struct nexus_devinfo * nexus_setup_dinfo(device_t, phandle_t);
106 static void nexus_destroy_dinfo(struct nexus_devinfo *);
107 static int nexus_print_res(struct nexus_devinfo *);
109 static device_method_t nexus_methods[] = {
110 /* Device interface */
111 DEVMETHOD(device_probe, nexus_probe),
112 DEVMETHOD(device_attach, nexus_attach),
113 DEVMETHOD(device_detach, bus_generic_detach),
114 DEVMETHOD(device_shutdown, bus_generic_shutdown),
115 DEVMETHOD(device_suspend, bus_generic_suspend),
116 DEVMETHOD(device_resume, bus_generic_resume),
119 DEVMETHOD(bus_print_child, nexus_print_child),
120 DEVMETHOD(bus_probe_nomatch, nexus_probe_nomatch),
121 DEVMETHOD(bus_read_ivar, bus_generic_read_ivar),
122 DEVMETHOD(bus_write_ivar, bus_generic_write_ivar),
123 DEVMETHOD(bus_add_child, nexus_add_child),
124 DEVMETHOD(bus_alloc_resource, nexus_alloc_resource),
125 DEVMETHOD(bus_activate_resource, nexus_activate_resource),
126 DEVMETHOD(bus_deactivate_resource, nexus_deactivate_resource),
127 DEVMETHOD(bus_adjust_resource, nexus_adjust_resource),
128 DEVMETHOD(bus_release_resource, nexus_release_resource),
129 DEVMETHOD(bus_setup_intr, nexus_setup_intr),
130 DEVMETHOD(bus_teardown_intr, nexus_teardown_intr),
131 DEVMETHOD(bus_set_resource, bus_generic_rl_set_resource),
132 DEVMETHOD(bus_get_resource, bus_generic_rl_get_resource),
133 DEVMETHOD(bus_get_resource_list, nexus_get_resource_list),
135 DEVMETHOD(bus_bind_intr, nexus_bind_intr),
137 DEVMETHOD(bus_describe_intr, nexus_describe_intr),
138 DEVMETHOD(bus_get_dma_tag, nexus_get_dma_tag),
139 DEVMETHOD(bus_get_bus_tag, nexus_get_bus_tag),
141 /* ofw_bus interface */
142 DEVMETHOD(ofw_bus_get_devinfo, nexus_get_devinfo),
143 DEVMETHOD(ofw_bus_get_compat, ofw_bus_gen_get_compat),
144 DEVMETHOD(ofw_bus_get_model, ofw_bus_gen_get_model),
145 DEVMETHOD(ofw_bus_get_name, ofw_bus_gen_get_name),
146 DEVMETHOD(ofw_bus_get_node, ofw_bus_gen_get_node),
147 DEVMETHOD(ofw_bus_get_type, ofw_bus_gen_get_type),
152 static devclass_t nexus_devclass;
154 DEFINE_CLASS_0(nexus, nexus_driver, nexus_methods, sizeof(struct nexus_softc));
155 EARLY_DRIVER_MODULE(nexus, root, nexus_driver, nexus_devclass, 0, 0,
157 MODULE_VERSION(nexus, 1);
159 static const char *const nexus_excl_name[] = {
165 "counter-timer", /* No separate device; handled by psycho/sbus */
179 static const char *const nexus_excl_type[] = {
185 extern struct bus_space_tag nexus_bustag;
186 extern struct bus_dma_tag nexus_dmatag;
189 nexus_inlist(const char *name, const char *const *list)
195 for (i = 0; list[i] != NULL; i++)
196 if (strcmp(name, list[i]) == 0)
201 #define NEXUS_EXCLUDED(name, type) \
202 (nexus_inlist((name), nexus_excl_name) || \
203 ((type) != NULL && nexus_inlist((type), nexus_excl_type)))
206 nexus_probe(device_t dev)
209 /* Nexus does always match. */
210 device_set_desc(dev, "Open Firmware Nexus device");
215 nexus_attach(device_t dev)
217 struct nexus_devinfo *ndi;
218 struct nexus_softc *sc;
222 if (strcmp(device_get_name(device_get_parent(dev)), "root") == 0) {
225 panic("%s: OF_peer failed.", __func__);
227 sc = device_get_softc(dev);
228 sc->sc_intr_rman.rm_type = RMAN_ARRAY;
229 sc->sc_intr_rman.rm_descr = "Interrupts";
230 sc->sc_mem_rman.rm_type = RMAN_ARRAY;
231 sc->sc_mem_rman.rm_descr = "Device Memory";
232 if (rman_init(&sc->sc_intr_rman) != 0 ||
233 rman_init(&sc->sc_mem_rman) != 0 ||
234 rman_manage_region(&sc->sc_intr_rman, 0,
236 rman_manage_region(&sc->sc_mem_rman, 0, BUS_SPACE_MAXADDR) != 0)
237 panic("%s: failed to set up rmans.", __func__);
239 node = ofw_bus_get_node(dev);
242 * Allow devices to identify.
244 bus_generic_probe(dev);
247 * Now walk the OFW tree and attach top-level devices.
249 for (node = OF_child(node); node > 0; node = OF_peer(node)) {
250 if ((ndi = nexus_setup_dinfo(dev, node)) == NULL)
252 cdev = device_add_child(dev, NULL, -1);
254 device_printf(dev, "<%s>: device_add_child failed\n",
255 ndi->ndi_obdinfo.obd_name);
256 nexus_destroy_dinfo(ndi);
259 device_set_ivars(cdev, ndi);
261 return (bus_generic_attach(dev));
265 nexus_add_child(device_t dev, u_int order, const char *name, int unit)
268 struct nexus_devinfo *ndi;
270 cdev = device_add_child_ordered(dev, order, name, unit);
274 ndi = malloc(sizeof(*ndi), M_DEVBUF, M_WAITOK | M_ZERO);
275 ndi->ndi_obdinfo.obd_node = -1;
276 ndi->ndi_obdinfo.obd_name = strdup(name, M_OFWPROP);
277 resource_list_init(&ndi->ndi_rl);
278 device_set_ivars(cdev, ndi);
284 nexus_print_child(device_t bus, device_t child)
288 rv = bus_print_child_header(bus, child);
289 rv += nexus_print_res(device_get_ivars(child));
290 rv += bus_print_child_footer(bus, child);
295 nexus_probe_nomatch(device_t bus, device_t child)
299 device_printf(bus, "<%s>", ofw_bus_get_name(child));
300 nexus_print_res(device_get_ivars(child));
301 type = ofw_bus_get_type(child);
302 printf(" type %s (no driver attached)\n",
303 type != NULL ? type : "unknown");
307 nexus_setup_intr(device_t bus __unused, device_t child, struct resource *r,
308 int flags, driver_filter_t *filt, driver_intr_t *intr, void *arg,
314 panic("%s: NULL interrupt resource!", __func__);
316 if ((rman_get_flags(r) & RF_SHAREABLE) == 0)
319 /* We depend here on rman_activate_resource() being idempotent. */
320 error = rman_activate_resource(r);
324 error = inthand_add(device_get_nameunit(child), rman_get_start(r),
325 filt, intr, arg, flags, cookiep);
328 * XXX in case of the AFB/FFB interrupt and a Psycho, Sabre or U2S
329 * bridge enable the interrupt in the respective bridge.
336 nexus_teardown_intr(device_t bus __unused, device_t child __unused,
337 struct resource *r, void *ih)
340 inthand_remove(rman_get_start(r), ih);
346 nexus_bind_intr(device_t bus __unused, device_t child __unused,
347 struct resource *r, int cpu)
350 return (intr_bind(rman_get_start(r), cpu));
355 nexus_describe_intr(device_t bus __unused, device_t child __unused,
356 struct resource *r, void *cookie, const char *descr)
359 return (intr_describe(rman_get_start(r), cookie, descr));
362 static struct resource *
363 nexus_alloc_resource(device_t bus, device_t child, int type, int *rid,
364 rman_res_t start, rman_res_t end, rman_res_t count, u_int flags)
366 struct nexus_softc *sc;
369 struct resource_list_entry *rle;
371 int isdefault, passthrough;
373 isdefault = RMAN_IS_DEFAULT_RANGE(start, end);
374 passthrough = (device_get_parent(child) != bus);
376 while (strcmp(device_get_name(device_get_parent(nexus)), "root") != 0)
377 nexus = device_get_parent(nexus);
378 sc = device_get_softc(nexus);
382 rle = resource_list_find(BUS_GET_RESOURCE_LIST(bus, child),
386 if (rle->res != NULL)
387 panic("%s: resource entry is busy", __func__);
390 count = ulmax(count, rle->count);
391 end = ulmax(rle->end, start + count - 1);
397 rm = &sc->sc_intr_rman;
400 rm = &sc->sc_mem_rman;
406 rv = rman_reserve_resource(rm, start, end, count, flags & ~RF_ACTIVE,
410 rman_set_rid(rv, *rid);
412 if ((flags & RF_ACTIVE) != 0 && bus_activate_resource(child, type,
414 rman_release_resource(rv);
420 rle->start = rman_get_start(rv);
421 rle->end = rman_get_end(rv);
422 rle->count = rle->end - rle->start + 1;
429 nexus_activate_resource(device_t bus __unused, device_t child __unused,
430 int type, int rid __unused, struct resource *r)
433 if (type == SYS_RES_MEMORY) {
434 rman_set_bustag(r, &nexus_bustag);
435 rman_set_bushandle(r, rman_get_start(r));
437 return (rman_activate_resource(r));
441 nexus_deactivate_resource(device_t bus __unused, device_t child __unused,
442 int type __unused, int rid __unused, struct resource *r)
445 return (rman_deactivate_resource(r));
449 nexus_adjust_resource(device_t bus, device_t child __unused, int type,
450 struct resource *r, rman_res_t start, rman_res_t end)
452 struct nexus_softc *sc;
457 while (strcmp(device_get_name(device_get_parent(nexus)), "root") != 0)
458 nexus = device_get_parent(nexus);
459 sc = device_get_softc(nexus);
462 rm = &sc->sc_intr_rman;
465 rm = &sc->sc_mem_rman;
472 if (rman_is_region_manager(r, rm) == 0)
474 return (rman_adjust_resource(r, start, end));
478 nexus_release_resource(device_t bus __unused, device_t child, int type,
479 int rid, struct resource *r)
483 if ((rman_get_flags(r) & RF_ACTIVE) != 0) {
484 error = bus_deactivate_resource(child, type, rid, r);
488 return (rman_release_resource(r));
491 static struct resource_list *
492 nexus_get_resource_list(device_t bus __unused, device_t child)
494 struct nexus_devinfo *ndi;
496 ndi = device_get_ivars(child);
497 return (&ndi->ndi_rl);
501 nexus_get_dma_tag(device_t bus __unused, device_t child __unused)
504 return (&nexus_dmatag);
507 static bus_space_tag_t
508 nexus_get_bus_tag(device_t bus __unused, device_t child __unused)
511 return (&nexus_bustag);
514 static const struct ofw_bus_devinfo *
515 nexus_get_devinfo(device_t bus __unused, device_t child)
517 struct nexus_devinfo *ndi;
519 ndi = device_get_ivars(child);
520 return (&ndi->ndi_obdinfo);
523 static struct nexus_devinfo *
524 nexus_setup_dinfo(device_t dev, phandle_t node)
526 struct nexus_devinfo *ndi;
527 struct nexus_regs *reg;
536 ndi = malloc(sizeof(*ndi), M_DEVBUF, M_WAITOK | M_ZERO);
537 if (ofw_bus_gen_setup_devinfo(&ndi->ndi_obdinfo, node) != 0) {
541 if (NEXUS_EXCLUDED(ndi->ndi_obdinfo.obd_name,
542 ndi->ndi_obdinfo.obd_type)) {
543 ofw_bus_gen_destroy_devinfo(&ndi->ndi_obdinfo);
547 resource_list_init(&ndi->ndi_rl);
548 nreg = OF_getprop_alloc_multi(node, "reg", sizeof(*reg), (void **)®);
550 device_printf(dev, "<%s>: incomplete\n",
551 ndi->ndi_obdinfo.obd_name);
554 for (i = 0; i < nreg; i++) {
555 phys = NEXUS_REG_PHYS(®[i]);
556 size = NEXUS_REG_SIZE(®[i]);
557 /* Skip the dummy reg property of glue devices like ssm(4). */
559 resource_list_add(&ndi->ndi_rl, SYS_RES_MEMORY, i,
560 phys, phys + size - 1, size);
564 nintr = OF_getprop_alloc_multi(node, "interrupts", sizeof(*intr),
567 if (OF_getprop(node, PCPU_GET(impl) < CPU_IMPL_ULTRASPARCIII ?
568 "upa-portid" : "portid", &ign, sizeof(ign)) <= 0) {
569 device_printf(dev, "<%s>: could not determine portid\n",
570 ndi->ndi_obdinfo.obd_name);
575 /* XXX 7-bit MID on Starfire */
576 ign = (ign << INTMAP_IGN_SHIFT) & INTMAP_IGN_MASK;
577 for (i = 0; i < nintr; i++) {
579 resource_list_add(&ndi->ndi_rl, SYS_RES_IRQ, i, intr[i],
588 nexus_destroy_dinfo(ndi);
593 nexus_destroy_dinfo(struct nexus_devinfo *ndi)
596 resource_list_free(&ndi->ndi_rl);
597 ofw_bus_gen_destroy_devinfo(&ndi->ndi_obdinfo);
602 nexus_print_res(struct nexus_devinfo *ndi)
607 rv += resource_list_print_type(&ndi->ndi_rl, "mem", SYS_RES_MEMORY,
609 rv += resource_list_print_type(&ndi->ndi_rl, "irq", SYS_RES_IRQ,