Erwan
a10e097a7e
Breakthroughs & Reverse Engineering (macOS Tahoe 26.7.1 / Darwin 25.6.0): - Reconstructed the complete 463-slot Skywalk vtable and class layout (0x128 / 296 bytes) of IO80211Controller (__ZTV17IO80211Controller at 0xffffff8002461148) and AppleBCMWLANCore from BootKernelExtensions.kc (IO80211Family 1200.13.1, source 1566.5). - Verified IOUSBHostDevice::deviceRequest vtable slot in Tahoe's BootKernelExtensions.kc (__ZTV15IOUSBHostDevice at 0xffffff8002e72720): confirmed exact match at slot 374 (0x176, byte offset 0xbb0). - Disassembled Tahoe's /usr/sbin/bluetoothd (FindTransportType at 0x10014c700, Found_USB_Dongle at 0x1000e9559, GetProductAndVendorID at 0x1000edf2a) confirming USB transport matching on 'Bluetooth USB Host Controller' and CSR 0x0a12 descriptor spoofing. Code & Build Modifications (v1.1.0): - IO80211Controller.h: Add full 463-slot Tahoe Skywalk vtable declaration (slots 394..462, offsets 0xc50..0xe70) and exact 0x80 filler size when __IO80211_TARGET >= 260000 while preserving legacy compatibility. - QualcommWifi.hpp/.cpp: Implement Tahoe IO80211Controller pure virtual methods (isCommandProhibited, handleCardSpecific, getDRIVER_VERSION, getHARDWARE_VERSION, getCARD_CAPABILITIES, getPOWER, setPOWER, getCOUNTRY_CODE, setCOUNTRY_CODE, setGET_DEBUG_INFO, getLogger, getFaultReporterFromDriver) and guard un-reserved IONetworkController slots 6..7 on SDK 26.5. - QualcommWireless.cpp: Add non-null vtable slot sanity check prior to installing the shadow vtable hook on IOUSBHostDevice::deviceRequest. - project.pbxproj & Info.plist: Upgrade to Xcode 26.6 (MacOSX26.5.sdk), MACOSX_DEPLOYMENT_TARGET = 26.0, __IO80211_TARGET = 260000, and bump version to 1.1.0. - docs & README: Document macOS Tahoe (Darwin 25) architecture, bluetoothd offsets, and Skywalk IO80211Controller ABI.
4.9 KiB
4.9 KiB
Compilation et Déploiement de QualcommWireless
Ce guide détaille les étapes pour compiler le kext QualcommWireless à partir des sources et l'intégrer proprement dans l'EFI OpenCore.
1. Prérequis Système
- Système d'exploitation hôte : macOS Tahoe (26.x / Darwin 25), macOS Sequoia (15.x / Darwin 24) ou macOS Sonoma (14.x).
- Environnement de développement : Xcode 26+ (ex. Xcode 26.6) ou Xcode 16+ avec les outils en ligne de commande (
xcode-select --install). - SDK macOS : macOS 26.x SDK (ex.
MacOSX26.5.sdk, inclus dans Xcode 26.6). - Architectures cibles : Binaire universel
x86_64(Hackintosh Intel/AMD) etarm64e(Apple Silicon).
2. Arborescence du Projet
QualcommWireless/
├── .gitignore # Filtres pour conserver un dépôt git propre
├── docs/ # Documentation technique détaillée
│ ├── ARCHITECTURE.md # Vue d'ensemble matérielle & logicielle
│ ├── BLUETOOTH.md # Analyse Bluetooth, diagnostic crash & fix
│ ├── NATIVE_WIFI.md # Pile Wi-Fi native (IO80211Controller)
│ └── BUILD.md # Ce guide de compilation et d'installation
├── firmware/ # Binaires de microprogrammes WCN7850
│ ├── amss.bin # Microprogramme principal Wi-Fi
│ ├── board-2.bin # Données de calibration radio RF
│ └── m3.bin # Microprogramme d'économie d'énergie M3
├── QualcommWifi/ # Code source du pilote Wi-Fi 7 natif (IO80211Controller)
│ ├── Firmware_WCN7850_Wifi.h/.cpp# Microprogrammes Wi-Fi intégrés
│ └── QualcommWifi.hpp/.cpp # Implémentation IO80211Controller (Tahoe Skywalk & Legacy)
├── QualcommWireless/ # Code source du pilote Bluetooth USB (IOService)
│ ├── Info.plist # Descripteur et personnalités IOKit (v1.1.0)
│ ├── Firmware_WCN7850.h # Header des microprogrammes BT intégrés
│ ├── QualcommWireless.hpp/.cpp # Implémentation DFU Bluetooth & Shadow VTable
│ └── include/ # Headers internes IOKit & 802.11
└── QualcommWireless.xcodeproj # Projet Xcode configuré pour build KEXT
3. Compilation
3.1. En Ligne de Commande (Recommandé)
Depuis la racine du projet :
xcodebuild -project QualcommWireless.xcodeproj -configuration Release
Le bundle kext final est généré dans :
build/Release/QualcommWireless.kext
3.2. Vérification du Binaire
Pour s'assurer que le kext est bien un binaire universel prêt pour le chargement noyau :
file build/Release/QualcommWireless.kext/Contents/MacOS/QualcommWireless
Sortie attendue :
Mach-O universal binary with 2 architectures: [x86_64:Mach-O 64-bit kext bundle x86_64] [arm64e]
4. Déploiement dans OpenCore
4.1. Copie du Kext dans l'EFI
Montez votre partition EFI (ex. /Volumes/EFI), puis copiez le kext compilé :
cp -R build/Release/QualcommWireless.kext /Volumes/EFI/EFI/OC/Kexts/
4.2. Configuration dans config.plist
Dans la section Kernel -> Add de votre config.plist :
<dict>
<key>Arch</key>
<string>Any</string>
<key>BundlePath</key>
<string>QualcommWireless.kext</string>
<key>Comment</key>
<string>Qualcomm FastConnect 7800 Wi-Fi & Bluetooth</string>
<key>Enabled</key>
<true/>
<key>ExecutablePath</key>
<string>Contents/MacOS/QualcommWireless</string>
<key>MaxKernel</key>
<string></string>
<key>MinKernel</key>
<string></string>
<key>PlistPath</key>
<string>Contents/Info.plist</string>
</dict>
Caution
RÈGLE CRITIQUE POUR ÉVITER LES CRASHS :
- DÉSACTIVEZ ET SUPPRIMEZ
IntelBTPatcher.kext. Il est conçu uniquement pour les puces Intel et provoque un Kernel Panic immédiat à la connexion des périphériques Bluetooth sous macOS 15 Sequoia (IOBluetoothL2CAPChanneltaggedRelease registry corruption).- CONSERVEZ
BlueToolFixup.kext, qui est indispensable pour activer la gestion des dongles tiers dansbluetoothd.
4.3. Arguments de Démarrage (NVRAM -> boot-args)
Vérifiez la présence des arguments suivants pour assurer la compatibilité Bluetooth :
-btlfxallowanyaddr -btlfxnvramcheck
5. Diagnostic et Commandes Utiles
Pour vérifier l'état du système après un redémarrage :
- Vérifier l'état du Bluetooth :
system_profiler SPBluetoothDataType - Vérifier la détection USB du contrôleur :
ioreg -l -r -n "IOUSBHostDevice@00a10000" - Consulter les journaux Bluetooth en temps réel :
/usr/bin/log stream --predicate 'process == "bluetoothd"' - Vérifier les extensions noyau chargées :
kmutil showloaded | grep -iE 'qualcomm|blue'