Fichiers
2026-10-11 01:55:11 +02:00

Rapport d'Audit Technique : OS_station & Intégration Davis Vantage Pro2

Projet : Gastinel.Weather.169
Cible : Intégration Météorologique Davis Vantage Pro2 & Chaîne d'Acquisition
Date d'audit : 2026-08-28
Statut : Rapport d'audit de référence


1. Synthèse de l'Audit

L'audit technique approfondi de l'intégration de la station Davis Vantage Pro2 (VP2) et du périmètre logiciel /OS_station met en lumière :

  1. Une ambiguïté terminologique majeure dans le dépôt :
    • Dans la documentation initiale (README.md, architecture_station.md), OS_station désignait les démons Linux C++20 sur le Raspberry Pi 4 récepteur en vallée.
    • Dans la vue fonctionnelle de la chaîne météo, OS_station représente le moteur d'acquisition et d'ingestion météo de la Davis VP2 (site de la Moucherolle).
    • Clarification requise : Le décodage et l'acquisition radio Davis doivent s'exécuter directement sur le microcontrôleur STM32L4 du relais via son module CC1101 (comme module logiciel pur découplé), tandis que le service en vallée constitue la Station Réceptrice Domestique.
  2. Une validation radio rigoureuse du protocole Davis ISS (868 MHz) :
    • Le protocole radio direct (19.2 kbps 2-FSK, FHSS 5 canaux EU, trames de 14 octets dans l'air / 8 octets utiles, CRC-16 CCITT) est totalement rétro-ingénieré et testable à 100% sur machine hôte.
    • L'espacement des canaux européens n'est pas de 125 kHz mais de ~115.17 kHz (868.067 à 868.527 MHz).
  3. Une supériorité nette de la réception radio directe CC1101 :
    • Toute solution basée sur console Davis, datalogger USB ou WeatherLink en haute montagne est éliminée pour des raisons de consommation électrique excessive (> 50-150 mA continu vs < 2 µA en veille), de vulnérabilité thermique au gel et de coût superflu.

2. Audit de l'Existant dans le Dépôt pour OS_station

Élément État Réel Statut d'Audit Justification / Impact
Répertoire /OS_station Dossier vide sur le disque [MANQUANT] Aucun fichier de code ni de configuration présent.
Documentation /OS_station Documenté dans notes/architecture_station.md comme démon C++20 sur RPi 4 [CONTRADICTION] Confusion de nommage entre la Station Météo (source haute) et la Station Passerelle (RPi en vallée).
Moteur Davis dans OS_relais OS_relais/src/protocol/davis.rs & crc.rs déjà implémentés en Rust [VALIDÉ] Moteur pur sans dépendance matérielle, calcul CRC-16 et décodage vent/temp/hum/pluie fonctionnels.
Driver CC1101 dans OS_relais Trait Radio868Receiver défini [VALIDÉ] Abstraction claire séparant le matériel SPI du décodage métier.
Agrégateur Météo OS_relais/src/app/aggregator.rs implémenté [VALIDÉ] Moyenne glissante du vent, rafales maximales, cumul pluie, mémorisation température/humidité.
Schéma de Télémétrie 169 MHz OS_relais/src/protocol/telemetry.rs sérialise 33 octets avec CRC32 [VALIDÉ] Format compact, aligné et vérifié par tests unitaires.
Gestion des Erreurs Davis Compteurs de paquets reçus / manqués dans la télémétrie [VALIDÉ] Permet la surveillance de santé du lien 868 MHz depuis la vallée.

3. Analyse Comparative des Architectures d'Acquisition VP2

Pour récupérer les données de la Davis Vantage Pro2 sur le site autonome de la Grande Moucherolle, quatre voies techniques sont envisageables :

             ┌───────────────────────────────────────────────────────────┐
             │            DAVIS VANTAGE PRO2 ISS (868 MHz)               │
             └─────────────────────────────┬─────────────────────────────┘
                                           │
         ┌─────────────────────────────────┼─────────────────────────────────┐
         │                                 │                                 │
         ▼                                 ▼                                 ▼
   [OPTION 1 : RECOMMANDÉE]       [OPTION 2 : REJETÉE]             [OPTION 3 : REJETÉE]
   Réception Radio Directe        Console Davis + Datalogger       WeatherLink Live / IP
   Transceiver CC1101 SPI         USB/Série vers Microcontrôleur   vers Pont Réseau / SBC
   MCU STM32L4 (Rust no_std)      Console alimentée 24/7           Consommation > 200 mA continu
   Consommation : ~1.2 µA veille  Consommation : ~30-50 mA         Nécessite switch/routeur IP

Tableau Comparatif Exhaustif

Critère Option 1 : Réception Radio Directe CC1101 (Retenue) Option 2 : Console Davis + Datalogger Série/USB Option 3 : WeatherLink Live / Meteobridge Option 4 : ISS Câblée (Vantage Pro2 Cabled)
Matériel Requis Module CC1101 868 MHz (~5 €) + Antenne 868 MHz Console Davis (~350 €) + Logger USB/Série (~180 €) Passerelle WeatherLink Live (~300 €) + Switch IP ISS câblée spéciale + Carte d'acquisition ADC/UART
Protocole Trames RF DavisTalk 868 MHz (14 octets) Série 19200 bauds (trames LOOP 99 octets) API REST JSON locale sur Ethernet/WiFi Signaux électriques analogiques / impulsions
Complexité Logicielle Décodage FSK + Suivi FHSS (déjà écrit) Parsing de 99 octets LOOP + gestion handshake RTS/CTS Stack TCP/IP + client HTTP/JSON lourd Décodage signaux bruts potentiomètre + ILS
Coût Matériel Très faible (< 10 €) Élevé (~530 €) Élevé (~300–450 €) Moyen (~350 €)
Consommation Moyenne Ultra-faible (~1.2 µA veille, ~15 mA pendant 15 ms) Inacceptable sur batterie (~30 à 60 mA continu) Critique sur batterie (~150 à 300 mA continu) Faible (~5 mA continu)
Fiabilité en Montagne Maximale (0 pièce mécanique/écran, vernis tropicalisé) Faible (écran LCD gèle à -15°C, connecteurs fragiles) Faible (nombreux équipements réseau actifs) Moyenne (câble exposé au gel, foudre et rongeurs)
Dépendance Matériel Propriétaire Nulle (transceiver standard du marché) Totale (matériel Davis propriétaire obligatoire) Totale (serveurs Davis / firmware propriétaire) Partielle (capteurs Davis propriétaires)
Pertinence Site Isolé Excellente (100% adaptée) Inadaptée Inadaptée Inadaptée (longueur de mât/foudre)

Important

Recommandation Formelle : L'Option 1 (Réception Radio Directe CC1101) est la seule architecture viable pour garantir l'autonomie pluriannuelle sur batterie en site de haute montagne.


4. Vérification Critique des Hypothèses Techniques du Dépôt

Affirmation Documentaire Source Trouvée / Vérifiée Statut Explication Technique Conséquence pour le Projet
Fréquence 868 MHz Bande ISM Europe 868.0 – 868.6 MHz VALIDÉ Fréquence réglementaire européenne des stations Davis. CC1101 configuré en bande 868 MHz.
Débit 19 200 bps DavisTalk standard (GFSK/2-FSK) VALIDÉ Débit binaire nominal confirmé sur banc SDR et RFM69. Registres CC1101 MDMCFG3/MDMCFG4 calibrés à 19.2k.
Sync Word 0xCB89 dekay/DavisRFM69, rtl_433, captures SDR VALIDÉ Mot de synchronisation standard 16 bits de l'ISS Davis. Registres CC1101 SYNC1=0xCB, SYNC0=0x89.
Trames de 14 octets dans l'air / 8 octets utiles 4 octets préambule + 2 sync + 6 payload + 2 CRC VALIDÉ Le CC1101 filtre le préambule/sync et délivre 8 octets en FIFO. Buffer RX fixé à 8 octets utiles.
Cinq canaux européens espacés de 125 kHz Fréquences réelles : 868.067, 868.182, 868.297, 868.412, 868.527 MHz À CORRIGER L'espacement réel est de ~115.17 kHz, non de 125.0 kHz. Corriger la table de fréquence dans cc1101.rs.
Formule période FHSS : $T = \frac{41 + ID}{16}\text{ s}$ Firmware Davis ISS & DavisRFM69 VALIDÉ Période exacte de répétition selon l'ID DIP-switch (0 à 7). Horloge RTC calée sur 2.5625\text{ s} pour Station 1.
Algorithme CRC-16 CCITT (0x1021, init 0x0000) Spécification DavisTalk & crc.rs VALIDÉ Calcul CRC sur 6 octets, vérification sur 8 octets \rightarrow 0x0000. Algorithme dans crc.rs 100% conforme.
Fenêtre d'écoute de 12 à 20 ms Durée trame (5.83 ms) + dérive quartz (\pm 100\text{ }\mu\text{s}) + marge VALIDÉ Recommandation issue de l'audit relais confirmée. Paramétrage du timer de timeout écoute à 18 ms.

5. Découpage Architectural Global & Pipeline de Données

┌─────────────────────────────────────────────────────────────────────────────────────────────────┐
│                               SITE DE LA GRANDE MOUCHEROLLE                                     │
│                                                                                                 │
│  ┌───────────────────────┐                                                                      │
│  │ Davis Vantage Pro2 ISS│ (Émission RF 868 MHz - Toutes les ~2.56 s)                           │
│  └───────────┬───────────┘                                                                      │
│              │ Paquet RF brut 14 octets (2-FSK, FHSS)                                           │
│              ▼                                                                                  │
│  ┌───────────────────────┐                                                                      │
│  │ Transceiver CC1101    │ (Détection Sync Word 0xCB89, extraction FIFO 8 octets)               │
│  └───────────┬───────────┘                                                                      │
│              │ Buffer brut 8 octets (Payload + CRC)                                             │
│              ▼                                                                                  │
│  ┌────────────────────────────────────────────────────────────────────────┐                     │
│  │ FIRMWARE RELAIS STM32L476 (Rust no_std)                                │                     │
│  │                                                                        │                     │
│  │  1. Validation d'Intégrité : Contrôle CRC-16 Davis == 0x0000           │                     │
│  │  2. Moteur de Décodage Davis : Extraction Station ID, Vent, Capteurs   │                     │
│  │  3. Normalisation Interne : Conversion en unités fixes (deci-km/h, °C) │                     │
│  │  4. Filtrage & Rejet : Contrôle de plausibilité physique               │                     │
│  │  5. Agrégateur Météo (SRAM2) : Moyennes glissantes, rafales, pluie     │                     │
│  │  6. Planificateur RTC : Émission 169 MHz selon politique horaire       │                     │
│  │  7. Sérialiseur Télémétrie 169 MHz : Format compact 33 octets + CRC32  │                     │
│  └───────────────────────────────────┬────────────────────────────────────┘                     │
│                                      │ Trame binaire 169 MHz (33 octets)                        │
│                                      ▼                                                          │
│  ┌───────────────────────┐                                                                      │
│  │ Transceiver E32 169MHz│ (Émission VHF +27 dBm ERP max)                                       │
│  └───────────┬───────────┘                                                                      │
└──────────────┼──────────────────────────────────────────────────────────────────────────────────┘
               │
               │ Liaison Radio VHF 169 MHz (Traversée montagne -> vallée)
               ▼
┌─────────────────────────────────────────────────────────────────────────────────────────────────┐
│                               SITE DOMESTIQUE (VALLÉE)                                          │
│                                                                                                 │
│  ┌───────────────────────┐                                                                      │
│  │ Récepteur VHF 169 MHz │ (Module E32 ou CC1101 sur UART/USB)                                  │
│  └───────────┬───────────┘                                                                      │
│              │ Flux d'octets 169 MHz                                                            │
│              ▼                                                                                  │
│  ┌────────────────────────────────────────────────────────────────────────┐                     │
│  │ STATION RÉCEPTRICE (Raspberry Pi 4 - Debian ARM64)                     │                     │
│  │                                                                        │                     │
│  │  1. Réception & Dépilage : Détection préambule 'GW' (0x4757)           │                     │
│  │  2. Contrôle d'Intégrité : Validation CRC32 du paquet 169 MHz          │                     │
│  │  3. Horodatage Local : Timestamp UNIX haute précision                  │                     │
│  │  4. Tampon Local Persistant : Écriture SQLite immédiate (anti-coupure) │                     │
│  │  5. Service d'Export : Transmission réseau Ethernet RJ45 vers serveur  │                     │
│  └───────────────────────────────────┬────────────────────────────────────┘                     │
│                                      │ Paquets validés (JSON / MQTT / TCP)                      │
│                                      ▼                                                          │
│  ┌────────────────────────────────────────────────────────────────────────┐                     │
│  │ SERVEUR DOMESTIQUE (Base de Données InfluxDB / PostgreSQL & Grafana)   │                     │
│  └────────────────────────────────────────────────────────────────────────┘                     │
└─────────────────────────────────────────────────────────────────────────────────────────────────┘

Règle d'Étanchéité des Responsabilités

  1. Sur le Relais STM32 (Haut) :
    • Décode les trames Davis brutes, valide le CRC-16, convertit les grandeurs physiques en unités entières fixes.
    • Agrège les mesures (moyenne du vent, rafales, pluie) pour éviter d'émettre à 169 MHz à chaque tir Davis (économie d'énergie).
    • Ne connaît rien des protocoles IP (HTTP, MQTT, SQLite).
  2. Sur la Station Raspberry Pi 4 (Bas) :
    • Reçoit la télémétrie 169 MHz agrégée, valide le CRC-32.
    • Persiste localement en SQLite pour garantir le zéro-perte.
    • Assure la passerelle vers le réseau IP domestique.

