Skip to content

Releases

Test build 2026-11-16 (all Intel cards, Tahoe, Debug)

Choose a tag to compare

@Ersiter Ersiter released this 16 Nov 04:26

Test build for every Intel card (BE200/BE201, AX200/201/210/211, 9260/9560 and others), macOS 26 Tahoe, Debug, source deef570. Not a release: nothing here has been run on hardware yet.

See README.txt inside the zip for install, boot arguments and what to send back.

SHA256 4b6bfec5dfbdf8afa854a18b48b8b2dd912284fbea35874da00cc13bffbd881a

BE RC4 · Fix31 · WPA3 / Wi-Fi 7

Choose a tag to compare

@Ersiter Ersiter released this 10 Nov 12:34
ff82f3e

This is the fourth release candidate of the be200-tahoe branch, continuing the native macOS Wi-Fi path from laobamac/itlwm for the Intel Wi-Fi 7 family: BE200 / BE202 / Killer GL (8086:272B) and BE201 / Killer BZ (8086:A840, 8086:7740, 8086:4D40). RC 4 is the first candidate with Wi-Fi 7 evidence from real hardware: a 320 MHz link rate at 2.5 Gbit/s of measured throughput, and a router with MLO enabled joined.

To the best of our review of public work, this remains the only public driver branch we know of with a macOS WPA3-Personal SAE/H2E implementation for Intel adapters, and with BE200 records on real hardware.

Download

Choose per system and purpose. Release for daily use; Debug keeps the diagnostic logs that connection and scan reports depend on. Every package holds one kext, the collector command and a short note.

System Daily use Diagnostic
macOS 26.x Tahoe · x86_64 Release Debug
macOS 15.2+ Sequoia · x86_64 Release Debug

Build marker 2.4.0_FIX31_20261109; source fixed at ff82f3e.

Current implementation

  • Firmware and the macOS interface
    Built on laobamac's IO80211/WCL integration and the OpenBSD network stack. The driver owns the firmware-side PHY, station, queue, key and RX/TX state and presents one logical Wi-Fi interface to macOS. BE firmware and PNVM are selected from the hardware revision, with an optional GL92 firmware for the BZ family.
  • WPA3-Personal SAE/H2E
    Stefan Sperling's OpenBSD SAE ported and wired in, with BearSSL P-256/i31 arithmetic for the H2E PT/PWE derivation, Commit/Confirm, PMK, the four-way handshake and controlled-port authorization. Default policy is H2E-only; Hunting-and-Pecking survives only in an experimental path that is off by default and is forbidden on 6 GHz. The AP's RSNXE is stored at scan time and checked at the four-way handshake.
  • Keys and enterprise
    Firmware MLD key interface with PMF management keys; 802.1X keeps using the macOS user-space EAP path bridged through EAPOL/PMK. Association, key authorization and the data port are tracked separately, and EAPOL that arrives early is queued until the user-space channel is ready. On multi-link, GTK/IGTK/BIGTK are kept per negotiated link.
  • Wi-Fi 6 and Wi-Fi 7
    802.11a/b/g/n/ac retained; ax and be wired through, including HE capability and bandwidth, EHT capability, 320 MHz and puncturing, Basic MLE, affiliated-AP link discovery by Multi-Link probe, per-link PHY/station/queue/key state and TID-to-link mapping. Multi-link follows Linux iwlmld: the driver decides when to pair two links for eMLSR from traffic, signal, channel load and punctured channels, and tells macOS about the link in use. A BE200 has one radio and uses one link at a time, so the links' rates are not added up. 6 GHz channel table, scan requests and results are band-encoded; the usable channels follow the local regulatory domain and the adapter's own permits.

RC 4 fixes

