xref: /freebsd/share/man/man4/umct.4 (revision f7c32ed617858bcd22f8d1b03199099d50125721)
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.\" $FreeBSD$
27.\"
28.Dd April 26, 2017
29.Dt UMCT 4
30.Os
31.Sh NAME
32.Nm umct
33.Nd Magic Control Technology USB-RS232 converter driver
34.Sh SYNOPSIS
35To compile this driver into the kernel,
36place the following lines in your
37kernel configuration file:
38.Bd -ragged -offset indent
39.Cd "device usb"
40.Cd "device ucom"
41.Cd "device umct"
42.Ed
43.Pp
44Alternatively, to load the driver as a
45module at boot time, place the following line in
46.Xr loader.conf 5 :
47.Bd -literal -offset indent
48umct_load="YES"
49.Ed
50.Sh DESCRIPTION
51The
52.Nm
53driver provides support for USB to RS-232 converters based on the Magic
54Control Technology USB-232 design.
55These devices support most of the
56standard RS-232 features including baud rates ranging from 300 to 115200
57bits per second.
58However, neither hardware nor software flow control
59seems to be supported.
60.Pp
61Access to devices under this driver is via the
62.Xr ucom 4
63framework and device nodes.
64.Sh HARDWARE
65The
66.Nm
67driver supports the following adapters:
68.Pp
69.Bl -bullet -compact
70.It
71Belkin F5U109
72.It
73Belkin F5U409
74.It
75D-Link DU-H3SP USB BAY Hub
76.It
77Magic Control Technology USB-232
78.It
79Sitecom USB-232
80.El
81.Sh FILES
82.Bl -tag -width "/dev/ttyU*.init" -compact
83.It Pa /dev/ttyU*
84for callin ports
85.It Pa /dev/ttyU*.init
86.It Pa /dev/ttyU*.lock
87corresponding callin initial-state and lock-state devices
88.Pp
89.It Pa /dev/cuaU*
90for callout ports
91.It Pa /dev/cuaU*.init
92.It Pa /dev/cuaU*.lock
93corresponding callout initial-state and lock-state devices
94.El
95.Sh SEE ALSO
96.Xr tty 4 ,
97.Xr ucom 4 ,
98.Xr usb 4
99.Sh HISTORY
100The
101.Nm
102driver
103appeared in
104.Fx 5.2 .
105It is loosely based on the
106.Xr ubsa 4
107driver by
108.An Alexander Kabaev Aq Mt kan@FreeBSD.org
109with documentation from
110.An Wolfgang Grandeggar Aq Mt wolfgang@cec.ch .
111.Sh AUTHORS
112The
113.Nm
114driver was written by
115.An Scott Long Aq Mt scottl@FreeBSD.org .
116