---

rtl8139.c File Reference

RTL8139C(L) single chip fast ethernet controller driver. More...

#include <const.h>
#include <errno.h>
#include <stdlib.h>
#include <string.h>
#include <arch/i386.h>
#include <arch/interrupt.h>
#include <arch/mem.h>
#include <arch/paging.h>
#include <kernel/clock.h>
#include <kernel/dma.h>
#include <kernel/kmalloc.h>
#include <kernel/pci.h>
#include <kernel/semaphore.h>
#include <kernel/video.h>
#include <net/arp.h>
#include <net/eth.h>
#include <net/ip.h>
#include <net/network.h>
#include <net/rtl8139.h>

Go to the source code of this file.

Enumerations
enum	RTL8139_registers {   MAC0 = 0, MAR0 = 8, TxStatus0 = 0x10, TxAddr0 = 0x20,   RxBuf = 0x30, RxEarlyCnt = 0x34, RxEarlyStatus = 0x36, ChipCmd = 0x37,   RxBufPtr = 0x38, RxBufAddr = 0x3A, IntrMask = 0x3C, IntrStatus = 0x3E,   TxConfig = 0x40, RxConfig = 0x44, Timer = 0x48, RxMissed = 0x4C,   Cfg9346 = 0x50, Config0 = 0x51, Config1 = 0x52, TimerIntrReg = 0x54,   MediaStatus = 0x58, Config3 = 0x59, HltClk = 0x5B, MultiIntr = 0x5C,   RevisionID = 0x5E, TxSummary = 0x60, MII_BMCR = 0x62, MII_BMSR = 0x64,   NWayAdvert = 0x66, NWayLPAR = 0x68, NWayExpansion = 0x6A, DisconnectCnt = 0x6C,   FalseCarrierCnt = 0x6E, NWayTestReg = 0x70, RxCnt = 0x72, CSCR = 0x74,   PhyParm1 = 0x78, TwisterParm = 0x7c, PhyParm2 = 0x80 }
	Symbolic RTL8139 offsets to registers. More...
enum	ChipCmdBits { CmdReset = 0x10, CmdRxEnb = 0x08, CmdTxEnb = 0x04, RxBufEmpty = 0x01 }
enum	IntrStatusBits {   PCIErr = 0x8000, PCSTimeout = 0x4000, CableLenChange = 0x2000, RxFIFOOver = 0x40,   RxUnderrun = 0x20, RxOverflow = 0x10, TxErr = 0x08, TxOK = 0x04,   RxErr = 0x02, RxOK = 0x01, IntrDefault = RxOK | TxOK }
	Interrupt Status Register bits. More...
enum	TxStatusBits {   TxHostOwns = 0x2000, TxUnderrun = 0x4000, TxStatOK = 0x8000, TxOutOfWindow = 0x20000000,   TxAborted = 0x40000000, TxCarrierLost = 0x80000000 }
	Transmit Status Register bits. More...
enum	RxStatusBits {   RxMulticast = 0x8000, RxPhysical = 0x4000, RxBroadcast = 0x2000, RxBadSymbol = 0x0020,   RxRunt = 0x0010, RxTooLong = 0x0008, RxCRCErr = 0x0004, RxBadAlign = 0x0002,   RxStatusOK = 0x0001 }
	Receive Status Register bits. More...
enum	MediaStatusBits {   MSRTxFlowEnable = 0x80, MSRRxFlowEnable = 0x40, MSRSpeed10 = 0x08, MSRLinkFail = 0x04,   MSRRxPauseFlag = 0x02, MSRTxPauseFlag = 0x01 }
	Media Status Register bits. More...
