AXGE(4)

💖 AXGE(4) 💖

okay bestie, sit down, hydrate, because today we're talking about axge — the ASIX Electronics AX88178A/AX88179 USB Gigabit Ethernet driver ✨ it's giving "my laptop has no ethernet port and I refuse to accept that" energy and honestly? iconic.

---

✨ NAME ✨

axge — the ASIX Electronics AX88178A/AX88179 USB Gigabit Ethernet driver 🦋

---

🌸 SYNOPSIS 🌸

so if you wanna compile this driver straight into the kernel (main character move, very committed), you drop these lines into your kernel configuration file:

device xhci
device ehci
device uhci
device ohci
device usb
device miibus
device uether
device axge

OR, if you'd rather be chill about it and just load the driver as a module at boot time (my personal fave, low effort high reward), you put this single line in loader.conf(5):

if_axge_load="YES"

that's it. one line. slay. 💅

---

👑 DESCRIPTION 👑

so the axge driver is here to provide support for USB Gigabit Ethernet adapters based on the ASIX Electronics AX88179 USB 3.0 and AX88178A USB 2.0 chipsets. fr fr, that's the whole job and it does it.

the AX88179 and AX88178A contain a 10/100/1000 Ethernet MAC with a GMII interface for interfacing with the Gigabit Ethernet PHY. very demure, very mindful, very gigabit.

these devices will operate with both USB 1.x and USB 2.0 controllers, and the AX88179 will operate with USB 3.0 controllers. packets are received and transmitted over separate USB bulk transfer endpoints — two endpoints, each doing their own little thing, we love a duo. 🫶

🎀 media types 🎀

the axge driver supports the following media types:

• autoselect — turns on autoselection of the media type and options. you can manually override the autoselected mode by adding media options to rc.conf(5), if you're feeling spicy.
• 10baseT/UTP — sets 10Mbps operation. the ifconfig(8) mediaopt option can also be used to select either full-duplex or half-duplex modes.
• 100baseTX — sets 100Mbps (Fast Ethernet) operation. the ifconfig(8) mediaopt option can also be used to select either full-duplex or half-duplex modes.
• 1000baseT — sets 1000Mbps (Gigabit Ethernet) operation (AX88178 only). the ifconfig(8) mediaopt option can also be used to select either full-duplex or half-duplex modes.

🌈 media options 🌈

and the axge driver supports the following media options:

• full-duplex — force full duplex operation. no negotiation, we're committing.
• half-duplex — force half duplex operation. also committing, just... less.

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

---

🦋 SEE ALSO 🦋

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

like, go read them, they're all right there, iykyk ⭐

---

⭐ HISTORY ⭐

the axge device driver first appeared in FreeBSD 10.1. a whole era. 😭

---

💖 AUTHORS 💖

the axge driver was written by Kevin Lo <kevlo@FreeBSD.org> and Li-Wen Hsu <lwhsu@FreeBSD.org>. this manual page was adapted by Mark Johnston <markj@FreeBSD.org> from the axe(4) manual page. legends, all three of them, no cap 👑

---

aaaand that's the whole page bestie!! 🎀 this one came to you courtesy of Debian, dated November 24, 2015 — yeah it's an oldie but it's still serving 💅✨ bye ily, go plug in your ethernet adapter 🦋