diff --git a/share/man/man4/ral.4 b/share/man/man4/ral.4 index bb4ba1350c8e..5b84bea00153 100644 --- a/share/man/man4/ral.4 +++ b/share/man/man4/ral.4 @@ -1,304 +1,300 @@ .\" Copyright (c) 2005-2010 Damien Bergamini .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .\" $FreeBSD$ .\" .Dd April 4, 2017 .Dt RAL 4 .Os .Sh NAME .Nm ral .Nd "Ralink Technology IEEE 802.11a/g/n wireless network device" .Sh SYNOPSIS To compile this driver into the kernel, place the following lines in your kernel configuration file: .Bd -ragged -offset indent .Cd "device ral" .Cd "device ralfw" .Cd "device wlan" .Cd "device wlan_amrr" .Cd "device firmware" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent if_ral_load="YES" .Ed .Sh DESCRIPTION The .Nm driver supports PCI/PCIe/CardBus wireless adapters based on the Ralink RT2500, RT2501, RT2600, RT2700, RT2800, RT3090 and RT3900E chipsets. .Pp The RT2500 chipset is the first generation of 802.11b/g adapters from Ralink. It consists of two integrated chips, an RT2560 MAC/BBP and an RT2525 radio transceiver. .Pp The RT2501 chipset is the second generation of 802.11a/b/g adapters from Ralink. It consists of two integrated chips, an RT2561 MAC/BBP and an RT2527 radio transceiver. This chipset provides support for the IEEE 802.11e standard with multiple hardware transmission queues and allows scatter/gather for efficient DMA operations. .Pp The RT2600 chipset consists of two integrated chips, an RT2661 MAC/BBP and an RT2529 radio transceiver. This chipset uses the MIMO (multiple-input multiple-output) technology with multiple radio transceivers to extend the operating range of the adapter and to achieve higher throughput. However, the RT2600 chipset does not support any of the 802.11n features. .Pp The RT2700 chipset is a low-cost version of the RT2800 chipset. It supports a single transmit path and two receiver paths (1T2R). It consists of two integrated chips, an RT2760 or RT2790 (PCIe) MAC/BBP and an RT2720 (2.4GHz) or RT2750 (2.4GHz/5GHz) radio transceiver. .Pp The RT2800 chipset is the first generation of 802.11n adapters from Ralink. It consists of two integrated chips, an RT2860 or RT2890 (PCIe) MAC/BBP and an RT2820 (2.4GHz) or RT2850 (2.4GHz/5GHz) radio transceiver. The RT2800 chipset supports two transmit paths and up to three receiver paths (2T2R/2T3R). It can achieve speeds up to 144Mbps (20MHz bandwidth) and 300Mbps (40MHz bandwidth.) .Pp The RT3090 chipset is the first generation of single-chip 802.11n adapters from Ralink. .Nm supports .Cm station , .Cm adhoc , .Cm hostap , .Cm mesh , .Cm wds , and .Cm monitor mode operation. Only one .Cm hostap or .Cm mesh virtual interface may be configured at a time. Any number of .Cm wds virtual interfaces may be configured together with a .Cm hostap interface. Multiple .Cm station interfaces may be operated together with a .Cm hostap interface to construct a wireless repeater device. .Pp The RT3900E chipset is a single-chip 802.11n adapters from Ralink. The MAC/Baseband Processor can be an RT5390 or RT5392. The RT5390 chip operates in the 2GHz spectrum and supports 1 transmit path and 1 receiver path (1T1R). The RT5392 chip operates in the 2GHz spectrum and supports up to 2 transmit paths and 2 receiver paths (2T2R). .Pp The transmit speed is user-selectable or can be adapted automatically by the driver depending on the number of hardware transmission retries. For more information on configuring this device, see .Xr ifconfig 8 . .Sh HARDWARE The .Nm driver supports PCI/PCIe/CardBus wireless adapters based on Ralink Technology chipsets, including: .Pp .Bl -column -compact ".Li Atlantis Land A02-PCM-W54" "RT2561S" "CardBus" .It Em Card Ta Em MAC/BBP Ta Em Bus .It "A-Link WL54H" Ta RT2560 Ta PCI .It "A-Link WL54PC" Ta RT2560 Ta CardBus .It "AirLink101 AWLC5025" Ta RT2661 Ta CardBus .It "AirLink101 AWLH5025" Ta RT2661 Ta PCI .It "Amigo AWI-914W" Ta RT2560 Ta CardBus .It "Amigo AWI-922W" Ta RT2560 Ta mini-PCI .It "Amigo AWI-926W" Ta RT2560 Ta PCI .It "AMIT WL531C" Ta RT2560 Ta CardBus .It "AMIT WL531P" Ta RT2560 Ta PCI .It "AOpen AOI-831" Ta RT2560 Ta PCI .It "ASUS WL-107G" Ta RT2560 Ta CardBus .It "ASUS WL-130g" Ta RT2560 Ta PCI .It "Atlantis Land A02-PCI-W54" Ta RT2560 Ta PCI .It "Atlantis Land A02-PCM-W54" Ta RT2560 Ta CardBus .It "Belkin F5D7000 v3" Ta RT2560 Ta PCI .It "Belkin F5D7010 v2" Ta RT2560 Ta CardBus .It "Billionton MIWLGRL" Ta RT2560 Ta mini-PCI .It "Canyon CN-WF511" Ta RT2560 Ta PCI .It "Canyon CN-WF513" Ta RT2560 Ta CardBus .It "CC&C WL-2102" Ta RT2560 Ta CardBus .It "CNet CWC-854" Ta RT2560 Ta CardBus .It "CNet CWP-854" Ta RT2560 Ta PCI .It "Compex WL54G" Ta RT2560 Ta CardBus .It "Compex WLP54G" Ta RT2560 Ta PCI .It "Conceptronic C54RC" Ta RT2560 Ta CardBus .It "Conceptronic C54Ri" Ta RT2560 Ta PCI .It "D-Link DWA-525 rev A2" Ta RT5392 Ta PCI .It "Digitus DN-7001G-RA" Ta RT2560 Ta CardBus .It "Digitus DN-7006G-RA" Ta RT2560 Ta PCI .It "E-Tech WGPC02" Ta RT2560 Ta CardBus .It "E-Tech WGPI02" Ta RT2560 Ta PCI .It "Edimax EW-7108PCg" Ta RT2560 Ta CardBus .It "Edimax EW-7128g" Ta RT2560 Ta PCI .It "Eminent EM3036" Ta RT2560 Ta CardBus .It "Eminent EM3037" Ta RT2560 Ta PCI .It "Encore ENLWI-G-RLAM" Ta RT2560 Ta PCI .It "Encore ENPWI-G-RLAM" Ta RT2560 Ta CardBus .It "Fiberline WL-400P" Ta RT2560 Ta PCI .It "Fibreline WL-400X" Ta RT2560 Ta CardBus .It "Gigabyte GN-WI01GS" Ta RT2561S Ta mini-PCI .It "Gigabyte GN-WIKG" Ta RT2560 Ta mini-PCI .It "Gigabyte GN-WMKG" Ta RT2560 Ta CardBus .It "Gigabyte GN-WP01GS" Ta RT2561S Ta PCI .It "Gigabyte GN-WPKG" Ta RT2560 Ta PCI .It "Hawking HWC54GR" Ta RT2560 Ta CardBus .It "Hawking HWP54GR" Ta RT2560 Ta PCI .It "iNexQ CR054g-009 (R03)" Ta RT2560 Ta PCI .It "JAHT WN-4054P" Ta RT2560 Ta CardBus .It "JAHT WN-4054PCI" Ta RT2560 Ta PCI .It "LevelOne WNC-0301 v2" Ta RT2560 Ta PCI .It "LevelOne WPC-0301 v2" Ta RT2560 Ta CardBus .It "Linksys WMP54G v4" Ta RT2560 Ta PCI .It "Micronet SP906GK" Ta RT2560 Ta PCI .It "Micronet SP908GK V3" Ta RT2560 Ta CardBus .It "Minitar MN54GCB-R" Ta RT2560 Ta CardBus .It "Minitar MN54GPC-R" Ta RT2560 Ta PCI .It "MSI CB54G2" Ta RT2560 Ta CardBus .It "MSI MP54G2" Ta RT2560 Ta mini-PCI .It "MSI PC54G2" Ta RT2560 Ta PCI .It "OvisLink EVO-W54PCI" Ta RT2560 Ta PCI .It "PheeNet HWL-PCIG/RA" Ta RT2560 Ta PCI .It "Planex GW-NS300N" Ta RT2860 Ta CardBus .It "Pro-Nets CB80211G" Ta RT2560 Ta CardBus .It "Pro-Nets PC80211G" Ta RT2560 Ta PCI .It "Repotec RP-WB7108" Ta RT2560 Ta CardBus .It "Repotec RP-WP0854" Ta RT2560 Ta PCI .It "SATech SN-54C" Ta RT2560 Ta CardBus .It "SATech SN-54P" Ta RT2560 Ta PCI .It "Sitecom WL-112" Ta RT2560 Ta CardBus .It "Sitecom WL-115" Ta RT2560 Ta PCI .It "SMC SMCWCB-GM" Ta RT2661 Ta CardBus .It "SMC SMCWPCI-GM" Ta RT2661 Ta PCI .It "SparkLAN WL-685R" Ta RT2560 Ta CardBus .It "Surecom EP-9321-g" Ta RT2560 Ta PCI .It "Surecom EP-9321-g1" Ta RT2560 Ta PCI .It "Surecom EP-9428-g" Ta RT2560 Ta CardBus .It "Sweex LC500050" Ta RT2560 Ta CardBus .It "Sweex LC700030" Ta RT2560 Ta PCI .It "TekComm NE-9321-g" Ta RT2560 Ta PCI .It "TekComm NE-9428-g" Ta RT2560 Ta CardBus .It "Unex CR054g-R02" Ta RT2560 Ta PCI .It "Unex MR054g-R02" Ta RT2560 Ta CardBus .It "Zinwell ZWX-G160" Ta RT2560 Ta CardBus .It "Zinwell ZWX-G360" Ta RT2560 Ta mini-PCI .It "Zinwell ZWX-G361" Ta RT2560 Ta PCI .It "Zonet ZEW1500" Ta RT2560 Ta CardBus .It "Zonet ZEW1600" Ta RT2560 Ta PCI .El .Sh EXAMPLES Join an existing BSS network (i.e., connect to an access point): .Pp .Dl "ifconfig wlan create wlandev ral0 inet 192.168.0.20 netmask 0xffffff00" .Pp Join a specific BSS network with network name .Dq Li my_net : .Bd -literal -offset indent ifconfig wlan create wlandev ral0 inet 192.168.0.20 \e netmask 0xffffff00 ssid my_net .Ed .Pp Join a specific BSS network with 40-bit WEP encryption: .Bd -literal -offset indent ifconfig wlan create wlandev ral0 inet 192.168.0.20 \e netmask 0xffffff00 ssid my_net \e wepmode on wepkey 0x1234567890 weptxkey 1 .Ed .Pp Join a specific BSS network with 104-bit WEP encryption: .Bd -literal -offset indent ifconfig wlan create wlandev ral0 inet 192.168.0.20 \e netmask 0xffffff00 ssid my_net \e wepmode on wepkey 0x01020304050607080910111213 weptxkey 1 .Ed .Sh DIAGNOSTICS .Bl -diag .It "ral%d: could not load 8051 microcode" An error occurred while attempting to upload the microcode to the onboard 8051 microcontroller unit. .It "ral%d: timeout waiting for MCU to initialize" The onboard 8051 microcontroller unit failed to initialize in time. .It "ral%d: device timeout" A frame dispatched to the hardware for transmission did not complete in time. The driver will reset the hardware. This should not happen. .El .Sh SEE ALSO .Xr cardbus 4 , .Xr intro 4 , .Xr wlan 4 , .Xr wlan_ccmp 4 , .Xr wlan_tkip 4 , .Xr wlan_wep 4 , .Xr wlan_xauth 4 , .Xr hostapd 8 , .Xr ifconfig 8 , .Xr wpa_supplicant 8 -.Rs -.%T "Ralink Technology" -.%U http://www.ralinktech.com/ -.Re .Sh HISTORY The .Nm driver first appeared in .Ox 3.7 . Support for the RT2501 and RT2600 chipsets was added in .Ox 3.9 . Support for the RT2800 chipset was added in .Ox 4.3 . Support for the RT2700 chipset was added in .Ox 4.4 . Support for the RT3090 chipset was added in .Ox 4.9 . .Sh AUTHORS The original .Nm driver was written by .An Damien Bergamini Aq Mt damien@openbsd.org . .Sh CAVEATS The .Nm driver does not make use of the hardware cryptographic engine. .Pp The .Nm driver does not support any of the 802.11n capabilities offered by the RT2700 and RT2800 chipsets. Additional work is required in before those features can be supported. .Pp Host AP mode does not support power saving. Clients attempting to use power saving mode may experience significant packet loss (disabling power saving on the client will fix this). .Pp Some PCI .Nm adapters strictly require a system supporting PCI 2.2 or greater. Check the board's PCI version before purchasing the card as it is likely these adapters will not work in systems based on older revisions of the PCI specification. diff --git a/share/man/man4/rum.4 b/share/man/man4/rum.4 index 79f104c43c97..fed7195a970f 100644 --- a/share/man/man4/rum.4 +++ b/share/man/man4/rum.4 @@ -1,188 +1,184 @@ .\" .\" Copyright (c) 2005-2007 .\" Damien Bergamini .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .\" $FreeBSD$ .\" .Dd November 8, 2018 .Dt RUM 4 .Os .Sh NAME .Nm rum .Nd Ralink Technology USB IEEE 802.11a/b/g wireless network device .Sh SYNOPSIS To compile this driver into the kernel, place the following lines in your kernel configuration file: .Bd -ragged -offset indent .Cd "device ehci" .Cd "device uhci" .Cd "device ohci" .Cd "device usb" .Cd "device rum" .Cd "device wlan" .Cd "device wlan_amrr" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent if_rum_load="YES" .Ed .Sh DESCRIPTION The .Nm driver supports USB 2.0 and PCI Express Mini Card wireless adapters based on the Ralink RT2501USB and RT2601USB chipsets. .Pp Ralink PCI Express Mini Card adapters show up as normal USB 2.0 devices and are thus handled by the .Nm driver. .Pp The RT2501USB chipset is the second generation of 802.11a/b/g adapters from Ralink. It consists of two integrated chips, an RT2571W MAC/BBP and an RT2528 or RT5226 radio transceiver. .Pp The RT2601USB chipset consists of two integrated chips, an RT2671 MAC/BBP and an RT2527 or RT5225 radio transceiver. This chipset uses the MIMO (multiple-input multiple-output) technology with multiple antennas to extend the operating range of the adapter and to achieve higher throughput. .Pp All chips have hardware support for WEP, AES-CCM, TKIP, and Michael cryptographic operations. .Pp .Nm supports .Cm station , .Cm adhoc , .Cm adhoc-demo , .Cm hostap , and .Cm monitor mode operation. Only one virtual interface may be configured at any time. For more information on configuring this device, see .Xr ifconfig 8 . .Sh HARDWARE The .Nm driver supports USB 2.0 wireless adapters based on the Ralink RT2501USB and RT2601USB chipsets, including: .Pp .Bl -column -compact "Atlantis Land A02-PCM-W54" "Bus" .It Em Card Ta Em Bus .It "3Com Aolynk WUB320g" Ta USB .It "Abocom WUG2700 Ta" Ta USB .It "Airlink101 AWLL5025" Ta USB .It "ASUS WL-167g ver 2" Ta USB .It "Belkin F5D7050 ver 3" Ta USB .It "Belkin F5D9050 ver 3" Ta USB .It "Buffalo WLI-U2-SG54HP" Ta USB .It "Buffalo WLI-U2-SG54HG" Ta USB .It "Buffalo WLI-U2-G54HP" Ta USB .It "Buffalo WLI-UC-G" Ta USB .It "CNet CWD-854 ver F" Ta USB .It "Conceptronic C54RU ver 2" Ta USB .It "Corega CG-WLUSB2GO" Ta USB .It "D-Link DWA-110" Ta USB .It "D-Link DWA-111" Ta USB .It "D-Link DWL-G122 rev C1" Ta USB .It "D-Link WUA-1340" Ta USB .It "Digitus DN-7003GR" Ta USB .It "Edimax EW-7318USG" Ta USB .It "Gigabyte GN-WB01GS" Ta USB .It "Gigabyte GN-WI05GS" Ta USB .It "Hawking HWUG1" Ta USB .It "Hawking HWU54DM" Ta USB .It "Hercules HWGUSB2-54-LB" Ta USB .It "Hercules HWGUSB2-54V2-AP" Ta USB .It "LevelOne WNC-0301USB v3" Ta USB .It "Linksys WUSB54G rev C" Ta USB .It "Linksys WUSB54GR" Ta USB .It "Planex GW-US54HP" Ta USB .It "Planex GW-US54Mini2" Ta USB .It "Planex GW-USMM" Ta USB .It "Senao NUB-3701" Ta USB .It "Sitecom WL-113 ver 2" Ta USB .It "Sitecom WL-172" Ta USB .It "Sweex LW053" Ta USB .It "TP-LINK TL-WN321G v1/v2/v3" Ta USB .El .Sh EXAMPLES Join an existing BSS network (i.e., connect to an access point): .Bd -literal -offset indent ifconfig wlan create wlandev rum0 inet 192.168.0.20 \e netmask 0xffffff00 .Ed .Pp Join a specific BSS network with network name .Dq Li my_net : .Pp .Dl "ifconfig wlan create wlandev rum0 ssid my_net up" .Pp Join a specific BSS network with 64-bit WEP encryption: .Bd -literal -offset indent ifconfig wlan create wlandev rum0 ssid my_net \e wepmode on wepkey 0x1234567890 weptxkey 1 up .Ed .Pp Join a specific BSS network with 128-bit WEP encryption: .Bd -literal -offset indent ifconfig wlan create wlandev rum0 wlanmode adhoc ssid my_net \e wepmode on wepkey 0x01020304050607080910111213 weptxkey 1 .Ed .Sh DIAGNOSTICS .Bl -diag .It "rum%d: could not load 8051 microcode" An error occurred while attempting to upload the microcode to the onboard 8051 microcontroller unit. The driver will reset the hardware. This should not happen. .El .Sh SEE ALSO .Xr intro 4 , .Xr netintro 4 , .Xr usb 4 , .Xr wlan 4 , .Xr wlan_amrr 4 , .Xr wlan_ccmp 4 , .Xr wlan_tkip 4 , .Xr wlan_wep 4 , .Xr wlan_xauth 4 , .Xr hostapd 8 , .Xr ifconfig 8 , .Xr wpa_supplicant 8 -.Rs -.%T "Ralink Technology" -.%U http://www.ralinktech.com/ -.Re .Sh HISTORY The .Nm driver first appeared in .Ox 4.0 . .Sh AUTHORS .An -nosplit The original .Nm driver was written by .An Niall O'Higgins Aq Mt niallo@openbsd.org and .An Damien Bergamini Aq Mt damien@openbsd.org . diff --git a/share/man/man4/run.4 b/share/man/man4/run.4 index 0cea7beada77..d27bca4b10b4 100644 --- a/share/man/man4/run.4 +++ b/share/man/man4/run.4 @@ -1,257 +1,254 @@ .\" $OpenBSD: run.4,v 1.22 2009/11/23 06:16:32 jmc Exp $ .\" .\" Copyright (c) 2008 Damien Bergamini .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .\" $FreeBSD$ .\" .Dd May 23, 2021 .Dt RUN 4 .Os .Sh NAME .Nm run .Nd Ralink Technology USB IEEE 802.11a/g/n wireless network device .Sh SYNOPSIS To compile this driver into the kernel, place the following lines in your kernel configuration file: .Bd -ragged -offset indent .Cd "device ehci" .Cd "device uhci" .Cd "device ohci" .Cd "device usb" .Cd "device run" .Cd "device wlan" .Cd "device wlan_amrr" .Ed .Pp Firmware is also needed, and provided by: .Bd -ragged -offset indent .Cd "device runfw" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following lines in .Xr loader.conf 5 : .Bd -literal -offset indent if_run_load="YES" runfw_load="YES" .Ed .Sh DESCRIPTION The .Nm driver supports USB 2.0 wireless adapters based on the Ralink RT2700U, RT2800U, RT3000U and RT3900E chipsets. .Pp The RT2700U chipset consists of two integrated chips, an RT2770 MAC/BBP and an RT2720 (1T2R) or RT2750 (dual-band 1T2R) radio transceiver. .Pp The RT2800U chipset consists of two integrated chips, an RT2870 MAC/BBP and an RT2820 (2T3R) or RT2850 (dual-band 2T3R) radio transceiver. .Pp The RT3000U is a single-chip solution based on an RT3070 MAC/BBP and an RT3020 (1T1R), RT3021 (1T2R) or RT3022 (2T2R) single-band radio transceiver. .Pp The RT3900E is a single-chip USB 2.0 802.11n solution. The MAC/Baseband Processor can be an RT3593, RT5390, RT5392 or an RT5592. The radio can be an RT3053, RT5370, RT5372 or an RT5572. The RT3053 chip operates in the 2GHz and 5GHz spectra and supports up to 3 transmit paths and 3 receiver paths (3T3R). The RT5370 chip operates in the 2GHz spectrum and supports 1 transmit path and 1 receiver path (1T1R). The RT5372 chip operates in the 2GHz spectrum and supports up to 2 transmit paths and 2 receiver paths (2T2R). The RT5572 chip operates in the 2GHz and 5GHz spectra and supports up to 2 transmit paths and 2 receiver paths (2T2R). .Pp These are the modes the .Nm driver can operate in: .Bl -tag -width "IBSS-masterXX" .It BSS mode Also known as .Em infrastructure mode, this is used when associating with an access point, through which all traffic passes. This mode is the default. .It Host AP mode In this mode the driver acts as an access point (base station) for other cards. .It monitor mode In this mode the driver is able to receive packets without associating with an access point. This disables the internal receive filter and enables the card to capture packets from networks which it wouldn't normally have access to, or to scan for access points. .El .Pp The .Nm driver can be configured to use Wired Equivalent Privacy (WEP) or Wi-Fi Protected Access (WPA-PSK and WPA2-PSK). WPA is the de facto encryption standard for wireless networks. It is strongly recommended that WEP not be used as the sole mechanism to secure wireless communication, due to serious weaknesses in it. The .Nm driver offloads both encryption and decryption of data frames to the hardware for the WEP40, WEP104, TKIP(+MIC) and CCMP ciphers. .Pp The .Nm driver can be configured at runtime with .Xr ifconfig 8 . .Sh HARDWARE The .Nm driver supports the following wireless adapters: .Pp .Bl -tag -width Ds -offset indent -compact .It Airlink101 AWLL6090 .It ASUS USB-N11 .It ASUS USB-N13 ver. A1 .It ASUS USB-N14 .It ASUS USB-N66 .It ASUS WL-160N .It Belkin F5D8051 ver 3000 .It Belkin F5D8053 .It Belkin F5D8055 .It Belkin F6D4050 ver 1 .It Belkin F9L1103 .It Buffalo WLI-UC-AG300N .It Buffalo WLI-UC-G300HP .It Buffalo WLI-UC-G300N .It Buffalo WLI-UC-G301N .It Buffalo WLI-UC-GN .It Buffalo WLI-UC-GNM .It Buffalo WLI-UC-GNM2 .It Corega CG-WLUSB2GNL .It Corega CG-WLUSB2GNR .It Corega CG-WLUSB300AGN .It Corega CG-WLUSB300GNM .It D-Link DWA-130 rev B1 .It D-Link DWA-130 rev F1 .It D-Link DWA-140 rev B1, B2, B3, \&D1 .It D-Link DWA-160 rev B2 .It D-Link DWA-162 .It DrayTek Vigor N61 .It Edimax EW-7711UAn .It Edimax EW-7711UTn .It Edimax EW-7717Un .It Edimax EW-7718Un .It Edimax EW-7733UnD .It Gigabyte GN-WB30N .It Gigabyte GN-WB31N .It Gigabyte GN-WB32L .It Hawking HWDN1 .It Hawking HWUN1 .It Hawking HWUN2 .It Hercules HWNU-300 .It Linksys WUSB54GC v3 .It Linksys WUSB600N .It Logitec LAN-W150N/U2 .It Mvix Nubbin MS-811N .It Panda Wireless PAU06 .It Planex GW-USMicroN .It Planex GW-US300MiniS .It Sitecom WL-182 .It Sitecom WL-188 .It Sitecom WL-301 .It Sitecom WL-302 .It Sitecom WL-315 .It SMC SMCWUSBS-N2 .It Sweex LW303 .It Sweex LW313 .It TP-LINK TL-WDN3200 .It TP-LINK TL-WN321G v4 .It TP-LINK TL-WN727N v3 .It Unex DNUR-81 .It Unex DNUR-82 .It ZyXEL NWD2705 .It ZyXEL NWD210N .It ZyXEL NWD270N .El .Sh EXAMPLES Join an existing BSS network (i.e., connect to an access point): .Bd -literal -offset indent ifconfig wlan create wlandev run0 inet 192.168.0.20 \e netmask 0xffffff00 .Ed .Pp Join a specific BSS network with network name .Dq Li my_net : .Pp .Dl "ifconfig wlan create wlandev run0 ssid my_net up" .Pp Join a specific BSS network with 64-bit WEP encryption: .Bd -literal -offset indent ifconfig wlan create wlandev run0 ssid my_net \e wepmode on wepkey 0x1234567890 weptxkey 1 up .Ed .Pp Join a specific BSS network with 128-bit WEP encryption: .Bd -literal -offset indent ifconfig wlan create wlandev run0 wlanmode adhoc ssid my_net \e wepmode on wepkey 0x01020304050607080910111213 weptxkey 1 .Ed .Sh DIAGNOSTICS .Bl -diag .It "run%d: faild load firmware of file runfw" For some reason, the driver was unable to read the microcode file from the filesystem. The file might be missing or corrupted. .It "run%d: could not load 8051 microcode" An error occurred while attempting to upload the microcode to the onboard 8051 microcontroller unit. .It "run%d: device timeout" A frame dispatched to the hardware for transmission did not complete in time. The driver will reset the hardware. This should not happen. .El .Sh SEE ALSO .Xr intro 4 , .Xr netintro 4 , .Xr runfw 4 , .Xr usb 4 , .Xr wlan 4 , .Xr wlan_amrr 4 , .Xr wlan_ccmp 4 , .Xr wlan_tkip 4 , .Xr wlan_wep 4 , .Xr wlan_xauth 4 , .Xr hostapd 8 , .Xr ifconfig 8 , .Xr wpa_supplicant 8 -.Pp -Ralink Technology: -.Pa http://www.ralinktech.com/ .Sh HISTORY The .Nm driver first appeared in .Ox 4.5 . .Sh AUTHORS The .Nm driver was written by .An Damien Bergamini Aq Mt damien@openbsd.org . .Sh CAVEATS The .Nm driver supports some of the 11n capabilities found in the RT2800, RT3000 and RT3900 chipsets. diff --git a/share/man/man4/ural.4 b/share/man/man4/ural.4 index 4b412f57905a..ceb0eee26ef4 100644 --- a/share/man/man4/ural.4 +++ b/share/man/man4/ural.4 @@ -1,165 +1,161 @@ .\" Copyright (c) 2005, 2006 .\" Damien Bergamini .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .\" $FreeBSD$ .\" .Dd April 13, 2008 .Dt URAL 4 .Os .Sh NAME .Nm ural .Nd "Ralink Technology RT2500USB IEEE 802.11 driver" .Sh SYNOPSIS To compile this driver into the kernel, place the following lines in your kernel configuration file: .Bd -ragged -offset indent .Cd "device ehci" .Cd "device uhci" .Cd "device ohci" .Cd "device usb" .Cd "device ural" .Cd "device wlan" .Cd "device wlan_amrr" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent if_ural_load="YES" .Ed .Sh DESCRIPTION The .Nm driver supports USB 2.0 wireless adapters based on the RT2500USB chipset. .Pp The RT2500USB chipset consists of two integrated chips, a RT2570 MAC/BBP and a radio transceiver (the model of which depends on the card revision). .Pp The RT2522, RT2523, RT2524, RT2525, RT2525e and RT2526 radio transceivers operate in the 2.4GHz band (802.11b/g) whereas the RT5222 is a dual-band radio transceiver that can operate in the 2.4GHz and 5.2GHz bands (802.11a). .Pp .Nm supports .Cm station , .Cm adhoc , .Cm hostap , and .Cm monitor mode operation. Only one virtual interface may be configured at any time. For more information on configuring this device, see .Xr ifconfig 8 . .Sh HARDWARE The .Nm driver supports USB 2.0 wireless adapters based on the Ralink Technology RT2500USB chipset, including: .Pp .Bl -column -compact ".Li Atlantis Land A02-PCM-W54" "Bus" .It Em Card Ta Em Bus .It "AMIT WL532U" Ta USB .It "ASUS WL-167g" Ta USB .It "Belkin F5D7050 v2000" Ta USB .It "Buffalo WLI-U2-KG54-AI" Ta USB .It "CNet CWD-854" Ta USB .It "Compex WLU54G 2A1100" Ta USB .It "Conceptronic C54RU" Ta USB .It "D-Link DWL-G122 b1" Ta USB .It "Dynalink WLG25USB" Ta USB .It "E-Tech WGUS02" Ta USB .It "Gigabyte GN-WBKG" Ta USB .It "Hercules HWGUSB2-54" Ta USB .It "KCORP LifeStyle KLS-685" Ta USB .It "Linksys WUSB54G v4" Ta USB .It "Linksys WUSB54GP v4" Ta USB .It "MSI MS-6861" Ta USB .It "MSI MS-6865" Ta USB .It "MSI MS-6869" Ta USB .It "NovaTech NV-902" Ta USB .It "OvisLink Evo-W54USB" Ta USB .It "SerComm UB801R" Ta USB .It "SparkLAN WL-685R" Ta USB .It "Surecom EP-9001-g" Ta USB .It "Sweex LC100060" Ta USB .It "Tonze UW-6200C" Ta USB .It "Zinwell ZWX-G261" Ta USB .It "Zonet ZEW2500P" Ta USB .El .Pp An up to date list can be found at .Pa http://ralink.rapla.net/ . .Sh EXAMPLES Join an existing BSS network (i.e., connect to an access point): .Bd -literal -offset indent ifconfig wlan create wlandev ural0 inet 192.168.0.20 \e netmask 0xffffff00 .Ed .Pp Join a specific BSS network with network name .Dq Li my_net : .Pp .Dl "ifconfig wlan create wlandev ural0 ssid my_net up" .Pp Join a specific BSS network with 64-bit WEP encryption: .Bd -literal -offset indent ifconfig wlan create wlandev ural0 ssid my_net \e wepmode on wepkey 0x1234567890 weptxkey 1 up .Ed .Pp Join a specific BSS network with 128-bit WEP encryption: .Bd -literal -offset indent ifconfig wlan create wlandev ural0 wlanmode adhoc ssid my_net \e wepmode on wepkey 0x01020304050607080910111213 weptxkey 1 .Ed .Sh DIAGNOSTICS .Bl -diag .It "ural%d: device timeout" The driver will reset the hardware. This should not happen. .El .Sh SEE ALSO .Xr intro 4 , .Xr netintro 4 , .Xr usb 4 , .Xr wlan 4 , .Xr wlan_amrr 4 , .Xr wlan_ccmp 4 , .Xr wlan_tkip 4 , .Xr wlan_wep 4 , .Xr wlan_xauth 4 , .Xr hostapd 8 , .Xr ifconfig 8 , .Xr wpa_supplicant 8 -.Rs -.%T "Ralink Technology" -.%U http://www.ralinktech.com/ -.Re .Sh HISTORY The .Nm driver first appeared in .Ox 3.7 . .Sh AUTHORS The original .Nm driver was written by .An Damien Bergamini Aq Mt damien.bergamini@free.fr . .Sh BUGS Host AP mode doesn't support client power save. Clients using power save mode will experience packet loss (disabling power saving on the client will fix this).