6. Définition des Contrats d'Interfaces Logiciels

6.1. Abstraction de la Source Météo (WeatherSource)

/// Échantillon météorologique instantané décodé
#[derive(Copy, Clone, Debug, PartialEq)]
pub struct WeatherSample {
    pub station_id: u8,
    pub battery_low: bool,
    pub wind_speed_deci_kmh: u16,
    pub wind_direction_deg: u16,
    pub sensor_data: SensorReading,
}

#[derive(Copy, Clone, Debug, PartialEq)]
pub enum SensorReading {
    TemperatureCentiC(i16),
    HumidityPct(u8),
    RainTips(u16),
    WindGustDeciKmh(u16),
    SolarRadiation(u16),
    UvIndexDeci(u8),
    None,
}

/// Contrat d'une source météo physique ou émulée
pub trait WeatherSource {
    type Error;

    /// Prépare la réception sur le prochain canal attendu
    fn prepare_next_reception(&mut self) -> Result<(), Self::Error>;

    /// Capture un échantillon dans la fenêtre temporelle active
    fn poll_sample(&mut self) -> Result<Option<WeatherSample>, Self::Error>;

    /// Notifie le succès de synchronisation pour recalage de phase
    fn on_reception_success(&mut self, timestamp_us: u32);
}

6.2. Abstraction du Récepteur Matériel Davis (DavisRadioFrontend)

