| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | Text File for the SMC TokenCard TokenRing Linux driver (smctr.c). |
| 2 | By Jay Schulist <jschlst@samba.org> |
| 3 | |
| 4 | The Linux SMC Token Ring driver works with the SMC TokenCard Elite (8115T) |
| 5 | ISA and SMC TokenCard Elite/A (8115T/A) MCA adapters. |
| 6 | |
| 7 | Latest information on this driver can be obtained on the Linux-SNA WWW site. |
| 8 | Please point your browser to: http://www.linux-sna.org |
| 9 | |
| 10 | This driver is rather simple to use. Select Y to Token Ring adapter support |
| 11 | in the kernel configuration. A choice for SMC Token Ring adapters will |
| 12 | appear. This drives supports all SMC ISA/MCA adapters. Choose this |
| 13 | option. I personally recommend compiling the driver as a module (M), but if you |
| 14 | you would like to compile it staticly answer Y instead. |
| 15 | |
| 16 | This driver supports multiple adapters without the need to load multiple copies |
| 17 | of the driver. You should be able to load up to 7 adapters without any kernel |
| 18 | modifications, if you are in need of more please contact the maintainer of this |
| 19 | driver. |
| 20 | |
| 21 | Load the driver either by lilo/loadlin or as a module. When a module using the |
| 22 | following command will suffice for most: |
| 23 | |
| 24 | # modprobe smctr |
| 25 | smctr.c: v1.00 12/6/99 by jschlst@samba.org |
| 26 | tr0: SMC TokenCard 8115T at Io 0x300, Irq 10, Rom 0xd8000, Ram 0xcc000. |
| 27 | |
| 28 | Now just setup the device via ifconfig and set and routes you may have. After |
| 29 | this you are ready to start sending some tokens. |
| 30 | |
| 31 | Errata: |
| 32 | 1). For anyone wondering where to pick up the SMC adapters please browse |
| 33 | to http://www.smc.com |
| 34 | |
| 35 | 2). If you are the first/only Token Ring Client on a Token Ring LAN, please |
| 36 | specify the ringspeed with the ringspeed=[4/16] module option. If no |
| 37 | ringspeed is specified the driver will attempt to autodetect the ring |
| 38 | speed and/or if the adapter is the first/only station on the ring take |
| 39 | the appropriate actions. |
| 40 | |
| 41 | NOTE: Default ring speed is 16MB UTP. |
| 42 | |
| 43 | 3). PnP support for this adapter sucks. I recommend hard setting the |
| 44 | IO/MEM/IRQ by the jumpers on the adapter. If this is not possible |
| 45 | load the module with the following io=[ioaddr] mem=[mem_addr] |
| 46 | irq=[irq_num]. |
| 47 | |
| 48 | The following IRQ, IO, and MEM settings are supported. |
| 49 | |
| 50 | IO ports: |
| 51 | 0x200, 0x220, 0x240, 0x260, 0x280, 0x2A0, 0x2C0, 0x2E0, 0x300, |
| 52 | 0x320, 0x340, 0x360, 0x380. |
| 53 | |
| 54 | IRQs: |
| 55 | 2, 3, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
| 56 | |
| 57 | Memory addresses: |
| 58 | 0xA0000, 0xA4000, 0xA8000, 0xAC000, 0xB0000, 0xB4000, |
| 59 | 0xB8000, 0xBC000, 0xC0000, 0xC4000, 0xC8000, 0xCC000, |
| 60 | 0xD0000, 0xD4000, 0xD8000, 0xDC000, 0xE0000, 0xE4000, |
| 61 | 0xE8000, 0xEC000, 0xF0000, 0xF4000, 0xF8000, 0xFC000 |
| 62 | |
| 63 | This driver is under the GNU General Public License. Its Firmware image is |
| 64 | included as an initialized C-array and is licensed by SMC to the Linux |
| 65 | users of this driver. However no warranty about its fitness is expressed or |
| 66 | implied by SMC. |