UPLCOM(4)

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

💅 UPLCOM(4) — the USB-to-serial driver that just gets it ✨

okay bestie, so sorry to hit you with the whole name but this is the uplcom page — literally the USB support for Prolific PL-2303/2303X/2303HX serial adapters driver. yeah. that whole thing. don't worry, we're gonna get through it together 🫶

🌈 SYNOPSIS

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

device usb
device ucom
device uplcom

OR, if you're more of a "load it as a module at boot time" girlie, just put this line into loader.conf(5):

uplcom_load="YES"

both are valid. pick your fighter 💖

✨ DESCRIPTION

k so the uplcom driver is out here providing support for various serial adapters based on the Prolific PL-2303, PL-2303X and PL-2303HX USB-to-RS232 Bridge chips. it's giving bridge. it's giving serial. it's giving everything tbh.

and the way you actually access the device? through the ucom(4) driver, which makes it behave like a tty(4). slay. iconic behavior. periodt 💅

👑 HARDWARE

okay this is the long part bestie, but every single one of these is supported by the uplcom driver, so let's get into it — no skips, we don't do that here:

  • ADLINK ND-6530 USB-Serial Adapter
  • Alcatel One Touch 535/735 Phone
  • Alcor AU9720 USB-RS232 Serial Adapter
  • AlDiga AL-11U Modem
  • Alltronix ACM003U00 Modem
  • Anchor Serial adapter
  • ATEN UC-232A
  • ATEN UC-232B
  • BAFO BF-800 and BF-810
  • Belkin F5U257
  • BenQ S81 Phone
  • Corega CG-USBRS232R Serial Adapter
  • Cressi Edy (Seiko) Diving Computer
  • ELECOM UC-SGT Serial Adapter
  • HAL Corporation Crossam2+USB IR commander
  • Hama USB RS-232 Serial Adapter
  • Hamlet exaggerate XURS232
  • HP LD220 Point-Of-Sale (POS) Display
  • IOGEAR UC-232A
  • I/O DATA USB-RSAQ, USB-RSAQ2, USB-RSAQ3 and USB-RSAQ5
  • iTegno WM1080A GSM/GFPRS Modem
  • iTegno WM2080A CDMA Modem
  • Leadtek 9531 GPS
  • Micromax 610U Modem
  • Microsoft Palm 700WX
  • Mobile Action MA-620 Infrared Adapter
  • Motorola Cables
  • Nokia CA-42 Cable
  • OTI DKU-5 cable
  • Panasonic TY-TP50P6-S flat screen
  • PLX CA-42 Phone Cable
  • PLANEX USB-RS232 URS-03
  • Prolific Generic USB-Serial Adapters
  • Prolific Generic USB-Serial Adapters (HXN)
  • Prolific Pharos USB-Serial Adapter
  • Prolific USB-Serial Controller D
  • RATOC REX-USB60
  • Radio Shack USB Serial Cable
  • Sagem USB-Serial Adapter
  • Samsung I330 Phone Cradle
  • Sandberg USB to Serial Link (model number 133-08)
  • Sanwa KB-USB2 Multimeter cable
  • Siemens/BenQ EF81, SX1, X65 and X75 Mobile Phones
  • Sitecom USB-Serial Adapter
  • SMART Technologies USB-Serial Adapter
  • Sony QN3 Phone Cable
  • Sony Ericsson Datapilot
  • Sony Ericsson DCU-10 and DCU-11 (Susteen) USB Cables
  • SOURCENEXT KeikaiDenwa 8 (with and without charger)
  • Speed Dragon USB-Serial Cable
  • Syntech CPT-8001C Barcode Scanner
  • TDK UHA6400 and UPA9664 USB-PHS Adapters
  • TRENDnet USB to Serial Converter (TU-S9)
  • Tripp-Lite U209-000-R USB-Serial Adapter
  • UIC HCR331 Magnetic Stripe Card Reader
  • UIC MSR206 Magnetic Stripe Card Reader
  • Willcom W-SIM DD PHS terminal.(WS002IN)
  • YC-Cable USB-Serial Adapter
  • Zeagle N2iTion3 Diving Computer

like… the range?? phones AND diving computers AND barcode scanners?? she contains multitudes fr fr 🦋

🎀 SYSCTL VARIABLES

hw.usb.uplcom.debug — okay so this is your debug output level bestie. 0 means debugging is disabled, and larger values increase debug message verbosity. default is 0. so like, if something's acting up, crank it and see what's tea ☕

and the tea is: the following variables are available as both sysctl(8) variables and loader(8) tunables. love that for us.

🍓 FILES

here's where the ports live:

  • /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

that's it. that's the whole vibe. know your paths 🧚

💜 SEE ALSO

go read these too, they're the supporting cast:

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

🔥 HISTORY

so the uplcom driver appeared in NetBSD 1.6, and this manual page was adopted from NetBSD by Tom Rhodes <trhodes@FreeBSD.org> in April 2002. a lil throwback, a lil lore drop. iykyk 💀

and that's the page bestie!! this one's from Debian, dated January 7, 2021 — go off, Debian, we love a documented driver. no cap, you're now officially an uplcom expert 🎀✨💖

📦 where this page comes from