UMCT(4)

📦
version 15.1 · 3 versions
, in freebsd 14.5, freebsd 15.1, nixpkgs unstable

💅 UMCT(4) — the Kernel Interfaces Manual, but make it cute

okay so bestie, welcome to umct(4) — your little corner of the kernel docs for a USB-to-RS232 converter driver. yes we're reading man pages together, it's a whole vibe, sit down 🎀

✨ NAME ✨

umct — the Magic Control Technology USB-RS232 converter driver. that's the whole name, no notes, slay.

🌸 SYNOPSIS 🌸

so if you wanna compile this driver into the kernel (main character energy, no modules, we live together now), you drop these lines into your kernel configuration file:

device usb
device ucom
device umct

or, alternative route, load it as a module at boot time like a normal person 🫶 — just put this line in loader.conf(5):

umct_load="YES"

💖 DESCRIPTION 💖

kay so umct gives you support for USB to RS-232 converters that are based on the Magic Control Technology USB-232 design. these devices are lowkey capable — they support most of the standard RS-232 features, including baud rates ranging from 300 to 115200 bits per second 🦋

but here's the thing, and I need you to hear me: neither hardware nor software flow control seems to be supported. like, at all. it's giving "we forgot that part" 😭 so no cap, don't count on flow control.

you get to these devices through the ucom(4) framework and device nodes. that's the door, that's the key, iykyk 🔑

👑 HARDWARE 👑

the umct driver says yes to these adapters, and honestly? taste:

  • Belkin F5U109
  • Belkin F5U409
  • D-Link DU-H3SP USB BAY Hub
  • Magic Control Technology USB-232
  • Sitecom USB-232

🎀 FILES 🎀

the callin ports:

  • /dev/ttyU* — for callin ports
  • /dev/ttyU*.init — corresponding callin initial-state device
  • /dev/ttyU*.lock — corresponding callin lock-state device

the callout ports:

  • /dev/cuaU* — for callout ports
  • /dev/cuaU*.init — corresponding callout initial-state device
  • /dev/cuaU*.lock — corresponding callout lock-state device

🌈 SEE ALSO 🌈

go read these next, bestie, they're literally the friends of this page:

tty(4), ucom(4), usb(4)

🧚 HISTORY 🧚

the umct driver appeared in FreeBSD 5.2 ⭐

and the lore? it's loosely based on the ubsa(4) driver by Alexander Kabaev <kan@FreeBSD.org>, with documentation from Wolfgang Grandeggar <wolfgang@cec.ch>. we stan credited sources 💜

💀 AUTHORS 💀

the umct driver was written by Scott Long <scottl@FreeBSD.org> — say thank you ✨

lowkey reminder before you go: no flow control. i said what i said. don't come for me, come for the hardware 🙈

okay bye bestie, this page is from Debian, dated April 26, 2017 — go forth and slay your serial connections 💅🔥

📦 where this page comes from