plip.c

Go to the documentation of this file.

/* $Id: plip.c,v 1.3.6.2 1997/04/16 15:07:56 phil Exp $ */
/* PLIP: A parallel port "network" driver for Linux. */
/* This driver is for parallel port with 5-bit cable (LapLink (R) cable). */
/*
 * Authors:     Donald Becker,  <becker@super.org>
 *              Tommy Thorn, <thorn@daimi.aau.dk>
 *              Tanabe Hiroyasu, <hiro@sanpo.t.u-tokyo.ac.jp>
 *              Alan Cox, <gw4pts@gw4pts.ampr.org>
 *              Peter Bauer, <100136.3530@compuserve.com>
 *              Niibe Yutaka, <gniibe@mri.co.jp>
 *
 *              Modularization and ifreq/ifmap support by Alan Cox.
 *              Rewritten by Niibe Yutaka.
 *              parport-sharing awareness code by Philip Blundell.
 *              SMP locking by Niibe Yutaka.
 *
 * Fixes:
 *              Niibe Yutaka
 *                - Module initialization.
 *                - MTU fix.
 *                - Make sure other end is OK, before sending a packet.
 *                - Fix immediate timer problem.
 *
 *              Al Viro
 *                - Changed {enable,disable}_irq handling to make it work
 *                  with new ("stack") semantics.
 *
 *              This program is free software; you can redistribute it and/or
 *              modify it under the terms of the GNU General Public License
 *              as published by the Free Software Foundation; either version
 *              2 of the License, or (at your option) any later version.
 */

/*
 * Original version and the name 'PLIP' from Donald Becker <becker@super.org>
 * inspired by Russ Nelson's parallel port packet driver.
 *
 * NOTE:
 *     Tanabe Hiroyasu had changed the protocol, and it was in Linux v1.0.
 *     Because of the necessity to communicate to DOS machines with the
 *     Crynwr packet driver, Peter Bauer changed the protocol again
 *     back to original protocol.
 *
 *     This version follows original PLIP protocol.
 *     So, this PLIP can't communicate the PLIP of Linux v1.0.
 */

/*
 *     To use with DOS box, please do (Turn on ARP switch):
 *      # ifconfig plip[0-2] arp
 */
static const char *version = "NET3 PLIP version 2.3-parport gniibe@mri.co.jp\n";

/*
  Sources:
        Ideas and protocols came from Russ Nelson's <nelson@crynwr.com>
        "parallel.asm" parallel port packet driver.

  The "Crynwr" parallel port standard specifies the following protocol:
    Trigger by sending '0x08' (this cause interrupt on other end)
    count-low octet
    count-high octet
    ... data octets
    checksum octet
  Each octet is sent as <wait for rx. '0x1?'> <send 0x10+(octet&0x0F)>
                        <wait for rx. '0x0?'> <send 0x00+((octet>>4)&0x0F)>

  The packet is encapsulated as if it were ethernet.

  The cable used is a de facto standard parallel null cable -- sold as
  a "LapLink" cable by various places.  You'll need a 12-conductor cable to
  make one yourself.  The wiring is:
    SLCTIN      17 - 17
    GROUND      25 - 25
    D0->ERROR   2 - 15          15 - 2
    D1->SLCT    3 - 13          13 - 3
    D2->PAPOUT  4 - 12          12 - 4
    D3->ACK     5 - 10          10 - 5
    D4->BUSY    6 - 11          11 - 6
  Do not connect the other pins.  They are
    D5,D6,D7 are 7,8,9
    STROBE is 1, FEED is 14, INIT is 16
    extra grounds are 18,19,20,21,22,23,24
*/

#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/sched.h>
#include <linux/types.h>
#include <linux/fcntl.h>
#include <linux/interrupt.h>
#include <linux/string.h>
#include <linux/ptrace.h>
#include <linux/if_ether.h>
#include <asm/system.h>
#include <asm/io.h>
#include <linux/in.h>
#include <linux/errno.h>
#include <linux/delay.h>
#include <linux/lp.h>
#include <linux/init.h>

#include <linux/netdevice.h>
#include <linux/etherdevice.h>
#include <linux/inetdevice.h>
#include <linux/skbuff.h>
#include <linux/if_plip.h>

#include <linux/tqueue.h>
#include <linux/ioport.h>
#include <asm/bitops.h>
#include <asm/irq.h>
#include <asm/byteorder.h>
#include <asm/spinlock.h>

#include <linux/parport.h>

/* Maximum number of devices to support. */
#define PLIP_MAX  8

/* Use 0 for production, 1 for verification, >2 for debug */
#ifndef NET_DEBUG
#define NET_DEBUG 1
#endif
static unsigned int net_debug = NET_DEBUG;

#define ENABLE(irq) enable_irq(irq)
#define DISABLE(irq) disable_irq(irq)

/* In micro second */
#define PLIP_DELAY_UNIT            1

/* Connection time out = PLIP_TRIGGER_WAIT * PLIP_DELAY_UNIT usec */
#define PLIP_TRIGGER_WAIT        500

