1.\" $NetBSD: ray.4,v 1.8 2001/09/11 22:52:53 wiz 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 38The 39.Nm 40device driver supports the Raytheon Raylink and Aviator 2.4/PRO 41802.11 FH 2Mbps wireless pcmcia cards. The cards can be operated in 42either adhoc or infrastructure modes. The operating mode is 43selectable with 44.Xr ifconfig 8 45through a media option. 46.Pp 47To communicate with other 802.11 cards a common network id or NWID must 48be specified on each station that wishes to participate in the shared 49wireless network. The NWID can 50be set with 51.Xr ifconfig 8 . 52.Pp 53The device uses IEEE 802.11 standard Frequency Hopping Spread Spectrum 54signaling and operates in the ranges of 2.400 to 2.4835 Gigahertz. 55This frequency range is further restricted by country according to 56that country's regulations. Currently the 57.Nm 58driver defaults to using the ranges appropriate for the USA. 59To change this setting you must define the kernel option 60RAY_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 81The output power of the transceiver is 100mW and the card's power consumption 82is 365 mA @ 5 volts. The transmission range in open air (line of sight) 83is a maximum of 1000 feet (or ~304 meters), and indoors (i.e., with 84obstructions) it is a maximum of 500 feet (152 meters). 85.Sh HARDWARE 86Cards supported by the 87.Nm 88driver include: 89.Pp 90.Bl -item -compact 91.It 92WebGear Aviator 2.4 93.It 94WebGear Aviator PRO 95.It 96Raytheon Raylink WLAN 97.El 98.Sh DIAGNOSTICS 99.Bl -diag 100.It "ray0: card failed self test: status x" 101Indicates 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 109The 110.Nm 111driver first appeared in 112.Nx 1.5 . 113.Sh AUTHORS 114The 115.Nm 116driver was written by 117.An Christian E. Hopps Aq chopps@netbsd.org . 118.Sh BUGS 119Currently the infrastructure mode is untested, and authentication 120using WEP is unimplemented. 121