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