MFC:
[dragonfly.git] / share / man / man4 / uslcom.4
blob93168a6865942b2994ea9bf8c8a6615118a8025e
1 .\"     $DragonFly: src/share/man/man4/uslcom.4,v 1.6 2008/01/28 14:57:52 matthias Exp $
2 .\"     $OpenBSD: uslcom.4,v 1.4 2007/02/17 01:47:47 jsg 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 August 15, 2007
19 .Dt USLCOM 4
20 .Os
21 .Sh NAME
22 .Nm uslcom
23 .Nd Silicon Laboratories CP2101, CP2102 and CP2103 USB to serial bridge
24 .Sh SYNOPSIS
25 To compile this driver into the kernel,
26 place the following lines in your
27 kernel configuration file:
28 .Bd -ragged -offset indent
29 .Cd "device uslcom"
30 .Cd "device ucom"
31 .Ed
32 .Pp
33 Alternatively, to load the driver as a
34 module at boot time, place the following line in
35 .Xr loader.conf 5 :
36 .Bd -literal -offset indent
37 uslcom_load="YES"
38 .Ed
39 .Sh DESCRIPTION
40 The
41 .Nm
42 driver supports devices based on Silicon Laboratories CP2101, CP2102 and
43 CP2103 USB to serial bridges.
44 .Pp
45 The following devices should work with the
46 .Nm
47 driver:
48 .Bl -bullet -compact
49 .It
50 Argussoft In-System Programmer
51 .It
52 Baltech card reader
53 .It
54 Burnside Telecom Desktop Mobile
55 .It
56 chip45.com Crumb128 module
57 .It
58 Enfora EDG1228 EDGE modem
59 .It
60 Helicomm IP-Link 1220-DVM
61 .It
62 Jablotron PC-60B
63 .It
64 Lipowsky Baby-JTAG
65 .It
66 Lipowsky Baby-LIN
67 .It
68 Lipowsky HARP-1
69 .It
70 Pololu USB to serial adapter
71 .It
72 Suunto USB to serial adapter
73 .It
74 Tracient RFID readers
75 .It
76 West Mountain Radio RIGblaster
77 .It
78 West Mountain Radio RIGtalk
79 .El
80 .Sh SEE ALSO
81 .Xr tty 4 ,
82 .Xr ucom 4 ,
83 .Xr usb 4
84 .Sh HISTORY
85 The
86 .Nm
87 device driver first appeared in
88 .Ox 4.0
89 and was imported into
90 .Dx 1.11 .
91 .Sh AUTHORS
92 .An -nosplit
93 The
94 .Nm
95 driver was written by
96 .An Jonathan Gray
97 .Aq jsg@openbsd.org .
98 .Sh CAVEATS
99 Setting hardware flow control is not tested.
101 Silicon Laboratories don't release any programming information
102 on their products.