xref: /freebsd/sys/dev/ofw/ofw_firmware.c (revision 7ef62cebc2f965b0f640263e179276928885e33d)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3  *
4  * Copyright (c) 2022 Beckhoff Automation GmbH & Co. KG
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25  * SUCH DAMAGE.
26  */
27 
28 #include <sys/cdefs.h>
29 
30 #include <sys/param.h>
31 #include <sys/systm.h>
32 #include <sys/kernel.h>
33 #include <sys/module.h>
34 #include <sys/malloc.h>
35 #include <sys/bus.h>
36 #include <sys/cpu.h>
37 #include <machine/bus.h>
38 
39 #include <dev/fdt/simplebus.h>
40 
41 #include <dev/ofw/openfirm.h>
42 #include <dev/ofw/ofw_bus.h>
43 #include <dev/ofw/ofw_bus_subr.h>
44 
45 struct ofw_firmware_softc {
46 	struct simplebus_softc	sc;
47 	device_t		dev;
48 };
49 
50 static struct simplebus_devinfo *
51 ofw_firmware_setup_dinfo(device_t dev, phandle_t node,
52     struct simplebus_devinfo *di)
53 {
54 	struct simplebus_softc *sc;
55 	struct simplebus_devinfo *ndi;
56 
57 	sc = device_get_softc(dev);
58 	if (di == NULL)
59 		ndi = malloc(sizeof(*ndi), M_DEVBUF, M_WAITOK | M_ZERO);
60 	else
61 		ndi = di;
62 	if (ofw_bus_gen_setup_devinfo(&ndi->obdinfo, node) != 0) {
63 		if (di == NULL)
64 			free(ndi, M_DEVBUF);
65 		return (NULL);
66 	}
67 
68 	/* reg resources is from the parent but interrupts is on the node itself */
69 	resource_list_init(&ndi->rl);
70 	ofw_bus_reg_to_rl(dev, OF_parent(node), sc->acells, sc->scells, &ndi->rl);
71 	ofw_bus_intr_to_rl(dev, node, &ndi->rl, NULL);
72 
73 	return (ndi);
74 }
75 
76 static device_t
77 ofw_firmware_add_device(device_t dev, phandle_t node, u_int order,
78     const char *name, int unit, struct simplebus_devinfo *di)
79 {
80 	struct simplebus_devinfo *ndi;
81 	device_t cdev;
82 
83 	if ((ndi = ofw_firmware_setup_dinfo(dev, node, di)) == NULL)
84 		return (NULL);
85 	cdev = device_add_child_ordered(dev, order, name, unit);
86 	if (cdev == NULL) {
87 		device_printf(dev, "<%s>: device_add_child failed\n",
88 		    ndi->obdinfo.obd_name);
89 		resource_list_free(&ndi->rl);
90 		ofw_bus_gen_destroy_devinfo(&ndi->obdinfo);
91 		if (di == NULL)
92 			free(ndi, M_DEVBUF);
93 		return (NULL);
94 	}
95 	device_set_ivars(cdev, ndi);
96 
97 	return(cdev);
98 }
99 
100 static int
101 ofw_firmware_probe(device_t dev)
102 {
103 	const char *name;
104 
105 	name = ofw_bus_get_name(dev);
106 	if (name == NULL || strcmp(name, "firmware") != 0)
107 		return (ENXIO);
108 
109 	device_set_desc(dev, "OFW Firmware Group");
110 	return (0);
111 }
112 
113 static int
114 ofw_firmware_attach(device_t dev)
115 {
116 	struct ofw_firmware_softc *sc;
117 	phandle_t node, child;
118 	device_t cdev;
119 
120 	sc = device_get_softc(dev);
121 	sc->dev = dev;
122 	node = ofw_bus_get_node(dev);
123 
124 	if (OF_getencprop(node, "#address-cells", &sc->sc.acells,
125 	    sizeof(sc->sc.acells)) == -1) {
126 		if (OF_getencprop(OF_parent(node), "#address-cells", &sc->sc.acells,
127 		    sizeof(sc->sc.acells)) == -1) {
128 			sc->sc.acells = 2;
129 		}
130 	}
131 	if (OF_getencprop(node, "#size-cells", &sc->sc.scells,
132 	    sizeof(sc->sc.scells)) == -1) {
133 		if (OF_getencprop(OF_parent(node), "#size-cells", &sc->sc.scells,
134 		    sizeof(sc->sc.scells)) == -1) {
135 			sc->sc.scells = 1;
136 		}
137 	}
138 
139 	for (child = OF_child(node); child != 0; child = OF_peer(child)) {
140 		cdev = ofw_firmware_add_device(dev, child, 0, NULL, -1, NULL);
141 		if (cdev != NULL)
142 			device_probe_and_attach(cdev);
143 	}
144 
145 	return (bus_generic_attach(dev));
146 }
147 
148 static device_method_t ofw_firmware_methods[] = {
149 	/* device_if */
150 	DEVMETHOD(device_probe, 	ofw_firmware_probe),
151 	DEVMETHOD(device_attach, 	ofw_firmware_attach),
152 
153 	DEVMETHOD_END
154 };
155 
156 DEFINE_CLASS_1(ofw_firmware, ofw_firmware_driver, ofw_firmware_methods,
157   sizeof(struct ofw_firmware_softc), simplebus_driver);
158 
159 EARLY_DRIVER_MODULE(ofw_firmware, simplebus, ofw_firmware_driver, 0, 0,
160     BUS_PASS_BUS + BUS_PASS_ORDER_MIDDLE);
161 MODULE_VERSION(ofw_firmware, 1);
162