share/man/man4/bwi.4

   1 .\" $NetBSD: bwi.4,v 1.4 2009/03/25 07:50:05 agc Exp $
   2 .\"
   3 .\" Copyright (c) 2007 The DragonFly Project.  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 .\"
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in
  13 .\"    the documentation and/or other materials provided with the
  14 .\"    distribution.
  15 .\" 3. Neither the name of The DragonFly Project nor the names of its
  16 .\"    contributors may be used to endorse or promote products derived
  17 .\"    from this software without specific, prior written permission.
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  20 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  21 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  22 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
  23 .\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  24 .\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
  25 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  26 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  27 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  28 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  29 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\" $DragonFly: src/share/man/man4/bwi.4,v 1.10 2008/07/26 16:25:40 swildner Exp $
  33 .\"
  34 .Dd March 24, 2009
  35 .Dt BWI 4
  36 .Os
  37 .Sh NAME
  38 .Nm bwi
  39 .Nd Broadcom BCM430x/4318 IEEE 802.11b/g wireless network driver
  40 .Sh DESCRIPTION
  41 The
  42 .Nm
  43 driver provides support for Broadcom BCM430x/4318 wireless network adapters.
  44 For more information on configuring this device, see
  45 .Xr ifconfig 8 .
  46 .Ss MIB Variables
  47 The following per-interface variables are implemented in the
  48 .Va hw.bwi Ns Em X
  49 branch of the
  50 .Xr sysctl 3
  51 MIB.
  52 .Bl -tag -width ".Va txpwr_calib"
  53 .It Va debug
  54 Debug flags.
  55 .It Va dwell_time
  56 Channel dwell time during scan (msec).
  57 .It Va fw_version
  58 Firmware version.
  59 .It Va led_idle
  60 Number of ticks before LED enters idle state.
  61 .It Va led_blink
  62 Allow LED to blink.
  63 .It Va txpwr_calib
  64 Enable software TX power calibration.
  65 .El
  66 .Sh HARDWARE
  67 The following cards are among those supported by the
  68 .Nm
  69 driver:
  70 .Pp
  71 .Bl -column -compact "Apple AirPort Extreme" "BCM4318" "Mini PCI" "b/g" -offset 6n
  72 .It Em "Card    Chip    Bus     Standard"
  73 .It Buffalo WLI-PCI-G54S        BCM4306 PCI     b/g
  74 .It Dell Wireless 1370  BCM4318 Mini PCI        b/g
  75 .It Dell Wireless 1470  BCM4318 Mini PCI        b/g
  76 .It Dell Truemobile 1400        BCM4309 Mini PCI        b/g
  77 .It Dell Latitude D505  BCM4306 PCI     b/g
  78 .It Apple AirPort Extreme                       b/g
  79 .El
  80 .Sh FILES
  81 The firmware for the adapter is not shipped with
  82 .Nx
  83 and must be obtained separately.
  84 An archive with firmware files that are known to work can be found at:
  85 .Bd -literal -offset indent
  86 http://leaf.dragonflybsd.org/~sephe/bwi/v3.tbz
  87 .Ed
  88 .Pp
  89 The firmware files conventionally reside in
  90 .Pa /libdata/firmware/bwi
  91 and will be loaded when the interface is brought up.
  92 .Em Note :
  93 the v3 subdirectory in the above firmware archive should exist
  94 in the firmware folder.
  95 The full list of paths checked for firmware can be found in the
  96 .Va hw.firmware.path
  97 .Xr sysctl 3
  98 node.
  99 .Sh SEE ALSO
 100 .Xr arp 4 ,
 101 .Xr ifmedia 4 ,
 102 .Xr pci 4 ,
 103 .Xr wiconfig 4 ,
 104 .Xr ifconfig 8 ,
 105 .Xr sysctl 8 ,
 106 .Xr wpa_supplicant 8
 107 .Sh HISTORY
 108 The
 109 .Nm
 110 driver first appeared in
 111 .Nx 6.0 .
 112 .Sh AUTHORS
 113 .An -nosplit
 114 The
 115 .Nm
 116 driver was written by
 117 .An Sepherosa Ziehau
 118 for Dragonfly BSD.
 119 It was ported to
 120 .Nx
 121 by
 122 .An Taylor R. Campbell Aq campbell@mumble.net .
 123 .Pp
 124 The hardware specification was reverse engineered by the people at
 125 .Pa http://bcm-specs.sipsolutions.net .
 126 Thanks go also to johill and mb on the #bcm-specs channel.
 127 .Sh BUGS
 128 BCM4306 and BCM4309 chips do not work properly on channel 1, 2, and 3.
 129 .Pp
 130 The
 131 .Nx
 132 driver does not yet support cardbus devices.