Eric-AirportItlwm
zh-Hant

開放原始碼 · GPL-2.0 · x86_64

Intel 無線網卡的 macOS 原生驅動程式,從 802.11n 到 Wi-Fi 7

macOS Tahoe 26、Sequoia 15 · WPA3 · 6 GHz · 802.11be · BE200 / BE201 以及 itlwm 支援的所有網卡

在 AirportItlwm 的 Wi-Fi 6 基礎上做到了 Wi-Fi 7(BE200、BE201),並持續開發 AirDrop(隔空投送)與即時熱點。原有網卡全部保留,使用 macOS 內建的 Wi-Fi,不需要 HeliPort,也不需要 OCLP 的無線修補。

前往 Releases 下載GitHub 儲存庫Issues

基於 itlwm 與 laobamac/itlwm。請見源流與致謝。

如果覺得好用,歡迎在 GitHub 上點個 ⭐ Star,讓更多使用 Intel 網卡的人看到。

Eric-AirportItlwm
連線速率
2882 Mbit/s
傳送
2.55 Gbit/s
接收
1.84 Gbit/s
實機
320 MHz

BE200 實測:macOS 26,6 GHz,320 MHz,雙串流。數值為連線速率與介面實測。5 GHz HE 160 MHz。睡眠:任意時間長度的睡眠後立即重新連線(測試者回報)。

  • macOS 26 Tahoe
  • macOS 15.2+ Sequoia
  • x86_64
  • GPL-2.0

源流與致謝

本專案的存在完全仰賴他人的原始碼。它保留 itlwm 與 AirportItlwm 的全部內容並在其上增加功能,並非取代。感謝下列所有人。

  1. itlwmzxystd / OpenIntelWireless
  2. laobamac/itlwmTahoe/Sequoia 原生 Apple 無線介面
  3. Eric-AirportItlwm本儲存庫

zxystd / OpenIntelWireless 的 itlwm → laobamac/itlwm(Tahoe/Sequoia 原生 Apple 無線介面)→ 本儲存庫:保留以上全部,並新增 Wi-Fi 7 傳輸層與 MLD 韌體路徑、WPA3 SAE/H2E 與 OWE、6 GHz、320 MHz 和多連結,依 Linux iwlwifi(mld、mvm)與 mac80211 逐條指令實作。

致謝

功能

功能網卡狀態
掃描、連線、漫遊、私人 Wi-Fi 位址全部 可用
WPA2 個人級、WPA2 企業級(PEAP)、WPA2/WPA3 過渡網路全部 可用
WPA3 個人級(SAE、H2E)、增強型開放網路(OWE)全部 可用 BE200 實機
802.11ac(VHT)、160 MHzAC 及以上 可用
802.11ax(HE)AX、BE 可用
6 GHzAX210/AX211/AX411、BE 可用 BE200 實機
802.11be(EHT)、320 MHz、多連結(eMLSR)BE 可用 320 MHz 實機;可加入啟用 MLO 的路由器;連結配對仍屬實驗
睡眠喚醒、韌體出錯自動恢復全部 可用
AirDrop 隔空投送 / AWDLiwn(PAN)、iwm、AX、BE 開發中 請見連續互通
即時熱點(在 Wi-Fi 選單中直接連接 iPhone)全部 開發中

支援的網卡

世代型號PCI 裝置 ID(8086:xxxx)驅動層 / 韌體
Wi-Fi 7BE200, BE202, Killer BE1750 x/w272Biwx, MLD API 92 (86)
Wi-Fi 7BE201, Killer BE1750 i/sA840 7740 4D40iwx, MLD API 92
Wi-Fi 6EAX210, AX211, AX4112725 2726 7A70 7AF0 51F0 51F1 54F0 7F70 2729 7E40iwx, API 68
Wi-Fi 6AX200, AX201, AX16502723 2720 02F0 06F0 34F0 3DF0 4DF0 43F0 A0F0iwx, API 68
Wi-Fi 59260, 9461, 9462, 9560, 8265, 8260, 7265, 7260, 3168, 3165, 3160請見 Info.plistiwm
Wi-Fi 46xxx, 5xxx, 4965, 2200, 2230, 1000, 1030, 100, 105, 130, 135請見 Info.plistiwn

所有網卡的韌體都已內建。BE 系列依硬體版本選擇韌體,先嘗試最高的已適配 API。暫不支援:Wi-Fi 7 的「SC」世代(BE211/BE213,6E70 D240 D340 E340 E440 9327),它需要本專案尚未提供的韌體。

