NAME

     vte — Vortex86 RDC R6040 Fast Ethernet driver

SYNOPSIS

     To compile this driver into the kernel, place the following lines in your kernel
     configuration file:

           device miibus
           device vte

     Alternatively, to load the driver as a module at boot time, place the following line in
     loader.conf(5):

           if_vte_load="YES"

DESCRIPTION

     The vte device driver provides support for RDC R6040 Fast Ethernet controller which is
     commonly found on Vortex86 System On a Chip (SoC).

     The RDC R6040 has integrated 10/100 PHY for 10/100Mbps support in full or half-duplex.  The
     controller supports interrupt moderation mechanism, a 64-bit multicast hash filter, VLAN
     over-size frame and four station addresses.  The vte device driver uses three station
     addresses out of four as perfect multicast filter.

     The vte driver supports the following media types:

     autoselect   Enable autoselection of the media type and options.  The user can manually
                  override the autoselected mode by adding media options to rc.conf(5).

     10baseT/UTP  Set 10Mbps operation.

     100baseTX    Set 100Mbps (Fast Ethernet) operation.

     The vte driver supports the following media options:

     full-duplex  Force full duplex operation.

     half-duplex  Force half duplex operation.

     For more information on configuring this device, see ifconfig(8).

HARDWARE

     The vte device driver provides support for the following Ethernet controllers:

     •   DM&P Vortex86 RDC R6040 Fast Ethernet controller

LOADER TUNABLES

     Tunables can be set at the loader(8) prompt before booting the kernel or stored in
     loader.conf(5).

     hw.vte.tx_deep_copy
             The RDC R6040 controller has no auto-padding support for short frames and the
             controller's DMA engine does not have capability to handle multiple buffers for a TX
             frame such that driver has to create a single contiguous TX buffer.  This hardware
             limitation leads to poor TX performance since most of CPU cycles are wasted on both
             de-fragmenting mbuf chains and padding.  This tunable enables deep copy operation
             for TX frames such that driver will spend less CPU cycles in de-fragmentation with
             the cost of extra TX buffer memory.  The default value is 1 to use deep copy.

SYSCTL VARIABLES

     The following variables are available as both sysctl(8) variables and loader(8) tunables:

     dev.vte.%d.rx_mod
             Maximum number of packets to fire RX completion interrupt.  The accepted range is 0
             to 15, the default is 15.

     dev.vte.%d.tx_mod
             Maximum number of packets to fire TX completion interrupt.  The accepted range is 0
             to 15, the default is 15.

     dev.vte.%d.stats
             Show hardware MAC statistics maintained in driver.

SEE ALSO

     altq(4), arp(4), miibus(4), netintro(4), ng_ether(4), vlan(4), ifconfig(8)

     DM&P Electronics Inc. Vortex86, http://www.dmp.com.tw.

HISTORY

     The vte driver was written by Pyun YongHyeon <yongari@FreeBSD.org>.  It first appeared in
     FreeBSD 8.3.