View source for Unit SMC91X

Return to [[Unit_Reference|Unit Reference]]


=== Description ===
----

'''SMSC 91C9x/91C1xx Ethernet Driver unit'''

The SMSC 91C9x/91C1xx are a family of Non-PCI 10/100 Ethernet Single Chip MAC + PHY devices.
 
This driver is primarily intended to support the LAN91C111 Ethernet device included in the QEMU Verstile PB emulation however the driver is based on the equivalent Linux driver and as such includes (untested) support for a number of chip variants (see SMC91X_CHIP_* constants below).
 
The QEMU emulation does not include support for a number of the features provided in the real chip so they are either currently not supported or are untested without access to a physical chip implementation for testing.

=== Constants ===
----


<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X specific constants''' <code> SMC91X_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_NETWORK_DESCRIPTION = 'SMSC 91C9x/91C1xx Ethernet';</code>
| Description of SMC91X device
|-
|colspan="2"|&nbsp;
|-
| <code>SMC91X_COMPLETION_THREAD_STACK_SIZE = SIZE_128K;</code>
| Stack size of receive and transmit completion thread
|-
| <code>SMC91X_COMPLETION_THREAD_PRIORITY = THREAD_PRIORITY_HIGHER;</code>
| Priority of receive and transmit completion thread
|-
|colspan="2"|&nbsp;
|-
| <code>SMC91X_COMPLETION_THREAD_NAME = 'SMSC 91C9x/91C1xx Completion';</code>
| Name of receive and transmit completion thread
|-
|colspan="2"|&nbsp;
|-
| <code>SMC91X_COMPLETION_RECEIVE = 0;</code>
| A receive message sent to the completion thread
|-
| <code>SMC91X_COMPLETION_TRANSMIT = 1;</code>
| A transmit message sent to the completion thread
|-
| <code>SMC91X_COMPLETION_ALLOCATE = 2;</code>
| An allocate message sent to the completion thread
|-
| <code>SMC91X_COMPLETION_TERMINATE = 3;</code>
| A terminate message sent to the completion thread
|-
|colspan="2"|&nbsp;
|-
| <code>SMC91X_MAX_TX_ENTRIES = SIZE_16;</code>
| Number of Transmit buffers allocated
|-
| <code>SMC91X_MAX_RX_ENTRIES = SIZE_256;</code>
| Number of Receive buffers allocated
|-
|colspan="2"|&nbsp;
|-
| <code>SMC91X_MAX_PACKET_SIZE = 2048;</code>
| &nbsp;
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X transmit control register''' <code> SMC91X_TCR_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_TCR_ENABLE = $0001;</code>
| Transmit enabled when set
|-
| <code>SMC91X_TCR_LOOP = $0002;</code>
| Loopback. General purpose output port used to control the LBK pin.
|-
| <code>SMC91X_TCR_FORCOL = $0004;</code>
| When set, the FORCOL bit will force a collision by not deferring deliberately.
|-
| <code>SMC91X_TCR_PAD_EN = $0080;</code>
| When set, will pad transmit frames shorter than 64 bytes with 00.
|-
| <code>SMC91X_TCR_NOCRC = $0100;</code>
| Does not append CRC to transmitted frames when set
|-
| <code>SMC91X_TCR_MON_CSN = $0400;</code>
| When set monitors carrier while transmitting
|-
| <code>SMC91X_TCR_FDUPLX = $0800;</code>
| When set will cause frames to be received if they pass the address filter regardless of the source for the frame. When clear the node will not receive a frame sourced by itself.
|-
| <code>SMC91X_TCR_STP_SQET = $1000;</code>
| Stop transmission on SQET error. If this bit is set, will stop and disable the transmitter on SQE test error.
|-
| <code>SMC91X_TCR_EPH_LOOP = $2000;</code>
| Internal loopback at the EPH block
|-
| <code>SMC91X_TCR_SWFDUP = $8000;</code>
| Enables Switched Full Duplex mode
|-
|colspan="2"|&nbsp;
|-
|colspan="2"|''Default settings''
|-
| <code>SMC91X_TCR_DEFAULT = SMC91X_TCR_ENABLE or SMC91X_TCR_PAD_EN;</code>
| &nbsp;
|-
| <code>SMC91X_TCR_CLEAR = 0;</code>
| &nbsp;
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X EPH status (Ethernet Protocol Handler)''' <code> SMC91X_EPH_STATUS_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_EPH_STATUS_TX_SUC = $0001;</code>
| Last transmit was successful. Set if transmit completes without a fatal error.
|-
| <code>SMC91X_EPH_STATUS_SNGL_COL = $0002;</code>
| Single collision detected for the last transmit frame. Set when a collision is detected.
|-
| <code>SMC91X_EPH_STATUS_MUL_COL = $0004;</code>
| Multiple collision detected for the last transmit frame. Set when more than one collision was experienced.
|-
| <code>SMC91X_EPH_STATUS_LTX_MULT = $0008;</code>
| Last transmit frame was a multicast. Set if frame was a multicast.
|-
| <code>SMC91X_EPH_STATUS_16COL = $0010;</code>
| 16 collisions reached. Set when 16 collisions are detected for a transmit frame.
|-
| <code>SMC91X_EPH_STATUS_SQET = $0020;</code>
| Signal Quality Error Test
|-
| <code>SMC91X_EPH_STATUS_LTXBRD = $0040;</code>
| Last transmit frame was a broadcast. Set if frame was broadcast.
|-
| <code>SMC91X_EPH_STATUS_TXDEFR = $0080;</code>
| Transmit Deferred. When set, carrier was detected during the first 6.4us of the inter frame gap.
|-
| <code>SMC91X_EPH_STATUS_LATCOL = $0200;</code>
| Late collision detected on last transmit frame. If set a late collision was detected (later than 64 byte times into the frame).
|-
| <code>SMC91X_EPH_STATUS_LOSTCARR = $0400;</code>
| Lost Carrier Sense. When set indicates that Carrier Sense was not present at end of preamble.
|-
| <code>SMC91X_EPH_STATUS_EXC_DEF = $0800;</code>
| Excessive Deferral. When set last/current transmit was deferred for more than 1518 * 2 byte times.
|-
| <code>SMC91X_EPH_STATUS_CTR_ROL = $1000;</code>
| Counter Roll Over. When set one or more 4 bit counters have reached maximum count (15).
|-
| <code>SMC91X_EPH_STATUS_LINK_OK = $4000;</code>
| General purpose input port driven by nLNK pin inverted
|-
| <code>SMC91X_EPH_STATUS_TXUNRN = $8000;</code>
| TX Underrun
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X receive control register''' <code> SMC91X_RCR_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_RCR_RX_ABORT = $0001;</code>
| This bit is set if a receive frame was aborted due to length longer than 2K bytes. The frame will not be received. The bit is cleared by RESET or by the CPU writing it low.
|-
| <code>SMC91X_RCR_PRMS = $0002;</code>
| Promiscuous mode. When set receives all frames. Does not receive its own transmission unless it is in Full Duplex.
|-
| <code>SMC91X_RCR_ALMUL = $0004;</code>
| When set accepts all multicast frames (frames in which the first bit of DA is '1'). When clear accepts only the multicast frames that match the multicast table setting. Defaults low.
|-
| <code>SMC91X_RCR_RXEN = $0100;</code>
| Enables the receiver when set. If cleared, completes receiving current frame and then goes idle. Defaults low on reset.
|-
| <code>SMC91X_RCR_STRIP_CRC = $0200;</code>
| When set, it strips the CRC on received frames. As a result, both the Byte Count and the frame format do not contain the CRC. When clear, the CRC is stored in memory following the packet. Defaults low.
|-
| <code>SMC91X_RCR_ABORT_ENB = $0200;</code>
| Enables abort of receive when collision occurs. Defaults low. When set, will automatically abort a packet being received when the appropriate collision input is activated.
|-
| <code>SMC91X_RCR_FILT_CAR = $0400;</code>
| Filter Carrier. When set filters leading edge of carrier sense for 12 bit times (3 nibble times). Otherwise recognizes a receive frame as soon as carrier sense is active. (Does NOT filter RX DV on MII)
|-
| <code>SMC91X_RCR_SOFTRST = $8000;</code>
| Software-Activated Reset. Active high. Initiated by writing this bit high and terminated by writing the bit low.
|-
|colspan="2"|''Default settings''
|-
| <code>SMC91X_RCR_DEFAULT = SMC91X_RCR_STRIP_CRC or SMC91X_RCR_RXEN;</code>
| &nbsp;
|-
| <code>SMC91X_RCR_CLEAR = 0;</code>
| &nbsp;
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X receive/PHY control''' <code> SMC91X_RPC_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_RPC_SPEED = $2000;</code>
| Speed select Input (1=100Mbps / 0=0Mbps)
|-
| <code>SMC91X_RPC_DPLX = $1000;</code>
| Duplex Select - This bit selects Full/Half Duplex operation (1=Full Duplex / 0=Half Duplex))
|-
| <code>SMC91X_RPC_ANEG = $0800;</code>
| Auto-Negotiation mode select
|-
| <code>SMC91X_RPC_LS2A = $0080;</code>
| LED select Signal Enable. These bits define what LED control signals are routed to the LEDA output pin on the Ethernet Controller. The default is 10/100 Link detected.
|-
| <code>SMC91X_RPC_LS1A = $0040;</code>
| &nbsp;
|-
| <code>SMC91X_RPC_LS0A = $0020;</code>
| &nbsp;
|-
| <code>SMC91X_RPC_LS2B = $0010;</code>
| LED select Signal Enable. These bits define what LED control signals are routed to the LEDB output pin on the Ethernet Controller. The default is 10/100 Link detected.
|-
| <code>SMC91X_RPC_LS1B = $0008;</code>
| &nbsp;
|-
| <code>SMC91X_RPC_LS0B = $0004;</code>
| &nbsp;
|-
|colspan="2"|''Default Settings''
|-
| <code>SMC91X_RPC_DEFAULT = SMC91X_RPC_ANEG or SMC91X_RPC_SPEED or SMC91X_RPC_DPLX;</code>
| &nbsp;
|-
|colspan="2"|''RPC LS2A/LS1A/LS0A and LS2B/LS1B/LS0B values''
|-
| <code>SMC91X_RPC_LED_100_10 = $00;</code>
| LED = 100Mbps OR's with 10Mbps link detect
|-
| <code>SMC91X_RPC_LED_RES = $01;</code>
| LED = Reserved
|-
| <code>SMC91X_RPC_LED_10 = $02;</code>
| LED = 10Mbps link detect
|-
| <code>SMC91X_RPC_LED_FD = $03;</code>
| LED = Full Duplex Mode
|-
| <code>SMC91X_RPC_LED_TX_RX = $04;</code>
| LED = TX or RX packet occurred
|-
| <code>SMC91X_RPC_LED_100 = $05;</code>
| LED = 100Mbps link detect
|-
| <code>SMC91X_RPC_LED_TX = $06;</code>
| LED = TX packet occurred
|-
| <code>SMC91X_RPC_LED_RX = $07;</code>
| LED = RX packet occurred
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X configuration''' <code> SMC91X_CONFIG_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_CONFIG_EXT_PHY = $0200;</code>
| External PHY Enabled (1=Enables the external MII / 0=Internal PHY is enabled)
|-
| <code>SMC91X_CONFIG_GPCNTRL = $0400;</code>
| This bit is a general purpose output port. Its inverse value drives pin nCNTRL and it is typically connected to a SELECT pin of the external PHY device such as a power enable.
|-
| <code>SMC91X_CONFIG_NO_WAIT = $1000;</code>
| When set, does not request additional wait states. An exception to this are accesses to the Data Register if not ready for a transfer.
|-
| <code>SMC91X_CONFIG_EPH_POWER_EN = $8000;</code>
| Used to selectively power transition the EPH to a low power mode. When this bit is cleared (0), the Host will place the EPH into a low power mode.
|-
| <code>SMC91X_CONFIG_RESERVED = $20B1;</code>
| Reserved values
|-
|colspan="2"|''Default is powered-up, Internal Phy, Wait States, and pin nCNTRL=low''
|-
| <code>SMC91X_CONFIG_DEFAULT = SMC91X_CONFIG_EPH_POWER_EN;</code>
| &nbsp;
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X control''' <code> SMC91X_CTL_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_CTL_RCV_BAD = $4000;</code>
| When set, bad CRC packets are received. When clear bad CRC packets do not generate interrupts and their memory is released.
|-
| <code>SMC91X_CTL_AUTO_RELEASE = $0800;</code>
| When set, transmit pages are released by transmit completion if the transmission was successful (when TX_SUC is set).
|-
| <code>SMC91X_CTL_LE_ENABLE = $0080;</code>
| Link Error Enable. When set it enables the LINK_OK bit transition as one of the interrupts merged into the EPH INT bit.
|-
| <code>SMC91X_CTL_CR_ENABLE = $0040;</code>
| Counter Roll over Enable. When set, it enables the CTR_ROL bit as one of the interrupts merged into the EPH INT bit.
|-
| <code>SMC91X_CTL_TE_ENABLE = $0020;</code>
| Transmit Error Enable. When set it enables Transmit Error as one of the interrupts merged into the EPH INT bit.
|-
| <code>SMC91X_CTL_EEPROM_SELECT = $0004;</code>
| This bit allows the CPU to specify which registers the EEPROM RELOAD or STORE refers to
|-
| <code>SMC91X_CTL_RELOAD = $0002;</code>
| When set it will read the EEPROM and update relevant registers with its contents
|-
| <code>SMC91X_CTL_STORE = $0001;</code>
| When set, stores the contents of all relevant registers in the serial EEPROM.
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X MMU command''' <code> SMC91X_MMU_CMD_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_MMU_CMD_BUSY = 1;</code>
| When 1 the last command has not completed
|-
| <code>SMC91X_MMU_CMD_NOP = (0 shl 5);</code>
| NOOP - NO OPERATION
|-
| <code>SMC91X_MMU_CMD_ALLOC = (1 shl 5);</code>
| ALLOCATE MEMORY FOR TX (OR with number of 256 byte packets)
|-
| <code>SMC91X_MMU_CMD_RESET = (2 shl 5);</code>
| RESET MMU TO INITIAL STATE (Frees all memory allocations, clears relevant interrupts, resets packet FIFO pointers)
|-
| <code>SMC91X_MMU_CMD_REMOVE = (3 shl 5);</code>
| REMOVE FRAME FROM TOP OF RX FIFO (To be issued after CPU has completed processing of present receive frame)
|-
| <code>SMC91X_MMU_CMD_RELEASE = (4 shl 5);</code>
| REMOVE AND RELEASE TOP OF RX FIFO (Like 3) but also releases all memory used by the packet presently at the RX FIFO output)
|-
| <code>SMC91X_MMU_CMD_FREEPKT = (5 shl 5);</code>
| RELEASE SPECIFIC PACKET (Frees all pages allocated to the packet specified in the PACKET NUMBER REGISTER)
|-
| <code>SMC91X_MMU_CMD_ENQUEUE = (6 shl 5);</code>
| ENQUEUE PACKET NUMBER INTO TX FIFO (This is the normal method of transmitting a packet just loaded into RAM)
|-
| <code>SMC91X_MMU_CMD_RSTTXFIFO = (7 shl 5);</code>
| RESET TX FIFOs (This command will reset both TX FIFOs)
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X allocation result''' <code> SMC91X_AR_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_AR_FAILED = $80;</code>
| FAILED - A zero indicates a successful allocation completion. If the allocation fails the bit is set and only cleared when the pending allocation is satisfied.
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X TX FIFO ports''' <code> SMC91X_TXFIFO_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_TXFIFO_TEMPTY = $80;</code>
| TEMPTY - No transmit packets in completion queue. For polling purposes, uses the TX_INT bit in the Interrupt Status Register.
|-
|}
</div></div>
<br />