/* Nibble time out = PLIP_NIBBLE_WAIT * PLIP_DELAY_UNIT usec */
#define PLIP_NIBBLE_WAIT        3000

#define PAR_INTR_ON             (LP_PINITP|LP_PSELECP|LP_PINTEN)
#define PAR_INTR_OFF            (LP_PINITP|LP_PSELECP)
#define PAR_DATA(dev)           ((dev)->base_addr+0)
#define PAR_STATUS(dev)         ((dev)->base_addr+1)
#define PAR_CONTROL(dev)        ((dev)->base_addr+2)

/* Bottom halfs */
static void plip_kick_bh(struct device *dev);
static void plip_bh(struct device *dev);

/* Interrupt handler */
static void plip_interrupt(int irq, void *dev_id, struct pt_regs *regs);

/* Functions for DEV methods */
static int plip_rebuild_header(struct sk_buff *skb);
static int plip_tx_packet(struct sk_buff *skb, struct device *dev);
static int plip_open(struct device *dev);
static int plip_close(struct device *dev);
static struct net_device_stats *plip_get_stats(struct device *dev);
static int plip_config(struct device *dev, struct ifmap *map);
static int plip_ioctl(struct device *dev, struct ifreq *ifr, int cmd);
static int plip_preempt(void *handle);
static void plip_wakeup(void *handle);

enum plip_connection_state {
        PLIP_CN_NONE=0,
        PLIP_CN_RECEIVE,
        PLIP_CN_SEND,
        PLIP_CN_CLOSING,
        PLIP_CN_ERROR
};

enum plip_packet_state {
        PLIP_PK_DONE=0,
        PLIP_PK_TRIGGER,
        PLIP_PK_LENGTH_LSB,
        PLIP_PK_LENGTH_MSB,
        PLIP_PK_DATA,
        PLIP_PK_CHECKSUM
};

enum plip_nibble_state {
        PLIP_NB_BEGIN,
        PLIP_NB_1,
        PLIP_NB_2,
};

struct plip_local {
        enum plip_packet_state state;
        enum plip_nibble_state nibble;
        union {
                struct {
#if defined(__LITTLE_ENDIAN)
                        unsigned char lsb;
                        unsigned char msb;
#elif defined(__BIG_ENDIAN)
                        unsigned char msb;
                        unsigned char lsb;
#else
#error  "Please fix the endianness defines in <asm/byteorder.h>"
#endif
                } b;
                unsigned short h;
        } length;
        unsigned short byte;
        unsigned char  checksum;
        unsigned char  data;
        struct sk_buff *skb;
};

struct net_local {
        struct net_device_stats enet_stats;
        struct tq_struct immediate;
        struct tq_struct deferred;
        struct plip_local snd_data;
        struct plip_local rcv_data;
        struct pardevice *pardev;
        unsigned long  trigger;
        unsigned long  nibble;
        enum plip_connection_state connection;
        unsigned short timeout_count;
        int is_deferred;
        int port_owner;
        int should_relinquish;
        int (*orig_rebuild_header)(struct sk_buff *skb);
        spinlock_t lock;
};

/* Entry point of PLIP driver.
   Probe the hardware, and register/initialize the driver.

   PLIP is rather weird, because of the way it interacts with the parport
   system.  It is _not_ initialised from Space.c.  Instead, plip_init()
   is called, and that function makes up a "struct device" for each port, and
   then calls us here.

   */
__initfunc(int
plip_init_dev(struct device *dev, struct parport *pb))
{
        struct net_local *nl;
        struct pardevice *pardev;

        dev->irq = pb->irq;
        dev->base_addr = pb->base;

        if (pb->irq == -1) {
                printk(KERN_INFO "plip: %s has no IRQ.\n", pb->name);
                return -ENODEV;
        }

        pardev = parport_register_device(pb, dev->name, plip_preempt,
                                         plip_wakeup, plip_interrupt, 
                                         0, dev);

        if (!pardev)
                return -ENODEV;

        printk(KERN_INFO "%s", version);
        printk(KERN_INFO "%s: Parallel port at %#3lx, using IRQ %d\n", dev->name,
               dev->base_addr, dev->irq);

        /* Fill in the generic fields of the device structure. */
        ether_setup(dev);

        /* Then, override parts of it */
        dev->hard_start_xmit    = plip_tx_packet;
        dev->open               = plip_open;
        dev->stop               = plip_close;
        dev->get_stats          = plip_get_stats;
        dev->set_config         = plip_config;
        dev->do_ioctl           = plip_ioctl;
        dev->tx_queue_len       = 10;
        dev->flags              = IFF_POINTOPOINT|IFF_NOARP;
        memset(dev->dev_addr, 0xfc, ETH_ALEN);

        /* Set the private structure */
        dev->priv = kmalloc(sizeof (struct net_local), GFP_KERNEL);
        if (dev->priv == NULL) {
                printk(KERN_ERR "%s: out of memory\n", dev->name);
                parport_unregister_device(pardev);
                return -ENOMEM;
        }
        memset(dev->priv, 0, sizeof(struct net_local));
        nl = (struct net_local *) dev->priv;

        nl->orig_rebuild_header = dev->rebuild_header;
        dev->rebuild_header     = plip_rebuild_header;
        nl->pardev = pardev; 

        nl->port_owner = 0;

        /* Initialize constants */
        nl->trigger     = PLIP_TRIGGER_WAIT;
        nl->nibble      = PLIP_NIBBLE_WAIT;

        /* Initialize task queue structures */
        nl->immediate.next = NULL;
        nl->immediate.sync = 0;
        nl->immediate.routine = (void *)(void *)plip_bh;
        nl->immediate.data = dev;

        nl->deferred.next = NULL;
        nl->deferred.sync = 0;
        nl->deferred.routine = (void *)(void *)plip_kick_bh;
        nl->deferred.data = dev;
        spin_lock_init(&nl->lock);

        return 0;
}

