1.\"	$OpenBSD: ray.4,v 1.9 2003/06/06 10:29:41 jmc Exp $
2.\"	$NetBSD: ray.4,v 1.5 2000/02/28 13:54:55 enami Exp $
3.\"
4.\" Copyright (c) 2000 Christian E. Hopps
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. The name of the author may not be used to endorse or promote products
16.\"    derived from this software without specific prior written permission
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28.\"
29.Dd January 24, 2000
30.Dt RAY 4
31.Os
32.Sh NAME
33.Nm ray
34.Nd Raytheon Raylink / WebGear Aviator IEEE 802.11FH 2Mbps Wireless
35.Sh SYNOPSIS
36.Cd "ray* at pcmcia? function ?"
37.Cd "option RAY_PID_COUNTRY_CODE_DEFAULT=RAY_PID_COUNTRY_CODE_USA"
38.Sh DESCRIPTION
39The
40.Nm
41device driver supports the Raytheon Raylink and Aviator 2.4/PRO
42802.11 Frequency Hopping 2Mbps wireless PCMCIA cards.
43The cards can be operated in either adhoc or infrastructure modes.
44The operating mode is selectable with
45.Xr ifconfig 8
46through a media option.
47.Pp
48Cards supported by the
49.Nm
50driver include:
51.Pp
52.Bl -item -offset indent -compact
53.It
54WebGear Aviator 2.4
55.It
56WebGear Aviator PRO
57.It
58Raytheon Raylink WLAN
59.El
60.Pp
61To communicate with other 802.11 cards a common network ID or NWID must
62be specified on each station that wishes to participate in the shared
63wireless network.
64The NWID can be set with
65.Xr ifconfig 8 .
66.Pp
67The device uses IEEE 802.11 standard Frequency Hopping Spread Spectrum
68signaling and operates in the ranges of 2.400 to 2.4835 Gigahertz.
69This frequency range is further restricted by country according to
70that country's regulations.
71Currently the
72.Nm
73driver defaults to using the ranges appropriate for the USA.
74To change this setting you must define the kernel option
75.Dv RAY_PID_COUNTRY_CODE_DEFAULT
76to one of the following values:
77.Pp
78.Bl -item -offset indent -compact
79.It
80.Cd RAY_PID_COUNTRY_CODE_USA
81.It
82.Cd RAY_PID_COUNTRY_CODE_EUROPE
83.It
84.Cd RAY_PID_COUNTRY_CODE_JAPAN
85.It
86.Cd RAY_PID_COUNTRY_CODE_KOREA
87.It
88.Cd RAY_PID_COUNTRY_CODE_SPAIN
89.It
90.Cd RAY_PID_COUNTRY_CODE_FRANCE
91.It
92.Cd RAY_PID_COUNTRY_CODE_ISRAEL
93.It
94.Cd RAY_PID_COUNTRY_CODE_AUSTRALIA
95.El
96.Pp
97The output power of the transceiver is 100mW and the card's power consumption
98is 365 mA @ 5 volts.
99The transmission range in open air (line of sight)
100is a maximum of 1000 feet (or ~304 meters), and indoors (i.e., with
101obstructions) it is a maximum of 500 feet (152 meters).
102.Pp
103.Tn Windows
104drivers may use one of two framing modes for wireless packets,
105"translation" and "encapsulation."
106"Encapsulation" is the only framing
107mode available when using some older
108.Tn Windows
109drivers.
110.Pp
111Setting
112.Em link0
113flag on the interface allows the
114Ethernet2 in 802.11 "encapsulation" framing method used by
115older
116.Tn Windows
117drivers for the card.
118For all other purposes, link0 should not be used, and "translation"
119should be selected if you are given the option in a newer
120.Tn Windows
121driver.
122.Sh DIAGNOSTICS
123.Bl -diag
124.It "ray0: card failed self test: status x"
125Indicates the card has failed its initial startup tests.
126.El
127.Sh SEE ALSO
128.Xr awi 4 ,
129.Xr ifmedia 4 ,
130.Xr intro 4 ,
131.Xr pcmcia 4 ,
132.Xr hostname.if 5 ,
133.Xr ifconfig 8
134.Sh HISTORY
135The
136.Nm
137device driver first appeared in
138.Nx 1.5 .
139.Ox
140support was added in
141.Ox 2.7 .
142.Sh AUTHORS
143The
144.Nm
145driver was written by
146.An Christian E. Hopps Aq chopps@netbsd.org
147and ported to
148.Ox
149by
150.An Michael Shalayeff Aq mickey@openbsd.org .
151Support for interoperating with newer
152.Tn Windows
153driver was added by
154.An Steve Weiss Aq srw@alum.mit.edu .
155.Sh BUGS
156Currently the infrastructure mode is untested, and authentication
157using WEP is unimplemented.
158.Pp
159Firmware version 4 does not interop with version 5 or higher.
160