<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X RX FIFO ports''' <code> SMC91X_RXFIFO_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_RXFIFO_REMPTY = $80;</code>
| REMPTY - No receive packets queued in the RX FIFO. For polling purposes, uses the RCV_INT bit in the Interrupt Status Register.
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X pointer''' <code> SMC91X_PTR_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_PTR_RCV = $8000;</code>
| When RCV is set the address refers to the receive area and uses the output of RX FIFO as the packet number, when RCV is clear the address refers to the transmit area and uses the packet number at the Packet Number Register.
|-
| <code>SMC91X_PTR_AUTOINC = $4000;</code>
| It will auto-increment on accesses to the data register when AUTO INCR is set. The increment is by one for every byte access, by two for every word access, and by four for every double word access.
|-
| <code>SMC91X_PTR_READ = $2000;</code>
| Determines the type of access to follow. If the READ bit is high the operation intended is a read.
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X interrupt mask''' <code> SMC91X_IM_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_IM_MDINT = $80;</code>
| PHY MI Register 18 Interrupt
|-
| <code>SMC91X_IM_ERCV_INT = $40;</code>
| Early Receive Interrupt
|-
| <code>SMC91X_IM_EPH_INT = $20;</code>
| Set by Ethernet Protocol Handler section
|-
| <code>SMC91X_IM_RX_OVRN_INT = $10;</code>
| Set by Receiver Overruns
|-
| <code>SMC91X_IM_ALLOC_INT = $08;</code>
| Set when allocation request is completed
|-
| <code>SMC91X_IM_TX_EMPTY_INT = $04;</code>
| Set if the TX FIFO goes empty
|-
| <code>SMC91X_IM_TX_INT = $02;</code>
| Transmit Interrupt
|-
| <code>SMC91X_IM_RCV_INT = $01;</code>
| Receive Interrupt
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X management interface''' <code> SMC91X_MII_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_MII_MSK_CRS100 = $4000;</code>
| Disables CRS100 detection during tx half dup
|-
| <code>SMC91X_MII_MDOE = $0008;</code>
| MII Output Enable
|-
| <code>SMC91X_MII_MCLK = $0004;</code>
| MII Clock, pin MDCLK
|-
| <code>SMC91X_MII_MDI = $0002;</code>
| MII Input, pin MDI
|-
| <code>SMC91X_MII_MDO = $0001;</code>
| MII Output, pin MDO
|-
|colspan="2"|&nbsp;
|-
| <code>SMC91X_MII_DELAY = 1;</code>
| The MII clock high/low times. 2 x this number gives the MII clock period in microseconds.
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X receive''' <code> SMC91X_RCV_THRESHOLD* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_RCV_RCV_DISCRD = $0080;</code>
| Set to discard a packet being received. Will discard packets only in the process of being received.
|-
| <code>SMC91X_RCV_THRESHOLD = $001F;</code>
| RCV Threshold Mask
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X receive status''' <code> SMC91X_RCV_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_RCV_ALGNERR = $8000;</code>
| Frame has alignment error
|-
| <code>SMC91X_RCV_BRODCAST = $4000;</code>
| Receive frame was Broadcast (The Multicast bit may also be set, software must ignore the Multicast bit for a Broadcast packet).
|-
| <code>SMC91X_RCV_BADCRC = $2000;</code>
| Frame has CRC error or RX_ER was asserted during reception
|-
| <code>SMC91X_RCV_ODDFRAME = $1000;</code>
| This bit when set indicates that the received frame has an odd number of bytes
|-
| <code>SMC91X_RCV_TOOLONG = $0800;</code>
| Frame length was longer than 802.3 maximum size (1518 bytes on the cable)
|-
| <code>SMC91X_RCV_TOOSHORT = $0400;</code>
| Frame length was shorter than 802.3 minimum size (64 bytes on the cable)
|-
| <code>SMC91X_RCV_MULTICAST = $0001;</code>
| Receive frame was Multicast
|-
| <code>SMC91X_RCV_ERRORS = (SMC91X_RCV_ALGNERR or SMC91X_RCV_BADCRC or SMC91X_RCV_TOOLONG or SMC91X_RCV_TOOSHORT);</code>
| &nbsp;
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X bank select''' <code> SMC91X_BANK_SELECT_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_BANK_SELECT_0 = 0;</code>
| style="width: 50%;"|&nbsp;
|-
| <code>SMC91X_BANK_SELECT_1 = 1;</code>
| &nbsp;
|-
| <code>SMC91X_BANK_SELECT_2 = 2;</code>
| &nbsp;
|-
| <code>SMC91X_BANK_SELECT_3 = 3;</code>
| &nbsp;
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X chip''' <code> SMC91X_CHIP_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
|colspan="2"|Bits 4-7 of the Revision register
|-
| <code>SMC91X_CHIP_COUNT = 16;</code>
| style="width: 50%;"|&nbsp;
|-
|colspan="2"|&nbsp;
|-
| <code>SMC91X_CHIP_9192 = 3;</code>
| &nbsp;
|-
| <code>SMC91X_CHIP_9194 = 4;</code>
| &nbsp;
|-
| <code>SMC91X_CHIP_9195 = 5;</code>
| &nbsp;
|-
| <code>SMC91X_CHIP_9196 = 6;</code>
| &nbsp;
|-
| <code>SMC91X_CHIP_91100 = 7;</code>
| &nbsp;
|-
| <code>SMC91X_CHIP_91100FD = 8;</code>
| &nbsp;
|-
| <code>SMC91X_CHIP_91111FD = 9;</code>
| &nbsp;
|-
|colspan="2"|&nbsp;
|-
| <code>SMC91X_CHIP_NAMES:array[0..SMC91X_CHIP_COUNT - 1] of String = (</code>
| &nbsp;
|-
| <code>' ',</code>
| &nbsp;
|-
| <code>' ',</code>
| &nbsp;
|-
| <code>' ',</code>
| &nbsp;
|-
| <code>'SMC91C90/91C92',</code>
| 3
|-
| <code>'SMC91C94',</code>
| 4
|-
| <code>'SMC91C95',</code>
| 5
|-
| <code>'SMC91C96',</code>
| 6
|-
| <code>'SMC91C100',</code>
| 7
|-
| <code>'SMC91C100FD',</code>
| 8
|-
| <code>'SMC91C11xFD',</code>
| 9
|-
| <code>' ',</code>
| &nbsp;
|-
| <code>' ',</code>
| &nbsp;
|-
| <code>' ',</code>
| &nbsp;
|-
| <code>' ',</code>
| &nbsp;
|-
| <code>' ',</code>
| &nbsp;
|-
| <code>' ');</code>
| &nbsp;
|-
|}
</div></div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 20px; padding-bottom: 15px;">
<div style="font-size: 14px; padding-left: 12px;">'''SMC91X PHY Ids''' <code> SMC91X_PHY_* </code></div>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>SMC91X_PHY_LAN83C183 = $0016f840;</code>
| LAN83C183 = LAN91C111 Internal PHY
|-
| <code>SMC91X_PHY_LAN83C180 = $02821c50;</code>
| &nbsp;
|-
|colspan="2"|&nbsp;
|-
|colspan="2"|SMC91X PHY Register Addresses (LAN91C111 Internal PHY)
|-
|colspan="2"|Register 0. Control Register
|-
|colspan="2"|See: Network Generic MII registers (MII_BMCR)
|-
|colspan="2"|&nbsp; 
|-
|colspan="2"|Register 1. Status Register
|-
|colspan="2"|See: Network Generic MII registers (MII_BMSR)
|-
|colspan="2"|&nbsp;
|-
|colspan="2"|Register 2 & 3. PHY Identifier Register
|-
|colspan="2"|See: Network Generic MII registers (MII_PHYSID1 / MII_PHYSID2)
|-
|colspan="2"|&nbsp;
|-
|colspan="2"|Register 4. Auto-Negotiation Advertisement Register
|-
|colspan="2"|See: Network Generic MII registers (MII_ADVERTISE)
|-
|colspan="2"|&nbsp;
|-
|colspan="2"|Register 5. Auto-Negotiation Remote End Capability Register
|-
|colspan="2"|See: Network Generic MII registers (MII_LPA)
|-
|colspan="2"|&nbsp;
|-
|colspan="2"|Register 16. Configuration 1- Structure and Bit Definition
|-
| <code>SMC91X_PHY_CFG1_REG = $10;</code>
| &nbsp;
|-
| <code>SMC91X_PHY_CFG1_LNKDIS = $8000;</code>
| 1=Rx Link Detect Function disabled
|-
| <code>SMC91X_PHY_CFG1_XMTDIS = $4000;</code>
| 1=TP Transmitter Disabled
|-
| <code>SMC91X_PHY_CFG1_XMTPDN = $2000;</code>
| 1=TP Transmitter Powered Down
|-
| <code>SMC91X_PHY_CFG1_BYPSCR = $0400;</code>
| 1=Bypass scrambler/descrambler
|-
| <code>SMC91X_PHY_CFG1_UNSCDS = $0200;</code>
| 1=Unscramble Idle Reception Disable
|-
| <code>SMC91X_PHY_CFG1_EQLZR = $0100;</code>
| 1=Rx Equalizer Disabled
|-
| <code>SMC91X_PHY_CFG1_CABLE = $0080;</code>
| 1=STP(150ohm), 0=UTP(100ohm)
|-
| <code>SMC91X_PHY_CFG1_RLVL0 = $0040;</code>
| 1=Rx Squelch level reduced by 4.5db
|-
| <code>SMC91X_PHY_CFG1_TLVL_SHIFT = 2;</code>
| Transmit Output Level Adjust
|-
| <code>SMC91X_PHY_CFG1_TLVL_MASK = $003C;</code>
| &nbsp;
|-
| <code>SMC91X_PHY_CFG1_TRF_MASK = $0003;</code>
| Transmitter Rise/Fall time
|-
|colspan="2"|&nbsp;
|-
|colspan="2"|Register 17. Configuration 2 - Structure and Bit Definition
|-
| <code>SMC91X_PHY_CFG2_REG = $11;</code>
| &nbsp;
|-
| <code>SMC91X_PHY_CFG2_APOLDIS = $0020;</code>
| 1=Auto Polarity Correction disabled
|-
| <code>SMC91X_PHY_CFG2_JABDIS = $0010;</code>
| 1=Jabber disabled
|-
| <code>SMC91X_PHY_CFG2_MREG = $0008;</code>
| 1=Multiple register access (MII mgt)
|-
| <code>SMC91X_PHY_CFG2_INTMDIO = $0004;</code>
| 1=Interrupt signaled with MDIO pulseo
|-
|colspan="2"|&nbsp;
|-
|colspan="2"|Register 18. Status Output - Structure and Bit Definition
|-
| <code>SMC91X_PHY_INT_REG = $12;</code>
| Status Output (Interrupt Status)
|-
| <code>SMC91X_PHY_INT_INT = $8000;</code>
| 1=bits have changed since last read
|-
| <code>SMC91X_PHY_INT_LNKFAIL = $4000;</code>
| 1=Link Not detected
|-
| <code>SMC91X_PHY_INT_LOSSSYNC = $2000;</code>
| 1=Descrambler has lost sync
|-
| <code>SMC91X_PHY_INT_CWRD = $1000;</code>
| 1=Invalid 4B5B code detected on rx
|-
| <code>SMC91X_PHY_INT_SSD = $0800;</code>
| 1=No Start Of Stream detected on rx
|-
| <code>SMC91X_PHY_INT_ESD = $0400;</code>
| 1=No End Of Stream detected on rx
|-
| <code>SMC91X_PHY_INT_RPOL = $0200;</code>
| 1=Reverse Polarity detected
|-
| <code>SMC91X_PHY_INT_JAB = $0100;</code>
| 1=Jabber detected
|-
| <code>SMC91X_PHY_INT_SPDDET = $0080;</code>
| 1=100Base-TX mode, 0=10Base-T mode
|-
| <code>SMC91X_PHY_INT_DPLXDET = $0040;</code>
| 1=Device in Full Duplex
|-
|colspan="2"|&nbsp;
|-
|colspan="2"|Register 19. Mask - Structure and Bit Definition
|-
| <code>SMC91X_PHY_MASK_REG = $13;</code>
| Interrupt Mask (Uses the same bit definitions as PHY_INT_REG)
|-
|colspan="2"|&nbsp;
|-
|colspan="2"|Register 20. Reserved - Structure and Bit Definition
|-
|colspan="2"|''Nothing''
|-
|}
</div></div>
<br />

