xref: /NextBSD/sys/dev/ep/if_ep_isa.c (revision eb1a5f8de9f7ea602c373a710f531abbf81141c4)
1 /*-
2  * Copyright (c) 1994 Herb Peyerl <hpeyerl@novatel.ca>
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. All advertising materials mentioning features or use of this software
14  *    must display the following acknowledgement:
15  *      This product includes software developed by Herb Peyerl.
16  * 4. The name of Herb Peyerl may not be used to endorse or promote products
17  *    derived from this software without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
20  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
21  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
22  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
23  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
24  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
28  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29  */
30 
31 #include <sys/cdefs.h>
32 __FBSDID("$FreeBSD$");
33 
34 #include <sys/param.h>
35 #include <sys/systm.h>
36 #include <sys/kernel.h>
37 #include <sys/socket.h>
38 #include <sys/module.h>
39 #include <sys/bus.h>
40 
41 #include <machine/bus.h>
42 #include <machine/resource.h>
43 #include <sys/rman.h>
44 
45 #include <net/if.h>
46 #include <net/if_arp.h>
47 #include <net/if_media.h>
48 
49 #include <isa/isavar.h>
50 
51 #include <dev/ep/if_epreg.h>
52 #include <dev/ep/if_epvar.h>
53 
54 #ifdef __i386__
55 #include <i386/isa/elink.h>
56 #endif
57 
58 #ifdef __i386__
59 static uint16_t get_eeprom_data(int, int);
60 static void ep_isa_identify(driver_t *, device_t);
61 #endif
62 
63 static int ep_isa_probe(device_t);
64 static int ep_isa_attach(device_t);
65 static int ep_eeprom_cksum(struct ep_softc *);
66 
67 struct isa_ident {
68 	uint32_t id;
69 	char *name;
70 };
71 const char *ep_isa_match_id(uint32_t, struct isa_ident *);
72 
73 #define ISA_ID_3C509_XXX   0x0506d509
74 #define ISA_ID_3C509_TP    0x506d5090
75 #define ISA_ID_3C509_BNC   0x506d5091
76 #define ISA_ID_3C509_COMBO 0x506d5094
77 #define ISA_ID_3C509_TPO   0x506d5095
78 #define ISA_ID_3C509_TPC   0x506d5098
79 #ifdef PC98
80 #define ISA_ID_3C569B_COMBO 0x506d5694
81 #define ISA_ID_3C569B_TPO   0x506d5695
82 #endif
83 
84 #ifdef __i386__
85 static struct isa_ident ep_isa_devs[] = {
86 	{ISA_ID_3C509_TP, "3Com 3C509-TP EtherLink III"},
87 	{ISA_ID_3C509_BNC, "3Com 3C509-BNC EtherLink III"},
88 	{ISA_ID_3C509_COMBO, "3Com 3C509-Combo EtherLink III"},
89 	{ISA_ID_3C509_TPO, "3Com 3C509-TPO EtherLink III"},
90 	{ISA_ID_3C509_TPC, "3Com 3C509-TPC EtherLink III"},
91 #ifdef PC98
92 	{ISA_ID_3C569B_COMBO, "3Com 3C569B-J-Combo EtherLink III"},
93 	{ISA_ID_3C569B_TPO, "3Com 3C569B-J-TPO EtherLink III"},
94 #endif
95 	{0, NULL},
96 };
97 #endif
98 
99 static struct isa_pnp_id ep_ids[] = {
100 	{0x90506d50, "3Com 3C509B-TP EtherLink III (PnP)"},	/* TCM5090 */
101 	{0x91506d50, "3Com 3C509B-BNC EtherLink III (PnP)"},	/* TCM5091 */
102 	{0x94506d50, "3Com 3C509B-Combo EtherLink III (PnP)"},	/* TCM5094 */
103 	{0x95506d50, "3Com 3C509B-TPO EtherLink III (PnP)"},	/* TCM5095 */
104 	{0x98506d50, "3Com 3C509B-TPC EtherLink III (PnP)"},	/* TCM5098 */
105 	{0xf780d041, NULL},	/* PNP80f7 */
106 	{0, NULL},
107 };
108 
109 /*
110  * We get eeprom data from the id_port given an offset into the eeprom.
111  * Basically; after the ID_sequence is sent to all of the cards; they enter
112  * the ID_CMD state where they will accept command requests. 0x80-0xbf loads
113  * the eeprom data.  We then read the port 16 times and with every read; the
114  * cards check for contention (ie: if one card writes a 0 bit and another
115  * writes a 1 bit then the host sees a 0. At the end of the cycle; each card
116  * compares the data on the bus; if there is a difference then that card goes
117  * into ID_WAIT state again). In the meantime; one bit of data is returned in
118  * the AX register which is conveniently returned to us by inb().  Hence; we
119  * read 16 times getting one bit of data with each read.
120  */
121 #ifdef __i386__
122 static uint16_t
get_eeprom_data(int id_port,int offset)123 get_eeprom_data(int id_port, int offset)
124 {
125 	int i;
126 	uint16_t data = 0;
127 
128 	outb(id_port, EEPROM_CMD_RD | offset);
129 	DELAY(BIT_DELAY_MULTIPLE * 1000);
130 	for (i = 0; i < 16; i++) {
131 		DELAY(50);
132 		data = (data << 1) | (inw(id_port) & 1);
133 	}
134 	return (data);
135 }
136 #endif
137 
138 const char *
ep_isa_match_id(uint32_t id,struct isa_ident * isa_devs)139 ep_isa_match_id(uint32_t id, struct isa_ident *isa_devs)
140 {
141 	struct isa_ident *i = isa_devs;
142 
143 	while (i->name != NULL) {
144 		if (id == i->id)
145 			return (i->name);
146 		i++;
147 	}
148 	/*
149 	 * If we see a card that is likely to be a 3c509
150 	 * return something so that it will work; be annoying
151 	 * so that the user will tell us about it though.
152 	 */
153 	if ((id >> 4) == ISA_ID_3C509_XXX)
154 		return ("Unknown 3c509; notify maintainer!");
155 	return (NULL);
156 }
157 
158 #ifdef __i386__
159 static void
ep_isa_identify(driver_t * driver,device_t parent)160 ep_isa_identify(driver_t * driver, device_t parent)
161 {
162 	int tag = EP_LAST_TAG;
163 	int found = 0;
164 	int i;
165 	int j;
166 	const char *desc;
167 	uint16_t data;
168 	uint32_t irq;
169 	uint32_t ioport;
170 	uint32_t isa_id;
171 	device_t child;
172 
173 	outb(ELINK_ID_PORT, 0);
174 	outb(ELINK_ID_PORT, 0);
175 	elink_idseq(ELINK_509_POLY);
176 	elink_reset();
177 
178 	DELAY(DELAY_MULTIPLE * 10000);
179 
180 	for (i = 0; i < EP_MAX_BOARDS; i++) {
181 
182 		outb(ELINK_ID_PORT, 0);
183 		outb(ELINK_ID_PORT, 0);
184 		elink_idseq(ELINK_509_POLY);
185 		DELAY(400);
186 
187 		/*
188 		 * For the first probe, clear all board's tag registers.
189 		 * Otherwise kill off already-found boards. -- linux 3c509.c
190 		 */
191 		if (i == 0)
192 			outb(ELINK_ID_PORT, 0xd0);
193 		else
194 			outb(ELINK_ID_PORT, 0xd8);
195 
196 		/* Get out of loop if we're out of cards. */
197 		data = get_eeprom_data(ELINK_ID_PORT, EEPROM_MFG_ID);
198 		if (data != MFG_ID)
199 			break;
200 		/* resolve contention using the Ethernet address */
201 		for (j = 0; j < 3; j++)
202 			(void)get_eeprom_data(ELINK_ID_PORT, j);
203 
204 		/*
205 		 * Construct an 'isa_id' in 'EISA'
206 		 * format.
207 		 */
208 		data = get_eeprom_data(ELINK_ID_PORT, EEPROM_MFG_ID);
209 		isa_id = (htons(data) << 16);
210 		data = get_eeprom_data(ELINK_ID_PORT, EEPROM_PROD_ID);
211 		isa_id |= htons(data);
212 
213 		/* Find known ISA boards */
214 		desc = ep_isa_match_id(isa_id, ep_isa_devs);
215 		if (!desc) {
216 			if (bootverbose)
217 				device_printf(parent,
218 				    "unknown ID 0x%08x\n", isa_id);
219 			continue;
220 		}
221 		/* Retreive IRQ */
222 		data = get_eeprom_data(ELINK_ID_PORT, EEPROM_RESOURCE_CFG);
223 		irq = (data >> 12);
224 
225 		/* Retreive IOPORT */
226 		data = get_eeprom_data(ELINK_ID_PORT, EEPROM_ADDR_CFG);
227 #ifdef PC98
228 		ioport = (((data & ADDR_CFG_MASK) * 0x100) + 0x40d0);
229 #else
230 		ioport = (((data & ADDR_CFG_MASK) << 4) + 0x200);
231 #endif
232 
233 		if ((data & ADDR_CFG_MASK) == ADDR_CFG_EISA) {
234 			device_printf(parent,
235 			    "<%s> at port 0x%03x in EISA mode!\n",
236 			    desc, ioport);
237 			/*
238 			 * Set the adaptor tag so that the next card can be
239 			 * found.
240 			 */
241 			outb(ELINK_ID_PORT, tag--);
242 			continue;
243 		}
244 		/* Test for an adapter with PnP support. */
245 		data = get_eeprom_data(ELINK_ID_PORT, EEPROM_CAP);
246 		if (data == CAP_ISA) {
247 			data = get_eeprom_data(ELINK_ID_PORT,
248 			    EEPROM_INT_CONFIG_1);
249 			if (data & ICW1_IAS_PNP) {
250 				if (bootverbose)
251 					device_printf(parent,
252 					    "<%s> at 0x%03x "
253 					    "in PnP mode!\n",
254 					    desc, ioport);
255 				/*
256 				 * Set the adaptor tag so that the next card
257 				 * can be found.
258 				 */
259 				outb(ELINK_ID_PORT, tag--);
260 				continue;
261 			}
262 		}
263 		/* Set the adaptor tag so that the next card can be found. */
264 		outb(ELINK_ID_PORT, tag--);
265 
266 		/* Activate the adaptor at the EEPROM location. */
267 		outb(ELINK_ID_PORT, ACTIVATE_ADAPTER_TO_CONFIG);
268 
269 		/* Test for an adapter in TEST mode. */
270 		outw(ioport + EP_COMMAND, WINDOW_SELECT | 0);
271 		data = inw(ioport + EP_W0_EEPROM_COMMAND);
272 		if (data & EEPROM_TST_MODE) {
273 			device_printf(parent,
274 			    "<%s> at port 0x%03x in TEST mode!"
275 			    "  Erase pencil mark.\n",
276 			    desc, ioport);
277 			continue;
278 		}
279 		child = BUS_ADD_CHILD(parent, ISA_ORDER_SPECULATIVE, "ep", -1);
280 		device_set_desc_copy(child, desc);
281 		device_set_driver(child, driver);
282 		bus_set_resource(child, SYS_RES_IRQ, 0, irq, 1);
283 		bus_set_resource(child, SYS_RES_IOPORT, 0, ioport, EP_IOSIZE);
284 
285 		if (bootverbose)
286 			device_printf(parent,
287 			    "<%s>"
288 			    " at port 0x%03x-0x%03x irq %d\n",
289 			    desc, ioport, ioport + EP_IOSIZE, irq);
290 		found++;
291 	}
292 }
293 #endif
294 
295 static int
ep_isa_probe(device_t dev)296 ep_isa_probe(device_t dev)
297 {
298 	int error = 0;
299 
300 	/* Check isapnp ids */
301 	error = ISA_PNP_PROBE(device_get_parent(dev), dev, ep_ids);
302 
303 	/* If the card had a PnP ID that didn't match any we know about */
304 	if (error == ENXIO)
305 		return (error);
306 
307 	/* If we had some other problem. */
308 	if (!(error == 0 || error == ENOENT))
309 		return (error);
310 
311 	/* If we have the resources we need then we're good to go. */
312 	if ((bus_get_resource_start(dev, SYS_RES_IOPORT, 0) != 0) &&
313 	    (bus_get_resource_start(dev, SYS_RES_IRQ, 0) != 0))
314 		return (0);
315 
316 	return (ENXIO);
317 }
318 
319 static int
ep_isa_attach(device_t dev)320 ep_isa_attach(device_t dev)
321 {
322 	struct ep_softc *sc = device_get_softc(dev);
323 	int error = 0;
324 
325 	if ((error = ep_alloc(dev)))
326 		goto bad;
327 	ep_get_media(sc);
328 
329 	GO_WINDOW(sc, 0);
330 	SET_IRQ(sc, rman_get_start(sc->irq));
331 
332 	if ((error = ep_attach(sc)))
333 		goto bad;
334 	error = ep_eeprom_cksum(sc);
335 	if (error) {
336 		device_printf(sc->dev, "Invalid EEPROM checksum!\n");
337 		goto bad;
338 	}
339 	if ((error = bus_setup_intr(dev, sc->irq, INTR_TYPE_NET | INTR_MPSAFE,
340 	    NULL, ep_intr, sc, &sc->ep_intrhand))) {
341 		device_printf(dev, "bus_setup_intr() failed! (%d)\n", error);
342 		goto bad;
343 	}
344 	return (0);
345 bad:
346 	ep_free(dev);
347 	return (error);
348 }
349 
350 static int
ep_eeprom_cksum(struct ep_softc * sc)351 ep_eeprom_cksum(struct ep_softc *sc)
352 {
353 	int i;
354 	int error;
355 	uint16_t val;
356 	uint16_t cksum;
357 	uint8_t cksum_high = 0;
358 	uint8_t cksum_low = 0;
359 
360 	error = ep_get_e(sc, 0x0f, &val);
361 	if (error)
362 		return (ENXIO);
363 	cksum = val;
364 
365 	for (i = 0; i < 0x0f; i++) {
366 		error = ep_get_e(sc, i, &val);
367 		if (error)
368 			return (ENXIO);
369 		switch (i) {
370 		case 0x08:
371 		case 0x09:
372 		case 0x0d:
373 			cksum_low ^= (uint8_t) (val & 0x00ff) ^
374 			    (uint8_t)((val & 0xff00) >> 8);
375 			break;
376 		default:
377 			cksum_high ^= (uint8_t) (val & 0x00ff) ^
378 			    (uint8_t)((val & 0xff00) >> 8);
379 			break;
380 		}
381 	}
382 	return (cksum != ((uint16_t)cksum_low | (uint16_t)(cksum_high << 8)));
383 }
384 
385 static device_method_t ep_isa_methods[] = {
386 	/* Device interface */
387 #ifdef __i386__
388 	DEVMETHOD(device_identify, ep_isa_identify),
389 #endif
390 	DEVMETHOD(device_probe, ep_isa_probe),
391 	DEVMETHOD(device_attach, ep_isa_attach),
392 	DEVMETHOD(device_detach, ep_detach),
393 
394 	DEVMETHOD_END
395 };
396 
397 static driver_t ep_isa_driver = {
398 	"ep",
399 	ep_isa_methods,
400 	sizeof(struct ep_softc),
401 };
402 
403 extern devclass_t ep_devclass;
404 
405 DRIVER_MODULE(ep, isa, ep_isa_driver, ep_devclass, 0, 0);
406 #ifdef __i386__
407 MODULE_DEPEND(ep, elink, 1, 1, 1);
408 #endif
409