share/man/man4/uplcom.4

   1 .\" $NetBSD: uplcom.4,v 1.9 2002/02/07 03:15:09 ross Exp $
   2 .\"
   3 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Lennart Augustsson.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .\" $FreeBSD$
  31 .\"
  32 .Dd January 7, 2021
  33 .Dt UPLCOM 4
  34 .Os
  35 .Sh NAME
  36 .Nm uplcom
  37 .Nd USB support for Prolific PL-2303/2303X/2303HX serial adapters driver
  38 .Sh SYNOPSIS
  39 To compile this driver into the kernel,
  40 place the following lines in your
  41 kernel configuration file:
  42 .Bd -ragged -offset indent
  43 .Cd "device usb"
  44 .Cd "device ucom"
  45 .Cd "device uplcom"
  46 .Ed
  47 .Pp
  48 Alternatively, to load the driver as a
  49 module at boot time, place the following line in
  50 .Xr loader.conf 5 :
  51 .Bd -literal -offset indent
  52 uplcom_load="YES"
  53 .Ed
  54 .Sh DESCRIPTION
  55 The
  56 .Nm
  57 driver provides support for various serial adapters based on the Prolific
  58 PL-2303, PL-2303X and PL-2303HX USB-to-RS232 Bridge chips.
  59 .Pp
  60 The device is accessed through the
  61 .Xr ucom 4
  62 driver which makes it behave like a
  63 .Xr tty 4 .
  64 .Sh HARDWARE
  65 The
  66 .Nm
  67 driver supports the following devices and adapters:
  68 .Pp
  69 .Bl -bullet -compact
  70 .It
  71 ADLINK ND-6530 USB-Serial Adapter
  72 .It
  73 Alcatel One Touch 535/735 Phone
  74 .It
  75 Alcor AU9720 USB-RS232 Serial Adapter
  76 .It
  77 AlDiga AL-11U Modem
  78 .It
  79 Alltronix ACM003U00 Modem
  80 .It
  81 Anchor Serial adapter
  82 .It
  83 ATEN UC-232A
  84 .It
  85 ATEN UC-232B
  86 .It
  87 BAFO BF-800 and BF-810
  88 .It
  89 Belkin F5U257
  90 .It
  91 BenQ S81 Phone
  92 .It
  93 Corega CG-USBRS232R Serial Adapter
  94 .It
  95 Cressi Edy (Seiko) Diving Computer
  96 .It
  97 ELECOM UC-SGT Serial Adapter
  98 .It
  99 HAL Corporation Crossam2+USB IR commander
 100 .It
 101 Hama USB RS-232 Serial Adapter
 102 .It
 103 Hamlet exaggerate XURS232
 104 .It
 105 HP LD220 Point-Of-Sale (POS) Display
 106 .It
 107 IOGEAR UC-232A
 108 .It
 109 I/O DATA USB-RSAQ, USB-RSAQ2, USB-RSAQ3 and USB-RSAQ5
 110 .It
 111 iTegno WM1080A GSM/GFPRS Modem
 112 .It
 113 iTegno WM2080A CDMA Modem
 114 .It
 115 Leadtek 9531 GPS
 116 .It
 117 Micromax 610U Modem
 118 .It
 119 Microsoft Palm 700WX
 120 .It
 121 Mobile Action MA-620 Infrared Adapter
 122 .It
 123 Motorola Cables
 124 .It
 125 Nokia CA-42 Cable
 126 .It
 127 OTI DKU-5 cable
 128 .It
 129 Panasonic TY-TP50P6-S flat screen
 130 .It
 131 PLX CA-42 Phone Cable
 132 .It
 133 PLANEX USB-RS232 URS-03
 134 .It
 135 Prolific Generic USB-Serial Adapters
 136 .It
 137 Prolific Generic USB-Serial Adapters (HXN)
 138 .It
 139 Prolific Pharos USB-Serial Adapter
 140 .It
 141 Prolific USB-Serial Controller D
 142 .It
 143 RATOC REX-USB60
 144 .It
 145 Radio Shack USB Serial Cable
 146 .It
 147 Sagem USB-Serial Adapter
 148 .It
 149 Samsung I330 Phone Cradle
 150 .It
 151 Sandberg USB to Serial Link (model number 133-08)
 152 .It
 153 Sanwa KB-USB2 Multimeter cable
 154 .It
 155 Siemens/BenQ EF81, SX1, X65 and X75 Mobile Phones
 156 .It
 157 Sitecom USB-Serial Adapter
 158 .It
 159 SMART Technologies USB-Serial Adapter
 160 .It
 161 Sony QN3 Phone Cable
 162 .It
 163 Sony Ericsson Datapilot
 164 .It
 165 Sony Ericsson DCU-10 and DCU-11 (Susteen) USB Cables
 166 .It
 167 SOURCENEXT KeikaiDenwa 8 (with and without charger)
 168 .It
 169 Speed Dragon USB-Serial Cable
 170 .It
 171 Syntech CPT-8001C Barcode Scanner
 172 .It
 173 TDK UHA6400 and UPA9664 USB-PHS Adapters
 174 .It
 175 TRENDnet USB to Serial Converter (TU-S9)
 176 .It
 177 Tripp-Lite U209-000-R USB-Serial Adapter
 178 .It
 179 UIC HCR331 Magnetic Stripe Card Reader
 180 .It
 181 UIC MSR206 Magnetic Stripe Card Reader
 182 .It
 183 Willcom W-SIM DD PHS terminal.(WS002IN)
 184 .It
 185 YC-Cable USB-Serial Adapter
 186 .It
 187 Zeagle N2iTion3 Diving Computer
 188 .El
 189 .Sh SYSCTL VARIABLES
 190 The following variables are available as both
 191 .Xr sysctl 8
 192 variables and
 193 .Xr loader 8
 194 tunables:
 195 .Bl -tag -width indent
 196 .It Va hw.usb.uplcom.debug
 197 Debug output level, where 0 is debugging disabled and larger values increase
 198 debug message verbosity.
 199 Default is 0.
 200 .El
 201 .Sh FILES
 202 .Bl -tag -width "/dev/ttyU*.init" -compact
 203 .It Pa /dev/ttyU*
 204 for callin ports
 205 .It Pa /dev/ttyU*.init
 206 .It Pa /dev/ttyU*.lock
 207 corresponding callin initial-state and lock-state devices
 208 .Pp
 209 .It Pa /dev/cuaU*
 210 for callout ports
 211 .It Pa /dev/cuaU*.init
 212 .It Pa /dev/cuaU*.lock
 213 corresponding callout initial-state and lock-state devices
 214 .El
 215 .Sh SEE ALSO
 216 .Xr tty 4 ,
 217 .Xr ucom 4 ,
 218 .Xr usb 4
 219 .Sh HISTORY
 220 The
 221 .Nm
 222 driver
 223 appeared in
 224 .Nx 1.6 .
 225 This manual page was adopted from
 226 .Nx
 227 by
 228 .An Tom Rhodes Aq Mt trhodes@FreeBSD.org
 229 in April 2002.