=== Type definitions ===
----


'''SMC91X bank 0 registers'''

<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">

<code>TSMC91XBank0Registers = packed record</code>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
|colspan="2"|Note: Layout of the SMC91X registers
|-
| <code>TCR:Word;</code>
| Transmit Control Register
|-
| <code>EPH_STATUS:Word;</code>
| EPH Status Register
|-
| <code>RCR:Word;</code>
| Receive Control Register
|-
| <code>COUNTER:Word;</code>
| Counter Register
|-
| <code>MIR:Word;</code>
| Memory Information Register
|-
| <code>RPCR:Word;</code>
| Receive/Phy Control Register
|-
| <code>RESERVED:Word;</code>
| Reserved
|-
| <code>BANK:Word;</code>
| Bank Select Register
|-
|}
</div></div>

'''SMC91X bank 1 registers'''

<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">

<code>TSMC91XBank1Registers = packed record</code>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>CONFIG:Word;</code>
| Configuration Register
|-
| <code>BASE:Word;</code>
| Base Address Register
|-
| <code>ADDR0:Word;</code>
| Individual Address Registers (0 and 1)
|-
| <code>ADDR1:Word;</code>
| Individual Address Registers (2 and 3)
|-
| <code>ADDR2:Word;</code>
| Individual Address Registers (4 and 5)
|-
| <code>GP:Word;</code>
| General Purpose Register
|-
| <code>CTL:Word;</code>
| Control Register
|-
| <code>BANK:Word;</code>
| Bank Select Register
|-
|}
</div></div>

