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.\" $FreeBSD$ 30.\" 31.Dd April 26, 2017 32.Dt UMCS 4 33.Os 34.Sh NAME 35.Nm umcs 36.Nd USB support for serial adapters based on the MCS7820 and MCS7840 chips 37.Sh SYNOPSIS 38To compile this driver into the kernel, 39place the following lines in your 40kernel configuration file: 41.Bd -ragged -offset indent 42.Cd "device usb" 43.Cd "device ucom" 44.Cd "device umcs" 45.Ed 46.Pp 47Alternatively, to load the driver as a 48module at boot time, place the following line in 49.Xr loader.conf 5 : 50.Bd -literal -offset indent 51umcs_load="YES" 52.Ed 53.Sh DESCRIPTION 54The 55.Nm 56driver provides support for various multiport serial adapters based on the MosCom 57MCS7820 and MCS7840 chips. 58They are 2- or 4-port adapters with full-featured 5916550-compatible UARTs and very flexible baud generators. 60Also, these chips 61support RS422/RS485 and IrDA operations. 62.Pp 63The device is accessed through the 64.Xr ucom 4 65driver which makes it behave like a 66.Xr tty 4 . 67.Pp 68Different ports on device are presented as sub-units, like 69.Pa /dev/ttyU0.1 70and 71.Pa /dev/ttyU0.2 . 72.Sh HARDWARE 73The 74.Nm 75driver was tested on the following adapters: 76.Pp 77.Bl -bullet -compact 78.It 79ST Lab U-360 two-port serial USB adapter 80.It 81ST Lab U-400 four-port serial USB adapter 82.El 83.Sh FILES 84.Bl -tag -width "/dev/ttyU*.*.init" -compact 85.It Pa /dev/ttyU*.* 86for callin ports 87.It Pa /dev/ttyU*.*.init 88.It Pa /dev/ttyU*.*.lock 89corresponding callin initial-state and lock-state devices 90.Pp 91.It Pa /dev/cuaU*.* 92for callout ports 93.It Pa /dev/cuaU*.*.init 94.It Pa /dev/cuaU*.*.lock 95corresponding callout initial-state and lock-state devices 96.El 97.Sh SEE ALSO 98.Xr tty 4 , 99.Xr ucom 4 , 100.Xr usb 4 101.Sh HISTORY 102The 103.Nm 104driver 105appeared in ports since December of 2010. 106.Sh AUTHORS 107.An -nosplit 108The 109.Nm 110driver was written by 111.An Lev Serebryakov Aq Mt lev@FreeBSD.org . 112.Sh BUGS 113This driver doesn't support access to any fine tunes of 114chip, like RS522/RS485 mode, non-standard baudrates, etc. 115