Eric-AirportItlwm
fr

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.

Eric-AirportItlwm
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.

  1. itlwmzxystd / OpenIntelWireless
  2. laobamac/itlwmL'interface sans fil native d'Apple pour Tahoe/Sequoia
  3. 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

FonctionCartesÉtat
Recherche, connexion, itinérance, adresse Wi-Fi privéetoutes Fonctionne
WPA2 Personnel, WPA2 Entreprise (PEAP), réseaux de transition WPA2/WPA3toutes Fonctionne
WPA3 Personnel (SAE, H2E), Enhanced Open (OWE)toutes Fonctionne sur BE200
802.11ac (VHT), 160 MHzAC et plus récentes Fonctionne
802.11ax (HE)AX et BE Fonctionne
6 GHzAX210/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 micrologicieltoutes Fonctionne
AirDrop / AWDLiwn (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érationCartesID de périphérique PCI (8086:xxxx)HAL / micrologiciel
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, 3160voir Info.plistiwm
Wi-Fi 46xxx, 5xxx, 4965, 2200, 2230, 1000, 1030, 100, 105, 130, 135voir Info.plistiwn

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

  1. Téléchargez le paquet correspondant à votre macOS depuis Releases : macOS26-Tahoe pour macOS 26, macOS15-Sequoia pour macOS 15.2 ou ultérieur. Release pour un usage quotidien ; Debug conserve les journaux de diagnostic dont un rapport a besoin.
  2. Placez la kext dans EFI/OC/Kexts/ et ajoutez-la dans Kernel → 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 à Darwin 25.0.0–25.99.99 et la kext Sequoia à 24.2.0–24.99.99.
  3. 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.
  4. 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

ArgumentEffet
-itlawdlAirDrop expérimental, voir ci-dessous. À n'utiliser que pour tester
itlwm_he=0Dé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.

Ouvrir un ticket

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 build

Les 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.