Eric-AirportItlwm
zh-Hans

开源 · 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),并在做隔空投送、即时热点。原有网卡全部保留,用的是 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 的路由器;链路配对仍属实验
睡眠唤醒、固件出错自动恢复全部 可用
隔空投送 / 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,先用 U 盘测试。

国家码和可用信道由周围的路由器经网卡自身的法规逻辑确定,与 Linux 相同,不需要设置。

启动参数

参数作用
-itlawdl实验性隔空投送,这一个开关就带上全部,见下文,不测试就别加
itlwm_he=0关闭 HE/EHT(802.11ax/be),默认开启

接续互通

开发中

即时热点

蓝牙唤起 iPhone 热点、定向扫描、WPA3 关联都已能完成;目前 iPhone 在四次握手后立刻断开,这是正在查的问题,修复对所有网卡都有效。

隔空投送(AWDL)

awdl0 已经创建,由 macOS 自己的 AWDL 协议栈驱动。隔空投送要求网卡一边留在你的网络上,一边在 AWDL 信道上监听。除 AX411 外所有 Intel 网卡都是单射频(Wi-Fi 7 的 eMLSR 也是单射频),由固件在两者之间分时:

  • AX 系列(非 MLD 固件):常驻监听器,有自己的信道上下文,与 ForbiddenItlwm 在 AX211 上实现双向隔空的做法相同。
  • BE 系列(MLD 固件):同样的思路换成 MLD 命令集,在主链路旁加一条 P2P 客户端链路(Linux 允许两条不同信道的组合)。正在按固件自身代码梳理它的激活条件,尚未走通。
  • iwm 网卡(7000、8000 和 9000 系列)在连上 Wi-Fi 后启动常驻监听器。新增型号仍待实机验证。
  • 支持 PAN 和 P2P 的 iwn 网卡(先验证 6205、6235):连接信道 6 的 Wi-Fi,并加 -itlawdl 启动。同信道隔空投送待实机验证。

隔空投送发现依赖蓝牙 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 时隔空速度最好。

反馈问题

用 Debug 包,复现前运行 Collect-EricWirelessDiagnostics.command,选择 Wi-Fi、隔空投送/即时热点或蓝牙发现。到 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。