FreeBSD manual

download PDF document: if_genet.4.pdf

GENET(4) FreeBSD Kernel Interfaces Manual GENET(4)
NAME genet - Raspberry Pi 4 / BCM2711 Gigabit Ethernet controller driver
SYNOPSIS To compile this driver into the kernel, place the following lines in the kernel configuration file:
device miibus device genet
DESCRIPTION The genet driver supports the BCM2711 Ethernet controller as found on the Raspberry Pi 4.
The following features are supported in the genet driver in FreeBSD:
IP/TCP/UDP checksum offload for IPv4 and IPv6 10/100/1000Mbps operation in full-duplex mode 10/100Mbps operation in half-duplex mode
Note that the operation of transmit checksum offload is coupled for IPv4 and IPv6; to disable it, both must be disabled even if both address families are not in use.
The genet 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. The ifconfig(8) mediaopt option can also be used to select either full-duplex or half-duplex modes.
100baseTX Set 100Mbps (Fast Ethernet) operation. The ifconfig(8) mediaopt option can also be used to select either full-duplex or half-duplex modes.
1000baseT Set 1000baseT operation over twisted pair. Only full-duplex mode is supported.
The genet driver supports the following media options set with the mediaopt option to the ifconfig(8) command:
full-duplex Force full duplex operation.
half-duplex Force half duplex operation.
For more information on configuring this device, see ifconfig(8).
HARDWARE The genet driver supports the Ethernet controller portion of the Broadcom BCM2711 on the Raspberry Pi 4 Model B and related systems. It utilizes the BCM54213PE PHY.
LOADER TUNABLES Tunables can be set at the loader(8) prompt before booting the kernel or
SYSCTL VARIABLES The following variable is available as a sysctl(8) variable:
hw.genet.tx_hdr_min When the driver is given an output packet in a buffer chain in which the first buffer contains only the Ethernet header, the number of bytes of the packet to add to the Ethernet header in the first buffer. Certain packets may be lost if this value is too small. The default value is 56, and is sufficient for the observed cases to date.
DIAGNOSTICS The genet driver has no diagnostics that are likely in normal operation. However, when the debug option is set with ifconfig(8), most failures that cause packet loss in the transmit and receive paths cause a cryptic diagnostic message naming the failure. These messages generally make sense only when looking at the driver source.
SEE ALSO altq(4), arp(4), miibus(4), netintro(4), ng_ether(4), vlan(4), ifconfig(8)
HISTORY The genet device driver first appeared in FreeBSD 13.0.
AUTHORS The genet driver was written by Mike Karels <karels@freebsd.org>. Portions are derived from the bcmgenet driver in NetBSD by Jared McNeill, and parts of the structure and common code are from the awg driver for the Allwinner EMAC by Jared McNeill.
FreeBSD 14.0-RELEASE-p6 December 8, 2021 FreeBSD 14.0-RELEASE-p6