/* Bottom half handler for the delayed request.
   This routine is kicked by do_timer().
   Request `plip_bh' to be invoked. */
static void
plip_kick_bh(struct device *dev)
{
        struct net_local *nl = (struct net_local *)dev->priv;

        if (nl->is_deferred) {
                queue_task(&nl->immediate, &tq_immediate);
                mark_bh(IMMEDIATE_BH);
        }
}

/* Forward declarations of internal routines */
static int plip_none(struct device *, struct net_local *,
                     struct plip_local *, struct plip_local *);
static int plip_receive_packet(struct device *, struct net_local *,
                               struct plip_local *, struct plip_local *);
static int plip_send_packet(struct device *, struct net_local *,
                            struct plip_local *, struct plip_local *);
static int plip_connection_close(struct device *, struct net_local *,
                                 struct plip_local *, struct plip_local *);
static int plip_error(struct device *, struct net_local *,
                      struct plip_local *, struct plip_local *);
static int plip_bh_timeout_error(struct device *dev, struct net_local *nl,
                                 struct plip_local *snd,
                                 struct plip_local *rcv,
                                 int error);

#define OK        0
#define TIMEOUT   1
#define ERROR     2
#define HS_TIMEOUT      3

typedef int (*plip_func)(struct device *dev, struct net_local *nl,
                         struct plip_local *snd, struct plip_local *rcv);

static plip_func connection_state_table[] =
{
        plip_none,
        plip_receive_packet,
        plip_send_packet,
        plip_connection_close,
        plip_error
};

/* Bottom half handler of PLIP. */
static void
plip_bh(struct device *dev)
{
        struct net_local *nl = (struct net_local *)dev->priv;
        struct plip_local *snd = &nl->snd_data;
        struct plip_local *rcv = &nl->rcv_data;
        plip_func f;
        int r;

        nl->is_deferred = 0;
        f = connection_state_table[nl->connection];
        if ((r = (*f)(dev, nl, snd, rcv)) != OK
            && (r = plip_bh_timeout_error(dev, nl, snd, rcv, r)) != OK) {
                nl->is_deferred = 1;
                queue_task(&nl->deferred, &tq_timer);
        }
}

static int
plip_bh_timeout_error(struct device *dev, struct net_local *nl,
                      struct plip_local *snd, struct plip_local *rcv,
                      int error)
{
        unsigned char c0;
        /*
         * This is tricky. If we got here from the beginning of send (either
         * with ERROR or HS_TIMEOUT) we have IRQ enabled. Otherwise it's
         * already disabled. With the old variant of {enable,disable}_irq()
         * extra disable_irq() was a no-op. Now it became mortal - it's
         * unbalanced and thus we'll never re-enable IRQ (until rmmod plip,
         * that is). So we have to treat HS_TIMEOUT and ERROR from send
         * in a special way.
         */

        spin_lock_irq(&nl->lock);
        if (nl->connection == PLIP_CN_SEND) {

                if (error != ERROR) { /* Timeout */
                        nl->timeout_count++;
                        if ((error == HS_TIMEOUT
                             && nl->timeout_count <= 10)
                            || nl->timeout_count <= 3) {
                                spin_unlock_irq(&nl->lock);
                                /* Try again later */
                                return TIMEOUT;
                        }
                        c0 = inb(PAR_STATUS(dev));
                        printk(KERN_WARNING "%s: transmit timeout(%d,%02x)\n",
                               dev->name, snd->state, c0);
                } else
                        error = HS_TIMEOUT;
                nl->enet_stats.tx_errors++;
                nl->enet_stats.tx_aborted_errors++;
        } else if (nl->connection == PLIP_CN_RECEIVE) {
                if (rcv->state == PLIP_PK_TRIGGER) {
                        /* Transmission was interrupted. */
                        spin_unlock_irq(&nl->lock);
                        return OK;
                }
                if (error != ERROR) { /* Timeout */
                        if (++nl->timeout_count <= 3) {
                                spin_unlock_irq(&nl->lock);
                                /* Try again later */
                                return TIMEOUT;
                        }
                        c0 = inb(PAR_STATUS(dev));
                        printk(KERN_WARNING "%s: receive timeout(%d,%02x)\n",
                               dev->name, rcv->state, c0);
                }
                nl->enet_stats.rx_dropped++;
        }
        rcv->state = PLIP_PK_DONE;
        if (rcv->skb) {
                kfree_skb(rcv->skb);
                rcv->skb = NULL;
        }
        snd->state = PLIP_PK_DONE;
        if (snd->skb) {
                dev_kfree_skb(snd->skb);
                snd->skb = NULL;
        }
        spin_unlock_irq(&nl->lock);
        if (error == HS_TIMEOUT) {
                DISABLE(dev->irq);
                synchronize_irq();
        }
        outb(PAR_INTR_OFF, PAR_CONTROL(dev));
        dev->tbusy = 1;
        nl->connection = PLIP_CN_ERROR;
        outb(0x00, PAR_DATA(dev));

        return TIMEOUT;
}