enum	MIIBMCRBits {   BMCRReset = 0x8000, BMCRSpeed100 = 0x2000, BMCRNWayEnable = 0x1000, BMCRRestartNWay = 0x0200,   BMCRDuplex = 0x0100 }
enum	CSCRBits {   CSCR_LinkOKBit = 0x0400, CSCR_LinkChangeBit = 0x0800, CSCR_LinkStatusBits = 0x0f000, CSCR_LinkDownOffCmd = 0x003c0,   CSCR_LinkDownCmd = 0x0f3c0 }
enum	rx_mode_bits {   RxCfgWrap = 0x80, AcceptErr = 0x20, AcceptRunt = 0x10, AcceptBroadcast = 0x08,   AcceptMulticast = 0x04, AcceptMyPhys = 0x02, AcceptAllPhys = 0x01 }
	Bits in Receive Configuration Register. More...
Functions
void	rtl8139_close (rtl8139_t **rtl)
	Halt the RTL8139 card and free the logical device. Parameters: rtl  An indirect pointer to the RTL8139 structure. Must be passed as an indirect pointer because it will be modified inside this routine!!!
unsigned	rtl8139_read_eeprom (rtl8139_t *rtl, unsigned location)
	Read RTL8139 informations from the EEPROM. Parameters: rtl  The RTL8139 structure. location  The location in the EEPROM to read. Returns: The value read from the EEPROM.
void	rtl8139_promisc (rtl8139_t *rtl, bool on)
	Enable/disable the promiscuous mode for the RTL8139 card. Parameters: rtl  The RTL8139 structure. on  TRUE enable the promiscuous mode; FALSE disable the promiscuous mode.
void	rtl8139_reset (rtl8139_t *rtl)
	Reset the RTL8139 ethernet card. Parameters: rtl  The RTL8139 structure.
int	rtl8139_init (bool promisc)
	Initialize the RTL8139 driver. Parameters: promisc  TRUE initialize the card and put it in promiscuous mode; FALSE initialize the card and don't put it in promiscuous mode. Returns: 0 if we can successfully enable the RTL8139 ethernet card; -ENXIO if the device if not present on PCI bus; -EIO if we cannot read ethernet card informations;.
uint8_t *	get_eth_mac_addr ()
	Get the MAC hardware address of the RTL8139 ethernet card. Returns: A pointer to the MAC address value. Exceptions: NULL  if a RTL8139 card has not been initialized.
rtl8139_t *	get_rtl8139_device ()
	Get the pointer of the RTL8139 device structure. Returns: a pointer of the RTL8139 structure if it has been initialized; 0 if the RTL8139 card has not been initialized.
int	send_rtl8139_packet (rtl8139_t *rtl, const void *data, size_t len)
	Send an ethernet packet to the physiscal layer. Parameters: rtl  The RTL8139 structure. data  The data to be sent. len  The size of the data to be sent in bytes. Returns: The number of bytes sent, or -1 if an error occurred.
void	rtl8139_handle_tx (rtl8139_t *rtl)
	Handle a transmitted packet event. Parameters: rtl  The RTL8139 structure.
void	rtl8139_handle_rx (rtl8139_t *rtl)
	Handle a received packet event. Parameters: rtl  The RTL8139 structure.
void	rtl8139_handler ()
	The RTL8139 interrupt handler routine. It is invoked every time that an ethernet packet is received or when a packet has been transmitted.
void	rtl8139_dump_info (rtl8139_t *rtl)
	Print the current RTL8139 card configuration on the console. Parameters: rtl  The RTL8139 structure.
Variables
rtl8139_t *	rtl = NULL
	Pointer to the RTL8139 structure.

---

Detailed Description

RTL8139C(L) single chip fast ethernet controller driver.

Author:

Andrea Righi <drizzt@inwind.it>

Date:

Last update: 2003-11-09

Note:

Copyright (©) 2003 Andrea Righi

Based on drivers/net/8139too.c from Linux. -Andrea Righi.

Definition in file rtl8139.c.

---

Enumeration Type Documentation

enum ChipCmdBits

Enumeration values: CmdReset  CmdRxEnb  CmdTxEnb  RxBufEmpty  Definition at line 93 of file rtl8139.c. { CmdReset=0x10, CmdRxEnb=0x08, CmdTxEnb=0x04, RxBufEmpty=0x01, };

