xref: /freebsd/sys/dev/gem/if_gem_pci.c (revision aa0a1e58)
1 /*-
2  * Copyright (C) 2001 Eduardo Horvath.
3  * Copyright (c) 2007 Marius Strobl <marius@FreeBSD.org>
4  * All rights reserved.
5  *
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR  ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR  BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  *
28  *	from: NetBSD: if_gem_pci.c,v 1.7 2001/10/18 15:09:15 thorpej Exp
29  */
30 
31 #include <sys/cdefs.h>
32 __FBSDID("$FreeBSD$");
33 
34 /*
35  * PCI bindings for Apple GMAC, Sun ERI and Sun GEM Ethernet controllers
36  */
37 
38 #include <sys/param.h>
39 #include <sys/systm.h>
40 #include <sys/bus.h>
41 #include <sys/kernel.h>
42 #include <sys/lock.h>
43 #include <sys/malloc.h>
44 #include <sys/module.h>
45 #include <sys/mutex.h>
46 #include <sys/resource.h>
47 #include <sys/rman.h>
48 #include <sys/socket.h>
49 
50 #include <net/ethernet.h>
51 #include <net/if.h>
52 
53 #include <machine/bus.h>
54 #if defined(__powerpc__) || defined(__sparc64__)
55 #include <dev/ofw/ofw_bus.h>
56 #include <dev/ofw/openfirm.h>
57 #include <machine/ofw_machdep.h>
58 #endif
59 #include <machine/resource.h>
60 
61 #include <dev/gem/if_gemreg.h>
62 #include <dev/gem/if_gemvar.h>
63 
64 #include <dev/pci/pcireg.h>
65 #include <dev/pci/pcivar.h>
66 
67 #include "miibus_if.h"
68 
69 static int	gem_pci_attach(device_t dev);
70 static int	gem_pci_detach(device_t dev);
71 static int	gem_pci_probe(device_t dev);
72 static int	gem_pci_resume(device_t dev);
73 static int	gem_pci_suspend(device_t dev);
74 
75 static device_method_t gem_pci_methods[] = {
76 	/* Device interface */
77 	DEVMETHOD(device_probe,		gem_pci_probe),
78 	DEVMETHOD(device_attach,	gem_pci_attach),
79 	DEVMETHOD(device_detach,	gem_pci_detach),
80 	DEVMETHOD(device_suspend,	gem_pci_suspend),
81 	DEVMETHOD(device_resume,	gem_pci_resume),
82 	/* Use the suspend handler here, it is all that is required. */
83 	DEVMETHOD(device_shutdown,	gem_pci_suspend),
84 
85 	/* bus interface */
86 	DEVMETHOD(bus_print_child,	bus_generic_print_child),
87 	DEVMETHOD(bus_driver_added,	bus_generic_driver_added),
88 
89 	/* MII interface */
90 	DEVMETHOD(miibus_readreg,	gem_mii_readreg),
91 	DEVMETHOD(miibus_writereg,	gem_mii_writereg),
92 	DEVMETHOD(miibus_statchg,	gem_mii_statchg),
93 
94 	KOBJMETHOD_END
95 };
96 
97 static driver_t gem_pci_driver = {
98 	"gem",
99 	gem_pci_methods,
100 	sizeof(struct gem_softc)
101 };
102 
103 DRIVER_MODULE(gem, pci, gem_pci_driver, gem_devclass, 0, 0);
104 MODULE_DEPEND(gem, pci, 1, 1, 1);
105 MODULE_DEPEND(gem, ether, 1, 1, 1);
106 
107 static const struct gem_pci_dev {
108 	uint32_t	gpd_devid;
109 	int		gpd_variant;
110 	const char	*gpd_desc;
111 } const gem_pci_devlist[] = {
112 	{ 0x1101108e, GEM_SUN_ERI,	"Sun ERI 10/100 Ethernet" },
113 	{ 0x2bad108e, GEM_SUN_GEM,	"Sun GEM Gigabit Ethernet" },
114 	{ 0x0021106b, GEM_APPLE_GMAC,	"Apple UniNorth GMAC Ethernet" },
115 	{ 0x0024106b, GEM_APPLE_GMAC,	"Apple Pangea GMAC Ethernet" },
116 	{ 0x0032106b, GEM_APPLE_GMAC,	"Apple UniNorth2 GMAC Ethernet" },
117 	{ 0x004c106b, GEM_APPLE_K2_GMAC,"Apple K2 GMAC Ethernet" },
118 	{ 0x0051106b, GEM_APPLE_GMAC,	"Apple Shasta GMAC Ethernet" },
119 	{ 0x006b106b, GEM_APPLE_GMAC,	"Apple Intrepid 2 GMAC Ethernet" },
120 	{ 0, 0, NULL }
121 };
122 
123 static int
124 gem_pci_probe(device_t dev)
125 {
126 	int i;
127 
128 	for (i = 0; gem_pci_devlist[i].gpd_desc != NULL; i++) {
129 		if (pci_get_devid(dev) == gem_pci_devlist[i].gpd_devid) {
130 			device_set_desc(dev, gem_pci_devlist[i].gpd_desc);
131 			return (BUS_PROBE_DEFAULT);
132 		}
133 	}
134 
135 	return (ENXIO);
136 }
137 
138 static struct resource_spec gem_pci_res_spec[] = {
139 	{ SYS_RES_IRQ, 0, RF_SHAREABLE | RF_ACTIVE },	/* GEM_RES_INTR */
140 	{ SYS_RES_MEMORY, PCIR_BAR(0), RF_ACTIVE },	/* GEM_RES_BANK1 */
141 	{ -1, 0 }
142 };
143 
144 #define	GEM_SHARED_PINS		"shared-pins"
145 #define	GEM_SHARED_PINS_SERDES	"serdes"
146 
147 static int
148 gem_pci_attach(device_t dev)
149 {
150 	struct gem_softc *sc;
151 	int i;
152 #if defined(__powerpc__) || defined(__sparc64__)
153 	char buf[sizeof(GEM_SHARED_PINS)];
154 #else
155 	int j;
156 #endif
157 
158 	sc = device_get_softc(dev);
159 	sc->sc_variant = GEM_UNKNOWN;
160 	for (i = 0; gem_pci_devlist[i].gpd_desc != NULL; i++) {
161 		if (pci_get_devid(dev) == gem_pci_devlist[i].gpd_devid) {
162 			sc->sc_variant = gem_pci_devlist[i].gpd_variant;
163 			break;
164 		}
165 	}
166 	if (sc->sc_variant == GEM_UNKNOWN) {
167 		device_printf(dev, "unknown adaptor\n");
168 		return (ENXIO);
169 	}
170 
171 	pci_enable_busmaster(dev);
172 
173 	/*
174 	 * Some Sun GEMs/ERIs do have their intpin register bogusly set to 0,
175 	 * although it should be 1.  Correct that.
176 	 */
177 	if (pci_get_intpin(dev) == 0)
178 		pci_set_intpin(dev, 1);
179 
180 	sc->sc_dev = dev;
181 	sc->sc_flags |= GEM_PCI;
182 
183 	if (bus_alloc_resources(dev, gem_pci_res_spec, sc->sc_res)) {
184 		device_printf(dev, "failed to allocate resources\n");
185 		bus_release_resources(dev, gem_pci_res_spec, sc->sc_res);
186 		return (ENXIO);
187 	}
188 
189 	GEM_LOCK_INIT(sc, device_get_nameunit(dev));
190 
191 	/*
192 	 * Derive GEM_RES_BANK2 from GEM_RES_BANK1.  This seemed cleaner
193 	 * with the old way of using copies of the bus tag and handle in
194 	 * the softc along with bus_space_*()...
195 	 */
196 	sc->sc_res[GEM_RES_BANK2] = malloc(sizeof(*sc->sc_res[GEM_RES_BANK2]),
197 	    M_DEVBUF, M_NOWAIT | M_ZERO);
198 	if (sc->sc_res[GEM_RES_BANK2] == NULL) {
199 		device_printf(dev, "failed to allocate bank2 resource\n");
200 		goto fail;
201 	}
202 	rman_set_bustag(sc->sc_res[GEM_RES_BANK2],
203 	    rman_get_bustag(sc->sc_res[GEM_RES_BANK1]));
204 	bus_space_subregion(rman_get_bustag(sc->sc_res[GEM_RES_BANK1]),
205 	    rman_get_bushandle(sc->sc_res[GEM_RES_BANK1]),
206 	    GEM_PCI_BANK2_OFFSET, GEM_PCI_BANK2_SIZE,
207 	    &sc->sc_res[GEM_RES_BANK2]->r_bushandle);
208 
209 	/* Determine whether we're running at 66MHz. */
210 	if ((GEM_BANK2_READ_4(sc, GEM_PCI_BIF_CONFIG) &
211 	   GEM_PCI_BIF_CNF_M66EN) != 0)
212 		sc->sc_flags |= GEM_PCI66;
213 
214 #if defined(__powerpc__) || defined(__sparc64__)
215 	OF_getetheraddr(dev, sc->sc_enaddr);
216 	if (OF_getprop(ofw_bus_get_node(dev), GEM_SHARED_PINS, buf,
217 	    sizeof(buf)) > 0) {
218 		buf[sizeof(buf) - 1] = '\0';
219 		if (strcmp(buf, GEM_SHARED_PINS_SERDES) == 0)
220 			sc->sc_flags |= GEM_SERDES;
221 	}
222 #else
223 	/*
224 	 * Dig out VPD (vital product data) and read NA (network address).
225 	 * The VPD resides in the PCI Expansion ROM (PCI FCode) and can't
226 	 * be accessed via the PCI capability pointer.
227 	 * ``Writing FCode 3.x Programs'' (newer ones, dated 1997 and later)
228 	 * chapter 2 describes the data structure.
229 	 */
230 
231 #define	PCI_ROMHDR_SIZE			0x1c
232 #define	PCI_ROMHDR_SIG			0x00
233 #define	PCI_ROMHDR_SIG_MAGIC		0xaa55		/* little endian */
234 #define	PCI_ROMHDR_PTR_DATA		0x18
235 #define	PCI_ROM_SIZE			0x18
236 #define	PCI_ROM_SIG			0x00
237 #define	PCI_ROM_SIG_MAGIC		0x52494350	/* "PCIR", endian */
238 							/* reversed */
239 #define	PCI_ROM_VENDOR			0x04
240 #define	PCI_ROM_DEVICE			0x06
241 #define	PCI_ROM_PTR_VPD			0x08
242 #define	PCI_VPDRES_BYTE0		0x00
243 #define	PCI_VPDRES_ISLARGE(x)		((x) & 0x80)
244 #define	PCI_VPDRES_LARGE_NAME(x)	((x) & 0x7f)
245 #define	PCI_VPDRES_LARGE_LEN_LSB	0x01
246 #define	PCI_VPDRES_LARGE_LEN_MSB	0x02
247 #define	PCI_VPDRES_LARGE_SIZE		0x03
248 #define	PCI_VPDRES_TYPE_VPD		0x10		/* large */
249 #define	PCI_VPD_KEY0			0x00
250 #define	PCI_VPD_KEY1			0x01
251 #define	PCI_VPD_LEN			0x02
252 #define	PCI_VPD_SIZE			0x03
253 
254 #define	GEM_ROM_READ_1(sc, offs)					\
255 	GEM_BANK1_READ_1((sc), GEM_PCI_ROM_OFFSET + (offs))
256 #define	GEM_ROM_READ_2(sc, offs)					\
257 	GEM_BANK1_READ_2((sc), GEM_PCI_ROM_OFFSET + (offs))
258 #define	GEM_ROM_READ_4(sc, offs)					\
259 	GEM_BANK1_READ_4((sc), GEM_PCI_ROM_OFFSET + (offs))
260 
261 	/* Read PCI Expansion ROM header. */
262 	if (GEM_ROM_READ_2(sc, PCI_ROMHDR_SIG) != PCI_ROMHDR_SIG_MAGIC ||
263 	    (i = GEM_ROM_READ_2(sc, PCI_ROMHDR_PTR_DATA)) <
264 	    PCI_ROMHDR_SIZE) {
265 		device_printf(dev, "unexpected PCI Expansion ROM header\n");
266 		goto fail;
267 	}
268 
269 	/* Read PCI Expansion ROM data. */
270 	if (GEM_ROM_READ_4(sc, i + PCI_ROM_SIG) != PCI_ROM_SIG_MAGIC ||
271 	    GEM_ROM_READ_2(sc, i + PCI_ROM_VENDOR) != pci_get_vendor(dev) ||
272 	    GEM_ROM_READ_2(sc, i + PCI_ROM_DEVICE) != pci_get_device(dev) ||
273 	    (j = GEM_ROM_READ_2(sc, i + PCI_ROM_PTR_VPD)) <
274 	    i + PCI_ROM_SIZE) {
275 		device_printf(dev, "unexpected PCI Expansion ROM data\n");
276 		goto fail;
277 	}
278 
279 	/*
280 	 * Read PCI VPD.
281 	 * SUNW,pci-gem cards have a single large resource VPD-R tag
282 	 * containing one NA.  The VPD used is not in PCI 2.2 standard
283 	 * format however.  The length in the resource header is in big
284 	 * endian and the end tag is non-standard (0x79) and followed
285 	 * by an all-zero "checksum" byte.  Sun calls this a "Fresh
286 	 * Choice Ethernet" VPD...
287 	 */
288 	if (PCI_VPDRES_ISLARGE(GEM_ROM_READ_1(sc,
289 	    j + PCI_VPDRES_BYTE0)) == 0 ||
290 	    PCI_VPDRES_LARGE_NAME(GEM_ROM_READ_1(sc,
291 	    j + PCI_VPDRES_BYTE0)) != PCI_VPDRES_TYPE_VPD ||
292 	    ((GEM_ROM_READ_1(sc, j + PCI_VPDRES_LARGE_LEN_LSB) << 8) |
293 	    GEM_ROM_READ_1(sc, j + PCI_VPDRES_LARGE_LEN_MSB)) !=
294 	    PCI_VPD_SIZE + ETHER_ADDR_LEN ||
295 	    GEM_ROM_READ_1(sc, j + PCI_VPDRES_LARGE_SIZE + PCI_VPD_KEY0) !=
296 	    0x4e /* N */ ||
297 	    GEM_ROM_READ_1(sc, j + PCI_VPDRES_LARGE_SIZE + PCI_VPD_KEY1) !=
298 	    0x41 /* A */ ||
299 	    GEM_ROM_READ_1(sc, j + PCI_VPDRES_LARGE_SIZE + PCI_VPD_LEN) !=
300 	    ETHER_ADDR_LEN ||
301 	    GEM_ROM_READ_1(sc, j + PCI_VPDRES_LARGE_SIZE + PCI_VPD_SIZE +
302 	    ETHER_ADDR_LEN) != 0x79) {
303 		device_printf(dev, "unexpected PCI VPD\n");
304 		goto fail;
305 	}
306 	bus_read_region_1(sc->sc_res[GEM_RES_BANK1],
307 	    GEM_PCI_ROM_OFFSET + j + PCI_VPDRES_LARGE_SIZE + PCI_VPD_SIZE,
308 	    sc->sc_enaddr, ETHER_ADDR_LEN);
309 #endif
310 	/*
311 	 * The Xserve G5 has a fake GMAC with an all-zero MAC address.
312 	 * Check for this, and don't attach in this case.
313 	 */
314 
315 	for (i = 0; i < ETHER_ADDR_LEN && sc->sc_enaddr[i] == 0; i++) {}
316 	if (i == ETHER_ADDR_LEN) {
317 		device_printf(dev, "invalid MAC address\n");
318 		goto fail;
319 	}
320 
321 	if (gem_attach(sc) != 0) {
322 		device_printf(dev, "could not be attached\n");
323 		goto fail;
324 	}
325 
326 	if (bus_setup_intr(dev, sc->sc_res[GEM_RES_INTR], INTR_TYPE_NET |
327 	    INTR_MPSAFE, NULL, gem_intr, sc, &sc->sc_ih) != 0) {
328 		device_printf(dev, "failed to set up interrupt\n");
329 		gem_detach(sc);
330 		goto fail;
331 	}
332 	return (0);
333 
334  fail:
335 	if (sc->sc_res[GEM_RES_BANK2] != NULL)
336 		free(sc->sc_res[GEM_RES_BANK2], M_DEVBUF);
337 	GEM_LOCK_DESTROY(sc);
338 	bus_release_resources(dev, gem_pci_res_spec, sc->sc_res);
339 	return (ENXIO);
340 }
341 
342 static int
343 gem_pci_detach(device_t dev)
344 {
345 	struct gem_softc *sc;
346 
347 	sc = device_get_softc(dev);
348 	bus_teardown_intr(dev, sc->sc_res[GEM_RES_INTR], sc->sc_ih);
349 	gem_detach(sc);
350 	free(sc->sc_res[GEM_RES_BANK2], M_DEVBUF);
351 	GEM_LOCK_DESTROY(sc);
352 	bus_release_resources(dev, gem_pci_res_spec, sc->sc_res);
353 	return (0);
354 }
355 
356 static int
357 gem_pci_suspend(device_t dev)
358 {
359 
360 	gem_suspend(device_get_softc(dev));
361 	return (0);
362 }
363 
364 static int
365 gem_pci_resume(device_t dev)
366 {
367 
368 	gem_resume(device_get_softc(dev));
369 	return (0);
370 }
371