share/man/man4/umct.4

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