Scroll to navigation

VTE(4) Device Drivers Manual VTE(4)

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:

Enable autoselection of the media type and options. The user can manually override the autoselected mode by adding media options to rc.conf(5).
Set 10Mbps operation.
Set 100Mbps (Fast Ethernet) operation.

The vte driver supports the following media options:

Force full duplex operation.
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.
December 30, 2010 Linux 4.19.0-10-amd64