RC 3 covered Fix30. This list covers everything since, newest first.

  • Empty scans — a scan request with no channel left to scan ends as an empty scan, like mac80211 completes a scan its driver cannot start, instead of restarting the firmware and dropping the join waiting behind it. (39bc04b)
  • Diagnostics — one log line per link after association with band, channel, width in MHz and PHY generation, active-link changes, and the driver's own lines collected for the whole attempt into negotiated-links.txt. (8cbd697, 3b7e9e5, a32195b, e4f81dd)
  • Multi-link link selection — eMLSR is entered by the driver, as in iwlmld, instead of waiting for a firmware recommendation that never comes: it is blocked until traffic reaches 400 MPDUs in a 5 s window, the other links are probed again, links are graded by signal, channel load and punctured channels, and the best pair of any two links is entered when the AP offers eMLSR. It leaves on low signal, low channel load, a firmware request or a failed transition, keeping the better link, and waits 30 s (300/600 s on repeats) before trying again. A choice the firmware refuses is rolled back instead of dropping the association. The signal of each link comes from the firmware's beacon report. (164300e, 22e0efe, 791eee8, 1bd78f5)
  • Link in use — the channel, width, signal, speed, MCS and PHY mode macOS shows follow the link in use, while the BSSID stays the one joined. (e2d255e, 5a7f898, 687b5f4)
  • Multi-link only where its keys exist — only WPA3 (SAE) and Enhanced Open networks join as multi-link, like wpa_supplicant, which drops PSK from the AKMs it uses on a multi-link AP; a WPA2-only network joins on a single link. (71c633c)
  • Joining an MLO router — the MAC context is added without the peer's capabilities and the EML fields follow with the association, as in iwlmld. Previously the firmware asserted before authentication, on the 2.4, 5 and 6 GHz networks of a router with MLO enabled alike. (da57a9b)
  • Link discovery — joining an AP MLD sends a Multi-Link probe for the other links, so they are found even when they were not in the last scan, including after a reconnect; a 6 GHz link that offers only WPA3 is used together with a WPA2/WPA3 link of the same router. (043e6ed, fa2cc77)
  • laobamac/itlwm merged through PR #36 — WPA2/WPA3 transition networks (a network offering SHA256-PSK also accepts ordinary WPA2-PSK), PMF with Cisco 3800 access points, link authorization before RUN, connected-scan timing, receive copy and dead-device polling, 160 MHz channel fallback checks, and no VHT advertised on 2.4 GHz. (dd18def)
  • Transmit A-MSDU — frames are sent without header padding. The padding is what the firmware rejected under sustained load on 5 GHz in Fix30, with the error and reset that followed. (4313da5)

Upstream context: OpenIntelWireless/itlwm#955 covers BE200 support and is the reason this branch exists. laobamac/itlwm#26 (early EAPOL and RUN/authorization ordering) and laobamac/itlwm#36 (WPA2/WPA3 transition networks) are the upstream discussions this branch keeps in sync with; this branch reports link-up only after RUN, queues WCL EAPOL until it is ready, and keeps a genuine SAE/H2E path rather than converting transition networks to WPA2.

On hardware so far: BE200 with WPA2-Personal, WPA2-Enterprise (PEAP), and WPA3-Personal SAE/H2E on both 5 GHz and 6 GHz; 5 GHz HE 160 MHz; 6 GHz EHT at a 2882 Mbit/s link rate (MCS 7, two streams, the rate of a 320 MHz channel), with up to 2.55 Gbit/s transmit and 1.84 Gbit/s receive measured on the interface; a WPA3 router with MLO enabled joined. The system menu still shows a 320 MHz channel as 20 MHz, a limit of the native channel descriptor. Whether the driver pairs two links on that router is not yet confirmed from logs. The 5 GHz reset under load seen in Fix30 was traced to the A-MSDU padding and is fixed in the code path; the reporter has not re-tested it. Sleep/wake is confirmed by testers: after any length of sleep the adapter reconnects immediately.

Sources and credits

  • laobamac/itlwm: the Tahoe/Sequoia native Wi-Fi integration this branch builds on, and its author's development, review and direction.
  • OpenIntelWireless/itlwm, zxystd and the original contributors: the Intel Wi-Fi macOS driver and its porting base.
  • OpenBSD, Stefan Sperling and contributors: net80211, iwn/iwm/iwx, and the SAE implementation whose authorship and copyright this branch preserves.
  • BearSSL, Thomas Pornin: P-256/i31 arithmetic.
  • Linux Intel iwlwifi, Intel and the Linux wireless contributors: GL/BZ firmware interfaces and MLD/key/channel reference, and the eMLSR link selection this branch follows. Intel supplies the firm...
Read more

