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