Pile Wi-Fi Native macOS pour Qualcomm WCN7850

Ce document détaille l'implémentation de la pile Wi-Fi native (IO80211Controller) pour le chipset Qualcomm FastConnect 7800 (WCN7850) sous macOS Sequoia (Darwin 24).

1. Pourquoi le Wi-Fi Natif et non l'Émulation Ethernet ?

Dans les premières ébauches de pilotes non officiels pour macOS, certains projets choisissaient d'émuler une interface réseau filaire standard (IOEthernetController), en masquant les détails Wi-Fi dans un daemon externe (comme HeliPort).

Cependant, cette approche présente des limitations rédhibitoires :

❌ Pas d'intégration dans le menu Wi-Fi natif du Centre de Contrôle macOS.
❌ Absence de géolocalisation par points d'accès Wi-Fi (CoreLocation).
❌ Incompatibilité totale avec les services Apple (AirDrop, AirPlay, Continuité, Universal Control).
❌ Impossibilité pour les applications utilisant CoreWLAN.framework de découvrir les réseaux, obtenir le RSSI, ou basculer de canal.

QualcommWireless fait le choix d'une intégration 100% native en dérivant directement de IO80211Controller (de com.apple.iokit.IO80211Family).

2. Architecture de `QualcommWifi` (`IO80211Controller`)

graph TD
    subgraph AppleStack["Sous-Système Sans Fil Apple"]
        CC["Centre de Contrôle macOS"]
        CoreWLAN["CoreWLAN.framework"]
        AirportD["airportd (Daemon Système)"]
        Skywalk["Skywalk Family (Packet Pipeline)"]
        IO80211["IO80211Family (IO80211Controller / IO80211Interface)"]
    end

    subgraph Driver["QualcommWifi (Driver Kernel)"]
        IoctlHandler["Gestionnaire IOCTL Apple80211 (apple80211_ioctl)"]
        ScanEngine["Moteur de Scan (Passif / Actif / Multicanal)"]
        RingDMA["Gestionnaire DMA & Anneaux MHI (CR / ER / TR)"]
        FirmwarePipeline["Pipeline de Démarrage BHI / AMSS"]
        Windowing["Module Fenêtrage PCIe BAR0 (0x310c)"]
    end

    subgraph Hardware["Qualcomm WCN7850 (PCIe 0x17cb:0x1107)"]
        PBL["Primary Boot Loader (PBL)"]
        MHIHardware["MHI Engine (Modem Host Interface)"]
        WlanFirmware["Firmware AMSS Wi-Fi 7 (ath12k/WCN7850)"]
        MacPhy["MAC / Baseband PHY (802.11a/b/g/n/ac/ax/be)"]
    end

    CC --> AirportD
    CoreWLAN --> AirportD
    AirportD -->|apple80211_ioctl| IO80211
    Skywalk --> IO80211
    IO80211 --> IoctlHandler
    IoctlHandler --> ScanEngine
    ScanEngine --> RingDMA
    RingDMA --> Windowing
    FirmwarePipeline --> Windowing
    Windowing --> PBL
    PBL --> MHIHardware
    MHIHardware --> WlanFirmware
    WlanFirmware --> MacPhy

3. Communication Matérielle : MHI & Fenêtrage PCIe

3.1. Gestion du Fenêtrage PCIe BAR0

Le bus PCIe expose un espace MMIO BAR0 de 512 Ko. Or, les composants internes du WCN7850 (SoC, registres MHI, BHI, mémoires partagées) s'étendent sur plusieurs mégaoctets :

Registre de sélection de fenêtre : 0x310c (ATH12K_PCI_WINDOW_REG_ADDRESS).
Calcul de la fenêtre : Pour une adresse matérielle A \ge 512\text{ Ko}, le numéro de fenêtre est calculé par : \text{window} = (A \gg 19) \ \& \ 0x3F \text{offset} = 0x80000 \ | \ (A \ \& \ 0x7FFFF)
Le pilote met à jour dynamiquement fCurrWindow avant d'effectuer les écritures/lectures MMIO nécessaires.

