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

Registre des Décisions d'Architecture (ADR) - Gastinel.Weather.169

Ce document consigne l'ensemble des décisions d'architecture prises pour le projet, leurs justifications et leurs statuts.


DEC-001

  • Date : 2026-08-28
  • Sujet : Nom du projet
  • Décision : Le projet de réseau de télécollecte météo est nommé Gastinel.Weather.169.
  • Justification : Identification claire du projet, de son domaine (météo) et de sa fréquence principale de transmission longue distance (169 MHz).
  • Statut : Validé

DEC-002

  • Date : 2026-08-28
  • Sujet : Topologie physique et chaîne de communication
  • Décision : Adopter une topologie matérielle à trois niveaux physiques :
    1. Relais autonome (STM32L476RGT6) sur le site isolé de la Grande Moucherolle ;
    2. Station de réception domestique (Raspberry Pi 4) en vallée ;
    3. Serveur domestique pour le stockage principal et le plan de contrôle.
  • Justification : Répond aux contraintes de site isolé (haute montagne, alimentation batterie, liaison VHF longue distance) et sépare la réception radio de la gestion pérenne des données.
  • Statut : Validé

DEC-003

  • Date : 2026-08-28
  • Sujet : Double chaîne radio sur le relais STM32
  • Décision : Utiliser deux modules radio distincts sur le relais :
    1. Un Texas Instruments CC1101 à 868 MHz dédié exclusivement à l'interception des trames Davis Vantage Pro2 ISS ;
    2. Un module 169 MHz (EBYTE E32-170T30D-V2.0 / CC1101 169 MHz) dédié à la liaison VHF descendante vers la station.
  • Justification : L'ISS émet nativement en 868 MHz FSK (norme européenne). La portée vers la vallée nécessite une fréquence plus basse et plus pénétrante (169 MHz VHF). La console Davis et son datalogger sont absents du site.
  • Statut : Validé

DEC-004

  • Date : 2026-08-28
  • Sujet : Organisation du dépôt et arborescence
  • Décision : Structurer le dépôt en 4 répertoires fondamentaux :
    • /OS_relais : Firmware bare-metal STM32.
    • /OS_station : Services Linux Raspberry Pi 4 (Debian ARM64 headless).
    • /surcouche : Définitions et modèles communs (télémétrie, commandes, configurations, sécurité).
    • /notes : Documentation d'architecture centralisée.
  • Justification : Assure une séparation nette des responsabilités, évite les dépendances circulaires et isole la documentation technique.
  • Statut : Validé

DEC-005

  • Date : 2026-08-28
  • Sujet : Choix des langages pour le relais STM32
  • Décision :
    • Langage principal : Rust (no_std).
    • Assembleur (ASM) : Uniquement de manière ciblée pour des accès bas niveau ou optimisations mesurables.
    • C / C++ : Utilisable ponctuellement pour des composants ou bibliothèques tierces si techniquement pertinent.
    • Python : Strictement réservé aux outils hors-firmware (simulateurs, tests, analyseurs de trames).
  • Justification : Rust offre la sécurité mémoire sans ramasse-miettes (déterminisme temps réel), tout en permettant une interopérabilité avec C et l'assembleur.
  • Statut : Validé

DEC-006

  • Date : 2026-08-28
  • Sujet : Choix des langages pour la station Raspberry Pi 4
  • Décision : C++ (C++20) est le langage privilégié pour les démons système principaux et la surcouche de la station. Python est utilisé pour les scripts auxiliaires et outils de test.
  • Justification : Robustesse, performance pour la gestion des flux d'E/S série/radio, et typage fort garantissant l'alignement binaire avec les structures partagées.
  • Statut : Validé

DEC-007

  • Date : 2026-08-28
  • Sujet : Environnement d'exécution du relais (Pas d'OS classique)
  • Décision : Fonctionnement en bare-metal strict sur le STM32, sans FreeRTOS, Zephyr ni Linux. Utilisation d'une couche système propriétaire légère (System Layer).
  • Justification : Réduction maximale de l'empreinte mémoire, maîtrise absolue de la consommation électrique et du temps passé en veille profonde, élimination des surcoûts d'ordonnancement non nécessaires.
  • Statut : Validé

DEC-008

  • Date : 2026-08-28
  • Sujet : Séparation en couches logicielles sur le relais
  • Décision : Respecter l'empilement strict : Application \rightarrow Protocole/Télémétrie \rightarrow Services Système \rightarrow Drivers \rightarrow Matériel.
  • Justification : Permet de tester le décodage Davis ou la logique de télémétrie indépendamment du matériel réel (sur banc PC), et d'interchanger les drivers matériels sans impacter la logique applicative.
  • Statut : Validé

