Annotation of Gnu-Mach/i386/i386at/gpl/linux/net/smc-ultra.c, revision 1.1.1.1

1.1       root        1: /* smc-ultra.c: A SMC Ultra ethernet driver for linux. */
                      2: /*
                      3:        Written 1993,1994,1995 by Donald Becker.
                      4: 
                      5:        Copyright 1993 United States Government as represented by the
                      6:        Director, National Security Agency.
                      7: 
                      8:        This software may be used and distributed according to the terms
                      9:        of the GNU Public License, incorporated herein by reference.
                     10: 
                     11:        The author may be reached as [email protected], or C/O
                     12:        Center of Excellence in Space Data and Information Sciences
                     13:                Code 930.5, Goddard Space Flight Center, Greenbelt MD 20771
                     14: 
                     15:        This is a driver for the SMC Ultra and SMC EtherEZ ethercards.
                     16: 
                     17:        This driver uses the cards in the 8390-compatible, shared memory mode.
                     18:        Most of the run-time complexity is handled by the generic code in
                     19:        8390.c.  The code in this file is responsible for
                     20: 
                     21:                ultra_probe()           Detecting and initializing the card.
                     22:                ultra_probe1()  
                     23: 
                     24:                ultra_open()            The card-specific details of starting, stopping
                     25:                ultra_reset_8390()      and resetting the 8390 NIC core.
                     26:                ultra_close()
                     27: 
                     28:                ultra_block_input()             Routines for reading and writing blocks of
                     29:                ultra_block_output()    packet buffer memory.
                     30: 
                     31:        This driver enables the shared memory only when doing the actual data
                     32:        transfers to avoid a bug in early version of the card that corrupted
                     33:        data transferred by a AHA1542.
                     34: 
                     35:        This driver does not support the programmed-I/O data transfer mode of
                     36:        the EtherEZ.  That support (if available) is smc-ez.c.  Nor does it
                     37:        use the non-8390-compatible "Altego" mode. (No support currently planned.)
                     38: 
                     39:        Changelog:
                     40: 
                     41:        Paul Gortmaker  : multiple card support for module users.
                     42: */
                     43: 
                     44: static const char *version =
                     45:        "smc-ultra.c:v1.12 1/18/95 Donald Becker ([email protected])\n";
                     46: 
                     47: 
                     48: #include <linux/module.h>
                     49: 
                     50: #include <linux/kernel.h>
                     51: #include <linux/sched.h>
                     52: #include <linux/errno.h>
                     53: #include <linux/string.h>
                     54: #include <asm/io.h>
                     55: #include <asm/system.h>
                     56: 
                     57: #include <linux/netdevice.h>
                     58: #include <linux/etherdevice.h>
                     59: #include "8390.h"
                     60: 
                     61: /* A zero-terminated list of I/O addresses to be probed. */
                     62: static unsigned int ultra_portlist[] =
                     63: {0x200, 0x220, 0x240, 0x280, 0x300, 0x340, 0x380, 0};
                     64: 
                     65: int ultra_probe(struct device *dev);
                     66: int ultra_probe1(struct device *dev, int ioaddr);
                     67: 
                     68: static int ultra_open(struct device *dev);
                     69: static void ultra_reset_8390(struct device *dev);
                     70: static void ultra_get_8390_hdr(struct device *dev, struct e8390_pkt_hdr *hdr, 
                     71:                                                int ring_page);
                     72: static void ultra_block_input(struct device *dev, int count,
                     73:                                                  struct sk_buff *skb, int ring_offset);
                     74: static void ultra_block_output(struct device *dev, int count,
                     75:                                                        const unsigned char *buf, const start_page);
                     76: static int ultra_close_card(struct device *dev);
                     77: 
                     78: 
                     79: #define START_PG               0x00    /* First page of TX buffer */
                     80: 
                     81: #define ULTRA_CMDREG   0               /* Offset to ASIC command register. */
                     82: #define         ULTRA_RESET    0x80    /* Board reset, in ULTRA_CMDREG. */
                     83: #define         ULTRA_MEMENB   0x40    /* Enable the shared memory. */
                     84: #define ULTRA_NIC_OFFSET  16   /* NIC register offset from the base_addr. */
                     85: #define ULTRA_IO_EXTENT 32
                     86: 
                     87: /*     Probe for the Ultra.  This looks like a 8013 with the station
                     88:        address PROM at I/O ports <base>+8 to <base>+13, with a checksum
                     89:        following.
                     90: */
                     91: #ifdef HAVE_DEVLIST
                     92: struct netdev_entry ultra_drv =
                     93: {"ultra", ultra_probe1, NETCARD_IO_EXTENT, netcard_portlist};
                     94: #else
                     95: 
                     96: int ultra_probe(struct device *dev)
                     97: {
                     98:        int i;
                     99:        int base_addr = dev ? dev->base_addr : 0;
                    100: 
                    101:        if (base_addr > 0x1ff)          /* Check a single specified location. */
                    102:                return ultra_probe1(dev, base_addr);
                    103:        else if (base_addr != 0)        /* Don't probe at all. */
                    104:                return ENXIO;
                    105: 
                    106:        for (i = 0; ultra_portlist[i]; i++) {
                    107:                int ioaddr = ultra_portlist[i];
                    108:                if (check_region(ioaddr, ULTRA_IO_EXTENT))
                    109:                        continue;
                    110:                if (ultra_probe1(dev, ioaddr) == 0)
                    111:                        return 0;
                    112:        }
                    113: 
                    114:        return ENODEV;
                    115: }
                    116: #endif
                    117: 
                    118: int ultra_probe1(struct device *dev, int ioaddr)
                    119: {
                    120:        int i;
                    121:        int checksum = 0;
                    122:        const char *model_name;
                    123:        unsigned char eeprom_irq = 0;
                    124:        static unsigned version_printed = 0;
                    125:        /* Values from various config regs. */
                    126:        unsigned char num_pages, irqreg, addr;
                    127:        unsigned char idreg = inb(ioaddr + 7);
                    128:        unsigned char reg4 = inb(ioaddr + 4) & 0x7f;
                    129: 
                    130:        /* Check the ID nibble. */
                    131:        if ((idreg & 0xF0) != 0x20                      /* SMC Ultra */
                    132:                && (idreg & 0xF0) != 0x40)              /* SMC EtherEZ */
                    133:                return ENODEV;
                    134: 
                    135:        /* Select the station address register set. */
                    136:        outb(reg4, ioaddr + 4);
                    137: 
                    138:        for (i = 0; i < 8; i++)
                    139:                checksum += inb(ioaddr + 8 + i);
                    140:        if ((checksum & 0xff) != 0xFF)
                    141:                return ENODEV;
                    142: 
                    143:        /* We should have a "dev" from Space.c or the static module table. */
                    144:        if (dev == NULL) {
                    145:                printk("smc-ultra.c: Passed a NULL device.\n");
                    146:                dev = init_etherdev(0, 0);
                    147:        }
                    148: 
                    149:        if (ei_debug  &&  version_printed++ == 0)
                    150:                printk(version);
                    151: 
                    152:        model_name = (idreg & 0xF0) == 0x20 ? "SMC Ultra" : "SMC EtherEZ";
                    153: 
                    154:        printk("%s: %s at %#3x,", dev->name, model_name, ioaddr);
                    155: 
                    156:        for (i = 0; i < 6; i++)
                    157:                printk(" %2.2X", dev->dev_addr[i] = inb(ioaddr + 8 + i));
                    158: 
                    159:        /* Switch from the station address to the alternate register set and
                    160:           read the useful registers there. */
                    161:        outb(0x80 | reg4, ioaddr + 4);
                    162: 
                    163:        /* Enabled FINE16 mode to avoid BIOS ROM width mismatches @ reboot. */
                    164:        outb(0x80 | inb(ioaddr + 0x0c), ioaddr + 0x0c);
                    165:        irqreg = inb(ioaddr + 0xd);
                    166:        addr = inb(ioaddr + 0xb);
                    167: 
                    168:        /* Switch back to the station address register set so that the MS-DOS driver
                    169:           can find the card after a warm boot. */
                    170:        outb(reg4, ioaddr + 4);
                    171: 
                    172:        if (dev->irq < 2) {
                    173:                unsigned char irqmap[] = {0, 9, 3, 5, 7, 10, 11, 15};
                    174:                int irq;
                    175: 
                    176:                /* The IRQ bits are split. */
                    177:                irq = irqmap[((irqreg & 0x40) >> 4) + ((irqreg & 0x0c) >> 2)];
                    178: 
                    179:                if (irq == 0) {
                    180:                        printk(", failed to detect IRQ line.\n");
                    181:                        return -EAGAIN;
                    182:                }
                    183:                dev->irq = irq;
                    184:                eeprom_irq = 1;
                    185:        }
                    186: 
                    187:        /* Allocate dev->priv and fill in 8390 specific dev fields. */
                    188:        if (ethdev_init(dev)) {
                    189:                printk (", no memory for dev->priv.\n");
                    190:                 return -ENOMEM;
                    191:         }
                    192:  
                    193:        /* OK, we are certain this is going to work.  Setup the device. */
                    194:        request_region(ioaddr, ULTRA_IO_EXTENT, model_name);
                    195: 
                    196:        /* The 8390 isn't at the base address, so fake the offset */
                    197:        dev->base_addr = ioaddr+ULTRA_NIC_OFFSET;
                    198: 
                    199:        {
                    200:                int addr_tbl[4] = {0x0C0000, 0x0E0000, 0xFC0000, 0xFE0000};
                    201:                short num_pages_tbl[4] = {0x20, 0x40, 0x80, 0xff};
                    202: 
                    203:                dev->mem_start = ((addr & 0x0f) << 13) + addr_tbl[(addr >> 6) & 3] ;
                    204:                num_pages = num_pages_tbl[(addr >> 4) & 3];
                    205:        }
                    206: 
                    207:        ei_status.name = model_name;
                    208:        ei_status.word16 = 1;
                    209:        ei_status.tx_start_page = START_PG;
                    210:        ei_status.rx_start_page = START_PG + TX_PAGES;
                    211:        ei_status.stop_page = num_pages;
                    212: 
                    213:        dev->rmem_start = dev->mem_start + TX_PAGES*256;
                    214:        dev->mem_end = dev->rmem_end
                    215:                = dev->mem_start + (ei_status.stop_page - START_PG)*256;
                    216: 
                    217:        printk(",%s IRQ %d memory %#lx-%#lx.\n", eeprom_irq ? "" : "assigned ",
                    218:                   dev->irq, dev->mem_start, dev->mem_end-1);
                    219: 
                    220:        ei_status.reset_8390 = &ultra_reset_8390;
                    221:        ei_status.block_input = &ultra_block_input;
                    222:        ei_status.block_output = &ultra_block_output;
                    223:        ei_status.get_8390_hdr = &ultra_get_8390_hdr;
                    224:        dev->open = &ultra_open;
                    225:        dev->stop = &ultra_close_card;
                    226:        NS8390_init(dev, 0);
                    227: 
                    228:        return 0;
                    229: }
                    230: 
                    231: static int
                    232: ultra_open(struct device *dev)
                    233: {
                    234:        int ioaddr = dev->base_addr - ULTRA_NIC_OFFSET; /* ASIC addr */
                    235: 
                    236:        if (request_irq(dev->irq, ei_interrupt, 0, ei_status.name))
                    237:                return -EAGAIN;
                    238: 
                    239:        outb(ULTRA_MEMENB, ioaddr);     /* Enable memory, 16 bit mode. */
                    240:        outb(0x80, ioaddr + 5);
                    241:        outb(0x01, ioaddr + 6);         /* Enable interrupts and memory. */
                    242:        ei_open(dev);
                    243:        MOD_INC_USE_COUNT;
                    244:        return 0;
                    245: }
                    246: 
                    247: static void
                    248: ultra_reset_8390(struct device *dev)
                    249: {
                    250:        int cmd_port = dev->base_addr - ULTRA_NIC_OFFSET; /* ASIC base addr */
                    251: 
                    252:        outb(ULTRA_RESET, cmd_port);
                    253:        if (ei_debug > 1) printk("resetting Ultra, t=%ld...", jiffies);
                    254:        ei_status.txing = 0;
                    255: 
                    256:        outb(ULTRA_MEMENB, cmd_port);
                    257: 
                    258:        if (ei_debug > 1) printk("reset done\n");
                    259:        return;
                    260: }
                    261: 
                    262: /* Grab the 8390 specific header. Similar to the block_input routine, but
                    263:    we don't need to be concerned with ring wrap as the header will be at
                    264:    the start of a page, so we optimize accordingly. */
                    265: 
                    266: static void
                    267: ultra_get_8390_hdr(struct device *dev, struct e8390_pkt_hdr *hdr, int ring_page)
                    268: {
                    269: 
                    270:        unsigned long hdr_start = dev->mem_start + ((ring_page - START_PG)<<8);
                    271: 
                    272:        outb(ULTRA_MEMENB, dev->base_addr - ULTRA_NIC_OFFSET);  /* shmem on */
                    273: #ifdef notdef
                    274:        /* Officially this is what we are doing, but the readl() is faster */
                    275:        memcpy_fromio(hdr, hdr_start, sizeof(struct e8390_pkt_hdr));
                    276: #else
                    277:        ((unsigned int*)hdr)[0] = readl(hdr_start);
                    278: #endif
                    279:        outb(0x00, dev->base_addr - ULTRA_NIC_OFFSET); /* shmem off */
                    280: }
                    281: 
                    282: /* Block input and output are easy on shared memory ethercards, the only
                    283:    complication is when the ring buffer wraps. */
                    284: 
                    285: static void
                    286: ultra_block_input(struct device *dev, int count, struct sk_buff *skb, int ring_offset)
                    287: {
                    288:        unsigned long xfer_start = dev->mem_start + ring_offset - (START_PG<<8);
                    289: 
                    290:        /* Enable shared memory. */
                    291:        outb(ULTRA_MEMENB, dev->base_addr - ULTRA_NIC_OFFSET);
                    292: 
                    293:        if (xfer_start + count > dev->rmem_end) {
                    294:                /* We must wrap the input move. */
                    295:                int semi_count = dev->rmem_end - xfer_start;
                    296:                memcpy_fromio(skb->data, xfer_start, semi_count);
                    297:                count -= semi_count;
                    298:                memcpy_fromio(skb->data + semi_count, dev->rmem_start, count);
                    299:        } else {
                    300:                /* Packet is in one chunk -- we can copy + cksum. */
                    301:                eth_io_copy_and_sum(skb, xfer_start, count, 0);
                    302:        }
                    303: 
                    304:        outb(0x00, dev->base_addr - ULTRA_NIC_OFFSET);  /* Disable memory. */
                    305: }
                    306: 
                    307: static void
                    308: ultra_block_output(struct device *dev, int count, const unsigned char *buf,
                    309:                                int start_page)
                    310: {
                    311:        unsigned long shmem = dev->mem_start + ((start_page - START_PG)<<8);
                    312: 
                    313:        /* Enable shared memory. */
                    314:        outb(ULTRA_MEMENB, dev->base_addr - ULTRA_NIC_OFFSET);
                    315: 
                    316:        memcpy_toio(shmem, buf, count);
                    317: 
                    318:        outb(0x00, dev->base_addr - ULTRA_NIC_OFFSET); /* Disable memory. */
                    319: }
                    320: 
                    321: static int
                    322: ultra_close_card(struct device *dev)
                    323: {
                    324:        int ioaddr = dev->base_addr - ULTRA_NIC_OFFSET; /* CMDREG */
                    325: 
                    326:        dev->start = 0;
                    327:        dev->tbusy = 1;
                    328: 
                    329:        if (ei_debug > 1)
                    330:                printk("%s: Shutting down ethercard.\n", dev->name);
                    331: 
                    332:        outb(0x00, ioaddr + 6);         /* Disable interrupts. */
                    333:        free_irq(dev->irq);
                    334:        irq2dev_map[dev->irq] = 0;
                    335: 
                    336:        NS8390_init(dev, 0);
                    337: 
                    338:        /* We should someday disable shared memory and change to 8-bit mode
                    339:           "just in case"... */
                    340: 
                    341:        MOD_DEC_USE_COUNT;
                    342: 
                    343:        return 0;
                    344: }
                    345: 
                    346: 
                    347: #ifdef MODULE
                    348: #define MAX_ULTRA_CARDS        4       /* Max number of Ultra cards per module */
                    349: #define NAMELEN                8       /* # of chars for storing dev->name */
                    350: static char namelist[NAMELEN * MAX_ULTRA_CARDS] = { 0, };
                    351: static struct device dev_ultra[MAX_ULTRA_CARDS] = {
                    352:        {
                    353:                NULL,           /* assign a chunk of namelist[] below */
                    354:                0, 0, 0, 0,
                    355:                0, 0,
                    356:                0, 0, 0, NULL, NULL
                    357:        },
                    358: };
                    359: 
                    360: static int io[MAX_ULTRA_CARDS] = { 0, };
                    361: static int irq[MAX_ULTRA_CARDS]  = { 0, };
                    362: 
                    363: /* This is set up so that only a single autoprobe takes place per call.
                    364: ISA device autoprobes on a running machine are not recommended. */
                    365: int
                    366: init_module(void)
                    367: {
                    368:        int this_dev, found = 0;
                    369: 
                    370:        for (this_dev = 0; this_dev < MAX_ULTRA_CARDS; this_dev++) {
                    371:                struct device *dev = &dev_ultra[this_dev];
                    372:                dev->name = namelist+(NAMELEN*this_dev);
                    373:                dev->irq = irq[this_dev];
                    374:                dev->base_addr = io[this_dev];
                    375:                dev->init = ultra_probe;
                    376:                if (io[this_dev] == 0)  {
                    377:                        if (this_dev != 0) break; /* only autoprobe 1st one */
                    378:                        printk(KERN_NOTICE "smc-ultra.c: Presently autoprobing (not recommended) for a single card.\n");
                    379:                }
                    380:                if (register_netdev(dev) != 0) {
                    381:                        printk(KERN_WARNING "smc-ultra.c: No SMC Ultra card found (i/o = 0x%x).\n", io[this_dev]);
                    382:                        if (found != 0) return 0;       /* Got at least one. */
                    383:                        return -ENXIO;
                    384:                }
                    385:                found++;
                    386:        }
                    387: 
                    388:        return 0;
                    389: }
                    390: 
                    391: void
                    392: cleanup_module(void)
                    393: {
                    394:        int this_dev;
                    395: 
                    396:        for (this_dev = 0; this_dev < MAX_ULTRA_CARDS; this_dev++) {
                    397:                struct device *dev = &dev_ultra[this_dev];
                    398:                if (dev->priv != NULL) {
                    399:                        /* NB: ultra_close_card() does free_irq + irq2dev */
                    400:                        int ioaddr = dev->base_addr - ULTRA_NIC_OFFSET;
                    401:                        kfree(dev->priv);
                    402:                        dev->priv = NULL;
                    403:                        release_region(ioaddr, ULTRA_IO_EXTENT);
                    404:                        unregister_netdev(dev);
                    405:                }
                    406:        }
                    407: }
                    408: #endif /* MODULE */
                    409: 
                    410: 
                    411: /*
                    412:  * Local variables:
                    413:  *  compile-command: "gcc -D__KERNEL__ -Wall -O6 -I/usr/src/linux/net/inet -c smc-ultra.c"
                    414:  *  version-control: t
                    415:  *  kept-new-versions: 5
                    416:  *  c-indent-level: 4
                    417:  *  tab-width: 4
                    418:  * End:
                    419:  */

unix.superglobalmegacorp.com

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