Annotation of Gnu-Mach/linux/src/drivers/net/smc-ultra32.c, revision 1.1.1.1

1.1       root        1: /*     smc-ultra32.c: An SMC Ultra32 EISA ethernet driver for linux.
                      2: 
                      3: Sources:
                      4: 
                      5:        This driver is based on (cloned from) the ISA SMC Ultra driver
                      6:        written by Donald Becker. Modifications to support the EISA
                      7:        version of the card by Paul Gortmaker and Leonard N. Zubkoff.
                      8: 
                      9:        This software may be used and distributed according to the terms
                     10:        of the GNU Public License, incorporated herein by reference.
                     11: 
                     12: Theory of Operation:
                     13: 
                     14:        The SMC Ultra32C card uses the SMC 83c790 chip which is also
                     15:        found on the ISA SMC Ultra cards. It has a shared memory mode of
                     16:        operation that makes it similar to the ISA version of the card.
                     17:        The main difference is that the EISA card has 32KB of RAM, but
                     18:        only an 8KB window into that memory. The EISA card also can be
                     19:        set for a bus-mastering mode of operation via the ECU, but that
                     20:        is not (and probably will never be) supported by this driver.
                     21:        The ECU should be run to enable shared memory and to disable the
                     22:        bus-mastering feature for use with linux.
                     23: 
                     24:        By programming the 8390 to use only 8KB RAM, the modifications
                     25:        to the ISA driver can be limited to the probe and initialization
                     26:        code. This allows easy integration of EISA support into the ISA
                     27:        driver. However, the driver development kit from SMC provided the
                     28:        register information for sliding the 8KB window, and hence the 8390
                     29:        is programmed to use the full 32KB RAM.
                     30: 
                     31:        Unfortunately this required code changes outside the probe/init
                     32:        routines, and thus we decided to separate the EISA driver from
                     33:        the ISA one. In this way, ISA users don't end up with a larger
                     34:        driver due to the EISA code, and EISA users don't end up with a
                     35:        larger driver due to the ISA EtherEZ PIO code. The driver is
                     36:        similar to the 3c503/16 driver, in that the window must be set
                     37:        back to the 1st 8KB of space for access to the two 8390 Tx slots.
                     38: 
                     39:        In testing, using only 8KB RAM (3 Tx / 5 Rx) didn't appear to
                     40:        be a limiting factor, since the EISA bus could get packets off
                     41:        the card fast enough, but having the use of lots of RAM as Rx
                     42:        space is extra insurance if interrupt latencies become excessive.
                     43: 
                     44: */
                     45: 
                     46: static const char *version = "smc-ultra32.c: 06/97 v1.00\n";
                     47: 
                     48: 
                     49: #include <linux/module.h>
                     50: #include <linux/kernel.h>
                     51: #include <linux/sched.h>
                     52: #include <linux/errno.h>
                     53: #include <linux/string.h>
                     54: 
                     55: #include <asm/io.h>
                     56: #include <asm/system.h>
                     57: 
                     58: #include <linux/netdevice.h>
                     59: #include <linux/etherdevice.h>
                     60: #include "8390.h"
                     61: 
                     62: int ultra32_probe(struct device *dev);
                     63: int ultra32_probe1(struct device *dev, int ioaddr);
                     64: static int ultra32_open(struct device *dev);
                     65: static void ultra32_reset_8390(struct device *dev);
                     66: static void ultra32_get_8390_hdr(struct device *dev, struct e8390_pkt_hdr *hdr,
                     67:                                 int ring_page);
                     68: static void ultra32_block_input(struct device *dev, int count,
                     69:                                struct sk_buff *skb, int ring_offset);
                     70: static void ultra32_block_output(struct device *dev, int count,
                     71:                                 const unsigned char *buf, const int start_page);
                     72: static int ultra32_close(struct device *dev);
                     73: 
                     74: #define ULTRA32_CMDREG 0       /* Offset to ASIC command register. */
                     75: #define         ULTRA32_RESET  0x80    /* Board reset, in ULTRA32_CMDREG. */
                     76: #define         ULTRA32_MEMENB 0x40    /* Enable the shared memory. */
                     77: #define ULTRA32_NIC_OFFSET 16  /* NIC register offset from the base_addr. */
                     78: #define ULTRA32_IO_EXTENT 32
                     79: #define EN0_ERWCNT             0x08    /* Early receive warning count. */
                     80: 
                     81: /*
                     82:  * Defines that apply only to the Ultra32 EISA card. Note that
                     83:  * "smc" = 10011 01101 00011 = 0x4da3, and hence !smc8010.cfg translates
                     84:  * into an EISA ID of 0x1080A34D
                     85:  */
                     86: #define ULTRA32_BASE   0xca0
                     87: #define ULTRA32_ID     0x1080a34d
                     88: #define ULTRA32_IDPORT (-0x20) /* 0xc80 */
                     89: /* Config regs 1->7 from the EISA !SMC8010.CFG file. */
                     90: #define ULTRA32_CFG1   0x04    /* 0xca4 */
                     91: #define ULTRA32_CFG2   0x05    /* 0xca5 */
                     92: #define ULTRA32_CFG3   (-0x18) /* 0xc88 */
                     93: #define ULTRA32_CFG4   (-0x17) /* 0xc89 */
                     94: #define ULTRA32_CFG5   (-0x16) /* 0xc8a */
                     95: #define ULTRA32_CFG6   (-0x15) /* 0xc8b */
                     96: #define ULTRA32_CFG7   0x0d    /* 0xcad */
                     97: 
                     98: 
                     99: /*     Probe for the Ultra32.  This looks like a 8013 with the station
                    100:        address PROM at I/O ports <base>+8 to <base>+13, with a checksum
                    101:        following.
                    102: */
                    103: 
                    104: int ultra32_probe(struct device *dev)
                    105: {
                    106:        const char *ifmap[] = {"UTP No Link", "", "UTP/AUI", "UTP/BNC"};
                    107:        int ioaddr, edge, media;
                    108: 
                    109:        if (!EISA_bus) return ENODEV;
                    110: 
                    111:        /* EISA spec allows for up to 16 slots, but 8 is typical. */
                    112:        for (ioaddr = 0x1000 + ULTRA32_BASE; ioaddr < 0x9000; ioaddr += 0x1000)
                    113:        if (check_region(ioaddr, ULTRA32_IO_EXTENT) == 0 &&
                    114:            inb(ioaddr + ULTRA32_IDPORT) != 0xff &&
                    115:            inl(ioaddr + ULTRA32_IDPORT) == ULTRA32_ID) {
                    116:                media = inb(ioaddr + ULTRA32_CFG7) & 0x03;
                    117:                edge = inb(ioaddr + ULTRA32_CFG5) & 0x08;
                    118:                printk("SMC Ultra32 in EISA Slot %d, Media: %s, %s IRQs.\n",
                    119:                       ioaddr >> 12, ifmap[media],
                    120:                       (edge ? "Edge Triggered" : "Level Sensitive"));
                    121:                if (ultra32_probe1(dev, ioaddr) == 0)
                    122:                  return 0;
                    123:        }
                    124:        return ENODEV;
                    125: }
                    126: 
                    127: int ultra32_probe1(struct device *dev, int ioaddr)
                    128: {
                    129:        int i;
                    130:        int checksum = 0;
                    131:        const char *model_name;
                    132:        static unsigned version_printed = 0;
                    133:        /* Values from various config regs. */
                    134:        unsigned char idreg = inb(ioaddr + 7);
                    135:        unsigned char reg4 = inb(ioaddr + 4) & 0x7f;
                    136: 
                    137:        /* Check the ID nibble. */
                    138:        if ((idreg & 0xf0) != 0x20)                     /* SMC Ultra */
                    139:                return ENODEV;
                    140: 
                    141:        /* Select the station address register set. */
                    142:        outb(reg4, ioaddr + 4);
                    143: 
                    144:        for (i = 0; i < 8; i++)
                    145:                checksum += inb(ioaddr + 8 + i);
                    146:        if ((checksum & 0xff) != 0xff)
                    147:                return ENODEV;
                    148: 
                    149:        /* We should have a "dev" from Space.c or the static module table. */
                    150:        if (dev == NULL) {
                    151:                printk("smc-ultra32.c: Passed a NULL device.\n");
                    152:                dev = init_etherdev(0, 0);
                    153:        }
                    154: 
                    155:        if (ei_debug  &&  version_printed++ == 0)
                    156:                printk(version);
                    157: 
                    158:        model_name = "SMC Ultra32";
                    159: 
                    160:        printk("%s: %s at 0x%X,", dev->name, model_name, ioaddr);
                    161: 
                    162:        for (i = 0; i < 6; i++)
                    163:                printk(" %2.2X", dev->dev_addr[i] = inb(ioaddr + 8 + i));
                    164: 
                    165:        /* Switch from the station address to the alternate register set and
                    166:           read the useful registers there. */
                    167:        outb(0x80 | reg4, ioaddr + 4);
                    168: 
                    169:        /* Enable FINE16 mode to avoid BIOS ROM width mismatches @ reboot. */
                    170:        outb(0x80 | inb(ioaddr + 0x0c), ioaddr + 0x0c);
                    171: 
                    172:        /* Reset RAM addr. */
                    173:        outb(0x00, ioaddr + 0x0b);
                    174: 
                    175:        /* Switch back to the station address register set so that the
                    176:           MS-DOS driver can find the card after a warm boot. */
                    177:        outb(reg4, ioaddr + 4);
                    178: 
                    179:        if ((inb(ioaddr + ULTRA32_CFG5) & 0x40) == 0) {
                    180:                printk("\nsmc-ultra32: Card RAM is disabled!  "
                    181:                       "Run EISA config utility.\n");
                    182:                return ENODEV;
                    183:        }
                    184:        if ((inb(ioaddr + ULTRA32_CFG2) & 0x04) == 0)
                    185:                printk("\nsmc-ultra32: Ignoring Bus-Master enable bit.  "
                    186:                       "Run EISA config utility.\n");
                    187: 
                    188:        if (dev->irq < 2) {
                    189:                unsigned char irqmap[] = {0, 9, 3, 5, 7, 10, 11, 15};
                    190:                int irq = irqmap[inb(ioaddr + ULTRA32_CFG5) & 0x07];
                    191:                if (irq == 0) {
                    192:                        printk(", failed to detect IRQ line.\n");
                    193:                        return -EAGAIN;
                    194:                }
                    195:                dev->irq = irq;
                    196:        }
                    197: 
                    198:        /* Allocate dev->priv and fill in 8390 specific dev fields. */
                    199:        if (ethdev_init(dev)) {
                    200:                printk (", no memory for dev->priv.\n");
                    201:                 return -ENOMEM;
                    202:         }
                    203: 
                    204:        /* OK, we are certain this is going to work.  Setup the device. */
                    205:        request_region(ioaddr, ULTRA32_IO_EXTENT, model_name);
                    206: 
                    207:        /* The 8390 isn't at the base address, so fake the offset */
                    208:        dev->base_addr = ioaddr + ULTRA32_NIC_OFFSET;
                    209: 
                    210:        /* Save RAM address in the unused reg0 to avoid excess inb's. */
                    211:        ei_status.reg0 = inb(ioaddr + ULTRA32_CFG3) & 0xfc;
                    212: 
                    213:        dev->mem_start =  0xc0000 + ((ei_status.reg0 & 0x7c) << 11);
                    214: 
                    215:        ei_status.name = model_name;
                    216:        ei_status.word16 = 1;
                    217:        ei_status.tx_start_page = 0;
                    218:        ei_status.rx_start_page = TX_PAGES;
                    219:        /* All Ultra32 cards have 32KB memory with an 8KB window. */
                    220:        ei_status.stop_page = 128;
                    221: 
                    222:        dev->rmem_start = dev->mem_start + TX_PAGES*256;
                    223:        dev->mem_end = dev->rmem_end = dev->mem_start + 0x1fff;
                    224: 
                    225:        printk(", IRQ %d, 32KB memory, 8KB window at 0x%lx-0x%lx.\n",
                    226:               dev->irq, dev->mem_start, dev->mem_end);
                    227:        ei_status.block_input = &ultra32_block_input;
                    228:        ei_status.block_output = &ultra32_block_output;
                    229:        ei_status.get_8390_hdr = &ultra32_get_8390_hdr;
                    230:        ei_status.reset_8390 = &ultra32_reset_8390;
                    231:        dev->open = &ultra32_open;
                    232:        dev->stop = &ultra32_close;
                    233:        NS8390_init(dev, 0);
                    234: 
                    235:        return 0;
                    236: }
                    237: 
                    238: static int ultra32_open(struct device *dev)
                    239: {
                    240:        int ioaddr = dev->base_addr - ULTRA32_NIC_OFFSET; /* ASIC addr */
                    241: 
                    242:        if (request_irq(dev->irq, ei_interrupt, 0, ei_status.name, dev))
                    243:                return -EAGAIN;
                    244: 
                    245:        outb(ULTRA32_MEMENB, ioaddr); /* Enable Shared Memory. */
                    246:        outb(0x80, ioaddr + ULTRA32_CFG6); /* Enable Interrupts. */
                    247:        outb(0x84, ioaddr + 5); /* Enable MEM16 & Disable Bus Master. */
                    248:        outb(0x01, ioaddr + 6); /* Enable Interrupts. */
                    249:        /* Set the early receive warning level in window 0 high enough not
                    250:           to receive ERW interrupts. */
                    251:        outb_p(E8390_NODMA+E8390_PAGE0, dev->base_addr);
                    252:        outb(0xff, dev->base_addr + EN0_ERWCNT);
                    253:        ei_open(dev);
                    254:        MOD_INC_USE_COUNT;
                    255:        return 0;
                    256: }
                    257: 
                    258: static int ultra32_close(struct device *dev)
                    259: {
                    260:        int ioaddr = dev->base_addr - ULTRA32_NIC_OFFSET; /* CMDREG */
                    261: 
                    262:        dev->start = 0;
                    263:        dev->tbusy = 1;
                    264: 
                    265:        if (ei_debug > 1)
                    266:                printk("%s: Shutting down ethercard.\n", dev->name);
                    267: 
                    268:        outb(0x00, ioaddr + ULTRA32_CFG6); /* Disable Interrupts. */
                    269:        outb(0x00, ioaddr + 6);         /* Disable interrupts. */
                    270:        free_irq(dev->irq, dev);
                    271:        irq2dev_map[dev->irq] = 0;
                    272: 
                    273:        NS8390_init(dev, 0);
                    274: 
                    275:        MOD_DEC_USE_COUNT;
                    276: 
                    277:        return 0;
                    278: }
                    279: 
                    280: static void ultra32_reset_8390(struct device *dev)
                    281: {
                    282:        int ioaddr = dev->base_addr - ULTRA32_NIC_OFFSET; /* ASIC base addr */
                    283: 
                    284:        outb(ULTRA32_RESET, ioaddr);
                    285:        if (ei_debug > 1) printk("resetting Ultra32, t=%ld...", jiffies);
                    286:        ei_status.txing = 0;
                    287: 
                    288:        outb(ULTRA32_MEMENB, ioaddr); /* Enable Shared Memory. */
                    289:        outb(0x80, ioaddr + ULTRA32_CFG6); /* Enable Interrupts. */
                    290:        outb(0x84, ioaddr + 5); /* Enable MEM16 & Disable Bus Master. */
                    291:        outb(0x01, ioaddr + 6); /* Enable Interrupts. */
                    292:        if (ei_debug > 1) printk("reset done\n");
                    293:        return;
                    294: }
                    295: 
                    296: /* Grab the 8390 specific header. Similar to the block_input routine, but
                    297:    we don't need to be concerned with ring wrap as the header will be at
                    298:    the start of a page, so we optimize accordingly. */
                    299: 
                    300: static void ultra32_get_8390_hdr(struct device *dev,
                    301:                                 struct e8390_pkt_hdr *hdr,
                    302:                                 int ring_page)
                    303: {
                    304:        unsigned long hdr_start = dev->mem_start + ((ring_page & 0x1f) << 8);
                    305:        unsigned int RamReg = dev->base_addr - ULTRA32_NIC_OFFSET + ULTRA32_CFG3;
                    306: 
                    307:        /* Select correct 8KB Window. */
                    308:        outb(ei_status.reg0 | ((ring_page & 0x60) >> 5), RamReg);
                    309: 
                    310: #ifdef notdef
                    311:        /* Officially this is what we are doing, but the readl() is faster */
                    312:        memcpy_fromio(hdr, hdr_start, sizeof(struct e8390_pkt_hdr));
                    313: #else
                    314:        ((unsigned int*)hdr)[0] = readl(hdr_start);
                    315: #endif
                    316: }
                    317: 
                    318: /* Block input and output are easy on shared memory ethercards, the only
                    319:    complication is when the ring buffer wraps, or in this case, when a
                    320:    packet spans an 8KB boundary. Note that the current 8KB segment is
                    321:    already set by the get_8390_hdr routine. */
                    322: 
                    323: static void ultra32_block_input(struct device *dev,
                    324:                                int count,
                    325:                                struct sk_buff *skb,
                    326:                                int ring_offset)
                    327: {
                    328:        unsigned long xfer_start = dev->mem_start + (ring_offset & 0x1fff);
                    329:        unsigned int RamReg = dev->base_addr - ULTRA32_NIC_OFFSET + ULTRA32_CFG3;
                    330: 
                    331:        if ((ring_offset & ~0x1fff) != ((ring_offset + count - 1) & ~0x1fff)) {
                    332:                int semi_count = 8192 - (ring_offset & 0x1FFF);
                    333:                memcpy_fromio(skb->data, xfer_start, semi_count);
                    334:                count -= semi_count;
                    335:                if (ring_offset < 96*256) {
                    336:                        /* Select next 8KB Window. */
                    337:                        ring_offset += semi_count;
                    338:                        outb(ei_status.reg0 | ((ring_offset & 0x6000) >> 13), RamReg);
                    339:                        memcpy_fromio(skb->data + semi_count, dev->mem_start, count);
                    340:                } else {
                    341:                        /* Select first 8KB Window. */
                    342:                        outb(ei_status.reg0, RamReg);
                    343:                        memcpy_fromio(skb->data + semi_count, dev->rmem_start, count);
                    344:                }
                    345:        } else {
                    346:                /* Packet is in one chunk -- we can copy + cksum. */
                    347:                eth_io_copy_and_sum(skb, xfer_start, count, 0);
                    348:        }
                    349: }
                    350: 
                    351: static void ultra32_block_output(struct device *dev,
                    352:                                 int count,
                    353:                                 const unsigned char *buf,
                    354:                                 int start_page)
                    355: {
                    356:        unsigned long xfer_start = dev->mem_start + (start_page<<8);
                    357:        unsigned int RamReg = dev->base_addr - ULTRA32_NIC_OFFSET + ULTRA32_CFG3;
                    358: 
                    359:        /* Select first 8KB Window. */
                    360:        outb(ei_status.reg0, RamReg);
                    361: 
                    362:        memcpy_toio(xfer_start, buf, count);
                    363: }
                    364: 
                    365: #ifdef MODULE
                    366: #define MAX_ULTRA32_CARDS   4  /* Max number of Ultra cards per module */
                    367: #define NAMELEN                    8   /* # of chars for storing dev->name */
                    368: static char namelist[NAMELEN * MAX_ULTRA32_CARDS] = { 0, };
                    369: static struct device dev_ultra[MAX_ULTRA32_CARDS] = {
                    370:        {
                    371:                NULL,           /* assign a chunk of namelist[] below */
                    372:                0, 0, 0, 0,
                    373:                0, 0,
                    374:                0, 0, 0, NULL, NULL
                    375:        },
                    376: };
                    377: 
                    378: int init_module(void)
                    379: {
                    380:        int this_dev, found = 0;
                    381: 
                    382:        for (this_dev = 0; this_dev < MAX_ULTRA32_CARDS; this_dev++) {
                    383:                struct device *dev = &dev_ultra[this_dev];
                    384:                dev->name = namelist+(NAMELEN*this_dev);
                    385:                dev->init = ultra32_probe;
                    386:                if (register_netdev(dev) != 0) {
                    387:                        if (found > 0) return 0; /* Got at least one. */
                    388:                        printk(KERN_WARNING "smc-ultra32.c: No SMC Ultra32 found.\n");
                    389:                        return -ENXIO;
                    390:                }
                    391:                found++;
                    392:        }
                    393: 
                    394:        return 0;
                    395: }
                    396: 
                    397: void cleanup_module(void)
                    398: {
                    399:        int this_dev;
                    400: 
                    401:        for (this_dev = 0; this_dev < MAX_ULTRA32_CARDS; this_dev++) {
                    402:                struct device *dev = &dev_ultra[this_dev];
                    403:                if (dev->priv != NULL) {
                    404:                        /* NB: ultra32_close_card() does free_irq + irq2dev */
                    405:                        int ioaddr = dev->base_addr - ULTRA32_NIC_OFFSET;
                    406:                        kfree(dev->priv);
                    407:                        dev->priv = NULL;
                    408:                        release_region(ioaddr, ULTRA32_IO_EXTENT);
                    409:                        unregister_netdev(dev);
                    410:                }
                    411:        }
                    412: }
                    413: #endif /* MODULE */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.