qemu/roms/ipxe/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/