xref: /freebsd/sys/dev/spibus/ofw_spibus.c (revision 5bf5ca772c6de2d53344a78cf461447cc322ccea)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3  *
4  * Copyright (c) 2009, Nathan Whitehorn <nwhitehorn@FreeBSD.org>
5  * Copyright (c) 2013 The FreeBSD Foundation
6  * All rights reserved.
7  *
8  * Portions of this software were developed by Oleksandr Rybalko
9  * under sponsorship from the FreeBSD Foundation.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice unmodified, this list of conditions, and the following
16  *    disclaimer.
17  * 2. Redistributions in binary form must reproduce the above copyright
18  *    notice, this list of conditions and the following disclaimer in the
19  *    documentation and/or other materials provided with the distribution.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 #include <sys/cdefs.h>
34 __FBSDID("$FreeBSD$");
35 
36 #include <sys/param.h>
37 #include <sys/bus.h>
38 #include <sys/kernel.h>
39 #include <sys/libkern.h>
40 #include <sys/lock.h>
41 #include <sys/module.h>
42 #include <sys/mutex.h>
43 
44 #include <dev/fdt/fdt_common.h>
45 #include <dev/spibus/spi.h>
46 #include <dev/spibus/spibusvar.h>
47 #include <dev/ofw/ofw_bus.h>
48 #include <dev/ofw/ofw_bus_subr.h>
49 #include <dev/ofw/openfirm.h>
50 
51 #include "spibus_if.h"
52 
53 struct ofw_spibus_devinfo {
54 	struct spibus_ivar	opd_dinfo;
55 	struct ofw_bus_devinfo	opd_obdinfo;
56 };
57 
58 /* Methods */
59 static device_probe_t ofw_spibus_probe;
60 static device_attach_t ofw_spibus_attach;
61 static device_t ofw_spibus_add_child(device_t dev, u_int order,
62     const char *name, int unit);
63 static const struct ofw_bus_devinfo *ofw_spibus_get_devinfo(device_t bus,
64     device_t dev);
65 
66 static int
67 ofw_spibus_probe(device_t dev)
68 {
69 
70 	if (ofw_bus_get_node(dev) == -1)
71 		return (ENXIO);
72 	device_set_desc(dev, "OFW SPI bus");
73 
74 	return (0);
75 }
76 
77 static int
78 ofw_spibus_attach(device_t dev)
79 {
80 	struct spibus_softc *sc = device_get_softc(dev);
81 	struct ofw_spibus_devinfo *dinfo;
82 	phandle_t child;
83 	pcell_t clock, paddr;
84 	device_t childdev;
85 	uint32_t mode = SPIBUS_MODE_NONE;
86 
87 	sc->dev = dev;
88 
89 	bus_generic_probe(dev);
90 	bus_enumerate_hinted_children(dev);
91 
92 	/*
93 	 * Attach those children represented in the device tree.
94 	 */
95 	for (child = OF_child(ofw_bus_get_node(dev)); child != 0;
96 	    child = OF_peer(child)) {
97 		/*
98 		 * Try to get the CS number first from the spi-chipselect
99 		 * property, then try the reg property.
100 		 */
101 		if (OF_getencprop(child, "spi-chipselect", &paddr,
102 		    sizeof(paddr)) == -1) {
103 			if (OF_getencprop(child, "reg", &paddr,
104 			    sizeof(paddr)) == -1)
105 				continue;
106 		}
107 
108 		/*
109 		 * Try to get the cpol/cpha mode
110 		 */
111 		if (OF_hasprop(child, "spi-cpol"))
112 			mode = SPIBUS_MODE_CPOL;
113 		if (OF_hasprop(child, "spi-cpha")) {
114 			if (mode == SPIBUS_MODE_CPOL)
115 				mode = SPIBUS_MODE_CPOL_CPHA;
116 			else
117 				mode = SPIBUS_MODE_CPHA;
118 		}
119 
120 		/*
121 		 * Try to get the CS polarity
122 		 */
123 		if (OF_hasprop(child, "spi-cs-high"))
124 			paddr |= SPIBUS_CS_HIGH;
125 
126 		/*
127 		 * Get the maximum clock frequency for device, zero means
128 		 * use the default bus speed.
129 		 */
130 		if (OF_getencprop(child, "spi-max-frequency", &clock,
131 		    sizeof(clock)) == -1)
132 			clock = 0;
133 
134 		/*
135 		 * Now set up the SPI and OFW bus layer devinfo and add it
136 		 * to the bus.
137 		 */
138 		dinfo = malloc(sizeof(struct ofw_spibus_devinfo), M_DEVBUF,
139 		    M_NOWAIT | M_ZERO);
140 		if (dinfo == NULL)
141 			continue;
142 		dinfo->opd_dinfo.cs = paddr;
143 		dinfo->opd_dinfo.clock = clock;
144 		dinfo->opd_dinfo.mode = mode;
145 		if (ofw_bus_gen_setup_devinfo(&dinfo->opd_obdinfo, child) !=
146 		    0) {
147 			free(dinfo, M_DEVBUF);
148 			continue;
149 		}
150 		childdev = device_add_child(dev, NULL, -1);
151 		device_set_ivars(childdev, dinfo);
152 	}
153 
154 	return (bus_generic_attach(dev));
155 }
156 
157 static device_t
158 ofw_spibus_add_child(device_t dev, u_int order, const char *name, int unit)
159 {
160 	device_t child;
161 	struct ofw_spibus_devinfo *devi;
162 
163 	child = device_add_child_ordered(dev, order, name, unit);
164 	if (child == NULL)
165 		return (child);
166 	devi = malloc(sizeof(struct ofw_spibus_devinfo), M_DEVBUF,
167 	    M_NOWAIT | M_ZERO);
168 	if (devi == NULL) {
169 		device_delete_child(dev, child);
170 		return (0);
171 	}
172 
173 	/*
174 	 * NULL all the OFW-related parts of the ivars for non-OFW
175 	 * children.
176 	 */
177 	devi->opd_obdinfo.obd_node = -1;
178 	devi->opd_obdinfo.obd_name = NULL;
179 	devi->opd_obdinfo.obd_compat = NULL;
180 	devi->opd_obdinfo.obd_type = NULL;
181 	devi->opd_obdinfo.obd_model = NULL;
182 
183 	device_set_ivars(child, devi);
184 
185 	return (child);
186 }
187 
188 static const struct ofw_bus_devinfo *
189 ofw_spibus_get_devinfo(device_t bus, device_t dev)
190 {
191 	struct ofw_spibus_devinfo *dinfo;
192 
193 	dinfo = device_get_ivars(dev);
194 	return (&dinfo->opd_obdinfo);
195 }
196 
197 static device_method_t ofw_spibus_methods[] = {
198 	/* Device interface */
199 	DEVMETHOD(device_probe,		ofw_spibus_probe),
200 	DEVMETHOD(device_attach,	ofw_spibus_attach),
201 
202 	/* Bus interface */
203 	DEVMETHOD(bus_child_pnpinfo_str, ofw_bus_gen_child_pnpinfo_str),
204 	DEVMETHOD(bus_add_child,	ofw_spibus_add_child),
205 
206 	/* ofw_bus interface */
207 	DEVMETHOD(ofw_bus_get_devinfo,	ofw_spibus_get_devinfo),
208 	DEVMETHOD(ofw_bus_get_compat,	ofw_bus_gen_get_compat),
209 	DEVMETHOD(ofw_bus_get_model,	ofw_bus_gen_get_model),
210 	DEVMETHOD(ofw_bus_get_name,	ofw_bus_gen_get_name),
211 	DEVMETHOD(ofw_bus_get_node,	ofw_bus_gen_get_node),
212 	DEVMETHOD(ofw_bus_get_type,	ofw_bus_gen_get_type),
213 
214 	DEVMETHOD_END
215 };
216 
217 devclass_t ofw_spibus_devclass;
218 
219 DEFINE_CLASS_1(spibus, ofw_spibus_driver, ofw_spibus_methods,
220     sizeof(struct spibus_softc), spibus_driver);
221 DRIVER_MODULE(ofw_spibus, spi, ofw_spibus_driver, ofw_spibus_devclass, 0, 0);
222 MODULE_VERSION(ofw_spibus, 1);
223 MODULE_DEPEND(ofw_spibus, spibus, 1, 1, 1);
224