UGENSA(4)

NAME
ugensa - Generic USB serial device

SYNOPSIS
To compile this driver into the kernel, place the following lines in your kernel configuration file:

device ugensa
device ucom

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):

    ugensa_load="YES"

DESCRIPTION
The ugensa is the minimal USB serial driver written to support virtual serial ports in devices where hardware specific settings (baudrate, flow control etc) don't make sense or just don't apply.

The virtual serial ports are accessed through the ucom(4) driver which makes them behave like a tty(4).

The ugensa driver was originally written to support Qualcomm MSM chipset found in EVDO and UMTS capable modems, but there is nothing MSM chipset specific in it. Many devices supported by the driver aren't typical USB devices, but CardBus, ExpressCard or PCI Express Mini Cards that incorporate a USB controller with the actual devices attached to it.

Communication devices supported by the ugensa driver typically have more than one virtual serial port, but only one of them (usually the first one) can be used with ppp(8). At least one of additional ports can usually be used for device/network monitoring and other communication tasks (like SMS for example). Protocols and methods used to access these features are out of scope of this driver.

The following devices should work with the ugensa driver:

Device |  | Bus
AirPrime PC5220 | | CardBus
AnyDATA ADU-E100A/D/H | | USB
Dell Wireless 5500 | | PCI Express Mini Card
Dell Wireless 5505 | | PCI Express Mini Card
Dell Wireless 5510 | | PCI Express Mini Card
Dell Wireless 5520 | | PCI Express Mini Card
Dell Wireless 5700 | | PCI Express Mini Card
Dell Wireless 5700 | | ExpressCard
Huawei Mobile Connect | | CardBus
Huawei E220 | | USB
Kyocera KPC650 | | CardBus
Novatel Wireless Expedite EU740 | | PCI Express Mini Card
Novatel Wireless Expedite EU870D | | PCI Express Mini Card
Novatel Wireless Expedite EV620 | | PCI Express Mini Card
Novatel Wireless Merlin ES620 | | CardBus
Novatel Wireless Merlin ES720 | | CardBus
Novatel Wireless Merlin EX720 | | ExpressCard
Novatel Wireless Merlin S620 | | CardBus
Novatel Wireless Merlin S640 | | CardBus
Novatel Wireless Merlin S720 | | CardBus
Novatel Wireless Merlin U730 | | CardBus
Novatel Wireless Merlin U740 | | CardBus
Novatel Wireless Merlin V620 | | CardBus
Novatel Wireless Merlin XS620 | ExpressCard
Novatel Wireless Merlin XU870 | ExpressCard
Novatel Wireless Ovation U720 | | USB
Novatel Wireless Ovation MC727 | | USB
Novatel Wireless Ovation MC950D | | USB
ONDA Communication H600 | | CardBus
Sierra Wireless MC5720 | | PCI Express Mini Card
Sierra Wireless MC5725 | | PCI Express Mini Card
Sierra Wireless MC8755 | | PCI Express Mini Card
Sierra Wireless MC8765 | | PCI Express Mini Card
Sierra Wireless MC8775 | | PCI Express Mini Card
Sierra Wireless MC8780 | | PCI Express Mini Card
Sierra Wireless MC8781 | | PCI Express Mini Card
Sierra Wireless AirCard 580 | | CardBus
Sierra Wireless AirCard 595 | | CardBus
Sierra Wireless AirCard 595U | | USB
Sierra Wireless AirCard 597E | | ExpressCard
Sierra Wireless AirCard 875 | | CardBus
Sierra Wireless AirCard 880 | | CardBus
Sierra Wireless AirCard 880E | | ExpressCard
Sierra Wireless AirCard 880U | | USB
Sierra Wireless AirCard 881 | | CardBus
Sierra Wireless AirCard 881E | | ExpressCard
Sierra Wireless AirCard 881U | | USB

Due to rebranding (which is very common in mobile broadband business) this list is certainly incomplete.

SEE ALSO
tty(4), ucom(4), usb(4), ppp(8)

HISTORY
The ugensa device driver first appeared in OpenBSD 4.0 as umsm. It was imported into DragonFly 1.11 with its present name and extended to support multiple virtual serial ports per device.

AUTHORS
-nosplit The ugensa driver was written by Jonathan Gray <jsg@openbsd.org>.

CAVEATS
For Verizon Wireless (and possibly other services), cards require a one-time activation before they will work.