xref: /freebsd/share/man/man4/umct.4 (revision 02e9120893770924227138ba49df1edb3896112a)
1.\"
2.\" Copyright (c) 2004 Scott Long
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
15.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
16.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
18.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
19.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
20.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
21.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
22.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
23.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
24.\" POSSIBILITY OF SUCH DAMAGE.
25.\"
26.Dd April 26, 2017
27.Dt UMCT 4
28.Os
29.Sh NAME
30.Nm umct
31.Nd Magic Control Technology USB-RS232 converter driver
32.Sh SYNOPSIS
33To compile this driver into the kernel,
34place the following lines in your
35kernel configuration file:
36.Bd -ragged -offset indent
37.Cd "device usb"
38.Cd "device ucom"
39.Cd "device umct"
40.Ed
41.Pp
42Alternatively, to load the driver as a
43module at boot time, place the following line in
44.Xr loader.conf 5 :
45.Bd -literal -offset indent
46umct_load="YES"
47.Ed
48.Sh DESCRIPTION
49The
50.Nm
51driver provides support for USB to RS-232 converters based on the Magic
52Control Technology USB-232 design.
53These devices support most of the
54standard RS-232 features including baud rates ranging from 300 to 115200
55bits per second.
56However, neither hardware nor software flow control
57seems to be supported.
58.Pp
59Access to devices under this driver is via the
60.Xr ucom 4
61framework and device nodes.
62.Sh HARDWARE
63The
64.Nm
65driver supports the following adapters:
66.Pp
67.Bl -bullet -compact
68.It
69Belkin F5U109
70.It
71Belkin F5U409
72.It
73D-Link DU-H3SP USB BAY Hub
74.It
75Magic Control Technology USB-232
76.It
77Sitecom USB-232
78.El
79.Sh FILES
80.Bl -tag -width "/dev/ttyU*.init" -compact
81.It Pa /dev/ttyU*
82for callin ports
83.It Pa /dev/ttyU*.init
84.It Pa /dev/ttyU*.lock
85corresponding callin initial-state and lock-state devices
86.Pp
87.It Pa /dev/cuaU*
88for callout ports
89.It Pa /dev/cuaU*.init
90.It Pa /dev/cuaU*.lock
91corresponding callout initial-state and lock-state devices
92.El
93.Sh SEE ALSO
94.Xr tty 4 ,
95.Xr ucom 4 ,
96.Xr usb 4
97.Sh HISTORY
98The
99.Nm
100driver
101appeared in
102.Fx 5.2 .
103It is loosely based on the
104.Xr ubsa 4
105driver by
106.An Alexander Kabaev Aq Mt kan@FreeBSD.org
107with documentation from
108.An Wolfgang Grandeggar Aq Mt wolfgang@cec.ch .
109.Sh AUTHORS
110The
111.Nm
112driver was written by
113.An Scott Long Aq Mt scottl@FreeBSD.org .
114