'''SMC91X FIFO registers'''

<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">

<code>TSMC91XFIFORegisters = packed record</code>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>case Integer of</code>
| style="width: 50%;"|&nbsp;
|-
| <code>0:(FIFO:Word);</code>
| &nbsp;
|-
| <code>1:(TX:Byte;</code>
| &nbsp;
|-
| <code>RX:Byte);</code>
| &nbsp;
|-
|}
</div></div>
  
'''SMC91X DATA registers'''

<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">

<code>TSMC91XDATARegisters = packed record</code>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>case Integer of</code>
| style="width: 50%;"|&nbsp;
|-
| <code>0:(DATA:LongWord);</code>
| &nbsp;
|-
| <code>1:(DATAH:Word;</code>
| &nbsp;
|-
| <code>DATAL:Word);</code>
| &nbsp;
|-
| <code>2:(DATA0:Byte;</code>
| &nbsp;
|-
| <code>DATA1:Byte;</code>
| &nbsp;
|-
| <code>DATA2:Byte;</code>
| &nbsp;
|-
| <code>DATA3:Byte);</code>
| &nbsp;
|-
|}
</div></div>

'''SMC91X bank 2 registers''' 

<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">

<code>TSMC91XBank2Registers = packed record</code>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>MMU_CMD:Word;</code>
| MMU Command Register
|-
| <code>PN:Byte;</code>
| Packet Number Register
|-
| <code>AR:Byte;</code>
| Allocation Result Register
|-
| <code>FIFO:TSMC91XFIFORegisters;</code>
| FIFO Ports Register
|-
| <code>PTR:Word;</code>
| Pointer Register
|-
| <code>DATA:TSMC91XDATARegisters;</code>
| Data Register
|-
| <code>INT:Byte;</code>
| Interrupt Status Register
|-
| <code>IM:Byte;</code>
| Interrupt Mask Register
|-
| <code>BANK:Word;</code>
| Bank Select Register
|-
|}
</div></div>