BE RC3 · Fix30 · WPA3 / Experimental Wi-Fi 7

Choose a tag to compare

@Ersiter Ersiter released this 07 Nov 05:09
FIX30-20261107
0048534

Fix30 has a known regression — use the Fix29 build below

On 5 GHz this build drops the link under sustained throughput. Testers report the
connection failing after a few speed tests: IO80211's resetStuckDataPathCheck resets the
chip repeatedly (25 times in 27 minutes in one report), the station re-joins on its own and
the cycle repeats. MLO activity is suspected, and the problem is not confined to one band.

Working build: BE200 Tahoe + Sequoia · Fix29 · Debug
— built from 0bd7a16, the last commit before the 7 November batch. Download the
AirportItlwm-Tahoe-Sequoia-Debug-0bd7a16… artifact from that run; GitHub requires a
sign-in to download artifacts. It replaces the kext in this release as-is.

This is the third release candidate of the be200-tahoe branch, continuing the native macOS Wi-Fi path from laobamac/itlwm. RC 3 widens the port from one part to the Intel Wi-Fi 7 family: BE200 / BE202 / Killer GL (8086:272B) and BE201 / Killer BZ (8086:A840, 8086:7740, 8086:4D40).

To the best of our review of public work, this remains the only public driver branch we know of with a macOS WPA3-Personal SAE/H2E implementation for Intel adapters, and with BE200 records on real hardware.

Download

Choose per system and purpose. Release for daily use; Debug keeps the diagnostic logs that connection and scan reports depend on. Every package holds one kext, the collector command and a short note.

System Daily use Diagnostic
macOS 26.x Tahoe · x86_64 Release Debug
macOS 15.2+ Sequoia · x86_64 Release Debug

Build marker 2.4.0_FIX30_20261107; source fixed at 0048534.

Current implementation

  • Firmware and the macOS interface
    Built on laobamac's IO80211/WCL integration and the OpenBSD network stack. The driver owns the firmware-side PHY, station, queue, key and RX/TX state and presents one logical Wi-Fi interface to macOS. BE firmware and PNVM are selected from the hardware revision, with an optional GL92 firmware for the BZ family.
  • WPA3-Personal SAE/H2E
    Stefan Sperling's OpenBSD SAE ported and wired in, with BearSSL P-256/i31 arithmetic for the H2E PT/PWE derivation, Commit/Confirm, PMK, the four-way handshake and controlled-port authorization. Default policy is H2E-only; Hunting-and-Pecking survives only in an experimental path that is off by default and is forbidden on 6 GHz. The AP's RSNXE is stored at scan time and checked at the four-way handshake.
  • Keys and enterprise
    Firmware MLD key interface with PMF management keys; 802.1X keeps using the macOS user-space EAP path bridged through EAPOL/PMK. Association, key authorization and the data port are tracked separately, and EAPOL that arrives early is queued until the user-space channel is ready. On multi-link, GTK/IGTK/BIGTK are kept per negotiated link.
  • Wi-Fi 6 and experimental Wi-Fi 7
    802.11a/b/g/n/ac retained; ax and be wired through, including HE capability and bandwidth, EHT capability, 320 MHz and puncturing, Basic MLE, affiliated-AP link discovery and address mapping, per-link PHY/station/queue/key state, eMLSR and TID-to-link mapping. 6 GHz channel table, scan requests and results are band-encoded; the usable channels follow the local regulatory domain and the adapter's own permits. Wi-Fi 7/EHT/MLO is not validated on hardware yet.

RC 3 fixes

