Differences between revisions 22 and 38 (spanning 16 versions)
Revision 22 as of 2010-04-06 12:38:07
Size: 22337
Editor: GeoffSimmons
Comment: Add Squeeze procedure.
Revision 38 as of 2015-04-30 11:38:09
Size: 11368
Editor: GeoffSimmons
Comment: Amend for Debian 8.0 release, update supported devices.
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)]]: [[fr/orinoco|Français]]-~
Line 4: Line 4:
= Hermes I, Prism 2/2.5/3, Spectrum24 Trilogy devices (orinoco) =
This page describes how to enable support for !WiFi devices based on the Hermes I (Lucent/Agere), Prism 2/2.5/3 (Conexant, formerly Intersil) and Spectrum24 Trilogy (Symbol) chipsets; using the Orinoco driver on Debian systems.

<<TableOfContents(3)>>
= Hermes I and Spectrum24 Trilogy devices (orinoco) =
This page describes how to enable support for !WiFi devices based on the Hermes I (Lucent/Agere) and Spectrum24 Trilogy (Symbol) chipsets; using the Orinoco driver on Debian systems.

<<TableOfContents(2)>>
Line 12: Line 12:
The [[http://orinoco.nongnu.org/|Orinoco driver]] is a collection of modules providing support for various 802.11b devices, based on the Hermes I, Prism 2/2.5/3 or Spectrum24 Trilogy chipsets: The [[http://orinoco.nongnu.org/|Orinoco driver]] is a collection of modules providing support for various 802.11b devices, based on the Hermes I and Spectrum24 Trilogy chipsets:
Line 15: Line 15:
   * Supports the [[WikiPedia:AirPort#AirPort_802.11b_Card|AirPort Card]] (not !AirPort Extreme).    * Supports the [[WikiPedia:AirPort#AirPort_802.11b_card|AirPort card]] (not !AirPort Extreme).
Line 17: Line 17:
   * Supports Hermes I (Lucent/Agere) and Prism-based PCMCIA/PC Card devices.    * Supports Hermes I (Lucent/Agere) PCMCIA/PC Card devices.
Line 19: Line 19:
   * Supports Hermes I (Lucent/Agere) and Prism-based PC Card devices using the Nortel PCI bridge.
  * orinoco_pci ([[#supported-orinoco-pci|supported devices]])
   * Supports Hermes I (Lucent/Agere) and Prism-based devices using a direct PCI interface.
   * Supports Hermes I (Lucent/Agere) PC Card devices using the Nortel PCI bridge.
Line 23: Line 21:
   * Supports Hermes I (Lucent/Agere) and Prism-based PC Card devices using the PLX9052 PCI bridge.    * Supports Hermes I (Lucent/Agere) PC Card devices using the PLX9052 PCI bridge.
Line 25: Line 23:
   * Supports Hermes I (Lucent/Agere) and Prism-based PC Card devices using the TMD7160 PCI bridge.    * Supports Hermes I (Lucent/Agere) PC Card devices using the TMD7160 PCI bridge.
  * [[orinoco_usb]] ([[orinoco_usb#supported|supported devices]])
   * Supports Hermes I (Lucent/Agere) based USB devices.
   * Introduced in Linux 2.6.35.
Line 28: Line 29:
   * Introduced in kernel 2.6.14.

<!> USB devices are [[#unsupported|not supported]] (for Hermes, see [[orinoco_usb]]; for Prism, see [[linux-wlan-ng]]).

While Prism 2/2.5/3 chipsets are supported, use of the [[hostap]] driver is generally preferred
.

As of Linux kernel 2.6.28-rc1, downloading of firmware to volatile memory (RAM) and [[WPA]] support is available for Hermes I-based devices. For WPA support, firmware version 9.42 (or later) is required. The Orinoco driver will attempt to download firmware from userspace during device initialization.
   * Introduced in Linux 2.6.14.

Previous support for Prism 2/2.5/3 chipsets (orinoco_pci module) is disabled by default since Linux 2.6.35<<FootNote([[https://git.kernel.org/linus/484b4dd582867c6cfec3a1feb128d60af21c4978|"orinoco: disable support for prism chipset by default" (git.kernel.org)]])>>, see [[hostap]] for device support. For support of Prism-based USB 802.11b devices, see [[linux-wlan-ng]].

As of Linux 2.6.28, downloading of firmware to volatile memory (RAM) and [[WPA]] support is available for Hermes I-based devices. For WPA support, firmware version 9.42 (or later) is required. The Orinoco driver will attempt to download firmware from userspace during device initialization.
Line 39: Line 38:
The Orinoco driver is included in the mainline Linux kernel since 2.4.3. It is included as modules in Debian kernel images.

<<Anchor(lenny)>>
=== Lenny ===
Using [[DebianEtch|Etch]]? [[#etch|Skip to the Etch section]].

==== WPA (Hermes I only) ====
You can [[#lenny-general|skip this section]] if WPA support is not required, or if your device has a Prism or Spectrum24 Trilogy chipset.

For [[WPA]] support, Linux 2.6.28 or later is required. Firmware is also required to be installed prior to driver operation.

 1. Add the [[Backports|Debian Backports]] repository to {{{/etc/apt/sources.list}}}, also including the "non-free" component. For example: {{{
# Backported packages for Debian Lenny
deb http://www.backports.org/debian lenny-backports main contrib non-free
}}}
 1. Update the list of available packages and install the DebianPkg:lenny-backports/debian-backports-keyring package: {{{
# aptitude update
# aptitude -t lenny-backports install debian-backports-keyring
}}}
 As your system does not yet have the GnuPG archive key of the backports.org repository installed, you will be asked to confirm installation of a package from an untrusted repository. Enter {{{Yes}}} when prompted.

 1. Install a 2.6.32 kernel image appropriate for your system, along with the DebianPkg:lenny-backports/firmware-linux-nonfree package. For example: {{{
# aptitude update
# aptitude -t lenny-backports install linux-image-2.6-$(uname -r | sed 's,.*-,,') firmware-linux-nonfree
}}}
 1. Restart your system and boot with the newly installed kernel, then continue with the [[#lenny-general|procedure below]].

<<Anchor(lenny-general)>>
==== General ====
 1. Install the DebianPkg:wireless-tools package: {{{
# aptitude install wireless-tools
}}}
 1. For users with Spectrum24 Trilogy-based devices only:

 Firmware is required for devices without flash memory. This can be downloaded and extracted using the {{{get_symbol_fw}}} script available from [[http://prdownloads.sourceforge.net/orinoco/|orinoco-fwutils]]: {{{
The Orinoco driver was introduced in Linux 2.4.3 and consists of modules in Debian Linux kernel images.

=== WPA (Hermes I only) ===
You can [[#general|skip this section]] if WPA support is not required, or if your device has a Spectrum24 Trilogy chipset.

Firmware version 9.42 or later is required for WPA support:

 1. Add a "non-free" component to {{{/etc/apt/sources.list}}}, for example: {{{
# Debian 8 "Jessie"
deb http://http.debian.net/debian/ jessie main contrib non-free
}}}
 1. Update the list of available packages and install the DebianPkg:firmware-linux-nonfree package: {{{
# apt-get update && apt-get install firmware-linux-nonfree
}}}
 1. Continue with the [[#general|procedure below]].

<<Anchor(general)>>
=== General ===
 1. For users with Spectrum24 Trilogy-based devices only: firmware is required for devices without flash memory. This can be downloaded and extracted using the {{{get_symbol_fw}}} script available from [[http://sourceforge.net/projects/orinoco/files/orinoco-fwutils/|orinoco-fwutils]]: {{{
Line 75: Line 58:
# aptitude install unzip # apt-get install unzip
Line 82: Line 65:
# mkdir -p /usr/local/lib/firmware
# mv symbol_sp24t_prim_fw symbol_sp24t_sec_fw /usr/local/lib/firmware
}}}
 1. If not already performed, connect the device to your system.
 1. The necessary kernel modules should be [[Modules|automatically loaded]]. If necessary, the required modules can be loaded manually with one of the following commands (depending on your device's host interface): {{{
# modprobe airport
}}} ''or'' {{{
# modprobe orinoco_cs
}}} ''or'' {{{
# modprobe orinoco_nortel
}}} ''or'' {{{
# modprobe orinoco_pci
}}} ''or'' {{{
# modprobe orinoco_plx
}}} ''or'' {{{
# modprobe orinoco_tmd
}}} ''or'' {{{
# modprobe spectrum_cs
}}}
 1. Verify your device has an available interface: {{{
# iwconfig
}}}
 1. Raise the interface to activate the radio, for example: {{{
# ifconfig eth1 up
}}}
 1. [[WiFi/HowToUse|Configure]] your interface as appropriate. See also [[#issues|known issues]].

==== Troubleshooting ====
 * For [[WPA]] support on Hermes I-based devices, firmware version 9.42 or later is required to be downloaded to the card.
  * Ensure the Lucent/Agere station firmware ({{{agere_sta_fw.bin}}}) is available when requested, check the kernel ring buffer ([[DebianMan:1/dmesg|dmesg(1)]]).
  * Ensure the DebianPkg:lenny-backports/firmware-linux-nonfree package is installed.
  * WPA capability can be verified by the presence of "WPA-PSK supported" in the buffer: ~- {{{
[ 2598.821904] eth1: Program end returned 0
[ 2598.821913] eth1: hermes_present returned 1
[ 2598.822731] eth1: Hardware identity 0001:0002:0003:0004
[ 2598.822854] eth1: Station identity 0005:0006:0007:0008
[ 2598.822868] eth1: Firmware determined as Lucent/Agere 9.48
[ 2598.822877] eth1: Ad-hoc demo mode supported
[ 2598.822885] eth1: IEEE standard IBSS ad-hoc mode supported
[ 2598.822892] eth1: WEP supported, 104-bit key
[ 2598.822901] eth1: WPA-PSK supported
[ 2599.051164] eth1: MAC address 00:11:22:33:44:55
[ 2599.051265] eth1: Station name "HERMES I"
[ 2599.051828] eth1: ready
}}} -~
  * See also [[#issues|known issues]].
 * Spectrum24 Trilogy-based devices without flash memory: Examine the kernel ring buffer ([[DebianMan:1/dmesg|dmesg(1)]]) to verify required firmware files are being loaded by the driver. If requested firmware is not available, no wireless interface will be created.
  * Ensure the firmware files produced by the {{{get_symbol_fw}}} script ({{{symbol_sp24t_prim_fw}}}, {{{symbol_sp24t_sec_fw}}}) were moved to {{{/usr/local/lib/firmware}}}.

<<Anchor(etch)>>
=== Etch ===

 1. Install the DebianPkg:wireless-tools package: {{{
# aptitude update && aptitude install wireless-tools
}}}
 1. For users with Spectrum24 Trilogy-based devices only:

 Firmware is required for devices without flash memory. This can be downloaded and extracted using the {{{get_symbol_fw}}} script available from [[http://prdownloads.sourceforge.net/orinoco/|orinoco-fwutils]]: {{{
$ su
# aptitude install unzip
# exit
$ wget 'http://downloads.sourceforge.net/orinoco/orinoco-fwutils-0.3.tar.gz?download'
$ tar xvf orinoco-fwutils-0.3.tar.gz
$ cd orinoco-fwutils-0.3
$ ./get_symbol_fw
$ su
# mkdir -p /usr/local/lib/firmware
# mv symbol_sp24t_prim_fw symbol_sp24t_sec_fw /usr/local/lib/firmware
}}}
 1. If not already performed, connect the device to your system.
 1. The necessary kernel modules should be [[Modules|automatically loaded]]. If necessary, the required modules can be loaded manually with one of the following commands (depending on your device's host interface): {{{
# modprobe airport
}}} ''or'' {{{
# modprobe orinoco_cs
}}} ''or'' {{{
# modprobe orinoco_nortel
}}} ''or'' {{{
# modprobe orinoco_pci
}}} ''or'' {{{
# modprobe orinoco_plx
}}} ''or'' {{{
# modprobe orinoco_tmd
}}} ''or'' {{{
# modprobe spectrum_cs
}}}
 1. Verify your device has an available interface: {{{
# iwconfig
}}}
 1. Raise the interface to activate the radio, for example: {{{
# ifconfig eth1 up
}}}
 1. [[WiFi/HowToUse|Configure]] your interface as appropriate. See also [[#issues|known issues]].

==== Troubleshooting ====
 * Spectrum24 Trilogy-based devices without flash memory: Examine the kernel ring buffer ([[DebianMan:1/dmesg|dmesg(1)]]) to verify required firmware files are being loaded by the driver. If requested firmware is not available, no wireless interface will be created.
  * Ensure the firmware files produced by the {{{get_symbol_fw}}} script ({{{symbol_sp24t_prim_fw}}}, {{{symbol_sp24t_sec_fw}}}) were moved to {{{/usr/local/lib/firmware}}}.

<<Anchor(squeeze)>>
=== Squeeze ===

==== WPA (Hermes I only) ====
You can [[#squeeze-general|skip this section]] if WPA support is not required, or if your device has a Prism or Spectrum24 Trilogy chipset.

Firmware is required to be installed prior to driver operation.

 1. Add a "non-free" component to {{{/etc/apt/sources.list}}}, for example: {{{
# Debian Squeeze (testing)
deb http://ftp.us.debian.org/debian squeeze main contrib non-free
}}}
 1. Update the list of available packages and install the DebianPkg:firmware-linux-nonfree package: {{{
# aptitude update && aptitude install firmware-linux-nonfree
}}}
 1. Continue with the [[#squeeze-general|procedure below]].

<<Anchor(squeeze-general)>>
==== General ====
 1. Install the DebianPkg:wireless-tools package: {{{
# aptitude install wireless-tools
}}}
 1. For users with Spectrum24 Trilogy-based devices only:

 Firmware is required for devices without flash memory. This can be downloaded and extracted using the {{{get_symbol_fw}}} script available from [[http://prdownloads.sourceforge.net/orinoco/|orinoco-fwutils]]: {{{
$ su
# aptitude install unzip
# exit
$ wget 'http://downloads.sourceforge.net/orinoco/orinoco-fwutils-0.3.tar.gz?download'
$ tar xvf orinoco-fwutils-0.3.tar.gz
$ cd orinoco-fwutils-0.3
$ ./get_symbol_fw
$ su
# mkdir -p /usr/local/lib/firmware
# mv symbol_sp24t_prim_fw symbol_sp24t_sec_fw /usr/local/lib/firmware
}}}
 1. If not already performed, connect the device to your system.

 1. Hermes I and WPA, Spectrum24 Trilogy-based devices without flash memory:
 As the driver may already be loaded, reinsert the relevant module to access installed firmware (depending on your device's host interface): {{{
# modprobe -r airport ; modprobe airport
}}} ''or'' {{{
# modprobe -r orinoco_cs ; modprobe orinoco_cs
}}} ''or'' {{{
# modprobe -r orinoco_nortel ; modprobe orinoco_nortel
}}} ''or'' {{{
# modprobe -r orinoco_pci ; modprobe orinoco_pci
}}} ''or'' {{{
# modprobe -r orinoco_plx ; modprobe orinoco_plx
}}} ''or'' {{{
# modprobe -r orinoco_tmd ; modprobe orinoco_tmd
}}} ''or'' {{{
# modprobe -r spectrum_cs ; modprobe spectrum_cs
}}}
 1. Verify your device has an available interface: {{{
# iwconfig
}}}
 1. Raise the interface to activate the radio, for example: {{{
# ifconfig eth1 up
}}}
 1. [[WiFi/HowToUse|Configure]] your interface as appropriate. See also [[#issues|known issues]].

==== Troubleshooting ====
# mv symbol_sp24t_prim_fw symbol_sp24t_sec_fw /lib/firmware
}}}
 1. Connect the device to your system. The necessary kernel module is [[Modules|automatically loaded]] for supported devices.
 1. [[WiFi/HowToUse|Configure]] your interface as appropriate. See also [[#troubleshooting|troubleshooting]] and [[#issues|known issues]].

<<Anchor(troubleshooting)>>
== Troubleshooting ==
Line 261: Line 91:
  * Ensure the firmware files produced by the {{{get_symbol_fw}}} script ({{{symbol_sp24t_prim_fw}}}, {{{symbol_sp24t_sec_fw}}}) were moved to {{{/usr/local/lib/firmware}}}.   * Ensure the firmware files produced by the {{{get_symbol_fw}}} script ({{{symbol_sp24t_prim_fw}}}, {{{symbol_sp24t_sec_fw}}}) were moved to {{{/lib/firmware}}}.
Line 266: Line 96:
 * Supported with Hermes I-based (Lucent/Agere) devices only (for Prism chipsets, see [[hostap]]).
 * Only WPA-PSK [[WikiPedia:Temporal_Key_Integrity_Protocol|TKIP]] is supported at this time.
  * You may need to prevent wpa_supplicant from initially using WikiPedia:CCMP, for example: {{{
 * Supported with Hermes I-based (Lucent/Agere) devices only.
 * 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 in {{{/etc/network/interfaces}}}: {{{
Line 279: Line 109:
=== WEP ===
<!> This encryption method is deprecated and not recommended for use.
 * For Prism-based devices, secondary/station firmware v1.4.9 or later is required for functional support.<<FootNote([[http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Orinoco.html#issues|MPL/GPL drivers for the Wavelan IEEE/Orinoco and others: Issues and release notes]])>>
Line 284: Line 110:
For Hermes I-based devices, Lucent/Agere firmware versions 7.xx and 8.xx are buggy with respect to monitor mode operation. The Orinoco driver will refuse to change to monitor mode if requested (e.g. via [[DebianMan:8/iwconfig|iwconfig(8)]]). Firmware versions <= 6.16 are required for this feature (see [[#notes|Other Notes]] regarding firmware flashing). For Hermes I-based devices, Lucent/Agere firmware versions 7.xx and 8.xx are buggy with respect to monitor mode operation; the Orinoco driver will refuse to change to monitor mode if requested. Firmware versions <= 6.16 are required for this feature, see [[#notes|Other Notes]] regarding firmware flashing.
Line 292: Line 118:
The station firmware on Hermes I-based devices can only be permanently upgraded/downgraded (flashed) through utilities available for the Microsoft Windows operating system. Some Agere firmware revisions are [[http://ftp.lucky.net/pub/radio/software/ORINOCO/PC_Card/Firmware/|available here]]. With respect to the !AirPort Card, its firmware can be indirectly flashed during installation of some Mac OS X operating system versions. The station firmware on Hermes I-based devices can only be permanently upgraded/downgraded (flashed) through utilities available for the Microsoft Windows operating system. With respect to the !AirPort card, its firmware can be indirectly flashed during installation of some Mac OS X operating system versions.
Line 301: Line 127:
The [[WikiPedia:AirPort#AirPort_802.11b_Card|AirPort Card]] (not !AirPort Extreme) is supported. This is an optional networking accessory for the following Apple systems: The [[WikiPedia:AirPort#AirPort_802.11b_card|AirPort card]] (not !AirPort Extreme) is supported. This is an optional networking accessory for the following Apple systems:
Line 305: Line 131:
 * Other compatible systems (e.g. slot-loading iMacs with an !AirPort Card adapter)  * Other compatible systems (e.g. slot-loading iMacs with an !AirPort card adapter)
Line 311: Line 137:
 * [[http://wireless.kernel.org/en/users/Drivers/orinoco/devices?dbw.orinoco.submit=filter&dbw.orinoco.filter0=%5Ball%5D&dbw.orinoco.filter2=orinoco_cs&dbw.orinoco.filter3=%5Ball%5D|Supported Devices]]  * [[https://wireless.wiki.kernel.org/en/users/Drivers/orinoco/devices|Supported Devices]]
Line 317: Line 143:
The following list is based on the ''alias'' fields of {{{ orinoco_nortel}}} on Lenny. The following list is based on the ''alias'' fields of {{{orinoco_nortel}}} in Debian 3.16 (3.16.7-ckt9-3~deb8u1) kernel images.
Line 319: Line 145:
##TAG:LIST_1_START
Line 323: Line 150:

 * [[http://wireless.kernel.org/en/users/Drivers/orinoco/devices?dbw.orinoco.submit=filter&dbw.orinoco.filter0=%5Ball%5D&dbw.orinoco.filter2=orinoco_nortel&dbw.orinoco.filter3=%5Ball%5D&dbw.orinoco.filter4=%5Ball%5D|Supported Devices]]

<<Anchor(supported-orinoco-pci)>>
=== orinoco_pci ===
The page [[HowToIdentifyADevice/PCI]] explains how to identify a PCI device.

The following list is based on the ''alias'' fields of {{{orinoco_pci}}} on Lenny.
## list generated with: http://www.klabs.be/~fpiat/linux/hardware/modinfo-devnames/
 ~- {{{
PCI: 1260:3872 Intersil Corporation Prism 2.5 Wavelan chipset
PCI: 1260:3873 Intersil Corporation Prism 2.5 Wavelan chipset
PCI: 167D:A000 Samsung Electro-Mechanics Co., Ltd. IPW2200 miniPCI Wireless
}}} -~

 * [[http://wireless.kernel.org/en/users/Drivers/orinoco/devices?dbw.orinoco.submit=filter&dbw.orinoco.filter0=%5Ball%5D&dbw.orinoco.filter2=orinoco_pci&dbw.orinoco.filter3=%5Ball%5D&dbw.orinoco.filter4=%5Ball%5D|Supported Devices]]
##TAG:LIST_1_END

 * [[https://wireless.wiki.kernel.org/en/users/Drivers/orinoco/devices|Supported Devices]]
Line 344: Line 158:
The following list is based on the ''alias'' fields of {{{orinoco_plx}}} on Lenny. The following list is based on the ''alias'' fields of {{{orinoco_plx}}} in Debian 3.16 (3.16.7-ckt9-3~deb8u1) kernel images.
Line 346: Line 160:
##TAG:LIST_2_START
Line 347: Line 162:
PCI: 10B7:7770 3Com Corporation 3CRWE777 PCI(PLX) Wireless Adaptor [Airconnect] PCI: 10B7:7770 3Com Corporation 3CRWE777 PCI Wireless Adapter [Airconnect]
Line 358: Line 173:

 * [[http://wireless.kernel.org/en/users/Drivers/orinoco/devices?dbw.orinoco.submit=filter&dbw.orinoco.filter0=%5Ball%5D&dbw.orinoco.filter2=orinoco_plx&dbw.orinoco.filter3=%5Ball%5D&dbw.orinoco.filter4=%5Ball%5D|Supported Devices]]
##TAG:LIST_2_END

 * [[https://wireless.wiki.kernel.org/en/users/Drivers/orinoco/devices|Supported Devices]]
Line 365: Line 181:
The following list is based on the ''alias'' fields of {{{orinoco_tmd}}} on Lenny. The following list is based on the ''alias'' fields of {{{orinoco_tmd}}} in Debian 3.16 (3.16.7-ckt9-3~deb8u1) kernel images.
Line 367: Line 183:
##TAG:LIST_3_START
Line 370: Line 187:

 * [[http://wireless.kernel.org/en/users/Drivers/orinoco/devices?dbw.orinoco.submit=filter&dbw.orinoco.filter0=%5Ball%5D&dbw.orinoco.filter2=orinoco_tmd&dbw.orinoco.filter3=%5Ball%5D&dbw.orinoco.filter4=%5Ball%5D|Supported Devices]]
##TAG:LIST_3_END

 * [[https://wireless.wiki.kernel.org/en/users/Drivers/orinoco/devices|Supported Devices]]
Line 377: Line 195:
 * [[http://wireless.kernel.org/en/users/Drivers/orinoco/devices?dbw.orinoco.submit=filter&dbw.orinoco.filter0=%5Ball%5D&dbw.orinoco.filter2=spectrum_cs&dbw.orinoco.filter3=%5Ball%5D|Supported Devices]]

<<Anchor(unsupported)>>
=== Unsupported ===

All ORiNOCO-branded USB devices, including:
 ~- {{{
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 (Vendor name unknown) (Device name unknown)
}}} -~

The above devices are supported by a [[orinoco_usb|USB-specific fork]] of the Orinoco driver.
 * [[http://wireless.kernel.org/en/users/Drivers/orinoco/devices|Supported Devices]]
Line 409: Line 198:
 * [[hostap]] - An alternate driver for Prism 2/2.5/3 chipsets (no USB support)
 * [[linux-wlan-ng]] - An alternate driver for Prism 2/2.5/3 chipsets (USB devices supported)
 * [[orinoco_usb]] - Help page for the USB-specific Orinoco driver
 * [[hostap]] - Driver for Prism 2/2.5/3 chipsets (no USB support)
 * [[linux-wlan-ng]] - Driver for Prism 2/2.5/3 USB chipsets
 * [[orinoco_usb]] - Early model ORiNOCO USB 802.11b devices
Line 416: Line 205:
 * http://wireless.kernel.org/en/users/Drivers/orinoco - Driver page on Linux Wireless  * https://wireless.wiki.kernel.org/en/users/Drivers/orinoco - Driver page on Linux Wireless

Translation(s): Français


Hermes I and Spectrum24 Trilogy devices (orinoco)

This page describes how to enable support for WiFi devices based on the Hermes I (Lucent/Agere) and Spectrum24 Trilogy (Symbol) chipsets; using the Orinoco driver on Debian systems.

This page is about the Orinoco driver. See Wikipedia for information about the ORiNOCO brand.

Driver

The Orinoco driver is a collection of modules providing support for various 802.11b devices, based on the Hermes I and Spectrum24 Trilogy chipsets:

  • airport (supported devices)

  • orinoco_cs (supported devices)

    • Supports Hermes I (Lucent/Agere) PCMCIA/PC Card devices.
  • orinoco_nortel (supported devices)

    • Supports Hermes I (Lucent/Agere) PC Card devices using the Nortel PCI bridge.
  • orinoco_plx (supported devices)

    • Supports Hermes I (Lucent/Agere) PC Card devices using the PLX9052 PCI bridge.
  • orinoco_tmd (supported devices)

    • Supports Hermes I (Lucent/Agere) PC Card devices using the TMD7160 PCI bridge.
  • orinoco_usb (supported devices)

    • Supports Hermes I (Lucent/Agere) based USB devices.
    • Introduced in Linux 2.6.35.
  • spectrum_cs (supported devices)

    • Supports Symbol Spectrum24 Trilogy-based PC Card and Compact Flash devices.
    • Introduced in Linux 2.6.14.

Previous support for Prism 2/2.5/3 chipsets (orinoco_pci module) is disabled by default since Linux 2.6.351, see hostap for device support. For support of Prism-based USB 802.11b devices, see linux-wlan-ng.

As of Linux 2.6.28, downloading of firmware to volatile memory (RAM) and WPA support is available for Hermes I-based devices. For WPA support, firmware version 9.42 (or later) is required. The Orinoco driver will attempt to download firmware from userspace during device initialization.

Firmware is required to be provided for Spectrum24 Trilogy-based devices without flash memory (e.g. Intel WPC2011BWW, Socket Communications WL6000-320).

Installation

The Orinoco driver was introduced in Linux 2.4.3 and consists of modules in Debian Linux kernel images.

WPA (Hermes I only)

You can skip this section if WPA support is not required, or if your device has a Spectrum24 Trilogy chipset.

Firmware version 9.42 or later is required for WPA support:

  1. Add a "non-free" component to /etc/apt/sources.list, for example:

    # Debian 8 "Jessie"
    deb http://http.debian.net/debian/ jessie main contrib non-free
  2. Update the list of available packages and install the firmware-linux-nonfree package:

    # apt-get update && apt-get install firmware-linux-nonfree
  3. Continue with the procedure below.

General

  1. For users with Spectrum24 Trilogy-based devices only: firmware is required for devices without flash memory. This can be downloaded and extracted using the get_symbol_fw script available from orinoco-fwutils:

    $ su
    # apt-get install unzip
    # exit
    $ wget 'http://downloads.sourceforge.net/orinoco/orinoco-fwutils-0.3.tar.gz?download'
    $ tar xvf orinoco-fwutils-0.3.tar.gz
    $ cd orinoco-fwutils-0.3
    $ ./get_symbol_fw
    $ su
    # mv symbol_sp24t_prim_fw symbol_sp24t_sec_fw /lib/firmware
  2. Connect the device to your system. The necessary kernel module is automatically loaded for supported devices.

  3. Configure your interface as appropriate. See also troubleshooting and known issues.

Troubleshooting

  • For WPA support on Hermes I-based devices, firmware version 9.42 or later is required to be downloaded to the card.

    • Ensure the Lucent/Agere station firmware (agere_sta_fw.bin) is available when requested, check the kernel ring buffer (dmesg(1)).

    • Ensure the firmware-linux-nonfree package is installed.

    • WPA capability can be verified by the presence of "WPA-PSK supported" in the buffer:

      [ 2598.821904] eth1: Program end returned 0
      [ 2598.821913] eth1: hermes_present returned 1
      [ 2598.822731] eth1: Hardware identity 0001:0002:0003:0004
      [ 2598.822854] eth1: Station identity  0005:0006:0007:0008
      [ 2598.822868] eth1: Firmware determined as Lucent/Agere 9.48
      [ 2598.822877] eth1: Ad-hoc demo mode supported
      [ 2598.822885] eth1: IEEE standard IBSS ad-hoc mode supported
      [ 2598.822892] eth1: WEP supported, 104-bit key
      [ 2598.822901] eth1: WPA-PSK supported
      [ 2599.051164] eth1: MAC address 00:11:22:33:44:55
      [ 2599.051265] eth1: Station name "HERMES I"
      [ 2599.051828] eth1: ready

    • See also known issues.

  • Spectrum24 Trilogy-based devices without flash memory: Examine the kernel ring buffer (dmesg(1)) to verify required firmware files are being loaded by the driver. If requested firmware is not available, no wireless interface will be created.

    • Ensure the firmware files produced by the get_symbol_fw script (symbol_sp24t_prim_fw, symbol_sp24t_sec_fw) were moved to /lib/firmware.

Known Issues

WPA

  • Supported with Hermes I-based (Lucent/Agere) devices only.
  • Only WPA-PSK TKIP is supported.

    • You may need to prevent wpa_supplicant from initially using CCMP, for example in /etc/network/interfaces:

      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

Monitor Mode

For Hermes I-based devices, Lucent/Agere firmware versions 7.xx and 8.xx are buggy with respect to monitor mode operation; the Orinoco driver will refuse to change to monitor mode if requested. Firmware versions <= 6.16 are required for this feature, see Other Notes regarding firmware flashing.

Monitor mode operation can be forced on buggy firmware versions by supplying force_monitor=1 as an option to the orinoco module:

echo options orinoco force_monitor=1 >> /etc/modprobe.d/local.conf

Other Notes

The station firmware on Hermes I-based devices can only be permanently upgraded/downgraded (flashed) through utilities available for the Microsoft Windows operating system. With respect to the AirPort card, its firmware can be indirectly flashed during installation of some Mac OS X operating system versions.

Installation of the hostap-utils package will blacklist the Orinoco driver modules. This package should be purged from your system if not required.

Supported Devices

airport

The AirPort card (not AirPort Extreme) is supported. This is an optional networking accessory for the following Apple systems:

  • iBook G3 ("Clamshell", "Dual USB / Snow")

  • PowerBook G3 ("Firewire")

  • Early-model PowerBook G4 ("Titanium")

  • Other compatible systems (e.g. slot-loading iMacs with an AirPort card adapter)

orinoco_cs

The page HowToIdentifyADevice/PC_Card explains how to identify a PC Card device.

orinoco_nortel

The page HowToIdentifyADevice/PCI explains how to identify a PCI device.

The following list is based on the alias fields of orinoco_nortel in Debian 3.16 (3.16.7-ckt9-3~deb8u1) kernel images.

  • PCI: 126C:8030 Northern Telecom (Device name unknown)
    PCI: 1562:0001 Symbol Technologies (Device name unknown)

orinoco_plx

The page HowToIdentifyADevice/PCI explains how to identify a PCI device.

The following list is based on the alias fields of orinoco_plx in Debian 3.16 (3.16.7-ckt9-3~deb8u1) kernel images.

  • PCI: 10B7:7770 3Com Corporation 3CRWE777 PCI Wireless Adapter [Airconnect]
    PCI: 111A:1023 Efficient Networks, Inc (Device name unknown)
    PCI: 1385:4100 Netgear MA301 802.11b Wireless PCI Adapter
    PCI: 15E8:0130 National Datacomm Corp Wireless PCI Card
    PCI: 1638:1100 Standard Microsystems Corp [SMC] SMC2602W EZConnect / Addtron AWA-100 / Eumitcom PCI WL11000
    PCI: 16AB:1100 Global Sun Technology Inc GL24110P
    PCI: 16AB:1101 Global Sun Technology Inc PLX9052 PCMCIA-to-PCI Wireless LAN
    PCI: 16AB:1102 Global Sun Technology Inc PCMCIA-to-PCI Wireless Network Bridge
    PCI: 16EC:3685 U.S. Robotics Wireless Access PCI Adapter Model 022415
    PCI: EC80:EC00 Belkin Corporation F5D6000

orinoco_tmd

The page HowToIdentifyADevice/PCI explains how to identify a PCI device.

The following list is based on the alias fields of orinoco_tmd in Debian 3.16 (3.16.7-ckt9-3~deb8u1) kernel images.

  • PCI: 15E8:0131 National Datacomm Corp NCP130A2 Wireless NIC

spectrum_cs

The page HowToIdentifyADevice/PC_Card explains how to identify a PC Card device.

See Also


CategoryHardware | CategoryWireless