share/man/man4/bt3c.4

   1 .\" $NetBSD: bt3c.4,v 1.3 2008/04/30 13:10:53 martin Exp $
   2 .\"
   3 .\" Copyright (c) 2006 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Iain Hibbert.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .Dd January 14, 2006
  31 .Dt BT3C 4
  32 .Os
  33 .Sh NAME
  34 .Nm bt3c
  35 .Nd 3Com Bluetooth PC Card driver
  36 .Sh SYNOPSIS
  37 .Cd "bt3c* at pcmcia? function ?"
  38 .Sh DESCRIPTION
  39 The
  40 .Nm
  41 driver provides support for the 3Com Bluetooth PC Card, model 3CRWB6096, to
  42 the Bluetooth protocol stack.
  43 .Sh FIRMWARE
  44 This card needs firmware loaded before it will work. Due to copyright restrictions
  45 we cannot distribute the firmware with NetBSD, but if you have the card then you
  46 should have received a CD with the drivers on, or you may download the latest
  47 version from the 3Com website. Create a directory named
  48 .Nm
  49 in the search path of the
  50 .Xr firmload 9
  51 kernel subsystem. Now, extract the driver archive and find the firmware file
  52 called
  53 .Nm "BT3CPCC.bin" ,
  54 and place this file in the newly created directory. The firmware will be loaded
  55 automatically as needed.
  56 .Sh DIAGNOSTICS
  57 .Bl -tag -width XXX -compact
  58 .It "bt3c%d: Cannot open firmware"
  59 This will be printed to the console if the device cannot open the firmware file
  60 as described above.
  61 .Pp
  62 .It "bt3c%d: Antenna In"
  63 .It "bt3c%d: Antenna Out"
  64 If the kernel is compiled with the
  65 .Dv DIAGNOSTIC
  66 option, these messages will be produced on the console when the card antenna
  67 position is changed.
  68 .Pp
  69 .It "bt3c%d: sleeping"
  70 .It "bt3c%d: waking up"
  71 These messages will be produced when the card is enabled or disabled due to
  72 power change events.
  73 .El
  74 .Sh SEE ALSO
  75 .Xr bluetooth 4 ,
  76 .Xr pcmcia 4 ,
  77 .Xr firmload 9
  78 .Sh HISTORY
  79 This
  80 .Nm
  81 device driver was written by
  82 .An "Iain Hibbert"
  83 using
  84 .Fx
  85 and BlueZ drivers as a reference.  It first appeared in
  86 .Nx 4.0 .
  87 .Sh BUGS