share/man/man4/uvisor.4

   1 .\" $NetBSD: uvisor.4,v 1.3 2001/01/23 21:31:10 augustss Exp $
   2 .\" $FreeBSD: src/share/man/man4/uvisor.4,v 1.2.2.2 2002/08/22 15:13:11 trhodes Exp $
   3 .\" $DragonFly: src/share/man/man4/uvisor.4,v 1.5 2007/08/14 17:40:19 hasso Exp $
   4 .\"
   5 .\" Copyright (c) 2000 The NetBSD Foundation, Inc.
   6 .\" All rights reserved.
   7 .\"
   8 .\" This code is derived from software contributed to The NetBSD Foundation
   9 .\" by Lennart Augustsson.
  10 .\"
  11 .\" Redistribution and use in source and binary forms, with or without
  12 .\" modification, are permitted provided that the following conditions
  13 .\" are met:
  14 .\" 1. Redistributions of source code must retain the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer.
  16 .\" 2. Redistributions in binary form must reproduce the above copyright
  17 .\"    notice, this list of conditions and the following disclaimer in the
  18 .\"    documentation and/or other materials provided with the distribution.
  19 .\" 3. All advertising materials mentioning features or use of this software
  20 .\"    must display the following acknowledgment:
  21 .\"        This product includes software developed by the NetBSD
  22 .\"        Foundation, Inc. and its contributors.
  23 .\" 4. Neither the name of The NetBSD Foundation nor the names of its
  24 .\"    contributors may be used to endorse or promote products derived
  25 .\"    from this software without specific prior written permission.
  26 .\"
  27 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  28 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  29 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  30 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  31 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  32 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  33 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  34 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  35 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  36 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  37 .\" POSSIBILITY OF SUCH DAMAGE.
  38 .\"
  39 .Dd March 10, 2000
  40 .Dt UVISOR 4
  41 .Os
  42 .Sh NAME
  43 .Nm uvisor
  44 .Nd USB support for the Handspring Visor, a Palmpilot compatible PDA
  45 .Sh SYNOPSIS
  46 To compile this driver into the kernel,
  47 place the following lines in your
  48 kernel configuration file:
  49 .Bd -ragged -offset indent
  50 .Cd "device uvisor"
  51 .Cd "device ucom"
  52 .Ed
  53 .Pp
  54 Alternatively, to load the driver as a
  55 module at boot time, place the following line in
  56 .Xr loader.conf 5 :
  57 .Bd -literal -offset indent
  58 uvisor_load="YES"
  59 .Ed
  60 .Sh DESCRIPTION
  61 The
  62 .Nm
  63 driver provides support for the Handspring Visor, a Palmpilot compatible PDA.
  64 .Pp
  65 The device is accessed through the
  66 .Xr ucom 4
  67 driver which makes it behave like a
  68 .Xr tty 4 .
  69 The device has several ports for different purposes, each of them gets its
  70 own
  71 .Xr ucom 4
  72 device.
  73 The attach message describes the purpose of each port.
  74 .Pp
  75 The usual Pilot tools can be used to access the Visor on the HotSync port.
  76 .Sh SEE ALSO
  77 .Xr tty 4 ,
  78 .Xr ucom 4 ,
  79 .Xr usb 4
  80 .Sh HISTORY
  81 The
  82 .Nm
  83 driver was adopted from
  84 .Nx 1.5
  85 in August 2002.  This manual page was adopted from
  86 .Nx
  87 by
  88 .An Tom Rhodes Aq trhodes@FreeBSD.org
  89 at that time.
  90 .Sh BUGS
  91 The code to provide multiple ucom instances has not yet been ported
  92 from
  93 .Nx .
  94 It's unclear whether this driver works in its current state.