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