UXRCOM(4)

πŸ“¦
version 11.0 Β· 2 versions
, in nixpkgs unstable

πŸ’… uxrcom β€” Exar XR21V141x USB serial adapter πŸŽ€

okay bestie, so this is a page from the Kernel Interfaces Manual (section 4, if you're keeping track) and it's all about uxrcom, which is literally the driver for Exar XR21V141x USB serial adapters. plug one in, get serial ports, live your best life. ✨


🌸 SYNOPSIS 🌸

uxrcom* at uhub?
ucom* at uxrcom?

so basically: uxrcom* attaches at uhub?, and then ucom* attaches at uxrcom?. it's giving very much "USB hub to driver to ucom" pipeline energy. πŸ¦‹


πŸ”Œ HARDWARE πŸ”Œ

the uxrcom driver supports serial adapters based on the XR21V1410, XR21V1412, and XR21V1414 chipsets. ngl that's the whole trio, no cap.

devices range from single port all the way to eight port β€” and the eight-port situation is implemented as a USB hub with two uxrcom four-port instances sitting behind it. like, main character hub energy with two four-port besties. πŸ‘‘

examples of hardware known to work with this driver are:

  • Gearmo GM-U28RS232 8 Port USB to Serial DB9 RS232 Adapter

(and yes, that name is a whole mouthful, but she works πŸ’–)


⭐ DESCRIPTION ⭐

the uxrcom driver attaches the Exar XR21V141x multiport chipset with individual port drivers via ucom(4), which makes it behave like a tty(4).

translation: each port gets its own little driver moment, and then ucom(4) does its thing so it feels just like a regular tty(4) to you. iconic behavior honestly. 🫢


πŸ¦‹ SEE ALSO πŸ¦‹

go read those too, bestie, they're all part of the lore. πŸ’œ


πŸŽ€ HISTORY πŸŽ€

the uxrcom device driver first appeared in OpenBSD 6.5 and in NetBSD 9.1.

so she's been out here slaying across two BSDs since forever. πŸ”₯


πŸ‘‘ AUTHORS πŸ‘‘

the uxrcom driver for the single port XR21V1410 was written by Mark Kettenis <kettenis@openbsd.org>.

the multi-port NetBSD driver is based on the OpenBSD driver but uses the common umodem(4) framework. the NetBSD driver was written by by Simon Burge ⟨simonb@NetBSD.org⟩.

(and yes, the original says "written by by" β€” we are respecting the sacred text, no edits, periodt. 😭)


a lil reminder: this page is from the Debian packaging, dated April 12, 2020, and it's UXRCOM(4) all the way down.</p>

alright bestie, that's the whole page β€” go forth and plug in your serial adapter, you've got this πŸ’…πŸŒˆπŸ’–

πŸ“¦ where this page comes from