share/man/man4/ray.4

   1 .\"     $NetBSD: ray.4,v 1.10 2003/02/14 15:20:19 grant Exp $
   2 .\"
   3 .\" Copyright (c) 2000 Christian E. Hopps
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   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 the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. The name of the author may not be used to endorse or promote products
  15 .\"    derived from this software without specific prior written permission
  16 .\"
  17 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27 .\"
  28 .Dd January 24, 2000
  29 .Dt RAY 4
  30 .Os
  31 .Sh NAME
  32 .Nm ray
  33 .Nd Raytheon Raylink / WebGear Aviator IEEE 802.11 2Mbps Wireless
  34 .Sh SYNOPSIS
  35 .Cd "ray* at pcmcia? function ?"
  36 .Cd "options RAY_PID_COUNTRY_CODE_DEFAULT=RAY_PID_COUNTRY_CODE_USA"
  37 .Sh DESCRIPTION
  38 The
  39 .Nm
  40 device driver supports the Raytheon Raylink and Aviator 2.4/PRO
  41 802.11 FH 2Mbps wireless PCMCIA cards.  The cards can be operated in
  42 either ad-hoc or infrastructure modes. The operating mode is
  43 selectable with
  44 .Xr ifconfig 8
  45 through a media option.
  46 .Pp
  47 To communicate with other 802.11 cards a common network id or NWID must
  48 be specified on each station that wishes to participate in the shared
  49 wireless network.  The NWID can
  50 be set with
  51 .Xr ifconfig 8 .
  52 .Pp
  53 The device uses IEEE 802.11 standard Frequency Hopping Spread Spectrum
  54 signaling and operates in the ranges of 2.400 to 2.4835 Gigahertz.
  55 This frequency range is further restricted by country according to
  56 that country's regulations.  Currently the
  57 .Nm
  58 driver defaults to using the ranges appropriate for the USA.
  59 To change this setting you must define the kernel option
  60 RAY_PID_COUNTRY_CODE_DEFAULT to one of the following values:
  61 .Pp
  62 .Bl -item -compact
  63 .It
  64 .Cd RAY_PID_COUNTRY_CODE_USA
  65 .It
  66 .Cd RAY_PID_COUNTRY_CODE_EUROPE
  67 .It
  68 .Cd RAY_PID_COUNTRY_CODE_JAPAN
  69 .It
  70 .Cd RAY_PID_COUNTRY_CODE_KOREA
  71 .It
  72 .Cd RAY_PID_COUNTRY_CODE_SPAIN
  73 .It
  74 .Cd RAY_PID_COUNTRY_CODE_FRANCE
  75 .It
  76 .Cd RAY_PID_COUNTRY_CODE_ISRAEL
  77 .It
  78 .Cd RAY_PID_COUNTRY_CODE_AUSTRALIA
  79 .El
  80 .Pp
  81 The output power of the transceiver is 100mW and the card's power consumption
  82 is 365 mA @ 5 volts.  The transmission range in open air (line of sight)
  83 is a maximum of 1000 feet (or ~304 meters), and indoors (i.e., with
  84 obstructions) it is a maximum of 500 feet (152 meters).
  85 .Sh HARDWARE
  86 Cards supported by the
  87 .Nm
  88 driver include:
  89 .Pp
  90 .Bl -item -compact
  91 .It
  92 WebGear Aviator 2.4
  93 .It
  94 WebGear Aviator PRO
  95 .It
  96 Raytheon Raylink WLAN
  97 .El
  98 .Sh DIAGNOSTICS
  99 .Bl -diag
 100 .It "ray0: card failed self test: status x"
 101 Indicates the card has failed its initial startup tests.
 102 .El
 103 .Sh SEE ALSO
 104 .Xr ifmedia 4 ,
 105 .Xr intro 4 ,
 106 .Xr pcmcia 4 ,
 107 .Xr ifconfig 8
 108 .Sh HISTORY
 109 The
 110 .Nm
 111 driver first appeared in
 112 .Nx 1.5 .
 113 .Sh AUTHORS
 114 The
 115 .Nm
 116 driver was written by
 117 .An Christian E. Hopps
 118 .Aq chopps@NetBSD.org .
 119 .Sh BUGS
 120 Currently the infrastructure mode is untested, and authentication
 121 using WEP is unimplemented.