DEC-009

  • Date : 2026-08-28
  • Sujet : Découplage entre acquisition et transmission
  • Décision : Dissocier formellement la fréquence d'acquisition météo (qui suit le rythme de l'ISS Davis à ~2.5s) de la fréquence de transmission radio 169 MHz (qui suit la politique horaire programmée, ex: 1 min ou 10 min).
  • Justification : L'émission radio VHF 169 MHz est le poste le plus énergivore du relais. L'acquisition et l'agrégation en mémoire vive consomment très peu d'énergie comparativement à l'émission.
  • Statut : Validé

DEC-010

  • Date : 2026-08-28
  • Sujet : Plan de contrôle et politique de transmission
  • Décision : Le serveur domestique constitue le plan de contrôle. Les politiques horaires de transmission sont définies sur le serveur, transmises au relais, et persistées localement dans le relais pour une exécution autonome basée sur sa RTC.
  • Justification : Garantit la résilience du relais qui continue d'émettre selon le dernier planning reçu même en cas de coupure de la liaison descendante ou du serveur.
  • Statut : Validé

DEC-011

  • Date : 2026-08-28
  • Sujet : Stockage tampon local sur la station Raspberry Pi 4
  • Décision : Implémenter un tampon local persistant sur le Raspberry Pi 4 pour conserver toutes les trames reçues en cas d'indisponibilité du serveur domestique ou du réseau Ethernet.
  • Justification : Évite toute perte de données météo lors des opérations de maintenance, pannes ou redémarrages du serveur central.
  • Statut : Validé

DEC-012

  • Date : 2026-08-28
  • Sujet : Stratégie de sécurité incrémentale (Priorité V1)
  • Décision : En version 1, ne pas implémenter de cryptographie complexe (pas de VERCORS, pas de double chiffrement, pas de crypto propriétaire). Se concentrer sur l'intégrité (CRC) et la validation syntaxique stricte. Prévoir l'architecture pour intégrer ultérieurement l'authentification et l'anti-rejeu.
  • Justification : Priorité absolue donnée à la validation de la chaîne radio, à la fiabilité de réception Davis et à la robustesse fonctionnelle avant d'introduire la complexité cryptographique.
  • Statut : Validé

DEC-013

  • Date : 2026-08-28
  • Sujet : Centralisation documentaire dans /notes
  • Décision : Toute la documentation d'architecture, les schémas, les arbitrages, les hypothèses et les questions ouvertes doivent impérativement résider dans /notes et ne pas être disséminés dans le code source.
  • Justification : Clarté du projet, traçabilité et séparation nette entre spécifications architecturales et code exécutable.
  • Statut : Validé

DEC-014

  • Date : 2026-08-28
  • Sujet : Règle de développement incrémental
  • Décision : Interdiction formelle de coder un composant significatif avant d'avoir présenté et validé son architecture, ses dépendances, ses interfaces, ses hypothèses, ses risques et ses tests.
  • Justification : Maintien d'un niveau maximal de rigueur, prévention de la dette technique et respect de la vision globale.
  • Statut : Validé

DEC-015

  • Date : 2026-08-28
  • Sujet : Modèle d'exécution interne du relais (Événementiel Réactif)
  • Décision : Structurer l'exécution interne de OS_relais autour d'un modèle événementiel réactif : routines d'interruption ultra-courtes (Short ISR), file d'événements circulaire statique (EventQueue), machine d'états applicative (FSM) et passage systématique en mode de sommeil profond (Stop 2 via WFI) dès qu'aucun événement n'est en attente.
  • Justification : Garantit une latence minimale de réaction aux événements radio/temporels, préserve une empreinte mémoire 100% statique et maximise le temps passé en sommeil ultra-basse consommation (~1.2 µA).
  • Statut : Validé

DEC-016

  • Date : 2026-08-28
  • Sujet : Séparation stricte HAL matérielle vs Services Système
  • Décision : Séparer formellement les abstractions matérielles sans état (/hal : GPIO, SPI, UART, ADC, Flash) des services système d'orchestration avec état (/services : PowerManager, ScheduleManager, StorageManager, WatchdogManager, DiagManager).
  • Justification : Modularité, portabilité, isolation des effets de bord et testabilité unitaire des services d'orchestration sur machine hôte.
  • Statut : Validé

