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

支持

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

版权所有 © 2003-2006，英特尔公司

README.ipw2100

版本:

git-1.1.5

日期:

2006 年 1 月 25 日

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

所有用户或分销商的重要提示!!!!

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

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

注意：许多监管机构认为无线 LAN 适配器是模块，因此，系统级法规批准取决于收到并审查测试数据，证明天线和系统配置不会导致 EMC 和无线电操作不符合规定。

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

https://www.intel.com/support/wireless/sb/CS-006408.htm

1. 简介

本文档简要概述了 IPW2100 驱动程序项目支持的功能。该项目的主要网站（可以在其中找到该驱动程序的最新开发版本）是：

您可以在那里找到不仅最新的版本，还可以找到有关潜在修复和补丁的信息，以及指向驱动程序项目开发邮件列表的链接。

2. 版本 git-1.1.5 当前支持的功能

  • 托管 (BSS) 和 Ad-Hoc (IBSS)

  • WEP（共享密钥和开放）

  • 无线工具支持

  • 802.1x（使用 XSupplicant 1.0.1 测试）

已启用（但不支持）的功能：- 监控/RFMon 模式 - WPA/WPA2

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

3. 命令行参数

如果该驱动程序构建为模块，则可以使用 modprobe 命令使用以下语法在命令行中输入以下可选参数：

modprobe ipw2100 [<option>=<VAL1><,VAL2>...]

例如，要在驱动程序加载时禁用无线电，请输入：

modprobe ipw2100 disable=1

ipw2100 驱动程序支持以下模块参数：

名称

值

示例

含义

debug

0x0-0xffffffff

debug=1024

调试级别设置为 1024

mode

0,1,2

mode=1

AdHoc

channel

int

channel=3

仅在 AdHoc 或 Monitor 中有效

associate

boolean

associate=0

不自动关联

disable

boolean

disable=1

不给硬件供电

4. Sysfs 助手文件

有几种方法可以控制驱动程序的行为。许多通用功能通过无线工具 (iwconfig) 公开。有一些功能通过 Linux Sysfs 中的条目公开。

驱动程序级别

对于驱动程序级别的文件，请查看 /sys/bus/pci/drivers/ipw2100/。

debug_level

这控制与“debug”模块参数相同的全局设置。有关可用的各种调试级别的信息，请运行驱动程序源目录中的“dvals”脚本。

注意

仅当启用 CONFIG_IPW2100_DEBUG 时，才启用“debug_level”。

设备级别

对于设备级别的文件，请查看：

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

例如

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

对于设备级别的文件，请参见 /sys/bus/pci/drivers/ipw2100

rf_kill

读取

0

未启用 RF 关闭（无线电开启）

1

基于软件的 RF 关闭处于活动状态（无线电关闭）

2

基于硬件的 RF 关闭处于活动状态（无线电关闭）

3

基于硬件和软件的 RF 关闭都处于活动状态（无线电关闭）

写入

0

如果基于软件的 RF 关闭处于活动状态，则重新打开无线电

1

如果无线电开启，则激活基于软件的 RF 关闭

注意

如果您启用基于软件的 RF 关闭，然后将基于硬件的 RF 关闭从 ON -> OFF -> ON 切换，则无线电将不会重新打开。

5. 无线电关闭开关

大多数笔记本电脑都允许用户物理禁用无线电。一些供应商已将其实现为物理开关，无需软件即可打开和关闭无线电。但是，在其他笔记本电脑上，该开关通过按下按钮进行控制，然后软件驱动程序会调用以打开和关闭无线电。这称为“基于软件的 RF 关闭开关”。

请参阅 Sysfs 助手文件“rf_kill”，以确定您系统上 RF 开关的状态。

6. 动态固件

由于固件是在限制使用许可下授权的，因此不能包含在内核源代码中。要启用 IPW2100，您需要一个固件映像才能加载到无线网卡的处理器中。

您可以从 <http://ipw2100.sf.net/firmware.php> 获取这些映像。

有关安装固件的说明，请参见 INSTALL。

7. 电源管理

IPW2100 通过私有无线扩展接口支持电源节省协议的配置。IPW2100 支持以下不同的模式：

off

无电源管理。无线电始终开启。

on

自动电源管理

1-5

不同级别的电源管理。数字越大，功率节省越大，但会影响数据包延迟。

电源管理的工作原理是在经过一定时间（没有数据包通过无线电）后关闭无线电。关闭电源后，无线电在该状态下保持一段时间。为了获得更高的功率节省，从上次数据包处理到休眠的时间间隔较短，而休眠时间较长。

当无线电处于休眠状态时，向该站发送数据的接入点必须在 AP 处缓冲数据包，直到该站唤醒并请求任何缓冲的数据包。如果您的 AP 不正确支持 PSP 协议，则在启用电源管理时，您可能会遇到数据包丢失或性能非常差。如果是这种情况，您将需要尝试为您的 AP 查找固件更新，或禁用电源管理（通过 iwconfig eth1 power off）

要在 IPW2100 上配置功率级别，您需要结合使用 iwconfig 和 iwpriv。iwconfig 用于打开、关闭电源管理，并将其设置为自动。

iwconfig eth1 power off

禁用无线电电源关闭

iwconfig eth1 power on

启用无线电电源管理到上次设置的级别（默认为 AUTO）

iwpriv eth1 set_power 0

将功率级别设置为 AUTO，如果以前未启用，则启用电源管理。

iwpriv eth1 set_power 1-5

将功率级别设置为指定值，如果以前未启用，则启用电源管理。

您可以通过以下方式查看当前功率级别设置：

iwpriv eth1 get_power

它将返回当前配置的周期或超时，其形式为 xxxx/yyyy (z) 的字符串，其中 xxxx 是超时间隔（数据包处理后的时间量），yyyy 是休眠时间（在打开无线电并查询接入点以获取缓冲数据包之前等待的时间量），而 z 是“功率级别”。如果电源管理关闭，则 xxxx/yyyy 将替换为“off”——如果调用 iwconfig eth1 power on，则报告的级别将是活动级别。

8. 支持

有关通用开发信息和支持，请访问

ipw2100 1.1.0 驱动程序和固件可以从以下网址下载

如需在 Linux 内核 2.6.8 或更高版本上安装 ipw2100 1.1.0 驱动程序的支持，请发送电子邮件至以下网址获得支持

9. 许可证

版权所有 © 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>

英特尔公司，5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497