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 模式(Ad-Hoc)

  • 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 = Ad-Hoc,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 文件的输入不必是数字。例如,hotplug 使用的固件加载程序利用 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

read -

0

未启用射频关闭(无线电开启)

1

基于软件的射频关闭激活(无线电关闭)

2

基于硬件的射频关闭激活(无线电关闭)

3

基于硬件和软件的射频关闭都激活(无线电关闭)

write -

0

如果基于软件的射频关闭激活,则重新打开无线电

1

如果无线电已打开,则激活基于软件的射频关闭

注意

如果您启用基于软件的射频关闭,然后将基于硬件的射频关闭从开启切换为关闭,然后再切换为开启,则无线电将不会重新打开

ucode

只读访问 ucode 版本号

led

read -

0

LED 代码已禁用

1

LED 代码已启用

write -

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 mode

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

3.2 iwconfig sens

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

4. 关于版本号

由于开源开发项目的性质,经常会合并一些尚未经过完整验证过程的更改。 这些更改已合并到开发快照版本中。

版本号采用三级方案

major.minor.development

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

任何“development”部分不为 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 通用公共许可证的副本; 如果没有,请写信给自由软件基金会,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