arch/common/boot/grub/netboot/sis900.txt

   1 How I added the SIS900 card to Etherboot
   2
   3 Author: Marty Connor (mdc@thinguin.org)
   4
   5 Date:   25 Febrary 2001
   6
   7 Description:
   8
   9 This file is intended to help people who want to write an Etherboot
  10 driver or port another driver to Etherboot.  It is a starting point.
  11 Perhaps someday I may write a more detailed description of writing an
  12 Etherboot driver. This text should help get people started, and
  13 studying sis900.[ch] should help show the basic structure and
  14 techniques involved in writing and Etherboot driver.
  15
  16 ***********************************************************************
  17
  18 0. Back up all the files I need to modify:
  19
  20 cd etherboot-4.7.20/src
  21 cp Makefile Makefile.orig
  22 cp config.c config.c.orig
  23 cp pci.h pci.h.orig
  24 cp NIC NIC.orig
  25 cp cards.h cards.h.orig
  26
  27 1. Edit src/Makefile to add SIS900FLAGS to defines
  28
  29 SIS900FLAGS=            -DINCLUDE_SIS900
  30
  31 2. edit src/pci.h to add PCI signatures for card
  32
  33 #define PCI_VENDOR_ID_SIS               0x1039
  34 #define PCI_DEVICE_ID_SIS900            0x0900
  35 #define PCI_DEVICE_ID_SIS7016           0x7016
  36
  37 3. Edit src/config.c to add the card to the card probe list
  38
  39 #if defined(INCLUDE_NS8390)  || defined(INCLUDE_EEPRO100)  ||
  40     defined(INCLUDE_LANCE)   || defined(INCLUDE_EPIC100)   ||
  41     defined(INCLUDE_TULIP)   || defined(INCLUDE_OTULIP)    ||
  42     defined(INCLUDE_3C90X)   || defined(INCLUDE_3C595)     ||
  43     defined(INCLUDE_RTL8139) || defined(INCLUDE_VIA_RHINE) ||
  44     defined(INCLUDE_SIS900)  || defined(INCLUDE_W89C840)
  45
  46 ... and ...
  47
  48 #ifdef INCLUDE_SIS900
  49        { PCI_VENDOR_ID_SIS,             PCI_DEVICE_ID_SIS900,
  50          "SIS900", 0, 0, 0, 0},
  51        { PCI_VENDOR_ID_SIS,             PCI_DEVICE_ID_SIS7016,
  52          "SIS7016", 0, 0, 0, 0},
  53 #endif
  54
  55 ... and ...
  56
  57 #ifdef INCLUDE_SIS900
  58         { "SIS900", sis900_probe, pci_ioaddrs },
  59 #endif
  60
  61 4. Edit NIC to add sis900 and sis7016 to NIC list
  62
  63 # SIS 900 and SIS 7016
  64 sis900          sis900          0x1039,0x0900
  65 sis7016         sis900          0x1039,0x7016
  66
  67 5. Edit cards.h to add sis900 probe routine declaration
  68
  69 #ifdef  INCLUDE_SIS900
  70 extern struct nic       *sis900_probe(struct nic *, unsigned short *
  71                         PCI_ARG(struct pci_device *));
  72 #endif
  73
  74 ***********************************************************************
  75
  76 At this point, you can begin creating your driver source file.  See
  77 the "Writing and Etherboot Driver" section of the Etherboot
  78 documentation for some hints.  See the skel.c file for a starting
  79 point.  If there is a Linux driver for the card, you may be able to
  80 use that.  Copy and learn from existing Etherboot drivers (this is GPL
  81 / Open Source software!).
  82
  83 Join the etherboot-developers and etherboot-users mailing lists
  84 (information is on etherboot.sourceforge.net) for information and
  85 assistance. We invite more developers to help improve Etherboot.
  86
  87 Visit the http://etherboot.sourceforge.net, http://thinguin.org,
  88 http://rom-o-matic.net, and http://ltsp.org sites for information and
  89 assistance.
  90
  91 Enjoy.