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