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 April 24, 2018
  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 Pharos USB-Serial Adapter
 138 .It
 139 Prolific USB-Serial Controller D
 140 .It
 141 RATOC REX-USB60
 142 .It
 143 Radio Shack USB Serial Cable
 144 .It
 145 Sagem USB-Serial Adapter
 146 .It
 147 Samsung I330 Phone Cradle
 148 .It
 149 Sandberg USB to Serial Link (model number 133-08)
 150 .It
 151 Sanwa KB-USB2 Multimeter cable
 152 .It
 153 Siemens/BenQ EF81, SX1, X65 and X75 Mobile Phones
 154 .It
 155 Sitecom USB-Serial Adapter
 156 .It
 157 SMART Technologies USB-Serial Adapter
 158 .It
 159 Sony QN3 Phone Cable
 160 .It
 161 Sony Ericsson Datapilot
 162 .It
 163 Sony Ericsson DCU-10 and DCU-11 (Susteen) USB Cables
 164 .It
 165 SOURCENEXT KeikaiDenwa 8 (with and without charger)
 166 .It
 167 Speed Dragon USB-Serial Cable
 168 .It
 169 Syntech CPT-8001C Barcode Scanner
 170 .It
 171 TDK UHA6400 and UPA9664 USB-PHS Adapters
 172 .It
 173 TRENDnet USB to Serial Converter (TU-S9)
 174 .It
 175 Tripp-Lite U209-000-R USB-Serial Adapter
 176 .It
 177 UIC HCR331 Magnetic Stripe Card Reader
 178 .It
 179 UIC MSR206 Magnetic Stripe Card Reader
 180 .It
 181 Willcom W-SIM DD PHS terminal.(WS002IN)
 182 .It
 183 YC-Cable USB-Serial Adapter
 184 .It
 185 Zeagle N2iTion3 Diving Computer
 186 .El
 187 .Sh SYSCTL VARIABLES
 188 The following variables are available as both
 189 .Xr sysctl 8
 190 variables and
 191 .Xr loader 8
 192 tunables:
 193 .Bl -tag -width indent
 194 .It Va hw.usb.uplcom.debug
 195 Debug output level, where 0 is debugging disabled and larger values increase
 196 debug message verbosity.
 197 Default is 0.
 198 .El
 199 .Sh FILES
 200 .Bl -tag -width "/dev/ttyU*.init" -compact
 201 .It Pa /dev/ttyU*
 202 for callin ports
 203 .It Pa /dev/ttyU*.init
 204 .It Pa /dev/ttyU*.lock
 205 corresponding callin initial-state and lock-state devices
 206 .Pp
 207 .It Pa /dev/cuaU*
 208 for callout ports
 209 .It Pa /dev/cuaU*.init
 210 .It Pa /dev/cuaU*.lock
 211 corresponding callout initial-state and lock-state devices
 212 .El
 213 .Sh SEE ALSO
 214 .Xr tty 4 ,
 215 .Xr ucom 4 ,
 216 .Xr usb 4
 217 .Sh HISTORY
 218 The
 219 .Nm
 220 driver
 221 appeared in
 222 .Nx 1.6 .
 223 This manual page was adopted from
 224 .Nx
 225 by
 226 .An Tom Rhodes Aq Mt trhodes@FreeBSD.org
 227 in April 2002.