安裝

  1. 在 Releases 下載對應系統的套件:macOS 26 使用 macOS26-Tahoe,macOS 15.2 以上使用 macOS15-Sequoia。日常使用 Release;Debug 保留回報問題所需的診斷日誌。
  2. 放進 EFI/OC/Kexts/,並在 Kernel → Add 中加入,只保留一個 Intel 無線驅動。同一份設定同時開機兩個系統時,Tahoe 版限定 Darwin 25.0.0–25.99.99,Sequoia 版限定 24.2.0–24.99.99。
  3. 不要與 OpenCore Legacy Patcher 的「Modern Wireless」根修補或任何 IO80211 / Skywalk 替換混用:本驅動使用的就是系統內建的無線堆疊。
  4. 保留一份可以開機的 EFI,先用隨身碟測試。

國家碼與可用頻道由周圍的路由器透過網卡自身的法規邏輯決定,與 Linux 相同,不需要設定。

開機參數

參數作用
-itlawdl實驗性的 AirDrop,這一個開關就帶上全部,請見下文,不測試請勿加入
itlwm_he=0關閉 HE/EHT(802.11ax/be),預設開啟

連續互通

開發中

即時熱點

藍牙喚醒 iPhone 熱點、定向掃描與 WPA3 關聯都已能完成;目前 iPhone 在四向交握之後立刻中斷連線,這是正在追查的問題,修正對所有網卡都有效。

AirDrop 隔空投送(AWDL)

awdl0 已經建立,由 macOS 自己的 AWDL 協定堆疊驅動。AirDrop 要求網卡一邊留在你的網路上,一邊在 AWDL 頻道上監聽。除 AX411 之外,所有 Intel 網卡都是單射頻(Wi-Fi 7 的 eMLSR 也是單射頻),由韌體在兩者之間分時:

  • AX 系列(非 MLD 韌體):常駐監聽器,擁有自己的頻道上下文,與 ForbiddenItlwm 在 AX211 上實現雙向 AirDrop 的做法相同。
  • BE 系列(MLD 韌體):同樣的思路改用 MLD 指令集,在主連結旁加一條 P2P 用戶端連結(Linux 允許兩個不同頻道的組合)。正在依韌體自身程式碼梳理它的啟用條件,尚未走通。
  • iwm 網卡(7000、8000 和 9000 系列)在連上 Wi-Fi 後啟動常駐監聽器。新增型號仍待實機驗證。
  • 支援 PAN 和 P2P 的 iwn 網卡(先驗證 6205、6235):連線至頻道 6 的 Wi-Fi,並加上 -itlawdl 啟動。同頻道的 AirDrop 仍待實機驗證。

AirDrop 探索依賴藍牙 LE 廣播與掃描。可從 Eric-BlueToolFixup Releases 單獨下載 Intel BLE 修補。藍牙獨立發版,配套社群測試包內提供兩個 kext。 加入 -itlawdl 時,驅動會先檢查 Apple 的 AWDL 介面表是否與編譯時一致(I/O Registry 中的 AWDLBuildCheck),不一致就只做一般 Wi-Fi,系統更新不會因此造成核心當機。監聽頻道依序選 149、44、6,只使用當地允許發射的頻道(沒有 149 的國家使用 44;被動頻道在聽到附近路由器的信標後才算可用)。149 最快:路由器在 149、iPhone 也在 149 或未連接 Wi-Fi 時,AirDrop 速度最好。

回報問題

用 Debug 套件,重現前執行 Collect-EricWirelessDiagnostics.command,選擇 Wi-Fi、AirDrop/即時熱點或藍牙探索。到 GitHub Issue 寫明網卡、對端裝置及實測結果。含網路中繼資料的 ZIP 請私下傳送。

提交 Issue

編譯

git clone https://github.com/acidanthera/MacKernelSDK.git MacKernelSDK
git -C MacKernelSDK checkout 3f750085caa17ec3a7880f11c11bf4f48cd6a164
python3 scripts/prepare_tahoe_sdk.py
xcodebuild -project itlwm.xcodeproj -scheme AirportItlwm-Tahoe   -configuration Release ARCHS=x86_64 CODE_SIGNING_ALLOWED=NO build
xcodebuild -project itlwm.xcodeproj -scheme AirportItlwm-Sequoia -configuration Release ARCHS=x86_64 CODE_SIGNING_ALLOWED=NO build

Wi-Fi 7 的實作說明、各階段實機狀態與對應的 Linux 程式碼,請見 BE200.md。

授權

GPL-2.0,沿襲 itlwm。Intel 韌體依其自身授權散布,請見 Intel 韌體授權。全文:LICENSE。