static int
plip_none(struct device *dev, struct net_local *nl,
          struct plip_local *snd, struct plip_local *rcv)
{
        return OK;
}

/* PLIP_RECEIVE --- receive a byte(two nibbles)
   Returns OK on success, TIMEOUT on timeout */
inline static int
plip_receive(unsigned short nibble_timeout, unsigned short status_addr,
             enum plip_nibble_state *ns_p, unsigned char *data_p)
{
        unsigned char c0, c1;
        unsigned int cx;

        switch (*ns_p) {
        case PLIP_NB_BEGIN:
                cx = nibble_timeout;
                while (1) {
                        c0 = inb(status_addr);
                        udelay(PLIP_DELAY_UNIT);
                        if ((c0 & 0x80) == 0) {
                                c1 = inb(status_addr);
                                if (c0 == c1)
                                        break;
                        }
                        if (--cx == 0)
                                return TIMEOUT;
                }
                *data_p = (c0 >> 3) & 0x0f;
                outb(0x10, --status_addr); /* send ACK */
                status_addr++;
                *ns_p = PLIP_NB_1;

        case PLIP_NB_1:
                cx = nibble_timeout;
                while (1) {
                        c0 = inb(status_addr);
                        udelay(PLIP_DELAY_UNIT);
                        if (c0 & 0x80) {
                                c1 = inb(status_addr);
                                if (c0 == c1)
                                        break;
                        }
                        if (--cx == 0)
                                return TIMEOUT;
                }
                *data_p |= (c0 << 1) & 0xf0;
                outb(0x00, --status_addr); /* send ACK */
                status_addr++;
                *ns_p = PLIP_NB_BEGIN;
        case PLIP_NB_2:
                break;
        }
        return OK;
}

/*
 *      Determine the packet's protocol ID. The rule here is that we 
 *      assume 802.3 if the type field is short enough to be a length.
 *      This is normal practice and works for any 'now in use' protocol.
 *
 *      PLIP is ethernet ish but the daddr might not be valid if unicast.
 *      PLIP fortunately has no bus architecture (its Point-to-point).
 *
 *      We can't fix the daddr thing as that quirk (more bug) is embedded
 *      in far too many old systems not all even running Linux.
 */
 
static unsigned short plip_type_trans(struct sk_buff *skb, struct device *dev)
{
        struct ethhdr *eth;
        unsigned char *rawp;
        
        skb->mac.raw=skb->data;
        skb_pull(skb,dev->hard_header_len);
        eth= skb->mac.ethernet;
        
        if(*eth->h_dest&1)
        {
                if(memcmp(eth->h_dest,dev->broadcast, ETH_ALEN)==0)
                        skb->pkt_type=PACKET_BROADCAST;
                else
                        skb->pkt_type=PACKET_MULTICAST;
        }
        
        /*
         *      This ALLMULTI check should be redundant by 1.4
         *      so don't forget to remove it.
         */
         
        if (ntohs(eth->h_proto) >= 1536)
                return eth->h_proto;
                
        rawp = skb->data;
        
        /*
         *      This is a magic hack to spot IPX packets. Older Novell breaks
         *      the protocol design and runs IPX over 802.3 without an 802.2 LLC
         *      layer. We look for FFFF which isn't a used 802.2 SSAP/DSAP. This
         *      won't work for fault tolerant netware but does for the rest.
         */
        if (*(unsigned short *)rawp == 0xFFFF)
                return htons(ETH_P_802_3);
                
        /*
         *      Real 802.2 LLC
         */
        return htons(ETH_P_802_2);
}


/* PLIP_RECEIVE_PACKET --- receive a packet */
static int
plip_receive_packet(struct device *dev, struct net_local *nl,
                    struct plip_local *snd, struct plip_local *rcv)
{
        unsigned short status_addr = PAR_STATUS(dev);
        unsigned short nibble_timeout = nl->nibble;
        unsigned char *lbuf;

