[:DebianWiki/EditorGuide#translation:Translation(s)]: none

(!) [:/Discussion:Discussion]


Hermes, Prism 2/2.5/3, Spectrum24 Trilogy devices (orinoco)

This page describes how to enable support for WiFi devices based on the Hermes (Lucent/Agere), Prism 2/2.5/3 (Conexant, formerly Intersil) and Spectrum24 Trilogy (Symbol) chipsets; using the Orinoco driver on Debian systems.

?TableOfContents(3)

This page is about the Orinoco driver. See Wikipedia for information about the [wiki:ORiNOCO ORiNOCO brand].

Driver

The [http://orinoco.nongnu.org/ Orinoco driver] is a collection of modules providing support for various 802.11b devices, based on the Hermes, Prism 2/2.5/3 or Spectrum24 Trilogy chipsets:

<!> USB devices are [#unsupported not supported].

While Prism 2/2.5/3 chipsets are supported by this driver, 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-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 (eg. Intel WPC2011BWW, Socket Communications WL6000-320).

Installation

The Orinoco driver is included in the mainline Linux kernel since 2.4.3. It is included as modules in Debian kernel images.

Etch

Using [:DebianLenny:Lenny]? [#lenny Skip to the Lenny section].

  1. Install the wireless-tools package:

    aptitude update
    aptitude install wireless-tools
  2. 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
    # mv symbol_sp24t_prim_fw symbol_sp24t_sec_fw /lib/firmware
  3. If not already performed, connect the device to your system.
  4. 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
  5. Verify your device has an available interface:

    iwconfig
  6. Raise the interface to activate the radio, for example:

    ifconfig eth1 up
  7. [:WiFi/HowToUse:Configure] your interface as appropriate. See also [#issues known issues].

Troubleshooting

?Anchor(lenny)

Lenny

WPA (Hermes/Agere 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, a 2.6.28 (or later) kernel is required. Firmware is also required to be installed prior to driver operation.

  1. Install the git-core package:

    aptitude update
    aptitude install git-core
  2. Acquire Agere v9.48 firmware from the [http://git.kernel.org/?p=linux/kernel/git/dwmw2/linux-firmware.git;a=summary linux-firmware] GIT tree:

    git clone git://git.kernel.org/pub/scm/linux/kernel/git/dwmw2/linux-firmware.git

    Alternatively, the same firmware can be obtained by downloading the attachment of [http://marc.info/?l=orinoco-devel&m=121078835610877 this orinoco-devel message], extracting its contents and renaming the file to agere_sta_fw.bin.

  3. Install the firmware:

    cp linux-firmware/agere_sta_fw.bin /lib/firmware
  4. Add the [:DebianKernel#snapshots:Debian Kernel Snapshots] repository to /etc/apt/sources.list:

    # Debian Kernel Snapshots (experimental!)
    deb http://kernel-archive.buildserver.net/debian-kernel trunk main
  5. Add the Debian Kernel Snapshots repository key:

    wget -q -O - http://kernel-archive.buildserver.net/key | apt-key add -
  6. Install a 2.6.28 (or later) kernel image appropriate for your system. For example:

    aptitude update
    aptitude install linux-image-2.6.28-1-686
  7. Restart your system to boot with this kernel, then continue with the [#lenny_general procedure below].

?Anchor(lenny_general)

General

  1. Install the wireless-tools package:

    aptitude update
    aptitude install wireless-tools
  2. 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
    # mv symbol_sp24t_prim_fw symbol_sp24t_sec_fw /lib/firmware
  3. If not already performed, connect the device to your system.
  4. 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
  5. Verify your device has an available interface:

    iwconfig
  6. Raise the interface to activate the radio, for example:

    ifconfig eth1 up
  7. [:WiFi/HowToUse:Configure] your interface as appropriate. See also [#issues known issues].

Troubleshooting

?Anchor(issues)

Known Issues

WPA

WEP

<!> This encryption method is deprecated and not recommended for use.

Monitor Mode

For Hermes-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 (eg. via [http://manpages.debian.net/man/8/iwconfig iwconfig]). Firmware versions <= 6.16 are required for this feature (see [#notes 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 orinoco force_monitor=1 >> /etc/modprobe.d/local

?Anchor(notes)

Other Notes

The station firmware on Hermes/Agere-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.

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

Supported Devices

?Anchor(supported_airport)

airport

The [wiki:AirPort.11b_Card ?AirPort Card] (not AirPort Extreme) is supported. This is an optional networking accessory for the following Apple systems:

?Anchor(supported_orinoco_cs)

orinoco_cs

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

?Anchor(supported_orinoco_nortel)

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.

?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.

?Anchor(supported_orinoco_plx)

orinoco_plx

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

The following list is based on the alias fields of  orinoco_plxl.

?Anchor(supported_orinoco_tmd)

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.

?Anchor(supported_spectrum_cs)

spectrum_cs

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

?Anchor(unsupported)

Unsupported

All ORiNOCO-branded USB devices, including:

The above devices are supported by a [:orinoco_usb:USB-specific fork] of the Orinoco driver.

See Also


CategoryHardware | CategoryWireless