share/man/man4/ral.4

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