1.\" Copyright (c) 2005
2.\" Damien Bergamini <damien.bergamini@free.fr>
3.\"
4.\" Permission to use, copy, modify, and distribute this software for any
5.\" purpose with or without fee is hereby granted, provided that the above
6.\" copyright notice and this permission notice appear in all copies.
7.\"
8.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15.\"
| 1.\" Copyright (c) 2005
2.\" Damien Bergamini <damien.bergamini@free.fr>
3.\"
4.\" Permission to use, copy, modify, and distribute this software for any
5.\" purpose with or without fee is hereby granted, provided that the above
6.\" copyright notice and this permission notice appear in all copies.
7.\"
8.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15.\"
|
16.\" $FreeBSD: head/share/man/man4/ral.4 147414 2005-06-16 11:36:08Z ru $
| 16.\" $FreeBSD: head/share/man/man4/ral.4 148145 2005-07-19 00:26:30Z trhodes $
|
17.\"
| 17.\"
|
18.Dd May 2, 2005
| 18.Dd July 16, 2005
|
19.Os
20.Dt RAL 4
21.Sh NAME
22.Nm ral
23.Nd "Ralink Technology RT2500 IEEE 802.11 driver"
24.Sh SYNOPSIS
| 19.Os
20.Dt RAL 4
21.Sh NAME
22.Nm ral
23.Nd "Ralink Technology RT2500 IEEE 802.11 driver"
24.Sh SYNOPSIS
|
| 25To compile support for the
26.Nm
27driver into your kernel, place the following lines in your kernel configuration file:
28.Bd -ragged -offset indent
|
25.Cd "device ral"
26.Cd "device wlan"
| 29.Cd "device ral"
30.Cd "device wlan"
|
| 31.Ed
32.Pp
33Alternatively, to load the
34.Nm
35driver at boot time, place the following line in
36.Xr loader.conf 5 :
37.Bd -literal -offset indent
38if_ral_load="YES"
39.Ed
|
27.Sh DESCRIPTION
28The
29.Nm
30driver supports PCI/CardBus wireless adapters based on the Ralink RT2500
31chipset.
32.Pp
33The RT2500 chipset consists of two integrated chips, a RT2560 MAC/BBP and a
34radio transceiver (the model of which depends on the card revision).
35.Pp
36The RT2522, RT2523, RT2524, RT2525, RT2525e and RT2526 radio transceivers
37operate in the 2.4GHz band (802.11b/g) whereas the RT5222 is a dual-band radio
38transceiver that can operate in the 2.4GHz and 5.2GHz bands (802.11a).
39.Pp
40The transmit speed is user-selectable or can be adapted automatically by the
41driver depending on the received-signal strength.
42.Sh HARDWARE
43The following adapters should work:
44.Pp
45.Bl -column -compact ".Li Atlantis Land A02-PCM-W54" "Bus"
46.It Em Card Ta Em Bus
47.It Li "A-Link WL54H" Ta PCI
48.It Li "A-Link WL54PC" Ta CardBus
49.It Li "Amigo AWI-914W" Ta CardBus
50.It Li "Amigo AWI-922W" Ta mini-PCI
51.It Li "Amigo AWI-926W" Ta PCI
52.It Li "AMIT WL531C" Ta CardBus
53.It Li "AMIT WL531P" Ta PCI
54.It Li "AOpen AOI-831" Ta PCI
55.It Li "ASUS WL-107G" Ta CardBus
56.It Li "ASUS WL-130g" Ta PCI
57.It Li "Atlantis Land A02-PCI-W54" Ta PCI
58.It Li "Atlantis Land A02-PCM-W54" Ta CardBus
59.It Li "Belkin F5D7000 v3" Ta PCI
60.It Li "Belkin F5D7010 v2" Ta CardBus
61.It Li "Billionton MIWLGRL" Ta mini-PCI
62.It Li "Canyon CN-WF511" Ta PCI
63.It Li "Canyon CN-WF513" Ta CardBus
64.It Li "CC&C WL-2102" Ta CardBus
65.It Li "CNet CWC-854" Ta CardBus
66.It Li "CNet CWP-854" Ta PCI
67.It Li "Compex WL54G" Ta CardBus
68.It Li "Compex WLP54G" Ta PCI
69.It Li "Conceptronic C54RC" Ta CardBus
70.It Li "Conceptronic C54Ri" Ta PCI
71.It Li "Digitus DN-7001G-RA" Ta CardBus
72.It Li "Digitus DN-7006G-RA" Ta PCI
73.It Li "E-Tech WGPC02" Ta CardBus
74.It Li "E-Tech WGPI02" Ta PCI
75.It Li "Edimax EW-7108PCg" Ta CardBus
76.It Li "Edimax EW-7128g" Ta PCI
77.It Li "Eminent EM3036" Ta CardBus
78.It Li "Eminent EM3037" Ta PCI
79.It Li "Encore ENLWI-G-RLAM" Ta PCI
80.It Li "Encore ENPWI-G-RLAM" Ta CardBus
81.It Li "Fiberline WL-400P" Ta PCI
82.It Li "Fibreline WL-400X" Ta CardBus
83.It Li "Gigabyte GN-WIKG" Ta mini-PCI
84.It Li "Gigabyte GN-WMKG" Ta CardBus
85.It Li "Gigabyte GN-WPKG" Ta PCI
86.It Li "Hawking HWC54GR" Ta CardBus
87.It Li "Hawking HWP54GR" Ta PCI
88.It Li "iNexQ CR054g-009 (R03)" Ta PCI
89.It Li "JAHT WN-4054P" Ta CardBus
90.It Li "JAHT WN-4054PCI" Ta PCI
91.It Li "LevelOne WNC-0301 v2" Ta PCI
92.It Li "LevelOne WPC-0301 v2" Ta CardBus
93.It Li "Linksys WMP54G v4" Ta PCI
94.It Li "Micronet SP906GK" Ta PCI
95.It Li "Micronet SP908GK V3" Ta CardBus
96.It Li "Minitar MN54GCB-R" Ta CardBus
97.It Li "Minitar MN54GPC-R" Ta PCI
98.It Li "MSI CB54G2" Ta CardBus
99.It Li "MSI MP54G2" Ta mini-PCI
100.It Li "MSI PC54G2" Ta PCI
101.It Li "OvisLink EVO-W54PCI" Ta PCI
102.It Li "PheeNet HWL-PCIG/RA" Ta PCI
103.It Li "Pro-Nets CB80211G" Ta CardBus
104.It Li "Pro-Nets PC80211G" Ta PCI
105.It Li "Repotec RP-WB7108" Ta CardBus
106.It Li "Repotec RP-WP0854" Ta PCI
107.It Li "SATech SN-54C" Ta CardBus
108.It Li "SATech SN-54P" Ta PCI
109.It Li "Sitecom WL-112" Ta CardBus
110.It Li "Sitecom WL-115" Ta PCI
111.It Li "SparkLAN WL-685R" Ta CardBus
112.It Li "Surecom EP-9321-g" Ta PCI
113.It Li "Surecom EP-9321-g1" Ta PCI
114.It Li "Surecom EP-9428-g" Ta CardBus
115.It Li "Sweex LC500050" Ta CardBus
116.It Li "Sweex LC700030" Ta PCI
117.It Li "TekComm NE-9321-g" Ta PCI
118.It Li "TekComm NE-9428-g" Ta CardBus
119.It Li "Unex CR054g-R02" Ta PCI
120.It Li "Unex MR054g-R02" Ta CardBus
121.It Li "Zinwell ZWX-G160" Ta CardBus
122.It Li "Zinwell ZWX-G360" Ta mini-PCI
123.It Li "Zinwell ZWX-G361" Ta PCI
124.It Li "Zonet ZEW1500" Ta CardBus
125.It Li "Zonet ZEW1600" Ta PCI
126.El
127.Pp
128An up to date list can be found at
129.Pa http://damien.bergamini.free.fr/ral/list.html .
130.Sh EXAMPLES
131Join an existing BSS network (i.e., connect to an access point):
132.Pp
133.Dl "ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00"
134.Pp
135Join a specific BSS network with network name
136.Dq Li my_net :
137.Pp
138.Dl "ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net"
139.Pp
140Join a specific BSS network with 40-bit WEP encryption:
141.Bd -literal -offset indent
142ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
143 wepmode on wepkey 0x1234567890
144.Ed
145.Pp
146Join a specific BSS network with 104-bit WEP encryption:
147.Bd -literal -offset indent
148ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
149 wepmode on wepkey 0x01020304050607080910111213
150.Ed
151.Sh DIAGNOSTICS
152.Bl -diag
153.It "ral%d: device timeout"
154The driver will reset the hardware.
155This should not happen.
156.El
157.Sh SEE ALSO
158.Xr arp 4 ,
159.Xr cardbus 4 ,
160.Xr netintro 4 ,
161.Xr pci 4 ,
162.Xr wlan 4 ,
163.Xr ifconfig 8
164.Rs
165.%T "Ralink Technology"
166.%O http://www.ralinktech.com/
167.Re
168.Sh HISTORY
169The
170.Nm
171driver first appeared in
172.Ox 3.7 .
173.Sh CAVEATS
174PCI
175.Nm
176adapters seem to require a PCI 2.2 compliant motherboard and will likely not
177work with PCI 2.1 only motherboard.
178.Sh AUTHORS
179The
180.Nm
181driver was written by
182.An Damien Bergamini Aq damien@FreeBSD.org .
| 40.Sh DESCRIPTION
41The
42.Nm
43driver supports PCI/CardBus wireless adapters based on the Ralink RT2500
44chipset.
45.Pp
46The RT2500 chipset consists of two integrated chips, a RT2560 MAC/BBP and a
47radio transceiver (the model of which depends on the card revision).
48.Pp
49The RT2522, RT2523, RT2524, RT2525, RT2525e and RT2526 radio transceivers
50operate in the 2.4GHz band (802.11b/g) whereas the RT5222 is a dual-band radio
51transceiver that can operate in the 2.4GHz and 5.2GHz bands (802.11a).
52.Pp
53The transmit speed is user-selectable or can be adapted automatically by the
54driver depending on the received-signal strength.
55.Sh HARDWARE
56The following adapters should work:
57.Pp
58.Bl -column -compact ".Li Atlantis Land A02-PCM-W54" "Bus"
59.It Em Card Ta Em Bus
60.It Li "A-Link WL54H" Ta PCI
61.It Li "A-Link WL54PC" Ta CardBus
62.It Li "Amigo AWI-914W" Ta CardBus
63.It Li "Amigo AWI-922W" Ta mini-PCI
64.It Li "Amigo AWI-926W" Ta PCI
65.It Li "AMIT WL531C" Ta CardBus
66.It Li "AMIT WL531P" Ta PCI
67.It Li "AOpen AOI-831" Ta PCI
68.It Li "ASUS WL-107G" Ta CardBus
69.It Li "ASUS WL-130g" Ta PCI
70.It Li "Atlantis Land A02-PCI-W54" Ta PCI
71.It Li "Atlantis Land A02-PCM-W54" Ta CardBus
72.It Li "Belkin F5D7000 v3" Ta PCI
73.It Li "Belkin F5D7010 v2" Ta CardBus
74.It Li "Billionton MIWLGRL" Ta mini-PCI
75.It Li "Canyon CN-WF511" Ta PCI
76.It Li "Canyon CN-WF513" Ta CardBus
77.It Li "CC&C WL-2102" Ta CardBus
78.It Li "CNet CWC-854" Ta CardBus
79.It Li "CNet CWP-854" Ta PCI
80.It Li "Compex WL54G" Ta CardBus
81.It Li "Compex WLP54G" Ta PCI
82.It Li "Conceptronic C54RC" Ta CardBus
83.It Li "Conceptronic C54Ri" Ta PCI
84.It Li "Digitus DN-7001G-RA" Ta CardBus
85.It Li "Digitus DN-7006G-RA" Ta PCI
86.It Li "E-Tech WGPC02" Ta CardBus
87.It Li "E-Tech WGPI02" Ta PCI
88.It Li "Edimax EW-7108PCg" Ta CardBus
89.It Li "Edimax EW-7128g" Ta PCI
90.It Li "Eminent EM3036" Ta CardBus
91.It Li "Eminent EM3037" Ta PCI
92.It Li "Encore ENLWI-G-RLAM" Ta PCI
93.It Li "Encore ENPWI-G-RLAM" Ta CardBus
94.It Li "Fiberline WL-400P" Ta PCI
95.It Li "Fibreline WL-400X" Ta CardBus
96.It Li "Gigabyte GN-WIKG" Ta mini-PCI
97.It Li "Gigabyte GN-WMKG" Ta CardBus
98.It Li "Gigabyte GN-WPKG" Ta PCI
99.It Li "Hawking HWC54GR" Ta CardBus
100.It Li "Hawking HWP54GR" Ta PCI
101.It Li "iNexQ CR054g-009 (R03)" Ta PCI
102.It Li "JAHT WN-4054P" Ta CardBus
103.It Li "JAHT WN-4054PCI" Ta PCI
104.It Li "LevelOne WNC-0301 v2" Ta PCI
105.It Li "LevelOne WPC-0301 v2" Ta CardBus
106.It Li "Linksys WMP54G v4" Ta PCI
107.It Li "Micronet SP906GK" Ta PCI
108.It Li "Micronet SP908GK V3" Ta CardBus
109.It Li "Minitar MN54GCB-R" Ta CardBus
110.It Li "Minitar MN54GPC-R" Ta PCI
111.It Li "MSI CB54G2" Ta CardBus
112.It Li "MSI MP54G2" Ta mini-PCI
113.It Li "MSI PC54G2" Ta PCI
114.It Li "OvisLink EVO-W54PCI" Ta PCI
115.It Li "PheeNet HWL-PCIG/RA" Ta PCI
116.It Li "Pro-Nets CB80211G" Ta CardBus
117.It Li "Pro-Nets PC80211G" Ta PCI
118.It Li "Repotec RP-WB7108" Ta CardBus
119.It Li "Repotec RP-WP0854" Ta PCI
120.It Li "SATech SN-54C" Ta CardBus
121.It Li "SATech SN-54P" Ta PCI
122.It Li "Sitecom WL-112" Ta CardBus
123.It Li "Sitecom WL-115" Ta PCI
124.It Li "SparkLAN WL-685R" Ta CardBus
125.It Li "Surecom EP-9321-g" Ta PCI
126.It Li "Surecom EP-9321-g1" Ta PCI
127.It Li "Surecom EP-9428-g" Ta CardBus
128.It Li "Sweex LC500050" Ta CardBus
129.It Li "Sweex LC700030" Ta PCI
130.It Li "TekComm NE-9321-g" Ta PCI
131.It Li "TekComm NE-9428-g" Ta CardBus
132.It Li "Unex CR054g-R02" Ta PCI
133.It Li "Unex MR054g-R02" Ta CardBus
134.It Li "Zinwell ZWX-G160" Ta CardBus
135.It Li "Zinwell ZWX-G360" Ta mini-PCI
136.It Li "Zinwell ZWX-G361" Ta PCI
137.It Li "Zonet ZEW1500" Ta CardBus
138.It Li "Zonet ZEW1600" Ta PCI
139.El
140.Pp
141An up to date list can be found at
142.Pa http://damien.bergamini.free.fr/ral/list.html .
143.Sh EXAMPLES
144Join an existing BSS network (i.e., connect to an access point):
145.Pp
146.Dl "ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00"
147.Pp
148Join a specific BSS network with network name
149.Dq Li my_net :
150.Pp
151.Dl "ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net"
152.Pp
153Join a specific BSS network with 40-bit WEP encryption:
154.Bd -literal -offset indent
155ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
156 wepmode on wepkey 0x1234567890
157.Ed
158.Pp
159Join a specific BSS network with 104-bit WEP encryption:
160.Bd -literal -offset indent
161ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
162 wepmode on wepkey 0x01020304050607080910111213
163.Ed
164.Sh DIAGNOSTICS
165.Bl -diag
166.It "ral%d: device timeout"
167The driver will reset the hardware.
168This should not happen.
169.El
170.Sh SEE ALSO
171.Xr arp 4 ,
172.Xr cardbus 4 ,
173.Xr netintro 4 ,
174.Xr pci 4 ,
175.Xr wlan 4 ,
176.Xr ifconfig 8
177.Rs
178.%T "Ralink Technology"
179.%O http://www.ralinktech.com/
180.Re
181.Sh HISTORY
182The
183.Nm
184driver first appeared in
185.Ox 3.7 .
186.Sh CAVEATS
187PCI
188.Nm
189adapters seem to require a PCI 2.2 compliant motherboard and will likely not
190work with PCI 2.1 only motherboard.
191.Sh AUTHORS
192The
193.Nm
194driver was written by
195.An Damien Bergamini Aq damien@FreeBSD.org .
|