share/man/man4/uslcom.4

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