RC 2 covered Fix26. This list covers everything since, newest first.

  • Multi-link keys — GTK/IGTK/BIGTK now live per negotiated link, MAC and Link KDEs are emitted in the handshake, and the AP MLD identity plus each link's RSNE/RSNXE are checked before a key is installed. Previously one group key served every link. (f645fa8, 7045cd5)

  • Transmit aggregation — A-MSDU subframes are built from the firmware's rate and aggregation notifications, with ADDBA permission negotiated separately; TLC MPDU limits follow the negotiated PHY. (cf100fb, 7811d4c)

  • Receive — the HE reorder window goes from 64 to 256 frames with matching storage, RX credits are published only after the upper-layer callback with generation and re-entry checks, firmware frame-release notifications are handled, and parsing honours the MIC/CRC trailer length the descriptor reports. (c282a1a, 301631c)

  • EHT reporting — 320 MHz capability, EHT Operation (extension ID 106) and negotiated rates are reported to the system, so the current link describes what was actually negotiated. (39f37a1, 1d9c99f, 71036eb)

  • TID-to-link mapping — negotiated for EHT associations instead of being left to the firmware default. (0bd7a16)

  • 6 GHz scanning — dwell policy follows upstream, scheduled scans stay on the PSC grid, and RNR discovery is limited to PSC and hinted channels. (dad38da, 76e43c2)

  • 6 GHz channel list — an empty 6 GHz list in the framework's request is no longer read as "do not scan the band": plain scans cover it, directed scans and joins still honour the request. (8608818)

  • Multiple BSSID — profiles are expanded before publication and each result carries its own elements and capability field; previously every profile reused the transmitting BSS's chain. (b7735ff, 353354b)

  • Scan results — the event boundary comes from the parser cursor instead of assuming a four-byte FCS, so a chain is no longer dropped whole when the firmware already stripped the trailer. (0534b77)

  • Scan and join sequencing — requests are serialized, superseded scans are retired, joins accepted before the driver is ready are held until it is, and a scan refused before the regulatory domain settles is issued once it does. (0dea715, 16a1ee8, 8140ed8)

  • SAE — H2E is advertised through authentication status code 126 rather than an appended RSNXE, the confirm counter advances on every transmission, and cached elements are bound to the MAC address they were derived from. (1658691, 09e824b, fff8987)

  • Wake — the adapter is re-enabled on wake; previously sleep left the interface down until Wi-Fi was toggled. (41b4754)

  • Enhanced Open (OWE) — association and key exchange, with the EAPOL MIC computed as SHA-256. (b0f7a3b, 3654918)

  • Wi-Fi 7 parts beyond BE200 — the branch now matches BE201 and the Killer BZ variants, and can load the optional GL92 firmware with PHY v5 and LINK v2. (6ab071a, 2e6e84f)

  • Key install failures (Fix28) — a failed IGTK/BIGTK install is reported as this handshake's failure instead of being deferred, the whole slot is cleared when an unseal discovers a failed install, and the install queue's counter and generation are tightened across link-state changes. (ad3ed5b)

  • 6 GHz probing (Fix28) — a probe request now goes out on 6 GHz where Linux sends one: PSC channels, and channels an RNR from a 2.4/5 GHz beacon points at. Previously the NVM's per-channel ACTIVE bit forced every 6 GHz dwell passive. (9bf74db)

  • Scan publication (Fix27) — a result is published only when it carries a name, the access point being joined is the exception, and the controller is told the driver is available on both notification paths. Previously the controller's own record stayed "unavailable", which it reads the country code from. (49a7987, ...

Read more

BE200 RC 2 · Fix26 · WPA3 / Experimental Wi-Fi 7

Choose a tag to compare

@Ersiter Ersiter released this 31 Oct 14:52
5cc1152

这是 be200-tahoe 分支的第二个RC版本发布,基于 laobamac/itlwm 的原生 macOS Wi-Fi 接入继续开发,重点支持 Intel BE200。

据目前已核对的公开实现,这是我们已知首个具备 Intel 无线网卡 macOS WPA3-Personal SAE/H2E 实现、并有 BE200 实机连接记录的公开驱动分支。

下载

本版为双平台合包,包含 macOS 26 Tahoe 与 macOS 15 Sequoia 的 Debug kext、检测 command 和一份中文说明。

附件 说明
AirportItlwm-BE200-Tahoe-Sequoia-20261031-Fix26-Debug.zip 双平台 Debug,含调试日志,反馈问题时使用

构建标记为 2.4.0_FIX26_20261031,源码固定在 5cc1152。

