Fichiers
radio/Gastinel.Weather.169/notes/surcouche.md
T
2026-10-11 01:55:11 +02:00

Architecture de la Surcouche Commune - /surcouche

1. Rôle et Définition de la Surcouche

La surcouche constitue le socle logique partagé entre le relais (STM32), la station (Raspberry Pi 4) et le serveur domestique.

Elle définit les contrats de données, la sémantique des échanges, les modèles de télémétrie, les structures de commandes, les politiques de configuration ainsi que le cadre d'évolution de la sécurité.

Elle est conçue pour être indépendante du transport physique sous-jacent et des particularités matérielles de chaque nœud.

┌─────────────────────────────────────────────────────────────┐
│                     SURCOUCHE COMMUNE                       │
│                                                             │
│  ┌───────────────────────┐       ┌───────────────────────┐  │
│  │   Télémétrie Météo    │       │  Télémétrie Système   │  │
│  │   (Mesures physiques) │       │   (Santé, Énergie)    │  │
│  └───────────────────────┘       └───────────────────────┘  │
│                                                             │
│  ┌───────────────────────┐       ┌───────────────────────┐  │
│  │     Commandes &       │       │      Politiques       │  │
│  │     Contrôle          │       │    de Transmission    │  │
│  └───────────────────────┘       └───────────────────────┘  │
│                                                             │
│  ┌───────────────────────┐       ┌───────────────────────┐  │
│  │   Synchronisation &   │       │   Cadre d'Évolution   │  │
│  │      Diagnostics      │       │     de la Sécurité    │  │
│  └───────────────────────┘       └───────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

2. Domaines Fonctionnels

2.1. Télémétrie Météorologique

Modélise les grandeurs physiques collectées depuis l'ISS Davis Vantage Pro2 :

  • Vent : Vitesse instantanée, vitesse moyenne sur l'intervalle, rafale maximale (gust), direction du vent (0-359°).
  • Température & Humidité : Température extérieure (°C / centièmes de °C), humidité relative (%).
  • Pluviosité : Nombre d'augets basculants (rain counter), intensité de précipitation (rain rate).
  • Pression Barométrique (si capteur présent/reçu) : Pression atmosphérique absolue et tendance.
  • Rayonnement & UV (si capteurs présents) : Rayonnement solaire (W/m^2), index UV.
  • Métadonnées de mesure : Horodatage, identifiant de la station émettrice, indicateurs de validité/qualité par grandeur.

2.2. Télémétrie Système et Diagnostics

Fournit une visibilité complète sur la santé opérationnelle du relais isolé :

  • Énergie & Alimentation : Tension de la batterie (mV), état de décharge estimé.
  • Thermique : Température interne du microcontrôleur STM32.
  • Performances Radio 868 MHz (Davis) : Nombre de paquets reçus, paquets manqués, CRC erronés, RSSI moyen.
  • Performances Radio 169 MHz : Nombre de transmissions effectuées, taux de réémissions, puissance d'émission configurée.
  • État d'Exécution : Compteur de réveils (wake-up count), temps passé en veille vs temps actif, cause du dernier reset (IWDG, BOR, POR, logiciel).

2.3. Politiques de Transmission (Transmission Policies)

Définit la planification temporelle des émissions radio 169 MHz du relais vers la station :

  • Une politique est représentée par une table de règles associant des plages horaires (heure de début \rightarrow heure de fin) à un intervalle d'émission.
  • Exemple de politique nominale :
    • 00:00 → 05:59 : Intervalle de transmission = 10 minutes
    • 06:00 → 07:59 : Intervalle de transmission = 1 minute (surveillance renforcée au lever du jour)
    • 08:00 → 23:59 : Intervalle de transmission = 10 minutes
  • Persistance : Cette structure de configuration doit pouvoir être sérialisée pour être transmise par radio et sauvegardée de manière non-volatile sur le relais.

2.4. Commandes & Plan de Contrôle

Définit le catalogue des actions pilotables à distance depuis le serveur :

  • SET_TRANSMISSION_POLICY : Téléversement d'une nouvelle table de politique horaire.
  • FORCE_TRANSMISSION : Demande d'émission immédiate des dernières mesures stockées.
  • GET_DIAGNOSTICS : Demande d'un rapport de santé système détaillé.
  • SYSTEM_RESET : Demande de redémarrage logiciel contrôlé du relais.
  • SET_RADIO_PARAMS : Ajustement de paramètres radio (canal 169 MHz, puissance d'émission).

2.5. Synchronisation Temporelle

  • Mécanisme d'alignement de l'horloge temps réel (RTC) du relais avec l'heure exacte de la station/serveur (temps UTC).
  • Garantit la cohérence des horodatages et l'application précise des plages horaires de transmission.

3. Modèle de Trame & Évolution de la Sécurité

3.1. Structure Logique Générique d'un Message

Chaque message échangé sur la liaison 169 MHz est composé selon un schéma standardisé :

┌──────────────┬──────────────┬──────────────┬──────────────┬──────────────┐
│  En-tête     │  Contrôle /  │  Type de     │  Charge      │  Contrôle    │
│  Réseau      │  Sécurité    │  Message     │  Utile       │  d'Intégrité │
│  (Sync, ID)  │  (Seq, Flags)│  (Msg Type)  │  (Payload)   │  (CRC / MAC) │
└──────────────┴──────────────┴──────────────┴──────────────┴──────────────┘
  • En-tête Réseau : Octets de synchronisation, identifiant réseau (Network ID), identifiant source/destination.
  • Contrôle & Sécurité : Numéro de séquence incrémental (anti-perte, anti-doublon), drapeaux de statut, champs réservés pour la sécurité future.
  • Type de Message : Télémétrie météo, Télémétrie système, Commande, Acquittement, Configuration.
  • Charge Utile (Payload) : Données binaires compactes sérialisées.
  • Contrôle d'Intégrité : Somme de contrôle (CRC16/CRC32 en V1).

3.2. Stratégie d'Évolution Sécuritaire

Conformément aux décisions d'architecture :

  1. Version 1 (Prototype initial) :

    • Priorité au bon fonctionnement radio, à l'acquisition Davis et à la fiabilité des transmissions.
    • Validation d'intégrité via CRC.
    • Vérification des limites et de la cohérence de chaque champ reçu avant toute action.
    • Pas de cryptographie complexe (ni VERCORS, ni chiffrement propriétaire).
  2. Évolutions futures (V2+) :

    • Les champs d'en-tête sont dimensionnés pour accueillir ultérieurement :
      • Un vecteur d'anti-rejeu strict (compteur monotone / timestamp vérifié).
      • Un code d'authentification de message (ex. HMAC-SHA256 ou AES-CMAC).
      • Une gestion formelle des clés et des permissions d'exécution des commandes.