feat(wifi): implement macOS Tahoe WorkQueue and FaultReporter for IO80211Controller

### Breakthroughs & Rétro-ingénierie (macOS Tahoe 26.7.1 / IO80211Family 1200.13.1)
1. WorkQueue Invariants (Slots 395 & 397):
   - Analyse de `IO80211Controller::start(provider)` et `IONetworkController::start(provider)`.
   - `createWorkLoop()` appelle directement le slot 395 `createWorkQueue()` (offset 0xc58), dont la classe de base renvoie `false`.
   - `getWorkLoop()` appelle le slot 397 `getWorkQueue()` (offset 0xc68), dont la classe de base renvoie `nullptr`.
   - Si non surchargés, `start()` échoue immédiatement avant l'allocation du timer.
   - Broadcom (`AppleBCMWLANCore`) alloue `IO80211WorkQueue::workQueue()` (`__ZN16IO80211WorkQueue9workQueueEv`).
   - Implémenté dans QualcommWifi avec `fWorkQueue` dérivé de `IOWorkLoop`.

2. Prévention du Kernel Panic dans `findAndAttachToFaultReporter` (Slot 432):
   - `IO80211Controller::findAndAttachToFaultReporter` appelle le slot 432 `getFaultReporterFromDriver()` (offset 0xd80).
   - Si `getFaultReporterFromDriver()` renvoie `nullptr` et que `ivars->_faultReporter` (offset 0x58) est nul, le kernel déclenche `panic("\"No ivars->_faultReporter\" @IO80211Controller.cpp:2877")`.
   - Création de la classe `QualcommFaultReporter` (dérivée d'`OSObject`), instanciée et renvoyée par `getFaultReporterFromDriver()`, satisfaisant l'invariant sans panique.

### Modifications apportées
- `QualcommWireless/include/IOKit/80211/IO80211WorkQueue.h`:
  - Déclaration de `IO80211WorkQueue` (dérivée d'`IOWorkLoop`) avec sa méthode statique `workQueue()`.
- `QualcommWireless/include/IOKit/80211/IO80211Controller.h`:
  - Inclusion de `IO80211WorkQueue.h`.
- `QualcommWifi/QualcommWifi.hpp`:
  - Déclaration de `QualcommFaultReporter : public OSObject`.
  - Ajout des membres `fWorkQueue` et `fFaultReporter`.
  - Déclaration des overrides `createWorkQueue()`, `getWorkQueue()` et `getFaultReporterFromDriver()`.
- `QualcommWifi/QualcommWifi.cpp`:
  - Implémentation de `createWorkQueue()`, `getWorkQueue()` et `getFaultReporterFromDriver()`.
  - Initialisation dans `init()` et libération dans `free()`.
  - Sécurisation du prologue de `QualcommWifi::start()` avant `super::start(provider)`.
- `QualcommWifi/Info.plist`:
  - Déclaration propre du kext Wi-Fi PCIe (`0x110717cb`), probe score 20000, et dépendances `IO80211Family`, `IONetworkingFamily`, `IOPCIFamily`.
- `build_wifi.sh`:
  - Script automatisé de compilation, assemblage firmware radio WCN7850, linkage et validation `kmutil`.

### Validation
- Compilation réussie avec `clang++` (-target x86_64-apple-macos15.0).
- Validation `kmutil libraries` réussie à 100% avec code retour 0 contre `/System/Library/KernelCollections/BootKernelExtensions.kc`.
- Aucune régression sur le Bluetooth (`QualcommWireless.kext`), testé et validé via `xcodebuild`.
This commit is contained in:
Erwan committed 2026-10-16 09:50:54 +02:00
1 parent 493c0989a1
commit 2dca4cd116
6 files changed
+179 -1

No files matched your search

+16
View File
@@ -174,8 +174,18 @@ struct mhi_ring_element {
#include <IOKit/80211/IO80211Controller.h>
#include <IOKit/80211/IO80211Interface.h>
#include <IOKit/80211/IO80211SkywalkInterface.h>
#include <IOKit/80211/IO80211WorkQueue.h>
#include "Firmware_WCN7850_Wifi.h"
// Classe FaultReporter pour satisfaire findAndAttachToFaultReporter sous macOS Tahoe
class QualcommFaultReporter : public OSObject {
OSDeclareDefaultStructors(QualcommFaultReporter)
public:
virtual bool init() override {
return OSObject::init();
}
};
class QualcommWifi : public IO80211Controller {
OSDeclareDefaultStructors(QualcommWifi)
@@ -204,6 +214,10 @@ private:
void *fDmaVirtAddr;
bool fDmaPrepared;
// Infrastructure macOS Tahoe IO80211Family
IO80211WorkQueue *fWorkQueue;
QualcommFaultReporter *fFaultReporter;
UInt32 read32(UInt32 offset);
void write32(UInt32 offset, UInt32 value);
@@ -237,6 +251,8 @@ public:
#if __IO80211_TARGET >= 260000
// macOS Tahoe 26.x (Darwin 25) Skywalk IO80211Controller overrides
virtual bool isCommandProhibited(int command) override;
virtual bool createWorkQueue(void) override;
virtual IO80211WorkQueue* getWorkQueue(void) const override;
virtual IOReturn handleCardSpecific(IO80211SkywalkInterface *iface, unsigned long req_type, void *req_data, bool isSet) override;
virtual UInt32 hardwareOutputQueueDepth(void) override;
virtual SInt32 performCountryCodeOperation(IO80211CountryCodeOp op) override;