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.
- 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.
- itlwmzxystd / OpenIntelWireless
- laobamac/itlwmDie native Apple-WLAN-Schnittstelle für Tahoe/Sequoia
- 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
- zxystd und OpenIntelWireless: itlwm und AirportItlwm
- laobamac: die native IO80211-/Skywalk-/WCL-Schnittstelle für Tahoe und Sequoia sowie Durchsicht und Anleitung
- OpenBSD, Stefan Sperling und Mitwirkende: net80211, iwn, iwm, iwx und die SAE-Implementierung
- BearSSL, Thomas Pornin: P-256-Arithmetik für SAE
- Linux iwlwifi und mac80211: das Referenzverhalten für jeden Firmware-Befehl
- hostap / wpa_supplicant: Referenz für SAE, RSNXE und Handshake-Verhalten
- retropineaple/ForbiddenItlwm: AWDL auf Intel-Karten; der AX-Listener und die Prüfung der AWDL-Tabelle folgen diesem Projekt
- crazyhulk: Vorarbeit an der AWDL-Schnittstelle und die BLE-Patches für BlueToolFixup
- seemoo-lab/owl: offene AWDL-Implementierung als Protokollreferenz
- Acidanthera: MacKernelSDK, Lilu, BrcmPatchRAM / BlueToolFixup
- Mieze, für Hinweise zum Empfangspfad unter macOS
- Die Projekte, die itlwm nennt: Black80211-Catalina, black80211, Voodoo80211, usr-sse2 und andere
- Intel, für die Firmware, verteilt unter Intels Firmware-Lizenz
- Alle, die Router, Hardware und Logs beigesteuert haben
Funktionen
| Funktion | Karten | Status |
|---|---|---|
| Suchen, Verbinden, Roaming, private WLAN-Adresse | alle | Funktioniert |
| WPA2-Personal, WPA2-Enterprise (PEAP), WPA2/WPA3-Übergangsnetze | alle | Funktioniert |
| WPA3-Personal (SAE, H2E), Enhanced Open (OWE) | alle | Funktioniert an einer BE200 |
| 802.11ac (VHT), 160 MHz | AC und neuer | Funktioniert |
| 802.11ax (HE) | AX und BE | Funktioniert |
| 6 GHz | AX210/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-Fehlern | alle | Funktioniert |
| AirDrop / AWDL | iwn (PAN), iwm, AX, BE | In Entwicklung siehe Continuity |
| Instant Hotspot (iPhone im WLAN-Menü) | alle | In Entwicklung |
Unterstützte Karten
| Generation | Karten | PCI-Geräte-IDs (8086:xxxx) | HAL / Firmware |
|---|---|---|---|
| Wi-Fi 7 | BE200, BE202, Killer BE1750 x/w | 272B | iwx, MLD API 92 (86) |
| Wi-Fi 7 | BE201, Killer BE1750 i/s | A840 7740 4D40 | iwx, MLD API 92 |
| Wi-Fi 6E | AX210, AX211, AX411 | 2725 2726 7A70 7AF0 51F0 51F1 54F0 7F70 2729 7E40 | iwx, API 68 |
| Wi-Fi 6 | AX200, AX201, AX1650 | 2723 2720 02F0 06F0 34F0 3DF0 4DF0 43F0 A0F0 | iwx, API 68 |
| Wi-Fi 5 | 9260, 9461, 9462, 9560, 8265, 8260, 7265, 7260, 3168, 3165, 3160 | siehe Info.plist | iwm |
| Wi-Fi 4 | 6xxx, 5xxx, 4965, 2200, 2230, 1000, 1030, 100, 105, 130, 135 | siehe Info.plist | iwn |
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
- Lade das Paket für dein macOS von Releases herunter:
macOS26-Tahoefür macOS 26,macOS15-Sequoiafür macOS 15.2 oder neuer. Release für den Alltag; Debug behält die Diagnose-Logs, die ein Fehlerbericht braucht. - Lege die Kext in
EFI/OC/Kexts/und trage sie unterKernel → Addein. Verwende nur eine einzige Intel-WLAN-Kext. Startet eine Konfiguration beide Systeme, begrenze die Tahoe-Kext auf Darwin25.0.0–25.99.99und die Sequoia-Kext auf24.2.0–24.99.99. - 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.
- 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
| Argument | Wirkung |
|---|---|
-itlawdl | Experimentelles AirDrop, siehe unten. Nur zum Testen verwenden |
itlwm_he=0 | HE/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
-itlawdlstarten. 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.
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 buildDie 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.