xref: /dflybsd-src/share/man/man4/umcs.4 (revision 4d6d0d0dfb28befba604c08220058df8e63579bc)
1*4d6d0d0dSSascha Wildner.\"
2*4d6d0d0dSSascha Wildner.\" Copyright (c) 2010 Lev Serebryakov <lev@FreeBSD.org>.
3*4d6d0d0dSSascha Wildner.\" All rights reserved.
4*4d6d0d0dSSascha Wildner.\"
5*4d6d0d0dSSascha Wildner.\" This code is derived from software contributed to The NetBSD Foundation
6*4d6d0d0dSSascha Wildner.\" by Lennart Augustsson.
7*4d6d0d0dSSascha Wildner.\"
8*4d6d0d0dSSascha Wildner.\" Redistribution and use in source and binary forms, with or without
9*4d6d0d0dSSascha Wildner.\" modification, are permitted provided that the following conditions
10*4d6d0d0dSSascha Wildner.\" are met:
11*4d6d0d0dSSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
12*4d6d0d0dSSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
13*4d6d0d0dSSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
14*4d6d0d0dSSascha Wildner.\"    notice, this list of conditions and the following disclaimer in the
15*4d6d0d0dSSascha Wildner.\"    documentation and/or other materials provided with the distribution.
16*4d6d0d0dSSascha Wildner.\"
17*4d6d0d0dSSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
18*4d6d0d0dSSascha Wildner.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
19*4d6d0d0dSSascha Wildner.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
20*4d6d0d0dSSascha Wildner.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
21*4d6d0d0dSSascha Wildner.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22*4d6d0d0dSSascha Wildner.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23*4d6d0d0dSSascha Wildner.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24*4d6d0d0dSSascha Wildner.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
25*4d6d0d0dSSascha Wildner.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26*4d6d0d0dSSascha Wildner.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27*4d6d0d0dSSascha Wildner.\" POSSIBILITY OF SUCH DAMAGE.
28*4d6d0d0dSSascha Wildner.\"
29*4d6d0d0dSSascha Wildner.\" $FreeBSD: head/share/man/man4/umcs.4 235317 2012-05-12 03:25:46Z gjb $
30*4d6d0d0dSSascha Wildner.\"
31*4d6d0d0dSSascha Wildner.Dd February 25, 2012
32*4d6d0d0dSSascha Wildner.Dt UMCS 4
33*4d6d0d0dSSascha Wildner.Os
34*4d6d0d0dSSascha Wildner.Sh NAME
35*4d6d0d0dSSascha Wildner.Nm umcs
36*4d6d0d0dSSascha Wildner.Nd USB support for serial adapters based on the MCS7820 and MCS7840 chips
37*4d6d0d0dSSascha Wildner.Sh SYNOPSIS
38*4d6d0d0dSSascha WildnerTo compile this driver into the kernel,
39*4d6d0d0dSSascha Wildnerplace the following lines in your
40*4d6d0d0dSSascha Wildnerkernel configuration file:
41*4d6d0d0dSSascha Wildner.Bd -ragged -offset indent
42*4d6d0d0dSSascha Wildner.Cd "device usb"
43*4d6d0d0dSSascha Wildner.Cd "device ucom"
44*4d6d0d0dSSascha Wildner.Cd "device umcs"
45*4d6d0d0dSSascha Wildner.Ed
46*4d6d0d0dSSascha Wildner.Pp
47*4d6d0d0dSSascha WildnerAlternatively, to load the driver as a
48*4d6d0d0dSSascha Wildnermodule at boot time, place the following line in
49*4d6d0d0dSSascha Wildner.Xr loader.conf 5 :
50*4d6d0d0dSSascha Wildner.Bd -literal -offset indent
51*4d6d0d0dSSascha Wildnerumcs_load="YES"
52*4d6d0d0dSSascha Wildner.Ed
53*4d6d0d0dSSascha Wildner.Sh DESCRIPTION
54*4d6d0d0dSSascha WildnerThe
55*4d6d0d0dSSascha Wildner.Nm
56*4d6d0d0dSSascha Wildnerdriver provides support for various multiport serial adapters based on the MosCom
57*4d6d0d0dSSascha WildnerMCS7820 and MCS7840 chips.
58*4d6d0d0dSSascha WildnerThey are 2- or 4-port adapters with full-featured
59*4d6d0d0dSSascha Wildner16550-compatible UARTs and very flexible baud generators.
60*4d6d0d0dSSascha WildnerAlso, these chips
61*4d6d0d0dSSascha Wildnersupport RS422/RS485 and IrDA operations.
62*4d6d0d0dSSascha Wildner.Pp
63*4d6d0d0dSSascha WildnerThe device is accessed through the
64*4d6d0d0dSSascha Wildner.Xr ucom 4
65*4d6d0d0dSSascha Wildnerdriver which makes it behave like a
66*4d6d0d0dSSascha Wildner.Xr tty 4 .
67*4d6d0d0dSSascha Wildner.Pp
68*4d6d0d0dSSascha WildnerDifferent ports on device are presented as sub-units, like
69*4d6d0d0dSSascha Wildner.Pa /dev/ttyU0.1
70*4d6d0d0dSSascha Wildnerand
71*4d6d0d0dSSascha Wildner.Pa /dev/ttyU0.2 .
72*4d6d0d0dSSascha Wildner.Sh HARDWARE
73*4d6d0d0dSSascha WildnerThe
74*4d6d0d0dSSascha Wildner.Nm
75*4d6d0d0dSSascha Wildnerdriver was tested on the following adapters:
76*4d6d0d0dSSascha Wildner.Pp
77*4d6d0d0dSSascha Wildner.Bl -bullet -compact
78*4d6d0d0dSSascha Wildner.It
79*4d6d0d0dSSascha WildnerST Lab U-360 two-port serial USB adapter
80*4d6d0d0dSSascha Wildner.It
81*4d6d0d0dSSascha WildnerST Lab U-400 four-port serial USB adapter
82*4d6d0d0dSSascha Wildner.El
83*4d6d0d0dSSascha Wildner.Sh SEE ALSO
84*4d6d0d0dSSascha Wildner.Xr tty 4 ,
85*4d6d0d0dSSascha Wildner.Xr ucom 4 ,
86*4d6d0d0dSSascha Wildner.Xr usb 4
87*4d6d0d0dSSascha Wildner.Sh HISTORY
88*4d6d0d0dSSascha WildnerThe
89*4d6d0d0dSSascha Wildner.Nm
90*4d6d0d0dSSascha Wildnerdriver
91*4d6d0d0dSSascha Wildnerappeared in ports since December of 2010.
92*4d6d0d0dSSascha Wildner.Sh AUTHORS
93*4d6d0d0dSSascha Wildner.An -nosplit
94*4d6d0d0dSSascha WildnerThe
95*4d6d0d0dSSascha Wildner.Nm
96*4d6d0d0dSSascha Wildnerdriver was written by
97*4d6d0d0dSSascha Wildner.An Lev Serebryakov
98*4d6d0d0dSSascha Wildner.Aq Mt lev@FreeBSD.org .
99*4d6d0d0dSSascha Wildner.Sh BUGS
100*4d6d0d0dSSascha WildnerThis driver doesn't support access to any fine tunes of
101*4d6d0d0dSSascha Wildnerchip, like RS522/RS485 mode, non-standard baudrates, etc.
102