Eric-AirportItlwm
de

Open Source · GPL-2.0 · x86_64

Natives macOS-WLAN für Intel-Karten, von 802.11n bis Wi-Fi 7

macOS Tahoe 26 und Sequoia 15 · WPA3 · 6 GHz · 802.11be · BE200 / BE201 und alle Karten, die itlwm unterstützt

AirportItlwm von Wi-Fi 6 auf Wi-Fi 7 gebracht (BE200, BE201); AirDrop und Instant Hotspot sind in Arbeit. Alle bisher unterstützten Karten funktionieren weiter, mit dem WLAN von macOS selbst, ohne HeliPort und ohne die WLAN-Patches von OpenCore Legacy Patcher.

Von Releases herunterladenAuf GitHub ansehenIssues

Aufgebaut auf itlwm und laobamac/itlwm. Siehe Herkunft und Danksagung.

Wenn der Treiber bei dir läuft, freue ich mich über einen ⭐ auf GitHub: So finden ihn mehr Intel-Nutzer.

Eric-AirportItlwm
Verbindungsrate
2882 Mbit/s
Senden
2.55 Gbit/s
Empfangen
1.84 Gbit/s
auf echter Hardware
320 MHz

Gemessen an einer BE200: macOS 26, 6 GHz, 320 MHz, zwei Streams. Angegeben sind Verbindungsrate und Durchsatz an der Schnittstelle. 5 GHz HE mit 160 MHz. Ruhezustand: verbindet sich nach beliebig langem Ruhezustand sofort neu (Berichte von Testern).

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

Herkunft und Danksagung

Dieses Projekt gibt es nur wegen des Quellcodes anderer. Es behält alles von itlwm und AirportItlwm und erweitert es, ersetzt es aber nicht. Vielen Dank an alle unten Genannten.

  1. itlwmzxystd / OpenIntelWireless
  2. laobamac/itlwmDie native Apple-WLAN-Schnittstelle für Tahoe/Sequoia
  3. Eric-AirportItlwmDieses Repository

itlwm von zxystd / OpenIntelWireless → laobamac/itlwm (die native Apple-WLAN-Schnittstelle für Tahoe/Sequoia) → dieses Repository: behält alles davon und ergänzt die Wi-Fi-7-Transportschicht und den MLD-Firmwarepfad, WPA3 SAE/H2E und OWE, 6 GHz, 320 MHz und Multi-Link, Befehl für Befehl nach Linux iwlwifi (mld, mvm) und mac80211.

Danksagung

Funktionen

FunktionKartenStatus
Suchen, Verbinden, Roaming, private WLAN-Adressealle Funktioniert
WPA2-Personal, WPA2-Enterprise (PEAP), WPA2/WPA3-Übergangsnetzealle Funktioniert
WPA3-Personal (SAE, H2E), Enhanced Open (OWE)alle Funktioniert an einer BE200
802.11ac (VHT), 160 MHzAC und neuer Funktioniert
802.11ax (HE)AX und BE Funktioniert
6 GHzAX210/AX211/AX411, BE Funktioniert an einer BE200
802.11be (EHT), 320 MHz, Multi-Link (eMLSR)BE Funktioniert 320 MHz auf echter Hardware; ein Router mit Multi-Link wird erreicht; die Link-Paarung ist noch experimentell
Ruhezustand und Aufwachen, Wiederherstellung nach Firmware-Fehlernalle Funktioniert
AirDrop / AWDLiwn (PAN), iwm, AX, BE In Entwicklung siehe Continuity
Instant Hotspot (iPhone im WLAN-Menü)alle In Entwicklung

Unterstützte Karten

GenerationKartenPCI-Geräte-IDs (8086:xxxx)HAL / Firmware
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, 3160siehe Info.plistiwm
Wi-Fi 46xxx, 5xxx, 4965, 2200, 2230, 1000, 1030, 100, 105, 130, 135siehe Info.plistiwn

Die Firmware jeder Karte ist in der Kext enthalten. Bei der BE-Familie wählt die Hardware-Revision die Firmware aus, und die höchste angepasste API wird zuerst versucht. Noch nicht unterstützt: die „SC“-Generation von Wi-Fi 7 (BE211/BE213, 6E70 D240 D340 E340 E440 9327), die Firmware braucht, die dieses Projekt nicht mitliefert.

