1.\" $OpenBSD: umsm.4,v 1.20 2007/05/31 19:19:52 jmc Exp $ 2.\" 3.\" Copyright (c) 2006 Jonathan Gray <jsg@openbsd.org> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd October 17, 2017 18.Dt UGENSA 4 19.Os 20.Sh NAME 21.Nm ugensa 22.Nd Generic USB serial device 23.Sh SYNOPSIS 24To compile this driver into the kernel, place the following lines in your 25kernel configuration file: 26.Bd -ragged -offset indent 27.Cd "device ugensa" 28.Cd "device ucom" 29.Ed 30.Pp 31Alternatively, to load the driver as a module at boot time, place the 32following line in 33.Xr loader.conf 5 : 34.Bd -literal -offset indent 35ugensa_load="YES" 36.Ed 37.Sh DESCRIPTION 38The 39.Nm 40is the minimal USB serial driver written to support virtual serial ports in 41devices where hardware specific settings (baudrate, flow control etc) don't 42make sense or just don't apply. 43.Pp 44The virtual serial ports are accessed through the 45.Xr ucom 4 46driver which makes them behave like a 47.Xr tty 4 . 48.Pp 49The 50.Nm 51driver was originally written to support Qualcomm MSM chipset found in EVDO 52and UMTS capable modems, but there is nothing MSM chipset specific in it. 53Many devices supported by the driver aren't typical USB devices, but CardBus, 54ExpressCard or PCI Express Mini Cards that incorporate a USB controller 55with the actual devices attached to it. 56.Pp 57Communication devices supported by the 58.Nm 59driver typically have more than one virtual serial port, but only one of 60them (usually the first one) can be used with 61.Xr ppp 8 . 62At least one of additional ports can usually be used for device/network 63monitoring and other communication tasks (like SMS for example). 64Protocols and methods used to access these features are out of scope of this 65driver. 66.Pp 67The following devices should work with the 68.Nm 69driver: 70.Pp 71.Bl -column "Device " "Bus" -compact -offset 6n 72.It Em "Device Bus" 73.It Li "AirPrime PC5220" Ta Ta CardBus 74.It Li "AnyDATA ADU-E100A/D/H" Ta Ta USB 75.It Li "Dell Wireless 5500" Ta Ta PCI Express Mini Card 76.It Li "Dell Wireless 5505" Ta Ta PCI Express Mini Card 77.It Li "Dell Wireless 5510" Ta Ta PCI Express Mini Card 78.It Li "Dell Wireless 5520" Ta Ta PCI Express Mini Card 79.It Li "Dell Wireless 5700" Ta Ta PCI Express Mini Card 80.It Li "Dell Wireless 5700" Ta Ta ExpressCard 81.It Li "Huawei Mobile Connect" Ta Ta CardBus 82.It Li "Huawei E220" Ta Ta USB 83.It Li "Kyocera KPC650" Ta Ta CardBus 84.It Li "Novatel Wireless Expedite EU740" Ta Ta PCI Express Mini Card 85.It Li "Novatel Wireless Expedite EU870D" Ta Ta PCI Express Mini Card 86.It Li "Novatel Wireless Expedite EV620" Ta Ta PCI Express Mini Card 87.It Li "Novatel Wireless Merlin ES620" Ta Ta CardBus 88.It Li "Novatel Wireless Merlin ES720" Ta Ta CardBus 89.It Li "Novatel Wireless Merlin EX720" Ta Ta ExpressCard 90.It Li "Novatel Wireless Merlin S620" Ta Ta CardBus 91.It Li "Novatel Wireless Merlin S640" Ta Ta CardBus 92.It Li "Novatel Wireless Merlin S720" Ta Ta CardBus 93.It Li "Novatel Wireless Merlin U730" Ta Ta CardBus 94.It Li "Novatel Wireless Merlin U740" Ta Ta CardBus 95.It Li "Novatel Wireless Merlin V620" Ta Ta CardBus 96.It Li "Novatel Wireless Merlin XS620" Ta ExpressCard 97.It Li "Novatel Wireless Merlin XU870" Ta ExpressCard 98.It Li "Novatel Wireless Ovation U720" Ta Ta USB 99.It Li "Novatel Wireless Ovation MC727" Ta Ta USB 100.It Li "Novatel Wireless Ovation MC950D" Ta Ta USB 101.It Li "ONDA Communication H600" Ta Ta CardBus 102.It Li "Sierra Wireless MC5720" Ta Ta PCI Express Mini Card 103.It Li "Sierra Wireless MC5725" Ta Ta PCI Express Mini Card 104.It Li "Sierra Wireless MC8755" Ta Ta PCI Express Mini Card 105.It Li "Sierra Wireless MC8765" Ta Ta PCI Express Mini Card 106.It Li "Sierra Wireless MC8775" Ta Ta PCI Express Mini Card 107.It Li "Sierra Wireless MC8780" Ta Ta PCI Express Mini Card 108.It Li "Sierra Wireless MC8781" Ta Ta PCI Express Mini Card 109.It Li "Sierra Wireless AirCard 580" Ta Ta CardBus 110.It Li "Sierra Wireless AirCard 595" Ta Ta CardBus 111.It Li "Sierra Wireless AirCard 595U" Ta Ta USB 112.It Li "Sierra Wireless AirCard 597E" Ta Ta ExpressCard 113.It Li "Sierra Wireless AirCard 875" Ta Ta CardBus 114.It Li "Sierra Wireless AirCard 880" Ta Ta CardBus 115.It Li "Sierra Wireless AirCard 880E" Ta Ta ExpressCard 116.It Li "Sierra Wireless AirCard 880U" Ta Ta USB 117.It Li "Sierra Wireless AirCard 881" Ta Ta CardBus 118.It Li "Sierra Wireless AirCard 881E" Ta Ta ExpressCard 119.It Li "Sierra Wireless AirCard 881U" Ta Ta USB 120.El 121.Pp 122Due to rebranding (which is very common in mobile broadband business) this 123list is certainly incomplete. 124.Sh SEE ALSO 125.Xr tty 4 , 126.Xr ucom 4 , 127.Xr usb 4 , 128.Xr ppp 8 129.Sh HISTORY 130The 131.Nm 132device driver first appeared in 133.Ox 4.0 134as 135.Nm umsm . 136It was imported into 137.Dx 1.11 138with its present name and extended to support multiple virtual serial ports 139per device. 140.Sh AUTHORS 141.An -nosplit 142The 143.Nm 144driver was written by 145.An Jonathan Gray Aq Mt jsg@openbsd.org . 146.Sh CAVEATS 147For Verizon Wireless (and possibly other services), cards require a one-time 148activation before they will work. 149