pub trait DavisRadioFrontend {
    type Error;

    fn set_frequency_hz(&mut self, freq_hz: u32) -> Result<(), Self::Error>;
    fn enter_rx_mode(&mut self) -> Result<(), Self::Error>;
    fn enter_sleep_mode(&mut self) -> Result<(), Self::Error>;
    fn read_raw_fifo(&mut self, buffer: &mut [u8; 8]) -> Result<bool, Self::Error>;
    fn get_last_rssi_dbm(&self) -> i8;
}

7. Stratégie de Test sur PC (Sans Matériel)

L'ensemble des composants critiques peut être validé sur machine hôte :

  1. Décodage des Trames Davis :
    • Test unitaire sur chaque type de capteur (0x8 température négative/positive, 0xA humidité 0-100%, 0xE augets de pluie, 0x9 rafales, 0x7 rayonnement).
    • Validation de la détection de batterie faible (bit 3 == 1).
  2. Contrôle CRC-16 Davis :
    • Vérification sur vecteurs réels connus.
    • Injection d'erreurs (modification bit à bit) et vérification du rejet systématique.
  3. Agrégateur Météo :
    • Simulation de séquences de 240 échantillons (10 minutes) avec calcul de moyennes, détection de rafale maximale et réinitialisation de fenêtre.
  4. Machine d'États FHSS (Sauts de fréquence) :
    • Simulation du calendrier de réveil, simulation de pertes de paquets consécutives et déclenchement automatique du mode resynchronisation après 10 tirs manqués.

