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