3.2. Séquence de Boot MHI (Modem Host Interface)

Reset initial via ATH12K_PCI_SOC_GLOBAL_RESET (0x3008).
Boot Host Interface (BHI/BHIe) :
- Initialisation des vecteurs de transmission (ATH12K_BHIE_TXVECADDR_LOW / _HIGH).
- Transfert de l'image de firmware principale (amss.bin, taille ~6 Mo) et du fichier de calibration carte (board-2.bin, ~2.4 Mo).
- Validation de la signature et exécution dans le SoC WCN7850.
Transition d'environnement MHI :
- Transition de l'état PBL (Primary Boot Loader) vers AMSS (Advanced Mobile Subscriber Software).
- Configuration des anneaux MHI :
  - Command Ring (CR) : Envoi des requêtes d'initialisation WMI.
  - Event Ring (ER) : Réception asynchrone des événements et interruptions MSI-X.
  - Transfer Rings (TR) : Transmission et réception des paquets réseau 802.11.

4. Implémentation des IOCTLs Apple80211

Pour qu'un pilote soit reconnu par le sous-système Wi-Fi de macOS, il doit répondre aux requêtes de configuration apple80211_ioctl émises par airportd :

Opération IOCTL	Rôle dans le système macOS
`APPLE80211_IOC_SSID` (GET / SET)	Lecture et définition du réseau Wi-Fi cible.
`APPLE80211_IOC_SCAN_REQ_MULTIPLE`	Déclenchement d'un scan Wi-Fi (recherche des réseaux environnants pour l'interface graphique).
`APPLE80211_IOC_SCAN_RESULT`	Remontée unitaire ou groupée des points d'accès découverts (SSID, BSSID, RSSI, Beacon, Type de sécurité WPA2/WPA3).
`APPLE80211_IOC_BSSID_LIST`	Fourniture de la liste des BSSIDs disponibles dans le cache.
`APPLE80211_IOC_CHANNEL` (GET / SET)	Lecture et bascule de canal (2.4 GHz, 5 GHz, 6 GHz).
`APPLE80211_IOC_CHANNEL_INFO`	Enumération des canaux supportés (canaux 1 à 14, bandes 5 GHz UNII-1 à UNII-4, et canaux 6 GHz UNII-5 à UNII-8 pour le Wi-Fi 6E/7).
`APPLE80211_IOC_PHY_MODE`	Déclaration des modes PHY supportés (`APPLE80211_MODE_11BE`, `11AX`, `11AC`, `11N`, `11G`, `11A`, `11B`).
`APPLE80211_IOC_STATE`	État de la machine à états de l'interface (`RUN`, `INIT`, `SCAN`, `AUTH`, `ASSOC`).
`APPLE80211_IOC_RSSI`	Niveau de signal courant (en dBm, typiquement entre -30 dBm et -95 dBm).
`APPLE80211_IOC_RATE`	Débit négocié courant (jusqu'aux débits Wi-Fi 7 EHT MCS 0-13).
`APPLE80211_IOC_TXPOWER`	Puissance d'émission radio déclarée.

5. Prise en Charge du Wi-Fi 7 (802.11be)

La puce WCN7850 introduit les caractéristiques Wi-Fi 7 suivantes, intégrées dans la table des capacités du pilote :

Canaux 320 MHz ultra-larges en bande 6 GHz.
Modulation 4096-QAM (4K-QAM) augmentant la densité de données de 20% par rapport au 1024-QAM du Wi-Fi 6.
Multi-Link Operation (MLO) : Capacité matérielle d'agréger ou de basculer dynamiquement entre plusieurs bandes (ex. 5 GHz + 6 GHz) pour une latence ultra-faible.
Preamble Puncturing : Évitement automatique des sous-canaux brouillés pour maximiser la bande passante utilisable.

6.2 KiB Raw Blame History