适用于 Linux 的 Intel(R) PRO/Wireless 2915ABG 驱动程序

支持

  • Intel(R) PRO/Wireless 2200BG 网络连接

  • Intel(R) PRO/Wireless 2915ABG 网络连接

注意:适用于 Linux 的 Intel(R) PRO/Wireless 2915ABG 驱动程序和适用于 Linux 的 Intel(R) PRO/Wireless 2200BG 驱动程序是一个统一的驱动程序,适用于上面列出的两种硬件适配器。在本文档中,适用于 Linux 的 Intel(R) PRO/Wireless 2915ABG 驱动程序将用于引用统一的驱动程序。

版权所有 © 2004-2006,英特尔公司

README.ipw2200

版本:

1.1.2

日期:

2006 年 3 月 30 日

0. 使用此驱动程序之前的重要信息

所有用户或分销商的重要通知!!!!

英特尔无线 LAN 适配器经过工程设计、制造、测试和质量检查,以确保它们满足所有必要的当地和政府监管机构对其指定和/或标记要运入的地区的要求。由于无线 LAN 通常是与雷达、卫星和其他许可和未许可设备共享频谱的未许可设备,因此有时需要动态检测、避免和限制使用,以避免干扰这些设备。在许多情况下,英特尔需要提供测试数据,以证明在获得产品认证或批准使用之前,符合地区和政府法规的地区和地方合规性。英特尔的无线 LAN 的 EEPROM、固件和软件驱动程序旨在仔细控制影响无线电操作的参数,并确保电磁兼容性 (EMC)。这些参数包括但不限于射频功率、频谱使用、信道扫描和人体暴露。

出于这些原因,英特尔不允许任何第三方操纵以二进制格式与无线 WLAN 适配器提供的软件(例如,EEPROM 和固件)。此外,如果您将任何补丁、实用程序或代码与未经授权的第三方(即,未经英特尔验证的补丁、实用程序或代码(包括开源代码修改))操纵的英特尔无线 LAN 适配器一起使用,(i) 您将独自负责确保产品的法规合规性,(ii) 英特尔对修改后的产品相关的任何问题不承担任何责任,无论是基于任何责任理论,包括但不限于保修下的索赔和/或因不符合法规而引起的问题,以及 (iii) 英特尔不会提供或被要求协助向任何第三方提供对此类修改产品的支持。

注意:许多监管机构认为无线 LAN 适配器是模块,因此,系统级监管批准的条件是收到并审查测试数据,证明天线和系统配置不会导致 EMC 和无线电操作不合规。

从 SourceForge 下载的驱动程序作为开发项目的一部分提供。符合当地法规要求是个别开发人员的责任。因此,如果您有兴趣部署或发布驱动程序作为旨在用于开发以外用途的解决方案的一部分,请从英特尔客户支持部门获取经过测试的驱动程序,网址为

http://support.intel.com

1. 简介

以下部分尝试简要介绍如何使用适用于 Linux 的 Intel(R) PRO/Wireless 2915ABG 驱动程序。

本文档并非旨在成为理解或使用无线技术的综合手册,但应足以让您在 Linux 上无线移动。

有关构建和安装驱动程序的信息,请参阅 INSTALL 文件。

1.1. 功能概述

当前版本 (1.1.2) 支持以下功能

  • BSS 模式(基础设施、托管)

  • IBSS 模式(自组织)

  • WEP(开放和共享密钥模式)

  • 通过 wpa_supplicant 和 xsupplicant 的 802.1x EAP

  • 无线扩展支持

  • 完全 B 和 G 速率支持(2200 和 2915)

  • 完全 A 速率支持(仅限 2915)

  • 发射功率控制

  • S 状态支持(ACPI 挂起/恢复)

以下功能当前已启用,但未正式支持

  • WPA

  • 长/短前导码支持

  • 监视器模式(又名 RFMon)

正式支持和启用之间的区别反映了对给定功能执行的验证和互操作性测试的数量。

1.2. 命令行参数

与 Linux 内核中使用的许多模块一样,适用于 Linux 的 Intel(R) PRO/Wireless 2915ABG 驱动程序允许将配置选项作为模块参数提供。指定模块参数的最常见方法是通过命令行。

一般形式是

% modprobe ipw2200 parameter=value

其中支持的参数是

associate

设置为 0 以禁用驱动程序的自动扫描和关联功能。如果禁用,驱动程序将不会尝试扫描并关联到网络,直到它已配置了目标网络的一个或多个属性,例如配置网络 SSID。默认为 0(不自动关联)

