xref: /freebsd/share/man/man4/uslcom.4 (revision 2e3507c25e42292b45a5482e116d278f5515d04d)
1.\"	$OpenBSD: uslcom.4,v 1.6 2007/10/08 03:10:42 jcs 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 December 9, 2019
18.Dt USLCOM 4
19.Os
20.Sh NAME
21.Nm uslcom
22.Nd Silicon Laboratories CP2101/CP2102/CP2103/CP2104/CP2105 based USB serial adapter
23.Sh SYNOPSIS
24To compile this driver into the kernel,
25place the following lines in your
26kernel configuration file:
27.Bd -ragged -offset indent
28.Cd "device usb"
29.Cd "device ucom"
30.Cd "device uslcom"
31.Ed
32.Pp
33Alternatively, to load the driver as a
34module at boot time, place the following line in
35.Xr loader.conf 5 :
36.Bd -literal -offset indent
37uslcom_load="YES"
38.Ed
39.Sh DESCRIPTION
40The
41.Nm
42driver supports Silicon Laboratories CP2101/CP2102/CP2103/CP2104/CP2105
43based USB serial adapters.
44.Pp
45The datasheets for the CP2101/CP2102/CP2103 list the maximum
46supported baud rate as 921,600.
47Empirical testing has shown that the rates 1,228,800 and 1,843,200 also work,
48at least on some hardware, so the driver allows setting those rates.
49.Sh HARDWARE
50The following devices should work with the
51.Nm
52driver:
53.Pp
54.Bl -bullet -compact
55.It
56AC-Services CAN, CIS-IBUS, IBUS and OBD interfaces
57.It
58Aerocomm Radio
59.It
60AKTACOM ACE-1001 cable
61.It
62AMBER Wireless AMB2560
63.It
64Arkham DS-101 Adapter
65.It
66Argussoft ISP
67.It
68Arygon Technologies Mifare RFID Reader
69.It
70AVIT Research USB-TTL interface
71.It
72B&G H3000 Data Cable
73.It
74Balluff RFID reader
75.It
76Baltech card reader
77.It
78BEI USB VCP Sensor
79.It
80Burnside Telecom Desktop Mobile
81.It
82chip45.com Crumb128 module
83.It
84Clipsal 5000CT2, 5500PACA, 5500PCU, 560884, 5800PC, C5000CT2
85and L51xx C-Bus Home Automation products
86.It
87Commander 2 EDGE(GSM) Modem
88.It
89Cygnal Fasttrax GPS and Debug adapter
90.It
91DataApex MultiCOM USB to RS232 converter
92.It
93Degree Controls USB adapter
94.It
95DekTec DTA Plus VHF/UHF Booster
96.It
97Dell DW700 GPS Receiver
98.It
99Digianswer ZigBee/802.15.4 MAC
100.It
101Dynastream ANT Development kits
102.It
103Elan USBcount50, USBscope50, USBpulse100 and USBwave12
104.It
105ELV USB-I2C interface
106.It
107EMS C1007 HF RFID controller
108.It
109Festo CPX-USB and CMSP interfaces
110.It
111Gemalto Prox-PU/CU contactless card reader
112.It
113Helicomm IP-Link 1220-DVM
114.It
115IMS USB-RS422 adapter
116.It
117Infinity GPS-MIC-1 Radio Monophone
118.It
119INSYS Modem
120.It
121IRZ SG-10 and MC35pu GSM/GPRS Modems
122.It
123Jablotron PC-60B
124.It
125Kamstrup M-Bus Master MultiPort 250D
126and Optical Eye/3 wire utility meter interfaces
127.It
128Kyocera GPS
129.It
130Link Instruments MS-019 and MS-028
131Oscilloscope/Logic Analyzer/Pattern Generators
132.It
133Lipowsky Baby-JTAG, Baby-LIN and HARP-1
134.It
135MEI CashFlow SC and Series 2000 cash acceptors
136.It
137MJS USB-TOSLINK Adapter
138.It
139MobiData GPRS USB Modems
140.It
141MSD DashHawk
142.It
143Multiplex RC adapter
144.It
145Optris MSpro LT Thermometer
146.It
147Owen AC4 USB-RS485 converter
148.It
149Pirelli DP-L10 SIP phone
150.It
151PLX CA-42 Phone cable
152.It
153Pololu USB to Serial
154.It
155Procyon AVS Mind Machine
156.It
157Renesas RX-Stick for RX610
158.It
159Siemens MC60 Cable
160.It
161Silicon Laboratories generic CP2101/CP2102/CP2103/CP2104/CP2105 chips
162.It
163Software Bisque Paramount ME
164.It
165SPORTident BSM7-D USB
166.It
167Suunto Sports Instrument
168.It
169Syntech CipherLab USB Barcode Scanner
170.It
171T-Com TC 300 SIP phone
172.It
173Tams Master Easy Control
174.It
175Telegesis ETRX2USB
176.It
177Timewave HamLinkUSB
178.It
179Tracient RFID Reader
180.It
181Track Systems Traqmate
182.It
183Vaisala USB Instrument cable
184.It
185VStabi Controller
186.It
187WAGO 750-923 USB Service Cable
188.It
189WaveSense Jazz Blood Glucose Meter
190.It
191WIENER Plein & Baus CML Data Logger, RCM Remote,
192and PL512 and MPOD PSUs
193.It
194WMR RIGblaster Plug&Play and RIGtalk RT1
195.It
196Zephyr Bioharness
197.El
198.Sh FILES
199.Bl -tag -width "/dev/ttyU*.init" -compact
200.It Pa /dev/ttyU*
201for callin ports
202.It Pa /dev/ttyU*.init
203.It Pa /dev/ttyU*.lock
204corresponding callin initial-state and lock-state devices
205.Pp
206.It Pa /dev/cuaU*
207for callout ports
208.It Pa /dev/cuaU*.init
209.It Pa /dev/cuaU*.lock
210corresponding callout initial-state and lock-state devices
211.El
212.Sh SEE ALSO
213.Xr tty 4 ,
214.Xr ucom 4 ,
215.Xr usb 4
216.Sh HISTORY
217The
218.Nm
219device driver first appeared in
220.Ox 4.0 .
221The first
222.Fx
223release to include it was
224.Fx 7.1 .
225.Sh AUTHORS
226The
227.Nm
228driver was written by
229.An Jonathan Gray Aq Mt jsg@openbsd.org .
230