当前实现方案

  • BE200 固件与 macOS 接口
    在 laobamac 的 IO80211/WCL 接入与 OpenBSD 网络栈基础上,接通 BE200 GL/BZ 固件、PNVM、传输及 MLD 命令路径;由驱动管理固件侧的 PHY、STA、发送队列、密钥与收发状态,向 macOS 提供一个逻辑 Wi-Fi 接口。
  • 支持 WPA3-Personal SAE/H2E
    移植并衔接 Stefan Sperling 的 OpenBSD SAE 实现,使用 BearSSL 的 P-256/i31 运算完成 H2E 的 PT/PWE 派生,以及 Commit/Confirm、PMK、四次握手和受控端口授权。默认策略为 H2E-only;传统 Hunting-and-Pecking 仅保留在默认不编译的实验兼容路径,6GHz 禁止使用 HnP。扫描信息保留 AP 的 SAE/RSNXE,四次握手校验保存的 AP 原始 RSNXE,接受格式有效的扩展能力,并检查能力是否被改变。
  • 密钥与企业认证
    对接固件 MLD 密钥接口及 PMF 管理密钥处理;802.1X 继续使用 macOS 用户层 EAP 认证,经 EAPOL/PMK 桥接到驱动的 RSN 密钥状态机。关联完成、密钥授权和普通数据端口分别维护;EAPOL 提前到达时按用户层通道就绪状态排队与交付。
  • Wi-Fi 6 与实验性 Wi-Fi 7
    保留 802.11a/b/g/n/ac,支持ax/be,接通 HE 能力与带宽配置;进一步加入 EHT 能力、320MHz 与合法打孔位图协商,以及 Basic MLE、附属 AP link 发现和地址映射、逐链路 PHY/STA/队列/密钥及 eMLSR 控制路径。6GHz 的信道表、扫描请求和结果按频段编码;实际信道受所在地监管域、网卡与固件许可约束。Wi-Fi 7 / EHT / MLO 未测试。

RC 2 修复

  • 端口授权:此前 WPA2/WPA3 网络能关联成功、认证也通过,但链路始终不建立、拿不到地址。四次握手现在在设备可编程时同步装密钥并返回成功,仅在设备确实不可用时推迟。
  • 换网络点一次即切换:此前点选本身会触发重新初始化,接口在窗口内未就绪,请求被丢弃,必须再点一次。现在这类请求会挂起到驱动就绪后再执行。
  • 接受 Cisco/Apple Fast Lane 请求:此前这类 AP 在关联成功约半秒后即被拆链。
  • 离开 WPA3/PMF 网络时发送保护性解除关联帧:此前发普通帧,路由器忽略,直到超时才清掉该站状态,影响随后立刻重连。
  • 开机 6GHz:首次应用监管配置后,等驱动就绪再通知系统重读国家码并重建活跃信道表。此前开机 6GHz 不出现,必须手动关开一次 Wi-Fi。
  • 6GHz 的 BSS 信道取自 HE Operation 的 6GHz Operation Information。此前同一 BSSID 会被登记在多个扫描信道上。
  • 6GHz 结果的名字取自收到的帧,未取到名字时不再置 SSIDPresent。此前结果的 SSID 为空,网络在结果数组里却进不了系统列表。
  • 后台扫描只覆盖 6GHz 的 PSC 信道,菜单里的全量扫描仍覆盖全部 6GHz 信道;监管域落定之前不接受扫描请求,被拒的请求只是推迟。
  • 扫描取代:新的扫描请求会取代进行中的扫描。此前旧扫描未结束就一律拒绝,调用方要等 20 秒批次超时,表现为网络列表长时间空白。
  • 关联期间不再对当前 AP 的每个 beacon 重复投递扫描结果;诊断环按 BSSID 去重、16 槽。
  • 接收:设备状态校验不接受全 1 的无效读数;直通模式下只解析固件实际写入的数据;恢复块确认的会话与重排计时器已装载;MPDU 解析按实际载荷长度设界。
  • 性能:默认关闭网卡省电。此前要求固件常开省电,表现为延迟抖动变大、吞吐偏低。

已有实机记录:BE200 的 WPA2-Personal、WPA2-Enterprise/PEAP、WPA3-Personal SAE/H2E,以及 5GHz HE 160MHz。RC 2 的修复仍需社区扩大覆盖;其他 Intel 网卡不据此视为已验证。