enum CSCRBits

Enumeration values: CSCR_LinkOKBit  CSCR_LinkChangeBit  CSCR_LinkStatusBits  CSCR_LinkDownOffCmd  CSCR_LinkDownCmd  Definition at line 162 of file rtl8139.c. { CSCR_LinkOKBit=0x0400, CSCR_LinkChangeBit=0x0800, CSCR_LinkStatusBits=0x0f000, CSCR_LinkDownOffCmd=0x003c0, CSCR_LinkDownCmd=0x0f3c0, };

enum IntrStatusBits

Interrupt Status Register bits. Enumeration values: PCIErr  PCSTimeout  CableLenChange  RxFIFOOver  RxUnderrun  RxOverflow  TxErr  TxOK  RxErr  RxOK  IntrDefault  Definition at line 102 of file rtl8139.c. { PCIErr=0x8000, PCSTimeout=0x4000, CableLenChange= 0x2000, RxFIFOOver=0x40, RxUnderrun=0x20, RxOverflow=0x10, TxErr=0x08, TxOK=0x04, RxErr=0x02, RxOK=0x01, IntrDefault = RxOK | TxOK, };

enum MediaStatusBits

Media Status Register bits. Enumeration values: MSRTxFlowEnable  MSRRxFlowEnable  MSRSpeed10  MSRLinkFail  MSRRxPauseFlag  MSRTxPauseFlag  Definition at line 143 of file rtl8139.c. { MSRTxFlowEnable=0x80, MSRRxFlowEnable=0x40, MSRSpeed10=0x08, MSRLinkFail=0x04, MSRRxPauseFlag=0x02, MSRTxPauseFlag=0x01, };

enum MIIBMCRBits

Enumeration values: BMCRReset  BMCRSpeed100  BMCRNWayEnable  BMCRRestartNWay  BMCRDuplex  Definition at line 153 of file rtl8139.c. { BMCRReset=0x8000, BMCRSpeed100=0x2000, BMCRNWayEnable=0x1000, BMCRRestartNWay=0x0200, BMCRDuplex=0x0100, };

enum RTL8139_registers