DEC-017

  • Date : 2026-08-28
  • Sujet : Driver radio 169 MHz EBYTE E32-170T30D-V2.0
  • Décision : Traiter le module E32-170T30D comme un modem intelligent autonome piloté par une interface asynchrone UART couplée à 3 broches GPIO de contrôle (M0, M1 pour les modes, AUX pour le statut de disponibilité/fin d'émission RF). La puissance d'émission doit être calibrée pour respecter la limite réglementaire européenne ERP (typiquement +27 dBm / 500 mW ERP max sur 169.400–169.475 MHz).
  • Justification : Le module E32 intègre son propre microcontrôleur de gestion RF et un amplificateur capable de +30 dBm. Il ne doit pas être confondu avec un transceiver SPI nu, et sa puissance doit impérativement respecter la législation radio.
  • Statut : Validé

DEC-018

  • Date : 2026-08-28
  • Sujet : Isolation algorithmique du décodeur Davis
  • Décision : Le décodeur de trames Davis (/protocol/davis) est conçu comme un moteur algorithmique pur opérant sur des buffers d'octets bruts en mémoire vive, sans aucune dépendance directe vers le driver matériel CC1101 ou les périphériques SPI.
  • Justification : Permet de tester exhaustivement le décodage et la validation CRC de tous les types de paquets Davis (vent, pluie, température, humidité) sur PC via des outils de test Python ou tests unitaires Rust sans nécessiter le matériel physique.
  • Statut : Validé

DEC-019

  • Date : 2026-08-28
  • Sujet : Coupure matérielle d'alimentation des radios (Load Switches)
  • Décision : Prévoir dans l'architecture matérielle et logicielle des interrupteurs de puissance commandables (Load Switches / MOSFETs) pour couper physiquement l'alimentation des modules CC1101 et E32-170T30D pendant les phases de veille prolongée.
  • Justification : Élimine les courants de fuite résiduels des composants radio en veille pour garantir la pérennité de la batterie sur plusieurs années.
  • Statut : Validé

DEC-020

  • Date : 2026-08-28
  • Sujet : Stratégie Assembleur (ASM Strategy)
  • Décision : L'implémentation du firmware nominal du relais repose à 100% sur Rust no_std combiné au runtime cortex-m-rt et aux intrinsics Cortex-M (core::arch::arm). L'écriture manuelle d'assembleur n'est pas requise et ne sera introduite que si un besoin matériel non couvert par le compilateur est identifié.
  • Justification : L'audit technique a démontré que LLVM génère du code machine Cortex-M4 optimal et que l'ASM manuscrit n'apporte aucun gain mesurable de consommation ou d'espace tout en dégradant la sécurité mémoire.
  • Statut : Validé

DEC-021

  • Date : 2026-08-28
  • Sujet : Rétention mémoire en mode Stop 2 via allocation exclusive en SRAM2 (32 Ko)
  • Décision : Mapper l'ensemble des segments de mémoire vive nécessaires à l'exécution continue (pile principale MSP, segments .data, .bss, file d'événements EventQueue, accumulateurs météo, table de configuration) exclusivement dans la plage d'adresses de la SRAM2 (32 Ko - 0x10000000) via le linker script memory.x. Activer le bit RRS dans PWR_CR1.
  • Justification : Sur le microcontrôleur STM32L476RGT6, le mode de veille ultra-basse consommation Stop 2 coupe l'alimentation de la SRAM1 (96 Ko). Seule la SRAM2 est maintenue sous tension.
  • Statut : Validé

DEC-022

  • Date : 2026-08-28
  • Sujet : Dimensionnement de la fenêtre de réception radio Davis 868 MHz
  • Décision : Dimensionner la fenêtre temporelle d'écoute du CC1101 entre 12 ms et 20 ms lors des réveils périodiques synchronisés.
  • Justification : Un paquet Davis complet (14 octets @ 19.2 kbps) a une durée d'émission dans l'air de 5.83 ms. En intégrant les dérives d'oscillateurs en milieu montagnard (\pm 20\text{ ppm} sur une plage thermique de -20^\circ\text{C} à +30^\circ\text{C}), une marge d'anticipation de 3 ms et une marge de sécurité de 5 ms sont indispensables pour garantir un taux d'interception > 99\%.
  • Statut : Validé

DEC-023

  • Date : 2026-08-28
  • Sujet : Architecture de persistance Flash Ping-Pong A/B
  • Décision : Implémenter la persistance de la table de configuration sur deux pages Flash dédiées de 2 Ko (Slot A à 0x080FE000 et Slot B à 0x080FF000) selon un protocole Ping-Pong avec en-tête structuré, numéro de séquence monotone, contrôle CRC32 et programmation finale d'un mot double de validation (commit_mark = 0x55AA55AA_55AA55AA).
  • Justification : Immunise le firmware contre toute corruption de configuration lors d'une coupure brutale d'alimentation ou d'un redémarrage intempestif pendant une opération d'écriture Flash.
  • Statut : Validé

DEC-024

  • Date : 2026-08-28
  • Sujet : Modèle de synchronisation événementielle StaticEventQueue
  • Décision : Utiliser un tampon circulaire statique de 16 événements (StaticEventQueue<16>) sans allocation dynamique, partagé entre les interruptions courtes (ISRs) et la boucle principale via une section critique courte (cortex_m::interrupt::free).
  • Justification : Garantit un déterminisme temporel strict, aucune possibilité de panique mémoire, et respecte la philosophie "Short ISR" (aucun traitement lourd en contexte d'interruption).
  • Statut : Validé

DEC-025

  • Date : 2026-08-28
  • Sujet : Parking analogique des broches GPIO et séquence de sommeil Stop 2
  • Décision : Avant chaque entrée en mode Stop 2, le PowerManager reconfigure l'ensemble des broches GPIO non critiques en mode Analogique sans résistance de tirage (Analog / No-Pull). Seules les broches d'interruption de réveil (GDO0, AUX) conservent leur configuration active.
  • Justification : Élimine les courants de fuite parasites sur les broches flottantes et garantit d'atteindre le courant de veille théorique du STM32L4 (\sim 1.2\text{ }\mu\text{A}).
  • Statut : Validé

DEC-026

  • Date : 2026-08-28
  • Sujet : Moteur de politiques horaires ScheduleManager et mode de repli
  • Décision : Représenter la politique de transmission sous forme d'une table binaire compacte contenant jusqu'à 4 règles de plages horaires associées à des intervalles en secondes. En cas d'invalidation de la table ou de perte de synchronisation RTC, le système bascule automatiquement sur un intervalle de sécurité fixe de 600 secondes (10 minutes).
  • Justification : Offre la flexibilité demandée (ex: 1 min entre 06h et 08h, 10 min le reste du temps) tout en assurant un comportement prévisible et robuste en cas de défaillance réseau.
  • Statut : Validé

DEC-027

  • Date : 2026-08-28
  • Sujet : Mode d'acquisition des données Davis Vantage Pro2 ISS
  • Décision : L'acquisition des données météorologiques de l'ISS Davis s'effectue exclusivement par interception radio directe des trames 868 MHz (DavisTalk) via le transceiver CC1101 piloté par le microcontrôleur STM32L4. Toute utilisation de console Davis, datalogger USB/série ou passerelle WeatherLink sur le site isolé de la Grande Moucherolle est formellement exclue.
  • Justification : Une console ou une passerelle réseau consomme entre 30 mA et 200 mA en continu et ne résiste pas au gel sévère (-20°C). L'interception radio directe permet de maintenir le système en sommeil profond Stop 2 à ~1.2 µA avec des réveils de 15 ms, garantissant une autonomie pluriannuelle sur batterie.
  • Statut : Validé

DEC-028

  • Date : 2026-08-28
  • Sujet : Paramètres RF et plan de fréquences Davis Europe 868 MHz
  • Décision : Configurer le CC1101 pour la modulation 2-FSK à 19 200 bps, Sync Word 0xCB89, et utiliser le plan de fréquences officiel européen à 5 canaux : 868.066711 MHz (ch 0), 868.181885 MHz (ch 1), 868.297119 MHz (ch 2), 868.412292 MHz (ch 3), 868.527466 MHz (ch 4), avec une séquence de saut [0, 2, 4, 1, 3].
  • Justification : Corrige l'hypothèse erronée d'un espacement régulier de 125 kHz. L'espacement réel est de ~115.17 kHz.
  • Statut : Validé

DEC-029

  • Date : 2026-08-28
  • Sujet : Frontières de responsabilités logicielles Relais vs Station
  • Décision : Le microcontrôleur STM32 du Relais assure l'acquisition radio 868 MHz, la validation CRC-16 Davis, le décodage physique, l'agrégation glissante (vent, rafales, pluie) et la transmission 169 MHz. La Station Raspberry Pi 4 assure la réception 169 MHz, la validation CRC-32, l'horodatage haute précision, le stockage tampon anti-coupure SQLite et la passerelle réseau IP.
  • Justification : Évite d'émettre par radio 169 MHz à chaque tir Davis (économie majeure d'énergie) et isole totalement les couches radio temps réel des couches réseau IP.
  • Statut : Validé

DEC-030

  • Date : 2026-08-28
  • Sujet : Représentation numérique en virgule fixe pour la télémétrie météo
  • Décision : Exprimer l'ensemble des grandeurs physiques sous forme d'entiers à virgule fixe dans le firmware du relais et les trames de télémétrie : température en centièmes de °C (i16), vent et rafales en dixièmes de km/h (u16), direction en degrés entiers (u16), pluviosité en nombre d'augets basculants (u16).
  • Justification : Élimine les imprécisions d'arrondi des nombres flottants, garantit un déterminisme binaire absolu entre architectures (ARM Cortex-M4 et ARM64 RPi) et compacte la charge utile transmise par radio.
  • Statut : Validé