'''SMC91X bank 3 registers'''

<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">

<code>TSMC91XBank3Registers = packed record</code>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>MCAST1:Word;</code>
| Multicast Table Registers (0 and 1)
|-
| <code>MCAST2:Word;</code>
| Multicast Table Registers (2 and 3)
|-
| <code>MCAST3:Word;</code>
| Multicast Table Registers (4 and 5)
|-
| <code>MCAST4:Word;</code>
| Multicast Table Registers (6 and 7)
|-
| <code>MII:Word;</code>
| Management Interface Register
|-
| <code>REV:Word;</code>
| Revision Register
|-
| <code>RCV:Word;</code>
| RCV Register
|-
| <code>Bank:Word;</code>
| Bank Select Register
|-
|}
</div></div>
 
'''SMC91X registers'''

<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
<code>PSMC91XRegisters = ^TSMC91XRegisters;</code>

<code>TSMC91XRegisters = packed record</code>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
| <code>case Integer of</code>
| style="width: 50%;"|&nbsp;
|-
| <code>0:(Bank0:TSMC91XBank0Registers);</code>
| Bank 0 Registers
|-
| <code>1:(Bank1:TSMC91XBank1Registers);</code>
| Bank 1 Registers
|-
| <code>2:(Bank2:TSMC91XBank2Registers);</code>
| Bank 2 Registers
|-
| <code>3:(Bank3:TSMC91XBank3Registers);</code>
| Bank 3 Registers
|-
|}
</div></div>

