premier push
This commit is contained in:
nawrhehe committed
commit
b03b6c8197
405 files changed
+152754
No files matched your search
@@ -0,0 +1,116 @@
|
||||
# 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`)
|
||||
|
||||
```mermaid
|
||||
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)
|
||||
1. **Reset initial** via `ATH12K_PCI_SOC_GLOBAL_RESET` (`0x3008`).
|
||||
2. **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.
|
||||
3. **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.
|
||||
Reference in new issue
Block a user