        switch (rcv->state) {
        case PLIP_PK_TRIGGER:
                DISABLE(dev->irq);
                /* Don't need to synchronize irq, as we can safely ignore it */
                outb(PAR_INTR_OFF, PAR_CONTROL(dev));
                dev->interrupt = 0;
                outb(0x01, PAR_DATA(dev)); /* send ACK */
                if (net_debug > 2)
                        printk(KERN_DEBUG "%s: receive start\n", dev->name);
                rcv->state = PLIP_PK_LENGTH_LSB;
                rcv->nibble = PLIP_NB_BEGIN;

        case PLIP_PK_LENGTH_LSB:
                if (snd->state != PLIP_PK_DONE) {
                        if (plip_receive(nl->trigger, status_addr,
                                         &rcv->nibble, &rcv->length.b.lsb)) {
                                /* collision, here dev->tbusy == 1 */
                                rcv->state = PLIP_PK_DONE;
                                nl->is_deferred = 1;
                                nl->connection = PLIP_CN_SEND;
                                queue_task(&nl->deferred, &tq_timer);
                                outb(PAR_INTR_ON, PAR_CONTROL(dev));
                                ENABLE(dev->irq);
                                return OK;
                        }
                } else {
                        if (plip_receive(nibble_timeout, status_addr,
                                         &rcv->nibble, &rcv->length.b.lsb))
                                return TIMEOUT;
                }
                rcv->state = PLIP_PK_LENGTH_MSB;

        case PLIP_PK_LENGTH_MSB:
                if (plip_receive(nibble_timeout, status_addr,
                                 &rcv->nibble, &rcv->length.b.msb))
                        return TIMEOUT;
                if (rcv->length.h > dev->mtu + dev->hard_header_len
                    || rcv->length.h < 8) {
                        printk(KERN_WARNING "%s: bogus packet size %d.\n", dev->name, rcv->length.h);
                        return ERROR;
                }
                /* Malloc up new buffer. */
                rcv->skb = dev_alloc_skb(rcv->length.h);
                if (rcv->skb == NULL) {
                        printk(KERN_ERR "%s: Memory squeeze.\n", dev->name);
                        return ERROR;
                }
                skb_put(rcv->skb,rcv->length.h);
                rcv->skb->dev = dev;
                rcv->state = PLIP_PK_DATA;
                rcv->byte = 0;
                rcv->checksum = 0;

        case PLIP_PK_DATA:
                lbuf = rcv->skb->data;
                do
                        if (plip_receive(nibble_timeout, status_addr,
                                         &rcv->nibble, &lbuf[rcv->byte]))
                                return TIMEOUT;
                while (++rcv->byte < rcv->length.h);
                do
                        rcv->checksum += lbuf[--rcv->byte];
                while (rcv->byte);
                rcv->state = PLIP_PK_CHECKSUM;

        case PLIP_PK_CHECKSUM:
                if (plip_receive(nibble_timeout, status_addr,
                                 &rcv->nibble, &rcv->data))
                        return TIMEOUT;
                if (rcv->data != rcv->checksum) {
                        nl->enet_stats.rx_crc_errors++;
                        if (net_debug)
                                printk(KERN_DEBUG "%s: checksum error\n", dev->name);
                        return ERROR;
                }
                rcv->state = PLIP_PK_DONE;

        case PLIP_PK_DONE:
                /* Inform the upper layer for the arrival of a packet. */
                rcv->skb->protocol=plip_type_trans(rcv->skb, dev);
                netif_rx(rcv->skb);
                nl->enet_stats.rx_bytes += rcv->length.h;
                nl->enet_stats.rx_packets++;
                rcv->skb = NULL;
                if (net_debug > 2)
                        printk(KERN_DEBUG "%s: receive end\n", dev->name);

                /* Close the connection. */
                outb (0x00, PAR_DATA(dev));
                spin_lock_irq(&nl->lock);
                if (snd->state != PLIP_PK_DONE) {
                        nl->connection = PLIP_CN_SEND;
                        spin_unlock_irq(&nl->lock);
                        queue_task(&nl->immediate, &tq_immediate);
                        mark_bh(IMMEDIATE_BH);
                        outb(PAR_INTR_ON, PAR_CONTROL(dev));
                        ENABLE(dev->irq);
                        return OK;
                } else {
                        nl->connection = PLIP_CN_NONE;
                        spin_unlock_irq(&nl->lock);
                        outb(PAR_INTR_ON, PAR_CONTROL(dev));
                        ENABLE(dev->irq);
                        return OK;
                }
        }
        return OK;
}

/* PLIP_SEND --- send a byte (two nibbles)
   Returns OK on success, TIMEOUT when timeout    */
inline static int
plip_send(unsigned short nibble_timeout, unsigned short data_addr,
          enum plip_nibble_state *ns_p, unsigned char data)
{
        unsigned char c0;
        unsigned int cx;