示例:% modprobe ipw2200 associate=0

auto_create

设置为 0 以禁用自动创建与提供的信道和网络名称参数匹配的 Ad-Hoc 网络。默认为 1。

channel

关联的信道号。设置信道的正常方法是使用标准无线工具(即 iwconfig eth1 channel 10),但有时在调试时设置此参数很有用。信道 0 表示“任何”

debug

如果使用调试版本,则此选项用于控制记录的调试信息量。有关如何使用此选项的更多信息,请参阅“dvals”和“load”脚本(dvals 和 load 脚本作为从 SourceForge 项目(网址为 http://ipw2200.sf.net)获得的 ipw2200 开发快照版本的一部分提供)

led

可用于打开实验性 LED 代码。0 = 关闭,1 = 打开。默认为 1。

mode

可用于设置适配器的默认模式。0 = 托管,1 = 自组织,2 = 监视器

1.3. 无线扩展私有方法

作为旨在处理通用硬件的接口,某些功能未通过正常的无线工具接口公开。因此,提供了一个规定,允许驱动程序声明自定义或私有方法。适用于 Linux 的 Intel(R) PRO/Wireless 2915ABG 驱动程序定义了几个私有方法来配置各种设置。

使用私有无线方法的一般形式是

% iwpriv $IFNAME method parameters

其中 $IFNAME 是设备注册的接口名称(通常为 eth1,通过各种网络接口名称管理器之一进行自定义,例如 ifrename)

支持的私有方法有

get_mode

可用于报告驱动程序配置为支持的 IEEE 模式。示例

% iwpriv eth1 get_mode eth1 get_mode:802.11bg (6)

set_mode

可用于配置驱动程序将支持的 IEEE 模式。

用法

% iwpriv eth1 set_mode {mode}

其中 {mode} 是 1-7 范围内的数字

1

802.11a(仅限 2915)

2

802.11b

3

802.11ab(仅限 2915)

4

802.11g

5

802.11ag(仅限 2915)

6

802.11bg

7

802.11abg(仅限 2915)

get_preamble

可用于报告前导码长度的配置。

set_preamble

可用于设置前导码长度的配置

用法

% iwpriv eth1 set_preamble {mode}

其中 {mode} 是以下之一

1

仅限长前导码

0

自动(根据连接使用长或短)

1.4. Sysfs 帮助程序文件

Linux 内核提供了一个伪文件系统,可用于访问操作系统的各种组件。适用于 Linux 的 Intel(R) PRO/Wireless 2915ABG 驱动程序通过此机制公开了多个配置参数。

sysfs 中的条目可以支持读取和/或写入。您通常可以通过使用 cat 查询 sysfs 条目的内容,并且可以通过 echo 设置内容。例如

% cat /sys/bus/pci/drivers/ipw2200/debug_level

将报告驱动程序日志子系统的当前调试级别(仅当构建驱动程序时配置了 CONFIG_IPW2200_DEBUG 时才可用)。

您可以通过以下方式设置调试级别

% echo $VALUE > /sys/bus/pci/drivers/ipw2200/debug_level

其中 $VALUE 在此 sysfs 条目的情况下将是一个数字。sysfs 文件的输入不必是数字。例如,热插拔使用的固件加载器使用 sysfs 条目将固件映像从用户空间传输到驱动程序。

适用于 Linux 的 Intel(R) PRO/Wireless 2915ABG 驱动程序在两个级别公开 sysfs 条目:驱动程序级别,它适用于驱动程序的所有实例(如果有多个设备安装),以及设备级别,它仅适用于单个特定实例。

1.4.1 驱动程序级别 Sysfs 帮助程序文件

对于驱动程序级别的文件,请在 /sys/bus/pci/drivers/ipw2200/ 中查找

debug_level

这控制着与“debug”模块参数相同的全局设置

1.4.2 设备级别 Sysfs 帮助程序文件

对于设备级别的文件,请在

/sys/bus/pci/drivers/ipw2200/{PCI-ID}/

中查找例如:

/sys/bus/pci/drivers/ipw2200/0000:02:01.0

有关设备级文件,请参阅 /sys/bus/pci/drivers/ipw2200

rf_kill

读取 -

0

RF 禁用未启用(无线电开启)

1

基于软件的 RF 禁用已激活(无线电关闭)

2

基于硬件的 RF 禁用已激活(无线电关闭)

3

硬件和软件 RF 禁用均已激活(无线电关闭)

写入 -

0

如果基于软件的 RF 禁用已激活,则重新打开无线电

1

如果无线电已开启,则激活基于软件的 RF 禁用

注意

如果您启用了基于软件的 RF 禁用,然后将基于硬件的 RF 禁用从开启 -> 关闭 -> 开启 切换,则无线电不会重新开启

ucode

只读访问 ucode 版本号

led

读取 -

0

LED 代码已禁用

1

LED 代码已启用

写入 -

0

禁用 LED 代码

1

启用 LED 代码

注意

据报告,当运行 ifconfig 时,LED 代码会导致某些系统挂起,因此默认情况下禁用该代码。

1.5. 支持的频道

加载 Linux 的 Intel(R) PRO/Wireless 2915ABG 驱动程序后,日志中将显示一条消息,说明检测到的地理代码和该卡支持的 802.11 通道数。

地理代码对应于下表中所示的法规域。

代码

地理位置

支持的频道

802.11bg

802.11a

---

受限

11

0

ZZF

自定义美国/加拿大

11

8

ZZD

世界其他地区

13

0

ZZA

自定义美国和欧洲及高频

11

13

ZZB

自定义北美和欧洲

11

13

ZZC

自定义日本

11

4

ZZM

自定义

11

0

ZZE

欧洲

13

19

ZZJ

自定义日本

14

4

ZZR

世界其他地区

14

0

ZZH

高频段

13

4

ZZG

自定义欧洲

13

4

ZZK

欧洲

13

24

ZZL

欧洲

11

13

2. Ad-Hoc 网络

当在 Ad-Hoc 网络中使用设备时,了解驱动程序创建、加入或合并网络的顺序和要求非常有用。

以下内容试图提供足够的信息,以便您在将驱动程序用作 Ad-Hoc 网络的成员时获得一致的体验。

2.1. 加入 Ad-Hoc 网络

加入 Ad-Hoc 网络的最简单方法是加入一个已存在的网络。

2.2. 创建 Ad-Hoc 网络

Ad-Hoc 网络是使用无线工具的语法创建的。

例如:iwconfig eth1 mode ad-hoc essid testing channel 2

2.3. 合并 Ad-Hoc 网络

3. 与无线工具的交互

3.1 iwconfig 模式

当配置适配器的模式时,所有运行时配置的参数都将重置为模块加载时使用的值。这包括通道、速率、ESSID 等。

3.2 iwconfig sens

“iwconfig ethX sens XX”命令不会像 iwconfig 文档中所述那样设置信号灵敏度阈值,而是设置将触发切换的连续丢失信标的数量,即漫游到另一个接入点。同时,它会将取消关联阈值设置为给定值的 3 倍。

4. 关于版本号

由于开源开发项目的性质,经常会有尚未经过完整验证过程的更改被纳入。这些更改被纳入开发快照版本中。

版本号采用三级方案

主版本号.次版本号.开发版本

任何“开发版本”部分为 0 的版本(例如 1.0.0、1.1.0 等)都表示一个稳定的版本,该版本将可用于内核包含。

任何“开发版本”部分不为 0 的版本(例如 1.0.1、1.1.5 等)都表示一个开发版本,该版本可用于测试和前沿用户。开发版本的稳定性和功能是未知的。我们努力尝试保持所有快照的合理稳定,但由于它们的发布频率以及希望尽快提供这些版本,因此应该预期会出现未知的异常。

当对驱动程序进行重大更改时,主版本号将递增。目前,没有计划进行重大更改。

5. 固件安装

驱动程序需要固件映像,下载该映像并将文件解压到 /lib/firmware(或 hotplug 的 firmware.agent 将查找固件文件的任何位置)

可以从以下 URL 下载固件

6. 支持

有关 1.0.0 版本的直接支持,您可以联系 http://supportmail.intel.com,或者您可以使用开源项目支持。

有关一般信息和支持,请访问

7. 许可证

版权所有 © 2003 - 2006 英特尔公司。保留所有权利。

本程序是自由软件;您可以根据自由软件基金会发布的 GNU 通用公共许可证版本 2 的条款重新分发和/或修改它。

本程序的发布是希望它有用,但不提供任何保证;甚至不提供关于适销性或针对特定用途的适用性的隐含保证。有关详细信息,请参阅 GNU 通用公共许可证。

您应该已收到本程序附带的 GNU 通用公共许可证的副本;如果没有,请写信给 Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA。

完整的 GNU 通用公共许可证包含在本发行版的名为 LICENSE 的文件中。

联系信息

James P. Ketrenos <ipw2100-admin@linux.intel.com>

Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497