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