        switch (*ns_p) {
        case PLIP_NB_BEGIN:
                outb((data & 0x0f), data_addr);
                *ns_p = PLIP_NB_1;

        case PLIP_NB_1:
                outb(0x10 | (data & 0x0f), data_addr);
                cx = nibble_timeout;
                data_addr++;
                while (1) {
                        c0 = inb(data_addr);
                        if ((c0 & 0x80) == 0)
                                break;
                        if (--cx == 0)
                                return TIMEOUT;
                        udelay(PLIP_DELAY_UNIT);
                }
                outb(0x10 | (data >> 4), --data_addr);
                *ns_p = PLIP_NB_2;

        case PLIP_NB_2:
                outb((data >> 4), data_addr);
                data_addr++;
                cx = nibble_timeout;
                while (1) {
                        c0 = inb(data_addr);
                        if (c0 & 0x80)
                                break;
                        if (--cx == 0)
                                return TIMEOUT;
                        udelay(PLIP_DELAY_UNIT);
                }
                data_addr--;
                *ns_p = PLIP_NB_BEGIN;
                return OK;
        }
        return OK;
}

/* PLIP_SEND_PACKET --- send a packet */
static int
plip_send_packet(struct device *dev, struct net_local *nl,
                 struct plip_local *snd, struct plip_local *rcv)
{
        unsigned short data_addr = PAR_DATA(dev);
        unsigned short nibble_timeout = nl->nibble;
        unsigned char *lbuf;
        unsigned char c0;
        unsigned int cx;

        if (snd->skb == NULL || (lbuf = snd->skb->data) == NULL) {
                printk(KERN_DEBUG "%s: send skb lost\n", dev->name);
                snd->state = PLIP_PK_DONE;
                snd->skb = NULL;
                return ERROR;
        }

        switch (snd->state) {
        case PLIP_PK_TRIGGER:
                if ((inb(PAR_STATUS(dev)) & 0xf8) != 0x80)
                        return HS_TIMEOUT;

                /* Trigger remote rx interrupt. */
                outb(0x08, data_addr);
                cx = nl->trigger;
                while (1) {
                        udelay(PLIP_DELAY_UNIT);
                        spin_lock_irq(&nl->lock);
                        if (nl->connection == PLIP_CN_RECEIVE) {
                                spin_unlock_irq(&nl->lock);
                                /* Interrupted. */
                                nl->enet_stats.collisions++;
                                return OK;
                        }
                        c0 = inb(PAR_STATUS(dev));
                        if (c0 & 0x08) {
                                spin_unlock_irq(&nl->lock);
                                DISABLE(dev->irq);
                                synchronize_irq();
                                if (nl->connection == PLIP_CN_RECEIVE) {
                                        /* Interrupted.
                                           We don't need to enable irq,
                                           as it is soon disabled.    */
                                        /* Yes, we do. New variant of
                                           {enable,disable}_irq *counts*
                                           them.  -- AV  */
                                        ENABLE(dev->irq);
                                        nl->enet_stats.collisions++;
                                        return OK;
                                }
                                outb(PAR_INTR_OFF, PAR_CONTROL(dev));
                                if (net_debug > 2)
                                        printk(KERN_DEBUG "%s: send start\n", dev->name);
                                snd->state = PLIP_PK_LENGTH_LSB;
                                snd->nibble = PLIP_NB_BEGIN;
                                nl->timeout_count = 0;
                                break;
                        }
                        spin_unlock_irq(&nl->lock);
                        if (--cx == 0) {
                                outb(0x00, data_addr);
                                return HS_TIMEOUT;
                        }
                }

        case PLIP_PK_LENGTH_LSB:
                if (plip_send(nibble_timeout, data_addr,
                              &snd->nibble, snd->length.b.lsb))
                        return TIMEOUT;
                snd->state = PLIP_PK_LENGTH_MSB;

        case PLIP_PK_LENGTH_MSB:
                if (plip_send(nibble_timeout, data_addr,
                              &snd->nibble, snd->length.b.msb))
                        return TIMEOUT;
                snd->state = PLIP_PK_DATA;
                snd->byte = 0;
                snd->checksum = 0;

        case PLIP_PK_DATA:
                do
                        if (plip_send(nibble_timeout, data_addr,
                                      &snd->nibble, lbuf[snd->byte]))
                                return TIMEOUT;
                while (++snd->byte < snd->length.h);
                do
                        snd->checksum += lbuf[--snd->byte];
                while (snd->byte);
                snd->state = PLIP_PK_CHECKSUM;

        case PLIP_PK_CHECKSUM:
                if (plip_send(nibble_timeout, data_addr,
                              &snd->nibble, snd->checksum))
                        return TIMEOUT;

                nl->enet_stats.tx_bytes += snd->skb->len;
                dev_kfree_skb(snd->skb);
                nl->enet_stats.tx_packets++;
                snd->state = PLIP_PK_DONE;

        case PLIP_PK_DONE:
                /* Close the connection */
                outb (0x00, data_addr);
                snd->skb = NULL;
                if (net_debug > 2)
                        printk(KERN_DEBUG "%s: send end\n", dev->name);
                nl->connection = PLIP_CN_CLOSING;
                nl->is_deferred = 1;
                queue_task(&nl->deferred, &tq_timer);
                outb(PAR_INTR_ON, PAR_CONTROL(dev));
                ENABLE(dev->irq);
                return OK;
        }
        return OK;
}