8. Liste du Matériel Nécessaire pour le Prototypage

Obligatoire (Must-Have)

  1. Module Transceiver CC1101 868 MHz (avec quartz 26 MHz et antenne hélicoïdale/SMA 868 MHz) : Permet la réception physique des trames Davis.
  2. Carte de Développement STM32L476RG Nucleo-64 (ou carte custom STM32L476RGT6) : Cible d'exécution du firmware bare-metal.
  3. Module Émetteur/Récepteur EBYTE E32-170T30D-V2.0 (169 MHz, 30 dBm) + Antenne VHF 169 MHz : Validation de la liaison radio longue distance.
  4. Sonde de Débogage ST-LINK V2/V3 (intégrée sur la carte Nucleo) : Flashage et débogage matériel pas-à-pas.

Recommandé (Should-Have)

  1. Émetteur Météo de Test (ISS Davis VP2 réelle OU Émulateur RFM69/ESP32) : Génération de trames radio Davis réelles en continu en laboratoire.
  2. Clé SDR (ex. RTL-SDR v4 avec antenne télescopique) : Analyse spectrale 868 MHz / 169 MHz, vérification de la modulation FSK, des sauts FHSS et de la puissance RF via GQRX ou SDR++.
  3. Raspberry Pi 4 Model B (avec adaptateur USB/UART et alimentation officielle) : Validation de la station réceptrice domestique et du tampon SQLite.

Optionnel (Labo & Validation Avancée)

  1. Alimentation de Précision / Analyseur de Consommation (ex. Nordic PPK2 ou Otii Arc) : Mesure fine du profil de courant en mode Stop 2 (~1.2 µA) et pendant les impulsions RX/TX.
  2. Oscilloscope Numérique / Analyseur Logique (ex. Saleae Logic 8) : Décodage des bus SPI CC1101, UART E32 et timings des broches d'interruption GDO0 et AUX.