Open source · GPL-2.0 · x86_64
Le Wi-Fi natif de macOS pour les cartes Intel, du 802.11n au Wi-Fi 7
macOS Tahoe 26 et Sequoia 15 · WPA3 · 6 GHz · 802.11be · BE200 / BE201 et toutes les cartes prises en charge par itlwm
AirportItlwm porté du Wi-Fi 6 au Wi-Fi 7 (BE200, BE201), avec AirDrop et le point d'accès instantané en cours de développement. Toutes les cartes déjà prises en charge continuent de fonctionner, avec le Wi-Fi propre à macOS, sans HeliPort et sans les correctifs Wi-Fi d'OpenCore Legacy Patcher.
Télécharger depuis ReleasesVoir sur GitHubIssues
Construit sur itlwm et laobamac/itlwm. Voir origines et remerciements.
Si le pilote vous est utile, une ⭐ sur GitHub aide d'autres utilisateurs d'Intel à le trouver.
- débit de liaison
- 2882 Mbit/s
- émission
- 2.55 Gbit/s
- réception
- 1.84 Gbit/s
- sur matériel réel
- 320 MHz
Mesuré sur une BE200 : macOS 26, 6 GHz, 320 MHz, deux flux. Les valeurs sont le débit de liaison et le débit mesuré sur l'interface. HE 160 MHz en 5 GHz. Mise en veille : reconnexion immédiate après une veille de n'importe quelle durée (retours de testeurs).
- macOS 26 Tahoe
- macOS 15.2+ Sequoia
- x86_64
- GPL-2.0
Origines et remerciements
Ce projet n'existe que grâce au code source des autres. Il conserve tout itlwm et AirportItlwm et y ajoute des fonctions ; il ne les remplace pas. Merci à toutes les personnes citées ci-dessous.
- itlwmzxystd / OpenIntelWireless
- laobamac/itlwmL'interface sans fil native d'Apple pour Tahoe/Sequoia
- Eric-AirportItlwmCe dépôt
itlwm de zxystd / OpenIntelWireless → laobamac/itlwm (l'interface sans fil native d'Apple pour Tahoe/Sequoia) → ce dépôt : il conserve tout cela et ajoute la couche de transport Wi-Fi 7 et le chemin du micrologiciel MLD, WPA3 SAE/H2E et OWE, le 6 GHz, le 320 MHz et le multi-lien, en suivant Linux iwlwifi (mld, mvm) et mac80211 commande par commande.
Remerciements
- zxystd et OpenIntelWireless : itlwm et AirportItlwm
- laobamac : l'interface native IO80211 / Skywalk / WCL pour Tahoe et Sequoia, ainsi que relectures et orientation
- OpenBSD, Stefan Sperling et les contributeurs : net80211, iwn, iwm, iwx et l'implémentation de SAE
- BearSSL, Thomas Pornin : arithmétique P-256 pour SAE
- Linux iwlwifi et mac80211 : le comportement de référence pour chaque commande du micrologiciel
- hostap / wpa_supplicant : référence pour SAE, RSNXE et le comportement de la poignée de main
- retropineaple/ForbiddenItlwm : AWDL sur les cartes Intel ; l'écouteur AX et la vérification de la table AWDL s'en inspirent
- crazyhulk : travaux préparatoires sur l'interface AWDL et correctifs BLE de BlueToolFixup
- seemoo-lab/owl : implémentation ouverte d'AWDL, utilisée comme référence du protocole
- Acidanthera : MacKernelSDK, Lilu, BrcmPatchRAM / BlueToolFixup
- Mieze, pour ses conseils sur le chemin de réception sous macOS
- Les projets cités par itlwm : Black80211-Catalina, black80211, Voodoo80211, usr-sse2 et d'autres
- Intel, pour le micrologiciel, distribué sous la licence de micrologiciel d'Intel
- Toutes les personnes qui ont fourni routeurs, matériel et journaux
Fonctions
| Fonction | Cartes | État |
|---|---|---|
| Recherche, connexion, itinérance, adresse Wi-Fi privée | toutes | Fonctionne |
| WPA2 Personnel, WPA2 Entreprise (PEAP), réseaux de transition WPA2/WPA3 | toutes | Fonctionne |
| WPA3 Personnel (SAE, H2E), Enhanced Open (OWE) | toutes | Fonctionne sur BE200 |
| 802.11ac (VHT), 160 MHz | AC et plus récentes | Fonctionne |
| 802.11ax (HE) | AX et BE | Fonctionne |
| 6 GHz | AX210/AX211/AX411, BE | Fonctionne sur BE200 |
| 802.11be (EHT), 320 MHz, multi-lien (eMLSR) | BE | Fonctionne 320 MHz sur matériel réel ; un routeur multi-lien est rejoint ; l'appairage des liens reste expérimental |
| Veille et réveil, reprise après erreur du micrologiciel | toutes | Fonctionne |
| AirDrop / AWDL | iwn (PAN), iwm, AX, BE | En développement voir Continuité |
| Point d'accès instantané (iPhone dans le menu Wi-Fi) | toutes | En développement |
Cartes prises en charge
| Génération | Cartes | ID de périphérique PCI (8086:xxxx) | HAL / micrologiciel |
|---|---|---|---|
| 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 | voir Info.plist | iwm |
| Wi-Fi 4 | 6xxx, 5xxx, 4965, 2200, 2230, 1000, 1030, 100, 105, 130, 135 | voir Info.plist | iwn |
Le micrologiciel de chaque carte est intégré à la kext. Pour la famille BE, la révision du matériel choisit le micrologiciel et l'API adaptée la plus élevée est essayée en premier. Pas encore prise en charge : la génération « SC » du Wi-Fi 7 (BE211/BE213, 6E70 D240 D340 E340 E440 9327), qui exige un micrologiciel que ce projet ne fournit pas.
Installation
- Téléchargez le paquet correspondant à votre macOS depuis Releases :
macOS26-Tahoepour macOS 26,macOS15-Sequoiapour macOS 15.2 ou ultérieur. Release pour un usage quotidien ; Debug conserve les journaux de diagnostic dont un rapport a besoin. - Placez la kext dans
EFI/OC/Kexts/et ajoutez-la dansKernel → Add. N'utilisez qu'une seule kext Wi-Fi Intel. Si une même configuration démarre les deux systèmes, limitez la kext Tahoe à Darwin25.0.0–25.99.99et la kext Sequoia à24.2.0–24.99.99. - Ne la combinez pas avec les correctifs racine « Modern Wireless » d'OpenCore Legacy Patcher ni avec un remplacement d'IO80211 / Skywalk : ce pilote utilise la pile Wi-Fi du système elle-même.
- Gardez une copie amorçable de votre EFI et testez d'abord depuis une clé USB.
Le pays et les canaux qui y sont autorisés viennent des réseaux environnants, grâce à la logique de réglementation de la carte elle-même, comme sous Linux. Il n'y a rien à régler.
Arguments de démarrage
| Argument | Effet |
|---|---|
-itlawdl | AirDrop expérimental, voir ci-dessous. À n'utiliser que pour tester |
itlwm_he=0 | Désactive HE/EHT (802.11ax/be). Activé par défaut |
Continuité
En développement
Point d'accès instantané
Le réveil Bluetooth du point d'accès de l'iPhone, le balayage dirigé et l'association WPA3 fonctionnent ; pour l'instant, l'iPhone coupe la liaison juste après la poignée de main à quatre voies. C'est le bogue ouvert, et la correction vaut pour toutes les cartes.
AirDrop (AWDL)
awdl0 est créée et c'est la pile AWDL de macOS elle-même qui la pilote. AirDrop exige que la carte écoute sur le canal AWDL tout en restant sur votre réseau. Toutes les cartes Intel sauf l'AX411 n'ont qu'une seule radio (l'eMLSR du Wi-Fi 7 est aussi une radio unique), si bien que le micrologiciel se partage le temps entre les deux :
- Cartes AX (micrologiciel sans MLD) : un écouteur permanent avec son propre contexte de canal, la construction que ForbiddenItlwm fait tourner sur l'AX211 avec AirDrop dans les deux sens.
- Cartes BE (micrologiciel MLD) : la même idée avec le jeu de commandes MLD, sous la forme d'un lien client P2P à côté du lien station (la combinaison que Linux autorise sur deux canaux). Les règles d'activation du micrologiciel sont en cours d'élucidation à partir de son propre code ; ne fonctionne pas encore.
- Cartes iwm (séries 7000, 8000 et 9000) : l’écouteur permanent démarre après la connexion au Wi-Fi. Les nouveaux modèles restent à vérifier sur le matériel.
- Cartes iwn avec PAN et P2P (6205 et 6235 en priorité) : se connecter au Wi-Fi sur le canal 6 et démarrer avec
-itlawdl. AirDrop sur ce canal reste à valider sur le matériel.
La détection AirDrop utilise la publicité et le balayage Bluetooth LE. Les correctifs Intel BLE sont disponibles séparément dans Eric-BlueToolFixup Releases. Les paquets de test contiennent les deux kexts. Avec -itlawdl, le pilote vérifie d'abord que la table d'interface AWDL d'Apple a la disposition pour laquelle il a été compilé (AWDLBuildCheck dans l'I/O Registry), sinon il fonctionne comme un simple Wi-Fi : une mise à jour de macOS ne peut donc pas provoquer de kernel panic. Le canal d'écoute est 149, puis 44, puis 6, et seulement un canal sur lequel le pays autorise l'émission (44 là où il n'y a pas de 149 ; un canal passif dès qu'un routeur voisin y émet des balises). Le 149 est le plus rapide : routeurs sur 149 et iPhone sur 149 ou hors Wi-Fi donnent la meilleure vitesse AirDrop.
Signaler un problème
Lancez Collect-EricWirelessDiagnostics.command depuis le paquet Debug avant de reproduire le problème. Choisissez Wi-Fi, AirDrop / Instant Hotspot ou détection Bluetooth. Indiquez la carte, l'autre appareil et le résultat dans un ticket GitHub. Envoyez l'archive en privé si elle contient des métadonnées réseau.
Compiler
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 buildLes notes d'implémentation du Wi-Fi 7, l'état du matériel étape par étape et les références Linux sont dans BE200.md (en anglais).
Licence
GPL-2.0, héritée d'itlwm. Le micrologiciel Intel est distribué sous sa propre licence : voir la licence de micrologiciel d'Intel. Texte complet : LICENSE.