static int
plip_connection_close(struct device *dev, struct net_local *nl,
                      struct plip_local *snd, struct plip_local *rcv)
{
        spin_lock_irq(&nl->lock);
        if (nl->connection == PLIP_CN_CLOSING) {
                nl->connection = PLIP_CN_NONE;
                dev->tbusy = 0;
                mark_bh(NET_BH);
        }
        spin_unlock_irq(&nl->lock);
        if (nl->should_relinquish) {
                nl->should_relinquish = nl->port_owner = 0;
                parport_release(nl->pardev);
        }
        return OK;
}

/* PLIP_ERROR --- wait till other end settled */
static int
plip_error(struct device *dev, struct net_local *nl,
           struct plip_local *snd, struct plip_local *rcv)
{
        unsigned char status;

        status = inb(PAR_STATUS(dev));
        if ((status & 0xf8) == 0x80) {
                if (net_debug > 2)
                        printk(KERN_DEBUG "%s: reset interface.\n", dev->name);
                nl->connection = PLIP_CN_NONE;
                nl->should_relinquish = 0;
                dev->tbusy = 0;
                dev->interrupt = 0;
                outb(PAR_INTR_ON, PAR_CONTROL(dev));
                ENABLE(dev->irq);
                mark_bh(NET_BH);
        } else {
                nl->is_deferred = 1;
                queue_task(&nl->deferred, &tq_timer);
        }

        return OK;
}

/* Handle the parallel port interrupts. */
static void
plip_interrupt(int irq, void *dev_id, struct pt_regs * regs)
{
        struct device *dev = dev_id;
        struct net_local *nl;
        struct plip_local *rcv;
        unsigned char c0;

        if (dev == NULL) {
                printk(KERN_DEBUG "plip_interrupt: irq %d for unknown device.\n", irq);
                return;
        }

        nl = (struct net_local *)dev->priv;
        rcv = &nl->rcv_data;

        if (dev->interrupt)
                return;

        c0 = inb(PAR_STATUS(dev));
        if ((c0 & 0xf8) != 0xc0) {
                if (net_debug > 1)
                        printk(KERN_DEBUG "%s: spurious interrupt\n", dev->name);
                return;
        }
        dev->interrupt = 1;
        if (net_debug > 3)
                printk(KERN_DEBUG "%s: interrupt.\n", dev->name);

        spin_lock_irq(&nl->lock);
        switch (nl->connection) {
        case PLIP_CN_CLOSING:
                dev->tbusy = 0;
        case PLIP_CN_NONE:
        case PLIP_CN_SEND:
                dev->last_rx = jiffies;
                rcv->state = PLIP_PK_TRIGGER;
                nl->connection = PLIP_CN_RECEIVE;
                nl->timeout_count = 0;
                queue_task(&nl->immediate, &tq_immediate);
                mark_bh(IMMEDIATE_BH);
                spin_unlock_irq(&nl->lock);
                break;

        case PLIP_CN_RECEIVE:
                /* May occur because there is race condition
                   around test and set of dev->interrupt.
                   Ignore this interrupt. */
                spin_unlock_irq(&nl->lock);
                break;

        case PLIP_CN_ERROR:
                spin_unlock_irq(&nl->lock);
                printk(KERN_ERR "%s: receive interrupt in error state\n", dev->name);
                break;
        }
}

/* We don't need to send arp, for plip is point-to-point. */
static int
plip_rebuild_header(struct sk_buff *skb)
{
        struct device *dev = skb->dev;
        struct net_local *nl = (struct net_local *)dev->priv;
        struct ethhdr *eth = (struct ethhdr *)skb->data;

        if ((dev->flags & IFF_NOARP)==0)
                return nl->orig_rebuild_header(skb);

        memcpy(eth->h_source, dev->dev_addr, dev->addr_len);
        memcpy(eth->h_dest, dev->broadcast, dev->addr_len);
        return 0;
}

static int
plip_tx_packet(struct sk_buff *skb, struct device *dev)
{
        struct net_local *nl = (struct net_local *)dev->priv;
        struct plip_local *snd = &nl->snd_data;

        if (dev->tbusy)
                return 1;

        /* We may need to grab the bus */
        if (!nl->port_owner) {
                if (parport_claim(nl->pardev))
                        return 1;
                nl->port_owner = 1;
        }

        if (test_and_set_bit(0, (void*)&dev->tbusy) != 0) {
                printk(KERN_WARNING "%s: Transmitter access conflict.\n", dev->name);
                return 1;
        }

        if (skb->len > dev->mtu + dev->hard_header_len) {
                printk(KERN_WARNING "%s: packet too big, %d.\n", dev->name, (int)skb->len);
                dev->tbusy = 0;
                return 0;
        }

        if (net_debug > 2)
                printk(KERN_DEBUG "%s: send request\n", dev->name);

        spin_lock_irq(&nl->lock);
        dev->trans_start = jiffies;
        snd->skb = skb;
        snd->length.h = skb->len;
        snd->state = PLIP_PK_TRIGGER;
        if (nl->connection == PLIP_CN_NONE) {
                nl->connection = PLIP_CN_SEND;
                nl->timeout_count = 0;
        }
        queue_task(&nl->immediate, &tq_immediate);
        mark_bh(IMMEDIATE_BH);
        spin_unlock_irq(&nl->lock);

        return 0;
}

