UGENSA(4)

💅 UGENSA(4) — like, the manual page for ugensa, bestie

okay so this is UGENSA(4), straight out of the Kernel Interfaces Manual, and it's genuinely one of the most "my USB dongle thinks it's a serial port" pages ever. let's get into it 🫶

---

🌸 NAME 🌸

ugensa — the USB generic serial adapter driver. yes that's the whole name, she's simple, she's iconic ✨

---

🎀 SYNOPSIS 🎀

ugensa*  at uhub?
ucom*  at ugensa?

so ugensa attaches at uhub? (that's a USB hub, duh) and then ucom* attaches at ugensa?. that's the whole config vibe — two lines, zero drama 💅

---

🔥 HARDWARE 🔥

ngl, this list is long, and the driver supports all of these adapters — or their USB device portion, for the ones that contain a USB host controller, a hub AND a USB device. multitasking queen energy fr fr 👑

• Airprime PC5220
• Novatel FlexPak GPS receiver
• Qualcom CDMA MSM (found in Kyocera KPC650 EVDO interface)
• Qualcom Inc. CDMA AC8700 (found in the ZTE 1x EVDO interface)
• Sierra AirCard 580
• Sierra AirCard 595
• Sierra AirCard 875 [not tested]
• Sierra Wireless EM5625 [not tested]
• Sierra Wireless MC5720 [not tested]
• Sierra Wireless MC5725 [not tested]
• Sierra Wireless MC8755 [not tested]
• Sierra Wireless MC8755 [not tested]
• Sierra Wireless MC8755 [not tested]
• Sierra Wireless MC8765 [not tested]
• Sierra Wireless MC8775 [not tested]
• Novatel Wireless Merlin CDMA (found in Verizon V620) [not tested]
• Novatel ExpressCard [not tested]
• Novatel Wireless S720 [not tested]
• Novatel Ovation U720 [not tested]
• Novatel Merlin XU870 HSDPA ExpressCard [not tested]
• Novatel Merlin ES620 [not tested]
• Dell/Novatel Wireless HDSPA modem
• Dell W5500 HDSPA modem [not tested]
• AnyDATA ADU-E500A [not tested]
• Linux's USB 3.0 debug port serial communication

and yes, Sierra Wireless MC8755 [not tested] is listed three separate times in the original and I'm keeping every single one, because who am I to edit the queen's list 💀 like, she said what she said.

---

💖 DESCRIPTION 💖

so what does ugensa actually do? she provides support for the USB-to-RS-232 Bridge chip that various vendors use — that's the whole gig, no cap 🔌

the device gets accessed through the ucom(4) driver, which is the icon that makes it behave like a tty(4). it's giving "serial port in a trench coat," and honestly? we love that for her 🦋

---

🌈 SEE ALSO 🌈

• tty(4)
• ucom(4)
• usb(4)

go read those too, iykyk 📚✨

---

⭐ HISTORY ⭐

the ugensa driver first appeared in NetBSD 3.0. vintage! she's an elder but she's still slaying 💜

---

and that's the whole page, bestie — from the Debian gang, dated July 4, 2020. periodt, drink some water, and go plug in a USB-to-serial adapter responsibly 🍓🧚