相关上游工作

  • OpenIntelWireless/itlwm #955:BE200 支持需求。本分支围绕新固件接口与 macOS 原生 Wi-Fi 接入进行实现。
  • laobamac/itlwm PR #26,作者 laobamac:早到 EAPOL 与 RUN/授权时序。本分支已有对应的“仅在 RUN 后报告链路 UP、进入 RUN 时接续已授权端口”逻辑,并补充 WCL EAPOL 就绪队列。上游 AX210/Cisco 案例仍由该 PR 继续验证。
  • laobamac/itlwm PR #36,作者 mingww64:WPA2/WPA3 混合网络兼容。该 PR 的方案通过调整 RSNXE/AKM 选择 WPA2;本分支提供保留 RSNXE 的 SAE/H2E 认证路径。两者解决方向不同。

BE200 工作暂时保留在独立分支开发,等待现有 PR 推进,暂不向上游提交重叠优化。

来源与致谢

  • laobamac/itlwm:Tahoe/Sequoia 原生 Wi-Fi 接入及本分支基础;感谢 laobamac 的开发、评审和方向建议。
  • OpenIntelWireless/itlwm、zxystd 及原项目贡献者:Intel Wi-Fi macOS 驱动与移植基础。
  • OpenBSD、Stefan Sperling 及相关贡献者:net80211、iwn/iwm/iwx,以及本分支 SAE 代码所保留的原作者实现与版权。
  • BearSSL、Thomas Pornin:P-256/i31 密码运算基础。
  • Linux Intel iwlwifi、Intel 与 Linux 无线栈贡献者:GL/BZ 固件接口、MLD/密钥/信道实现参考;Intel 提供无线固件。
  • hostap / wpa_supplicant:SAE、RSNXE 和握手行为参考。
  • Acidanthera/MacKernelSDK:内核构建 SDK。
  • 原项目列出的 Black80211-Catalina、rpeshkov/black80211、Voodoo80211、usr-sse2 等作者与项目:IO80211 接入及历史移植基础;完整署名见 README Credits。
  • 感谢 Mieze 的 macOS 收包架构建议,以及提供路由器、实机和日志的社区测试者。

源码及各文件原始版权保留在本标签中;参见 项目许可 与 Intel 固件许可。

安装与反馈

选择与你系统对应的一个 kext,放入实际启动 EFI 的 OC/Kexts 并正确启用 Kernel/Add;同一系统只启用一个 Wi-Fi 驱动。HE/802.11ax 需 itlwm_he=1,更新后重启。

遇到问题请使用 Debug 包与随包 Collect-WiFi-Community.command,附系统版本、网卡/路由器型号、加密方式及复现现象。日志含网络元数据,请私下发送。

BE200 RC 1 · Fix22 · WPA3 / Experimental Wi-Fi 7

Choose a tag to compare

@Ersiter Ersiter released this 29 Oct 20:11

这是 be200-tahoe 分支的第一个RC版本发布,基于 laobamac/itlwm 的原生 macOS Wi-Fi 接入继续开发,重点支持 Intel BE200。

据目前已核对的公开实现,这是我们已知首个具备 Intel 无线网卡 macOS WPA3-Personal SAE/H2E 实现、并有 BE200 实机连接记录的公开驱动分支。

下载

日常使用选 Release;需要调试日志、反馈连接或扫描问题时选 Debug。

系统 日常测试 调试反馈
macOS 26.x Tahoe · x86_64 Release Debug
macOS 15.2+ Sequoia · x86_64 Release Debug

每个包包含对应系统的 kext、检测 command 和一份中文说明。构建标记为 2.4.0_FIX22_20261030,源码固定在 0e2a3fd。

