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