Installation

  1. Lade das Paket für dein macOS von Releases herunter: macOS26-Tahoe für macOS 26, macOS15-Sequoia für macOS 15.2 oder neuer. Release für den Alltag; Debug behält die Diagnose-Logs, die ein Fehlerbericht braucht.
  2. Lege die Kext in EFI/OC/Kexts/ und trage sie unter Kernel → Add ein. Verwende nur eine einzige Intel-WLAN-Kext. Startet eine Konfiguration beide Systeme, begrenze die Tahoe-Kext auf Darwin 25.0.0–25.99.99 und die Sequoia-Kext auf 24.2.0–24.99.99.
  3. Kombiniere sie nicht mit den „Modern Wireless“-Root-Patches von OpenCore Legacy Patcher oder einem Ersatz für IO80211 / Skywalk: Dieser Treiber nutzt den WLAN-Stack des Systems selbst.
  4. Bewahre eine startfähige Kopie deiner EFI auf und teste zuerst mit einem USB-Stick.

Das Land und die dort erlaubten Kanäle ergeben sich aus den Netzen in der Umgebung, über die Regulierungslogik der Karte selbst, wie unter Linux. Es gibt nichts einzustellen.

Boot-Argumente

ArgumentWirkung
-itlawdlExperimentelles AirDrop, siehe unten. Nur zum Testen verwenden
itlwm_he=0HE/EHT (802.11ax/be) ausschalten. Standardmäßig an

Continuity

In Entwicklung

Instant Hotspot

Das Aufwecken des iPhone-Hotspots über Bluetooth, der gezielte Scan und die WPA3-Assoziation funktionieren; das iPhone trennt die Verbindung derzeit direkt nach dem Vier-Wege-Handshake. Das ist der offene Fehler, und die Korrektur gilt für jede Karte.

AirDrop (AWDL)

awdl0 wird angelegt und vom AWDL-Stack von macOS selbst betrieben. Für AirDrop muss die Karte auf dem AWDL-Kanal lauschen und zugleich in deinem Netz bleiben. Jede Intel-Karte außer der AX411 hat nur ein Funkmodul (auch das eMLSR von Wi-Fi 7 ist ein einzelnes Funkmodul), deshalb teilt die Firmware die Zeit auf beide auf:

  • AX-Karten (Firmware ohne MLD): ein dauerhafter Listener mit eigenem Kanalkontext, so wie ForbiddenItlwm ihn auf der AX211 betreibt, mit AirDrop in beide Richtungen.
  • BE-Karten (MLD-Firmware): derselbe Gedanke mit dem MLD-Befehlssatz, als P2P-Client-Link neben dem Station-Link (die Kombination, die Linux auf zwei Kanälen erlaubt). Die Aktivierungsregeln der Firmware werden aus deren eigenem Code erarbeitet; funktioniert noch nicht.
  • iwm-Karten (Serien 7000, 8000 und 9000): Der dauerhafte Listener startet nach dem Verbinden mit dem WLAN. Für die neu hinzugekommenen Modelle stehen Praxistests aus.
  • iwn-Karten mit PAN und P2P (zunächst 6205 und 6235): WLAN auf Kanal 6 verwenden und mit -itlawdl starten. Der AirDrop-Betrieb auf diesem Kanal muss noch auf echter Hardware geprüft werden.

AirDrop verwendet Bluetooth LE zur Erkennung. Die optionalen Intel-BLE-Patches gibt es separat unter Eric-BlueToolFixup Releases. Community-Testpakete enthalten beide Kexts. Mit -itlawdl prüft der Treiber zuerst, ob Apples AWDL-Schnittstellentabelle das Layout hat, für das er gebaut wurde (AWDLBuildCheck in der I/O-Registry), und läuft sonst als reines WLAN, sodass ein macOS-Update keinen Kernel-Panic auslösen kann. Der Lauschkanal ist 149, dann 44, dann 6, und zwar nur einer, auf dem das Land das Senden erlaubt (44, wo es keine 149 gibt; ein passiver Kanal, sobald ein Router in der Nähe dort Beacons sendet). 149 ist am schnellsten: Router auf 149 und ein iPhone auf 149 oder ohne WLAN ergeben die beste AirDrop-Geschwindigkeit.

Fehler melden

Starte vor dem Reproduzieren Collect-EricWirelessDiagnostics.command aus dem Debug-Paket. Wähle WLAN, AirDrop / Instant Hotspot oder Bluetooth-Erkennung. Melde Adapter, Gegenstelle und Ergebnis im GitHub-Issue. ZIP-Dateien mit Netzwerkdaten privat senden.

Issue öffnen

Bauen

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

Die Hinweise zur Wi-Fi-7-Implementierung, der Hardware-Stand je Stufe und die Linux-Referenzen stehen in BE200.md (englisch).

Lizenz

GPL-2.0, von itlwm übernommen. Die Intel-Firmware wird unter ihrer eigenen Lizenz verteilt: siehe Intels Firmware-Lizenz. Volltext: LICENSE.