xref: /freebsd/share/man/man4/uplcom.4 (revision 7899f917b1c0ea178f1d2be0cfb452086d079d23)
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.Dd January 7, 2021
31.Dt UPLCOM 4
32.Os
33.Sh NAME
34.Nm uplcom
35.Nd USB support for Prolific PL-2303/2303X/2303HX serial adapters driver
36.Sh SYNOPSIS
37To compile this driver into the kernel,
38place the following lines in your
39kernel configuration file:
40.Bd -ragged -offset indent
41.Cd "device usb"
42.Cd "device ucom"
43.Cd "device uplcom"
44.Ed
45.Pp
46Alternatively, to load the driver as a
47module at boot time, place the following line in
48.Xr loader.conf 5 :
49.Bd -literal -offset indent
50uplcom_load="YES"
51.Ed
52.Sh DESCRIPTION
53The
54.Nm
55driver provides support for various serial adapters based on the Prolific
56PL-2303, PL-2303X and PL-2303HX USB-to-RS232 Bridge chips.
57.Pp
58The device is accessed through the
59.Xr ucom 4
60driver which makes it behave like a
61.Xr tty 4 .
62.Sh HARDWARE
63The
64.Nm
65driver supports the following devices and adapters:
66.Pp
67.Bl -bullet -compact
68.It
69ADLINK ND-6530 USB-Serial Adapter
70.It
71Alcatel One Touch 535/735 Phone
72.It
73Alcor AU9720 USB-RS232 Serial Adapter
74.It
75AlDiga AL-11U Modem
76.It
77Alltronix ACM003U00 Modem
78.It
79Anchor Serial adapter
80.It
81ATEN UC-232A
82.It
83ATEN UC-232B
84.It
85BAFO BF-800 and BF-810
86.It
87Belkin F5U257
88.It
89BenQ S81 Phone
90.It
91Corega CG-USBRS232R Serial Adapter
92.It
93Cressi Edy (Seiko) Diving Computer
94.It
95ELECOM UC-SGT Serial Adapter
96.It
97HAL Corporation Crossam2+USB IR commander
98.It
99Hama USB RS-232 Serial Adapter
100.It
101Hamlet exaggerate XURS232
102.It
103HP LD220 Point-Of-Sale (POS) Display
104.It
105IOGEAR UC-232A
106.It
107I/O DATA USB-RSAQ, USB-RSAQ2, USB-RSAQ3 and USB-RSAQ5
108.It
109iTegno WM1080A GSM/GFPRS Modem
110.It
111iTegno WM2080A CDMA Modem
112.It
113Leadtek 9531 GPS
114.It
115Micromax 610U Modem
116.It
117Microsoft Palm 700WX
118.It
119Mobile Action MA-620 Infrared Adapter
120.It
121Motorola Cables
122.It
123Nokia CA-42 Cable
124.It
125OTI DKU-5 cable
126.It
127Panasonic TY-TP50P6-S flat screen
128.It
129PLX CA-42 Phone Cable
130.It
131PLANEX USB-RS232 URS-03
132.It
133Prolific Generic USB-Serial Adapters
134.It
135Prolific Generic USB-Serial Adapters (HXN)
136.It
137Prolific Pharos USB-Serial Adapter
138.It
139Prolific USB-Serial Controller D
140.It
141RATOC REX-USB60
142.It
143Radio Shack USB Serial Cable
144.It
145Sagem USB-Serial Adapter
146.It
147Samsung I330 Phone Cradle
148.It
149Sandberg USB to Serial Link (model number 133-08)
150.It
151Sanwa KB-USB2 Multimeter cable
152.It
153Siemens/BenQ EF81, SX1, X65 and X75 Mobile Phones
154.It
155Sitecom USB-Serial Adapter
156.It
157SMART Technologies USB-Serial Adapter
158.It
159Sony QN3 Phone Cable
160.It
161Sony Ericsson Datapilot
162.It
163Sony Ericsson DCU-10 and DCU-11 (Susteen) USB Cables
164.It
165SOURCENEXT KeikaiDenwa 8 (with and without charger)
166.It
167Speed Dragon USB-Serial Cable
168.It
169Syntech CPT-8001C Barcode Scanner
170.It
171TDK UHA6400 and UPA9664 USB-PHS Adapters
172.It
173TRENDnet USB to Serial Converter (TU-S9)
174.It
175Tripp-Lite U209-000-R USB-Serial Adapter
176.It
177UIC HCR331 Magnetic Stripe Card Reader
178.It
179UIC MSR206 Magnetic Stripe Card Reader
180.It
181Willcom W-SIM DD PHS terminal.(WS002IN)
182.It
183YC-Cable USB-Serial Adapter
184.It
185Zeagle N2iTion3 Diving Computer
186.El
187.Sh SYSCTL VARIABLES
188The following variables are available as both
189.Xr sysctl 8
190variables and
191.Xr loader 8
192tunables:
193.Bl -tag -width indent
194.It Va hw.usb.uplcom.debug
195Debug output level, where 0 is debugging disabled and larger values increase
196debug message verbosity.
197Default is 0.
198.El
199.Sh FILES
200.Bl -tag -width "/dev/ttyU*.init" -compact
201.It Pa /dev/ttyU*
202for callin ports
203.It Pa /dev/ttyU*.init
204.It Pa /dev/ttyU*.lock
205corresponding callin initial-state and lock-state devices
206.Pp
207.It Pa /dev/cuaU*
208for callout ports
209.It Pa /dev/cuaU*.init
210.It Pa /dev/cuaU*.lock
211corresponding 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
218The
219.Nm
220driver
221appeared in
222.Nx 1.6 .
223This manual page was adopted from
224.Nx
225by
226.An Tom Rhodes Aq Mt trhodes@FreeBSD.org
227in April 2002.
228