Update email addresses in drivers
[people/adir/gpxe.git] / src / drivers / net / tulip.txt
1 This software may be used and distributed according to the terms of
2 the GNU Public License, incorporated herein by reference.
3
4 This is a tulip and clone driver for Etherboot.  See the revision
5 history in the tulip.c file for information on changes.  This version
6 of the driver incorporates changes from Bob Edwards and Paul Mackerras
7 who cantributed changes to support the TRENDnet TE100-PCIA NIC which
8 uses a genuine Intel 21143-PD chipset.  There are also various code
9 cleanups to make time-based activities more reliable.
10
11 Of course you have to have all the usual Etherboot environment
12 (bootp/dhcp/NFS) set up, and you need a Linux kernel with v0.91g
13 (7.16.99) or later of the tulip.c driver compiled in to support some
14 MX98715 based cards.  That file is available at:
15
16   http://cesdis.gsfc.nasa.gov/linux/drivers/test/tulip.c
17
18 NOTES
19
20 I've tested this driver with a SOHOware Fast 10/100 Model SDA110A,
21 a Linksys LNE100TX v2.0, and a Netgear FA310TX card, and it worked at
22 both 10 and 100 mbits. Other cards based on the tulip family may work as
23 well.
24
25 These cards are about 20$US, are supported by Linux and now Etherboot,
26 and being PCI, they auto-configure IRQ and IOADDR and auto-negotiate
27 10/100 half/full duplex. It seems like a pretty good value compared to
28 some of the pricier cards, and can lower the cost of building/adapting
29 thin client workstations substantially while giving a considerable
30 performance increase.
31
32 On some PCI tulip clone chipsets (MX987x5, LC82C115, LC82C168) this driver 
33 lets the card choose the fastest speed it can negotiate with the peer
34 device.  On other cards, it chooses 10mbit half-duplex.
35
36 I burned an AM27C256 (32KByte) EPROM with mx987x5.lzrom and it worked.
37 According to the data sheet the MX98715A supports up to 64K (27C512)
38 EPROMs, 
39
40 I've liberally commented the code and header files in the hope that it
41 will help the next person who hacks the code or needs to support some
42 tulip clone card, or wishes to add functionality.
43
44 Anyway, please test this if you can on your tulip based card, and let
45 me (mdc@etherboot.org) and the Etherboot-Discuss list
46 (etherboot-discuss@lists.sourceforge.net) know how things go.  I also
47 would appreciate code review by people who program.  I'm a strong
48 believer in "another set of eyes".
49
50 Regards,
51
52 Marty Connor
53 mdc@etherboot.org
54 http://www.etherboot.org/