/* * xircom_cb: A driver for the (tulip-like) Xircom Cardbus ethernet cards * * This software is (C) by the respective authors, and licensed under the GPL * License. * * Written by Arjan van de Ven for Red Hat, Inc. * Based on work by Jeff Garzik, Doug Ledford and Donald Becker * * This software may be used and distributed according to the terms * of the GNU General Public License, incorporated herein by reference. * * * $Id: xircom_cb.c,v 1.33 2001/03/19 14:02:07 arjanv Exp $ */ #define pr_fmt(fmt) … #include <linux/module.h> #include <linux/kernel.h> #include <linux/string.h> #include <linux/errno.h> #include <linux/ioport.h> #include <linux/slab.h> #include <linux/interrupt.h> #include <linux/pci.h> #include <linux/netdevice.h> #include <linux/etherdevice.h> #include <linux/skbuff.h> #include <linux/delay.h> #include <linux/bitops.h> #include <linux/uaccess.h> #include <asm/io.h> #ifdef CONFIG_NET_POLL_CONTROLLER #include <asm/irq.h> #endif MODULE_DESCRIPTION(…) …; MODULE_AUTHOR(…) …; MODULE_LICENSE(…) …; #define xw32(reg, val) … #define xr32(reg) … #define xr8(reg) … /* IO registers on the card, offsets */ #define CSR0 … #define CSR1 … #define CSR2 … #define CSR3 … #define CSR4 … #define CSR5 … #define CSR6 … #define CSR7 … #define CSR8 … #define CSR9 … #define CSR10 … #define CSR11 … #define CSR12 … #define CSR13 … #define CSR14 … #define CSR15 … #define CSR16 … /* PCI registers */ #define PCI_POWERMGMT … /* Offsets of the buffers within the descriptor pages, in bytes */ #define NUMDESCRIPTORS … static int bufferoffsets[NUMDESCRIPTORS] = …; struct xircom_private { … }; /* Function prototypes */ static int xircom_probe(struct pci_dev *pdev, const struct pci_device_id *id); static void xircom_remove(struct pci_dev *pdev); static irqreturn_t xircom_interrupt(int irq, void *dev_instance); static netdev_tx_t xircom_start_xmit(struct sk_buff *skb, struct net_device *dev); static int xircom_open(struct net_device *dev); static int xircom_close(struct net_device *dev); static void xircom_up(struct xircom_private *card); #ifdef CONFIG_NET_POLL_CONTROLLER static void xircom_poll_controller(struct net_device *dev); #endif static void investigate_read_descriptor(struct net_device *dev,struct xircom_private *card, int descnr, unsigned int bufferoffset); static void investigate_write_descriptor(struct net_device *dev, struct xircom_private *card, int descnr, unsigned int bufferoffset); static void read_mac_address(struct xircom_private *card); static void transceiver_voodoo(struct xircom_private *card); static void initialize_card(struct xircom_private *card); static void trigger_transmit(struct xircom_private *card); static void trigger_receive(struct xircom_private *card); static void setup_descriptors(struct xircom_private *card); static void remove_descriptors(struct xircom_private *card); static int link_status_changed(struct xircom_private *card); static void activate_receiver(struct xircom_private *card); static void deactivate_receiver(struct xircom_private *card); static void activate_transmitter(struct xircom_private *card); static void deactivate_transmitter(struct xircom_private *card); static void enable_transmit_interrupt(struct xircom_private *card); static void enable_receive_interrupt(struct xircom_private *card); static void enable_link_interrupt(struct xircom_private *card); static void disable_all_interrupts(struct xircom_private *card); static int link_status(struct xircom_private *card); static const struct pci_device_id xircom_pci_table[] = …; MODULE_DEVICE_TABLE(pci, xircom_pci_table); static struct pci_driver xircom_ops = …; #if defined DEBUG && DEBUG > 1 static void print_binary(unsigned int number) { int i,i2; char buffer[64]; memset(buffer,0,64); i2=0; for (i=31;i>=0;i--) { if (number & (1<<i)) buffer[i2++]='1'; else buffer[i2++]='0'; if ((i&3)==0) buffer[i2++]=' '; } pr_debug("%s\n",buffer); } #endif static const struct net_device_ops netdev_ops = …; /* xircom_probe is the code that gets called on device insertion. it sets up the hardware and registers the device to the networklayer. TODO: Send 1 or 2 "dummy" packets here as the card seems to discard the first two packets that get send, and pump hates that. */ static int xircom_probe(struct pci_dev *pdev, const struct pci_device_id *id) { … } /* xircom_remove is called on module-unload or on device-eject. it unregisters the irq, io-region and network device. Interrupts and such are already stopped in the "ifconfig ethX down" code. */ static void xircom_remove(struct pci_dev *pdev) { … } static irqreturn_t xircom_interrupt(int irq, void *dev_instance) { … } static netdev_tx_t xircom_start_xmit(struct sk_buff *skb, struct net_device *dev) { … } static int xircom_open(struct net_device *dev) { … } static int xircom_close(struct net_device *dev) { … } #ifdef CONFIG_NET_POLL_CONTROLLER static void xircom_poll_controller(struct net_device *dev) { … } #endif static void initialize_card(struct xircom_private *card) { … } /* trigger_transmit causes the card to check for frames to be transmitted. This is accomplished by writing to the CSR1 port. The documentation claims that the act of writing is sufficient and that the value is ignored; I chose zero. */ static void trigger_transmit(struct xircom_private *card) { … } /* trigger_receive causes the card to check for empty frames in the descriptor list in which packets can be received. This is accomplished by writing to the CSR2 port. The documentation claims that the act of writing is sufficient and that the value is ignored; I chose zero. */ static void trigger_receive(struct xircom_private *card) { … } /* setup_descriptors initializes the send and receive buffers to be valid descriptors and programs the addresses into the card. */ static void setup_descriptors(struct xircom_private *card) { … } /* remove_descriptors informs the card the descriptors are no longer valid by setting the address in the card to 0x00. */ static void remove_descriptors(struct xircom_private *card) { … } /* link_status_changed returns 1 if the card has indicated that the link status has changed. The new link status has to be read from CSR12. This function also clears the status-bit. */ static int link_status_changed(struct xircom_private *card) { … } /* transmit_active returns 1 if the transmitter on the card is in a non-stopped state. */ static int transmit_active(struct xircom_private *card) { … } /* receive_active returns 1 if the receiver on the card is in a non-stopped state. */ static int receive_active(struct xircom_private *card) { … } /* activate_receiver enables the receiver on the card. Before being allowed to active the receiver, the receiver must be completely de-activated. To achieve this, this code actually disables the receiver first; then it waits for the receiver to become inactive, then it activates the receiver and then it waits for the receiver to be active. must be called with the lock held and interrupts disabled. */ static void activate_receiver(struct xircom_private *card) { … } /* deactivate_receiver disables the receiver on the card. To achieve this this code disables the receiver first; then it waits for the receiver to become inactive. must be called with the lock held and interrupts disabled. */ static void deactivate_receiver(struct xircom_private *card) { … } /* activate_transmitter enables the transmitter on the card. Before being allowed to active the transmitter, the transmitter must be completely de-activated. To achieve this, this code actually disables the transmitter first; then it waits for the transmitter to become inactive, then it activates the transmitter and then it waits for the transmitter to be active again. must be called with the lock held and interrupts disabled. */ static void activate_transmitter(struct xircom_private *card) { … } /* deactivate_transmitter disables the transmitter on the card. To achieve this this code disables the transmitter first; then it waits for the transmitter to become inactive. must be called with the lock held and interrupts disabled. */ static void deactivate_transmitter(struct xircom_private *card) { … } /* enable_transmit_interrupt enables the transmit interrupt must be called with the lock held and interrupts disabled. */ static void enable_transmit_interrupt(struct xircom_private *card) { … } /* enable_receive_interrupt enables the receive interrupt must be called with the lock held and interrupts disabled. */ static void enable_receive_interrupt(struct xircom_private *card) { … } /* enable_link_interrupt enables the link status change interrupt must be called with the lock held and interrupts disabled. */ static void enable_link_interrupt(struct xircom_private *card) { … } /* disable_all_interrupts disables all interrupts must be called with the lock held and interrupts disabled. */ static void disable_all_interrupts(struct xircom_private *card) { … } /* enable_common_interrupts enables several weird interrupts must be called with the lock held and interrupts disabled. */ static void enable_common_interrupts(struct xircom_private *card) { … } /* enable_promisc starts promisc mode must be called with the lock held and interrupts disabled. */ static int enable_promisc(struct xircom_private *card) { … } /* link_status() checks the links status and will return 0 for no link, 10 for 10mbit link and 100 for.. guess what. Must be called in locked state with interrupts disabled */ static int link_status(struct xircom_private *card) { … } /* read_mac_address() reads the MAC address from the NIC and stores it in the "dev" structure. This function will take the spinlock itself and can, as a result, not be called with the lock helt. */ static void read_mac_address(struct xircom_private *card) { … } /* transceiver_voodoo() enables the external UTP plug thingy. it's called voodoo as I stole this code and cannot cross-reference it with the specification. */ static void transceiver_voodoo(struct xircom_private *card) { … } static void xircom_up(struct xircom_private *card) { … } /* Bufferoffset is in BYTES */ static void investigate_read_descriptor(struct net_device *dev, struct xircom_private *card, int descnr, unsigned int bufferoffset) { … } /* Bufferoffset is in BYTES */ static void investigate_write_descriptor(struct net_device *dev, struct xircom_private *card, int descnr, unsigned int bufferoffset) { … } module_pci_driver(…) …;
Codebase Browser
linux