share/man/man4/uslcom.4

   1 .\"     $OpenBSD: uslcom.4,v 1.4 2007/02/17 01:47:47 jsg 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 .Dd August 15, 2007
  18 .Dt USLCOM 4
  19 .Os
  20 .Sh NAME
  21 .Nm uslcom
  22 .Nd Silicon Laboratories CP2101, CP2102 and CP2103 USB to serial bridge
  23 .Sh SYNOPSIS
  24 To compile this driver into the kernel,
  25 place the following lines in your
  26 kernel configuration file:
  27 .Bd -ragged -offset indent
  28 .Cd "device uslcom"
  29 .Cd "device ucom"
  30 .Ed
  31 .Pp
  32 Alternatively, to load the driver as a
  33 module at boot time, place the following line in
  34 .Xr loader.conf 5 :
  35 .Bd -literal -offset indent
  36 uslcom_load="YES"
  37 .Ed
  38 .Sh DESCRIPTION
  39 The
  40 .Nm
  41 driver supports devices based on Silicon Laboratories CP2101, CP2102 and
  42 CP2103 USB to serial bridges.
  43 .Pp
  44 The following devices should work with the
  45 .Nm
  46 driver:
  47 .Bl -bullet -compact
  48 .It
  49 Argussoft In-System Programmer
  50 .It
  51 Baltech card reader
  52 .It
  53 Burnside Telecom Desktop Mobile
  54 .It
  55 chip45.com Crumb128 module
  56 .It
  57 Enfora EDG1228 EDGE modem
  58 .It
  59 Helicomm IP-Link 1220-DVM
  60 .It
  61 Jablotron PC-60B
  62 .It
  63 Lipowsky Baby-JTAG
  64 .It
  65 Lipowsky Baby-LIN
  66 .It
  67 Lipowsky HARP-1
  68 .It
  69 Pololu USB to serial adapter
  70 .It
  71 Suunto USB to serial adapter
  72 .It
  73 Tracient RFID readers
  74 .It
  75 West Mountain Radio RIGblaster
  76 .It
  77 West Mountain Radio RIGtalk
  78 .El
  79 .Sh SEE ALSO
  80 .Xr tty 4 ,
  81 .Xr ucom 4 ,
  82 .Xr usb 4
  83 .Sh HISTORY
  84 The
  85 .Nm
  86 device driver first appeared in
  87 .Ox 4.0
  88 and was imported into
  89 .Dx 1.11 .
  90 .Sh AUTHORS
  91 .An -nosplit
  92 The
  93 .Nm
  94 driver was written by
  95 .An Jonathan Gray Aq Mt jsg@openbsd.org .
  96 .Sh CAVEATS
  97 Setting hardware flow control is not tested.
  98 .Pp
  99 Silicon Laboratories don't release any programming information
 100 on their products.