|
Size: 5517
Comment: Formatting, add link.
|
Size: 6315
Comment: Update for driver in mainline.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| ||<tablestyle="width: 100%;" style="border: 0px hidden">~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: none-~||<style="text-align: right;border: 0px hidden"> (!) [[/Discussion|Discussion]]|| | ~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: none-~ |
| Line 4: | Line 4: |
| = Hermes USB devices (orinoco_usb) = This page describes how to enable support for !WiFi devices based on the Hermes chipset - using a USB interface - on Debian systems. |
= Hermes I USB devices (orinoco_usb) = This page describes how to enable support for !WiFi devices based on the Hermes I chipset - using a USB interface - on Debian systems. |
| Line 9: | Line 9: |
| The Orinoco USB driver is a fork of the [[orinoco|Orinoco]] driver, specifically supporting early-model (aka "variant 1", "old variant") ORiNOCO USB wireless LAN devices. [[#supported|Supported devices]] are listed at the end of this page. | Support of early-model (aka "variant 1", "old variant") ORiNOCO USB wireless LAN devices is available in the mainline [[orinoco|Orinoco]] driver since Linux 2.6.35. [[#supported|Supported devices]] are listed at the end of this page. |
| Line 11: | Line 11: |
| These devices are essentially adapters. Internally, they consist of a PCMCIA (PC Card) device with a Lucent/Agere Hermes chipset, connected by a PCMCIA-to-USB ("EZUSB") bridge to the host system. Firmware for the EZUSB bridge is required to be installed, which can be extracted from the relevant Windows XP driver using a utility script. |
These devices are essentially adapters. Internally, they consist of a PCMCIA (PC Card) device with a Lucent/Agere Hermes I chipset, connected by a PCMCIA-to-USB ("EZUSB") bridge to the host system. |
| Line 16: | Line 14: |
| The Orinoco USB driver is not included in the mainline Linux kernel. It is required to be acquired from the Orinoco driver's "usb" Subversion branch and compiled on your system. | The Orinoco USB driver is included in the mainline Linux kernel since version 2.6.35. |
| Line 18: | Line 16: |
| 1. Install the DebPkg:build-essential, relevant linux-headers, DebPkg:subversion, DebPkg:unzip, DebPkg:wget and DebPkg:wireless-tools packages: {{{ | For device operation, firmware for the EZUSB bridge is required to be installed. For [[WPA]] support, card firmware version 9.42 (or later) is required together with compatible bridge firmware; the Orinoco driver will attempt to download card firmware from userspace during device initialization. === Sid === ## adjust/rename to wheezy when linux-2.6 >= 2.6.37-2 migrates to testing 1. Add a "non-free" component to {{{/etc/apt/sources.list}}}, for example: {{{ # Debian Sid deb http://ftp.us.debian.org/debian sid main contrib non-free }}} 1. Update the list of available packages and install the DebianPkg:firmware-linux-nonfree, DebianPkg:unzip, DebianPkg:wget and DebianPkg:wireless-tools packages: {{{ # aptitude update # aptitude install firmware-linux-nonfree unzip wget wireless-tools && exit }}} 1. Acquire and install compatible EZUSB bridge firmware: {{{ $ wget http://replay.waybackmachine.org/20061206062642/http://www.agere.com/mobility/docs/windows_drivers_sr02-2.3.zip $ unzip windows_drivers_sr02-2.3.zip WLAGS51.SYS $ dd if=WLAGS51.SYS of=orinoco_ezusb_fw skip=10312 count=436 bs=16 |
| Line 20: | Line 34: |
| # aptitude update # aptitude install build-essential linux-headers-$(uname -r) subversion unzip wget wireless-tools # exit |
# mkdir /usr/local/lib/firmware # mv orinoco_ezusb_fw /usr/local/lib/firmware |
| Line 24: | Line 37: |
| 1. Checkout the usb branch of the Orinoco driver: {{{ $ svn co https://orinoco.svn.sourceforge.net/svnroot/orinoco/branches/usb orinoco_usb }}} 1. Compile the driver: {{{ $ cd orinoco_usb $ make }}} 1. Manually install the kernel modules: {{{ $ su # mkdir -p /lib/modules/$(uname -r)/updates/orinoco/drivers/net/wireless # cp orinoco.ko orinoco_usb.ko /lib/modules/$(uname -r)/updates/orinoco/drivers/net/wireless # depmod -a -F /boot/System.map-$(uname -r) $(uname -r) # exit }}} 1. Acquire and install the EZUSB bridge firmware: {{{ $ cd firmware $ ./get_ezusb_fw $ su # mv orinoco_ezusb_fw /lib/firmware }}} 1. Load the orinoco_usb module: {{{ $ su |
1. If not already performed, connect the device to your system. 1. The necessary kernel module should be [[Modules|automatically loaded]]. If necessary, it can be manually loaded via: {{{ |
| Line 48: | Line 42: |
| This module will be automatically loaded when your system is restarted and the device is connected. If not already performed, connect the device to your system. |
|
| Line 58: | Line 50: |
| === Troubleshooting === * Examine the kernel ring buffer (dmesg) to verify the EZUSB bridge firmware is being loaded by the driver. If this is not available, no wireless interface will be created. * Ensure the firmware is installed, then reinsert the kernel module: {{{modprobe -r orinoco_usb && modprobe orinoco_usb}}} |
== Troubleshooting == * Examine the kernel ring buffer ([[DebianMan:1/dmesg|dmesg(1)]]) to verify the EZUSB bridge firmware is being loaded by the driver. If this is not available, no wireless interface will be created. * Ensure the bridge firmware is installed, then reinsert the kernel module: {{{modprobe -r orinoco_usb ; modprobe orinoco_usb}}} * For [[WPA]] support, firmware version 9.42 or later is required to be downloaded to the card. * Ensure the DebianPkg:firmware-linux-nonfree package is installed. * WPA capability can be verified by the presence of "WPA-PSK supported" in the buffer: ~- {{{ [ 227.983302] usb 4-1: Firmware determined as Lucent/Agere 9.48 [ 227.983315] usb 4-1: Ad-hoc demo mode supported [ 227.983328] usb 4-1: IEEE standard IBSS ad-hoc mode supported [ 227.983342] usb 4-1: WEP supported, 104-bit key [ 227.983353] usb 4-1: WPA-PSK supported }}} -~ * Only WPA-PSK [[WikiPedia:Temporal_Key_Integrity_Protocol|TKIP]] is supported. * You may need to prevent wpa_supplicant from initially using WikiPedia:CCMP, for example: {{{ iface eth1 inet dhcp wpa-ssid foo wpa-psk barbazquxquuxcorgegraultgarplywaldofredplughxyzzythud # force WPA-PSK TKIP wpa-key_mgmt WPA-PSK wpa-proto WPA wpa-pairwise TKIP wpa-group TKIP }}} |
| Line 62: | Line 74: |
| == Known Issues == * This driver currently does not support [[WPA]] or Hermes II chipsets. Master mode operation is not available. * Installation of this driver will conflict with symbols used by the kernel-supplied [[orinoco]] driver, preventing the use of devices it would normally support. == Other Notes == PC Card devices containing an Intersil Prism 2 or 2.5 chipset can alternatively be used in the EZUSB bridge. An exception to this is high-powered devices (100/200 mW) as the adapter's USB voltage is insufficient. |
## commented as support for Prism 2/2.5 devices is disabled by default since Linux 2.6.35 ##== Other Notes == ##PC Card devices containing an Intersil Prism 2 or 2.5 chipset can alternatively be used in the EZUSB bridge. An exception to this is high-powered devices (100/200 mW) as the adapter's USB voltage is insufficient. |
| Line 74: | Line 83: |
| The following list is based on the ''alias'' fields of {{{ orinoco_usb }}} as at Subversion revision 1300. | The following list is based on the ''alias'' fields of {{{orinoco_usb}}} in Debian 2.6.37 (2.6.37-2) kernel images: |
| Line 96: | Line 105: |
| USB: 1630:FF81 (Vendor name unknown) (Device name unknown) | USB: 1630:FF81 2Wire, Inc. 802.11b Wireless Adapter [Lucent/Agere Hermes I] |
| Line 101: | Line 110: |
| All ORiNOCO USB "variant 2" / "new variant" devices. These devices use a single-board design with an Intersil Prism 2 chipset (see [[linux-wlan-ng]]). | All ORiNOCO USB "variant 2" / "new variant" devices. These devices use a single-board design with an Intersil Prism 2 chipset, see [[linux-wlan-ng]]. |
| Line 109: | Line 118: |
| * http://wireless.kernel.org/en/users/Drivers/orinoco - Driver page on Linux Wireless |
Translation(s): none
Hermes I USB devices (orinoco_usb)
This page describes how to enable support for WiFi devices based on the Hermes I chipset - using a USB interface - on Debian systems.
Contents
Support of early-model (aka "variant 1", "old variant") ORiNOCO USB wireless LAN devices is available in the mainline Orinoco driver since Linux 2.6.35. Supported devices are listed at the end of this page.
These devices are essentially adapters. Internally, they consist of a PCMCIA (PC Card) device with a Lucent/Agere Hermes I chipset, connected by a PCMCIA-to-USB ("EZUSB") bridge to the host system.
Installation
The Orinoco USB driver is included in the mainline Linux kernel since version 2.6.35.
For device operation, firmware for the EZUSB bridge is required to be installed. For WPA support, card firmware version 9.42 (or later) is required together with compatible bridge firmware; the Orinoco driver will attempt to download card firmware from userspace during device initialization.
Sid
Add a "non-free" component to /etc/apt/sources.list, for example:
# Debian Sid deb http://ftp.us.debian.org/debian sid main contrib non-free
Update the list of available packages and install the firmware-linux-nonfree, unzip, wget and wireless-tools packages:
# aptitude update # aptitude install firmware-linux-nonfree unzip wget wireless-tools && exit
Acquire and install compatible EZUSB bridge firmware:
$ wget http://replay.waybackmachine.org/20061206062642/http://www.agere.com/mobility/docs/windows_drivers_sr02-2.3.zip $ unzip windows_drivers_sr02-2.3.zip WLAGS51.SYS $ dd if=WLAGS51.SYS of=orinoco_ezusb_fw skip=10312 count=436 bs=16 $ su # mkdir /usr/local/lib/firmware # mv orinoco_ezusb_fw /usr/local/lib/firmware
- If not already performed, connect the device to your system.
The necessary kernel module should be automatically loaded. If necessary, it can be manually loaded via:
# modprobe orinoco_usb
Verify your device has an available interface:
# iwconfig
Raise the interface to activate the radio, for example:
# ifconfig eth1 up
Configure your interface as appropriate.
Troubleshooting
Examine the kernel ring buffer (dmesg(1)) to verify the EZUSB bridge firmware is being loaded by the driver. If this is not available, no wireless interface will be created.
Ensure the bridge firmware is installed, then reinsert the kernel module: modprobe -r orinoco_usb ; modprobe orinoco_usb
For WPA support, firmware version 9.42 or later is required to be downloaded to the card.
Ensure the firmware-linux-nonfree package is installed.
WPA capability can be verified by the presence of "WPA-PSK supported" in the buffer:
[ 227.983302] usb 4-1: Firmware determined as Lucent/Agere 9.48 [ 227.983315] usb 4-1: Ad-hoc demo mode supported [ 227.983328] usb 4-1: IEEE standard IBSS ad-hoc mode supported [ 227.983342] usb 4-1: WEP supported, 104-bit key [ 227.983353] usb 4-1: WPA-PSK supported
Only WPA-PSK TKIP is supported.
You may need to prevent wpa_supplicant from initially using CCMP, for example:
iface eth1 inet dhcp wpa-ssid foo wpa-psk barbazquxquuxcorgegraultgarplywaldofredplughxyzzythud # force WPA-PSK TKIP wpa-key_mgmt WPA-PSK wpa-proto WPA wpa-pairwise TKIP wpa-group TKIP
Supported Devices
The page HowToIdentifyADevice/USB explains how to identify a USB device.
The following list is based on the alias fields of orinoco_usb in Debian 2.6.37 (2.6.37-2) kernel images:
USB: 0411:0006 MelCo., Inc. WLI-USB-L11 Wireless LAN Adapter USB: 0411:000B MelCo., Inc. WLI-USB-L11G-WR Wireless LAN Adapter USB: 0411:000D MelCo., Inc. WLI-USB-L11G Wireless LAN Adapter USB: 047E:0300 Agere Systems, Inc. (Lucent) ORiNOCO Card USB: 049F:001F Compaq Computer Corp. WL215 Adapter USB: 049F:0076 Compaq Computer Corp. Wireless LAN MultiPort W200 USB: 049F:0082 Compaq Computer Corp. (Device name unknown) USB: 04E8:5002 Samsung Electronics Co., Ltd YP-30 USB: 04E8:5B11 Samsung Electronics Co., Ltd SEW-2001u Card USB: 04E8:7011 Samsung Electronics Co., Ltd SEW-2003U Card USB: 05CC:3100 ELSA AG AirLancer USB-11 USB: 0681:0012 Siemens Information and Communication Products I-Gate 802.11b Adapter USB: 0BF8:1002 Fujitsu Siemens Computers (Device name unknown) USB: 0D4E:047A Agere Systems Netherland BV WLAN Card USB: 0D4E:1000 Agere Systems Netherland BV Wireless Card Model 0801 USB: 0D4E:1001 Agere Systems Netherland BV Wireless Card Model 0802 USB: 0D98:0300 Mars Semiconductor Corp. Avaya Wireless Card USB: 0D9E:0300 Avaya Wireless Card USB: 0E7C:0300 (Vendor name unknown) (Device name unknown) USB: 1630:FF81 2Wire, Inc. 802.11b Wireless Adapter [Lucent/Agere Hermes I]
Unsupported
All ORiNOCO USB "variant 2" / "new variant" devices. These devices use a single-board design with an Intersil Prism 2 chipset, see linux-wlan-ng.
See Also
External Links
http://orinoco.nongnu.org/ - The Linux ORiNOCO Driver
http://wireless.kernel.org/en/users/Drivers/orinoco - Driver page on Linux Wireless
http://www.wlan.webd.pl/orinoco/ - Orinoco USB Unofficial Complex Support Page