/* Open/initialize the board.  This is called (in the current kernel)
   sometime after booting when the 'ifconfig' program is run.

   This routine gets exclusive access to the parallel port by allocating
   its IRQ line.
 */
static int
plip_open(struct device *dev)
{
        struct net_local *nl = (struct net_local *)dev->priv;
        struct in_device *in_dev;

        /* Grab the port */
        if (!nl->port_owner) {
                if (parport_claim(nl->pardev)) return -EAGAIN;
                nl->port_owner = 1;
        }

        nl->should_relinquish = 0;

        /* Clear the data port. */
        outb (0x00, PAR_DATA(dev));

        /* Enable rx interrupt. */
        outb(PAR_INTR_ON, PAR_CONTROL(dev));

        /* Initialize the state machine. */
        nl->rcv_data.state = nl->snd_data.state = PLIP_PK_DONE;
        nl->rcv_data.skb = nl->snd_data.skb = NULL;
        nl->connection = PLIP_CN_NONE;
        nl->is_deferred = 0;

        /* Fill in the MAC-level header.
           (ab)Use "dev->broadcast" to store point-to-point MAC address.

           PLIP doesn't have a real mac address, but we need to create one
           to be DOS compatible.  */
        memset(dev->dev_addr,  0xfc, ETH_ALEN);
        memset(dev->broadcast, 0xfc, ETH_ALEN);

        if ((in_dev=dev->ip_ptr) != NULL) {
                /*
                 *      Any address will do - we take the first
                 */
                struct in_ifaddr *ifa=in_dev->ifa_list;
                if (ifa != NULL) {
                        memcpy(dev->dev_addr+2, &ifa->ifa_local, 4);
                        memcpy(dev->broadcast+2, &ifa->ifa_address, 4);
                }
        }

        dev->interrupt = 0;
        dev->start = 1;
        dev->tbusy = 0;

        MOD_INC_USE_COUNT;
        return 0;
}

/* The inverse routine to plip_open (). */
static int
plip_close(struct device *dev)
{
        struct net_local *nl = (struct net_local *)dev->priv;
        struct plip_local *snd = &nl->snd_data;
        struct plip_local *rcv = &nl->rcv_data;

        dev->tbusy = 1;
        dev->start = 0;
        DISABLE(dev->irq);
        synchronize_irq();

#ifdef NOTDEF
        outb(0x00, PAR_DATA(dev));
#endif
        nl->is_deferred = 0;
        nl->connection = PLIP_CN_NONE;
        if (nl->port_owner) {
                parport_release(nl->pardev);
                nl->port_owner = 0;
        }

        snd->state = PLIP_PK_DONE;
        if (snd->skb) {
                dev_kfree_skb(snd->skb);
                snd->skb = NULL;
        }
        rcv->state = PLIP_PK_DONE;
        if (rcv->skb) {
                kfree_skb(rcv->skb);
                rcv->skb = NULL;
        }

#ifdef NOTDEF
        /* Reset. */
        outb(0x00, PAR_CONTROL(dev));
#endif
        MOD_DEC_USE_COUNT;
        return 0;
}

static int
plip_preempt(void *handle)
{
        struct device *dev = (struct device *)handle;
        struct net_local *nl = (struct net_local *)dev->priv;

        /* Stand our ground if a datagram is on the wire */
        if (nl->connection != PLIP_CN_NONE) {
                nl->should_relinquish = 1;
                return 1;
        }

        nl->port_owner = 0;     /* Remember that we released the bus */
        return 0;
}

static void
plip_wakeup(void *handle)
{
        struct device *dev = (struct device *)handle;
        struct net_local *nl = (struct net_local *)dev->priv;

        if (nl->port_owner) {
                /* Why are we being woken up? */
                printk(KERN_DEBUG "%s: why am I being woken up?\n", dev->name);
                if (!parport_claim(nl->pardev))
                        /* bus_owner is already set (but why?) */
                        printk(KERN_DEBUG "%s: I'm broken.\n", dev->name);
                else
                        return;
        }
        
        if (!(dev->flags & IFF_UP))
                /* Don't need the port when the interface is down */
                return;

        if (!parport_claim(nl->pardev)) {
                nl->port_owner = 1;
                /* Clear the data port. */
                outb (0x00, PAR_DATA(dev));
        }

        return;
}

static struct n