| 1 | How I added the SIS900 card to Etherboot
|
|---|
| 2 |
|
|---|
| 3 | Author: Marty Connor ([email protected])
|
|---|
| 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 an 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 http://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.
|
|---|
