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