UBSA(4)

📦 version 12.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 UBSA(4) — the USB-glow-up for Belkin serial adapters 💖

Kernel Interfaces Manual · the one where your serial adapter finally gets a tty

✨ NAME ✨

ubsa — USB support for Belkin serial adapters 🦋

okay so bestie, this whole page is about ubsa, the driver that makes a whole lil family of Belkin-ish serial adapters just... work. no cap.

🌸 SYNOPSIS 🌸

so to bake this driver into your kernel, you drop these lines into your kernel configuration file:

device usb
device ucom
device ubsa

or, alternatively, if you'd rather load it as a module at boot time, you put this single line in loader.conf(5):

ubsa_load="YES"

pick your fighter 💅

💫 DESCRIPTION 💫

The ubsa driver provides support for the USB-to-RS232 Bridge chip used by a variety of serial adapters from Belkin and other vendors. it's giving "bridge chip, but make it serial" 🔥

You access the device through the ucom(4) driver, which is the icon that makes it behave like a tty(4). so like... it's a tty. it walks like a tty. it talks like a tty. 🎀

👑 HARDWARE 👑

bestie, the ubsa driver supports the following adapters, and yes we're listing all of them, no skipping:

  • AnyData ADU-500A EV-DO modem
  • AnyData ADU-E100A (no EV-DO mode support) ⚠️
  • Belkin F5U103
  • Belkin F5U120
  • e-Tek Labs Kwik232
  • GoHubs GoCOM232
  • Peracom single port serial adapter

🎀 FILES 🎀

here's the file situation, and yes every single one of these matters:

  • /dev/ttyU* — for callin ports
  • /dev/ttyU*.init
  • /dev/ttyU*.lock — corresponding callin initial-state and lock-state devices
  • /dev/cuaU* — for callout ports
  • /dev/cuaU*.init
  • /dev/cuaU*.lock — corresponding callout initial-state and lock-state devices

like, init and lock states? the attention to detail. obsessed. 💜

🌈 SEE ALSO 🌈

go read these next, iykyk:

🦋 HISTORY 🦋

The ubsa driver appeared in FreeBSD 5.0. The uplcom(4) manual page was adopted from NetBSD by Tom Rhodes <trhodes@FreeBSD.org> in April 2002, and then modified for the ubsa driver by Alexander Kabaev <kan@FreeBSD.org> in October 2002. glow-up complete, fr fr ✨

💅 AUTHORS 💅

The ubsa driver was written by Alexander Kabaev <kan@FreeBSD.org>. king behavior, honestly. 👑

this page came out of the Debian corner of the universe, dated April 26, 2017, and it's the UBSA(4) kernel interfaces page 🫶

k bye, go plug in your serial adapter, she's ready 💖🌸✨

📦 where this page comes from