d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
2a22d4279f
freebsd-skq/share/man/man4/uslcom.4

227 lines
4.5 KiB
Groff
Raw Normal View History

Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
.\" $OpenBSD: uslcom.4,v 1.6 2007/10/08 03:10:42 jcs Exp $
.\"
.\" Copyright (c) 2006 Jonathan Gray <jsg@openbsd.org>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.\" $FreeBSD$
.\"
Add information about device nodes to man pages for USB serial drivers. MFC after: 2 weeks
2017-04-26 19:51:10 +00:00
.Dd April 26, 2017
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
.Dt USLCOM 4
.Os
.Sh NAME
.Nm uslcom
Support multiple interface devices. The driver had previously hardcoded support for only the first port, but the CP2105 can have multiple ports. Although this allowed the first port to mostly work on multi port devices, there could be issues with this arrangement. Update the man page to reflect support for both ports and the CP2105. Many thanks to Silicon Labs (www.silabs.com) for providing a CP2105-EK dev board for testing. MFC after: 2 weeks
2012-08-04 15:11:36 +00:00
.Nd Silicon Laboratories CP2101/CP2102/CP2103/CP2104/CP2105 based USB serial adapter
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
.Sh SYNOPSIS
To compile this driver into the kernel,
place the following lines in your
kernel configuration file:
.Bd -ragged -offset indent
- Add missing usb and ucom devices PR: usb/160301 Submitted by: Garrett Cooper <gcooper@ixsystems.com> Reviewed by: hselasky Approved by: hselasky, rwatson (mentor) MFC after: 3 Days
2011-11-20 12:18:21 +00:00
.Cd "device usb"
.Cd "device ucom"
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
.Cd "device uslcom"
.Ed
.Pp
Alternatively, to load the driver as a
module at boot time, place the following line in
.Xr loader.conf 5 :
.Bd -literal -offset indent
uslcom_load="YES"
.Ed
.Sh DESCRIPTION
The
.Nm
Support multiple interface devices. The driver had previously hardcoded support for only the first port, but the CP2105 can have multiple ports. Although this allowed the first port to mostly work on multi port devices, there could be issues with this arrangement. Update the man page to reflect support for both ports and the CP2105. Many thanks to Silicon Labs (www.silabs.com) for providing a CP2105-EK dev board for testing. MFC after: 2 weeks
2012-08-04 15:11:36 +00:00
driver supports Silicon Laboratories CP2101/CP2102/CP2103/CP2104/CP2105
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
based USB serial adapters.
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.Sh HARDWARE
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
The following devices should work with the
.Nm
driver:
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.Pp
.Bl -bullet -compact
.It
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
AC-Services CAN, CIS-IBUS, IBUS and OBD interfaces
.It
Aerocomm Radio
.It
AKTACOM ACE-1001 cable
.It
AMBER Wireless AMB2560
.It
Arkham DS-101 Adapter
.It
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
Argussoft ISP
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
Arygon Technologies Mifare RFID Reader
.It
AVIT Research USB-TTL interface
.It
B&G H3000 Data Cable
.It
Balluff RFID reader
.It
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
Baltech card reader
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
BEI USB VCP Sensor
.It
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
Burnside Telecom Desktop Mobile
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
chip45.com Crumb128 module
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
Clipsal 5000CT2, 5500PACA, 5500PCU, 560884, 5800PC, C5000CT2
and L51xx C-Bus Home Automation products
.It
Commander 2 EDGE(GSM) Modem
.It
Cygnal Fasttrax GPS and Debug adapter
.It
DataApex MultiCOM USB to RS232 converter
.It
Degree Controls USB adapter
.It
DekTec DTA Plus VHF/UHF Booster
.It
Dell DW700 GPS Receiver
.It
Digianswer ZigBee/802.15.4 MAC
.It
Dynastream ANT Development kits
.It
Elan USBcount50, USBscope50, USBpulse100 and USBwave12
.It
ELV USB-I2C interface
.It
EMS C1007 HF RFID controller
.It
Festo CPX-USB and CMSP interfaces
.It
Gemalto Prox-PU/CU contactless card reader
.It
Helicomm IP-Link 1220-DVM
.It
IMS USB-RS422 adapter
.It
Infinity GPS-MIC-1 Radio Monophone
.It
INSYS Modem
.It
IRZ SG-10 and MC35pu GSM/GPRS Modems
.It
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
Jablotron PC-60B
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
Kamstrup M-Bus Master MultiPort 250D
and Optical Eye/3 wire utility meter interfaces
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
Kyocera GPS
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
Link Instruments MS-019 and MS-028
Oscilloscope/Logic Analyzer/Pattern Generators
.It
Lipowsky Baby-JTAG, Baby-LIN and HARP-1
.It
MEI CashFlow SC and Series 2000 cash acceptors
.It
MJS USB-TOSLINK Adapter
.It
MobiData GPRS USB Modems
.It
MSD DashHawk
.It
Multiplex RC adapter
.It
Optris MSpro LT Thermometer
.It
Owen AC4 USB-RS485 converter
.It
Pirelli DP-L10 SIP phone
.It
PLX CA-42 Phone cable
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
Pololu USB to Serial
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
Procyon AVS Mind Machine
.It
Renesas RX-Stick for RX610
.It
Siemens MC60 Cable
.It
Support multiple interface devices. The driver had previously hardcoded support for only the first port, but the CP2105 can have multiple ports. Although this allowed the first port to mostly work on multi port devices, there could be issues with this arrangement. Update the man page to reflect support for both ports and the CP2105. Many thanks to Silicon Labs (www.silabs.com) for providing a CP2105-EK dev board for testing. MFC after: 2 weeks
2012-08-04 15:11:36 +00:00
Silicon Laboratories generic CP2101/CP2102/CP2103/CP2104/CP2105 chips
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
.It
Software Bisque Paramount ME
.It
SPORTident BSM7-D USB
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
Suunto Sports Instrument
.It
Syntech CipherLab USB Barcode Scanner
.It
T-Com TC 300 SIP phone
.It
Tams Master Easy Control
.It
Telegesis ETRX2USB
.It
Timewave HamLinkUSB
.It
Tracient RFID Reader
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.It
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
Track Systems Traqmate
Add support for more devices to uslcom(4). This commit syncronises the list of supported devices with the union of: NetBSD src/sys/dev/usb/uslsa.c 1.18 OpenBSD src/sys/dev/usb/uslcom.c 1.24 Linux source/drivers/usb/serial/cp210x.c HEAD Remove duplicate JABLOTRON PC60B entry. Note that some of the devices added here are multi-port devices. The uslcom(4) driver currently only supports the first port on such devices. Update the man page to reflect the full list of supported devices. Remove two caveats from the CAVEATS section, as both listed caveats no longer apply. Add a caveat about multi-port devices. MFC after: 2 weeks
2012-07-26 12:10:19 +00:00
.It
Vaisala USB Instrument cable
.It
VStabi Controller
.It
WAGO 750-923 USB Service Cable
.It
WaveSense Jazz Blood Glucose Meter
.It
WIENER Plein & Baus CML Data Logger, RCM Remote,
and PL512 and MPOD PSUs
.It
WMR RIGblaster Plug&Play and RIGtalk RT1
.It
Zephyr Bioharness
mdoc changes to make this manpage consistent with our other section 4 manpages.
2008-03-05 18:04:21 +00:00
.El
Add information about device nodes to man pages for USB serial drivers. MFC after: 2 weeks
2017-04-26 19:51:10 +00:00
.Sh FILES
Fix device paths for USB serial adapters: the formatting strings contain "%u", differently from eg uart(4) which uses "%r". Suggested by: bde@ MFC after: 2 weeks
2017-05-09 08:36:09 +00:00
.Bl -tag -width "/dev/ttyU*.init" -compact
.It Pa /dev/ttyU*
Add information about device nodes to man pages for USB serial drivers. MFC after: 2 weeks
2017-04-26 19:51:10 +00:00
for callin ports
Fix device paths for USB serial adapters: the formatting strings contain "%u", differently from eg uart(4) which uses "%r". Suggested by: bde@ MFC after: 2 weeks
2017-05-09 08:36:09 +00:00
.It Pa /dev/ttyU*.init
.It Pa /dev/ttyU*.lock
Add information about device nodes to man pages for USB serial drivers. MFC after: 2 weeks
2017-04-26 19:51:10 +00:00
corresponding callin initial-state and lock-state devices
.Pp
Fix device paths for USB serial adapters: the formatting strings contain "%u", differently from eg uart(4) which uses "%r". Suggested by: bde@ MFC after: 2 weeks
2017-05-09 08:36:09 +00:00
.It Pa /dev/cuaU*
Add information about device nodes to man pages for USB serial drivers. MFC after: 2 weeks
2017-04-26 19:51:10 +00:00
for callout ports
Fix device paths for USB serial adapters: the formatting strings contain "%u", differently from eg uart(4) which uses "%r". Suggested by: bde@ MFC after: 2 weeks
2017-05-09 08:36:09 +00:00
.It Pa /dev/cuaU*.init
.It Pa /dev/cuaU*.lock
Add information about device nodes to man pages for USB serial drivers. MFC after: 2 weeks
2017-04-26 19:51:10 +00:00
corresponding callout initial-state and lock-state devices
.El
Import uslcom(4) from OpenBSD - this is a driver for Silicon Laboratories CP2101/CP2102 based USB serial adapters. Reviewed by: imp, emaste Obtained from: OpenBSD MFC after: 2 weeks
2008-03-05 14:13:30 +00:00
.Sh SEE ALSO
.Xr tty 4 ,
.Xr ucom 4 ,
.Xr usb 4
.Sh HISTORY
The
.Nm
device driver first appeared in
.Ox 4.0 .
The first
.Fx
release to include it was
.Fx 7.1 .
.Sh AUTHORS
The
.Nm
driver was written by
use .Mt to mark up email addresses consistently (final part) PR: 191174 Submitted by: Franco Fichtner <franco at lastsummer.de>
2014-06-26 21:46:14 +00:00
.An Jonathan Gray Aq Mt jsg@openbsd.org .
Reference in New Issue Copy Permalink