share/man/man4/uslcom.4

   1 .\"     $OpenBSD: uslcom.4,v 1.6 2007/10/08 03:10:42 jcs Exp $
   2 .\"
   3 .\" Copyright (c) 2006 Jonathan Gray <jsg@openbsd.org>
   4 .\"
   5 .\" Permission to use, copy, modify, and distribute this software for any
   6 .\" purpose with or without fee is hereby granted, provided that the above
   7 .\" copyright notice and this permission notice appear in all copies.
   8 .\"
   9 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16 .\"
  17 .\" $FreeBSD$
  18 .\"
  19 .Dd May 31, 2007
  20 .Dt USLCOM 4
  21 .Os
  22 .Sh NAME
  23 .Nm uslcom
  24 .Nd Silicon Laboratories CP2101/CP2102 based USB serial adapter
  25 .Sh SYNOPSIS
  26 To compile this driver into the kernel,
  27 place the following lines in your
  28 kernel configuration file:
  29 .Bd -ragged -offset indent
  30 .Cd "device uslcom"
  31 .Cd "device ucom"
  32 .Ed
  33 .Pp
  34 Alternatively, to load the driver as a
  35 module at boot time, place the following line in
  36 .Xr loader.conf 5 :
  37 .Bd -literal -offset indent
  38 uslcom_load="YES"
  39 .Ed
  40 .Sh DESCRIPTION
  41 The
  42 .Nm
  43 driver supports Silicon Laboratories CP2101/CP2102 based serial adapters.
  44 .Sh HARDWARE
  45 The following devices should work with the
  46 .Nm
  47 driver:
  48 .Pp
  49 .Bl -bullet -compact
  50 .It
  51 Argussoft ISP
  52 .It
  53 Baltech card reader
  54 .It
  55 Burnside Telecom Desktop Mobile
  56 .It
  57 chip45.com Crumb128 module
  58 .It
  59 Jablotron PC-60B
  60 .It
  61 Lipowsky Baby-JTAG
  62 .It
  63 Lipowsky Baby-LIN
  64 .It
  65 Lipowsky HARP-1
  66 .It
  67 Pololu USB to Serial
  68 .It
  69 Silicon Laboratories CP2101
  70 .It
  71 Silicon Laboratories CP2102
  72 .It
  73 Track Systems Traqmate
  74 .El
  75 .Sh SEE ALSO
  76 .Xr tty 4 ,
  77 .Xr ucom 4 ,
  78 .Xr usb 4
  79 .Sh HISTORY
  80 The
  81 .Nm
  82 device driver first appeared in
  83 .Ox 4.0 .
  84 The first
  85 .Fx
  86 release to include it was
  87 .Fx 7.1 .
  88 .Sh AUTHORS
  89 The
  90 .Nm
  91 driver was written by
  92 .An Jonathan Gray Aq jsg@openbsd.org .
  93 .Sh CAVEATS
  94 Setting hardware flow control is not currently supported.
  95 .Pp
  96 Silicon Laboratories do not release any programming information
  97 on their products.