xref: /freebsd/share/man/man4/uplcom.4 (revision e2eeea75eb8b6dd50c1298067a0655880d186734)
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
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 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