当前实现方案

  • BE200 固件与 macOS 接口
    在 laobamac 的 IO80211/WCL 接入与 OpenBSD 网络栈基础上,接通 BE200 GL/BZ 固件、PNVM、传输及 MLD 命令路径;由驱动管理固件侧的 PHY、STA、发送队列、密钥与收发状态,向 macOS 提供一个逻辑 Wi-Fi 接口。
  • 支持 WPA3-Personal SAE/H2E
    移植并衔接 Stefan Sperling 的 OpenBSD SAE 实现,使用 BearSSL 的 P-256/i31 运算完成 H2E 的 PT/PWE 派生,以及 Commit/Confirm、PMK、四次握手和受控端口授权。默认策略为 H2E-only;传统 Hunting-and-Pecking 仅保留在默认不编译的实验兼容路径,6GHz 禁止使用 HnP。扫描信息保留 AP 的 SAE/RSNXE,四次握手校验保存的 AP 原始 RSNXE,接受格式有效的扩展能力,并检查能力是否被改变。
  • 密钥与企业认证
    对接固件 MLD 密钥接口及 PMF 管理密钥处理;802.1X 继续使用 macOS 用户层 EAP 认证,经 EAPOL/PMK 桥接到驱动的 RSN 密钥状态机。关联完成、密钥授权和普通数据端口分别维护;EAPOL 提前到达时按用户层通道就绪状态排队与交付。
  • Wi-Fi 6 与实验性 Wi-Fi 7
    保留 802.11a/b/g/n/ac,支持ax/be,接通 HE 能力与带宽配置;进一步加入 EHT 能力、320MHz 与合法打孔位图协商,以及 Basic MLE、附属 AP link 发现和地址映射、逐链路 PHY/STA/队列/密钥及 eMLSR 控制路径。6GHz 的信道表、扫描请求和结果按频段编码;实际信道受所在地监管域、网卡与固件许可约束。Wi-Fi 7 / EHT / MLO 未测试。

已有实机记录:BE200 的 WPA2-Personal、WPA2-Enterprise/PEAP、WPA3-Personal SAE/H2E,以及 5GHz HE 160MHz。Fix22 的新增协议边界仍需社区扩大覆盖;其他 Intel 网卡不据此视为已验证。

相关上游工作

  • OpenIntelWireless/itlwm #955:BE200 支持需求。本分支围绕新固件接口与 macOS 原生 Wi-Fi 接入进行实现。
  • laobamac/itlwm PR #26,作者 laobamac:早到 EAPOL 与 RUN/授权时序。本分支已有对应的“仅在 RUN 后报告链路 UP、进入 RUN 时接续已授权端口”逻辑,并补充 WCL EAPOL 就绪队列。上游 AX210/Cisco 案例仍由该 PR 继续验证。
  • laobamac/itlwm PR #36,作者 mingww64:WPA2/WPA3 混合网络兼容。该 PR 的方案通过调整 RSNXE/AKM 选择 WPA2;本分支提供保留 RSNXE 的 SAE/H2E 认证路径。两者解决方向不同。

BE200 工作暂时保留在独立分支开发,等待现有 PR 推进,暂不向上游提交重叠优化。

来源与致谢

  • laobamac/itlwm:Tahoe/Sequoia 原生 Wi-Fi 接入及本分支基础;感谢 laobamac 的开发、评审和方向建议。
  • OpenIntelWireless/itlwm、zxystd 及原项目贡献者:Intel Wi-Fi macOS 驱动与移植基础。
  • OpenBSD、Stefan Sperling 及相关贡献者:net80211、iwn/iwm/iwx,以及本分支 SAE 代码所保留的原作者实现与版权。
  • BearSSL、Thomas Pornin:P-256/i31 密码运算基础。
  • Linux Intel iwlwifi、Intel 与 Linux 无线栈贡献者:GL/BZ 固件接口、MLD/密钥/信道实现参考;Intel 提供无线固件。
  • hostap / wpa_supplicant:SAE、RSNXE 和握手行为参考。
  • Acidanthera/MacKernelSDK:内核构建 SDK。
  • 原项目列出的 Black80211-Catalina、rpeshkov/black80211、Voodoo80211、usr-sse2 等作者与项目:IO80211 接入及历史移植基础;完整署名见 README Credits。
  • 感谢 Mieze 的 macOS 收包架构建议,以及提供路由器、实机和日志的社区测试者。

源码及各文件原始版权保留在本标签中;参见 项目许可 与 Intel 固件许可。

安装与反馈

选择与你系统对应的一个 kext,放入实际启动 EFI 的 OC/Kexts 并正确启用 Kernel/Add;同一系统只启用一个 Wi-Fi 驱动。HE/802.11ax 需 itlwm_he=1,更新后重启。

遇到问题请使用同平台 Debug 包与随包 Collect-WiFi-Community.command,附系统版本、网卡/路由器型号、加密方式及复现现象。日志含网络元数据,请私下发送。