'''SMC91X network'''

<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
<code>PSMC91XNetwork = ^TSMC91XNetwork;</code>

<code>TSMC91XNetwork = record</code>
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
{| class="wikitable" style="font-size: 14px; background: white;"
|-
|colspan="2"|''Network Properties''
|-
| <code>Network:TNetworkDevice;</code>
| style="width: 50%;"|&nbsp;
|-
|colspan="2"|''SMC91X Properties''
|-
| <code>IRQ:LongWord;</code>
| &nbsp;
|-
| <code>Lock:TSpinHandle;</code>
| Device lock (Differs from lock in Network device) (Spin lock due to use by interrupt handler)
|-
| <code>Thread:TThreadHandle;</code>
| Thread for handling packet receive and transmit completion
|-
| <code>Start:LongWord;</code>
| First receive entry available for incoming packet
|-
| <code>Count:LongWord;</code>
| Number of receive entries available for incoming packets
|-
| <code>Entries:array[0..(SMC91X_MAX_RX_ENTRIES - 1)] of PNetworkEntry;</code>
| Queue of receive entries for handling incoming packets
|-
| <code>Registers:PSMC91XRegisters;</code>
| Device registers
|-
| <code>Revision:Word;</code>
| Device revision
|-
| <code>PHYId:LongWord;</code>
| Physical Interface (PHY) Address
|-
| <code>PHYType:LongWord;</code>
| Physical Interface (PHY) Type
|-
| <code>TCRFlags:LongWord;</code>
| Current Transmit Control Register (TCR) flags
|-
| <code>RCRFlags:LongWord;</code>
| Current Receive Control Register (RCR) flags
|-
| <code>RPCFlags:LongWord;</code>
| Current Receive/PHY Control Register (RPC) flags
|-
|colspan="2"|''Statistics Properties''
|-
| <code>InterruptCount:LongWord;</code>
| Number of interrupt requests received by the device
|-
| <code>CollisionCount:LongWord;</code>
| Number of transmit collisions detected by the device
|-
|}
</div></div>
<br />

=== Public variables ===
----


'''SMC91X specific variables'''

{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
|-
| <code>SMC91X_ALLOCATE_WAIT_COUNT:LongWord = 16;</code>
| style="width: 40%;"|How long to wait for the SMC91X to allocate memory before deferring a packet
|-
|}
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
|-
| <code>SMC91X_MAX_IRQ_COUNT:LongWord = 8;</code>
| style="width: 40%;"|How many iterations of the interrupt handler are allowed on each interrupt
|-
|}
{| class="wikitable" style="font-size: 14px; text-align: left; width: 100%; height: 50px;"
|-
| <code>SMC91X_THROTTLE_TRANSMIT:Boolean = False;</code>
| style="width: 40%;"|Determines if TX packets are sent one at a time or queued into SMC91X internal memory
|-
|} 
<br />

=== Function declarations ===
----

''To be documented''


Return to [[Unit_Reference|Unit Reference]]