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