Symbolic RTL8139 offsets to registers. Enumeration values: MAC0  Ethernet hardware address. MAR0  Multicast filter. TxStatus0  Transmit status: 4 32bit registers. TxAddr0  Tx descriptors (also 4 32bit). RxBuf  RxEarlyCnt  RxEarlyStatus  ChipCmd  RxBufPtr  RxBufAddr  IntrMask  IntrStatus  TxConfig  RxConfig  Timer  General-purpose counter. RxMissed  24 bits valid, write clears. Cfg9346  Config0  Config1  TimerIntrReg  INTR if gp counter reaches this value. MediaStatus  Config3  HltClk  MultiIntr  RevisionID  Revision of the RTL8139 chip. TxSummary  MII_BMCR  MII_BMSR  NWayAdvert  NWayLPAR  NWayExpansion  DisconnectCnt  FalseCarrierCnt  NWayTestReg  RxCnt  Packet received counter. CSCR  Chip status and configuration register. PhyParm1  Undocumented. TwisterParm  Undocumented. PhyParm2  Undocumented. Definition at line 36 of file rtl8139.c. { MAC0=0, //!< Ethernet hardware address. MAR0=8, //!< Multicast filter. TxStatus0=0x10, //!< Transmit status: 4 32bit registers. TxAddr0=0x20, //!< Tx descriptors (also 4 32bit). RxBuf=0x30, RxEarlyCnt=0x34, RxEarlyStatus=0x36, ChipCmd=0x37, RxBufPtr=0x38, RxBufAddr=0x3A, IntrMask=0x3C, IntrStatus=0x3E, TxConfig=0x40, RxConfig=0x44, Timer=0x48, //!< General-purpose counter. RxMissed=0x4C, //!< 24 bits valid, write clears. Cfg9346=0x50, Config0=0x51, Config1=0x52, TimerIntrReg=0x54, //!< INTR if gp counter reaches this value. MediaStatus=0x58, Config3=0x59, HltClk=0x5B, MultiIntr=0x5C, RevisionID=0x5E, //!< Revision of the RTL8139 chip. TxSummary=0x60, MII_BMCR=0x62, MII_BMSR=0x64, NWayAdvert=0x66, NWayLPAR=0x68, NWayExpansion=0x6A, DisconnectCnt=0x6C, FalseCarrierCnt=0x6E, NWayTestReg=0x70, RxCnt=0x72, //!< Packet received counter. CSCR=0x74, //!< Chip status and configuration register. PhyParm1=0x78, //!< Undocumented. TwisterParm=0x7c, //!< Undocumented. PhyParm2=0x80, //!< Undocumented. // From 0x84 onwards are a number of power management/wakeup // // frame definitions we will probably never need to know about. // };

enum rx_mode_bits

Bits in Receive Configuration Register. Enumeration values: RxCfgWrap  AcceptErr  AcceptRunt  AcceptBroadcast  AcceptMulticast  AcceptMyPhys  AcceptAllPhys  Definition at line 172 of file rtl8139.c. { RxCfgWrap=0x80, AcceptErr=0x20, AcceptRunt=0x10, AcceptBroadcast=0x08, AcceptMulticast=0x04, AcceptMyPhys=0x02, AcceptAllPhys=0x01, };

enum RxStatusBits

Receive Status Register bits. Enumeration values: RxMulticast  RxPhysical  RxBroadcast  RxBadSymbol  RxRunt  RxTooLong  RxCRCErr  RxBadAlign  RxStatusOK  Definition at line 129 of file rtl8139.c. { RxMulticast=0x8000, RxPhysical=0x4000, RxBroadcast=0x2000, RxBadSymbol=0x0020, RxRunt=0x0010, RxTooLong=0x0008, RxCRCErr=0x0004, RxBadAlign=0x0002, RxStatusOK=0x0001, };

enum TxStatusBits

Transmit Status Register bits. Enumeration values: TxHostOwns  TxUnderrun  TxStatOK  TxOutOfWindow  TxAborted  TxCarrierLost  Definition at line 118 of file rtl8139.c. { TxHostOwns=0x2000, TxUnderrun=0x4000, TxStatOK=0x8000, TxOutOfWindow=0x20000000, TxAborted=0x40000000, TxCarrierLost=0x80000000, };

---

Function Documentation

uint8_t* get_eth_mac_addr (    )

Get the MAC hardware address of the RTL8139 ethernet card. Returns: A pointer to the MAC address value. Exceptions: NULL  if a RTL8139 card has not been initialized. Definition at line 455 of file rtl8139.c. { if (rtl) return(rtl->station_address); else return(NULL); }

rtl8139_t* get_rtl8139_device (    )

Get the pointer of the RTL8139 device structure. Returns: a pointer of the RTL8139 structure if it has been initialized; 0 if the RTL8139 card has not been initialized. Definition at line 468 of file rtl8139.c. { return( rtl ); }

void rtl8139_close (  rtl8139_t **    rtl )

Halt the RTL8139 card and free the logical device. Parameters: rtl  An indirect pointer to the RTL8139 structure. Must be passed as an indirect pointer because it will be modified inside this routine!!! Definition at line 191 of file rtl8139.c. { // Disable interrupts by clearing the interrupt mask // out16((*rtl)->iobase + IntrMask, 0); // Stop the chip's Tx and Rx DMA processes // out((*rtl)->iobase + ChipCmd, 0); // Put the chip in low-power mode // out((*rtl)->iobase + Cfg9346, 0xC0); out((*rtl)->iobase + Config1, 0x03); // 'R' would leave the clock running // out((*rtl)->iobase + HltClk, 'H'); if ( (*rtl) != NULL ) { // Disable the IRQ line // disable_IRQ((*rtl)->irq); // Deallocate the ring buffers // dma_phys_free((*rtl)->rx_phys, RX_BUF_LEN); dma_phys_free((*rtl)->tx_phys, TX_BUF_SIZE*NUM_TX_DESC); // Deallocate the logical structure // kfree((*rtl)); *rtl = NULL; } }

void rtl8139_dump_info (  rtl8139_t *    rtl )

Print the current RTL8139 card configuration on the console. Parameters: rtl  The RTL8139 structure. Definition at line 654 of file rtl8139.c. { in_addr_t ip, netmask, ip_bcast; if ( !rtl ) { // The card is not configured // kprintf("\n\rUsage: ifconfig [up|down]"); kprintf("\n\rRTL8139: ethernet card not configured!\n\r"); return; } // Dump the device informations // kprintf("\n\rRTL8139: card configured @ I/O base=%04X IRQ=%u", rtl->iobase, rtl->irq); // Dump the MAC address // kprintf("\n\rRTL8139: MAC address %02x:%02x:%02x:%02x:%02x:%02x", rtl->station_address[0], rtl->station_address[1], rtl->station_address[2], rtl->station_address[3], rtl->station_address[4], rtl->station_address[5] ); // Dump the media informations // kprintf("\n\rRTL8139: %sMbps %s-duplex", rtl->speed10 ? "10" : "100", rtl->fullduplex ? "full" : "half" ); // Print the promiscuous mode flag // kprintf("\n\rRTL8139: promiscuous mode %s", (rtl->promisc) ? "ENABLED" : "DISABLED"); // Print virtual memory rings pointers // kprintf("\n\rRTL8139: rx_ring=%p<->%p, tx_ring=%p<->%p", rtl->rx_ring, rtl->rx_ring + RX_BUF_LEN, rtl->tx_ring, rtl->tx_ring + PAGE_ALIGN_UP(TX_BUF_SIZE*NUM_TX_DESC) ); // Well done! // kprintf("\n\rRTL8139: OK, ethernet card is ready!"); ip = ntohl( get_host_ip() ); netmask = ntohl( get_host_netmask() ); ip_bcast = (~netmask) | (ip & netmask); kprintf("\n\n\rhost ip=%u.%u.%u.%u netmask=%u.%u.%u.%u broadcast=%u.%u.%u.%u\n\r", IP_A(ip), IP_B(ip), IP_C(ip), IP_D(ip), IP_A(netmask), IP_B(netmask), IP_C(netmask), IP_D(netmask), IP_A(ip_bcast), IP_B(ip_bcast), IP_C(ip_bcast), IP_D(ip_bcast) ); }

void rtl8139_handle_rx (  rtl8139_t *    rtl )

Handle a received packet event. Parameters: rtl  The RTL8139 structure. Definition at line 549 of file rtl8139.c. { uint32_t ring_offs, rx_size, rx_status; rxpacket_t *packet; while ((in(rtl->iobase + ChipCmd) & RxBufEmpty) == 0) { ring_offs = rtl->cur_rx % RX_BUF_LEN; // Read status+size of the next frame from DMA // // ring buffer // rx_status = *(uint32_t *)(rtl->rx_ring + ring_offs); rx_size = rx_status >> 16; rx_status &= 0xFFFF; if ( (rx_status & (RxBadSymbol | RxRunt | RxTooLong | RxCRCErr | RxBadAlign)) || (rx_size < ETH_MIN_LEN) || (rx_size > ETH_FRAME_LEN + 4) ) { #ifdef DEBUG kprintf("\n\rRX error! status=%#010x rx_size=%#010x\n\r", rx_status, rx_size); #endif rtl8139_reset(rtl); return; } // Allocate a buffer to store the packet // packet = kmalloc(sizeof(rxpacket_t) - 1 + rx_size - 4); if (packet == NULL) return; // No one cares about the FCS // packet->length = rx_size - 4; // Received a good packet // if (ring_offs + 4 + rx_size - 4 > RX_BUF_LEN) { int semi_count = RX_BUF_LEN - ring_offs - 4; memcpy(packet->data, rtl->rx_ring + ring_offs + 4, semi_count); memcpy(packet->data + semi_count, rtl->rx_ring, rx_size - 4 - semi_count); #ifdef DEBUG kprintf("\n\rRX packet (%u+%u bytes)", semi_count, rx_size - 4 - semi_count); #endif } else { memcpy(packet->data, rtl->rx_ring + ring_offs + 4, packet->length); #ifdef DEBUG kprintf("\n\rRX packet (%u bytes)", rx_size-4); #endif } #if 0 // Dump the received packet content // kprintf("\n\r"); for (i=0; i<packet->length; i++) kprintf("%02X ", packet->data[i]); #endif rtl->cur_rx = (rtl->cur_rx + rx_size + 4 + 3) & ~3; out16(rtl->iobase + RxBufPtr, rtl->cur_rx - 16); // Send the packet to the upper layer // to_eth_layer((ethernet_t *)packet->data, packet->length); // Free the packet sturcture // kfree(packet); } return; }

void rtl8139_handle_tx (  rtl8139_t *    rtl )

Handle a transmitted packet event. Parameters: rtl  The RTL8139 structure. Definition at line 532 of file rtl8139.c. { unsigned int i, status; for(i=0; i<NUM_TX_DESC; i++) { // We must read the status of every descriptor when // // a Tx interrupt occurs // status = in32(rtl->iobase + TxStatus0 + (i * 4)); #ifdef DEBUG kprintf("\n\rbuffer %u status %#010x", i, status); #endif } }

int rtl8139_init (  bool    promisc )

Initialize the RTL8139 driver. Parameters: promisc  TRUE initialize the card and put it in promiscuous mode; FALSE initialize the card and don't put it in promiscuous mode. Returns: 0 if we can successfully enable the RTL8139 ethernet card; -ENXIO if the device if not present on PCI bus; -EIO if we cannot read ethernet card informations;. Definition at line 358 of file rtl8139.c. { pci_cfg_t cfg; unsigned i; dword IF = GET_IF(); // Search an ethernet device on PCI and enable it! // cfg.base_class = 0x02; // Ethernet class // cfg.sub_class = 0x00; // Ethernet sub_class // cfg.interface = 0x00; // Ethernet interface // if ( !pci_find_cfg(&cfg, TRUE) ) { return(-ENXIO); } // Close a previous RTL8139 structure if present // if ( rtl != NULL ) { rtl8139_close(&rtl); } // Allocate the RTL8139 structure // rtl = kmalloc(sizeof(rtl8139_t)); if ( !rtl ) return(-ENOMEM); memset(rtl, 0, sizeof(rtl8139_t)); // Setup the I/O base register // for (i=0; i<6; i++) if ( (rtl->iobase=cfg.base[i]) != 0 ) break; // Check if the device I/O base address is valid // if ( rtl->iobase == 0 ) { kfree(rtl); return(-EIO); } // Setup the IRQ line // disable(); rtl->irq = cfg.irq; install_irq_handler( rtl->irq, (void *)&rtl8139_handler ); // Bring the chip out of low-power mode // out(rtl->iobase + Config1, 0x00); // Read the MAC address // if (rtl8139_read_eeprom(rtl, 0) != 0xFFFF) { // Read from EEPROM // unsigned short *ap = (unsigned short*)rtl->station_address; for (i = 0; i < 3; i++) *ap++ = rtl8139_read_eeprom(rtl, i + 7); } else { // Read from MAC0 register // unsigned char *ap = (unsigned char*)rtl->station_address; for (i = 0; i < 6; i++) *ap++ = in(rtl->iobase + MAC0 + i); } // Read the media informations // rtl->speed10 = (in(rtl->iobase + MediaStatus) & MSRSpeed10) != 0; rtl->fullduplex = (in16(rtl->iobase + MII_BMCR) & BMCRDuplex) != 0; // Setup the promiscuous mode // rtl->promisc = promisc; // Initialize the Rx and Tx rings buffer // if ( !(rtl->rx_ring) ) { rtl->rx_phys = (addr_t)dma_phys_alloc(RX_BUF_LEN); rtl->rx_ring = PHYSICAL( (uint8_t *)(rtl->rx_phys) ); } if ( !(rtl->tx_ring) ) { rtl->tx_phys = (addr_t)dma_phys_alloc(TX_BUF_SIZE*NUM_TX_DESC); rtl->tx_ring = PHYSICAL( (uint8_t *)(rtl->tx_phys) ); } // Initialize the RTL8139 mutex semaphore // INIT_MUTEX(&rtl->mutex); // Hardware reset of the RTL8139 // rtl8139_reset(rtl); // Well done! // SET_IF(IF); return(0); }

void rtl8139_promisc (  rtl8139_t *    rtl, bool    on )

Enable/disable the promiscuous mode for the RTL8139 card. Parameters: rtl  The RTL8139 structure. on  TRUE enable the promiscuous mode; FALSE disable the promiscuous mode. Definition at line 265 of file rtl8139.c. { uint8_t rxc; dword IF = GET_IF(); disable(); rxc = in(rtl->iobase + RxConfig); if ( on ) out(rtl->iobase + RxConfig, rxc | AcceptAllPhys); else out(rtl->iobase + RxConfig, rxc & (~AcceptAllPhys)); rtl->promisc = on; SET_IF(IF); }

unsigned rtl8139_read_eeprom (  rtl8139_t *    rtl, unsigned    location )  [static]

Read RTL8139 informations from the EEPROM. Parameters: rtl  The RTL8139 structure. location  The location in the EEPROM to read. Returns: The value read from the EEPROM. Definition at line 223 of file rtl8139.c. { int i; unsigned int retval = 0; long ee_addr = rtl->iobase + Cfg9346; int read_cmd = location | EE_READ_CMD; out(ee_addr, EE_ENB & ~EE_CS); out(ee_addr, EE_ENB); // Shift the read command bits out // for (i = 10; i >= 0; i--) { int dataval = (read_cmd & (1 << i)) ? EE_DATA_WRITE : 0; out(ee_addr, EE_ENB | dataval); eeprom_delay(); out(ee_addr, EE_ENB | dataval | EE_SHIFT_CLK); eeprom_delay(); } out(ee_addr, EE_ENB); eeprom_delay(); for (i = 16; i > 0; i--) { out(ee_addr, EE_ENB | EE_SHIFT_CLK); eeprom_delay(); retval = (retval << 1) | ((in(ee_addr) & EE_DATA_READ) ? 1 : 0); out(ee_addr, EE_ENB); eeprom_delay(); } // Terminate the EEPROM access // out(ee_addr, ~EE_CS); return(retval); }

void rtl8139_reset (  rtl8139_t *    rtl )

Reset the RTL8139 ethernet card. Parameters: rtl  The RTL8139 structure. Definition at line 282 of file rtl8139.c. { unsigned i; timeout_t elapsed; dword IF = GET_IF(); // Send the software-reset command // out(rtl->iobase + ChipCmd, CmdReset); // Reset the Rx and Tx rings // rtl->cur_rx = 0; rtl->cur_tx = 0; // Give the chip 10ms to finish the reset // enable(); set_timeout(&elapsed, 10); while ( (in(rtl->iobase + ChipCmd) & CmdReset) != 0 ) if ( is_timeout(&elapsed) ) break; SET_IF(IF); // Set-up the card MAC address register // for (i=0; i<_countof(rtl->station_address); i++) out(rtl->iobase + MAC0 + i, rtl->station_address[i]); // Must enable Tx/Rx before setting transfer thresholds! // out(rtl->iobase + ChipCmd, CmdRxEnb | CmdTxEnb); // Accept no frames yet! // out32(rtl->iobase + RxConfig, (RX_FIFO_THRESH<<13) | (RX_BUF_LEN_IDX<<11) | (RX_DMA_BURST<<8)); out32(rtl->iobase + TxConfig, (TX_DMA_BURST<<8) | 0x03000000); // Configure the RX buffer // out32(rtl->iobase + RxBuf, rtl->rx_phys); // Init Tx buffer DMA addresses // for (i = 0; i < NUM_TX_DESC; i++) out32(rtl->iobase + TxAddr0 + (i * 4), rtl->tx_phys + (TX_BUF_SIZE*i)); // Reset the missed packets counter // out32(rtl->iobase + RxMissed, 0); // Set RX mode // if ( rtl->promisc ) out(rtl->iobase + RxConfig, AcceptBroadcast | AcceptMyPhys | AcceptAllPhys); else out(rtl->iobase + RxConfig, AcceptBroadcast | AcceptMyPhys); // If we add multicast support, the MAR0 register would have to // // be initialized to 0xFFFFFFFF.FFFFFFFF (two 32 bit accesses). // // Etherboot only needs broadcast (for ARP/RARP/BOOTP/DHCP) and // // unicast. // // Start the chip's Tx and Rx process // out(rtl->iobase + ChipCmd, CmdRxEnb | CmdTxEnb); // Disable all known interrupts by setting the interrupt mask // // out16(rtl->iobase + IntrMask, 0x0000); // Enable all known interrupts // // out16(rtl->iobase + IntrMask, PCIErr | PCSTimeout | RxUnderrun | // RxOverflow | RxFIFOOver | // TxErr | TxOK | RxErr | RxOK); // Enable default interrupt mask (RxOK | TxOK) // out16(rtl->iobase + IntrMask, IntrDefault); }

int send_rtl8139_packet (  rtl8139_t *    rtl, const void *    data, size_t    len )

Send an ethernet packet to the physiscal layer. Parameters: rtl  The RTL8139 structure. data  The data to be sent. len  The size of the data to be sent in bytes. Returns: The number of bytes sent, or -1 if an error occurred. Todo: Set up a timeout for the transmitted packets. Definition at line 481 of file rtl8139.c. { // Check if the RTL8139 card has been configured // if ( !rtl ) return(-1); // Adapt the packet length to the Tx buffer size // // This should be done by the ethernet layer... // len = MIN(len, TX_BUF_SIZE); // Enter critical region // DOWN(&rtl->mutex); // kprintf("\n\rlooking for buffer %u", desc); if ( in32(rtl->iobase + TxStatus0 + (rtl->cur_tx * 4)) & TxHostOwns ) { // Found a free buffer! // // Copy the raw data to the Tx ring // memcpy(rtl->tx_ring + (TX_BUF_SIZE*rtl->cur_tx), data, len); // NOTE: RTL8139 doesn't auto-pad! Be sure that // // the ethernet layer has done it correctly // while (len < ETH_MIN_LEN) (rtl->tx_ring + (TX_BUF_SIZE*rtl->cur_tx))[len++] = '\0'; // Move the data from the Tx buffer to the // // internal transmit FIFO in PCI bus master // // mode // out32(rtl->iobase + TxAddr0 + rtl->cur_tx * 4, rtl->tx_phys + (TX_BUF_SIZE * rtl->cur_tx)); out32(rtl->iobase + TxStatus0 + rtl->cur_tx * 4, ((TX_FIFO_THRESH<<11) & 0x003F0000) | len); // Select new descriptor for transmition // rtl->cur_tx = (rtl->cur_tx + 1) % NUM_TX_DESC; // End of critical region // UP(&rtl->mutex); // Return the byte transmitted // return(len); } // End of critical region // UP(&rtl->mutex); // Buffer not available! // return(-1); }

---

Variable Documentation

rtl8139_t* rtl = NULL

Pointer to the RTL8139 structure. Definition at line 184 of file rtl8139.c.

---