Premier commit
Cette révision appartient à :
révision
aee5ad5442
118 fichiers modifiés
+16226
Aucun fichier ne correspond à votre recherche
@@ -0,0 +1,66 @@
|
||||
|
||||
# --- double-push : exclusions generiques (secrets, builds, binaires, gros fichiers) ---
|
||||
target/
|
||||
node_modules/
|
||||
build/
|
||||
build-*/
|
||||
dist/
|
||||
out/
|
||||
.gradle/
|
||||
.idea/
|
||||
venv/
|
||||
.venv/
|
||||
env/
|
||||
__pycache__/
|
||||
*.pyc
|
||||
.cache/
|
||||
.next/
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
accounts.json
|
||||
Clee.API/
|
||||
*.pem
|
||||
*.key
|
||||
*.p12
|
||||
*.pfx
|
||||
*.jks
|
||||
*.keystore
|
||||
keystore.properties
|
||||
id_rsa*
|
||||
id_ed25519*
|
||||
*.kdbx
|
||||
*.odt
|
||||
*.sqlite
|
||||
*.sqlite3
|
||||
*.db
|
||||
*.log
|
||||
*.exe
|
||||
*.dll
|
||||
*.msi
|
||||
*.jar
|
||||
*.zip
|
||||
*.7z
|
||||
*.rar
|
||||
*.tar
|
||||
*.tar.gz
|
||||
*.tgz
|
||||
*.gguf
|
||||
*.safetensors
|
||||
*.onnx
|
||||
*.pt
|
||||
*.pth
|
||||
*.bin
|
||||
*.iso
|
||||
*.gws
|
||||
*.apk
|
||||
*.aab
|
||||
*.so
|
||||
*.o
|
||||
*.a
|
||||
*.lib
|
||||
*.pdb
|
||||
*.mp4
|
||||
*.mkv
|
||||
*.wav
|
||||
*.flac
|
||||
@@ -0,0 +1,7 @@
|
||||
[target.thumbv7em-none-eabihf]
|
||||
rustflags = [
|
||||
"-C", "link-arg=-Tlink.x",
|
||||
]
|
||||
|
||||
[build]
|
||||
target = "thumbv7em-none-eabihf"
|
||||
+196
@@ -0,0 +1,196 @@
|
||||
# This file is automatically @generated by Cargo.
|
||||
# It is not intended for manual editing.
|
||||
version = 4
|
||||
|
||||
[[package]]
|
||||
name = "bare-metal"
|
||||
version = "0.2.5"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "5deb64efa5bd81e31fcd1938615a6d98c82eafcbcd787162b6f63b91d6bac5b3"
|
||||
dependencies = [
|
||||
"rustc_version",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "bitfield"
|
||||
version = "0.13.2"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "46afbd2983a5d5a7bd740ccb198caf5b82f45c40c09c0eed36052d91cb92e719"
|
||||
|
||||
[[package]]
|
||||
name = "cortex-m"
|
||||
version = "0.7.9"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "844b9697e922c99847eed515c6eb6d101e7ce62ff556fcaec243798291427ee8"
|
||||
dependencies = [
|
||||
"bare-metal",
|
||||
"bitfield",
|
||||
"cortex-m-macros",
|
||||
"critical-section",
|
||||
"embedded-hal 0.2.7",
|
||||
"embedded-hal 1.0.0",
|
||||
"volatile-register",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "cortex-m-macros"
|
||||
version = "0.7.8"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "6d1922be58519ad40368fc4ca595a2cefa51a7abf947be3b0c90586dc7dbd0e2"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"syn",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "cortex-m-rt"
|
||||
version = "0.7.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "9c439b23bf18154d8a634543caf1ee73cceb723f2902f7ea243634159a00fd47"
|
||||
dependencies = [
|
||||
"cortex-m-rt-macros",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "cortex-m-rt-macros"
|
||||
version = "0.7.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "061a75f3e7f3f01d649668d68e02d0ef92c7041a9c97b8fe6bc354ddbf40822d"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"syn",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "critical-section"
|
||||
version = "1.2.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "790eea4361631c5e7d22598ecd5723ff611904e3344ce8720784c93e3d83d40b"
|
||||
|
||||
[[package]]
|
||||
name = "embedded-hal"
|
||||
version = "0.2.7"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "35949884794ad573cf46071e41c9b60efb0cb311e3ca01f7af807af1debc66ff"
|
||||
dependencies = [
|
||||
"nb 0.1.3",
|
||||
"void",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "embedded-hal"
|
||||
version = "1.0.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "361a90feb7004eca4019fb28352a9465666b24f840f5c3cddf0ff13920590b89"
|
||||
|
||||
[[package]]
|
||||
name = "nb"
|
||||
version = "0.1.3"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "801d31da0513b6ec5214e9bf433a77966320625a37860f910be265be6e18d06f"
|
||||
dependencies = [
|
||||
"nb 1.1.0",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "nb"
|
||||
version = "1.1.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "8d5439c4ad607c3c23abf66de8c8bf57ba8adcd1f129e699851a6e43935d339d"
|
||||
|
||||
[[package]]
|
||||
name = "os_relais"
|
||||
version = "0.1.0"
|
||||
dependencies = [
|
||||
"cortex-m",
|
||||
"cortex-m-rt",
|
||||
"panic-halt",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "panic-halt"
|
||||
version = "0.2.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "de96540e0ebde571dc55c73d60ef407c653844e6f9a1e2fdbd40c07b9252d812"
|
||||
|
||||
[[package]]
|
||||
name = "proc-macro2"
|
||||
version = "1.0.107"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
|
||||
dependencies = [
|
||||
"unicode-ident",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "quote"
|
||||
version = "1.0.47"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "rustc_version"
|
||||
version = "0.2.3"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "138e3e0acb6c9fb258b19b67cb8abd63c00679d2851805ea151465464fe9030a"
|
||||
dependencies = [
|
||||
"semver",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "semver"
|
||||
version = "0.9.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "1d7eb9ef2c18661902cc47e535f9bc51b78acd254da71d375c2f6720d9a40403"
|
||||
dependencies = [
|
||||
"semver-parser",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "semver-parser"
|
||||
version = "0.7.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "388a1df253eca08550bef6c72392cfe7c30914bf41df5269b68cbd6ff8f570a3"
|
||||
|
||||
[[package]]
|
||||
name = "syn"
|
||||
version = "2.0.119"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"unicode-ident",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "unicode-ident"
|
||||
version = "1.0.24"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
|
||||
|
||||
[[package]]
|
||||
name = "vcell"
|
||||
version = "0.1.3"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "77439c1b53d2303b20d9459b1ade71a83c716e3f9c34f3228c00e6f185d6c002"
|
||||
|
||||
[[package]]
|
||||
name = "void"
|
||||
version = "1.0.2"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "6a02e4885ed3bc0f2de90ea6dd45ebcbb66dacffe03547fadbb0eeae2770887d"
|
||||
|
||||
[[package]]
|
||||
name = "volatile-register"
|
||||
version = "0.2.2"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "de437e2a6208b014ab52972a27e59b33fa2920d3e00fe05026167a1c509d19cc"
|
||||
dependencies = [
|
||||
"vcell",
|
||||
]
|
||||
@@ -0,0 +1,31 @@
|
||||
[package]
|
||||
name = "os_relais"
|
||||
version = "0.1.0"
|
||||
edition = "2021"
|
||||
authors = ["Gastinel.Weather.169 Team"]
|
||||
description = "Bare-metal no_std firmware for STM32L476RGT6 weather relay node"
|
||||
|
||||
[lib]
|
||||
name = "os_relais"
|
||||
path = "src/lib.rs"
|
||||
|
||||
[[bin]]
|
||||
name = "os_relais"
|
||||
path = "src/main.rs"
|
||||
test = false
|
||||
bench = false
|
||||
|
||||
[dependencies]
|
||||
cortex-m = { version = "0.7.7", features = ["critical-section-single-core"] }
|
||||
cortex-m-rt = "0.7.3"
|
||||
panic-halt = "0.2.0"
|
||||
|
||||
[profile.dev]
|
||||
opt-level = 1
|
||||
lto = false
|
||||
|
||||
[profile.release]
|
||||
opt-level = "s"
|
||||
lto = true
|
||||
codegen-units = 1
|
||||
panic = "abort"
|
||||
@@ -0,0 +1,21 @@
|
||||
use std::env;
|
||||
use std::fs::File;
|
||||
use std::io::Write;
|
||||
use std::path::PathBuf;
|
||||
|
||||
fn main() {
|
||||
// Put `memory.x` in our output directory and ensure it's
|
||||
// on the linker search path.
|
||||
let out = &PathBuf::from(env::var_os("OUT_DIR").unwrap());
|
||||
File::create(out.join("memory.x"))
|
||||
.unwrap()
|
||||
.write_all(include_bytes!("memory.x"))
|
||||
.unwrap();
|
||||
println!("cargo:rustc-link-search={}", out.display());
|
||||
|
||||
// By default, Cargo will re-run a build script whenever
|
||||
// any file in the project changes. By specifying `memory.x`
|
||||
// here, we ensure the build script is only re-run when
|
||||
// `memory.x` is changed.
|
||||
println!("cargo:rerun-if-changed=memory.x");
|
||||
}
|
||||
@@ -0,0 +1,20 @@
|
||||
/* Linker script STM32L476RGT6 optimisé pour la rétention Stop 2 */
|
||||
MEMORY
|
||||
{
|
||||
/* Mémoire Flash programme (1020 Ko) */
|
||||
FLASH (rx) : ORIGIN = 0x08000000, LENGTH = 1020K
|
||||
|
||||
/* Pages Flash réservées pour la persistance Ping-Pong A/B (2 x 2 Ko) */
|
||||
FLASH_STORAGE_A (r) : ORIGIN = 0x080FE000, LENGTH = 2K
|
||||
FLASH_STORAGE_B (r) : ORIGIN = 0x080FF000, LENGTH = 2K
|
||||
|
||||
/* SRAM2 (32 Ko) : Conservée sous tension en mode Stop 2 (PWR_CR1.RRS = 1) */
|
||||
/* Héberge la pile MSP, les segments .data et .bss ainsi que l'EventQueue */
|
||||
RAM (rwx) : ORIGIN = 0x10000000, LENGTH = 32K
|
||||
|
||||
/* SRAM1 (96 Ko) : Non conservée en Stop 2 - réservée pour buffers volatils */
|
||||
SRAM1 (rwx) : ORIGIN = 0x20000000, LENGTH = 96K
|
||||
}
|
||||
|
||||
/* Positionnement de la pile au sommet de la SRAM2 */
|
||||
_stack_start = ORIGIN(RAM) + LENGTH(RAM);
|
||||
@@ -0,0 +1,145 @@
|
||||
//! Agrégation glissante des mesures météorologiques (min, max, moyennes, augets pluie)
|
||||
|
||||
use crate::protocol::davis::{DavisMeasurement, DavisPayload};
|
||||
|
||||
/// Agrégateur de mesures météorologiques en mémoire vive (SRAM2)
|
||||
#[derive(Copy, Clone, Debug, PartialEq)]
|
||||
pub struct WeatherAggregator {
|
||||
wind_speed_sum: u32,
|
||||
wind_samples_count: u16,
|
||||
max_gust_mph: u8,
|
||||
last_wind_dir_deg: u16,
|
||||
last_temp_centi_c: i16,
|
||||
last_humidity_pct: u8,
|
||||
total_rain_tips: u16,
|
||||
has_valid_temp: bool,
|
||||
has_valid_hum: bool,
|
||||
}
|
||||
|
||||
impl WeatherAggregator {
|
||||
/// Crée un agrégateur réinitialisé
|
||||
pub const fn new() -> Self {
|
||||
Self {
|
||||
wind_speed_sum: 0,
|
||||
wind_samples_count: 0,
|
||||
max_gust_mph: 0,
|
||||
last_wind_dir_deg: 0,
|
||||
last_temp_centi_c: 0,
|
||||
last_humidity_pct: 0,
|
||||
total_rain_tips: 0,
|
||||
has_valid_temp: false,
|
||||
has_valid_hum: false,
|
||||
}
|
||||
}
|
||||
|
||||
/// Intègre une nouvelle mesure reçue de l'ISS Davis
|
||||
pub fn update(&mut self, m: &DavisMeasurement) {
|
||||
// Mise à jour continue du vent instantané
|
||||
self.wind_speed_sum = self.wind_speed_sum.saturating_add(m.wind_speed_mph as u32);
|
||||
self.wind_samples_count = self.wind_samples_count.saturating_add(1);
|
||||
self.last_wind_dir_deg = m.wind_direction_deg;
|
||||
|
||||
if m.wind_speed_mph > self.max_gust_mph {
|
||||
self.max_gust_mph = m.wind_speed_mph;
|
||||
}
|
||||
|
||||
match m.payload {
|
||||
DavisPayload::WindGust { gust_speed_mph } => {
|
||||
if gust_speed_mph > self.max_gust_mph {
|
||||
self.max_gust_mph = gust_speed_mph;
|
||||
}
|
||||
}
|
||||
DavisPayload::Temperature { temp_centi_celsius } => {
|
||||
self.last_temp_centi_c = temp_centi_celsius;
|
||||
self.has_valid_temp = true;
|
||||
}
|
||||
DavisPayload::Humidity { relative_humidity_pct } => {
|
||||
self.last_humidity_pct = relative_humidity_pct;
|
||||
self.has_valid_hum = true;
|
||||
}
|
||||
DavisPayload::Rain { tip_count } => {
|
||||
self.total_rain_tips = tip_count;
|
||||
}
|
||||
DavisPayload::SolarRadiation { .. } => {}
|
||||
DavisPayload::UvIndex { .. } => {}
|
||||
DavisPayload::Unknown { .. } => {}
|
||||
}
|
||||
}
|
||||
|
||||
/// Calcule la vitesse moyenne du vent sur l'intervalle en dixièmes de km/h (1 mph ≈ 1.60934 km/h)
|
||||
pub fn average_wind_deci_kmh(&self) -> u16 {
|
||||
if self.wind_samples_count == 0 {
|
||||
return 0;
|
||||
}
|
||||
let avg_mph = (self.wind_speed_sum as f32) / (self.wind_samples_count as f32);
|
||||
(avg_mph * 16.0934) as u16
|
||||
}
|
||||
|
||||
/// Calcule la rafale maximale du vent en dixièmes de km/h
|
||||
pub fn max_gust_deci_kmh(&self) -> u16 {
|
||||
((self.max_gust_mph as f32) * 16.0934) as u16
|
||||
}
|
||||
|
||||
pub fn last_wind_dir_deg(&self) -> u16 {
|
||||
self.last_wind_dir_deg
|
||||
}
|
||||
|
||||
pub fn last_temp_centi_c(&self) -> i16 {
|
||||
self.last_temp_centi_c
|
||||
}
|
||||
|
||||
pub fn last_humidity_pct(&self) -> u8 {
|
||||
self.last_humidity_pct
|
||||
}
|
||||
|
||||
pub fn total_rain_tips(&self) -> u16 {
|
||||
self.total_rain_tips
|
||||
}
|
||||
|
||||
/// Réinitialise les accumulateurs glissants après une transmission 169 MHz réussie
|
||||
pub fn reset_window(&mut self) {
|
||||
self.wind_speed_sum = 0;
|
||||
self.wind_samples_count = 0;
|
||||
self.max_gust_mph = 0;
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn test_aggregator_wind_averaging_and_reset() {
|
||||
let mut agg = WeatherAggregator::new();
|
||||
assert_eq!(agg.average_wind_deci_kmh(), 0);
|
||||
|
||||
let m1 = DavisMeasurement {
|
||||
station_id: 0,
|
||||
battery_low: false,
|
||||
wind_speed_mph: 10,
|
||||
wind_direction_deg: 90,
|
||||
payload: DavisPayload::WindGust { gust_speed_mph: 15 },
|
||||
};
|
||||
let m2 = DavisMeasurement {
|
||||
station_id: 0,
|
||||
battery_low: false,
|
||||
wind_speed_mph: 20,
|
||||
wind_direction_deg: 180,
|
||||
payload: DavisPayload::WindGust { gust_speed_mph: 25 },
|
||||
};
|
||||
|
||||
agg.update(&m1);
|
||||
agg.update(&m2);
|
||||
|
||||
// Moyenne = 15 mph ≈ 241 deci-km/h (24.1 km/h)
|
||||
assert_eq!(agg.average_wind_deci_kmh(), 241);
|
||||
// Rafale max = 25 mph ≈ 402 deci-km/h (40.2 km/h)
|
||||
assert_eq!(agg.max_gust_deci_kmh(), 402);
|
||||
assert_eq!(agg.last_wind_dir_deg(), 180);
|
||||
|
||||
agg.reset_window();
|
||||
assert_eq!(agg.average_wind_deci_kmh(), 0);
|
||||
assert_eq!(agg.max_gust_deci_kmh(), 0);
|
||||
assert_eq!(agg.last_wind_dir_deg(), 180); // Conservé
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,7 @@
|
||||
//! Couche applicative haute (Machine d'États FSM, Agrégation météo)
|
||||
|
||||
pub mod aggregator;
|
||||
pub mod state_machine;
|
||||
|
||||
pub use aggregator::WeatherAggregator;
|
||||
pub use state_machine::{RelayAction, RelayState, RelayStateMachine};
|
||||
@@ -0,0 +1,208 @@
|
||||
//! Machine d'États Principale du Relais (FSM Applicative)
|
||||
//!
|
||||
//! Orchestre les cycles d'écoute Davis 868 MHz, de transmission 169 MHz,
|
||||
//! d'écoute descendante et de veille profonde Stop 2 sans dépendance matérielle.
|
||||
|
||||
use crate::events::SystemEvent;
|
||||
|
||||
/// États opérationnels de la machine d'états principale
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum RelayState {
|
||||
Boot,
|
||||
Init,
|
||||
DavisScan,
|
||||
SystemIdleSleep,
|
||||
DavisSync,
|
||||
DavisProcess,
|
||||
Transmission169,
|
||||
DownlinkListen,
|
||||
CommandProcessing,
|
||||
ErrorSafeMode,
|
||||
}
|
||||
|
||||
/// Actions ordonnées par la FSM en réaction aux événements
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum RelayAction {
|
||||
StartHardwareInit,
|
||||
StartDavisScan,
|
||||
EnterStop2Sleep,
|
||||
PrepareDavisSyncWindow,
|
||||
DecodeAndAggregateDavis,
|
||||
StartRadio169Transmission,
|
||||
OpenDownlinkListenWindow,
|
||||
ProcessIncomingCommand,
|
||||
ApplySafeModeFallback,
|
||||
None,
|
||||
}
|
||||
|
||||
/// Machine d'états principale du relais
|
||||
pub struct RelayStateMachine {
|
||||
current_state: RelayState,
|
||||
missed_davis_packets: u8,
|
||||
consecutive_transmissions: u32,
|
||||
}
|
||||
|
||||
impl RelayStateMachine {
|
||||
/// Initialise la machine d'états dans l'état initial BOOT
|
||||
pub const fn new() -> Self {
|
||||
Self {
|
||||
current_state: RelayState::Boot,
|
||||
missed_davis_packets: 0,
|
||||
consecutive_transmissions: 0,
|
||||
}
|
||||
}
|
||||
|
||||
/// État courant de la FSM
|
||||
#[inline(always)]
|
||||
pub fn current_state(&self) -> RelayState {
|
||||
self.current_state
|
||||
}
|
||||
|
||||
/// Nombre de paquets Davis consécutifs manqués
|
||||
#[inline(always)]
|
||||
pub fn missed_davis_packets(&self) -> u8 {
|
||||
self.missed_davis_packets
|
||||
}
|
||||
|
||||
/// Force l'état de la machine (utilisé lors du démarrage / tests)
|
||||
pub fn set_state(&mut self, state: RelayState) {
|
||||
self.current_state = state;
|
||||
}
|
||||
|
||||
/// Traite un événement entrant et opère la transition d'état
|
||||
pub fn process_event(&mut self, event: SystemEvent) -> (RelayState, RelayAction) {
|
||||
let (next_state, action) = match (self.current_state, event) {
|
||||
(RelayState::Boot, _) => (RelayState::Init, RelayAction::StartHardwareInit),
|
||||
|
||||
(RelayState::Init, _) => (RelayState::DavisScan, RelayAction::StartDavisScan),
|
||||
|
||||
(RelayState::DavisScan, SystemEvent::DavisPacketReady) => {
|
||||
self.missed_davis_packets = 0;
|
||||
(RelayState::SystemIdleSleep, RelayAction::EnterStop2Sleep)
|
||||
}
|
||||
(RelayState::DavisScan, SystemEvent::DavisListenTimeout) => {
|
||||
(RelayState::ErrorSafeMode, RelayAction::ApplySafeModeFallback)
|
||||
}
|
||||
|
||||
(RelayState::SystemIdleSleep, SystemEvent::RtcDavisTick) => {
|
||||
(RelayState::DavisSync, RelayAction::PrepareDavisSyncWindow)
|
||||
}
|
||||
(RelayState::SystemIdleSleep, SystemEvent::RtcTransmitTick) => {
|
||||
(
|
||||
RelayState::Transmission169,
|
||||
RelayAction::StartRadio169Transmission,
|
||||
)
|
||||
}
|
||||
|
||||
(RelayState::DavisSync, SystemEvent::DavisPacketReady) => {
|
||||
self.missed_davis_packets = 0;
|
||||
(RelayState::DavisProcess, RelayAction::DecodeAndAggregateDavis)
|
||||
}
|
||||
(RelayState::DavisSync, SystemEvent::DavisListenTimeout) => {
|
||||
self.missed_davis_packets = self.missed_davis_packets.saturating_add(1);
|
||||
(RelayState::DavisProcess, RelayAction::DecodeAndAggregateDavis)
|
||||
}
|
||||
|
||||
(RelayState::DavisProcess, _) => {
|
||||
if self.missed_davis_packets > 10 {
|
||||
// Perte prolongée de synchronisation -> retour en scan à froid
|
||||
(RelayState::DavisScan, RelayAction::StartDavisScan)
|
||||
} else {
|
||||
(RelayState::SystemIdleSleep, RelayAction::EnterStop2Sleep)
|
||||
}
|
||||
}
|
||||
|
||||
(RelayState::Transmission169, SystemEvent::Radio169AuxReady) => {
|
||||
self.consecutive_transmissions = self.consecutive_transmissions.saturating_add(1);
|
||||
(
|
||||
RelayState::DownlinkListen,
|
||||
RelayAction::OpenDownlinkListenWindow,
|
||||
)
|
||||
}
|
||||
|
||||
(RelayState::DownlinkListen, SystemEvent::Radio169RxByte(_)) => (
|
||||
RelayState::CommandProcessing,
|
||||
RelayAction::ProcessIncomingCommand,
|
||||
),
|
||||
(RelayState::DownlinkListen, SystemEvent::Radio169ListenEnd) => {
|
||||
(RelayState::SystemIdleSleep, RelayAction::EnterStop2Sleep)
|
||||
}
|
||||
|
||||
(RelayState::CommandProcessing, _) => {
|
||||
(RelayState::SystemIdleSleep, RelayAction::EnterStop2Sleep)
|
||||
}
|
||||
|
||||
(RelayState::ErrorSafeMode, _) => {
|
||||
(RelayState::SystemIdleSleep, RelayAction::EnterStop2Sleep)
|
||||
}
|
||||
|
||||
// Événements hors contexte -> maintien de l'état
|
||||
(state, _) => (state, RelayAction::None),
|
||||
};
|
||||
|
||||
self.current_state = next_state;
|
||||
(next_state, action)
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn test_fsm_nominal_davis_cycle() {
|
||||
let mut fsm = RelayStateMachine::new();
|
||||
assert_eq!(fsm.current_state(), RelayState::Boot);
|
||||
|
||||
// Boot -> Init
|
||||
let (s, a) = fsm.process_event(SystemEvent::WatchdogKick);
|
||||
assert_eq!(s, RelayState::Init);
|
||||
assert_eq!(a, RelayAction::StartHardwareInit);
|
||||
|
||||
// Init -> DavisScan
|
||||
let (s, a) = fsm.process_event(SystemEvent::WatchdogKick);
|
||||
assert_eq!(s, RelayState::DavisScan);
|
||||
assert_eq!(a, RelayAction::StartDavisScan);
|
||||
|
||||
// Capture du 1er paquet en scan -> Sleep
|
||||
let (s, a) = fsm.process_event(SystemEvent::DavisPacketReady);
|
||||
assert_eq!(s, RelayState::SystemIdleSleep);
|
||||
assert_eq!(a, RelayAction::EnterStop2Sleep);
|
||||
|
||||
// Réveil RTC Davis -> DavisSync
|
||||
let (s, a) = fsm.process_event(SystemEvent::RtcDavisTick);
|
||||
assert_eq!(s, RelayState::DavisSync);
|
||||
assert_eq!(a, RelayAction::PrepareDavisSyncWindow);
|
||||
|
||||
// Paquet reçu en sync -> DavisProcess
|
||||
let (s, a) = fsm.process_event(SystemEvent::DavisPacketReady);
|
||||
assert_eq!(s, RelayState::DavisProcess);
|
||||
assert_eq!(a, RelayAction::DecodeAndAggregateDavis);
|
||||
|
||||
// Fin de traitement -> Retour Sleep
|
||||
let (s, a) = fsm.process_event(SystemEvent::WatchdogKick);
|
||||
assert_eq!(s, RelayState::SystemIdleSleep);
|
||||
assert_eq!(a, RelayAction::EnterStop2Sleep);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_fsm_transmission_169_and_downlink() {
|
||||
let mut fsm = RelayStateMachine::new();
|
||||
fsm.set_state(RelayState::SystemIdleSleep);
|
||||
|
||||
// Réveil RTC Schedule -> Transmission 169
|
||||
let (s, a) = fsm.process_event(SystemEvent::RtcTransmitTick);
|
||||
assert_eq!(s, RelayState::Transmission169);
|
||||
assert_eq!(a, RelayAction::StartRadio169Transmission);
|
||||
|
||||
// AUX Ready -> Écoute descendante
|
||||
let (s, a) = fsm.process_event(SystemEvent::Radio169AuxReady);
|
||||
assert_eq!(s, RelayState::DownlinkListen);
|
||||
assert_eq!(a, RelayAction::OpenDownlinkListenWindow);
|
||||
|
||||
// Fin de fenêtre sans ordre -> Sommeil
|
||||
let (s, a) = fsm.process_event(SystemEvent::Radio169ListenEnd);
|
||||
assert_eq!(s, RelayState::SystemIdleSleep);
|
||||
assert_eq!(a, RelayAction::EnterStop2Sleep);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,48 @@
|
||||
//! Primitives de contrôle et barrières CPU Cortex-M4F
|
||||
|
||||
/// Exécute une barrière de synchronisation des données (Data Synchronization Barrier).
|
||||
#[inline(always)]
|
||||
pub fn dsb() {
|
||||
#[cfg(target_arch = "arm")]
|
||||
cortex_m::asm::dsb();
|
||||
}
|
||||
|
||||
/// Exécute une barrière de synchronisation des instructions (Instruction Synchronization Barrier).
|
||||
#[inline(always)]
|
||||
pub fn isb() {
|
||||
#[cfg(target_arch = "arm")]
|
||||
cortex_m::asm::isb();
|
||||
}
|
||||
|
||||
/// Place le cœur en attente d'interruption (Wait For Interrupt).
|
||||
#[inline(always)]
|
||||
pub fn wfi() {
|
||||
#[cfg(target_arch = "arm")]
|
||||
cortex_m::asm::wfi();
|
||||
}
|
||||
|
||||
/// Place le cœur en attente d'événement (Wait For Event).
|
||||
#[inline(always)]
|
||||
pub fn wfe() {
|
||||
#[cfg(target_arch = "arm")]
|
||||
cortex_m::asm::wfe();
|
||||
}
|
||||
|
||||
/// Exécute un bloc de code en section critique (interruptions masquées).
|
||||
#[inline(always)]
|
||||
pub fn critical_section<F, R>(f: F) -> R
|
||||
where
|
||||
F: FnOnce(&cortex_m::interrupt::CriticalSection) -> R,
|
||||
{
|
||||
#[cfg(target_arch = "arm")]
|
||||
{
|
||||
cortex_m::interrupt::free(f)
|
||||
}
|
||||
#[cfg(not(target_arch = "arm"))]
|
||||
{
|
||||
// Dummy critical section token for host tests
|
||||
struct DummyCs;
|
||||
let cs = unsafe { core::mem::transmute::<&DummyCs, &cortex_m::interrupt::CriticalSection>(&DummyCs) };
|
||||
f(cs)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,5 @@
|
||||
//! Abstractions d'architecture CPU Cortex-M4F
|
||||
|
||||
pub mod barrier;
|
||||
|
||||
pub use barrier::{critical_section, dsb, isb, wfe, wfi};
|
||||
@@ -0,0 +1,77 @@
|
||||
//! Module d'initialisation matérielle précoce au démarrage (Boot)
|
||||
//!
|
||||
//! Ce module configure les registres bas niveau du Cortex-M4F et du STM32L4
|
||||
//! immédiatement après la sortie du `Reset_Handler` de `cortex-m-rt`.
|
||||
|
||||
/// Cause identifiée du dernier reset matériel
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
#[repr(u8)]
|
||||
pub enum ResetReason {
|
||||
PowerOnReset = 0x01,
|
||||
BrownOutReset = 0x02,
|
||||
PinReset = 0x03,
|
||||
IndependentWatchdog = 0x04,
|
||||
WindowWatchdog = 0x05,
|
||||
SoftwareReset = 0x06,
|
||||
LowPowerReset = 0x07,
|
||||
Unknown = 0x00,
|
||||
}
|
||||
|
||||
/// Initialisation du coprocesseur FPU et de l'empilement paresseux (Lazy Stacking).
|
||||
///
|
||||
/// Active CP10 et CP11 dans le registre CPACR (Cortex-M4F) et s'assure que
|
||||
/// `FPCCR.LSPEN` est armé afin de ne pas pénaliser la latence des ISRs courtes.
|
||||
pub fn init_fpu() {
|
||||
#[cfg(target_arch = "arm")]
|
||||
unsafe {
|
||||
// CPACR est à l'adresse 0xE000ED88
|
||||
const CPACR: *mut u32 = 0xE000_ED88 as *mut u32;
|
||||
// Bits 20..23 = 0b1111 (Full Access CP10 & CP11)
|
||||
let val = core::ptr::read_volatile(CPACR);
|
||||
core::ptr::write_volatile(CPACR, val | (0xF << 20));
|
||||
|
||||
// FPCCR est à l'adresse 0xE000EF34
|
||||
const FPCCR: *mut u32 = 0xE000_EF34 as *mut u32;
|
||||
// Bit 30 = LSPEN (Lazy Stacking Enable)
|
||||
let fpccr_val = core::ptr::read_volatile(FPCCR);
|
||||
core::ptr::write_volatile(FPCCR, fpccr_val | (1 << 30));
|
||||
|
||||
cortex_m::asm::dsb();
|
||||
cortex_m::asm::isb();
|
||||
}
|
||||
}
|
||||
|
||||
/// Analyse et acquitte les drapeaux de reset dans RCC_CSR.
|
||||
pub fn capture_and_clear_reset_reason() -> ResetReason {
|
||||
#[cfg(target_arch = "arm")]
|
||||
unsafe {
|
||||
// RCC_CSR sur STM32L476 est à 0x40021094
|
||||
const RCC_CSR: *mut u32 = 0x4002_1094 as *mut u32;
|
||||
let csr = core::ptr::read_volatile(RCC_CSR);
|
||||
|
||||
let reason = if csr & (1 << 31) != 0 {
|
||||
ResetReason::LowPowerReset
|
||||
} else if csr & (1 << 29) != 0 {
|
||||
ResetReason::IndependentWatchdog
|
||||
} else if csr & (1 << 30) != 0 {
|
||||
ResetReason::WindowWatchdog
|
||||
} else if csr & (1 << 28) != 0 {
|
||||
ResetReason::SoftwareReset
|
||||
} else if csr & (1 << 27) != 0 {
|
||||
ResetReason::BrownOutReset
|
||||
} else if csr & (1 << 26) != 0 {
|
||||
ResetReason::PinReset
|
||||
} else {
|
||||
ResetReason::PowerOnReset
|
||||
};
|
||||
|
||||
// RMVF (bit 23) : efface les drapeaux de reset
|
||||
core::ptr::write_volatile(RCC_CSR, csr | (1 << 23));
|
||||
|
||||
reason
|
||||
}
|
||||
#[cfg(not(target_arch = "arm"))]
|
||||
{
|
||||
ResetReason::PowerOnReset
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
//! Driver pour transceiver CC1101 (868 MHz - Interception Davis)
|
||||
|
||||
use crate::hal::spi::SpiError;
|
||||
|
||||
/// Erreurs possibles du driver CC1101
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum Cc1101Error {
|
||||
Spi(SpiError),
|
||||
ChipNotResponding,
|
||||
InvalidChannel(u8),
|
||||
FifoOverflow,
|
||||
CrcError,
|
||||
}
|
||||
|
||||
impl From<SpiError> for Cc1101Error {
|
||||
fn from(err: SpiError) -> Self {
|
||||
Cc1101Error::Spi(err)
|
||||
}
|
||||
}
|
||||
|
||||
/// Contrat d'interface du récepteur radio 868 MHz Davis
|
||||
pub trait Radio868Receiver {
|
||||
type Error;
|
||||
|
||||
/// Initialise les registres RF du CC1101 pour la démodulation FSK 19.2 kbps
|
||||
fn init(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Sélectionne le canal FHSS Davis (0..4 pour l'Europe : 868.0 à 868.5 MHz)
|
||||
fn set_channel(&mut self, channel: u8) -> Result<(), Self::Error>;
|
||||
|
||||
/// Passe le CC1101 en mode écoute active (RX)
|
||||
fn start_listening(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Récupère un paquet brut de 14 octets depuis la FIFO
|
||||
fn read_packet(&mut self, buf: &mut [u8; 16]) -> Result<Option<u8>, Self::Error>;
|
||||
|
||||
/// Place le CC1101 en mode veille profonde (Power Down / Sleep)
|
||||
fn sleep(&mut self) -> Result<(), Self::Error>;
|
||||
}
|
||||
@@ -0,0 +1,54 @@
|
||||
//! Driver pour module EBYTE E32-170T30D-V2.0 (Liaison VHF 169 MHz)
|
||||
|
||||
use crate::hal::uart::UartError;
|
||||
|
||||
/// Modes de fonctionnement du modem E32
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum E32Mode {
|
||||
/// Mode 0 : Transmission et réception transparentes (M0=0, M1=0)
|
||||
Mode0Normal,
|
||||
/// Mode 1 : Wake-up émetteur (M0=1, M1=0)
|
||||
Mode1WakeUp,
|
||||
/// Mode 2 : Économie d'énergie récepteur (M0=0, M1=1)
|
||||
Mode2PowerSaving,
|
||||
/// Mode 3 : Veille / Mode configuration (M0=1, M1=1)
|
||||
Mode3Sleep,
|
||||
}
|
||||
|
||||
/// Erreurs possibles du driver E32-170T30D
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum E32Error {
|
||||
Uart(UartError),
|
||||
TimeoutAux,
|
||||
ModuleBusy,
|
||||
InvalidParameter,
|
||||
}
|
||||
|
||||
impl From<UartError> for E32Error {
|
||||
fn from(err: UartError) -> Self {
|
||||
E32Error::Uart(err)
|
||||
}
|
||||
}
|
||||
|
||||
/// Contrat d'interface du transceiver 169 MHz EBYTE
|
||||
pub trait Radio169Transceiver {
|
||||
type Error;
|
||||
|
||||
/// Initialise le module, configure le débit et vérifie le signal AUX
|
||||
fn init(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Émet une trame montante sérialisée sur 169 MHz (+27 dBm ERP max)
|
||||
fn send_payload(&mut self, payload: &[u8]) -> Result<(), Self::Error>;
|
||||
|
||||
/// Bascule en mode écoute descendante après émission (Mode 0)
|
||||
fn start_downlink_window(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Scrute la réception de commandes descendantes pendant la fenêtre d'écoute
|
||||
fn poll_downlink(&mut self, buf: &mut [u8]) -> Result<Option<usize>, Self::Error>;
|
||||
|
||||
/// Bascule le module en veille ultra-basse consommation (Mode 3 Sleep)
|
||||
fn sleep(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Indique si la broche d'état AUX est à l'état haut (Module prêt / Idle)
|
||||
fn is_aux_ready(&self) -> bool;
|
||||
}
|
||||
@@ -0,0 +1,9 @@
|
||||
//! Drivers pour composants et modules externes
|
||||
|
||||
pub mod cc1101;
|
||||
pub mod e32_170t30d;
|
||||
pub mod pwr_switch;
|
||||
|
||||
pub use cc1101::{Cc1101Error, Radio868Receiver};
|
||||
pub use e32_170t30d::{E32Error, E32Mode, Radio169Transceiver};
|
||||
pub use pwr_switch::{PowerSwitchController, PowerSwitchError};
|
||||
@@ -0,0 +1,19 @@
|
||||
//! Driver pour interrupteurs d'alimentation commandables (Load Switches)
|
||||
|
||||
/// Erreurs possibles du driver d'alimentation des périphériques
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum PowerSwitchError {
|
||||
PinError,
|
||||
ThermalFault,
|
||||
}
|
||||
|
||||
/// Contrat de coupure matérielle de puissance pour éliminer les courants de fuite
|
||||
pub trait PowerSwitchController {
|
||||
type Error;
|
||||
|
||||
/// Active ou coupe la ligne d'alimentation du récepteur CC1101 (868 MHz)
|
||||
fn set_cc1101_power(&mut self, on: bool) -> Result<(), Self::Error>;
|
||||
|
||||
/// Active ou coupe la ligne d'alimentation du modem EBYTE E32 (169 MHz)
|
||||
fn set_e32_power(&mut self, on: bool) -> Result<(), Self::Error>;
|
||||
}
|
||||
@@ -0,0 +1,177 @@
|
||||
//! File d'événements circulaire statique déterministe (StaticEventQueue)
|
||||
//!
|
||||
//! Conçue pour une exécution sans allocation dynamique (`no_std`), avec zéro tas (heap),
|
||||
//! manipulable sous section critique courte (`cortex_m::interrupt::free`) entre les ISRs
|
||||
//! et la boucle principale.
|
||||
|
||||
/// Descripteurs d'événements du système météo
|
||||
#[repr(u8)]
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum SystemEvent {
|
||||
/// Réveil périodique RTC pour capture d'un tir Davis (~2.5s)
|
||||
RtcDavisTick,
|
||||
/// Réveil RTC pour transmission montante planifiée 169 MHz
|
||||
RtcTransmitTick,
|
||||
/// Front d'interruption EXTI GDO0 (trame Davis prête dans la FIFO du CC1101)
|
||||
DavisPacketReady,
|
||||
/// Échéance du timer d'écoute Davis (12-20 ms) sans réception de sync word
|
||||
DavisListenTimeout,
|
||||
/// Signal AUX du module EBYTE E32 passé à l'état haut (prêt / fin d'émission RF)
|
||||
Radio169AuxReady,
|
||||
/// Réception d'un octet descendant sur l'interface UART du module 169 MHz
|
||||
Radio169RxByte(u8),
|
||||
/// Échéance de la fenêtre d'écoute descendante 169 MHz (1.0 s)
|
||||
Radio169ListenEnd,
|
||||
/// Alerte de seuil bas de tension batterie mesurée par l'ADC ou PVD
|
||||
BatteryVoltageAlert,
|
||||
/// Signal périodique de rafraîchissement du chien de garde (IWDG)
|
||||
WatchdogKick,
|
||||
}
|
||||
|
||||
/// Tampon circulaire statique borné et déterministe pour `SystemEvent`.
|
||||
pub struct StaticEventQueue<const CAP: usize> {
|
||||
buffer: [SystemEvent; CAP],
|
||||
head: usize,
|
||||
tail: usize,
|
||||
count: usize,
|
||||
overflow_count: u32,
|
||||
}
|
||||
|
||||
impl<const CAP: usize> StaticEventQueue<CAP> {
|
||||
/// Crée une nouvelle file d'événements statique vide.
|
||||
pub const fn new() -> Self {
|
||||
Self {
|
||||
buffer: [SystemEvent::RtcDavisTick; CAP],
|
||||
head: 0,
|
||||
tail: 0,
|
||||
count: 0,
|
||||
overflow_count: 0,
|
||||
}
|
||||
}
|
||||
|
||||
/// Tente d'insérer un événement dans la file (typiquement appelé depuis une ISR courte).
|
||||
///
|
||||
/// Retourne `true` si l'événement a été inséré, ou `false` si la file est saturée.
|
||||
/// En cas de saturation, le compteur d'overflow est incrémenté de façon saturante.
|
||||
pub fn push(&mut self, event: SystemEvent) -> bool {
|
||||
if self.count >= CAP {
|
||||
self.overflow_count = self.overflow_count.saturating_add(1);
|
||||
return false;
|
||||
}
|
||||
self.buffer[self.head] = event;
|
||||
self.head = (self.head + 1) % CAP;
|
||||
self.count += 1;
|
||||
true
|
||||
}
|
||||
|
||||
/// Dépile le plus ancien événement disponible dans la file (appelé depuis la boucle principale).
|
||||
pub fn pop(&mut self) -> Option<SystemEvent> {
|
||||
if self.count == 0 {
|
||||
return None;
|
||||
}
|
||||
let event = self.buffer[self.tail];
|
||||
self.tail = (self.tail + 1) % CAP;
|
||||
self.count -= 1;
|
||||
Some(event)
|
||||
}
|
||||
|
||||
/// Indique si la file est vide.
|
||||
#[inline(always)]
|
||||
pub const fn is_empty(&self) -> bool {
|
||||
self.count == 0
|
||||
}
|
||||
|
||||
/// Indique si la file est saturée.
|
||||
#[inline(always)]
|
||||
pub const fn is_full(&self) -> bool {
|
||||
self.count == CAP
|
||||
}
|
||||
|
||||
/// Nombre d'événements actuellement en attente.
|
||||
#[inline(always)]
|
||||
pub const fn len(&self) -> usize {
|
||||
self.count
|
||||
}
|
||||
|
||||
/// Capacité maximale de la file.
|
||||
#[inline(always)]
|
||||
pub const fn capacity(&self) -> usize {
|
||||
CAP
|
||||
}
|
||||
|
||||
/// Nombre d'événements perdus par saturation depuis l'initialisation.
|
||||
#[inline(always)]
|
||||
pub const fn overflow_count(&self) -> u32 {
|
||||
self.overflow_count
|
||||
}
|
||||
|
||||
/// Vide la file d'événements.
|
||||
pub fn clear(&mut self) {
|
||||
self.head = 0;
|
||||
self.tail = 0;
|
||||
self.count = 0;
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn test_event_queue_fifo_order() {
|
||||
let mut queue = StaticEventQueue::<4>::new();
|
||||
assert!(queue.is_empty());
|
||||
assert_eq!(queue.len(), 0);
|
||||
|
||||
assert!(queue.push(SystemEvent::RtcDavisTick));
|
||||
assert!(queue.push(SystemEvent::Radio169RxByte(0x42)));
|
||||
assert!(queue.push(SystemEvent::WatchdogKick));
|
||||
|
||||
assert_eq!(queue.len(), 3);
|
||||
assert!(!queue.is_empty());
|
||||
assert!(!queue.is_full());
|
||||
|
||||
assert_eq!(queue.pop(), Some(SystemEvent::RtcDavisTick));
|
||||
assert_eq!(queue.pop(), Some(SystemEvent::Radio169RxByte(0x42)));
|
||||
assert_eq!(queue.pop(), Some(SystemEvent::WatchdogKick));
|
||||
assert_eq!(queue.pop(), None);
|
||||
assert!(queue.is_empty());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_event_queue_saturation_and_overflow() {
|
||||
let mut queue = StaticEventQueue::<2>::new();
|
||||
|
||||
assert!(queue.push(SystemEvent::RtcDavisTick));
|
||||
assert!(queue.push(SystemEvent::DavisPacketReady));
|
||||
assert!(queue.is_full());
|
||||
|
||||
// Doit échouer et incrémenter overflow_count
|
||||
assert!(!queue.push(SystemEvent::BatteryVoltageAlert));
|
||||
assert_eq!(queue.overflow_count(), 1);
|
||||
|
||||
assert!(!queue.push(SystemEvent::RtcTransmitTick));
|
||||
assert_eq!(queue.overflow_count(), 2);
|
||||
|
||||
assert_eq!(queue.pop(), Some(SystemEvent::RtcDavisTick));
|
||||
assert_eq!(queue.len(), 1);
|
||||
|
||||
// Insertion à nouveau possible
|
||||
assert!(queue.push(SystemEvent::BatteryVoltageAlert));
|
||||
assert_eq!(queue.pop(), Some(SystemEvent::DavisPacketReady));
|
||||
assert_eq!(queue.pop(), Some(SystemEvent::BatteryVoltageAlert));
|
||||
assert_eq!(queue.pop(), None);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_event_queue_wraparound() {
|
||||
let mut queue = StaticEventQueue::<3>::new();
|
||||
|
||||
for i in 0..10 {
|
||||
assert!(queue.push(SystemEvent::Radio169RxByte(i as u8)));
|
||||
assert_eq!(queue.pop(), Some(SystemEvent::Radio169RxByte(i as u8)));
|
||||
}
|
||||
assert!(queue.is_empty());
|
||||
assert_eq!(queue.overflow_count(), 0);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,5 @@
|
||||
//! Gestion des événements système et files de synchronisation
|
||||
|
||||
pub mod event_queue;
|
||||
|
||||
pub use event_queue::{StaticEventQueue, SystemEvent};
|
||||
@@ -0,0 +1,20 @@
|
||||
//! Abstraction matérielle de l'ADC (Conversion Analogique-Numérique)
|
||||
|
||||
/// Erreurs possibles du convertisseur ADC
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum AdcError {
|
||||
ConversionTimeout,
|
||||
CalibrationFailed,
|
||||
ChannelNotConfigured,
|
||||
}
|
||||
|
||||
/// Trait d'accès aux mesures de télémétrie interne du microcontrôleur
|
||||
pub trait AdcController {
|
||||
type Error;
|
||||
|
||||
/// Mesure la tension d'alimentation / batterie en millivolts
|
||||
fn read_vbat_mv(&mut self) -> Result<u16, Self::Error>;
|
||||
|
||||
/// Mesure la température interne de la jonction silicium en dixièmes de degré Celsius
|
||||
fn read_internal_temp_deci_celsius(&mut self) -> Result<i16, Self::Error>;
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
//! Abstraction matérielle de la mémoire Flash interne (STM32L476)
|
||||
//!
|
||||
//! Pages de 2 Ko (2048 octets), programmation par mots doubles (64 bits).
|
||||
|
||||
/// Taille d'une page Flash sur STM32L4
|
||||
pub const FLASH_PAGE_SIZE: usize = 2048;
|
||||
|
||||
/// Erreurs Flash matérielles
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum FlashError {
|
||||
UnlockFailed,
|
||||
EraseError,
|
||||
ProgrammingError,
|
||||
AlignmentError,
|
||||
AddressOutOfBounds,
|
||||
WriteProtected,
|
||||
Timeout,
|
||||
}
|
||||
|
||||
/// Trait d'accès bas niveau à la mémoire Flash
|
||||
pub trait FlashDriver {
|
||||
type Error;
|
||||
|
||||
/// Déverrouille les registres de contrôle de la Flash
|
||||
fn unlock(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Verrouille les registres de contrôle de la Flash
|
||||
fn lock(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Efface une page de 2 Ko à l'adresse spécifiée (doit être alignée sur 2 Ko)
|
||||
fn erase_page(&mut self, page_base_addr: u32) -> Result<(), Self::Error>;
|
||||
|
||||
/// Écrit un mot double de 64 bits à une adresse alignée sur 8 octets
|
||||
fn write_double_word(&mut self, addr: u32, data: u64) -> Result<(), Self::Error>;
|
||||
|
||||
/// Lit un segment de mémoire Flash dans un buffer RAM
|
||||
fn read_bytes(&self, addr: u32, buf: &mut [u8]) -> Result<(), Self::Error>;
|
||||
}
|
||||
@@ -0,0 +1,69 @@
|
||||
//! Abstraction matérielle des GPIOs et parking analogique basse consommation
|
||||
|
||||
/// Mode opérationnel d'une broche GPIO
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum PinMode {
|
||||
Input,
|
||||
Output,
|
||||
AlternateFunction(u8),
|
||||
Analog,
|
||||
}
|
||||
|
||||
/// Résistance de tirage d'une broche GPIO
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum Pull {
|
||||
None,
|
||||
Up,
|
||||
Down,
|
||||
}
|
||||
|
||||
/// Vitesse de commutation d'une broche GPIO
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum Speed {
|
||||
Low,
|
||||
Medium,
|
||||
High,
|
||||
VeryHigh,
|
||||
}
|
||||
|
||||
/// Identifiant de port GPIO
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum GpioPort {
|
||||
A,
|
||||
B,
|
||||
C,
|
||||
D,
|
||||
E,
|
||||
H,
|
||||
}
|
||||
|
||||
/// Descripteur d'une broche physique
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub struct PinId {
|
||||
pub port: GpioPort,
|
||||
pub pin: u8, // 0..15
|
||||
}
|
||||
|
||||
/// Trait d'abstraction pour le contrôle d'une broche de sortie
|
||||
pub trait OutputPin {
|
||||
type Error;
|
||||
fn set_high(&mut self) -> Result<(), Self::Error>;
|
||||
fn set_low(&mut self) -> Result<(), Self::Error>;
|
||||
fn toggle(&mut self) -> Result<(), Self::Error>;
|
||||
}
|
||||
|
||||
/// Trait d'abstraction pour la lecture d'une broche d'entrée
|
||||
pub trait InputPin {
|
||||
type Error;
|
||||
fn is_high(&self) -> Result<bool, Self::Error>;
|
||||
fn is_low(&self) -> Result<bool, Self::Error>;
|
||||
}
|
||||
|
||||
/// Trait de configuration des broches GPIO
|
||||
pub trait GpioController {
|
||||
type Error;
|
||||
fn configure_pin(&mut self, pin: PinId, mode: PinMode, pull: Pull, speed: Speed) -> Result<(), Self::Error>;
|
||||
/// Reconfigure l'ensemble des broches non critiques en mode Analogique sans tirage
|
||||
/// pour éliminer les courants de fuite en veille Stop 2 (DEC-025).
|
||||
fn park_non_wake_pins(&mut self) -> Result<(), Self::Error>;
|
||||
}
|
||||
@@ -0,0 +1,10 @@
|
||||
//! Abstraction matérielle du Watchdog Indépendant (IWDG)
|
||||
|
||||
/// Trait de contrôle du Watchdog Indépendant
|
||||
pub trait WatchdogDriver {
|
||||
/// Démarre le watchdog avec un timeout en millisecondes
|
||||
fn start(&mut self, timeout_ms: u32);
|
||||
|
||||
/// Rafraîchit le compteur du watchdog (Kick / Feed)
|
||||
fn feed(&mut self);
|
||||
}
|
||||
@@ -0,0 +1,22 @@
|
||||
//! Abstractions matérielles pures (Hardware Abstraction Layer)
|
||||
//!
|
||||
//! Couche d'accès aux périphériques sans logique métier, sans calcul météo,
|
||||
//! sans choix de politique horaire et sans protocole radio.
|
||||
|
||||
pub mod adc;
|
||||
pub mod flash;
|
||||
pub mod gpio;
|
||||
pub mod iwdg;
|
||||
pub mod pwr;
|
||||
pub mod rtc;
|
||||
pub mod spi;
|
||||
pub mod uart;
|
||||
|
||||
pub use adc::{AdcController, AdcError};
|
||||
pub use flash::{FlashDriver, FlashError, FLASH_PAGE_SIZE};
|
||||
pub use gpio::{GpioController, GpioPort, InputPin, OutputPin, PinId, PinMode, Pull, Speed};
|
||||
pub use iwdg::WatchdogDriver;
|
||||
pub use pwr::{LowPowerMode, PowerController};
|
||||
pub use rtc::{RtcController, RtcError, RtcTime};
|
||||
pub use spi::{SpiError, SpiMaster};
|
||||
pub use uart::{UartError, UartInterface};
|
||||
@@ -0,0 +1,55 @@
|
||||
//! Abstraction matérielle de la gestion de l'énergie et des horloges (PWR / RCC)
|
||||
|
||||
/// Modes de basse consommation supportés par le microcontrôleur
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum LowPowerMode {
|
||||
Sleep,
|
||||
LowPowerSleep,
|
||||
Stop0,
|
||||
Stop1,
|
||||
Stop2,
|
||||
Standby,
|
||||
Shutdown,
|
||||
}
|
||||
|
||||
/// Trait de contrôle de l'alimentation et des transitions de sommeil
|
||||
pub trait PowerController {
|
||||
type Error;
|
||||
|
||||
/// Prépare le microcontrôleur pour le mode Stop 2 avec rétention SRAM2 garantie
|
||||
fn prepare_stop2(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Exécute la mise en sommeil effectif (DSB + ISB + WFI)
|
||||
fn enter_low_power(&mut self);
|
||||
|
||||
/// Restaure les horloges système après réveil (MSI 16 MHz sans PLL)
|
||||
fn restore_clocks_after_wakeup(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Acquitte les drapeaux de réveil matériel
|
||||
fn clear_wakeup_flags(&mut self);
|
||||
}
|
||||
|
||||
/// Séquence matérielle directe de passage en Stop 2 pour STM32L476
|
||||
pub fn enter_stop2_hardware_sequence() {
|
||||
#[cfg(target_arch = "arm")]
|
||||
unsafe {
|
||||
// PWR_CR1 est à 0x40007000
|
||||
const PWR_CR1: *mut u32 = 0x4000_7000 as *mut u32;
|
||||
let mut cr1 = core::ptr::read_volatile(PWR_CR1);
|
||||
// Bit 9 = RRS (SRAM2 retention in Stop 2)
|
||||
cr1 |= 1 << 9;
|
||||
// Bits 2..0 = LPMS = 010 (Stop 2 mode)
|
||||
cr1 = (cr1 & !0x07) | 0x02;
|
||||
core::ptr::write_volatile(PWR_CR1, cr1);
|
||||
|
||||
// SCB_SCR est à 0xE000ED10
|
||||
const SCB_SCR: *mut u32 = 0xE000_ED10 as *mut u32;
|
||||
let scr = core::ptr::read_volatile(SCB_SCR);
|
||||
// Bit 2 = SLEEPDEEP
|
||||
core::ptr::write_volatile(SCB_SCR, scr | (1 << 2));
|
||||
|
||||
cortex_m::asm::dsb();
|
||||
cortex_m::asm::isb();
|
||||
cortex_m::asm::wfi();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,54 @@
|
||||
//! Abstraction matérielle de l'Horloge Temps Réel (RTC) et registres de sauvegarde
|
||||
|
||||
/// Structure de temps UTC compacte
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub struct RtcTime {
|
||||
pub hour: u8, // 0..23
|
||||
pub minute: u8, // 0..59
|
||||
pub second: u8, // 0..59
|
||||
}
|
||||
|
||||
impl RtcTime {
|
||||
/// Convertit l'heure en minute du jour (0..1439)
|
||||
#[inline(always)]
|
||||
pub const fn to_minutes_of_day(&self) -> u16 {
|
||||
(self.hour as u16) * 60 + (self.minute as u16)
|
||||
}
|
||||
}
|
||||
|
||||
/// Erreurs possibles lors des opérations RTC
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum RtcError {
|
||||
InitializationFailed,
|
||||
InvalidParameter,
|
||||
HardwareTimeout,
|
||||
}
|
||||
|
||||
/// Trait de contrôle de la RTC et des registres de sauvegarde
|
||||
pub trait RtcController {
|
||||
type Error;
|
||||
|
||||
/// Lit l'heure courante issue des registres RTC
|
||||
fn get_time(&self) -> Result<RtcTime, Self::Error>;
|
||||
|
||||
/// Définit l'heure courante (synchronisation depuis la station/serveur)
|
||||
fn set_time(&mut self, time: RtcTime) -> Result<(), Self::Error>;
|
||||
|
||||
/// Programme un réveil périodique via le Wakeup Timer (pour capture Davis)
|
||||
fn set_wakeup_timer_ticks(&mut self, ticks: u16) -> Result<(), Self::Error>;
|
||||
|
||||
/// Désactive le Wakeup Timer
|
||||
fn disable_wakeup_timer(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Programme une alarme horaire (Alarme A pour la transmission 169 MHz)
|
||||
fn set_alarm_time(&mut self, hour: u8, minute: u8, second: u8) -> Result<(), Self::Error>;
|
||||
|
||||
/// Acquitte l'interruption d'alarme
|
||||
fn clear_alarm_flag(&mut self) -> Result<(), Self::Error>;
|
||||
|
||||
/// Lit l'un des 32 registres de sauvegarde (Backup Registers 0..31)
|
||||
fn read_backup_register(&self, index: u8) -> u32;
|
||||
|
||||
/// Écrit dans l'un des 32 registres de sauvegarde (préservés en Stop 2 et Vbat)
|
||||
fn write_backup_register(&mut self, index: u8, value: u32);
|
||||
}
|
||||
@@ -0,0 +1,22 @@
|
||||
//! Abstraction matérielle du bus SPI (Master)
|
||||
|
||||
/// Erreurs possibles sur le bus SPI
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum SpiError {
|
||||
BusError,
|
||||
Overrun,
|
||||
ModeFault,
|
||||
CrcError,
|
||||
Timeout,
|
||||
}
|
||||
|
||||
/// Trait d'accès synchrone au bus SPI maître (ex: communication CC1101)
|
||||
pub trait SpiMaster {
|
||||
type Error;
|
||||
|
||||
/// Écrit un buffer sur le bus SPI sans lire la réponse
|
||||
fn write(&mut self, data: &[u8]) -> Result<(), Self::Error>;
|
||||
|
||||
/// Échange simultanément des octets en émission et réception (Full Duplex)
|
||||
fn transfer(&mut self, write_buf: &[u8], read_buf: &mut [u8]) -> Result<(), Self::Error>;
|
||||
}
|
||||
@@ -0,0 +1,25 @@
|
||||
//! Abstraction matérielle de l'interface série asynchrone (UART/USART)
|
||||
|
||||
/// Erreurs possibles sur la liaison série UART
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum UartError {
|
||||
FramingError,
|
||||
NoiseError,
|
||||
Overrun,
|
||||
ParityError,
|
||||
Timeout,
|
||||
}
|
||||
|
||||
/// Trait d'accès à l'interface série (ex: modem EBYTE E32-170T30D)
|
||||
pub trait UartInterface {
|
||||
type Error;
|
||||
|
||||
/// Émet un buffer d'octets de manière bloquante ou DMA
|
||||
fn write_bytes(&mut self, data: &[u8]) -> Result<(), Self::Error>;
|
||||
|
||||
/// Lit un octet disponible sans blocage
|
||||
fn read_byte(&mut self) -> Result<Option<u8>, Self::Error>;
|
||||
|
||||
/// Vide et acquitte le buffer matériel de réception
|
||||
fn flush_rx(&mut self) -> Result<(), Self::Error>;
|
||||
}
|
||||
@@ -0,0 +1,15 @@
|
||||
#![no_std]
|
||||
|
||||
//! # OS_relais - Firmware Bare-Metal Relais Météo 169 MHz (STM32L476RGT6)
|
||||
//!
|
||||
//! Couche logicielle propriétaire sans OS, sans RTOS et sans allocation dynamique (zéro heap),
|
||||
//! optimisée pour la rétention SRAM2 en mode Stop 2 et l'interception des trames Davis 868 MHz.
|
||||
|
||||
pub mod app;
|
||||
pub mod arch;
|
||||
pub mod boot;
|
||||
pub mod drivers;
|
||||
pub mod events;
|
||||
pub mod hal;
|
||||
pub mod protocol;
|
||||
pub mod services;
|
||||
@@ -0,0 +1,82 @@
|
||||
#![no_std]
|
||||
#![no_main]
|
||||
|
||||
use cortex_m_rt::entry;
|
||||
use panic_halt as _;
|
||||
|
||||
use os_relais::app::{RelayAction, RelayStateMachine, WeatherAggregator};
|
||||
use os_relais::arch::barrier::wfi;
|
||||
use os_relais::boot::{capture_and_clear_reset_reason, init_fpu};
|
||||
use os_relais::events::{StaticEventQueue, SystemEvent};
|
||||
use os_relais::services::{
|
||||
PowerManager, SystemDiagnostics, TransmissionPolicyTable, WatchdogManager,
|
||||
};
|
||||
|
||||
/// Capacité de la file d'événements statique en SRAM2
|
||||
const EVENT_QUEUE_CAPACITY: usize = 16;
|
||||
|
||||
#[entry]
|
||||
fn main() -> ! {
|
||||
// 1. Initialisation matérielle précoce du CPU Cortex-M4F
|
||||
init_fpu();
|
||||
let reset_reason = capture_and_clear_reset_reason();
|
||||
|
||||
// 2. Allocation statique des gestionnaires en SRAM2 (0x10000000)
|
||||
let mut event_queue = StaticEventQueue::<EVENT_QUEUE_CAPACITY>::new();
|
||||
let mut fsm = RelayStateMachine::new();
|
||||
let mut aggregator = WeatherAggregator::new();
|
||||
let _power_mgr = PowerManager::new();
|
||||
let _watchdog_mgr = WatchdogManager::new(8000);
|
||||
let mut diag = SystemDiagnostics::new(reset_reason);
|
||||
let _policy = TransmissionPolicyTable::default_safe();
|
||||
|
||||
// Premier événement d'amorçage
|
||||
event_queue.push(SystemEvent::WatchdogKick);
|
||||
|
||||
// 3. Boucle événementielle principale
|
||||
loop {
|
||||
if let Some(event) = event_queue.pop() {
|
||||
let (_next_state, action) = fsm.process_event(event);
|
||||
|
||||
match action {
|
||||
RelayAction::StartHardwareInit => {
|
||||
// Initialisation des périphériques (clocks, GPIO, RTC, SPI, UART)
|
||||
event_queue.push(SystemEvent::WatchdogKick);
|
||||
}
|
||||
RelayAction::StartDavisScan => {
|
||||
// Démarrage de l'écoute continue CC1101 sur canal 0
|
||||
}
|
||||
RelayAction::PrepareDavisSyncWindow => {
|
||||
// Armement de la fenêtre d'écoute CC1101 (12-20 ms)
|
||||
}
|
||||
RelayAction::DecodeAndAggregateDavis => {
|
||||
// Décodage du paquet brut et mise à jour de l'agrégateur
|
||||
diag.record_davis_rx();
|
||||
}
|
||||
RelayAction::StartRadio169Transmission => {
|
||||
// Sérialisation télémétrie et émission UART E32 (+27 dBm ERP max)
|
||||
diag.record_169_tx();
|
||||
aggregator.reset_window();
|
||||
}
|
||||
RelayAction::OpenDownlinkListenWindow => {
|
||||
// Maintien écoute 169 MHz (1.0 s)
|
||||
}
|
||||
RelayAction::ProcessIncomingCommand => {
|
||||
// Application de la commande reçue
|
||||
diag.record_169_cmd();
|
||||
}
|
||||
RelayAction::ApplySafeModeFallback => {
|
||||
// Basculement sur politique de repli (600s)
|
||||
diag.record_davis_sync_loss();
|
||||
}
|
||||
RelayAction::EnterStop2Sleep => {
|
||||
// Entrée en mode Stop 2 avec réveil par RTC ou EXTI
|
||||
}
|
||||
RelayAction::None => {}
|
||||
}
|
||||
} else {
|
||||
// Aucun événement en attente : attente basse consommation
|
||||
wfi();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,158 @@
|
||||
//! Traitement et validation des commandes descendantes 169 MHz depuis la station/serveur
|
||||
|
||||
use super::crc::crc32;
|
||||
|
||||
/// Magic identifiant les commandes descendantes
|
||||
pub const COMMAND_MAGIC: u16 = 0x4743; // 'G', 'C'
|
||||
|
||||
/// Catalogue des identifiants d'ordres descendants
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
#[repr(u8)]
|
||||
pub enum CommandId {
|
||||
SetTransmissionPolicy = 0x10,
|
||||
ForceTransmission = 0x11,
|
||||
GetDiagnostics = 0x12,
|
||||
SystemReset = 0x13,
|
||||
SetRtcTime = 0x14,
|
||||
SetRadioParams = 0x15,
|
||||
}
|
||||
|
||||
/// Commande descendante décodée
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum DownlinkCommand {
|
||||
SetTransmissionPolicy {
|
||||
default_interval_s: u16,
|
||||
},
|
||||
ForceTransmission,
|
||||
GetDiagnostics,
|
||||
SystemReset,
|
||||
SetRtcTime {
|
||||
hour: u8,
|
||||
minute: u8,
|
||||
second: u8,
|
||||
},
|
||||
SetRadioParams {
|
||||
channel_index: u8,
|
||||
power_dbm: u8,
|
||||
},
|
||||
}
|
||||
|
||||
/// Erreurs de parsing de commande
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum CommandParseError {
|
||||
InvalidMagic,
|
||||
UnknownCommand(u8),
|
||||
PayloadLengthMismatch,
|
||||
CrcError,
|
||||
BufferTooShort,
|
||||
InvalidParameter,
|
||||
}
|
||||
|
||||
/// Décode une commande descendante reçue sur UART 169 MHz
|
||||
pub fn parse_downlink_command(raw: &[u8]) -> Result<(u32, DownlinkCommand), CommandParseError> {
|
||||
if raw.len() < 10 {
|
||||
return Err(CommandParseError::BufferTooShort);
|
||||
}
|
||||
|
||||
let magic = ((raw[0] as u16) << 8) | (raw[1] as u16);
|
||||
if magic != COMMAND_MAGIC {
|
||||
return Err(CommandParseError::InvalidMagic);
|
||||
}
|
||||
|
||||
let seq = u32::from_be_bytes([raw[2], raw[3], raw[4], raw[5]]);
|
||||
let cmd_code = raw[6];
|
||||
let payload_len = raw[7] as usize;
|
||||
|
||||
if raw.len() < 8 + payload_len + 4 {
|
||||
return Err(CommandParseError::PayloadLengthMismatch);
|
||||
}
|
||||
|
||||
let expected_crc = u32::from_be_bytes([
|
||||
raw[8 + payload_len],
|
||||
raw[8 + payload_len + 1],
|
||||
raw[8 + payload_len + 2],
|
||||
raw[8 + payload_len + 3],
|
||||
]);
|
||||
|
||||
let computed_crc = crc32(&raw[0..8 + payload_len]);
|
||||
if expected_crc != computed_crc {
|
||||
return Err(CommandParseError::CrcError);
|
||||
}
|
||||
|
||||
let payload = &raw[8..8 + payload_len];
|
||||
|
||||
let cmd = match cmd_code {
|
||||
0x10 => {
|
||||
if payload.len() < 2 {
|
||||
return Err(CommandParseError::PayloadLengthMismatch);
|
||||
}
|
||||
let default_interval_s = u16::from_be_bytes([payload[0], payload[1]]);
|
||||
DownlinkCommand::SetTransmissionPolicy { default_interval_s }
|
||||
}
|
||||
0x11 => DownlinkCommand::ForceTransmission,
|
||||
0x12 => DownlinkCommand::GetDiagnostics,
|
||||
0x13 => DownlinkCommand::SystemReset,
|
||||
0x14 => {
|
||||
if payload.len() < 3 {
|
||||
return Err(CommandParseError::PayloadLengthMismatch);
|
||||
}
|
||||
let hour = payload[0];
|
||||
let minute = payload[1];
|
||||
let second = payload[2];
|
||||
if hour > 23 || minute > 59 || second > 59 {
|
||||
return Err(CommandParseError::InvalidParameter);
|
||||
}
|
||||
DownlinkCommand::SetRtcTime { hour, minute, second }
|
||||
}
|
||||
0x15 => {
|
||||
if payload.len() < 2 {
|
||||
return Err(CommandParseError::PayloadLengthMismatch);
|
||||
}
|
||||
let channel_index = payload[0];
|
||||
let power_dbm = payload[1];
|
||||
if power_dbm > 27 {
|
||||
// Conformité ERP max (+27 dBm / 500 mW)
|
||||
return Err(CommandParseError::InvalidParameter);
|
||||
}
|
||||
DownlinkCommand::SetRadioParams {
|
||||
channel_index,
|
||||
power_dbm,
|
||||
}
|
||||
}
|
||||
other => return Err(CommandParseError::UnknownCommand(other)),
|
||||
};
|
||||
|
||||
Ok((seq, cmd))
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn test_parse_set_rtc_time_command() {
|
||||
let mut buf = [0u8; 15];
|
||||
buf[0] = (COMMAND_MAGIC >> 8) as u8;
|
||||
buf[1] = (COMMAND_MAGIC & 0xFF) as u8;
|
||||
buf[2..6].copy_from_slice(&105u32.to_be_bytes()); // Seq = 105
|
||||
buf[6] = 0x14; // SetRtcTime
|
||||
buf[7] = 3; // Payload len = 3
|
||||
buf[8] = 14; // 14h
|
||||
buf[9] = 30; // 30m
|
||||
buf[10] = 0; // 00s
|
||||
|
||||
let crc = crc32(&buf[0..11]);
|
||||
buf[11..15].copy_from_slice(&crc.to_be_bytes());
|
||||
|
||||
let (seq, cmd) = parse_downlink_command(&buf).unwrap();
|
||||
assert_eq!(seq, 105);
|
||||
assert_eq!(
|
||||
cmd,
|
||||
DownlinkCommand::SetRtcTime {
|
||||
hour: 14,
|
||||
minute: 30,
|
||||
second: 0
|
||||
}
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,98 @@
|
||||
//! Calculs d'intégrité et sommes de contrôle (CRC16 Davis, CRC16 CCITT, CRC32)
|
||||
//!
|
||||
//! Fonctions pures déterministes fonctionnant sans allocation dynamique.
|
||||
|
||||
/// Calcule le CRC-16 propre aux trames de l'ISS Davis Vantage Pro2.
|
||||
///
|
||||
/// Polynôme : 0x1021, Valeur initiale : 0x0000.
|
||||
pub fn crc16_davis(data: &[u8]) -> u16 {
|
||||
let mut crc: u16 = 0x0000;
|
||||
for &byte in data {
|
||||
let mut b = (byte as u16) << 8;
|
||||
for _ in 0..8 {
|
||||
if ((crc ^ b) & 0x8000) != 0 {
|
||||
crc = (crc << 1) ^ 0x1021;
|
||||
} else {
|
||||
crc <<= 1;
|
||||
}
|
||||
b <<= 1;
|
||||
}
|
||||
}
|
||||
crc
|
||||
}
|
||||
|
||||
/// Vérifie si une trame Davis brute (payload + 2 octets CRC) est intègre.
|
||||
pub fn is_davis_crc_valid(packet: &[u8]) -> bool {
|
||||
if packet.len() < 3 {
|
||||
return false;
|
||||
}
|
||||
crc16_davis(packet) == 0x0000
|
||||
}
|
||||
|
||||
/// Calcule le CRC-16 CCITT standard (XModem / Kermit / Table de politique).
|
||||
///
|
||||
/// Polynôme : 0x1021, Valeur initiale : 0xFFFF.
|
||||
pub fn crc16_ccitt(data: &[u8]) -> u16 {
|
||||
let mut crc: u16 = 0xFFFF;
|
||||
for &byte in data {
|
||||
crc ^= (byte as u16) << 8;
|
||||
for _ in 0..8 {
|
||||
if (crc & 0x8000) != 0 {
|
||||
crc = (crc << 1) ^ 0x1021;
|
||||
} else {
|
||||
crc <<= 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
crc
|
||||
}
|
||||
|
||||
/// Calcule le CRC-32 IEEE 802.3 standard (utilisé pour Flash Ping-Pong et Télémétrie 169).
|
||||
///
|
||||
/// Polynôme réfléchi : 0xEDB88320, Valeur initiale : 0xFFFFFFFF, Inversion finale.
|
||||
pub fn crc32(data: &[u8]) -> u32 {
|
||||
let mut crc: u32 = 0xFFFF_FFFF;
|
||||
for &byte in data {
|
||||
crc ^= byte as u32;
|
||||
for _ in 0..8 {
|
||||
let mask = if (crc & 1) != 0 { 0xEDB8_8320 } else { 0 };
|
||||
crc = (crc >> 1) ^ mask;
|
||||
}
|
||||
}
|
||||
!crc
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn test_crc16_davis_calculation_and_validation() {
|
||||
// Paquet simulé : 6 octets payload + 2 octets CRC Davis
|
||||
let payload = [0x50, 0x01, 0x2A, 0x00, 0x12, 0x34];
|
||||
let crc = crc16_davis(&payload);
|
||||
let crc_bytes = [(crc >> 8) as u8, (crc & 0xFF) as u8];
|
||||
|
||||
let mut full_packet = [0u8; 8];
|
||||
full_packet[..6].copy_from_slice(&payload);
|
||||
full_packet[6..8].copy_from_slice(&crc_bytes);
|
||||
|
||||
assert!(is_davis_crc_valid(&full_packet));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_crc16_ccitt() {
|
||||
let data = b"123456789";
|
||||
let crc = crc16_ccitt(data);
|
||||
// Le CRC-16/CCITT-FALSE de "123456789" est 0x29B1
|
||||
assert_eq!(crc, 0x29B1);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_crc32_standard() {
|
||||
let data = b"123456789";
|
||||
let crc = crc32(data);
|
||||
// Le CRC-32 IEEE de "123456789" est 0xCBF43926
|
||||
assert_eq!(crc, 0xCBF4_3926);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,176 @@
|
||||
//! Moteur algorithmique de décodage des trames Davis Vantage Pro2 ISS (868 MHz)
|
||||
//!
|
||||
//! Module pur sans dépendance matérielle, testable sur banc hôte.
|
||||
|
||||
use super::crc::is_davis_crc_valid;
|
||||
|
||||
/// Types de paquets transmis par l'ISS Davis
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum DavisPacketType {
|
||||
Temperature, // Type 0x8 (VP2P_TEMP)
|
||||
WindGust, // Type 0x9 (VP2P_WINDGUST)
|
||||
Humidity, // Type 0xA (VP2P_HUMIDITY)
|
||||
RainAccumulated, // Type 0xE (VP2P_RAIN)
|
||||
SolarRadiation, // Type 0x6 / 0x7 (VP2P_SOLAR)
|
||||
UvIndex, // Type 0x4 (VP2P_UV)
|
||||
RainSecs, // Type 0x5 (VP2P_RAINSECS)
|
||||
Unknown(u8),
|
||||
}
|
||||
|
||||
/// Mesure météorologique décodée issue d'une trame Davis
|
||||
#[derive(Copy, Clone, Debug, PartialEq)]
|
||||
pub struct DavisMeasurement {
|
||||
pub station_id: u8,
|
||||
pub battery_low: bool,
|
||||
pub wind_speed_mph: u8,
|
||||
pub wind_direction_deg: u16,
|
||||
pub payload: DavisPayload,
|
||||
}
|
||||
|
||||
/// Charge utile spécifique au type de capteur
|
||||
#[derive(Copy, Clone, Debug, PartialEq)]
|
||||
pub enum DavisPayload {
|
||||
Temperature { temp_centi_celsius: i16 },
|
||||
Humidity { relative_humidity_pct: u8 },
|
||||
Rain { tip_count: u16 },
|
||||
WindGust { gust_speed_mph: u8 },
|
||||
SolarRadiation { radiation_wm2: u16 },
|
||||
UvIndex { uv_index_deci: u8 },
|
||||
Unknown { raw_type: u8, data: [u8; 3] },
|
||||
}
|
||||
|
||||
/// Erreurs possibles lors du décodage d'un paquet Davis
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum DavisDecodeError {
|
||||
BufferTooShort,
|
||||
CrcInvalid,
|
||||
InvalidData,
|
||||
}
|
||||
|
||||
/// Décode un paquet brut reçu de l'ISS Davis (8 octets : 6 octets payload + 2 octets CRC)
|
||||
pub fn decode_davis_packet(raw: &[u8]) -> Result<DavisMeasurement, DavisDecodeError> {
|
||||
if raw.len() < 8 {
|
||||
return Err(DavisDecodeError::BufferTooShort);
|
||||
}
|
||||
|
||||
if !is_davis_crc_valid(&raw[0..8]) {
|
||||
return Err(DavisDecodeError::CrcInvalid);
|
||||
}
|
||||
|
||||
let byte0 = raw[0];
|
||||
let packet_type_nibble = (byte0 >> 4) & 0x0F;
|
||||
let battery_low = (byte0 & 0x08) != 0;
|
||||
let station_id = byte0 & 0x07;
|
||||
|
||||
let wind_speed_mph = raw[1];
|
||||
|
||||
// Direction du vent sur 8 bits normalisée à 0..359°
|
||||
let wind_direction_raw = raw[2] as u32;
|
||||
let wind_direction_deg = ((wind_direction_raw * 360) / 256) as u16 % 360;
|
||||
|
||||
let payload = match packet_type_nibble {
|
||||
0x8 => {
|
||||
// Température extérieure (Type 0x8 - VP2P_TEMP)
|
||||
// Format Davis : ((raw[3] << 8) | raw[4]) >> 4 en 1/10e °F (signé)
|
||||
let raw_temp_f_tenths = (((raw[3] as i16) << 8) | (raw[4] as i16)) >> 4;
|
||||
// Conversion en centièmes de °C : (T_F/10 - 32) * 5/9 * 100 = (T_F_tenths - 320) * 50 / 9
|
||||
let temp_centi_celsius = (((raw_temp_f_tenths as i32 - 320) * 50) / 9) as i16;
|
||||
DavisPayload::Temperature { temp_centi_celsius }
|
||||
}
|
||||
0x9 => {
|
||||
// Rafale de vent 10-minutes (Type 0x9 - VP2P_WINDGUST)
|
||||
let gust_speed_mph = raw[3];
|
||||
DavisPayload::WindGust { gust_speed_mph }
|
||||
}
|
||||
0xA => {
|
||||
// Humidité relative extérieure (Type 0xA - VP2P_HUMIDITY)
|
||||
// Format Davis : (((raw[4] >> 4) << 8) | raw[3]) / 10 en %
|
||||
let raw_hum = (((raw[4] as u16 >> 4) << 8) | (raw[3] as u16)) / 10;
|
||||
let relative_humidity_pct = if raw_hum > 100 { 100 } else { raw_hum as u8 };
|
||||
DavisPayload::Humidity { relative_humidity_pct }
|
||||
}
|
||||
0xE => {
|
||||
// Pluviosité : compteur cumulé d'augets (Type 0xE - VP2P_RAIN)
|
||||
let tip_count = (raw[3] as u16 & 0x7F) | (((raw[4] as u16) & 0x0F) << 7);
|
||||
DavisPayload::Rain { tip_count }
|
||||
}
|
||||
0x6 | 0x7 => {
|
||||
// Rayonnement solaire (Type 0x6 / 0x7 - VP2P_SOLAR)
|
||||
let raw_solar = (((raw[3] as u16) << 8) | (raw[4] as u16)) >> 6;
|
||||
DavisPayload::SolarRadiation { radiation_wm2: raw_solar }
|
||||
}
|
||||
0x4 => {
|
||||
// Indice UV (Type 0x4 - VP2P_UV)
|
||||
let raw_uv = (((raw[3] as u16) << 8) | (raw[4] as u16)) >> 6;
|
||||
DavisPayload::UvIndex { uv_index_deci: (raw_uv / 5) as u8 }
|
||||
}
|
||||
other => {
|
||||
let mut data = [0u8; 3];
|
||||
data.copy_from_slice(&raw[3..6]);
|
||||
DavisPayload::Unknown { raw_type: other, data }
|
||||
}
|
||||
};
|
||||
|
||||
Ok(DavisMeasurement {
|
||||
station_id,
|
||||
battery_low,
|
||||
wind_speed_mph,
|
||||
wind_direction_deg,
|
||||
payload,
|
||||
})
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn test_decode_davis_temp_packet() {
|
||||
// Vecteur 1 vérifié : Type 0x8 (Température), Station ID 0, Vent 10 mph, Dir 90° (0x40), Temp 0x3E9 (100.1 °F = 37.83 °C)
|
||||
let raw = [0x80, 0x0A, 0x40, 0x3E, 0x90, 0x00, 0x3A, 0x5D];
|
||||
let measurement = decode_davis_packet(&raw).expect("Doit décoder");
|
||||
|
||||
assert_eq!(measurement.station_id, 0);
|
||||
assert!(!measurement.battery_low);
|
||||
assert_eq!(measurement.wind_speed_mph, 10);
|
||||
assert_eq!(measurement.wind_direction_deg, 90);
|
||||
assert_eq!(
|
||||
measurement.payload,
|
||||
DavisPayload::Temperature { temp_centi_celsius: 3783 }
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_decode_davis_rain_packet() {
|
||||
// Vecteur 2 vérifié : Type 0xE (Pluie), Station ID 0, Vent 0 mph, Dir 0°, Augets 21
|
||||
let raw = [0xE0, 0x00, 0x00, 0x15, 0x00, 0x00, 0x23, 0xAB];
|
||||
let measurement = decode_davis_packet(&raw).expect("Doit décoder");
|
||||
|
||||
assert_eq!(measurement.station_id, 0);
|
||||
assert_eq!(measurement.wind_speed_mph, 0);
|
||||
assert_eq!(measurement.payload, DavisPayload::Rain { tip_count: 21 });
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_decode_davis_humidity_packet() {
|
||||
// Vecteur 3 vérifié : Type 0xA (Humidité), Station ID 0, Vent 5 mph, Dir 180° (0x80), Humidité 58.8% -> 58%
|
||||
let raw = [0xA0, 0x05, 0x80, 0x4C, 0x20, 0x00, 0x71, 0x6D];
|
||||
let measurement = decode_davis_packet(&raw).expect("Doit décoder");
|
||||
|
||||
assert_eq!(measurement.station_id, 0);
|
||||
assert_eq!(measurement.wind_speed_mph, 5);
|
||||
assert_eq!(measurement.wind_direction_deg, 180);
|
||||
assert_eq!(
|
||||
measurement.payload,
|
||||
DavisPayload::Humidity { relative_humidity_pct: 58 }
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_decode_davis_crc_error() {
|
||||
let raw = [0x80, 15, 128, 25, 0x00, 0x00, 0xFF, 0xFF];
|
||||
let result = decode_davis_packet(&raw);
|
||||
assert_eq!(result, Err(DavisDecodeError::CrcInvalid));
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
//! Protocoles de données indépendants du matériel (Davis, Télémétrie 169 MHz, Commandes)
|
||||
|
||||
pub mod command;
|
||||
pub mod crc;
|
||||
pub mod davis;
|
||||
pub mod telemetry;
|
||||
|
||||
pub use command::{parse_downlink_command, CommandId, CommandParseError, DownlinkCommand, COMMAND_MAGIC};
|
||||
pub use crc::{crc16_ccitt, crc16_davis, crc32, is_davis_crc_valid};
|
||||
pub use davis::{decode_davis_packet, DavisDecodeError, DavisMeasurement, DavisPacketType, DavisPayload};
|
||||
pub use telemetry::{MessageType, WeatherTelemetryPacket, TELEMETRY_MAGIC};
|
||||
@@ -0,0 +1,147 @@
|
||||
//! Format binaire de la télémétrie montante 169 MHz vers la station
|
||||
//!
|
||||
//! Encodage compact sans allocation dynamique, protégé par CRC-32.
|
||||
|
||||
use super::crc::crc32;
|
||||
|
||||
/// Identifiant magique du protocole Gastinel Weather surcouche
|
||||
pub const TELEMETRY_MAGIC: u16 = 0x4757; // 'G', 'W'
|
||||
|
||||
/// Type de message télémétrique
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
#[repr(u8)]
|
||||
pub enum MessageType {
|
||||
WeatherReport = 0x01,
|
||||
SystemDiagnostics = 0x02,
|
||||
AlarmNotification = 0x03,
|
||||
}
|
||||
|
||||
/// Structure de télémétrie météo compacte à transmettre sur 169 MHz
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub struct WeatherTelemetryPacket {
|
||||
pub sequence_number: u32,
|
||||
pub timestamp_minutes: u16,
|
||||
pub wind_avg_deci_kmh: u16,
|
||||
pub wind_gust_deci_kmh: u16,
|
||||
pub wind_direction_deg: u16,
|
||||
pub temperature_centi_c: i16,
|
||||
pub humidity_pct: u8,
|
||||
pub rain_tips_accumulated: u16,
|
||||
pub vbat_mv: u16,
|
||||
pub die_temp_deci_c: i16,
|
||||
pub davis_rx_count: u16,
|
||||
pub davis_miss_count: u16,
|
||||
}
|
||||
|
||||
impl WeatherTelemetryPacket {
|
||||
/// Taille sérialisée du paquet (sans CRC) : 2 (magic) + 1 (type) + 26 (champs) = 29 octets (+ 4 octets CRC32 = 33 octets)
|
||||
pub const SERIALIZED_LEN: usize = 33;
|
||||
|
||||
/// Sérialise le paquet dans un buffer de 33 octets avec CRC32 en queue
|
||||
pub fn serialize(&self, out: &mut [u8; Self::SERIALIZED_LEN]) {
|
||||
out[0] = (TELEMETRY_MAGIC >> 8) as u8;
|
||||
out[1] = (TELEMETRY_MAGIC & 0xFF) as u8;
|
||||
out[2] = MessageType::WeatherReport as u8;
|
||||
|
||||
out[3..7].copy_from_slice(&self.sequence_number.to_be_bytes());
|
||||
out[7..9].copy_from_slice(&self.timestamp_minutes.to_be_bytes());
|
||||
out[9..11].copy_from_slice(&self.wind_avg_deci_kmh.to_be_bytes());
|
||||
out[11..13].copy_from_slice(&self.wind_gust_deci_kmh.to_be_bytes());
|
||||
out[13..15].copy_from_slice(&self.wind_direction_deg.to_be_bytes());
|
||||
out[15..17].copy_from_slice(&self.temperature_centi_c.to_be_bytes());
|
||||
out[17] = self.humidity_pct;
|
||||
out[18..20].copy_from_slice(&self.rain_tips_accumulated.to_be_bytes());
|
||||
out[20..22].copy_from_slice(&self.vbat_mv.to_be_bytes());
|
||||
out[22..24].copy_from_slice(&self.die_temp_deci_c.to_be_bytes());
|
||||
out[24..26].copy_from_slice(&self.davis_rx_count.to_be_bytes());
|
||||
out[26..28].copy_from_slice(&self.davis_miss_count.to_be_bytes());
|
||||
out[28] = 0x00; // Réservé / Padding
|
||||
|
||||
let crc = crc32(&out[0..29]);
|
||||
out[29..33].copy_from_slice(&crc.to_be_bytes());
|
||||
}
|
||||
|
||||
/// Désérialise et valide un buffer de télémétrie reçu
|
||||
pub fn deserialize(raw: &[u8; Self::SERIALIZED_LEN]) -> Option<Self> {
|
||||
let magic = ((raw[0] as u16) << 8) | (raw[1] as u16);
|
||||
if magic != TELEMETRY_MAGIC || raw[2] != (MessageType::WeatherReport as u8) {
|
||||
return None;
|
||||
}
|
||||
|
||||
let expected_crc = u32::from_be_bytes([raw[29], raw[30], raw[31], raw[32]]);
|
||||
let computed_crc = crc32(&raw[0..29]);
|
||||
if expected_crc != computed_crc {
|
||||
return None;
|
||||
}
|
||||
|
||||
Some(Self {
|
||||
sequence_number: u32::from_be_bytes([raw[3], raw[4], raw[5], raw[6]]),
|
||||
timestamp_minutes: u16::from_be_bytes([raw[7], raw[8]]),
|
||||
wind_avg_deci_kmh: u16::from_be_bytes([raw[9], raw[10]]),
|
||||
wind_gust_deci_kmh: u16::from_be_bytes([raw[11], raw[12]]),
|
||||
wind_direction_deg: u16::from_be_bytes([raw[13], raw[14]]),
|
||||
temperature_centi_c: i16::from_be_bytes([raw[15], raw[16]]),
|
||||
humidity_pct: raw[17],
|
||||
rain_tips_accumulated: u16::from_be_bytes([raw[18], raw[19]]),
|
||||
vbat_mv: u16::from_be_bytes([raw[20], raw[21]]),
|
||||
die_temp_deci_c: i16::from_be_bytes([raw[22], raw[23]]),
|
||||
davis_rx_count: u16::from_be_bytes([raw[24], raw[25]]),
|
||||
davis_miss_count: u16::from_be_bytes([raw[26], raw[27]]),
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn test_telemetry_packet_roundtrip() {
|
||||
let packet = WeatherTelemetryPacket {
|
||||
sequence_number: 1420,
|
||||
timestamp_minutes: 720, // 12:00
|
||||
wind_avg_deci_kmh: 450, // 45.0 km/h
|
||||
wind_gust_deci_kmh: 680, // 68.0 km/h
|
||||
wind_direction_deg: 270,
|
||||
temperature_centi_c: -350, // -3.50 °C
|
||||
humidity_pct: 85,
|
||||
rain_tips_accumulated: 12,
|
||||
vbat_mv: 3620,
|
||||
die_temp_deci_c: -15,
|
||||
davis_rx_count: 50,
|
||||
davis_miss_count: 1,
|
||||
};
|
||||
|
||||
let mut buf = [0u8; WeatherTelemetryPacket::SERIALIZED_LEN];
|
||||
packet.serialize(&mut buf);
|
||||
|
||||
let decoded = WeatherTelemetryPacket::deserialize(&buf).expect("Doit décoder");
|
||||
assert_eq!(packet, decoded);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_telemetry_packet_crc_rejection() {
|
||||
let packet = WeatherTelemetryPacket {
|
||||
sequence_number: 1,
|
||||
timestamp_minutes: 10,
|
||||
wind_avg_deci_kmh: 0,
|
||||
wind_gust_deci_kmh: 0,
|
||||
wind_direction_deg: 0,
|
||||
temperature_centi_c: 2000,
|
||||
humidity_pct: 50,
|
||||
rain_tips_accumulated: 0,
|
||||
vbat_mv: 3700,
|
||||
die_temp_deci_c: 220,
|
||||
davis_rx_count: 10,
|
||||
davis_miss_count: 0,
|
||||
};
|
||||
|
||||
let mut buf = [0u8; WeatherTelemetryPacket::SERIALIZED_LEN];
|
||||
packet.serialize(&mut buf);
|
||||
|
||||
// Corrompt un octet
|
||||
buf[5] ^= 0xFF;
|
||||
|
||||
assert_eq!(WeatherTelemetryPacket::deserialize(&buf), None);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
//! Gestionnaire de Diagnostics et Métriques de Santé Système (DiagManager)
|
||||
|
||||
use crate::boot::ResetReason;
|
||||
|
||||
/// Structure de métriques et compteurs de santé système
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub struct SystemDiagnostics {
|
||||
pub last_reset_reason: ResetReason,
|
||||
pub davis_packets_received: u32,
|
||||
pub davis_crc_errors: u32,
|
||||
pub davis_sync_losses: u16,
|
||||
pub radio169_transmissions: u32,
|
||||
pub radio169_rx_commands: u16,
|
||||
pub queue_overflows: u32,
|
||||
pub last_vbat_mv: u16,
|
||||
pub last_die_temp_deci_c: i16,
|
||||
}
|
||||
|
||||
impl SystemDiagnostics {
|
||||
pub const fn new(reset_reason: ResetReason) -> Self {
|
||||
Self {
|
||||
last_reset_reason: reset_reason,
|
||||
davis_packets_received: 0,
|
||||
davis_crc_errors: 0,
|
||||
davis_sync_losses: 0,
|
||||
radio169_transmissions: 0,
|
||||
radio169_rx_commands: 0,
|
||||
queue_overflows: 0,
|
||||
last_vbat_mv: 0,
|
||||
last_die_temp_deci_c: 0,
|
||||
}
|
||||
}
|
||||
|
||||
pub fn record_davis_rx(&mut self) {
|
||||
self.davis_packets_received = self.davis_packets_received.saturating_add(1);
|
||||
}
|
||||
|
||||
pub fn record_davis_crc_error(&mut self) {
|
||||
self.davis_crc_errors = self.davis_crc_errors.saturating_add(1);
|
||||
}
|
||||
|
||||
pub fn record_davis_sync_loss(&mut self) {
|
||||
self.davis_sync_losses = self.davis_sync_losses.saturating_add(1);
|
||||
}
|
||||
|
||||
pub fn record_169_tx(&mut self) {
|
||||
self.radio169_transmissions = self.radio169_transmissions.saturating_add(1);
|
||||
}
|
||||
|
||||
pub fn record_169_cmd(&mut self) {
|
||||
self.radio169_rx_commands = self.radio169_rx_commands.saturating_add(1);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,19 @@
|
||||
//! Services système d'orchestration (Power, Schedule, Storage, Watchdog, Diagnostics)
|
||||
|
||||
pub mod diag_manager;
|
||||
pub mod power_manager;
|
||||
pub mod schedule_manager;
|
||||
pub mod storage_manager;
|
||||
pub mod watchdog_manager;
|
||||
|
||||
pub use diag_manager::SystemDiagnostics;
|
||||
pub use power_manager::{PowerManager, PowerState};
|
||||
pub use schedule_manager::{
|
||||
TimeWindowRule, TransmissionPolicyTable, MAX_RULES, POLICY_MAGIC, SAFE_FALLBACK_INTERVAL_S,
|
||||
};
|
||||
pub use storage_manager::{
|
||||
arbitrate_slots, FlashSlotHeader, PersistentStorageManager, PingPongArbitration, SlotStatus,
|
||||
StorageSlot, COMMIT_MARK_ERASED, COMMIT_MARK_VALID, FLASH_SLOT_A_ADDR, FLASH_SLOT_B_ADDR,
|
||||
STORAGE_MAGIC,
|
||||
};
|
||||
pub use watchdog_manager::WatchdogManager;
|
||||
@@ -0,0 +1,110 @@
|
||||
//! Gestionnaire d'Énergie et transitions de sommeil (PowerManager - Stop 2)
|
||||
//!
|
||||
//! Orchestre le parking analogique des broches, la coupure des Load Switches,
|
||||
//! la programmation du mode Stop 2 avec rétention SRAM2 et le réveil rapide sur MSI.
|
||||
|
||||
use crate::hal::gpio::GpioController;
|
||||
use crate::hal::pwr::enter_stop2_hardware_sequence;
|
||||
|
||||
/// État du cycle de gestion d'énergie
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum PowerState {
|
||||
Active,
|
||||
PreparingSleep,
|
||||
InStop2,
|
||||
WakingUp,
|
||||
}
|
||||
|
||||
/// Structure d'orchestration du PowerManager
|
||||
pub struct PowerManager {
|
||||
state: PowerState,
|
||||
total_wakeups: u32,
|
||||
}
|
||||
|
||||
impl PowerManager {
|
||||
/// Initialise le gestionnaire d'énergie
|
||||
pub const fn new() -> Self {
|
||||
Self {
|
||||
state: PowerState::Active,
|
||||
total_wakeups: 0,
|
||||
}
|
||||
}
|
||||
|
||||
/// État courant de la gestion d'énergie
|
||||
#[inline(always)]
|
||||
pub fn current_state(&self) -> PowerState {
|
||||
self.state
|
||||
}
|
||||
|
||||
/// Nombre total de réveils depuis l'initialisation
|
||||
#[inline(always)]
|
||||
pub fn total_wakeups(&self) -> u32 {
|
||||
self.total_wakeups
|
||||
}
|
||||
|
||||
/// Séquence formelle d'entrée en mode Stop 2 ultra-basse consommation
|
||||
///
|
||||
/// 1. Parking analogique des GPIOs non-réveil
|
||||
/// 2. Armement de la rétention SRAM2 (`PWR_CR1.RRS = 1`)
|
||||
/// 3. Barrières DSB / ISB et exécution de WFI
|
||||
pub fn enter_stop2<G: GpioController>(&mut self, gpio: &mut G) -> Result<(), G::Error> {
|
||||
self.state = PowerState::PreparingSleep;
|
||||
|
||||
// Parking des broches GPIO pour éliminer les fuites parasites (~1.2 µA visé)
|
||||
gpio.park_non_wake_pins()?;
|
||||
|
||||
self.state = PowerState::InStop2;
|
||||
|
||||
// Séquence matérielle Stop 2 avec rétention SRAM2 et WFI
|
||||
enter_stop2_hardware_sequence();
|
||||
|
||||
// Sortie de WFI (Réveil immédiat par EXTI ou RTC)
|
||||
self.state = PowerState::WakingUp;
|
||||
self.total_wakeups = self.total_wakeups.saturating_add(1);
|
||||
self.state = PowerState::Active;
|
||||
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use crate::hal::gpio::{PinId, PinMode, Pull, Speed};
|
||||
|
||||
struct MockGpio {
|
||||
parked: bool,
|
||||
}
|
||||
|
||||
impl GpioController for MockGpio {
|
||||
type Error = ();
|
||||
fn configure_pin(
|
||||
&mut self,
|
||||
_pin: PinId,
|
||||
_mode: PinMode,
|
||||
_pull: Pull,
|
||||
_speed: Speed,
|
||||
) -> Result<(), Self::Error> {
|
||||
Ok(())
|
||||
}
|
||||
fn park_non_wake_pins(&mut self) -> Result<(), Self::Error> {
|
||||
self.parked = true;
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_power_manager_lifecycle() {
|
||||
let mut pm = PowerManager::new();
|
||||
let mut gpio = MockGpio { parked: false };
|
||||
|
||||
assert_eq!(pm.current_state(), PowerState::Active);
|
||||
assert_eq!(pm.total_wakeups(), 0);
|
||||
|
||||
let res = pm.enter_stop2(&mut gpio);
|
||||
assert!(res.is_ok());
|
||||
assert!(gpio.parked);
|
||||
assert_eq!(pm.current_state(), PowerState::Active);
|
||||
assert_eq!(pm.total_wakeups(), 1);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,202 @@
|
||||
//! Moteur de politiques horaires de transmission (ScheduleManager)
|
||||
//!
|
||||
//! Gère la table de configuration des plages de transmission VHF 169 MHz,
|
||||
//! évalue l'intervalle selon l'heure UTC courante (minutes du jour) et applique
|
||||
//! un repli de sécurité déterministe (600s / 10 min) en cas d'invalidité.
|
||||
|
||||
use crate::protocol::crc::crc16_ccitt;
|
||||
|
||||
/// Magic identifiant la table binaire de politique ("POLY")
|
||||
pub const POLICY_MAGIC: u32 = 0x504F4C59;
|
||||
|
||||
/// Intervalle de repli de sécurité par défaut (10 minutes)
|
||||
pub const SAFE_FALLBACK_INTERVAL_S: u16 = 600;
|
||||
|
||||
/// Nombre maximal de règles de plages horaires dans la table
|
||||
pub const MAX_RULES: usize = 4;
|
||||
|
||||
/// Règle de plage horaire compacte (8 octets)
|
||||
#[repr(C, packed)]
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub struct TimeWindowRule {
|
||||
pub start_hour: u8, // 0..23
|
||||
pub start_minute: u8, // 0..59
|
||||
pub end_hour: u8, // 0..23
|
||||
pub end_minute: u8, // 0..59
|
||||
pub interval_seconds: u16, // Intervalle d'émission pendant la plage (ex: 60s)
|
||||
pub flags: u16, // Réservé / Drapeaux futurs
|
||||
}
|
||||
|
||||
impl TimeWindowRule {
|
||||
/// Crée une nouvelle règle de plage horaire
|
||||
pub const fn new(
|
||||
start_hour: u8,
|
||||
start_minute: u8,
|
||||
end_hour: u8,
|
||||
end_minute: u8,
|
||||
interval_seconds: u16,
|
||||
) -> Self {
|
||||
Self {
|
||||
start_hour,
|
||||
start_minute,
|
||||
end_hour,
|
||||
end_minute,
|
||||
interval_seconds,
|
||||
flags: 0,
|
||||
}
|
||||
}
|
||||
|
||||
/// Indique si la règle est syntaxiquement valide
|
||||
pub fn is_valid(&self) -> bool {
|
||||
self.start_hour < 24
|
||||
&& self.start_minute < 60
|
||||
&& self.end_hour < 24
|
||||
&& self.end_minute < 60
|
||||
&& self.interval_seconds > 0
|
||||
}
|
||||
|
||||
/// Évalue si la minute courante du jour (0..1439) est incluse dans la plage
|
||||
pub fn matches_minute_of_day(&self, current_minute_of_day: u16) -> bool {
|
||||
let start = (self.start_hour as u16) * 60 + (self.start_minute as u16);
|
||||
let end = (self.end_hour as u16) * 60 + (self.end_minute as u16);
|
||||
|
||||
if start <= end {
|
||||
// Plage intra-journée classique (ex: 06:00 -> 08:00)
|
||||
current_minute_of_day >= start && current_minute_of_day < end
|
||||
} else {
|
||||
// Plage à cheval sur minuit (ex: 22:00 -> 04:00)
|
||||
current_minute_of_day >= start || current_minute_of_day < end
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// Table binaire complète de politique de transmission
|
||||
#[repr(C, packed)]
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub struct TransmissionPolicyTable {
|
||||
pub magic: u32,
|
||||
pub version: u16,
|
||||
pub num_rules: u8,
|
||||
pub default_interval_s: u16,
|
||||
pub rules: [TimeWindowRule; MAX_RULES],
|
||||
pub checksum: u16, // CRC-16 CCITT
|
||||
}
|
||||
|
||||
impl TransmissionPolicyTable {
|
||||
/// Crée une table de politique par défaut avec repli 10 minutes
|
||||
pub const fn default_safe() -> Self {
|
||||
let dummy_rule = TimeWindowRule::new(0, 0, 0, 0, SAFE_FALLBACK_INTERVAL_S);
|
||||
Self {
|
||||
magic: POLICY_MAGIC,
|
||||
version: 1,
|
||||
num_rules: 0,
|
||||
default_interval_s: SAFE_FALLBACK_INTERVAL_S,
|
||||
rules: [dummy_rule; MAX_RULES],
|
||||
checksum: 0,
|
||||
}
|
||||
}
|
||||
|
||||
/// Calcule et met à jour le checksum CRC-16 CCITT de la table
|
||||
pub fn update_checksum(&mut self) {
|
||||
let bytes = unsafe {
|
||||
let ptr = self as *const Self as *const u8;
|
||||
// Taille de la structure moins les 2 octets du champ checksum
|
||||
let len = core::mem::size_of::<Self>() - 2;
|
||||
core::slice::from_raw_parts(ptr, len)
|
||||
};
|
||||
self.checksum = crc16_ccitt(bytes);
|
||||
}
|
||||
|
||||
/// Vérifie la conformité totale de la table (magic, limites, checksum)
|
||||
pub fn is_valid(&self) -> bool {
|
||||
if self.magic != POLICY_MAGIC || self.num_rules > (MAX_RULES as u8) {
|
||||
return false;
|
||||
}
|
||||
|
||||
if self.default_interval_s == 0 {
|
||||
return false;
|
||||
}
|
||||
|
||||
for i in 0..(self.num_rules as usize) {
|
||||
if !self.rules[i].is_valid() {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
let bytes = unsafe {
|
||||
let ptr = self as *const Self as *const u8;
|
||||
let len = core::mem::size_of::<Self>() - 2;
|
||||
core::slice::from_raw_parts(ptr, len)
|
||||
};
|
||||
crc16_ccitt(bytes) == self.checksum
|
||||
}
|
||||
|
||||
/// Évalue l'intervalle de transmission actif pour une minute du jour donnée (0..1439).
|
||||
///
|
||||
/// Retourne l'intervalle en secondes de la première règle concordante,
|
||||
/// ou `default_interval_s` hors plages, ou `SAFE_FALLBACK_INTERVAL_S` si la table est corrompue.
|
||||
pub fn evaluate_interval(&self, minute_of_day: u16) -> u16 {
|
||||
if !self.is_valid() {
|
||||
return SAFE_FALLBACK_INTERVAL_S;
|
||||
}
|
||||
|
||||
let n = self.num_rules as usize;
|
||||
for i in 0..n {
|
||||
if self.rules[i].matches_minute_of_day(minute_of_day) {
|
||||
return self.rules[i].interval_seconds;
|
||||
}
|
||||
}
|
||||
|
||||
self.default_interval_s
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn test_time_window_intra_day() {
|
||||
let rule = TimeWindowRule::new(6, 0, 8, 0, 60); // 06:00 -> 08:00
|
||||
assert!(rule.is_valid());
|
||||
|
||||
assert!(!rule.matches_minute_of_day(5 * 60 + 59)); // 05:59 -> faux
|
||||
assert!(rule.matches_minute_of_day(6 * 60)); // 06:00 -> vrai
|
||||
assert!(rule.matches_minute_of_day(7 * 60 + 30)); // 07:30 -> vrai
|
||||
assert!(!rule.matches_minute_of_day(8 * 60)); // 08:00 -> faux
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_time_window_cross_midnight() {
|
||||
let rule = TimeWindowRule::new(22, 0, 4, 0, 120); // 22:00 -> 04:00
|
||||
assert!(rule.is_valid());
|
||||
|
||||
assert!(rule.matches_minute_of_day(22 * 60)); // 22:00 -> vrai
|
||||
assert!(rule.matches_minute_of_day(23 * 60 + 59)); // 23:59 -> vrai
|
||||
assert!(rule.matches_minute_of_day(0)); // 00:00 -> vrai
|
||||
assert!(rule.matches_minute_of_day(3 * 60 + 59)); // 03:59 -> vrai
|
||||
assert!(!rule.matches_minute_of_day(4 * 60)); // 04:00 -> faux
|
||||
assert!(!rule.matches_minute_of_day(12 * 60)); // 12:00 -> faux
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_policy_table_evaluation_and_fallback() {
|
||||
let mut table = TransmissionPolicyTable::default_safe();
|
||||
table.default_interval_s = 600;
|
||||
table.num_rules = 1;
|
||||
table.rules[0] = TimeWindowRule::new(6, 0, 8, 0, 60);
|
||||
table.update_checksum();
|
||||
|
||||
assert!(table.is_valid());
|
||||
|
||||
// À 07:00 -> 60s
|
||||
assert_eq!(table.evaluate_interval(7 * 60), 60);
|
||||
// À 12:00 -> 600s (default)
|
||||
assert_eq!(table.evaluate_interval(12 * 60), 600);
|
||||
|
||||
// Corrompre le checksum -> repli safe 600s
|
||||
table.checksum ^= 0xFFFF;
|
||||
assert!(!table.is_valid());
|
||||
assert_eq!(table.evaluate_interval(7 * 60), SAFE_FALLBACK_INTERVAL_S);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,231 @@
|
||||
//! Architecture de persistance Flash Ping-Pong A/B (StorageManager)
|
||||
//!
|
||||
//! Assure la sauvegarde sécurisée et atomique de la configuration et des états
|
||||
//! sur deux pages Flash indépendantes de 2 Ko (Pages 510 et 511), avec numéro
|
||||
//! de séquence monotone, contrôle CRC32 et mot double de validation (commit mark).
|
||||
|
||||
use crate::hal::flash::FLASH_PAGE_SIZE;
|
||||
|
||||
/// Magic identifiant l'en-tête de persistance Flash ("GWST")
|
||||
pub const STORAGE_MAGIC: u32 = 0x47575354;
|
||||
|
||||
/// Valeur du mot double de validation écrit en dernier pour valider une page
|
||||
pub const COMMIT_MARK_VALID: u64 = 0x55AA55AA_55AA55AA;
|
||||
|
||||
/// Valeur d'une cellule Flash effacée
|
||||
pub const COMMIT_MARK_ERASED: u64 = 0xFFFF_FFFF_FFFF_FFFF;
|
||||
|
||||
/// Adresses des deux pages Flash réservées (STM32L476 1 Mo)
|
||||
pub const FLASH_SLOT_A_ADDR: u32 = 0x080F_E000; // Page 510
|
||||
pub const FLASH_SLOT_B_ADDR: u32 = 0x080F_F000; // Page 511
|
||||
|
||||
/// En-tête structuré d'un slot de persistance Flash (Alignement 64 bits obligatoire - 24 octets)
|
||||
///
|
||||
/// Composé exactement de 3 mots doubles de 64 bits :
|
||||
/// - Mot 1 : `magic` (32b) + `sequence_number` (32b)
|
||||
/// - Mot 2 : `payload_len` (16b) + `payload_version` (16b) + `crc32` (32b)
|
||||
/// - Mot 3 : `commit_mark` (64b)
|
||||
#[repr(C, align(8))]
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub struct FlashSlotHeader {
|
||||
pub magic: u32, // 0x47575354 ("GWST")
|
||||
pub sequence_number: u32, // Numéro de séquence strictement croissant
|
||||
pub payload_len: u16, // Taille de la charge utile en octets
|
||||
pub payload_version: u16, // Version du schéma
|
||||
pub crc32: u32, // CRC-32 IEEE du payload
|
||||
pub commit_mark: u64, // Mot double programmé en tout dernier
|
||||
}
|
||||
|
||||
impl FlashSlotHeader {
|
||||
/// Taille en octets du header Flash (24 octets = 3 mots de 64 bits)
|
||||
pub const SIZE: usize = core::mem::size_of::<Self>();
|
||||
|
||||
/// Crée un nouvel en-tête prêt pour l'écriture (non commité)
|
||||
pub const fn new_uncommitted(sequence_number: u32, payload_len: u16, payload_version: u16, crc32: u32) -> Self {
|
||||
Self {
|
||||
magic: STORAGE_MAGIC,
|
||||
sequence_number,
|
||||
payload_len,
|
||||
payload_version,
|
||||
crc32,
|
||||
commit_mark: COMMIT_MARK_ERASED,
|
||||
}
|
||||
}
|
||||
|
||||
/// Vérifie si l'en-tête est formellement valide et commité
|
||||
pub fn is_valid_committed(&self) -> bool {
|
||||
self.magic == STORAGE_MAGIC
|
||||
&& self.commit_mark == COMMIT_MARK_VALID
|
||||
&& (self.payload_len as usize) <= (FLASH_PAGE_SIZE - Self::SIZE)
|
||||
}
|
||||
}
|
||||
|
||||
/// Identifiant de slot Ping-Pong
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum StorageSlot {
|
||||
SlotA,
|
||||
SlotB,
|
||||
}
|
||||
|
||||
impl StorageSlot {
|
||||
/// Retourne l'adresse physique Flash du début du slot
|
||||
pub const fn base_address(&self) -> u32 {
|
||||
match self {
|
||||
StorageSlot::SlotA => FLASH_SLOT_A_ADDR,
|
||||
StorageSlot::SlotB => FLASH_SLOT_B_ADDR,
|
||||
}
|
||||
}
|
||||
|
||||
/// Retourne le slot opposé
|
||||
pub const fn opposite(&self) -> Self {
|
||||
match self {
|
||||
StorageSlot::SlotA => StorageSlot::SlotB,
|
||||
StorageSlot::SlotB => StorageSlot::SlotA,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// État de santé d'un slot Flash
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub struct SlotStatus {
|
||||
pub slot: StorageSlot,
|
||||
pub is_valid: bool,
|
||||
pub sequence_number: u32,
|
||||
pub payload_len: u16,
|
||||
}
|
||||
|
||||
/// Résultat de l'arbitrage Ping-Pong au démarrage
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub struct PingPongArbitration {
|
||||
/// Slot actif contenant la configuration valide la plus récente
|
||||
pub active_slot: Option<StorageSlot>,
|
||||
/// Slot cible pour la prochaine écriture
|
||||
pub next_target_slot: StorageSlot,
|
||||
/// Prochain numéro de séquence à utiliser
|
||||
pub next_sequence_number: u32,
|
||||
}
|
||||
|
||||
/// Arbitre l'état des deux slots Flash pour déterminer le slot actif et le slot cible
|
||||
pub fn arbitrate_slots(status_a: SlotStatus, status_b: SlotStatus) -> PingPongArbitration {
|
||||
match (status_a.is_valid, status_b.is_valid) {
|
||||
(true, true) => {
|
||||
// Les deux slots sont valides : on choisit le plus récent selon sequence_number
|
||||
if status_a.sequence_number >= status_b.sequence_number {
|
||||
PingPongArbitration {
|
||||
active_slot: Some(StorageSlot::SlotA),
|
||||
next_target_slot: StorageSlot::SlotB,
|
||||
next_sequence_number: status_a.sequence_number.saturating_add(1),
|
||||
}
|
||||
} else {
|
||||
PingPongArbitration {
|
||||
active_slot: Some(StorageSlot::SlotB),
|
||||
next_target_slot: StorageSlot::SlotA,
|
||||
next_sequence_number: status_b.sequence_number.saturating_add(1),
|
||||
}
|
||||
}
|
||||
}
|
||||
(true, false) => PingPongArbitration {
|
||||
active_slot: Some(StorageSlot::SlotA),
|
||||
next_target_slot: StorageSlot::SlotB,
|
||||
next_sequence_number: status_a.sequence_number.saturating_add(1),
|
||||
},
|
||||
(false, true) => PingPongArbitration {
|
||||
active_slot: Some(StorageSlot::SlotB),
|
||||
next_target_slot: StorageSlot::SlotA,
|
||||
next_sequence_number: status_b.sequence_number.saturating_add(1),
|
||||
},
|
||||
(false, false) => PingPongArbitration {
|
||||
active_slot: None,
|
||||
next_target_slot: StorageSlot::SlotA,
|
||||
next_sequence_number: 1,
|
||||
},
|
||||
}
|
||||
}
|
||||
|
||||
/// Contrat du gestionnaire de persistance
|
||||
pub trait PersistentStorageManager {
|
||||
type Error;
|
||||
|
||||
/// Initialise et inspecte les deux slots au démarrage
|
||||
fn init(&mut self) -> Result<PingPongArbitration, Self::Error>;
|
||||
|
||||
/// Charge la charge utile depuis le slot actif
|
||||
fn read_active_payload(&self, out: &mut [u8]) -> Result<usize, Self::Error>;
|
||||
|
||||
/// Sauvegarde une nouvelle charge utile de manière atomique sur le slot inactif
|
||||
fn write_payload(&mut self, payload: &[u8], version: u16) -> Result<(), Self::Error>;
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn test_header_size_and_alignment() {
|
||||
assert_eq!(FlashSlotHeader::SIZE, 24);
|
||||
assert_eq!(core::mem::align_of::<FlashSlotHeader>(), 8);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_arbitrate_slots_both_valid() {
|
||||
let status_a = SlotStatus {
|
||||
slot: StorageSlot::SlotA,
|
||||
is_valid: true,
|
||||
sequence_number: 12,
|
||||
payload_len: 64,
|
||||
};
|
||||
let status_b = SlotStatus {
|
||||
slot: StorageSlot::SlotB,
|
||||
is_valid: true,
|
||||
sequence_number: 13,
|
||||
payload_len: 64,
|
||||
};
|
||||
|
||||
let arb = arbitrate_slots(status_a, status_b);
|
||||
assert_eq!(arb.active_slot, Some(StorageSlot::SlotB));
|
||||
assert_eq!(arb.next_target_slot, StorageSlot::SlotA);
|
||||
assert_eq!(arb.next_sequence_number, 14);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_arbitrate_slots_one_corrupted() {
|
||||
let status_a = SlotStatus {
|
||||
slot: StorageSlot::SlotA,
|
||||
is_valid: true,
|
||||
sequence_number: 5,
|
||||
payload_len: 64,
|
||||
};
|
||||
let status_b = SlotStatus {
|
||||
slot: StorageSlot::SlotB,
|
||||
is_valid: false, // Coupure pendant écriture
|
||||
sequence_number: 6,
|
||||
payload_len: 64,
|
||||
};
|
||||
|
||||
let arb = arbitrate_slots(status_a, status_b);
|
||||
assert_eq!(arb.active_slot, Some(StorageSlot::SlotA));
|
||||
assert_eq!(arb.next_target_slot, StorageSlot::SlotB);
|
||||
assert_eq!(arb.next_sequence_number, 6);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_arbitrate_slots_fresh_flash() {
|
||||
let status_a = SlotStatus {
|
||||
slot: StorageSlot::SlotA,
|
||||
is_valid: false,
|
||||
sequence_number: 0,
|
||||
payload_len: 0,
|
||||
};
|
||||
let status_b = SlotStatus {
|
||||
slot: StorageSlot::SlotB,
|
||||
is_valid: false,
|
||||
sequence_number: 0,
|
||||
payload_len: 0,
|
||||
};
|
||||
|
||||
let arb = arbitrate_slots(status_a, status_b);
|
||||
assert_eq!(arb.active_slot, None);
|
||||
assert_eq!(arb.next_target_slot, StorageSlot::SlotA);
|
||||
assert_eq!(arb.next_sequence_number, 1);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,36 @@
|
||||
//! Gestionnaire du Chien de Garde et intégrité système (WatchdogManager)
|
||||
|
||||
use crate::hal::iwdg::WatchdogDriver;
|
||||
|
||||
/// Gestionnaire d'orchestration de la surveillance watchdog
|
||||
pub struct WatchdogManager {
|
||||
timeout_ms: u32,
|
||||
kick_count: u32,
|
||||
}
|
||||
|
||||
impl WatchdogManager {
|
||||
/// Crée un nouveau gestionnaire de watchdog (défaut 8000 ms)
|
||||
pub const fn new(timeout_ms: u32) -> Self {
|
||||
Self {
|
||||
timeout_ms,
|
||||
kick_count: 0,
|
||||
}
|
||||
}
|
||||
|
||||
/// Démarre le watchdog matériel
|
||||
pub fn start<W: WatchdogDriver>(&mut self, watchdog: &mut W) {
|
||||
watchdog.start(self.timeout_ms);
|
||||
}
|
||||
|
||||
/// Rafraîchit le watchdog matériel
|
||||
pub fn feed<W: WatchdogDriver>(&mut self, watchdog: &mut W) {
|
||||
watchdog.feed();
|
||||
self.kick_count = self.kick_count.saturating_add(1);
|
||||
}
|
||||
|
||||
/// Nombre total de rafraîchissements effectués
|
||||
#[inline(always)]
|
||||
pub fn kick_count(&self) -> u32 {
|
||||
self.kick_count
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,26 @@
|
||||
# Gastinel.Weather.169
|
||||
|
||||
Réseau prototype de télécollecte météo autonome depuis le site isolé de la **Grande Moucherolle** vers une station de réception domestique via liaison radio VHF 169 MHz.
|
||||
|
||||
---
|
||||
|
||||
## 1. Organisation du Répertoire
|
||||
|
||||
- **[`/OS_relais`](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/OS_relais)** : Architecture logicielle bare-metal du microcontrôleur STM32L476RGT6 (Rust, System Layer).
|
||||
- **[`/OS_station`](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/OS_station)** : Services de réception, bufferisation locale et synchronisation sous Debian ARM64 headless (Raspberry Pi 4, C++).
|
||||
- **[`/surcouche`](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/surcouche)** : Modèles communs de télémétrie, politiques de transmission, commandes, diagnostics et interfaces.
|
||||
- **[`/notes`](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes)** : Documentation d'architecture centralisée, registre des décisions et questions ouvertes.
|
||||
|
||||
---
|
||||
|
||||
## 2. Documentation d'Architecture
|
||||
|
||||
Toute la documentation d'architecture est centralisée dans le dossier **`/notes`** :
|
||||
|
||||
1. [Architecture Globale](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes/architecture_globale.md)
|
||||
2. [Architecture Relais (STM32L4)](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes/architecture_relais.md)
|
||||
3. [Architecture Station (Raspberry Pi 4)](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes/architecture_station.md)
|
||||
4. [Architecture Surcouche Commune](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes/surcouche.md)
|
||||
5. [Flux de Données et Interfaces](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes/flux_donnees.md)
|
||||
6. [Registre des Décisions (ADR)](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes/decisions.md)
|
||||
7. [Questions Ouvertes & Arbitrages](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes/questions_ouvertes.md)
|
||||
@@ -0,0 +1,26 @@
|
||||
# Gastinel.Weather.169
|
||||
|
||||
Réseau prototype de télécollecte météo autonome depuis le site isolé de la **Grande Moucherolle** vers une station de réception domestique via liaison radio VHF 169 MHz.
|
||||
|
||||
---
|
||||
|
||||
## 1. Organisation du Répertoire
|
||||
|
||||
- **[`/OS_relais`](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/OS_relais)** : Architecture logicielle bare-metal du microcontrôleur STM32L476RGT6 (Rust, System Layer).
|
||||
- **[`/OS_station`](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/OS_station)** : Services de réception, bufferisation locale et synchronisation sous Debian ARM64 headless (Raspberry Pi 4, C++).
|
||||
- **[`/surcouche`](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/surcouche)** : Modèles communs de télémétrie, politiques de transmission, commandes, diagnostics et interfaces.
|
||||
- **[`/notes`](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes)** : Documentation d'architecture centralisée, registre des décisions et questions ouvertes.
|
||||
|
||||
---
|
||||
|
||||
## 2. Documentation d'Architecture
|
||||
|
||||
Toute la documentation d'architecture est centralisée dans le dossier **`/notes`** :
|
||||
|
||||
1. [Architecture Globale](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes/architecture_globale.md)
|
||||
2. [Architecture Relais (STM32L4)](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes/architecture_relais.md)
|
||||
3. [Architecture Station (Raspberry Pi 4)](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes/architecture_station.md)
|
||||
4. [Architecture Surcouche Commune](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes/surcouche.md)
|
||||
5. [Flux de Données et Interfaces](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes/flux_donnees.md)
|
||||
6. [Registre des Décisions (ADR)](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes/decisions.md)
|
||||
7. [Questions Ouvertes & Arbitrages](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes/questions_ouvertes.md)
|
||||
@@ -0,0 +1,119 @@
|
||||
# Architecture Globale - Gastinel.Weather.169
|
||||
|
||||
## 1. Vue d'ensemble du projet
|
||||
|
||||
**Gastinel.Weather.169** est un réseau prototype de télécollecte météo autonome conçu pour opérer en environnement hostile et isolé (site de haute montagne : *La Grande Moucherolle*).
|
||||
|
||||
Le système assure l'acquisition de données météorologiques natives émises par une suite de capteurs **Davis Vantage Pro2 ISS**, leur traitement et leur relais par liaison radio VHF longue portée (169 MHz) vers une station de réception domestique (Raspberry Pi 4), qui achemine les données vers un serveur domestique dédié au stockage principal et au plan de contrôle.
|
||||
|
||||
```
|
||||
┌───────────────────────────────┐
|
||||
│ Davis Vantage Pro2 ISS (868M) │ (Site isolé : Grande Moucherolle)
|
||||
└───────────────┬───────────────┘
|
||||
│ Radio native Davis 868 MHz
|
||||
▼
|
||||
┌───────────────────────────────┐
|
||||
│ Relais STM32L476RGT6 │ (Site isolé : Grande Moucherolle)
|
||||
│ - Réception : CC1101 868 MHz │ (Alimentation autonome sur batterie)
|
||||
│ - Émission : E32-170T30D │
|
||||
└───────────────┬───────────────┘
|
||||
│ Liaison radio VHF 169 MHz
|
||||
▼
|
||||
┌───────────────────────────────┐
|
||||
│ Station Raspberry Pi 4 │ (Site domestique)
|
||||
│ - Réception 169 MHz │ (Debian ARM64 headless)
|
||||
│ - Buffer local & validation │
|
||||
└───────────────┬───────────────┘
|
||||
│ Réseau local Ethernet RJ45
|
||||
▼
|
||||
┌───────────────────────────────┐
|
||||
│ Serveur Domestique │ (Stockage principal & Plan de contrôle)
|
||||
│ - Base de données & Dashboard│
|
||||
│ - Politiques de transmission │
|
||||
└───────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Chaîne Matérielle & Topologie Physique
|
||||
|
||||
### 2.1. Source de Données Météo : Davis Vantage Pro2 ISS
|
||||
- **Localisation** : Grande Moucherolle.
|
||||
- **Rôle** : Mesures physiques (vent, pluie, température, humidité, rayonnement, etc.).
|
||||
- **Interface radio** : Émetteur radio natif Davis en bande ISM 868 MHz (Europe), modulation FSK, sauts de fréquence (FHSS).
|
||||
- **Particularité** : Absence volontaire de console Davis et de datalogger USB/série sur le site. Les trames brutes doivent être interceptées directement dans les airs.
|
||||
|
||||
### 2.2. Nœud Relais : STM32L476RGT6
|
||||
- **Localisation** : Grande Moucherolle (colocalisé avec ou à proximité de l'ISS).
|
||||
- **Contrainte principale** : Autonomie énergétique totale sur batterie.
|
||||
- **Cœur de traitement** : Microcontrôleur STMicroelectronics STM32L476RGT6 (ARM Cortex-M4 avec FPU, Ultra-Low-Power).
|
||||
- **Front-end Radio 868 MHz** : Transceiver Texas Instruments CC1101 configuré en réception sur la bande 868 MHz pour l'écoute des trames Davis.
|
||||
- **Front-end Radio 169 MHz** : Module EBYTE E32-170T30D-V2.0 (ou CC1101 169 MHz) dédié à la liaison descendante vers la vallée/station.
|
||||
- **Mode d'exécution** : Bare-metal strict, sans OS généraliste, via une couche système dédiée (*System Layer*).
|
||||
|
||||
### 2.3. Liaison Radio Longue Portée (169 MHz)
|
||||
- **Bande de fréquence** : VHF 169 MHz (bande ISM européenne propice aux liaisons longue distance et à la pénétration en relief montagneux).
|
||||
- **Rôle** : Télécollecte des données agrégées et réception des ordres de configuration en provenance de la station.
|
||||
|
||||
### 2.4. Station Réceptrice : Raspberry Pi 4
|
||||
- **Localisation** : Site domestique (vallée / domicile).
|
||||
- **Plateforme** : Raspberry Pi 4 sous Linux Debian ARM64 (mode headless, sans interface graphique).
|
||||
- **Rôle** : Réception radio 169 MHz, vérification d'intégrité, stockage tampon local (buffer anti-coupure), transmission réseau vers le serveur, relai des ordres du serveur vers le relais, interface d'administration locale et distante via SSH.
|
||||
|
||||
### 2.5. Plan de Contrôle et Stockage : Serveur Domestique
|
||||
- **Localisation** : Réseau local domestique.
|
||||
- **Connectivité** : Liaison Ethernet filaire RJ45 avec le Raspberry Pi 4.
|
||||
- **Rôles** :
|
||||
- Ingestion et archivage pérenne des données météo et de diagnostic système.
|
||||
- Plan de contrôle centralisé : définition et diffusion des politiques de transmission et ordres d'administration vers le relais.
|
||||
- Visualisation, alertes et exploitation des séries temporelles.
|
||||
|
||||
---
|
||||
|
||||
## 3. Découpage et Organisation du Répertoire Projet
|
||||
|
||||
Le dépôt est structuré en quatre répertoires étanches :
|
||||
|
||||
```
|
||||
/Gastinel.Weather.169
|
||||
├── /OS_relais # Architecture logicielle STM32 (bare metal, system layer)
|
||||
├── /OS_station # Architecture logicielle Raspberry Pi 4 (Debian ARM64)
|
||||
├── /surcouche # Modèles communs de données, protocoles, commandes & sécurité
|
||||
└── /notes # Documentation d'architecture, décisions et questions ouvertes
|
||||
```
|
||||
|
||||
### 3.1. `/OS_relais` (Firmware Relais STM32)
|
||||
- Cible le STM32L476RGT6 en environnement **bare-metal**.
|
||||
- Exclut tout système d'exploitation classique (ni FreeRTOS, ni Linux, ni Zephyr).
|
||||
- Implémente une couche système propriétaire (*System Layer*) assurant l'accès au matériel, la gestion fine de l'énergie, les timers et les périphériques.
|
||||
- Langage principal : **Rust** (avec appui ponctuel en ASM très ciblé et C/C++ si requis). Outillage externe en **Python**.
|
||||
|
||||
### 3.2. `/OS_station` (Services Linux Raspberry Pi 4)
|
||||
- Cible le Raspberry Pi 4 sous **Debian ARM64 headless**.
|
||||
- Déploie les services d'écoute radio, de traitement, de bufferisation locale, de synchronisation réseau et de diagnostic.
|
||||
- Langage principal : **C++** pour les démons critiques, **Python** pour l'outillage et les tests.
|
||||
|
||||
### 3.3. `/surcouche` (Spécifications et Logique Commune)
|
||||
- Découplée du matériel spécifique du relais et de la station.
|
||||
- Définit :
|
||||
- Les structures de données de télémétrie météo et système.
|
||||
- Le format des messages d'échange sur la liaison 169 MHz.
|
||||
- Le jeu de commandes et de politiques de configuration.
|
||||
- Les mécanismes d'intégrité, de synchronisation temporelle et les hooks d'authentification future.
|
||||
|
||||
### 3.4. `/notes` (Documentation Centralisée)
|
||||
- Point unique de vérité pour l'architecture, les spécifications, le registre des décisions (`decisions.md`), les flux de données (`flux_donnees.md`) et les arbitrages en attente (`questions_ouvertes.md`).
|
||||
|
||||
---
|
||||
|
||||
## 4. Principes Fondamentaux d'Architecture
|
||||
|
||||
1. **Découplage strict Acquisition vs Transmission** :
|
||||
Le relais ne transmet pas systématiquement à chaque mesure de l'ISS. L'acquisition météo et la transmission 169 MHz suivent des rythmes et des contraintes énergétiques distincts.
|
||||
2. **Autonomie et Résilience Locale** :
|
||||
- Le relais applique des politiques de transmission autonomes basées sur son horloge temps réel (RTC) et reste fonctionnel même en cas de rupture de communication avec la station.
|
||||
- La station dispose d'un stockage tampon local pour préserver les mesures en cas d'indisponibilité temporaire du serveur domestique.
|
||||
3. **Séparation Stricte des Couches Logicielles** :
|
||||
Les drivers matériels (ex. SPI, CC1101) ne contiennent aucune logique métier ni de décodage de protocole (ex. décodage Davis ou modèle surcouche).
|
||||
4. **Évolution Incrémentale et Sécurité par Conception** :
|
||||
La version 1 se concentre sur la fiabilité des liaisons radio, de la télémétrie et de la gestion de configuration sans chiffrement complexe, tout en réservant dans les en-têtes de paquets les champs requis pour l'authentification et l'anti-rejeu futurs.
|
||||
@@ -0,0 +1,523 @@
|
||||
# Architecture Interne du Relais (STM32L476RGT6) - /OS_relais
|
||||
|
||||
## 1. Contexte, Philosophie et Contraintes Matérielles
|
||||
|
||||
Le relais est le nœud d'acquisition autonome situé sur le site isolé de la **Grande Moucherolle**.
|
||||
|
||||
- **Cœur de calcul** : STMicroelectronics **STM32L476RGT6** (ARM Cortex-M4F avec FPU simple précision @ 80 MHz max, 1 Mo Flash, 128 Ko SRAM totale : 96 Ko SRAM1 + 32 Ko SRAM2).
|
||||
- **Contrainte opérationnelle majeure** : Autonomie stricte sur batterie en milieu de haute montagne (températures négatives, maintenance rare).
|
||||
- **Philosophie d'exécution** :
|
||||
- **Bare-metal pur** : Aucun OS généraliste (pas de Linux), aucun RTOS classique (pas de FreeRTOS, Zephyr ou embOS).
|
||||
- **System Layer propriétaire** : Une couche d'abstraction et d'orchestration légère, ultra-spécialisée, conçue spécifiquement pour le cycle de vie du relais météo (sommeil profond `Stop 2`, réveils périodiques ultra-courts, transmission planifiée).
|
||||
- **Zéro allocation dynamique** : Pas de tas (`no heap`), pas de `malloc`, pas de vecteur dynamique. Tous les buffers et structures sont statiquement alloués en mémoire SRAM2.
|
||||
- **Langages** :
|
||||
- **Rust (`no_std`)** : Langage d'implémentation principal et exclusif du firmware nominal (garanties d'absence de corruption mémoire, pas de garbage collector, typage strict, abstractions à coût nul).
|
||||
- **Assembleur (ASM)** : Réservé exclusivement si un besoin matériel impérieux l'exigeait (l'audit confirme que Rust `no_std` avec intrinsics Cortex-M suffit pour 100% du firmware nominal).
|
||||
- **C / C++** : Autorisé ponctuellement uniquement si une bibliothèque matérielle tierce incontournable est validée.
|
||||
- **Python** : Strictement externe au microcontrôleur (bancs de test PC, émulateurs de trames, analyseurs hors-ligne).
|
||||
|
||||
---
|
||||
|
||||
## 2. Modèle en Couches Logicielles
|
||||
|
||||
L'architecture interne est découpée en couches à responsabilités unilatérales et strictes :
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ APPLICATION RELAIS │
|
||||
│ - Orchestrateur Météo & Machine d'États Principale (FSM) │
|
||||
│ - Coordination Acquisition / Traitement / Sommeil / Émission│
|
||||
└──────────────────────────────┬──────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ PROTOCOLES & TÉLÉMÉTRIE │
|
||||
│ - Moteur Protocole Davis (Décodage trames, calcul grandeurs)│
|
||||
│ - Sérialiseur Télémétrie 169 MHz (Format surcouche, CRC) │
|
||||
│ - Parseur & Validateur des Commandes Descendantes │
|
||||
└──────────────────────────────┬──────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ SERVICES SYSTÈME │
|
||||
│ - Gestionnaire d'Énergie (Power Management Service - Stop 2)│
|
||||
│ - Planificateur Horaire & Politiques de Transmission (RTC) │
|
||||
│ - Gestionnaire de Persistance & Stockage (Flash Ping-Pong) │
|
||||
│ - Surveillance Watchdog & Intégrité Système (IWDG) │
|
||||
│ - Gestionnaire de Diagnostics & Métriques Système │
|
||||
└──────────────────────────────┬──────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ DRIVERS │
|
||||
│ - Driver CC1101 (868 MHz) : SPI, FIFO, Détection paquets │
|
||||
│ - Driver EBYTE E32-170T30D (169 MHz) : UART, M0/M1, AUX │
|
||||
│ - Driver Commutateurs d'Alimentation (Load Switches) │
|
||||
└──────────────────────────────┬──────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ ABSTRACTIONS MATÉRIELLES (HAL) │
|
||||
│ - GPIO, SPI, UART, RTC, Timers (LPTIM), ADC, Flash, EXTI │
|
||||
│ - Primitives CPU & Contrôle d'Horloges (MSI, HSI, LSE) │
|
||||
└──────────────────────────────┬──────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ BOOT / STARTUP │
|
||||
│ - cortex-m-rt, Vector Table, init SRAM2, FPU, saut main() │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Cartographie & Architecture Mémoire Silicium
|
||||
|
||||
### 3.1. Rétention Mémoire en Mode `Stop 2` : Distinction SRAM1 vs SRAM2
|
||||
|
||||
> [!IMPORTANT]
|
||||
> **Règle Silicium STM32L476** : En mode de veille ultra-basse consommation `Stop 2`, **SRAM1 (96 Ko) est entièrement coupée**. Seule **SRAM2 (32 Ko)** bénéficie d'une rétention de contenu configurable (via le bit `RRS` du registre `PWR_CR1`).
|
||||
>
|
||||
> En conséquence, l'ensemble des segments de mémoire vive nécessaires à la reprise d'exécution (pile, buffers, machine d'état, accumulateurs météo, table de politique) est impérativement alloué en **SRAM2**.
|
||||
|
||||
### 3.2. Linker Script (`memory.x`) et Segments Mémoire
|
||||
|
||||
```ld
|
||||
/* Linker script STM32L476RGT6 optimisé pour la rétention Stop 2 */
|
||||
MEMORY
|
||||
{
|
||||
/* Mémoire Flash interne (1 Mo) */
|
||||
FLASH (rx) : ORIGIN = 0x08000000, LENGTH = 1020K
|
||||
|
||||
/* Secteurs dédiés à la persistance Ping-Pong (Pages 510 et 511 - 4 Ko) */
|
||||
FLASH_STORAGE_A (r) : ORIGIN = 0x080FE000, LENGTH = 2K
|
||||
FLASH_STORAGE_B (r) : ORIGIN = 0x080FF000, LENGTH = 2K
|
||||
|
||||
/* SRAM2 (32 Ko) : Conservée en Stop 2 - Héberge Stack, Data et BSS */
|
||||
RAM (rwx) : ORIGIN = 0x10000000, LENGTH = 32K
|
||||
|
||||
/* SRAM1 (96 Ko) : Non conservée en Stop 2 - Utilisable pour buffers temporaires */
|
||||
SRAM1 (rwx) : ORIGIN = 0x20000000, LENGTH = 96K
|
||||
}
|
||||
|
||||
/* L'ensemble du runtime Rust pointe sur RAM (SRAM2) */
|
||||
_stack_start = ORIGIN(RAM) + LENGTH(RAM);
|
||||
```
|
||||
|
||||
### 3.3. Bilan d'Allocation SRAM2 (32 Ko)
|
||||
|
||||
| Composant Mémoire | Taille Allouée | Rôle Opérationnel | Rétention Stop 2 |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **Pile Principale (`MSP`)** | 4 096 octets (4 Ko) | Appels de fonctions, contextes d'interruption | Oui |
|
||||
| **Segment `.data`** | ~512 octets | Variables globales statiques initialisées | Oui |
|
||||
| **Segment `.bss`** | ~2 048 octets | Variables statiques mises à zéro au boot | Oui |
|
||||
| **File d'Événements (`EventQueue`)** | 256 octets | Tableau statique circulaire (16 événements $\times 16$ o) | Oui |
|
||||
| **Buffer Réception Davis (CC1101)** | 32 octets | Trame brute 868 MHz (14 octets) + métadonnées | Oui |
|
||||
| **Buffer Émission 169 MHz (E32)** | 256 octets | Trame surcouche encodée + CRC | Oui |
|
||||
| **Accumulateur & Agrégats Météo** | 1 024 octets (1 Ko) | Min, max, moyennes glissantes, augets pluie | Oui |
|
||||
| **Diagnostics & Métriques Santé** | 512 octets | Causes de reset, compteurs d'erreurs, durées | Oui |
|
||||
| **Cache Configuration Active** | 128 octets | Copie RAM de la politique horaire courante | Oui |
|
||||
| **Marge de Sécurité Libre** | ~19 Ko | Espace restant pour évolution | Oui |
|
||||
| **TOTAL SRAM2 UTILISÉ** | **~8.8 Ko / 32 Ko** | **Taux d'occupation : < 28%** | **100% conservé** |
|
||||
|
||||
### 3.4. Registres de Sauvegarde RTC (*Backup Domain*)
|
||||
- 32 registres de 32 bits (128 octets) situés dans le domaine de sauvegarde (`TAMP_BKPxR`), préservés tant que $V_{DD}$ ou $V_{BAT}$ est alimenté :
|
||||
- `BKP0R` : Dernier canal Davis actif (0 à 4) et phase de saut FHSS pour ré-accrochage immédiat sans scan.
|
||||
- `BKP1R` : Numéro de séquence monotone global des transmissions 169 MHz.
|
||||
- `BKP2R` : Compteur de réveils totaux depuis mise sous tension.
|
||||
- `BKP3R` : Cause du dernier reset (capturé depuis `RCC_CSR`).
|
||||
|
||||
---
|
||||
|
||||
## 4. Boot et Séquence de Démarrage
|
||||
|
||||
### 4.1. Chronologie du Reset à l'Exécution Applicative
|
||||
1. **Événement Reset Matériel** : Sortie de reset (Power-On Reset, Brown-Out, Watchdog ou Pin Reset).
|
||||
2. **Table des Vecteurs d'Interruption** :
|
||||
- Chargement du pointeur de pile initial (`MSP`) situé à l'adresse `0x08000000` (pointant sur le sommet de SRAM2 : `0x10008000`).
|
||||
- Saut vers le vecteur de `Reset_Handler` (`cortex-m-rt`).
|
||||
3. **Phase de Startup Minimal** :
|
||||
- Désactivation globale précoce des interruptions masquables (`cpsid i`).
|
||||
- Activation du coprocesseur FPU via le registre `CPACR` (bits 20 à 23) et activation de l'empilement paresseux (*Lazy Stacking* via `FPCCR.LSPEN`) pour éviter d'empiler les registres flottants dans les ISR.
|
||||
- Initialisation de la mémoire vive en SRAM2 :
|
||||
- Copie du segment `.data` de la Flash (LMA) vers SRAM2 (VMA `0x10000000`).
|
||||
- Mise à zéro (*zero-fill*) du segment `.bss` en SRAM2.
|
||||
- Configuration du registre `VTOR` (Vector Table Offset Register) sur `0x08000000`.
|
||||
4. **Initialisation Système Précoce** :
|
||||
- Analyse de `RCC_CSR` pour capturer la cause exacte du reset et enregistrement dans `BKP3R`.
|
||||
- Configuration de l'horloge système nominale : démarrage sur oscillateur interne **MSI à 16 MHz** (pas de PLL pour limiter la consommation et éliminer les 100 µs de verrouillage).
|
||||
- Initialisation de l'oscillateur basse consommation LSE 32.768 kHz pour la RTC.
|
||||
5. **Entrée dans l'Application Rust** :
|
||||
- Réactivation contrôlée des interruptions (`cpsie i`).
|
||||
- Appel du point d'entrée Rust `main()` (`#[no_std]`).
|
||||
|
||||
---
|
||||
|
||||
## 5. Architecture des Interruptions et Événements
|
||||
|
||||
### 5.1. Cartographie des Sources d'Interruption
|
||||
|
||||
| Source d'Interruption | Vecteur NVIC / Ligne EXTI | Rôle Opérationnel | Priorité relative |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **Radio 868 MHz (CC1101)** | EXTI Pin (GDO0 / Sync Word) | Notification de réception d'un paquet Davis | Haute |
|
||||
| **Radio 169 MHz (E32 AUX)** | EXTI Pin (Ligne AUX) | Notification : module prêt / fin d'émission RF | Moyenne |
|
||||
| **Radio 169 MHz (UART RX)** | USARTx Global Interrupt | Réception d'octets d'un ordre descendant | Moyenne |
|
||||
| **RTC Wakeup Timer / Alarme**| EXTI Ligne 20 (RTC Wakeup) | Réveil périodique depuis le mode sommeil Stop 2 | Haute |
|
||||
| **Surveillance Tension (PVD)**| EXTI Ligne 16 (PVD) | Détection de chute critique de tension batterie | Critique |
|
||||
| **Watchdog (IWDG)** | Hardware Independent | Réinitialisation matérielle en cas de blocage | Maximale |
|
||||
|
||||
### 5.2. Philosophie de Traitement des Interruptions (*Short ISR*)
|
||||
Les routines de service d'interruption (ISR) respectent une règle stricte : **aucun traitement lourd dans l'ISR**.
|
||||
|
||||
- L'ISR se limite à :
|
||||
1. Acquitter le drapeau d'interruption matériel (*clear pending flag*) ;
|
||||
2. Capturer le contexte minimal (ex. timestamp RTC, statut brut) ;
|
||||
3. Pousser un descripteur d'événement typé dans la file d'événements circulaire statique (`EventQueue`) en section critique courte ;
|
||||
4. Réveiller le processeur si celui-ci était en veille (`WFI` / `WFE`).
|
||||
- Les opérations lourdes (lecture SPI du CC1101, décodage Davis, calculs météorologiques, écritures Flash) sont différées et exécutées par la machine d'états dans la boucle principale.
|
||||
|
||||
---
|
||||
|
||||
---
|
||||
|
||||
## 6. Machine d'États Principale du Relais (FSM)
|
||||
|
||||
```mermaid
|
||||
stateDiagram-v2
|
||||
[*] --> BOOT
|
||||
BOOT --> INIT : Init CPU, FPU, Vector Table
|
||||
INIT --> DAVIS_SCAN : Storage Load, RTC OK, IWDG Start
|
||||
|
||||
DAVIS_SCAN --> SYSTEM_IDLE_SLEEP : 1er paquet Davis reçu (Sync OK)
|
||||
DAVIS_SCAN --> ERROR_SAFE_MODE : Timeout scan (30s) sans paquet
|
||||
|
||||
SYSTEM_IDLE_SLEEP --> DAVIS_SYNC : Tick RTC Davis (~2.5s)
|
||||
SYSTEM_IDLE_SLEEP --> TRANSMISSION_169 : Tick RTC Schedule (1 min / 10 min)
|
||||
|
||||
DAVIS_SYNC --> DAVIS_PROCESS : Paquet capturé (EXTI GDO0)
|
||||
DAVIS_SYNC --> DAVIS_PROCESS : Timeout écoute (18 ms)
|
||||
|
||||
DAVIS_PROCESS --> SYSTEM_IDLE_SLEEP : Agrégats mis à jour / CC1101 OFF
|
||||
DAVIS_PROCESS --> DAVIS_SCAN : Synchro perdue (> 10 tirs manqués)
|
||||
|
||||
TRANSMISSION_169 --> DOWNLINK_LISTEN : Trame transmise (AUX haut)
|
||||
TRANSMISSION_169 --> ERROR_SAFE_MODE : Erreur UART / Timeout AUX
|
||||
|
||||
DOWNLINK_LISTEN --> COMMAND_PROCESSING : Données reçues sur UART
|
||||
DOWNLINK_LISTEN --> SYSTEM_IDLE_SLEEP : Fin fenêtre écoute (1.0s)
|
||||
|
||||
COMMAND_PROCESSING --> SYSTEM_IDLE_SLEEP : Commande appliquée / Flash OK
|
||||
COMMAND_PROCESSING --> SYSTEM_IDLE_SLEEP : Commande invalide (rejetée)
|
||||
|
||||
ERROR_SAFE_MODE --> SYSTEM_IDLE_SLEEP : Fallback safe params (10 min)
|
||||
```
|
||||
|
||||
### 6.1. Description Formelle des États et Transitions
|
||||
|
||||
| État | Rôle & Actions Entrée | Événements Déclencheurs | Actions Sortie & Transitions |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **`BOOT`** | Init bas niveau CPU, configuration MSP, vecteur table. | Fin d'initialisation matérielle. | $\rightarrow$ `INIT`. |
|
||||
| **`INIT`** | Chargement configuration Flash (StorageManager), init RTC, démarrage IWDG (8s). | Config Flash valide ou valeurs par défaut chargées. | $\rightarrow$ `DAVIS_SCAN`. |
|
||||
| **`DAVIS_SCAN`** | Écoute continue sur canal 0 (868.0 MHz) pour accrochage à froid de l'ISS. | Paquet Davis valide reçu OU Timeout de 30s. | Si reçu : calcul intervalle ($T = \frac{41+ID}{16}\text{ s}$), calage phase $\rightarrow$ `SYSTEM_IDLE_SLEEP`. Si timeout $\rightarrow$ `ERROR_SAFE_MODE`. |
|
||||
| **`SYSTEM_IDLE_SLEEP`** | Extinction périphériques inutiles, parking GPIO analogique, mode `Stop 2` via `WFI`. | Réveil RTC Wakeup Timer (Davis) OU Alarme RTC (169 MHz). | Rétablissement horloge MSI 16 MHz, dispatch événement vers `DAVIS_SYNC` ou `TRANSMISSION_169`. |
|
||||
| **`DAVIS_SYNC`** | Réveil ~3 ms avant tir estimé, mise sous tension CC1101, écoute sur canal FHSS. | Interruption EXTI GDO0 (paquet reçu) OU Timeout timer (18 ms). | Extinction CC1101, passage en `DAVIS_PROCESS`. |
|
||||
| **`DAVIS_PROCESS`** | Décodage trame, contrôle CRC Davis, injection dans l'accumulateur météo, recalage drift. | Fin de traitement ou comptabilisation paquet perdu. | Si > 10 pertes $\rightarrow$ `DAVIS_SCAN`, sinon `SYSTEM_IDLE_SLEEP`. |
|
||||
| **`TRANSMISSION_169`** | Sérialisation trame surcouche, réveil E32 (Mode 0), émission UART, contrôle AUX. | Signal AUX repassant à l'état haut (fin émission RF). | $\rightarrow$ `DOWNLINK_LISTEN`. Si erreur/timeout AUX $\rightarrow$ `ERROR_SAFE_MODE`. |
|
||||
| **`DOWNLINK_LISTEN`** | Maintien du module E32 en écoute pendant 1.0 seconde (timer LPTIM). | Octets reçus sur UART OU Échéance du timer 1.0s. | Si octets $\rightarrow$ `COMMAND_PROCESSING`, sinon extinction E32 $\rightarrow$ `SYSTEM_IDLE_SLEEP`. |
|
||||
| **`COMMAND_PROCESSING`** | Validation syntaxe, validation CRC, contrôle limites, écriture Flash Ping-Pong. | Fin d'application de la commande ou rejet. | Extinction E32 (Mode 3), retour en `SYSTEM_IDLE_SLEEP`. |
|
||||
| **`ERROR_SAFE_MODE`** | Enregistrement métrique d'erreur, basculement sur politique de repli (10 min). | Reprise nominale ou re-scan. | Retour en `SYSTEM_IDLE_SLEEP` ou `DAVIS_SCAN`. |
|
||||
|
||||
---
|
||||
|
||||
## 7. Architecture de la File d'Événements (`EventQueue`)
|
||||
|
||||
L'exécution est régie par une file d'événements circulaire statique allouée en SRAM2 :
|
||||
|
||||
```rust
|
||||
#[repr(u8)]
|
||||
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
|
||||
pub enum SystemEvent {
|
||||
RtcDavisTick, // Réveil pour capture Davis (~2.5s)
|
||||
RtcTransmitTick, // Réveil pour transmission 169 MHz
|
||||
DavisPacketReady, // CC1101 GDO0 actif (paquet en FIFO)
|
||||
DavisTimeout, // Fin de fenêtre d'écoute Davis (18 ms)
|
||||
Radio169AuxReady, // Module E32 disponible / fin d'émission RF
|
||||
Radio169RxByte(u8), // Octet descendant reçu sur UART
|
||||
Radio169ListenEnd, // Fin de la fenêtre d'écoute 1.0s
|
||||
BatteryVoltageWarning, // Tension batterie sous le seuil d'alerte
|
||||
WatchdogRefresh, // Tick périodique de rafraîchissement IWDG
|
||||
}
|
||||
|
||||
pub struct StaticEventQueue<const CAP: usize> {
|
||||
buffer: [SystemEvent; CAP],
|
||||
head: usize,
|
||||
tail: usize,
|
||||
count: usize,
|
||||
overflow_count: u32,
|
||||
}
|
||||
|
||||
impl<const CAP: usize> StaticEventQueue<CAP> {
|
||||
pub const fn new() -> Self {
|
||||
Self {
|
||||
buffer: [SystemEvent::RtcDavisTick; CAP],
|
||||
head: 0,
|
||||
tail: 0,
|
||||
count: 0,
|
||||
overflow_count: 0,
|
||||
}
|
||||
}
|
||||
|
||||
/// Insertion thread-safe depuis une ISR via section critique courte
|
||||
pub fn push_isr(&mut self, event: SystemEvent) -> bool {
|
||||
if self.count >= CAP {
|
||||
self.overflow_count = self.overflow_count.saturating_add(1);
|
||||
return false;
|
||||
}
|
||||
self.buffer[self.head] = event;
|
||||
self.head = (self.head + 1) % CAP;
|
||||
self.count += 1;
|
||||
true
|
||||
}
|
||||
|
||||
/// Consommation dans la boucle principale
|
||||
pub fn pop(&mut self) -> Option<SystemEvent> {
|
||||
if self.count == 0 {
|
||||
return None;
|
||||
}
|
||||
let event = self.buffer[self.tail];
|
||||
self.tail = (self.tail + 1) % CAP;
|
||||
self.count -= 1;
|
||||
Some(event)
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. Services Système
|
||||
|
||||
### 8.1. Service Gestionnaire d'Énergie (`PowerManager`)
|
||||
|
||||
- **Bilan Consommation par État** :
|
||||
- STM32L4 en mode `Stop 2` (SRAM2 + RTC LSE active) : **~1.2 µA**
|
||||
- STM32L4 en mode actif (MSI 16 MHz) : **~2 mA**
|
||||
- CC1101 en veille (Power Down) : **~0.2 µA**
|
||||
- CC1101 en écoute active RX (868 MHz) : **~15 mA**
|
||||
- E32-170T30D en Mode 3 (Sleep) : **~3 µA**
|
||||
- E32-170T30D en écoute active RX (169 MHz) : **~18 mA**
|
||||
- E32-170T30D en émission TX (+27 dBm / 500 mW ERP) : **~450 mA**
|
||||
|
||||
- **Séquence Formelle d'Entrée en `Stop 2`** :
|
||||
1. Vérification que les bus SPI et UART sont inactifs.
|
||||
2. Coupure des horloges périphériques APB1/APB2 non requises.
|
||||
3. Parking de l'ensemble des broches GPIO inutilisées en mode **Analogique sans tirage** (élimination des courants de fuite sur broches flottantes). Maintien strict des broches de réveil EXTI (GDO0, AUX) avec leur configuration d'interruption.
|
||||
4. Coupure de l'alimentation des transceivers via les *Load Switches* (si phase de veille prolongée).
|
||||
5. Positionnement du bit `PWR_CR1.RRS = 1` (rétention SRAM2 garantie).
|
||||
6. Positionnement des bits `PWR_CR1.LPMS[2:0] = 010` (sélection du mode Stop 2).
|
||||
7. Activation de `SCB_SCR.SLEEPDEEP = 1`.
|
||||
8. Exécution des barrières de synchronisation et mise en sommeil :
|
||||
```rust
|
||||
cortex_m::asm::dsb();
|
||||
cortex_m::asm::isb();
|
||||
cortex_m::asm::wfi();
|
||||
```
|
||||
|
||||
- **Séquence Formelle de Sortie de `Stop 2`** :
|
||||
1. Réveil instantané du cœur CPU sur l'oscillateur MSI (16 MHz, ~5 µs).
|
||||
2. Acquittement des drapeaux d'interruption de réveil dans `PWR_SCR` et `EXTI_PR1`.
|
||||
3. Restauration de la configuration GPIO des périphériques requis pour l'événement (SPI pour CC1101, UART pour E32).
|
||||
4. Réactivation des bus et traitement de l'événement.
|
||||
|
||||
### 8.2. Service Planificateur Horaire (`ScheduleManager`)
|
||||
|
||||
- **Format Binaire de la Table de Politique (`TransmissionPolicyTable`)** :
|
||||
```rust
|
||||
#[repr(C, packed)]
|
||||
#[derive(Copy, Clone, Debug)]
|
||||
pub struct TimeWindowRule {
|
||||
pub start_hour: u8, // 0..23
|
||||
pub start_minute: u8, // 0..59
|
||||
pub end_hour: u8, // 0..23
|
||||
pub end_minute: u8, // 0..59
|
||||
pub interval_seconds: u16, // Ex: 60 ou 600
|
||||
pub flags: u16, // Réservé / Options
|
||||
}
|
||||
|
||||
#[repr(C, packed)]
|
||||
#[derive(Copy, Clone, Debug)]
|
||||
pub struct TransmissionPolicyTable {
|
||||
pub magic: u32, // 0x504F4C59 ("POLY")
|
||||
pub version: u16, // Version incrémentale
|
||||
pub num_rules: u8, // Nombre de règles actives (1 à 4)
|
||||
pub default_interval_s: u16, // Intervalle hors plages (ex: 600s)
|
||||
pub rules: [TimeWindowRule; 4],
|
||||
pub checksum: u16, // CRC-16 CCITT
|
||||
}
|
||||
```
|
||||
|
||||
- **Algorithme d'Évaluation et de Programmation RTC** :
|
||||
1. Lecture de l'heure et minute courantes dans les registres RTC BCD (`RTC_TR`).
|
||||
2. Conversion en minutes du jour : $M_{cur} = \text{hour} \times 60 + \text{min}$.
|
||||
3. Recherche dans les règles actives :
|
||||
- Règle intra-journée ($M_{start} \le M_{end}$) : Active si $M_{start} \le M_{cur} < M_{end}$.
|
||||
- Règle à cheval sur minuit ($M_{start} > M_{end}$) : Active si $M_{cur} \ge M_{start} \lor M_{cur} < M_{end}$.
|
||||
4. Si règle active $\rightarrow$ intervalle = `rule.interval_seconds`, sinon intervalle = `default_interval_s`.
|
||||
5. Calcul du prochain réveil RTC et programmation de l'Alarme A.
|
||||
6. **Repli de Sécurité (Safe Mode)** : En cas de table invalide ou d'heure non synchronisée, l'intervalle est fixé à **600 secondes (10 minutes)**.
|
||||
|
||||
### 8.3. Service Persistance & Stockage Flash (`StorageManager`)
|
||||
|
||||
- **Architecture Ping-Pong A/B (2 pages de 2 Ko)** :
|
||||
- **Slot A** : Page 510 (`0x080FE000` - 2048 octets).
|
||||
- **Slot B** : Page 511 (`0x080FF000` - 2048 octets).
|
||||
|
||||
- **Structure du Header de Slot (Alignement 64 bits)** :
|
||||
```rust
|
||||
#[repr(C, align(8))]
|
||||
pub struct FlashSlotHeader {
|
||||
pub magic: u32, // 0x47575354 ("GWST" = Gastinel Weather STorage)
|
||||
pub sequence_number: u32, // Numéro de séquence strictement croissant
|
||||
pub payload_len: u16, // Taille exacte de la charge utile
|
||||
pub payload_version: u16, // Version du schéma
|
||||
pub crc32: u32, // CRC32 IEEE 802.3 calculé sur le payload
|
||||
pub reserved: u32, // Alignement
|
||||
pub commit_mark: u64, // 0x55AA55AA_55AA55AA (programmé en dernier !)
|
||||
}
|
||||
```
|
||||
|
||||
- **Protocole d'Écriture Atomique et Résistant aux Coupures** :
|
||||
1. Identifier le slot actif (magic valide, CRC32 conforme, `commit_mark == 0x55AA55AA_55AA55AA`, plus grand `sequence_number`).
|
||||
2. Sélectionner le slot inactif cible.
|
||||
3. Déverrouiller le contrôleur Flash (`FLASH_KEYR`).
|
||||
4. Effacer entièrement la page de 2 Ko du slot cible.
|
||||
5. Écrire le header avec `commit_mark = 0xFFFFFFFF_FFFFFFFF` (non validé) suivi du payload par mots doubles (64 bits).
|
||||
6. Relire la page Flash et recalculer le CRC32 sur le payload écrit.
|
||||
7. Si le CRC correspond : programmer le mot double `commit_mark = 0x55AA55AA_55AA55AA`.
|
||||
8. Verrouiller la Flash (`FLASH_CR.LOCK = 1`).
|
||||
9. Si une coupure survient avant la programmation du `commit_mark`, le slot cible est ignoré au redémarrage et le slot actif précédent reste intact.
|
||||
|
||||
---
|
||||
|
||||
## 9. Drivers Périphériques
|
||||
|
||||
### 9.1. Driver CC1101 (868 MHz)
|
||||
- **Interface** : Bus SPI1 (NSS, SCK, MISO, MOSI) + broche EXTI GDO0.
|
||||
- **Paramètres Radio Davis** : Fréquence centrale 868.0 MHz (5 canaux espacés de 125 kHz), modulation 2-FSK, débit 19.2 kbps, Sync Word Davis `0xCB89` (canal normal).
|
||||
- **Fenêtre de Réception Calibrée** : **12 à 20 ms** (prise en compte de la durée du paquet de 5.83 ms et des dérives d'oscillateurs thermiques $\pm 20\text{ ppm}$).
|
||||
- **Responsabilité Stricte** : Gestion des registres, transfert FIFO SPI, lecture RSSI/LQI. Renvoie un buffer brut de 14 octets sans interprétation métier.
|
||||
|
||||
### 9.2. Driver EBYTE E32-170T30D (169 MHz)
|
||||
- **Interface** : USART2 (9600 bauds, 8N1) + broches GPIO `M0`, `M1` + broche d'état `AUX` (EXTI).
|
||||
- **Puissance RF Conforme** : Calibrée à **+27 dBm (500 mW ERP max)** pour respecter la réglementation ERC 70-03 Annexe 1 sur la sous-bande 169.400–169.475 MHz.
|
||||
- **Pilotage des Modes** :
|
||||
- `Mode 3` (Sleep) : $M_0 = 1, M_1 = 1$ (consommation $\sim 3\text{ }\mu\text{A}$).
|
||||
- `Mode 0` (Normal) : $M_0 = 0, M_1 = 0$ (émission UART et écoute).
|
||||
- **Gestion Stricte de la Broche `AUX`** :
|
||||
- Lors du réveil (Mode 3 $\rightarrow$ Mode 0), attendre le front montant d'AUX ($\sim 2$ à $5\text{ ms}$) avant d'écrire sur l'UART.
|
||||
- Après émission de la trame UART, attendre le front descendant puis le front montant d'AUX confirmant que l'amplificateur RF a achevé la transmission aérienne.
|
||||
|
||||
---
|
||||
|
||||
## 10. Contrats d'Interfaces Rust (`no_std`)
|
||||
|
||||
```rust
|
||||
/// Trait d'abstraction de la réception Davis 868 MHz
|
||||
pub trait Radio868Receiver {
|
||||
type Error;
|
||||
fn init(&mut self) -> Result<(), Self::Error>;
|
||||
fn set_channel(&mut self, channel: u8) -> Result<(), Self::Error>;
|
||||
fn start_listening(&mut self) -> Result<(), Self::Error>;
|
||||
fn read_packet(&mut self, buf: &mut [u8; 16]) -> Result<Option<u8>, Self::Error>;
|
||||
fn sleep(&mut self) -> Result<(), Self::Error>;
|
||||
}
|
||||
|
||||
/// Trait d'abstraction du transceiver 169 MHz
|
||||
pub trait Radio169Transceiver {
|
||||
type Error;
|
||||
fn init(&mut self) -> Result<(), Self::Error>;
|
||||
fn send_payload(&mut self, payload: &[u8]) -> Result<(), Self::Error>;
|
||||
fn start_downlink_window(&mut self) -> Result<(), Self::Error>;
|
||||
fn poll_downlink(&mut self, buf: &mut [u8]) -> Result<Option<usize>, Self::Error>;
|
||||
fn sleep(&mut self) -> Result<(), Self::Error>;
|
||||
}
|
||||
|
||||
/// Trait de gestion de l'énergie et de la veille
|
||||
pub trait PowerController {
|
||||
fn enter_stop2(&mut self);
|
||||
fn restore_active_clocks(&mut self);
|
||||
fn park_gpios(&mut self);
|
||||
}
|
||||
|
||||
/// Trait de persistance Flash
|
||||
pub trait PersistentStorage {
|
||||
type Error;
|
||||
fn load_policy(&self, policy: &mut TransmissionPolicyTable) -> Result<(), Self::Error>;
|
||||
fn save_policy(&mut self, policy: &TransmissionPolicyTable) -> Result<(), Self::Error>;
|
||||
}
|
||||
|
||||
/// Trait de l'horloge temps réel
|
||||
pub trait RtcProvider {
|
||||
type Error;
|
||||
fn get_time_minutes_of_day(&self) -> u16;
|
||||
fn set_alarm_seconds(&mut self, seconds: u32) -> Result<(), Self::Error>;
|
||||
fn clear_alarm(&mut self);
|
||||
}
|
||||
|
||||
/// Trait du moteur de décodage Davis
|
||||
pub trait DavisDecoderEngine {
|
||||
type Error;
|
||||
fn decode_packet(raw: &[u8; 10]) -> Result<DavisMeasurement, Self::Error>;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 11. Arborescence Cible du Code (`/OS_relais`)
|
||||
|
||||
```
|
||||
/OS_relais
|
||||
├── Cargo.toml # Configuration Rust no_std (cortex-m, cortex-m-rt)
|
||||
├── memory.x # Linker script STM32L476RGT6 (Flash 1Mo, SRAM2 32Ko)
|
||||
├── build.rs # Script de build et validation linker
|
||||
└── src/
|
||||
├── main.rs # Point d'entrée, initialisation et boucle événementielle
|
||||
├── hal/ # Abstractions matérielles pures
|
||||
│ ├── mod.rs
|
||||
│ ├── gpio.rs # Configuration des broches & parking analogique
|
||||
│ ├── spi.rs # Interface SPI1 maître (CC1101)
|
||||
│ ├── uart.rs # Interface USART2 (E32)
|
||||
│ ├── rtc.rs # Horloge RTC, alarmes et backup registers
|
||||
│ ├── adc.rs # Mesure Vbat/3 et température die
|
||||
│ ├── flash.rs # Primitives d'effacement et écriture mots doubles
|
||||
│ ├── iwdg.rs # Watchdog indépendant
|
||||
│ └── pwr.rs # Registres PWR STM32L4 (Stop 2)
|
||||
├── drivers/ # Drivers de périphériques externes
|
||||
│ ├── mod.rs
|
||||
│ ├── cc1101.rs # Driver matériel CC1101 868 MHz
|
||||
│ ├── e32_170t30d.rs # Driver modem EBYTE 169 MHz (UART + M0/M1/AUX)
|
||||
│ └── pwr_switch.rs # Commande des Load Switches
|
||||
├── services/ # Services système d'orchestration
|
||||
│ ├── mod.rs
|
||||
│ ├── power_manager.rs # Gestion des transitions de sommeil Stop 2
|
||||
│ ├── schedule_manager.rs # Moteur des politiques horaires de transmission
|
||||
│ ├── storage_manager.rs # Persistance Flash Ping-Pong A/B
|
||||
│ ├── watchdog_manager.rs # Surveillance de santé système
|
||||
│ └── diag_manager.rs # Métriques et compteurs de diagnostic
|
||||
├── protocol/ # Protocoles de données indépendants du matériel
|
||||
│ ├── mod.rs
|
||||
│ ├── davis/ # Décodage Davis Vantage Pro2
|
||||
│ │ ├── mod.rs
|
||||
│ │ ├── crc.rs # Vérification CRC-16 Davis
|
||||
│ │ └── decoder.rs # Décodage vent, pluie, température, humidité
|
||||
│ └── telemetry_169/ # Télémétrie montante et commandes descendantes
|
||||
│ ├── mod.rs
|
||||
│ ├── framing.rs # En-têtes, numéros de séquence, CRC32
|
||||
│ └── serializer.rs # Encodage binaire compact
|
||||
├── events/ # Gestion événementielle
|
||||
│ ├── mod.rs
|
||||
│ └── event_queue.rs # File statique d'événements circulaire lock-free
|
||||
└── app/ # Couche applicative haute
|
||||
├── mod.rs
|
||||
├── state_machine.rs # Machine d'états principale du relais (FSM)
|
||||
└── aggregator.rs # Agrégation météo glissante (min, max, moyennes)
|
||||
```
|
||||
@@ -0,0 +1,98 @@
|
||||
# Architecture Station (Raspberry Pi 4) - /OS_station
|
||||
|
||||
## 1. Contexte & Environnement Système
|
||||
|
||||
La station réceptrice est localisée sur le site domestique (en vallée).
|
||||
|
||||
- **Cible matérielle** : Single Board Computer **Raspberry Pi 4 Model B** (Broadcom BCM2711, Quad-core Cortex-A72 ARMv8 64-bit).
|
||||
- **Système d'exploitation** : **Debian GNU/Linux ARM64** en mode **headless** (sans interface graphique, allégé).
|
||||
- **Interfaces matérielles & réseau** :
|
||||
- **Module Récepteur 169 MHz** : Raccordé via UART (GPIO série RPi) ou SPI/USB.
|
||||
- **Interface Réseau** : Port Ethernet RJ45 Gigabit raccordé au réseau local du serveur domestique.
|
||||
- **Accès d'administration** : Accès distant sécurisé via OpenSSH (clés SSH, sans mot de passe).
|
||||
|
||||
---
|
||||
|
||||
## 2. Choix des Langages & Architecture Logicielle
|
||||
|
||||
- **C++ (C++20)** : Langage privilégié pour les services critiques d'acquisition radio, de décodage, de bufferisation locale et de transmission réseau (haute performance, gestion fine des ressources, typage fort).
|
||||
- **Python (Python 3)** : Utilisé pour les outils de diagnostic, scripts de maintenance, bancs de test et utilitaires d'analyse de données.
|
||||
|
||||
---
|
||||
|
||||
## 3. Rôles et Responsabilités du Système
|
||||
|
||||
La station assure le rôle de passerelle intelligente entre la liaison radio VHF longue portée (169 MHz) et le réseau local IP du serveur de stockage.
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ ADMINISTRATION & CLI │
|
||||
│ - Accès SSH, Outils de diagnostic & supervision │
|
||||
└──────────────────────────────┬──────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ SERVICES STATION (C++ / Linux) │
|
||||
│ │
|
||||
│ ┌───────────────────────┐ ┌───────────────────────┐ │
|
||||
│ │ Service Réception │ │ Service Ingestion │ │
|
||||
│ │ Radio 169 MHz │ │ & Commande Serveur │ │
|
||||
│ └───────────┬───────────┘ └───────────▲───────────┘ │
|
||||
│ │ │ │
|
||||
│ ▼ │ │
|
||||
│ ┌───────────────────────────────────────────┴───────────┐ │
|
||||
│ │ Validation de Trames & Décodage Surcouche │ │
|
||||
│ └───────────────────────────┬───────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌───────────────────────────────────────────────────────┐ │
|
||||
│ │ Stockage Tampon Local (Buffer Anti-Coupure) │ │
|
||||
│ └───────────────────────────┬───────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌───────────────────────────────────────────────────────┐ │
|
||||
│ │ Client de Synchronisation & Export Réseau (Vers SRV) │ │
|
||||
│ └───────────────────────────────────────────────────────┘ │
|
||||
└──────────────────────────────┬──────────────────────────────┘
|
||||
│
|
||||
┌───────────────┴───────────────┐
|
||||
▼ ▼
|
||||
[Récepteur 169 MHz] [Réseau Ethernet RJ45]
|
||||
(Liaison vers Relais) (Liaison vers Serveur)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Composants Détaillés
|
||||
|
||||
### 4.1. Service Réception Radio 169 MHz
|
||||
- Écoute continue sur l'interface matérielle (UART / SPI / USB) raccordée au module récepteur 169 MHz.
|
||||
- Extraction des paquets du flux d'octets bruts (détection de préambule, délimiteurs de trame).
|
||||
- Horodatage précis de réception locale (timestamp UNIX haute résolution).
|
||||
|
||||
### 4.2. Moteur de Validation & Décodage
|
||||
- Vérification d'intégrité (contrôle de redondance cyclique - CRC).
|
||||
- Vérification syntaxique du schéma de trame défini dans `/surcouche`.
|
||||
- Enregistrement des métriques radio associées : RSSI (puissance du signal reçu), LQI (qualité du lien), taux d'erreur de trame.
|
||||
|
||||
### 4.3. Stockage Tampon Local (*Local Buffer*)
|
||||
- **Objectif** : Zéro perte de données en cas d'arrêt, de redémarrage ou d'indisponibilité temporaire du serveur domestique ou du réseau local.
|
||||
- **Principe de fonctionnement** :
|
||||
- Chaque trame valide reçue est immédiatement persistée dans un stockage local (base de données légère type SQLite ou journal binaire append-only horodaté).
|
||||
- Un pointeur d'acquittement (*watermark / sync status*) suit l'état de synchronisation avec le serveur domestique.
|
||||
- Dès rétablissement de la connectivité avec le serveur, les données en attente sont déversées dans l'ordre chronologique.
|
||||
|
||||
### 4.4. Client d'Export Réseau & Synchronisation
|
||||
- Maintient la communication réseau avec le service d'ingestion du serveur domestique via Ethernet RJ45.
|
||||
- Transmet les paquets météo et diagnostics validés.
|
||||
- Reçoit l'acquittement du serveur pour marquer les trames comme synchronisées dans le tampon local.
|
||||
|
||||
### 4.5. Gestionnaire de Commandes et Politiques Descendantes
|
||||
- Réceptionne les ordres de configuration émis par le serveur domestique (ex. modification de la politique d'horaires de transmission du relais).
|
||||
- Maintient la file d'attente des commandes à destination du relais.
|
||||
- Transmet les commandes vers le module radio 169 MHz au moment opportun (aux fenêtres d'écoute configurées du relais).
|
||||
|
||||
### 4.6. Gestion Système sous Linux Debian
|
||||
- Les services tournent sous forme de démons **systemd** autonomes avec redémarrage automatique en cas d'anomalie.
|
||||
- Journalisation centralisée via `systemd-journald` / `syslog`.
|
||||
- Métriques d'état système exposées pour surveillance locale.
|
||||
@@ -0,0 +1,190 @@
|
||||
# Rapport d'Audit Technique Critique : Architecture /OS_relais (STM32L476RGT6)
|
||||
|
||||
**Projet** : Gastinel.Weather.169
|
||||
**Cible** : Nœud Relais autonome (Site de la Grande Moucherolle)
|
||||
**Date d'audit** : 2026-08-28
|
||||
**Statut** : Rapport d'audit préalable à l'implémentation
|
||||
|
||||
---
|
||||
|
||||
## 1. Synthèse Exécutive de l'Audit
|
||||
|
||||
L'audit technique de l'architecture interne de `/OS_relais` met en évidence une structure globale cohérente et bien découplée, mais révèle **plusieurs hypothèses erronées, sous-estimations physiques et choix prématurés** qui auraient conduit à des défaillances critiques en phase d'implémentation :
|
||||
|
||||
1. **[ERREUR CRITIQUE] Perte de données en mode `Stop 2` (SRAM1 vs SRAM2)** :
|
||||
Sur le STM32L476, le mode de veille ultra-basse consommation `Stop 2` **coupe l'alimentation de la SRAM1 (96 Ko)**. Seule la **SRAM2 (32 Ko)** est retenue. Toute la mémoire vive active (pile, buffers, machine d'état) doit impérativement être mappée dans SRAM2 par le linker script.
|
||||
2. **[ERREUR CRITIQUE] Fenêtre d'écoute Davis 868 MHz physiquement impossible** :
|
||||
L'hypothèse d'une durée d'écoute de "3 à 5 ms" est invalide : la durée d'émission d'un paquet Davis dans les airs est de **~5.8 ms** (14 octets @ 19.2 kbps). Avec les dérives d'oscillateurs en milieu montagnard, la fenêtre de réception doit être dimensionnée entre **10 et 20 ms**.
|
||||
3. **[À VÉRIFIER / RÉGLEMENTATION] Confusion entre Puissance Maximale du Module (1 W) et Puissance Réglementaire (ERP)** :
|
||||
Le module E32-170T30D est capable de +30 dBm (1 W conduit), mais la réglementation européenne/française (ERC 70-03 / ARCEP) sur la bande 169 MHz impose des limites strictes de PAR/ERP (typiquement 500 mW ERP max selon la sous-bande) et des limitations de rapport cyclique (*duty cycle* $\le 10\%$ ou $\le 1\%$).
|
||||
4. **[HYPOTHÈSE NON JUSTIFIÉE] Valeur ajoutée de l'Assembleur (ASM)** :
|
||||
L'analyse fine montre que le compilateur Rust (`no_std`) combiné au runtime `cortex-m-rt` génère du code machine Cortex-M4 optimal. L'utilisation d'ASM manuscrit n'apporte aucun gain mesurable de consommation ou de performance pour le startup ou la mise en veille.
|
||||
|
||||
---
|
||||
|
||||
## 2. Audit Détaillé Point par Point
|
||||
|
||||
### 2.1. Cible STM32L476RGT6 & Silicium
|
||||
|
||||
| Paramètre | Hypothèse Initiale | Réalité Technique Silicium | Impact & Classification |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **Rétention SRAM en `Stop 2`** | "Rétention totale de la SRAM 128 Ko" | **SRAM1 (96 Ko) est éteinte** ; seule **SRAM2 (32 Ko)** est conservée sous tension (Section 5.3.4 Reference Manual RM0351). | **[ERREUR]** : Le linker script (`memory.x`) doit mapper la pile, le BSS et les données vives exclusivement dans la plage SRAM2 (`0x10000000` - 32 Ko). |
|
||||
| **Clocks & Réveil** | Réveil en 5 µs sur MSI | Réveil MSI en 5 µs nominal, mais stabilisation du PLL (si utilisé) requiert ~100 µs. Pour un réveil périodique Davis, le MCU doit tourner directement sur MSI @ 16/24 MHz sans PLL. | **[VALIDÉ AVEC RESTRICTION]** : Exécuter l'acquisition Davis sur horloge MSI sans réenclencher la PLL. |
|
||||
| **FPU (Cortex-M4F)** | Activation dans le startup | Registre `CPACR` bits 20..23. L'empilement paresseux (*Lazy Stacking* via `FPCCR.LSPEN`) évite de sauvegarder les 16 registres FPU lors d'interruptions si l'ISR n'utilise pas de flottants. | **[VALIDÉ]** |
|
||||
| **Backup Domain & RTC** | 32 Backup Registers (128 octets) | Préservés tant que $V_{DD}$ ou $V_{BAT}$ est présent. Parfaitement adapté pour stocker le numéro de canal Davis actif, la phase de saut et le compteur de trames 169 MHz. | **[VALIDÉ]** |
|
||||
| **Sources de Réveil depuis `Stop 2`** | EXTI Radio, RTC Wakeup | L'UART standard ne peut pas réveiller le MCU depuis `Stop 2` (seul le LPUART ou une broche EXTI comme `E32 AUX` ou `RX GPIO EXTI` le peut). | **[À VÉRIFIER]** : Le réveil sur événement radio 169 MHz doit obligatoirement passer par l'interruption EXTI de la broche `AUX`. |
|
||||
|
||||
---
|
||||
|
||||
### 2.2. Réception Davis Vantage Pro2 & CC1101 868 MHz
|
||||
|
||||
```
|
||||
Structure d'un paquet Davis 868 MHz dans l'air :
|
||||
┌─────────────────┬─────────────────┬───────────────────────────┬─────────────┐
|
||||
│ Préambule │ Sync Word │ Charge Utile (Payload) │ CRC-16 │
|
||||
│ (4 octets 0xAA) │ (2 octets) │ (6 octets grandeurs/type) │ (2 octets) │
|
||||
└─────────────────┴─────────────────┴───────────────────────────┴─────────────┘
|
||||
◄──────────────────────── 14 octets @ 19.2 kbps ────────────────────────►
|
||||
◄────────────────────── Durée dans l'air : 5.83 ms ──────────────────────►
|
||||
```
|
||||
|
||||
| Aspect | Hypothèse Initiale | Réalité Physique & Mesures | Statut |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **Durée du paquet** | "Écoute de 3 à 5 ms" | **5.83 ms** au total (14 octets à 19 200 bauds). Si la fenêtre d'écoute fait 3 ms, la réception échoue systématiquement. | **[ERREUR]** |
|
||||
| **Dérive Temporelle** | Horloge parfaite | En altitude ($-15^\circ\text{C}$ à $+30^\circ\text{C}$), le quartz de l'ISS Davis et le quartz LSE du relais dérivent ($\pm 20\text{ ppm}$, soit $\sim \pm 50\text{ }\mu\text{s}$ par tir). | **[HYPOTHÈSE]** |
|
||||
| **Fenêtre d'Écoute Réelle** | 3 à 5 ms | Doit être de **12 à 20 ms** : ouverture 3 ms avant le créneau théorique, attente du sync word, capture des 6 ms de paquet, marge de sécurité. | **[À DÉCIDER]** |
|
||||
| **Saut de Fréquence (FHSS)** | Poursuite immédiate | Séquence sur 5 canaux EU (868.0, 868.125, 868.25, 868.375, 868.5 MHz). Période $T = \frac{41 + ID}{16}\text{ s}$ (~2.5625 s pour ID 1). Phase d'accrochage à froid (scan continu) obligatoire au démarrage avant passage en suivi périodique. | **[VALIDÉ]** |
|
||||
| **Découplage Davis / 169 MHz** | Indépendance totale | L'acquisition Davis alimente un agrégateur en SRAM2. La transmission 169 MHz lit cet agrégateur selon sa propre horloge. | **[VALIDÉ]** |
|
||||
|
||||
---
|
||||
|
||||
### 2.3. Module EBYTE E32-170T30D-V2.0 & Liaison 169 MHz
|
||||
|
||||
| Paramètre | Analyse Technique Approfondie | Statut |
|
||||
| :--- | :--- | :--- |
|
||||
| **Architecture du Module** | Modem autonome basé sur MCU interne + PA 1W. Pilotage par UART asynchrone (niveaux 3.3V). | **[VALIDÉ]** |
|
||||
| **Broches de Contrôle** | `M0`, `M1` (Modes 0 Normal, 1 Wake-up, 2 Power-saving, 3 Sleep). `AUX` indique l'état interne (bas = occupé, haut = prêt). | **[VALIDÉ]** |
|
||||
| **Temps de Commutation de Mode** | Lors du passage de Mode 3 (Sleep) à Mode 0 (Normal), `AUX` passe à 0 pendant **$\sim 2$ à $5\text{ ms}$** avant de remonter à 1. Le STM32 ne doit émettre sur l'UART qu'après remontée d'AUX. | **[À VÉRIFIER]** |
|
||||
| **Consommation Réelle par État** | - **Mode 3 (Sleep)** : $\sim 2$ à $4\text{ }\mu\text{A}$ <br>- **Mode 0 (Écoute RX)** : $\sim 15$ à $20\text{ mA}$ <br>- **Mode 0 (Émission TX @ +30 dBm)** : $\sim 500$ à $650\text{ mA}$ (courant crête très élevé sur la batterie !). | **[HYPOTHÈSE CRITIQUE]** |
|
||||
| **Dimensionnement Électrique Batterie** | Le courant d'appel de 600 mA pendant l'émission 169 MHz impose un condensateur réservoir (ou batterie à faible résistance interne) pour éviter le *Brown-Out Reset* du STM32. | **[À DÉCIDER]** |
|
||||
| **Écoute RX Descendante après TX** | Après émission, le module repasse en écoute RX en Mode 0. Maintenir l'écoute consomme 18 mA. Une fenêtre de **1.0 seconde max** est recommandée pour limiter le coût énergétique à $\sim 5\text{ }\mu\text{Ah}$ par transmission. | **[À DÉCIDER]** |
|
||||
|
||||
---
|
||||
|
||||
### 2.4. Réglementation Spectrale 169 MHz (France / Europe)
|
||||
|
||||
> [!CAUTION]
|
||||
> **Rappel Réglementaire Impératif** : La mention d'une "émission 1 W" dans une décision d'architecture est prématurée et potentiellement non conforme.
|
||||
|
||||
1. **Bande VHF 169.4 – 169.8125 MHz (Décision ARCEP / Norme ERC REC 70-03 Annexe 1)** :
|
||||
- **Sous-bande 169.400 – 169.475 MHz** : Puissance max autorisée = **500 mW ERP (+27 dBm)** avec un rapport cyclique (*duty cycle*) $\le 10\%$.
|
||||
- **Sous-bande 169.475 – 169.4875 MHz** : Puissance max = **500 mW ERP (+27 dBm)** avec canalisation 12.5 kHz et *duty cycle* $\le 0.1\%$ ou $\le 1\%$.
|
||||
2. **Distinction Technique Indispensable** :
|
||||
$$\text{ERP (PAR)} = P_{\text{conduite (module)}} - \text{Pertes câbles} + G_{\text{antenne (dBd)}}$$
|
||||
- Si le module émet à $+30\text{ dBm}$ (1 W conduit) sur une antenne directive de $+3\text{ dBd}$, l'ERP atteint $2\text{ W}$, ce qui est **illégal** sans licence spécifique.
|
||||
- Le firmware doit pouvoir configurer le module à **$+27\text{ dBm}$ (500 mW)** ou adapter la puissance en fonction du gain de l'antenne installée à la Moucherolle.
|
||||
|
||||
---
|
||||
|
||||
### 2.5. Architecture Logicielle & Dépendances
|
||||
|
||||
L'analyse de l'empilement logiciel confirme l'absence de dépendance circulaire :
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ APPLICATION (Orchestrateur Météo / State Machine) │
|
||||
└───────────────────────────┬────────────────────────────┘
|
||||
│ Déclenche agrégation & transmission
|
||||
▼
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ PROTOCOLES (Davis Decoder / 169 Framing / Commands) │
|
||||
└───────────────────────────┬────────────────────────────┘
|
||||
│ Utilise les services système
|
||||
▼
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ SERVICES SYSTÈME (Power, Schedule, Storage, Watchdog) │
|
||||
└───────────────────────────┬────────────────────────────┘
|
||||
│ Pilote les composants
|
||||
▼
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ DRIVERS (CC1101, E32-170T30D, PowerSwitches) │
|
||||
└───────────────────────────┬────────────────────────────┘
|
||||
│ Accède aux registres
|
||||
▼
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ HAL (GPIO, SPI, UART, RTC, ADC, Flash) │
|
||||
└────────────────────────────────────────────────────────┘
|
||||
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ SYNCHRONISATION : File d'Événements Statique │
|
||||
│ - Les ISRs (EXTI, RTC, UART) poussent dans EventQueue │
|
||||
│ - L'Application dépile depuis EventQueue │
|
||||
│ - Les couches Drivers/HAL ne dépendent pas d'App │
|
||||
└────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
- **Règle des Interruptions (*Short ISR*)** : Validée. Aucune transaction bloquante (SPI, Flash, UART) n'est exécutée en contexte d'interruption.
|
||||
|
||||
---
|
||||
|
||||
### 2.6. Audit de la Stratégie Assembleur (ASM)
|
||||
|
||||
| Emplacement Proposé | Nécessité Réelle | Faisabilité en Rust `no_std` | Impact Performance / Énergie | Décision d'Audit |
|
||||
| :--- | :--- | :--- | :--- | :--- |
|
||||
| **Startup / Reset Handler** | Nulle | **Totale** (via `cortex-m-rt`) | 0 cycle de différence (le code machine généré est strictement identique). | **[SUPPRIMER L'ASM OBLIGATOIRE]** : Utiliser `cortex-m-rt`. Garder `startup.s` uniquement comme option d'étude théorique. |
|
||||
| **Mise en veille `Stop 2` (`DSB`, `ISB`, `WFI`)** | Faible | **Totale** via `core::arch::arm::{__dsb, __isb, __wfi}` | Identique à l'instruction près. | **[SUPPRIMER L'ASM MANUSCRIT]** : Les intrinsics Rust sont 100% inlinés sans overhead. |
|
||||
| **Routines d'Interruption (ISR)** | Nulle | **Totale** via `#[interrupt]` | Le hardware Cortex-M gère l'empilement en 12 cycles. L'ASM n'apporte aucun gain. | **[REJETER L'ASM EN ISR]** |
|
||||
| **Calculs Météo / Filtrage** | Nulle | **Totale** (Rust compile en instructions FPU matérielles Cortex-M4) | Rust + LLVM vectorise et optimise mieux que du code ASM manuel complexe. | **[REJETER L'ASM EN CALCUL]** |
|
||||
|
||||
> **Conclusion ASM** : L'utilisation d'ASM manuscrit n'est justifiée par **aucun gain technique réel**. Tout le firmware peut et doit être écrit en **Rust `no_std` pur**.
|
||||
|
||||
---
|
||||
|
||||
### 2.7. Audit Mémoire & Persistance
|
||||
|
||||
1. **Empreinte RAM (SRAM2 - 32 Ko)** :
|
||||
- Pile statique : 4 Ko
|
||||
- File d'événements (16 événements $\times 8$ octets) : 128 octets
|
||||
- Buffers de paquets (Davis 16 octets, 169 MHz 128 octets) : ~256 octets
|
||||
- Buffer d'agrégation météo glissant : ~1 Ko
|
||||
- État système & diagnostics : ~512 octets
|
||||
- **Total estimé : $< 7\text{ Ko}$**, largement contenu dans les 32 Ko de SRAM2 préservés en `Stop 2`.
|
||||
2. **Flash & Persistance de la Configuration** :
|
||||
- Secteur de 2 Ko dédié.
|
||||
- **Risque d'écriture interrompue** (coupure batterie pendant effacement/programmation Flash) :
|
||||
- **Solution obligatoire** : Architecture *Ping-Pong* (2 pages Flash alternées avec numéro de séquence incrémental et CRC32). La dernière page valide est rechargée en cas de corruption.
|
||||
|
||||
---
|
||||
|
||||
## 3. Matrice de Classification des Décisions et Éléments Techniques
|
||||
|
||||
| Élément d'Architecture | Statut d'Audit | Justification / Action Requise |
|
||||
| :--- | :--- | :--- |
|
||||
| **STM32L476RGT6 Bare-Metal (Rust `no_std`)** | **[VALIDÉ]** | Choix optimal pour sécurité mémoire et maîtrise énergétique. |
|
||||
| **Architecture modulaire à 7 couches** | **[VALIDÉ]** | Pas de dépendances circulaires, séparation stricte. |
|
||||
| **Rétention SRAM totale en `Stop 2`** | **[ERREUR]** | Seule la SRAM2 (32 Ko) est conservée. Mapper la RAM active en SRAM2. |
|
||||
| **Écoute Davis 868 MHz en "3 à 5 ms"** | **[ERREUR]** | Durée paquet = 5.8 ms. Fenêtre réelle à calibrer entre 12 et 20 ms. |
|
||||
| **Double chaîne radio (CC1101 + E32-170T30D)** | **[VALIDÉ]** | Architecture radio confirmée. |
|
||||
| **Driver E32 traité en UART + M0/M1/AUX** | **[VALIDÉ]** | Correspond exactement au matériel physique. |
|
||||
| **Émission radio 169 MHz qualifiée de "1 W"** | **[À VÉRIFIER]** | Reformuler en "Module capable de +30 dBm, puissance d'émission calibrée selon la limite réglementaire ERP (ex. 500 mW ERP max)". |
|
||||
| **Découplage strict Acquisition vs Transmission** | **[VALIDÉ]** | Fondamental pour l'autonomie sur batterie. |
|
||||
| **Usage obligatoire d'ASM pour startup et veille** | **[HYPOTHÈSE INVALIDE]** | Rust `no_std` avec `cortex-m-rt` et intrinsics ARM couvre 100% du besoin sans perte. |
|
||||
| **Fenêtre RX descendante de 1.0 s après TX** | **[À DÉCIDER]** | Compromis énergie/réactivité à valider expérimentalement. |
|
||||
| **Persistance Flash avec protection Ping-Pong** | **[À DÉCIDER]** | Recommandation formelle pour prévenir toute corruption. |
|
||||
|
||||
---
|
||||
|
||||
## 4. Propositions de Modifications Documentaires
|
||||
|
||||
Une fois cet audit validé, les ajustements suivants devront être apportés aux notes :
|
||||
|
||||
1. **[`/notes/architecture_relais.md`](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes/architecture_relais.md)** :
|
||||
- Corriger la section mémoire en spécifiant l'usage exclusif de **SRAM2 (32 Ko)** pour la rétention en `Stop 2`.
|
||||
- Corriger la durée de fenêtre de capture Davis (passage de 3-5 ms à **12-20 ms** avec justification de la durée de trame de 5.83 ms).
|
||||
- Ajuster la section ASM pour acter que Rust `no_std` et `cortex-m-rt` constituent la solution nominale.
|
||||
2. **[`/notes/decisions.md`](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes/decisions.md)** :
|
||||
- Mettre à jour **DEC-003** et **DEC-017** pour mentionner la conformité réglementaire ERP et supprimer toute affirmation d'émission non régulée à 1 W.
|
||||
- Ajouter une décision formelle sur l'allocation SRAM2 pour `Stop 2`.
|
||||
3. **[`/notes/questions_ouvertes.md`](file:///c:/Users/theog/Documents/_CODE/7-radio/__RADIO/Gastinel.Weather.169/notes/questions_ouvertes.md)** :
|
||||
- Ajouter l'étude du profil d'appel de courant TX (~600 mA) sur la batterie et le condensateur de découplage d'entrée.
|
||||
- Préciser la sous-bande 169 MHz exacte (169.400 - 169.475 MHz) et la limite ERP associée.
|
||||
@@ -0,0 +1,190 @@
|
||||
# Rapport d'Audit Technique Critique : Architecture /OS_relais (STM32L476RGT6)
|
||||
|
||||
**Projet** : Gastinel.Weather.169
|
||||
**Cible** : Nœud Relais autonome (Site de la Grande Moucherolle)
|
||||
**Date d'audit** : 2026-08-28
|
||||
**Statut** : Rapport d'audit préalable à l'implémentation
|
||||
|
||||
---
|
||||
|
||||
## 1. Synthèse Exécutive de l'Audit
|
||||
|
||||
L'audit technique de l'architecture interne de `/OS_relais` met en évidence une structure globale cohérente et bien découplée, mais révèle **plusieurs hypothèses erronées, sous-estimations physiques et choix prématurés** qui auraient conduit à des défaillances critiques en phase d'implémentation :
|
||||
|
||||
1. **[ERREUR CRITIQUE] Perte de données en mode `Stop 2` (SRAM1 vs SRAM2)** :
|
||||
Sur le STM32L476, le mode de veille ultra-basse consommation `Stop 2` **coupe l'alimentation de la SRAM1 (96 Ko)**. Seule la **SRAM2 (32 Ko)** est retenue. Toute la mémoire vive active (pile, buffers, machine d'état) doit impérativement être mappée dans SRAM2 par le linker script.
|
||||
2. **[ERREUR CRITIQUE] Fenêtre d'écoute Davis 868 MHz physiquement impossible** :
|
||||
L'hypothèse d'une durée d'écoute de "3 à 5 ms" est invalide : la durée d'émission d'un paquet Davis dans les airs est de **~5.8 ms** (14 octets @ 19.2 kbps). Avec les dérives d'oscillateurs en milieu montagnard, la fenêtre de réception doit être dimensionnée entre **10 et 20 ms**.
|
||||
3. **[À VÉRIFIER / RÉGLEMENTATION] Confusion entre Puissance Maximale du Module (1 W) et Puissance Réglementaire (ERP)** :
|
||||
Le module E32-170T30D est capable de +30 dBm (1 W conduit), mais la réglementation européenne/française (ERC 70-03 / ARCEP) sur la bande 169 MHz impose des limites strictes de PAR/ERP (typiquement 500 mW ERP max selon la sous-bande) et des limitations de rapport cyclique (*duty cycle* $\le 10\%$ ou $\le 1\%$).
|
||||
4. **[HYPOTHÈSE NON JUSTIFIÉE] Valeur ajoutée de l'Assembleur (ASM)** :
|
||||
L'analyse fine montre que le compilateur Rust (`no_std`) combiné au runtime `cortex-m-rt` génère du code machine Cortex-M4 optimal. L'utilisation d'ASM manuscrit n'apporte aucun gain mesurable de consommation ou de performance pour le startup ou la mise en veille.
|
||||
|
||||
---
|
||||
|
||||
## 2. Audit Détaillé Point par Point
|
||||
|
||||
### 2.1. Cible STM32L476RGT6 & Silicium
|
||||
|
||||
| Paramètre | Hypothèse Initiale | Réalité Technique Silicium | Impact & Classification |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **Rétention SRAM en `Stop 2`** | "Rétention totale de la SRAM 128 Ko" | **SRAM1 (96 Ko) est éteinte** ; seule **SRAM2 (32 Ko)** est conservée sous tension (Section 5.3.4 Reference Manual RM0351). | **[ERREUR]** : Le linker script (`memory.x`) doit mapper la pile, le BSS et les données vives exclusivement dans la plage SRAM2 (`0x10000000` - 32 Ko). |
|
||||
| **Clocks & Réveil** | Réveil en 5 µs sur MSI | Réveil MSI en 5 µs nominal, mais stabilisation du PLL (si utilisé) requiert ~100 µs. Pour un réveil périodique Davis, le MCU doit tourner directement sur MSI @ 16/24 MHz sans PLL. | **[VALIDÉ AVEC RESTRICTION]** : Exécuter l'acquisition Davis sur horloge MSI sans réenclencher la PLL. |
|
||||
| **FPU (Cortex-M4F)** | Activation dans le startup | Registre `CPACR` bits 20..23. L'empilement paresseux (*Lazy Stacking* via `FPCCR.LSPEN`) évite de sauvegarder les 16 registres FPU lors d'interruptions si l'ISR n'utilise pas de flottants. | **[VALIDÉ]** |
|
||||
| **Backup Domain & RTC** | 32 Backup Registers (128 octets) | Préservés tant que $V_{DD}$ ou $V_{BAT}$ est présent. Parfaitement adapté pour stocker le numéro de canal Davis actif, la phase de saut et le compteur de trames 169 MHz. | **[VALIDÉ]** |
|
||||
| **Sources de Réveil depuis `Stop 2`** | EXTI Radio, RTC Wakeup | L'UART standard ne peut pas réveiller le MCU depuis `Stop 2` (seul le LPUART ou une broche EXTI comme `E32 AUX` ou `RX GPIO EXTI` le peut). | **[À VÉRIFIER]** : Le réveil sur événement radio 169 MHz doit obligatoirement passer par l'interruption EXTI de la broche `AUX`. |
|
||||
|
||||
---
|
||||
|
||||
### 2.2. Réception Davis Vantage Pro2 & CC1101 868 MHz
|
||||
|
||||
```
|
||||
Structure d'un paquet Davis 868 MHz dans l'air :
|
||||
┌─────────────────┬─────────────────┬───────────────────────────┬─────────────┐
|
||||
│ Préambule │ Sync Word │ Charge Utile (Payload) │ CRC-16 │
|
||||
│ (4 octets 0xAA) │ (2 octets) │ (6 octets grandeurs/type) │ (2 octets) │
|
||||
└─────────────────┴─────────────────┴───────────────────────────┴─────────────┘
|
||||
◄──────────────────────── 14 octets @ 19.2 kbps ────────────────────────►
|
||||
◄────────────────────── Durée dans l'air : 5.83 ms ──────────────────────►
|
||||
```
|
||||
|
||||
| Aspect | Hypothèse Initiale | Réalité Physique & Mesures | Statut |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **Durée du paquet** | "Écoute de 3 à 5 ms" | **5.83 ms** au total (14 octets à 19 200 bauds). Si la fenêtre d'écoute fait 3 ms, la réception échoue systématiquement. | **[ERREUR]** |
|
||||
| **Dérive Temporelle** | Horloge parfaite | En altitude ($-15^\circ\text{C}$ à $+30^\circ\text{C}$), le quartz de l'ISS Davis et le quartz LSE du relais dérivent ($\pm 20\text{ ppm}$, soit $\sim \pm 50\text{ }\mu\text{s}$ par tir). | **[HYPOTHÈSE]** |
|
||||
| **Fenêtre d'Écoute Réelle** | 3 à 5 ms | Doit être de **12 à 20 ms** : ouverture 3 ms avant le créneau théorique, attente du sync word, capture des 6 ms de paquet, marge de sécurité. | **[À DÉCIDER]** |
|
||||
| **Saut de Fréquence (FHSS)** | Poursuite immédiate | Séquence sur 5 canaux EU (868.0, 868.125, 868.25, 868.375, 868.5 MHz). Période $T = \frac{41 + ID}{16}\text{ s}$ (~2.5625 s pour ID 1). Phase d'accrochage à froid (scan continu) obligatoire au démarrage avant passage en suivi périodique. | **[VALIDÉ]** |
|
||||
| **Découplage Davis / 169 MHz** | Indépendance totale | L'acquisition Davis alimente un agrégateur en SRAM2. La transmission 169 MHz lit cet agrégateur selon sa propre horloge. | **[VALIDÉ]** |
|
||||
|
||||
---
|
||||
|
||||
### 2.3. Module EBYTE E32-170T30D-V2.0 & Liaison 169 MHz
|
||||
|
||||
| Paramètre | Analyse Technique Approfondie | Statut |
|
||||
| :--- | :--- | :--- |
|
||||
| **Architecture du Module** | Modem autonome basé sur MCU interne + PA 1W. Pilotage par UART asynchrone (niveaux 3.3V). | **[VALIDÉ]** |
|
||||
| **Broches de Contrôle** | `M0`, `M1` (Modes 0 Normal, 1 Wake-up, 2 Power-saving, 3 Sleep). `AUX` indique l'état interne (bas = occupé, haut = prêt). | **[VALIDÉ]** |
|
||||
| **Temps de Commutation de Mode** | Lors du passage de Mode 3 (Sleep) à Mode 0 (Normal), `AUX` passe à 0 pendant **$\sim 2$ à $5\text{ ms}$** avant de remonter à 1. Le STM32 ne doit émettre sur l'UART qu'après remontée d'AUX. | **[À VÉRIFIER]** |
|
||||
| **Consommation Réelle par État** | - **Mode 3 (Sleep)** : $\sim 2$ à $4\text{ }\mu\text{A}$ <br>- **Mode 0 (Écoute RX)** : $\sim 15$ à $20\text{ mA}$ <br>- **Mode 0 (Émission TX @ +30 dBm)** : $\sim 500$ à $650\text{ mA}$ (courant crête très élevé sur la batterie !). | **[HYPOTHÈSE CRITIQUE]** |
|
||||
| **Dimensionnement Électrique Batterie** | Le courant d'appel de 600 mA pendant l'émission 169 MHz impose un condensateur réservoir (ou batterie à faible résistance interne) pour éviter le *Brown-Out Reset* du STM32. | **[À DÉCIDER]** |
|
||||
| **Écoute RX Descendante après TX** | Après émission, le module repasse en écoute RX en Mode 0. Maintenir l'écoute consomme 18 mA. Une fenêtre de **1.0 seconde max** est recommandée pour limiter le coût énergétique à $\sim 5\text{ }\mu\text{Ah}$ par transmission. | **[À DÉCIDER]** |
|
||||
|
||||
---
|
||||
|
||||
### 2.4. Réglementation Spectrale 169 MHz (France / Europe)
|
||||
|
||||
> [!CAUTION]
|
||||
> **Rappel Réglementaire Impératif** : La mention d'une "émission 1 W" dans une décision d'architecture est prématurée et potentiellement non conforme.
|
||||
|
||||
1. **Bande VHF 169.4 – 169.8125 MHz (Décision ARCEP / Norme ERC REC 70-03 Annexe 1)** :
|
||||
- **Sous-bande 169.400 – 169.475 MHz** : Puissance max autorisée = **500 mW ERP (+27 dBm)** avec un rapport cyclique (*duty cycle*) $\le 10\%$.
|
||||
- **Sous-bande 169.475 – 169.4875 MHz** : Puissance max = **500 mW ERP (+27 dBm)** avec canalisation 12.5 kHz et *duty cycle* $\le 0.1\%$ ou $\le 1\%$.
|
||||
2. **Distinction Technique Indispensable** :
|
||||
$$\text{ERP (PAR)} = P_{\text{conduite (module)}} - \text{Pertes câbles} + G_{\text{antenne (dBd)}}$$
|
||||
- Si le module émet à $+30\text{ dBm}$ (1 W conduit) sur une antenne directive de $+3\text{ dBd}$, l'ERP atteint $2\text{ W}$, ce qui est **illégal** sans licence spécifique.
|
||||
- Le firmware doit pouvoir configurer le module à **$+27\text{ dBm}$ (500 mW)** ou adapter la puissance en fonction du gain de l'antenne installée à la Moucherolle.
|
||||
|
||||
---
|
||||
|
||||
### 2.5. Architecture Logicielle & Dépendances
|
||||
|
||||
L'analyse de l'empilement logiciel confirme l'absence de dépendance circulaire :
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ APPLICATION (Orchestrateur Météo / State Machine) │
|
||||
└───────────────────────────┬────────────────────────────┘
|
||||
│ Déclenche agrégation & transmission
|
||||
▼
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ PROTOCOLES (Davis Decoder / 169 Framing / Commands) │
|
||||
└───────────────────────────┬────────────────────────────┘
|
||||
│ Utilise les services système
|
||||
▼
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ SERVICES SYSTÈME (Power, Schedule, Storage, Watchdog) │
|
||||
└───────────────────────────┬────────────────────────────┘
|
||||
│ Pilote les composants
|
||||
▼
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ DRIVERS (CC1101, E32-170T30D, PowerSwitches) │
|
||||
└───────────────────────────┬────────────────────────────┘
|
||||
│ Accède aux registres
|
||||
▼
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ HAL (GPIO, SPI, UART, RTC, ADC, Flash) │
|
||||
└────────────────────────────────────────────────────────┘
|
||||
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ SYNCHRONISATION : File d'Événements Statique │
|
||||
│ - Les ISRs (EXTI, RTC, UART) poussent dans EventQueue │
|
||||
│ - L'Application dépile depuis EventQueue │
|
||||
│ - Les couches Drivers/HAL ne dépendent pas d'App │
|
||||
└────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
- **Règle des Interruptions (*Short ISR*)** : Validée. Aucune transaction bloquante (SPI, Flash, UART) n'est exécutée en contexte d'interruption.
|
||||
|
||||
---
|
||||
|
||||
### 2.6. Audit de la Stratégie Assembleur (ASM)
|
||||
|
||||
| Emplacement Proposé | Nécessité Réelle | Faisabilité en Rust `no_std` | Impact Performance / Énergie | Décision d'Audit |
|
||||
| :--- | :--- | :--- | :--- | :--- |
|
||||
| **Startup / Reset Handler** | Nulle | **Totale** (via `cortex-m-rt`) | 0 cycle de différence (le code machine généré est strictement identique). | **[SUPPRIMER L'ASM OBLIGATOIRE]** : Utiliser `cortex-m-rt`. Garder `startup.s` uniquement comme option d'étude théorique. |
|
||||
| **Mise en veille `Stop 2` (`DSB`, `ISB`, `WFI`)** | Faible | **Totale** via `core::arch::arm::{__dsb, __isb, __wfi}` | Identique à l'instruction près. | **[SUPPRIMER L'ASM MANUSCRIT]** : Les intrinsics Rust sont 100% inlinés sans overhead. |
|
||||
| **Routines d'Interruption (ISR)** | Nulle | **Totale** via `#[interrupt]` | Le hardware Cortex-M gère l'empilement en 12 cycles. L'ASM n'apporte aucun gain. | **[REJETER L'ASM EN ISR]** |
|
||||
| **Calculs Météo / Filtrage** | Nulle | **Totale** (Rust compile en instructions FPU matérielles Cortex-M4) | Rust + LLVM vectorise et optimise mieux que du code ASM manuel complexe. | **[REJETER L'ASM EN CALCUL]** |
|
||||
|
||||
> **Conclusion ASM** : L'utilisation d'ASM manuscrit n'est justifiée par **aucun gain technique réel**. Tout le firmware peut et doit être écrit en **Rust `no_std` pur**.
|
||||
|
||||
---
|
||||
|
||||
### 2.7. Audit Mémoire & Persistance
|
||||
|
||||
1. **Empreinte RAM (SRAM2 - 32 Ko)** :
|
||||
- Pile statique : 4 Ko
|
||||
- File d'événements (16 événements $\times 8$ octets) : 128 octets
|
||||
- Buffers de paquets (Davis 16 octets, 169 MHz 128 octets) : ~256 octets
|
||||
- Buffer d'agrégation météo glissant : ~1 Ko
|
||||
- État système & diagnostics : ~512 octets
|
||||
- **Total estimé : $< 7\text{ Ko}$**, largement contenu dans les 32 Ko de SRAM2 préservés en `Stop 2`.
|
||||
2. **Flash & Persistance de la Configuration** :
|
||||
- Secteur de 2 Ko dédié.
|
||||
- **Risque d'écriture interrompue** (coupure batterie pendant effacement/programmation Flash) :
|
||||
- **Solution obligatoire** : Architecture *Ping-Pong* (2 pages Flash alternées avec numéro de séquence incrémental et CRC32). La dernière page valide est rechargée en cas de corruption.
|
||||
|
||||
---
|
||||
|
||||
## 3. Matrice de Classification des Décisions et Éléments Techniques
|
||||
|
||||
| Élément d'Architecture | Statut d'Audit | Justification / Action Requise |
|
||||
| :--- | :--- | :--- |
|
||||
| **STM32L476RGT6 Bare-Metal (Rust `no_std`)** | **[VALIDÉ]** | Choix optimal pour sécurité mémoire et maîtrise énergétique. |
|
||||
| **Architecture modulaire à 7 couches** | **[VALIDÉ]** | Pas de dépendances circulaires, séparation stricte. |
|
||||
| **Rétention SRAM totale en `Stop 2`** | **[ERREUR]** | Seule la SRAM2 (32 Ko) est conservée. Mapper la RAM active en SRAM2. |
|
||||
| **Écoute Davis 868 MHz en "3 à 5 ms"** | **[ERREUR]** | Durée paquet = 5.8 ms. Fenêtre réelle à calibrer entre 12 et 20 ms. |
|
||||
| **Double chaîne radio (CC1101 + E32-170T30D)** | **[VALIDÉ]** | Architecture radio confirmée. |
|
||||
| **Driver E32 traité en UART + M0/M1/AUX** | **[VALIDÉ]** | Correspond exactement au matériel physique. |
|
||||
| **Émission radio 169 MHz qualifiée de "1 W"** | **[À VÉRIFIER]** | Reformuler en "Module capable de +30 dBm, puissance d'émission calibrée selon la limite réglementaire ERP (ex. 500 mW ERP max)". |
|
||||
| **Découplage strict Acquisition vs Transmission** | **[VALIDÉ]** | Fondamental pour l'autonomie sur batterie. |
|
||||
| **Usage obligatoire d'ASM pour startup et veille** | **[HYPOTHÈSE INVALIDE]** | Rust `no_std` avec `cortex-m-rt` et intrinsics ARM couvre 100% du besoin sans perte. |
|
||||
| **Fenêtre RX descendante de 1.0 s après TX** | **[À DÉCIDER]** | Compromis énergie/réactivité à valider expérimentalement. |
|
||||
| **Persistance Flash avec protection Ping-Pong** | **[À DÉCIDER]** | Recommandation formelle pour prévenir toute corruption. |
|
||||
|
||||
---
|
||||
|
||||
## 4. Propositions de Modifications Documentaires
|
||||
|
||||
Une fois cet audit validé, les ajustements suivants devront être apportés aux notes :
|
||||
|
||||
1. **[`/notes/architecture_relais.md`](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes/architecture_relais.md)** :
|
||||
- Corriger la section mémoire en spécifiant l'usage exclusif de **SRAM2 (32 Ko)** pour la rétention en `Stop 2`.
|
||||
- Corriger la durée de fenêtre de capture Davis (passage de 3-5 ms à **12-20 ms** avec justification de la durée de trame de 5.83 ms).
|
||||
- Ajuster la section ASM pour acter que Rust `no_std` et `cortex-m-rt` constituent la solution nominale.
|
||||
2. **[`/notes/decisions.md`](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes/decisions.md)** :
|
||||
- Mettre à jour **DEC-003** et **DEC-017** pour mentionner la conformité réglementaire ERP et supprimer toute affirmation d'émission non régulée à 1 W.
|
||||
- Ajouter une décision formelle sur l'allocation SRAM2 pour `Stop 2`.
|
||||
3. **[`/notes/questions_ouvertes.md`](file:///c:/Users/theog/Documents/_CODE/__RADIO/Gastinel.Weather.169/notes/questions_ouvertes.md)** :
|
||||
- Ajouter l'étude du profil d'appel de courant TX (~600 mA) sur la batterie et le condensateur de découplage d'entrée.
|
||||
- Préciser la sous-bande 169 MHz exacte (169.400 - 169.475 MHz) et la limite ERP associée.
|
||||
@@ -0,0 +1,255 @@
|
||||
# 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`)
|
||||
|
||||
```rust
|
||||
/// É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`)
|
||||
|
||||
```rust
|
||||
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`.
|
||||
@@ -0,0 +1,237 @@
|
||||
# Spécification Technique & Décodage du Protocole Radio Davis Vantage Pro2 ISS (868 MHz Europe)
|
||||
|
||||
## 1. Synthèse du Protocole Radio Terrestre (DavisTalk RF)
|
||||
|
||||
L'Integrated Sensor Suite (**ISS**) de la Davis Vantage Pro2 (VP2) transmet ses relevés météorologiques par paquets radio autonomes sur la bande ISM 868 MHz en Europe (et 902–928 MHz aux USA).
|
||||
|
||||
Le protocole radio direct (souvent désigné sous le nom communautaire *DavisTalk*) est un protocole propriétaire **non documenté officiellement par Davis Instruments**, mais intégralement rétro-ingénieré et validé par plusieurs projets ouverts de référence (*DavisRFM69* par DeKay/Mad Scientist Labs, *CC1101-Weather-Receiver* par cmatteri, *rtldavis* par Douglas Hall / bcl, et les drivers *WeeWX*).
|
||||
|
||||
> [!CAUTION]
|
||||
> **Distinction Fondamentale des Protocoles Davis** :
|
||||
> 1. **Protocole Radio Brut (DavisTalk RF)** : Paquets de 14 octets dans l'air (8 octets utiles), modulation 2-FSK @ 19.2 kbps, FHSS toutes les ~2.5 s. C'est l'unique protocole émis par l'ISS sans fil.
|
||||
> 2. **Protocole Console / Datalogger (Serial LOOP / LOOP2)** : Trames de 99 octets transmises en UART série 19200 bauds (8N1) par la console ou le module WeatherLink série/USB.
|
||||
> 3. **Protocole Réseau WeatherLinkIP / Live** : Données transmises en TCP/UDP/HTTP JSON sur réseau IP.
|
||||
> 4. **Protocole APRS** : Chaînes de caractères ASCII formatées pour le réseau radioamateur.
|
||||
>
|
||||
> Pour une station autonome en montagne sans console, **seul le protocole radio brut (DavisTalk RF)** est utilisé.
|
||||
|
||||
---
|
||||
|
||||
## 2. Couche Physique Radio (Bande 868 MHz Europe)
|
||||
|
||||
### 2.1. Modulation et Paramètres RF
|
||||
|
||||
| Paramètre | Valeur Exacte | Tolérance / Remarques |
|
||||
| :--- | :--- | :--- |
|
||||
| **Modulation** | **2-FSK** (Frequency Shift Keying) | Déviation de fréquence : $\pm 9.6\text{ kHz}$ ($\Delta f \approx 9.6\text{ kHz}$) |
|
||||
| **Débit Binaire (*Air Data Rate*)** | **19 200 bps** (19.2 kbps) | Durée d'un bit : $52.083\text{ }\mu\text{s}$ |
|
||||
| **Préambule Physique** | **4 à 8 octets `0xAA`** (`10101010...`) | Permet le calage AGC et de phase du récepteur |
|
||||
| **Mot de Synchronisation (*Sync Word*)** | **2 octets : `0xCB89`** (MSB first) | Binaire : `1100 1011 1000 1001` |
|
||||
| **Largeur de Canal / Filtre RX** | **~100 à 150 kHz** | Réglage optimal CC1101 `MDMCFG4.CHANBW` $\approx 100\text{ kHz}$ |
|
||||
| **Endianness Transmission** | **MSB First** (Bit le plus significatif émis en premier) | Octet le plus significatif en premier pour le CRC |
|
||||
|
||||
### 2.2. Canaux Fréquentiels Européens (Plan 5 Canaux)
|
||||
|
||||
Contrairement à la version nord-américaine (qui utilise 51 canaux entre 902 et 928 MHz), la version européenne (modèles finissant par `EU` ou `OV`) opère sur **5 canaux spécifiques** dans la bande 868.0 – 868.6 MHz :
|
||||
|
||||
| Index Canal (Logiciel) | Fréquence Exacte (Hz) | Fréquence Nominale (MHz) | Espacement |
|
||||
| :---: | :---: | :---: | :---: |
|
||||
| **Canal 0** | `868 066 711 Hz` | 868.067 MHz | Base |
|
||||
| **Canal 1** | `868 181 885 Hz` | 868.182 MHz | +115.174 kHz |
|
||||
| **Canal 2** | `868 297 119 Hz` | 868.297 MHz | +115.234 kHz |
|
||||
| **Canal 3** | `868 412 292 Hz` | 868.412 MHz | +115.173 kHz |
|
||||
| **Canal 4** | `868 527 466 Hz` | 868.527 MHz | +115.174 kHz |
|
||||
|
||||
> [!WARNING]
|
||||
> **Correction d'une erreur fréquente** : L'espacement des canaux Davis Europe n'est **PAS de 125.0 kHz** (comme souvent supposé dans les notes initiales : `868.0, 868.125, 868.250...`), mais précisément de **~115.17 kHz** dérivé du pas de synthèse fractionnaire du transceiver Davis.
|
||||
|
||||
### 2.3. Séquence de Saut de Fréquence (FHSS)
|
||||
|
||||
Pour la bande européenne à 5 canaux, l'ISS cycle à travers les canaux selon la séquence pseudo-aléatoire fixe :
|
||||
$$\text{Séquence d'index canaux} : [0, 2, 4, 1, 3]$$
|
||||
|
||||
À chaque tir d'émission, l'ISS passe au canal suivant de la séquence.
|
||||
|
||||
---
|
||||
|
||||
## 3. Synchronisation Temporelle & Périodicité
|
||||
|
||||
### 3.1. Formule de l'Intervalle d'Émission
|
||||
|
||||
L'intervalle de temps nominal $T$ entre deux tirs successifs de l'ISS dépend exclusivement de l'**identifiant de la station** (*Station ID* / *Transmitter ID*, configuré par 3 DIP-switches sur le boîtier de l'ISS, de 1 à 8) :
|
||||
|
||||
$$T_{\text{tir}} = \frac{41 + \text{ID}_{\text{raw}}}{16} \text{ secondes}$$
|
||||
|
||||
où $\text{ID}_{\text{raw}} \in [0..7]$ correspond aux stations 1 à 8 :
|
||||
|
||||
| DIP Switches ISS | Identifiant Station | Valeur Binaire ($\text{ID}_{\text{raw}}$) | Intervalle Exact $T$ (s) | Intervalle en Millisecondes |
|
||||
| :---: | :---: | :---: | :---: | :---: |
|
||||
| 1-OFF, 2-OFF, 3-OFF | **Station 1 (Défaut)** | `0` | $41 / 16 = 2.5625\text{ s}$ | **2 562.5 ms** |
|
||||
| 1-ON, 2-OFF, 3-OFF | **Station 2** | `1` | $42 / 16 = 2.6250\text{ s}$ | **2 625.0 ms** |
|
||||
| 1-OFF, 2-ON, 3-OFF | **Station 3** | `2` | $43 / 16 = 2.6875\text{ s}$ | **2 687.5 ms** |
|
||||
| 1-ON, 2-ON, 3-OFF | **Station 4** | `3` | $44 / 16 = 2.7500\text{ s}$ | **2 750.0 ms** |
|
||||
| 1-OFF, 2-OFF, 3-ON | **Station 5** | `4` | $45 / 16 = 2.8125\text{ s}$ | **2 812.5 ms** |
|
||||
| 1-ON, 2-OFF, 3-ON | **Station 6** | `5` | $46 / 16 = 2.8750\text{ s}$ | **2 875.0 ms** |
|
||||
| 1-OFF, 2-ON, 3-ON | **Station 7** | `6` | $47 / 16 = 2.9375\text{ s}$ | **2 937.5 ms** |
|
||||
| 1-ON, 2-ON, 3-ON | **Station 8** | `7` | $48 / 16 = 3.0000\text{ s}$ | **3 000.0 ms** |
|
||||
|
||||
### 3.2. Durée du Paquet dans l'Air & Budget Temporel
|
||||
|
||||
Un paquet radio Davis complet est constitué de :
|
||||
- **Préambule** : 4 octets (`32 bits`)
|
||||
- **Sync Word** : 2 octets (`16 bits`)
|
||||
- **Payload utile** : 6 octets (`48 bits`)
|
||||
- **CRC-16** : 2 octets (`16 bits`)
|
||||
- **Total dans l'air** : **14 octets** = **112 bits**
|
||||
|
||||
$$\text{Durée dans l'air} = \frac{112\text{ bits}}{19\text{ }200\text{ bps}} = 5.8333\text{ ms}$$
|
||||
|
||||
### 3.3. Dimensionnement de la Fenêtre de Réception du Relais
|
||||
|
||||
En conditions de haute montagne (température $-20^\circ\text{C}$ à $+30^\circ\text{C}$), les dérives cumulées du quartz de l'ISS et du quartz LSE 32.768 kHz du récepteur ($\pm 20\text{ ppm}$) entraînent une dérive relative maximale de :
|
||||
$$\Delta t_{\text{dérive}} = 40\text{ ppm} \times 2.5625\text{ s} \approx \pm 102.5\text{ }\mu\text{s par tir}$$
|
||||
|
||||
- **Fenêtre nominale de poursuite (*Tracking Window*)** :
|
||||
- Réveil CC1101 : **3.0 ms** avant l'instant estimé.
|
||||
- Durée de capture du paquet : **5.83 ms**.
|
||||
- Marge de garde après tir : **5.0 ms**.
|
||||
- **Durée totale d'écoute active RX** : **14.0 à 18.0 ms** (parfaitement alignée avec DEC-022).
|
||||
- **Recalage de phase à chaque paquet reçu** : L'instant d'interruption EXTI `GDO0` (Sync Word détecté) sert de référence absolue pour recaler le timer RTC du tir suivant, annulant toute accumulation d'erreur de quartz.
|
||||
|
||||
---
|
||||
|
||||
## 4. Structure Binaire des Trames (8 octets utiles)
|
||||
|
||||
Une fois le préambule et le mot de synchronisation validés et retirés par le transceiver matériel (CC1101 ou RFM69), le microcontrôleur reçoit un buffer exact de **8 octets** (`raw[0..7]`) :
|
||||
|
||||
```
|
||||
┌──────────────┬──────────────┬──────────────┬──────────────┬──────────────┬──────────────┬──────────────┬──────────────┐
|
||||
│ Byte 0 │ Byte 1 │ Byte 2 │ Byte 3 │ Byte 4 │ Byte 5 │ Byte 6 │ Byte 7 │
|
||||
├──────────────┼──────────────┼──────────────┼──────────────┼──────────────┼──────────────┼──────────────┼──────────────┤
|
||||
│ Type & ID │ Vitesse Vent │ Direction V. │ Donnée Cap 1 │ Donnée Cap 2 │ Donnée Cap 3 │ CRC-16 (MSB) │ CRC-16 (LSB) │
|
||||
└──────────────┴──────────────┴──────────────┴──────────────┴──────────────┴──────────────┴──────────────┴──────────────┘
|
||||
```
|
||||
|
||||
### 4.1. Octet 0 : En-tête de Trame (`raw[0]`)
|
||||
|
||||
```
|
||||
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
|
||||
┌───────────────────────────────────┬──────────┬────────────────────────────┐
|
||||
│ Packet Type (4 bits) │ Batt_Low │ Station ID (3 bits) │
|
||||
└───────────────────────────────────┴──────────┴────────────────────────────┘
|
||||
```
|
||||
|
||||
- **Bits 7..4 : Type de Paquet / Capteur** :
|
||||
- `0x8` : Température Extérieure (`VP2P_TEMP`)
|
||||
- `0x9` : Rafale de Vent 10 min (`VP2P_WINDGUST`)
|
||||
- `0xA` : Humidité Relative Extérieure (`VP2P_HUMIDITY`)
|
||||
- `0xE` : Pluviosité / Augets (`VP2P_RAIN`)
|
||||
- `0x6` / `0x7` : Rayonnement Solaire (`VP2P_SOLAR`)
|
||||
- `0x4` : Indice UV (`VP2P_UV`)
|
||||
- `0x5` : Pluviosité instantanée / secondes entre basculements (`VP2P_RAINSECS`)
|
||||
- **Bit 3 : Indicateur Batterie Faible (*Transmitter Battery Low*)** :
|
||||
- `0` : Tension batterie/condensateur de l'ISS nominale.
|
||||
- `1` : Batterie de l'ISS faible (pile CR123A à remplacer).
|
||||
- **Bits 2..0 : Identifiant Station ($\text{ID}_{\text{raw}} \in [0..7]$)** :
|
||||
- Correspond au numéro de station configuré ($1 \text{ à } 8$).
|
||||
|
||||
### 4.2. Octet 1 : Vitesse du Vent Instantanée (`raw[1]`)
|
||||
|
||||
- Transmise **dans chaque paquet**, quel que soit le type de capteur du paquet.
|
||||
- Format : Entier non signé sur 8 bits ($0 \text{ à } 255$).
|
||||
- Unité native : **Miles per hour (mph)**.
|
||||
- **Conversion en km/h** :
|
||||
$$v_{\text{km/h}} = v_{\text{mph}} \times 1.609344$$
|
||||
- **Valeur spéciale** : `0x00` = Calme (0 mph).
|
||||
|
||||
### 4.3. Octet 2 : Direction du Vent (`raw[2]`)
|
||||
|
||||
- Transmise **dans chaque paquet**.
|
||||
- Format : Entier non signé sur 8 bits ($0 \text{ à } 255$).
|
||||
- **Conversion en degrés ($0^\circ \text{ à } 359^\circ$)** :
|
||||
$$\text{Direction (degrés)} = \frac{\text{raw}[2] \times 360}{256} = \text{raw}[2] \times 1.40625^\circ$$
|
||||
|
||||
---
|
||||
|
||||
## 5. Décodage Détaillé par Type de Paquet (Octets 3, 4, 5)
|
||||
|
||||
### 5.1. Type `0x8` : Température Extérieure (`VP2P_TEMP`)
|
||||
|
||||
- **Encodage physique** : Valeur sur 12 bits signée en dixièmes de degré Fahrenheit ($1/10^\circ\text{F}$).
|
||||
- **Extraction des bits** :
|
||||
$$\text{raw\_temp\_tenths} = ((\text{raw}[3] \text{ as } \text{i16}) \ll 8 \mid \text{raw}[4] \text{ as } \text{i16}) \gg 4$$
|
||||
- **Conversion exacte en centièmes de °C (virgule fixe)** :
|
||||
$$T_{\text{centi\_C}} = \frac{(\text{raw\_temp\_tenths} - 320) \times 50}{9}$$
|
||||
|
||||
### 5.2. Type `0xA` : Humidité Relative (`VP2P_HUMIDITY`)
|
||||
|
||||
- **Extraction des bits** :
|
||||
$$\text{raw\_hum} = \frac{((\text{raw}[4] \gg 4) \ll 8) \mid \text{raw}[3]}{10}$$
|
||||
- **Plage valide** : $0\% \text{ à } 100\%$.
|
||||
|
||||
### 5.3. Type `0x9` : Rafale de Vent (`VP2P_WINDGUST`)
|
||||
|
||||
- **Octet 3 (`raw[3]`)** : Vitesse maximale de la rafale mesurée sur les 10 dernières minutes en mph.
|
||||
|
||||
### 5.4. Type `0xE` : Pluviosité (`VP2P_RAIN`)
|
||||
|
||||
- **Extraction des bits** :
|
||||
$$\text{tips} = (\text{raw}[3] \ \& \ \text{0x7F}) \mid ((\text{raw}[4] \ \& \ \text{0x0F}) \ll 7)$$
|
||||
- Résolution cône européen métrique : **0.2 mm** par basculement.
|
||||
|
||||
---
|
||||
|
||||
## 6. Algorithme de Contrôle d'Intégrité CRC-16 Davis
|
||||
|
||||
Le protocole DavisTalk utilise un **CRC-16 CCITT** direct calculé sur les **6 premiers octets** de la trame (`raw[0..5]`).
|
||||
|
||||
### 6.1. Paramètres Formels du CRC
|
||||
|
||||
| Paramètre | Valeur |
|
||||
| :--- | :--- |
|
||||
| **Polynôme Générateur** | `0x1021` ($x^{16} + x^{12} + x^5 + 1$) |
|
||||
| **Valeur Initiale (*Init*)** | `0x0000` |
|
||||
| **RefIn (Réflexion entrée)** | `false` (MSB-first direct) |
|
||||
| **RefOut (Réflexion sortie)** | `false` |
|
||||
| **XorOut (Inversion finale)** | `0x0000` |
|
||||
| **Position dans le paquet** | `raw[6]` = CRC MSB, `raw[7]` = CRC LSB |
|
||||
|
||||
### 6.2. Propriété de Vérification Globale
|
||||
|
||||
Si l'on calcule le CRC-16 sur l'intégralité des **8 octets** (payload 6 octets + les 2 octets de CRC reçus), le résultat mathématique exact doit être strictement égal à **`0x0000`** :
|
||||
|
||||
```rust
|
||||
pub fn is_davis_crc_valid(packet_8_bytes: &[u8; 8]) -> bool {
|
||||
crc16_davis(packet_8_bytes) == 0x0000
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. Jeu de Données de Test & Vecteurs de Validation Réels (Mathématiquement Vérifiés)
|
||||
|
||||
### Vecteur 1 : Trame Température Extérieure + Vent
|
||||
- **Octets Bruts (Hex)** : `[ 0x80, 0x0A, 0x40, 0x3E, 0x90, 0x00, 0x3A, 0x5D ]`
|
||||
- **Décodage** :
|
||||
- `raw[0] = 0x80` : Type = `0x8` (Température), Battery OK, Station ID = `0` (Station 1).
|
||||
- `raw[1] = 0x0A = 10` : Vent = $10\text{ mph} \approx 16.1\text{ km/h}$.
|
||||
- `raw[2] = 0x40 = 64` : Direction vent = $\frac{64 \times 360}{256} = 90^\circ$ (Est).
|
||||
- `raw[3..4] = 0x3E, 0x90` : `(0x3E90) >> 4 = 0x3E9 = 1001` ($100.1^\circ\text{F} \approx 37.83^\circ\text{C}$).
|
||||
- `CRC calculé sur raw[0..5]` = `0x3A5D` $\rightarrow$ `raw[6]=0x3A`, `raw[7]=0x5D` $\rightarrow$ **CRC VALIDE == 0x0000**.
|
||||
|
||||
### Vecteur 2 : Trame Pluie (Augets) + Vent
|
||||
- **Octets Bruts (Hex)** : `[ 0xE0, 0x00, 0x00, 0x15, 0x00, 0x00, 0x23, 0xAB ]`
|
||||
- **Décodage** :
|
||||
- `raw[0] = 0xE0` : Type = `0xE` (Pluie), Station ID = `0`.
|
||||
- `raw[1] = 0x00` : Vent calme (0 km/h).
|
||||
- `raw[3..4]` : Compteur augets = `21` basculements ($21 \times 0.2\text{ mm} = 4.2\text{ mm}$).
|
||||
- `CRC calculé sur raw[0..5]` = `0x23AB` $\rightarrow$ `raw[6]=0x23`, `raw[7]=0xAB` $\rightarrow$ **CRC VALIDE == 0x0000**.
|
||||
|
||||
### Vecteur 3 : Trame Humidité Extérieure
|
||||
- **Octets Bruts (Hex)** : `[ 0xA0, 0x05, 0x80, 0x4C, 0x20, 0x00, 0x71, 0x6D ]`
|
||||
- **Décodage** :
|
||||
- `raw[0] = 0xA0` : Type = `0xA` (Humidité), Station ID = `0`.
|
||||
- `raw[1] = 0x05` : Vent = $5\text{ mph} \approx 8.0\text{ km/h}$.
|
||||
- `raw[2] = 0x80 = 128` : Direction vent = $180^\circ$ (Sud).
|
||||
- `raw[3..4]` : Humidité = $58.8\% \rightarrow 58\%$.
|
||||
- `CRC calculé sur raw[0..5]` = `0x716D` $\rightarrow$ `raw[6]=0x71`, `raw[7]=0x6D` $\rightarrow$ **CRC VALIDE == 0x0000**.
|
||||
@@ -0,0 +1,287 @@
|
||||
# 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é
|
||||
@@ -0,0 +1,141 @@
|
||||
# Flux de Données et Interfaces - Gastinel.Weather.169
|
||||
|
||||
## 1. Vue d'Ensemble des Flux
|
||||
|
||||
Le système comporte trois flux de données principaux et un flux d'administration locale :
|
||||
1. **Flux Télémétrie Météo (Montant / Uplink)** : Du capteur Davis vers le serveur domestique via le relais et la station.
|
||||
2. **Flux Télémétrie Système & Diagnostic (Montant / Uplink)** : Du microcontrôleur STM32 vers le serveur domestique.
|
||||
3. **Flux de Contrôle et Configuration (Descendant / Downlink)** : Du serveur domestique vers le relais via la station.
|
||||
4. **Flux d'Administration Locale** : De l'opérateur vers la station (SSH / diagnostics).
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
autonumber
|
||||
participant ISS as Davis Vantage Pro2 ISS
|
||||
participant Relais as Relais STM32L4 (Moucherolle)
|
||||
participant Station as Station Raspberry Pi 4
|
||||
participant Serveur as Serveur Domestique
|
||||
|
||||
Note over ISS,Relais: Acquisition Météo (868 MHz - Toutes les ~2.5s)
|
||||
ISS->>Relais: Paquet RF Davis 868 MHz (Vent/Pluie/Temp/Hum)
|
||||
Relais->>Relais: Décodage, agrégation & bufferisation locale
|
||||
|
||||
Note over Relais,Serveur: Transmission Planifiée (169 MHz - selon politique ex: 10 min ou 1 min)
|
||||
Relais->>Station: Trame Télémétrie Météo + Diagnostic 169 MHz
|
||||
Station->>Station: Validation CRC, horodatage & écriture Tampon Local
|
||||
Station->>Serveur: Export Réseau Ethernet RJ45 (Paquets validés)
|
||||
Serveur->>Serveur: Stockage BDD pérenne & mise à jour Dashboard
|
||||
Serveur-->>Station: Acquittement de réception (mise à jour watermark)
|
||||
|
||||
Note over Serveur,Relais: Plan de Contrôle (Downlink)
|
||||
Serveur->>Station: Nouvelle Politique de Transmission / Commande (RJ45)
|
||||
Station->>Station: File d'attente de commandes
|
||||
Station->>Relais: Émission Trame Commande 169 MHz (fenêtre d'écoute)
|
||||
Relais->>Relais: Validation de la commande & mise à jour RTC / Flash
|
||||
Relais-->>Station: Acquittement de commande (Optionnel / Trame suivante)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Description Détaillée des Flux
|
||||
|
||||
### 2.1. Flux 1 : Télémétrie Météorologique (Uplink)
|
||||
|
||||
```
|
||||
[Davis Vantage Pro2 ISS]
|
||||
│
|
||||
│ Liaison RF 868 MHz (FSK, sauts de canaux Davis, ~2.5s)
|
||||
▼
|
||||
[CC1101 868 MHz] (Sur Relais)
|
||||
│ Bus SPI (lecture FIFO d'octets bruts)
|
||||
▼
|
||||
[Driver CC1101]
|
||||
│ Octets bruts
|
||||
▼
|
||||
[Décodeur Protocole Davis]
|
||||
│ Validation CRC Davis & extraction grandeurs physiques
|
||||
▼
|
||||
[Agrégateur Météo / Buffer Local]
|
||||
│ Agrégation (Moyennes, Min, Max, Rafales)
|
||||
▼
|
||||
[Planificateur d'Émission (RTC)]
|
||||
│ Déclenchement selon la politique horaire active
|
||||
▼
|
||||
[Sérialiseur Télémétrie Surcouche]
|
||||
│ Génération trame compacte normalisée + CRC
|
||||
▼
|
||||
[Driver Émetteur 169 MHz (E32 / CC1101)]
|
||||
│
|
||||
│ Liaison Radio VHF 169 MHz (Longue distance)
|
||||
▼
|
||||
[Récepteur 169 MHz] (Sur Station RPi 4)
|
||||
│ Liaison Série UART / SPI
|
||||
▼
|
||||
[Service Réception Station C++]
|
||||
│ Contrôle de trame & validation CRC
|
||||
▼
|
||||
[Stockage Tampon Local Station (SQLite/Journal)]
|
||||
│ Persistance immédiate (protection contre coupure réseau)
|
||||
▼
|
||||
[Client d'Export Réseau]
|
||||
│
|
||||
│ Liaison Filaire Ethernet RJ45 (Réseau Local)
|
||||
▼
|
||||
[Service d'Ingestion Serveur Domestique]
|
||||
│ Validation finale & horodatage serveur
|
||||
▼
|
||||
[Base de Données Principale & Tableaux de Bord]
|
||||
```
|
||||
|
||||
### 2.2. Flux 2 : Télémétrie Système et Diagnostic (Uplink)
|
||||
1. **Sur le Relais** :
|
||||
- Lecture de la tension batterie par l'ADC interne via diviseur résistif.
|
||||
- Mesure de la température interne du die STM32.
|
||||
- Collecte des statistiques radio 868 MHz (paquets reçus, erreurs CRC) et 169 MHz (émissions).
|
||||
- Relevé des compteurs de veille et du statut watchdog.
|
||||
2. **Encapsulation & Envoi** :
|
||||
- Les métriques système sont concaténées au paquet météo régulier ou transmises dans une sous-trame de diagnostic.
|
||||
3. **À la Station & Serveur** :
|
||||
- La station enregistre les métriques locales associées (RSSI 169 MHz, LQI, horodatage de réception).
|
||||
- Le serveur enregistre l'historique de santé du matériel et génère des alertes (ex. tension batterie basse).
|
||||
|
||||
### 2.3. Flux 3 : Contrôle et Configuration (Downlink)
|
||||
|
||||
```
|
||||
[Serveur Domestique (Plan de Contrôle / UI / CLI)]
|
||||
│ Définition d'une politique (ex. plages 1 min / 10 min)
|
||||
│ Liaison Ethernet RJ45
|
||||
▼
|
||||
[Service Réception Ordres Station RPi 4]
|
||||
│ Stockage dans la file d'attente locale
|
||||
▼
|
||||
[Planificateur d'Émission Station]
|
||||
│ Attente de la fenêtre d'écoute du relais (après transmission météo)
|
||||
│ Liaison Radio 169 MHz
|
||||
▼
|
||||
[Récepteur 169 MHz Relais STM32L4]
|
||||
│ Lecture paquet commande
|
||||
▼
|
||||
[Module de Validation des Commandes]
|
||||
│ Vérification de syntaxe, limites des valeurs et cohérence
|
||||
▼
|
||||
[Moteur de Politiques / Couche Système Relais]
|
||||
│ Enregistrement en mémoire non-volatile (Flash interne)
|
||||
│ Mise à jour des alarmes RTC et du planificateur
|
||||
```
|
||||
|
||||
### 2.4. Flux 4 : Administration Locale Station
|
||||
- L'opérateur se connecte en SSH sur le Raspberry Pi 4.
|
||||
- Consultation des journaux temps réel via `journalctl -u weather-station.service`.
|
||||
- Outils CLI d'inspection du tampon local et d'état du récepteur 169 MHz.
|
||||
|
||||
---
|
||||
|
||||
## 3. Définition des Interfaces Entre Nœuds
|
||||
|
||||
| Interface | Nœud Source | Nœud Destinataire | Média Physique | Protocole / Format | Caractéristiques |
|
||||
| :--- | :--- | :--- | :--- | :--- | :--- |
|
||||
| **INT-01** | Davis ISS | Relais STM32 | Radio 868 MHz (Europe) | Protocole propriétaire Davis (FSK, FHSS) | Unidirectionnel, périodique (~2.5s), sans accusé |
|
||||
| **INT-02** | Relais STM32 | Station RPi 4 | Radio VHF 169 MHz | Trames binaires `/surcouche` (V1: CRC16/32) | Longue portée, bidirectionnel semi-duplex (Half-Duplex) |
|
||||
| **INT-03** | Station RPi 4 | Serveur Domestique | Câble Ethernet RJ45 | Protocole réseau IP (ex. TCP binaire, MQTT ou HTTP/REST) | Fiable, filaire, bidirectionnel, sur réseau local |
|
||||
| **INT-04** | Opérateur | Station RPi 4 | Réseau IP / Ethernet | SSH (OpenSSH ARM64) | Administration système et consultation locale |
|
||||
@@ -0,0 +1,116 @@
|
||||
# Questions Ouvertes & Choix Techniques à Arbitrer - Gastinel.Weather.169
|
||||
|
||||
Ce document recense les points techniques en suspens, les options envisageables, leurs compromis et les validations requises avant implémentation.
|
||||
|
||||
---
|
||||
|
||||
## 1. Liaison Radio 169 MHz & Électronique
|
||||
|
||||
### QO-01 : Configuration fine et débit du module EBYTE E32-170T30D-V2.0
|
||||
- **Contexte** : Le module E32-170T30D est piloté par UART (DEC-017). Les paramètres internes du module (débit radio aérien *air data rate*, parité UART, puissance RF) doivent être fixés.
|
||||
- **Options** :
|
||||
- *Option A* : Configuration en usine / banc de test via le mode 3 (Sleep/Config) et mémorisation en EEPROM interne du module E32.
|
||||
- *Option B* : Configuration dynamique par le STM32 à chaque initialisation via commandes de configuration E32.
|
||||
- **Recommandation** : Option B (permet de s'assurer de la cohérence de configuration même si un module est remplacé sans pré-configuration).
|
||||
- **Statut** : À valider lors du banc de test hardware.
|
||||
|
||||
### QO-02 : Mécanisme de réception des commandes sur le relais (Half-Duplex 169 MHz)
|
||||
- **Contexte** : Pour recevoir les ordres du serveur (politiques, commandes), une fenêtre d'écoute radio est requise.
|
||||
- **Décision d'architecture** : **Option A retenue (DEC-022/FSM)** : Fenêtre d'écoute active de **1.0 seconde** immédiatement après chaque transmission montante 169 MHz. Si aucune commande n'est reçue, le module repasse en sommeil `Stop 2`.
|
||||
- **Statut** : **Arbitré / Validé (FSM Relais)**.
|
||||
|
||||
### QO-11 : Courant crête à l'émission 169 MHz (~450-600 mA) et immunité Brown-Out
|
||||
- **Contexte** : L'émetteur E32 consomme un courant impulsionnel élevé lors de l'émission RF à +27 dBm / +30 dBm. La résistance interne d'une batterie en milieu froid ($-15^\circ\text{C}$) peut provoquer une chute de tension temporaire et déclencher un Brown-Out Reset (BOR) du STM32.
|
||||
- **Actions requises** :
|
||||
- Mesure de la chute de tension sous charge impulsionnelle.
|
||||
- Dimensionnement d'une capacité réservoir (supercondensateur ou condensateur électrolytique faible ESR) sur le rail d'alimentation du module radio.
|
||||
- **Statut** : **À VÉRIFIER sur banc de mesure**.
|
||||
|
||||
---
|
||||
|
||||
## 2. Protocole Davis 868 MHz & Synchronisation
|
||||
|
||||
### QO-03 : Stratégie de verrouillage et suivi de saut de fréquence Davis (FHSS)
|
||||
- **Contexte** : L'ISS Davis Vantage Pro2 émet en bande 868 MHz sur 5 canaux en Europe (868.0, 868.125, 868.25, 868.375, 868.5 MHz) selon une séquence pseudo-aléatoire et un intervalle précis déterminé par l'ID de la station ($T = \frac{41 + ID}{16}$ secondes, soit ~2.5625 s pour ID 1).
|
||||
- **Architecture validée** :
|
||||
- *Phase 1 (Acquisition / Scan à froid)* : Écoute continue sur canal 0 jusqu'à intercepter un premier paquet valide, capture du timestamp précis et calcul de la phase.
|
||||
- *Phase 2 (Poursuite / Tracking)* : Fenêtre d'écoute ultra-courte (**12 à 20 ms**, DEC-022) centrée sur le tir estimé avec compensation de dérive.
|
||||
- **Statut** : **Validé conceptuellement**, à tester sur trames réelles en labo.
|
||||
|
||||
---
|
||||
|
||||
## 3. Système & Stockage Relais
|
||||
|
||||
### QO-04 : Support de persistance de la politique horaire sur le STM32L4
|
||||
- **Contexte** : La politique horaire reçue du serveur doit être protégée contre toute coupure brutale d'alimentation.
|
||||
- **Décision d'architecture** : **Option A retenue (DEC-023)** : Architecture Ping-Pong sur deux pages Flash indépendantes de 2 Ko (Pages 510 et 511) avec en-tête structuré, numéro de séquence monotone, contrôle CRC32 et programmation atomique du mot double de commit (`0x55AA55AA_55AA55AA`).
|
||||
- **Statut** : **Arbitré / Validé (DEC-023)**.
|
||||
|
||||
### QO-05 : Politique de gestion de la mémoire tampon sur le Relais en cas de panne 169 MHz
|
||||
- **Contexte** : Si la liaison radio 169 MHz échoue ou si le relais est contraint de couper ses émissions (ex. tension batterie critique), les mesures s'accumulent en mémoire vive.
|
||||
- **Options** :
|
||||
- *Option A* : File FIFO circulaire simple (les mesures les plus anciennes sont écrasées dès saturation du buffer).
|
||||
- *Option B* : Compression / compaction des agrégats (conservation des extrêmes de température/vent et passage à une moyenne horaire).
|
||||
- **Statut** : Option A retenue pour la V1 (simplicité, déterminisme mémoire).
|
||||
|
||||
---
|
||||
|
||||
## 4. Boot & Outillage Bas Niveau
|
||||
|
||||
### QO-09 : Choix du runtime de démarrage Rust pour STM32L4
|
||||
- **Contexte** : Choix entre `cortex-m-rt` et un assembleur maison `startup.s`.
|
||||
- **Décision d'architecture** : **Option A retenue (DEC-020)** : Runtime standard `cortex-m-rt` avec link script `memory.x` personnalisé pour SRAM2.
|
||||
- **Statut** : **Arbitré / Validé (DEC-020)**.
|
||||
|
||||
### QO-10 : Protocole de caractérisation énergétique sur banc de mesure
|
||||
- **Contexte** : Mesurer précisément la consommation du STM32L476 en phase active, en écoute CC1101, en émission E32 et en mode `Stop 2`.
|
||||
- **Options** :
|
||||
- Analyseur d'énergie type Otii Arc / Nordic Power Profiler Kit II ou mesure oscilloscope différentiel sur shunt résistif de précision (10 $\Omega$ / 100 $\Omega$).
|
||||
- **Statut** : En attente de la phase de validation matérielle en labo.
|
||||
|
||||
---
|
||||
|
||||
## 5. Interfaces Station <-> Serveur Domestique
|
||||
|
||||
### QO-06 : Protocole de transport sur le réseau Ethernet RJ45
|
||||
- **Contexte** : La station Raspberry Pi 4 doit expédier les données validées au serveur domestique et en recevoir les ordres de configuration.
|
||||
- **Options** :
|
||||
- *Option A* : Broker de messages MQTT (Mosquitto) avec topics dédiés (`weather/telemetry/raw`, `weather/control/policy`).
|
||||
- *Option B* : API HTTP/REST ou WebSocket exposée par le serveur domestique.
|
||||
- *Option C* : Protocole binaire direct sur socket TCP sécurisé.
|
||||
- **Statut** : À déterminer selon l'écosystème déjà en place sur le serveur domestique (MQTT recommandé).
|
||||
|
||||
### QO-07 : Moteur de stockage pour le tampon local de la Station
|
||||
- **Contexte** : Garantir le stockage local sans perte sur le Raspberry Pi 4.
|
||||
- **Options** :
|
||||
- *Option A* : Base de données légère **SQLite** (transactions ACID, requêtes d'extraction faciles pour synchronisation).
|
||||
- *Option B* : Journal binaire séquentiel sur fichier (*append-only log*) avec fichier d'index de synchronisation.
|
||||
- **Statut** : Option A retenue (SQLite recommandé pour sa robustesse et sa facilité d'inspection en CLI).
|
||||
|
||||
---
|
||||
|
||||
## 6. Sécurité & Contrôle d'Accès (V2+)
|
||||
|
||||
### QO-08 : Primitive cryptographique pour l'authentification des commandes
|
||||
- **Contexte** : Bien qu'exclue de la V1, l'architecture réserve la taille des champs d'en-tête pour la V2.
|
||||
- **Options à l'étude pour V2** : HMAC-SHA256 tronqué à 64/128 bits ou AES-CMAC (128 bits).
|
||||
- **Statut** : Réservé pour la phase V2, aucun code cryptographique en V1.
|
||||
|
||||
---
|
||||
|
||||
## 7. Acquisition Davis VP2 & Intégration Radio
|
||||
|
||||
### QO-12 : Détection initiale du canal actif lors du scan à froid (Acquisition Phase)
|
||||
- **Contexte** : Lors du premier démarrage du relais (ou après 10 tirs manqués consécutifs), le relais ignore sur quel canal de la séquence `[0, 2, 4, 1, 3]` l'ISS va émettre.
|
||||
- **Options** :
|
||||
- *Option A* : Rester à l'écoute continue sur le Canal 0 (`868.067 MHz`) jusqu'à intercepter un paquet valide (temps d'attente max = $5 \times 2.56\text{ s} \approx 12.8\text{ s}$).
|
||||
- *Option B* : Balayer activement les 5 canaux en changeant de canal toutes les 500 ms.
|
||||
- **Recommandation** : Option A (beaucoup plus simple, déterministe et garantit la capture en moins de 13 secondes sans risque d'inversion de phase).
|
||||
- **Statut** : **À valider sur banc RF avec ISS réelle**.
|
||||
|
||||
### QO-13 : Compensation de dérive thermique extrême du quartz Davis en hiver (-20°C)
|
||||
- **Contexte** : En cas de grand froid, la dérive de l'oscillateur de l'ISS peut dépasser 20 ppm. Si la fenêtre d'écoute est trop serrée (ex: 10 ms), le tir peut déborder.
|
||||
- **Actions requises** :
|
||||
- Mesurer la gigue temporelle (jitter) sur 24 heures en chambre climatique ou en extérieur hivernal.
|
||||
- Ajuster dynamiquement la largeur de la fenêtre d'écoute : 14 ms en régime nominal, élargissement progressif à 25 ms après 2 ou 3 paquets consécutifs manqués avant passage en scan continu.
|
||||
- **Statut** : **À valider en conditions réelles / mesures labo**.
|
||||
@@ -0,0 +1,108 @@
|
||||
# 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.
|
||||
@@ -0,0 +1,129 @@
|
||||
# Changelog
|
||||
|
||||
Format inspiré de [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/).
|
||||
|
||||
> **Note de convention.** Le cahier des charges demandait un CHANGELOG et des
|
||||
> ADR « cohérents avec les conventions déjà en place sur `server-infra` ».
|
||||
> Vérification faite, `server-infra` ne contient ni CHANGELOG ni répertoire
|
||||
> d'ADR. Ce fichier adopte donc Keep a Changelog, et les ADR le format MADR
|
||||
> numéroté. À réaligner si une convention maison existe ailleurs.
|
||||
|
||||
## [0.2.0] — 2026-09-02
|
||||
|
||||
Points [1], [3], [5] et [6] implémentés — **sur hypothèses, pas sur
|
||||
spécification**. Le manifeste Gastinel Frame ne descend pas à ce niveau de
|
||||
détail ; chaque ADR concerné porte le statut *hypothèse provisoire, à valider
|
||||
avant tout déploiement réel*.
|
||||
|
||||
### Ajouté
|
||||
|
||||
- `asm/vercors_keysched.asm` — les quatre points :
|
||||
- **[1]** `vc_derive_grain` : `SHA256(K_M ‖ BE16(semaine ISO) ‖ BE32(compteur
|
||||
anti-rejeu))`. Le grain ne transite jamais par la radio.
|
||||
- **[3]** Fenêtre de Garde Dynamique : élargissement linéaire calé sur la
|
||||
dérive du quartz (20 ppm), plafonné à 30 s, resserrement immédiat et
|
||||
recalage d'horloge sur paquet valide. `vc_gate_accept_window` relâche le
|
||||
bord inférieur sans branchement.
|
||||
- **[5]** Bascule de clé : chaînage, la clé N+1 est chiffrée **sous la clé du
|
||||
jour courant** avant d'être logée dans le bourrage. Drapeau en bit 7 de
|
||||
l'octet d'en-tête, créneau en octets 32–63.
|
||||
- **[6]** `vc_coldstart_needed` : déclenchement local sur reboot ou 7 jours
|
||||
sans paquet valide.
|
||||
- `asm/factory_key.asm` — placeholder de K_M, `PLACEHOLDER-NE-PAS-UTILISER-PROD`
|
||||
en ASCII lisible. **Ne pas utiliser en production.**
|
||||
- `vc_ctr_set_domain` et les constantes `VC_CTR_DOMAIN_FRAME` /
|
||||
`VC_CTR_DOMAIN_KEYWRAP` — séparation de domaine des compteurs CTR, sans
|
||||
laquelle le créneau de clé et la trame partageraient un flot de clé.
|
||||
- `vc_frame_build` / `vc_frame_parse` — construction et lecture de trame avec
|
||||
bascule optionnelle, passage par structure pour éviter le cinquième argument
|
||||
sur la pile sous ABI Microsoft.
|
||||
- 42 tests supplémentaires (86 au total) : vecteur de référence d'encodage du
|
||||
grain, plafonnement de la fenêtre à 10 ans de silence, horloge qui recule,
|
||||
saturation près de minuit, absence de la clé en clair, budget de charge utile
|
||||
en mode bascule, distinction des domaines de compteur.
|
||||
- ADR 0007 à 0010, tous marqués *hypothèse provisoire*.
|
||||
|
||||
### Modifié
|
||||
|
||||
- ADR 0006 reformulé : l'en-tête de trame porte désormais un drapeau de bascule
|
||||
en bit 7, et le fait que **l'en-tête soit à l'intérieur du chiffré** est
|
||||
affirmé explicitement plutôt que laissé déductible.
|
||||
|
||||
### Confirmé
|
||||
|
||||
- **L'octet de longueur ne circule pas en clair.** La trame de 64 octets est
|
||||
construite en clair puis chiffrée **en entier** en AES-256-CTR. Ni la
|
||||
longueur ni le drapeau ne sont observables sur l'air, et toutes les trames
|
||||
font 64 octets quel que soit leur contenu. Aucune correction n'était requise.
|
||||
- Big-endian sur les 4 premiers octets du condensat (Heure Cible) : conservé.
|
||||
|
||||
### Points ouverts
|
||||
|
||||
- **Aucune authentification de trame.** Aggravé par la bascule de clé : sans
|
||||
MAC, un seul bit retourné dans le créneau de clé désynchronise durablement
|
||||
les deux extrémités. Voir ADR 0003 et 0009.
|
||||
- **L'époque d'origine des semaines n'est pas définie** (ADR 0007). Deux
|
||||
implémentations partant d'origines différentes ne se parleront jamais, sans
|
||||
erreur visible.
|
||||
- **Contenu de l'échange de resynchronisation** Cold Start : seul le
|
||||
déclencheur est implémenté, pas le dialogue (ADR 0010).
|
||||
|
||||
### TODO portage
|
||||
|
||||
- `asm/factory_key.asm` disparaît : K_M passe dans l'élément sécurisé
|
||||
**STSAFE-A110**. Changement de forme d'API, pas simple remplacement de
|
||||
constante — les octets de la clé ne doivent jamais transiter par la RAM du
|
||||
STM32U5. Voir ADR 0010.
|
||||
|
||||
## [0.1.0] — 2026-09-02
|
||||
|
||||
Première passe : cœur cryptographique et sous-ensemble protocolaire, en
|
||||
assembleur x86-64 pur.
|
||||
|
||||
### Ajouté
|
||||
|
||||
- `asm/sha256.asm` — SHA-256 complet (FIPS 180-4), API incrémentale et
|
||||
one-shot. Validé sur 4 vecteurs officiels dont le message de 1 Mo.
|
||||
- `asm/aes256.asm` — AES-256 logiciel, chiffrement de bloc et mode CTR. Validé
|
||||
sur FIPS 197 C.3 et NIST SP 800-38A F.5.5.
|
||||
- `asm/const_time.asm` — `memcmp`, masques d'égalité et d'infériorité,
|
||||
déplacement conditionnel et effacement, tous à temps constant.
|
||||
- `asm/csprng.asm` — DRBG maison à base de SHA-256, avec résistance au retour
|
||||
en arrière.
|
||||
- `asm/vercors_protocol.asm` — Heure Cible [2] avec méthode de rejet, gating
|
||||
temporel [4], bourrage à taille fixe [7].
|
||||
- `include/abi.inc` — abstraction de convention d'appel System V / Microsoft
|
||||
x64, permettant d'assembler les mêmes sources pour les deux cibles.
|
||||
- `include/vercors.h` — interface C, avec verrous `_Static_assert` sur les
|
||||
tailles de structures partagées avec l'assembleur.
|
||||
- `hal/` — stubs C radio 169 MHz (bouclage mémoire), IMU et baromètre, avec
|
||||
interfaces pérennes destinées au portage STM32U5.
|
||||
- `test/test_vercors.c` — harnais de 44 tests : vecteurs officiels sur les
|
||||
primitives, puis cycle protocolaire complet sur radio bouclée.
|
||||
- `build.sh` — assemblage et édition de liens, détection automatique de cible.
|
||||
- `docs/adr/0001` à `0006` — décisions d'architecture.
|
||||
|
||||
### Non implémenté à cette version — traité en 0.2.0 sur hypothèses
|
||||
|
||||
Le manifeste Gastinel Frame n'a pas pu être lu (`__RADIO\Gastinel Frame` est
|
||||
vide). Conformément à la consigne de ne rien supposer silencieusement, les
|
||||
points suivants étaient laissés ouverts à cette version :
|
||||
|
||||
- **[1]** Grain de Sel Temporel — fonction de dérivation hebdomadaire inconnue.
|
||||
- **[3]** Fenêtre de Garde Dynamique — aucune valeur numérique fournie.
|
||||
- **[5]** Bascule de clé asynchrone — schéma stéganographique non décrit.
|
||||
- **[6]** Cold Start / resynchronisation — ni détection, ni Clé Maîtresse
|
||||
d'Usine.
|
||||
|
||||
### Soulevé
|
||||
|
||||
- **Authentification des trames.** Le mode CTR retenu ne fournit aucune
|
||||
intégrité : un attaquant peut retourner des bits du clair sans détection. Un
|
||||
MAC ou un mode AEAD manque. La place d'un MAC dans la trame de 64 octets
|
||||
dépend du manifeste. Voir ADR 0003.
|
||||
|
||||
### Connu et assumé
|
||||
|
||||
- AES logiciel expose une fuite par timing de cache via la S-box. Accepté pour
|
||||
la cible STM32U5, à revoir si le protocole tourne un jour sur un hôte
|
||||
partagé. Voir ADR 0002.
|
||||
@@ -0,0 +1,230 @@
|
||||
# VERCORS — prototype x86-64 en assembleur
|
||||
|
||||
*Variable Encryption Rendez-vous Clock-Over-Radio System* — écosystème Gastinel
|
||||
Frame, boîtiers radio bas-débit 169 MHz en montagne.
|
||||
|
||||
Cette passe est un **prototype x86-64 sur PC**, pas la cible finale. Objectif :
|
||||
valider la logique du protocole en assembleur pur avant portage STM32U5
|
||||
(Cortex-M33, Thumb-2).
|
||||
|
||||
---
|
||||
|
||||
## Construire et exécuter
|
||||
|
||||
```bash
|
||||
./build.sh
|
||||
```
|
||||
|
||||
Sans argument, le script détecte la plate-forme : `win64` sous MinGW/MSYS,
|
||||
`elf64` ailleurs. On peut forcer : `./build.sh elf64` ou `./build.sh win64`.
|
||||
Puis :
|
||||
|
||||
```bash
|
||||
./build/test_vercors.exe
|
||||
```
|
||||
|
||||
**Choix de build.** Pas de Makefile : `make` n'est pas installé sur la machine
|
||||
de développement, et le projet ne compte qu'une dizaine d'unités de compilation. Un
|
||||
script `sh` sans dépendance coûte moins cher à maintenir qu'un Makefile qu'on
|
||||
ne peut pas exécuter. Les fonctions assembleur sont appelées depuis un harnais
|
||||
C compilé avec `gcc` — c'était le seul moyen de confronter le code aux vecteurs
|
||||
officiels FIPS/NIST, ce qui était l'enjeu principal de cette passe.
|
||||
|
||||
État actuel : **86 tests, tous au vert.**
|
||||
|
||||
---
|
||||
|
||||
## Ce qui est fait
|
||||
|
||||
### Cryptographie — assembleur pur, aucune dépendance externe
|
||||
|
||||
Pas d'OpenSSL, pas de libsodium, pas une ligne de C dans le chemin
|
||||
cryptographique.
|
||||
|
||||
| Module | Contenu | Validation |
|
||||
|---|---|---|
|
||||
| `asm/sha256.asm` | SHA-256 complet (init/update/final + one-shot) | 4 vecteurs FIPS 180-4, dont 1 Mo, plus l'équivalence incrémental/one-shot |
|
||||
| `asm/aes256.asm` | AES-256 logiciel, chiffrement + mode CTR | FIPS 197 C.3, NIST SP 800-38A F.5.5, bloc partiel, retenue de compteur |
|
||||
| `asm/const_time.asm` | Comparaisons et sélections à temps constant | Écarts en tête et en fin de zone, bornes non signées |
|
||||
| `asm/csprng.asm` | DRBG maison à base de SHA-256 | Déterminisme, divergence, cohérence de préfixe |
|
||||
|
||||
### Protocole — points spécifiés
|
||||
|
||||
| Point du cahier des charges | État |
|
||||
|---|---|
|
||||
| [2] Heure Cible | **Fait** — SHA-256 → 4 octets big-endian → méthode de rejet → uniforme sur 0–86399 |
|
||||
| [4] Gating temporel avant déchiffrement | **Fait** — rejet sans lancer AES, rendu en masque |
|
||||
| [7] Bourrage aléatoire à 64 octets | **Fait** — bruit CSPRNG |
|
||||
| [8] Chiffrement/déchiffrement AES-256 CTR | **Fait** — compteur avancé et chaîné |
|
||||
|
||||
### Protocole — points sur hypothèses
|
||||
|
||||
> **Ces quatre points ne reposent pas sur une spécification.** Le manifeste
|
||||
> Gastinel Frame ne descend pas à ce niveau de détail. Les constructions
|
||||
> ci-dessous viennent d'hypothèses de travail, complétées ici par des choix
|
||||
> d'encodage. Chacune est documentée en ADR avec le statut *hypothèse
|
||||
> provisoire*. **Rien de tout cela ne doit être déployé sans validation.**
|
||||
|
||||
| Point | Construction retenue | ADR |
|
||||
|---|---|---|
|
||||
| [1] Grain de Sel Temporel | `SHA256(K_M ‖ BE16(semaine ISO) ‖ BE32(compteur anti-rejeu))` — ne transite jamais par la radio | [0007](docs/adr/0007-grain-de-sel-derivation.md) |
|
||||
| [3] Fenêtre de Garde | Élargissement linéaire calé sur la dérive du quartz (20 ppm), plafonné à 30 s, resserrement immédiat | [0008](docs/adr/0008-fenetre-de-garde-dynamique.md) |
|
||||
| [5] Bascule de clé | Chaînage : clé N+1 chiffrée **sous la clé N** avant d'être logée dans le bourrage | [0009](docs/adr/0009-bascule-de-cle-steganographique.md) |
|
||||
| [6] Cold Start | Déclenchement local : reboot, ou 7 jours sans paquet valide → repli sur K_M | [0010](docs/adr/0010-cold-start-cle-maitresse.md) |
|
||||
|
||||
**Trois points méritent d'être lus avant d'aller plus loin :**
|
||||
|
||||
1. **L'époque d'origine des semaines n'est pas définie** ([ADR 0007](docs/adr/0007-grain-de-sel-derivation.md)).
|
||||
Un `uint16` ne porte pas d'année : « semaine 36 » est ambigu. Deux
|
||||
implémentations partant d'origines différentes dérivent des grains
|
||||
différents et **ne se parleront jamais** — sans erreur visible, juste un
|
||||
silence radio permanent.
|
||||
2. **La bascule de clé fait tomber la charge utile de 63 à 31 octets** les jours
|
||||
de renouvellement. Une clé AES-256 occupe la moitié d'une trame de 64 octets :
|
||||
c'est arithmétique. À confirmer que 31 octets suffisent.
|
||||
3. **La séparation de domaine des compteurs CTR n'est pas négociable**
|
||||
([ADR 0009](docs/adr/0009-bascule-de-cle-steganographique.md)). Sans elle, le
|
||||
créneau de clé et la trame partageraient un flot de clé sous la même clé du
|
||||
jour, ce qui révélerait la clé N+1. `vc_ctr_set_domain` existe pour rendre
|
||||
cette contrainte explicite plutôt que laissée à la discipline de l'appelant.
|
||||
|
||||
### Clé Maîtresse d'Usine
|
||||
|
||||
`asm/factory_key.asm` contient un **placeholder de test** valant littéralement
|
||||
`PLACEHOLDER-NE-PAS-UTILISER-PROD`, en ASCII lisible pour qu'un dump mémoire
|
||||
crie ce qu'il est. Cette clé est publique : elle vit en clair dans un fichier
|
||||
versionné.
|
||||
|
||||
**TODO PORTAGE — ce n'est pas un simple remplacement de constante.** Sur cible,
|
||||
K_M vivra dans l'élément sécurisé **STSAFE-A110**. Les octets de la clé ne
|
||||
doivent alors jamais transiter par la RAM du STM32U5, sinon l'élément sécurisé
|
||||
ne sert à rien. L'API devra donc passer d'une exposition de clé
|
||||
(`vc_factory_key` retourne un pointeur) à une API **par opération**, le STSAFE
|
||||
faisant le calcul lui-même : `vc_derive_grain(km, ...)` deviendra
|
||||
`vc_derive_grain_stsafe(week, counter, out)`, sans paramètre de clé. C'est la
|
||||
différence structurante entre ce prototype et la cible, et le premier point à
|
||||
traiter au portage. Détail dans l'[ADR 0010](docs/adr/0010-cold-start-cle-maitresse.md).
|
||||
|
||||
### Couche d'abstraction matérielle
|
||||
|
||||
`hal/` — stubs **en C**, comme demandé, avec des `.h` définissant l'interface
|
||||
pérenne que le portage STM32U5 devra honorer :
|
||||
|
||||
- `vc_radio.h` / `radio_stub.c` — bouclage mémoire tenant lieu de transceiver
|
||||
169 MHz ; `vc_radio_send`, `vc_radio_recv`, `vc_radio_last_rx_seconds`
|
||||
- `vc_imu.h` / `imu_stub.c` — accéléromètre, drapeau de chute
|
||||
- `vc_baro.h` / `baro_stub.c` — pression, température
|
||||
|
||||
Chaque stub expose en plus une ou deux fonctions `*_stub_*` **absentes des
|
||||
en-têtes** : ce sont des points de contrôle réservés au harnais de test
|
||||
(déplacer l'horloge d'arrivée, armer une chute). Le code protocolaire ne les
|
||||
appelle jamais, et la cible ne les aura pas.
|
||||
|
||||
---
|
||||
|
||||
## Confirmation demandée sur la trame
|
||||
|
||||
L'octet d'en-tête (longueur + drapeau de bascule) est **déjà à l'intérieur du
|
||||
chiffré** : `vc_frame_pad` / `vc_frame_build` construisent les 64 octets en
|
||||
clair, puis l'appelant chiffre le bloc **entier** en AES-256-CTR. Ni la
|
||||
longueur ni le drapeau ne circulent en clair sur l'air, et toutes les trames
|
||||
font 64 octets quel que soit leur contenu — l'exigence d'indifférenciabilité du
|
||||
cas C est satisfaite. Aucune correction n'était nécessaire ; l'ADR 0006 a été
|
||||
reformulé pour que ce soit explicite plutôt que déductible.
|
||||
|
||||
---
|
||||
|
||||
## Point ouvert : aucune authentification de trame
|
||||
|
||||
CTR ne fournit **aucune intégrité**. Un attaquant peut retourner des bits
|
||||
arbitraires du clair sans être détecté. Le gating temporel filtre l'inondation,
|
||||
pas la falsification ciblée.
|
||||
|
||||
La bascule de clé aggrave l'enjeu : sans MAC, un attaquant ne peut pas
|
||||
*choisir* la clé N+1, mais il peut la **corrompre**, et provoquer une
|
||||
désynchronisation permanente des deux extrémités avec un seul bit retourné.
|
||||
L'authentification n'est pas un raffinement ici — c'est ce qui empêche un déni
|
||||
de service définitif à coût nul.
|
||||
|
||||
Il manque donc un MAC (HMAC-SHA-256 tronqué, ou AES-CMAC) ou un mode AEAD. Le
|
||||
SHA-256 nécessaire est déjà présent dans ce dépôt. C'est la place du MAC dans
|
||||
les 64 octets qui reste à décider — et le budget est serré les jours de
|
||||
bascule, où il ne reste que 31 octets utiles. Voir
|
||||
[ADR 0003](docs/adr/0003-mode-ctr.md) et
|
||||
[ADR 0009](docs/adr/0009-bascule-de-cle-steganographique.md).
|
||||
|
||||
---
|
||||
|
||||
## Écarts par rapport au cahier des charges, et pourquoi
|
||||
|
||||
| Écart | Justification |
|
||||
|---|---|
|
||||
| Cible Win64 exécutable en plus d'ELF64/System V | WSL n'est pas installé : assembler en ELF sans pouvoir exécuter aurait produit du code jamais lancé, alors que l'objet de la passe est de *valider*. Une abstraction d'ABI (`include/abi.inc`) rend les mêmes sources valides dans les deux formats. **System V reste la cible de référence.** ADR 0001 |
|
||||
| AES logiciel, pas AES-NI | Le prompt l'autorisait à condition de le signaler ; le choix inverse a été fait pour que le code testé soit celui qui sera porté. ADR 0002 |
|
||||
| Pas de Makefile | `make` absent de la machine ; six unités de compilation. |
|
||||
| Disposition interne de la trame | **Hypothèse explicite** faute de manifeste, isolée dans quatre fonctions. ADR 0006, 0009 |
|
||||
| Points [1] [3] [5] [6] | Implémentés sur **hypothèses**, pas sur spécification. Chaque ADR concerné porte le statut *hypothèse provisoire*. ADR 0007 à 0010 |
|
||||
| ADR/CHANGELOG : conventions non reprises de `server-infra` | Le prompt demande la cohérence avec `server-infra`, mais ce dépôt **ne contient ni CHANGELOG ni ADR** (vérifié). Format MADR standard retenu par défaut ; à réaligner si une convention existe ailleurs. |
|
||||
|
||||
---
|
||||
|
||||
## Ce qui devra être réécrit pour Cortex-M33
|
||||
|
||||
Le découpage a été fait pour que cette liste soit courte et localisée. La
|
||||
logique — planning de message SHA-256, S-box AES, `MixColumns`, méthode de
|
||||
rejet, construction du DRBG — est portable telle quelle.
|
||||
|
||||
| Élément x86-64 | Équivalent / travail Thumb-2 |
|
||||
|---|---|
|
||||
| `include/abi.inc` en entier | À remplacer par un équivalent AAPCS (arguments dans `r0-r3`). Aucune logique protocolaire n'y réside. |
|
||||
| `r8d..r15d` pour l'état SHA-256 (a..h) | Thumb-2 n'a que `r0-r12` utilisables : il faudra spiller une partie de l'état sur la pile. |
|
||||
| `bswap` | `rev` |
|
||||
| `ror` 32 bits | `ror` — portable tel quel |
|
||||
| `rep movsb` / `rep stosb` / `rep stosq` | Boucles explicites |
|
||||
| `div` (reste modulo 86400) | Le M33 n'a pas de division entière avec reste sur 64 bits : `udiv` + `mls`, ou réduction par soustractions à temps constant |
|
||||
| `sbb reg, reg` (masque depuis la retenue) | `sbc r, r, r` |
|
||||
| `cmovb` | `it`/`mov` conditionnel, ou arithmétique de masque |
|
||||
| Demi-registre haut `ah` dans `SUBWORD` | Pas d'équivalent : `ubfx` / `bfi` |
|
||||
| Tableau `W` de 256 octets sur la pile (SHA-256) | À vérifier vis-à-vis de la taille de pile des tâches embarquées |
|
||||
| Amorçage du CSPRNG | À câbler sur le TRNG matériel du STM32U5 — **point de vérification obligatoire de la revue de portage** |
|
||||
| `asm/factory_key.asm` en entier | Disparaît : K_M passe dans l'élément sécurisé STSAFE-A110, avec changement de forme d'API. ADR 0010 |
|
||||
| `xchg al, ah` (encodage BE16 du grain) | Pas d'équivalent : `rev16`, ou `ubfx`/`bfi` |
|
||||
|
||||
Aucune extension SIMD, AES-NI ou SHA-NI n'est utilisée nulle part.
|
||||
|
||||
---
|
||||
|
||||
## Arborescence
|
||||
|
||||
```
|
||||
asm/ sha256, aes256, const_time, csprng,
|
||||
vercors_protocol (points 2, 4, 7, 8)
|
||||
vercors_keysched (points 1, 3, 5, 6 -- hypotheses)
|
||||
factory_key (placeholder K_M, disparait au portage)
|
||||
include/ abi.inc (macros d'ABI), vercors.h (interface C)
|
||||
hal/ stubs radio / IMU / baromètre, en C
|
||||
test/ harnais de cycle complet
|
||||
docs/adr/ décisions d'architecture numérotées
|
||||
build.sh assemblage et édition de liens
|
||||
```
|
||||
|
||||
## Sécurité — ce qui est garanti et ce qui ne l'est pas
|
||||
|
||||
**Garanti** : comparaisons de secrets à temps constant (`const_time.asm`,
|
||||
aucun saut conditionnel sur une valeur secrète) ; effacement non optimisable
|
||||
des tampons sensibles ; gating temporel strictement antérieur à AES ; bourrage
|
||||
en bruit et non en zéros.
|
||||
|
||||
**Garanti aussi** : séparation de domaine des compteurs CTR entre trame et
|
||||
créneau de clé ; clé N+1 jamais en clair, même avant le chiffrement de trame ;
|
||||
fenêtre de garde bornée quoi qu'il arrive, y compris horloge qui recule.
|
||||
|
||||
**Non garanti** : résistance au timing de cache d'AES logiciel (ADR 0002,
|
||||
assumé pour cette cible) ; intégrité/authenticité des trames sous CTR
|
||||
(ADR 0003 et 0009, **ouvert**) ; qualité de l'entropie d'amorçage, qui dépend
|
||||
de l'appelant (ADR 0004) ; protection de K_M, qui n'existe pas sur ce prototype
|
||||
(ADR 0010).
|
||||
|
||||
**Non validé** : les quatre constructions [1] [3] [5] [6] sont des hypothèses.
|
||||
Elles sont cohérentes et testées, mais rien ne dit qu'elles correspondent au
|
||||
protocole VERCORS réel.
|
||||
@@ -0,0 +1,426 @@
|
||||
; =============================================================================
|
||||
; aes256.asm -- AES-256 logiciel en assembleur x86-64 pur, sans dependance.
|
||||
;
|
||||
; DECISION (voir docs/adr/0002) : implementation LOGICIELLE, pas AES-NI.
|
||||
; Le prompt autorise AES-NI a condition de le signaler. Le choix inverse a ete
|
||||
; fait volontairement : cette passe x86-64 sert a valider la logique VERCORS
|
||||
; avant portage Cortex-M33, or le M33 n'a pas d'accelerateur AES accessible de
|
||||
; la meme facon. Ecrire ici la version logicielle donne un comportement
|
||||
; strictement identique a celui de la cible, et la meme structure de code a
|
||||
; porter. Une variante AES-NI serait plus rapide mais validerait un chemin
|
||||
; d'execution qui n'existera jamais sur le boitier.
|
||||
;
|
||||
; DECISION (voir docs/adr/0003) : mode CTR, comme suggere. Consequence directe
|
||||
; ici : CTR n'utilise QUE le chiffrement de bloc. Aucune fonction de
|
||||
; dechiffrement (InvSubBytes, InvMixColumns, table inverse) n'est necessaire --
|
||||
; c'est environ la moitie du code et de la ROM en moins sur STM32U5.
|
||||
;
|
||||
; API publique :
|
||||
; void vc_aes256_expand_key (const uint8_t key[32], vc_aes_rk *rk);
|
||||
; void vc_aes256_encrypt_block(const vc_aes_rk *rk, const uint8_t in[16],
|
||||
; uint8_t out[16]);
|
||||
; void vc_aes256_ctr_xor (const vc_aes_rk *rk, uint8_t ctr[16],
|
||||
; uint8_t *inout, size_t len);
|
||||
;
|
||||
; vc_aes256_ctr_xor travaille EN PLACE (4 arguments). Une signature separant
|
||||
; entree et sortie aurait fait 5 arguments, donc un passage par la pile sous
|
||||
; ABI Microsoft dont l'offset depend des registres empiles par VC_ARGS. CTR
|
||||
; etant une simple XOR involutive, le sur-place est naturel et evite ce piege.
|
||||
;
|
||||
; MISE EN GARDE TEMPORELLE : les SubBytes passent par une table S de 256 octets
|
||||
; indexee par des donnees secretes. Sur un CPU a cache partage, cela expose une
|
||||
; fuite par timing de cache. C'est accepte ici et documente dans l'ADR 0002 :
|
||||
; - la cible reelle (STM32U5) n'a pas de cache de donnees partage avec un
|
||||
; attaquant, ni de multi-tenance ; le modele de menace radio est distant ;
|
||||
; - une version constante en temps demanderait du bitslicing, qui ne se porte
|
||||
; pas tel quel en Thumb-2 et brouillerait l'objectif de cette passe.
|
||||
; Les comparaisons de secrets, elles, sont bien en temps constant (const_time.asm).
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : la logique (S-box, ShiftRows, MixColumns, cadencement
|
||||
; de cles) est portable telle quelle. Sont x86-64-specifiques :
|
||||
; - l'allocation de registres et l'usage de rbp comme base d'etat sur pile ;
|
||||
; - l'astuce d'acces au demi-registre haut (ah) dans SUBWORD, qui n'a pas
|
||||
; d'equivalent Thumb-2 (il faudra des ubfx/bfi) ;
|
||||
; - ror sur 32 bits, disponible en Thumb-2 (ror), donc portable.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
%define AES_ROUNDS 14
|
||||
%define AES_RK_BYTES 240 ; (14 + 1) * 16
|
||||
|
||||
; =============================================================================
|
||||
SECT_RODATA
|
||||
|
||||
align 64
|
||||
SBOX:
|
||||
db 0x63,0x7c,0x77,0x7b,0xf2,0x6b,0x6f,0xc5,0x30,0x01,0x67,0x2b,0xfe,0xd7,0xab,0x76
|
||||
db 0xca,0x82,0xc9,0x7d,0xfa,0x59,0x47,0xf0,0xad,0xd4,0xa2,0xaf,0x9c,0xa4,0x72,0xc0
|
||||
db 0xb7,0xfd,0x93,0x26,0x36,0x3f,0xf7,0xcc,0x34,0xa5,0xe5,0xf1,0x71,0xd8,0x31,0x15
|
||||
db 0x04,0xc7,0x23,0xc3,0x18,0x96,0x05,0x9a,0x07,0x12,0x80,0xe2,0xeb,0x27,0xb2,0x75
|
||||
db 0x09,0x83,0x2c,0x1a,0x1b,0x6e,0x5a,0xa0,0x52,0x3b,0xd6,0xb3,0x29,0xe3,0x2f,0x84
|
||||
db 0x53,0xd1,0x00,0xed,0x20,0xfc,0xb1,0x5b,0x6a,0xcb,0xbe,0x39,0x4a,0x4c,0x58,0xcf
|
||||
db 0xd0,0xef,0xaa,0xfb,0x43,0x4d,0x33,0x85,0x45,0xf9,0x02,0x7f,0x50,0x3c,0x9f,0xa8
|
||||
db 0x51,0xa3,0x40,0x8f,0x92,0x9d,0x38,0xf5,0xbc,0xb6,0xda,0x21,0x10,0xff,0xf3,0xd2
|
||||
db 0xcd,0x0c,0x13,0xec,0x5f,0x97,0x44,0x17,0xc4,0xa7,0x7e,0x3d,0x64,0x5d,0x19,0x73
|
||||
db 0x60,0x81,0x4f,0xdc,0x22,0x2a,0x90,0x88,0x46,0xee,0xb8,0x14,0xde,0x5e,0x0b,0xdb
|
||||
db 0xe0,0x32,0x3a,0x0a,0x49,0x06,0x24,0x5c,0xc2,0xd3,0xac,0x62,0x91,0x95,0xe4,0x79
|
||||
db 0xe7,0xc8,0x37,0x6d,0x8d,0xd5,0x4e,0xa9,0x6c,0x56,0xf4,0xea,0x65,0x7a,0xae,0x08
|
||||
db 0xba,0x78,0x25,0x2e,0x1c,0xa6,0xb4,0xc6,0xe8,0xdd,0x74,0x1f,0x4b,0xbd,0x8b,0x8a
|
||||
db 0x70,0x3e,0xb5,0x66,0x48,0x03,0xf6,0x0e,0x61,0x35,0x57,0xb9,0x86,0xc1,0x1d,0x9e
|
||||
db 0xe1,0xf8,0x98,0x11,0x69,0xd9,0x8e,0x94,0x9b,0x1e,0x87,0xe9,0xce,0x55,0x28,0xdf
|
||||
db 0x8c,0xa1,0x89,0x0d,0xbf,0xe6,0x42,0x68,0x41,0x99,0x2d,0x0f,0xb0,0x54,0xbb,0x16
|
||||
|
||||
; Rcon[j] pour j = 1..7 (AES-256 : i/Nk va de 1 a 7).
|
||||
; Le mot est stocke en little-endian, donc l'octet de poids faible correspond
|
||||
; a b0, l'octet le plus a gauche du mot AES : Rcon vaut bien 0x000000xx.
|
||||
align 16
|
||||
RCON:
|
||||
dd 0x00000001, 0x00000002, 0x00000004, 0x00000008
|
||||
dd 0x00000010, 0x00000020, 0x00000040
|
||||
|
||||
; =============================================================================
|
||||
section .text
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; XTIME %1 -- multiplication par x dans GF(2^8), sans branchement.
|
||||
; %1 : registre 32 bits contenant une valeur 0..255 (entree/sortie)
|
||||
; %2 : registre 32 bits scratch
|
||||
; Le masque est derive du bit 7 par neg, donc pas de saut conditionnel
|
||||
; dependant de la donnee.
|
||||
; -----------------------------------------------------------------------------
|
||||
%macro XTIME 2
|
||||
mov %2, %1
|
||||
shr %2, 7
|
||||
and %2, 1
|
||||
neg %2 ; 0x00000000 ou 0xffffffff
|
||||
and %2, 0x1b
|
||||
add %1, %1
|
||||
and %1, 0xff
|
||||
xor %1, %2
|
||||
%endmacro
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; SUBWORD -- applique la S-box aux 4 octets de eax.
|
||||
; Entree/sortie : eax. Clobber : ecx, edx. Base S-box attendue dans rbx.
|
||||
; N'utilise que des registres herites (ah interdit avec un prefixe REX).
|
||||
; -----------------------------------------------------------------------------
|
||||
%macro SUBWORD 0
|
||||
movzx ecx, al
|
||||
movzx edx, ah
|
||||
mov cl, [rbx + rcx]
|
||||
mov dl, [rbx + rdx]
|
||||
mov al, cl
|
||||
mov ah, dl
|
||||
ror eax, 16
|
||||
movzx ecx, al
|
||||
movzx edx, ah
|
||||
mov cl, [rbx + rcx]
|
||||
mov dl, [rbx + rdx]
|
||||
mov al, cl
|
||||
mov ah, dl
|
||||
ror eax, 16
|
||||
%endmacro
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; Symboles exportes pour les autres modules ASM du projet (convention privee
|
||||
; System V), pas pour du code C. Voir la note equivalente dans sha256.asm.
|
||||
; -----------------------------------------------------------------------------
|
||||
global aes256_expand_key_i
|
||||
global aes256_encrypt_block_i
|
||||
global aes256_ctr_xor_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; aes256_expand_key_i -- interne. rdi = cle 32 octets, rsi = rk (240 octets).
|
||||
;
|
||||
; Cadencement AES-256 : Nk = 8, Nr = 14, 60 mots de 32 bits.
|
||||
; w[i] = w[i-8] ^ f(w[i-1]) avec f = SubWord(RotWord(.)) ^ Rcon si i%8 == 0
|
||||
; f = SubWord(.) si i%8 == 4
|
||||
; f = identite sinon
|
||||
; La branche supplementaire a i%8 == 4 est propre a AES-256 (absente en 128).
|
||||
; -----------------------------------------------------------------------------
|
||||
aes256_expand_key_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
|
||||
; --- w[0..7] = cle
|
||||
mov rax, [rdi + 0]
|
||||
mov [rsi + 0], rax
|
||||
mov rax, [rdi + 8]
|
||||
mov [rsi + 8], rax
|
||||
mov rax, [rdi + 16]
|
||||
mov [rsi + 16], rax
|
||||
mov rax, [rdi + 24]
|
||||
mov [rsi + 24], rax
|
||||
|
||||
lea rbx, [SBOX]
|
||||
lea r13, [RCON]
|
||||
mov r12, 8 ; i
|
||||
|
||||
.loop:
|
||||
mov eax, [rsi + 4*r12 - 4] ; temp = w[i-1]
|
||||
|
||||
mov r8d, r12d
|
||||
and r8d, 7
|
||||
jnz .maybe_mid
|
||||
|
||||
; --- i % 8 == 0
|
||||
ror eax, 8 ; RotWord
|
||||
SUBWORD
|
||||
mov r8d, r12d
|
||||
shr r8d, 3 ; j = i / 8, dans 1..7
|
||||
xor eax, [r13 + 4*r8 - 4] ; ^ Rcon[j]
|
||||
jmp .combine
|
||||
|
||||
.maybe_mid:
|
||||
cmp r8d, 4
|
||||
jne .combine
|
||||
; --- i % 8 == 4 : SubWord seule (specifique AES-256)
|
||||
SUBWORD
|
||||
|
||||
.combine:
|
||||
xor eax, [rsi + 4*r12 - 32] ; ^ w[i-8]
|
||||
mov [rsi + 4*r12], eax
|
||||
|
||||
inc r12
|
||||
cmp r12, 60
|
||||
jb .loop
|
||||
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; aes256_encrypt_block_i -- interne.
|
||||
; rdi = rk, rsi = bloc clair 16 octets, rdx = bloc chiffre 16 octets.
|
||||
; in et out peuvent etre confondus.
|
||||
;
|
||||
; Cadre de pile (rbp) :
|
||||
; [rbp + 0 .. 15] etat courant
|
||||
; [rbp + 16 .. 31] etat intermediaire (apres SubBytes+ShiftRows)
|
||||
; [rbp + 32 .. 39] pointeur de sortie (rdx est ecrase pendant les rondes)
|
||||
; -----------------------------------------------------------------------------
|
||||
aes256_encrypt_block_i:
|
||||
push rbx
|
||||
push rbp
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
push r15
|
||||
sub rsp, 48
|
||||
mov rbp, rsp
|
||||
|
||||
mov [rbp + 32], rdx ; pointeur de sortie, a l'abri
|
||||
|
||||
; --- etat = bloc ^ rk[0] (AddRoundKey initial)
|
||||
mov rax, [rsi + 0]
|
||||
xor rax, [rdi + 0]
|
||||
mov [rbp + 0], rax
|
||||
mov rax, [rsi + 8]
|
||||
xor rax, [rdi + 8]
|
||||
mov [rbp + 8], rax
|
||||
|
||||
lea rbx, [SBOX]
|
||||
lea r14, [rdi + 16] ; pointeur de cle de ronde courante
|
||||
mov r13, 1 ; numero de ronde
|
||||
|
||||
.round_loop:
|
||||
; --- SubBytes + ShiftRows, fusionnes : etat -> intermediaire.
|
||||
; out[r + 4c] = S[ in[r + 4*((c + r) mod 4)] ]
|
||||
; Les index sont resolus a l'assemblage, il n'y a aucun calcul
|
||||
; d'adresse dependant de la donnee.
|
||||
%assign idx 0
|
||||
%rep 16
|
||||
%assign rr (idx & 3)
|
||||
%assign cc (idx >> 2)
|
||||
movzx eax, byte [rbp + (rr + 4*((cc + rr) & 3))]
|
||||
mov al, [rbx + rax]
|
||||
mov [rbp + 16 + idx], al
|
||||
%assign idx idx+1
|
||||
%endrep
|
||||
|
||||
; --- MixColumns, sautee a la derniere ronde
|
||||
cmp r13, AES_ROUNDS
|
||||
je .add_round_key
|
||||
|
||||
%assign cc 0
|
||||
%rep 4
|
||||
movzx eax, byte [rbp + 16 + 4*cc + 0] ; a0
|
||||
movzx ecx, byte [rbp + 16 + 4*cc + 1] ; a1
|
||||
movzx edx, byte [rbp + 16 + 4*cc + 2] ; a2
|
||||
movzx r8d, byte [rbp + 16 + 4*cc + 3] ; a3
|
||||
|
||||
mov r9d, eax
|
||||
xor r9d, ecx
|
||||
xor r9d, edx
|
||||
xor r9d, r8d ; t = a0^a1^a2^a3
|
||||
|
||||
; b0 = a0 ^ t ^ xtime(a0 ^ a1)
|
||||
mov r11d, eax
|
||||
xor r11d, ecx
|
||||
XTIME r11d, r15d
|
||||
xor r11d, r9d
|
||||
xor r11d, eax
|
||||
mov [rbp + 16 + 4*cc + 0], r11b
|
||||
; b1 = a1 ^ t ^ xtime(a1 ^ a2)
|
||||
mov r11d, ecx
|
||||
xor r11d, edx
|
||||
XTIME r11d, r15d
|
||||
xor r11d, r9d
|
||||
xor r11d, ecx
|
||||
mov [rbp + 16 + 4*cc + 1], r11b
|
||||
; b2 = a2 ^ t ^ xtime(a2 ^ a3)
|
||||
mov r11d, edx
|
||||
xor r11d, r8d
|
||||
XTIME r11d, r15d
|
||||
xor r11d, r9d
|
||||
xor r11d, edx
|
||||
mov [rbp + 16 + 4*cc + 2], r11b
|
||||
; b3 = a3 ^ t ^ xtime(a3 ^ a0)
|
||||
mov r11d, r8d
|
||||
xor r11d, eax
|
||||
XTIME r11d, r15d
|
||||
xor r11d, r9d
|
||||
xor r11d, r8d
|
||||
mov [rbp + 16 + 4*cc + 3], r11b
|
||||
|
||||
%assign cc cc+1
|
||||
%endrep
|
||||
|
||||
.add_round_key:
|
||||
mov rax, [rbp + 16]
|
||||
xor rax, [r14 + 0]
|
||||
mov [rbp + 0], rax
|
||||
mov rax, [rbp + 24]
|
||||
xor rax, [r14 + 8]
|
||||
mov [rbp + 8], rax
|
||||
|
||||
add r14, 16
|
||||
inc r13
|
||||
cmp r13, AES_ROUNDS
|
||||
jbe .round_loop
|
||||
|
||||
; --- ecriture du resultat
|
||||
mov rdx, [rbp + 32]
|
||||
mov rax, [rbp + 0]
|
||||
mov [rdx + 0], rax
|
||||
mov rax, [rbp + 8]
|
||||
mov [rdx + 8], rax
|
||||
|
||||
; --- effacement de l'etat intermediaire (contient du clair partiel)
|
||||
xor eax, eax
|
||||
mov [rbp + 0], rax
|
||||
mov [rbp + 8], rax
|
||||
mov [rbp + 16], rax
|
||||
mov [rbp + 24], rax
|
||||
|
||||
add rsp, 48
|
||||
pop r15
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbp
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; ctr_inc_i -- interne. rdi = compteur 16 octets, incremente en big-endian
|
||||
; sur la totalite du bloc (NIST SP 800-38A, compteur standard sur 128 bits).
|
||||
; Duree d'execution dependante de la retenue, mais le compteur n'est pas secret.
|
||||
; -----------------------------------------------------------------------------
|
||||
ctr_inc_i:
|
||||
mov rcx, 15
|
||||
.loop:
|
||||
inc byte [rdi + rcx]
|
||||
jnz .done
|
||||
dec rcx
|
||||
jns .loop
|
||||
.done:
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; Enveloppes publiques
|
||||
; =============================================================================
|
||||
|
||||
VC_FUNC vc_aes256_expand_key
|
||||
VC_ARGS ; rdi = key32, rsi = rk
|
||||
call aes256_expand_key_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_aes256_encrypt_block
|
||||
VC_ARGS ; rdi = rk, rsi = in, rdx = out
|
||||
call aes256_encrypt_block_i
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_aes256_ctr_xor(const vc_aes_rk *rk, uint8_t ctr[16],
|
||||
; uint8_t *inout, size_t len)
|
||||
; XOR sur place avec le flot CTR. Le compteur est avance et laisse a jour
|
||||
; pour permettre un chainage sur plusieurs appels.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_aes256_ctr_xor
|
||||
VC_ARGS ; rdi = rk, rsi = ctr, rdx = inout, rcx = len
|
||||
call aes256_ctr_xor_i
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; aes256_ctr_xor_i -- interne. rdi = rk, rsi = ctr, rdx = inout, rcx = len.
|
||||
; -----------------------------------------------------------------------------
|
||||
aes256_ctr_xor_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
push r15
|
||||
sub rsp, 16 ; tampon de flot
|
||||
|
||||
mov r12, rdi ; rk
|
||||
mov r13, rsi ; ctr
|
||||
mov r14, rdx ; inout
|
||||
mov r15, rcx ; len
|
||||
mov rbx, rsp ; keystream
|
||||
|
||||
.block_loop:
|
||||
test r15, r15
|
||||
jz .finish
|
||||
|
||||
mov rdi, r12
|
||||
mov rsi, r13
|
||||
mov rdx, rbx
|
||||
call aes256_encrypt_block_i
|
||||
|
||||
mov rdi, r13
|
||||
call ctr_inc_i
|
||||
|
||||
; n = min(16, len)
|
||||
mov rax, 16
|
||||
cmp r15, rax
|
||||
cmovb rax, r15
|
||||
|
||||
xor rcx, rcx
|
||||
.xor_loop:
|
||||
mov dl, [rbx + rcx]
|
||||
xor [r14 + rcx], dl
|
||||
inc rcx
|
||||
cmp rcx, rax
|
||||
jb .xor_loop
|
||||
|
||||
add r14, rax
|
||||
sub r15, rax
|
||||
jmp .block_loop
|
||||
|
||||
.finish:
|
||||
; effacement du dernier bloc de flot
|
||||
xor rax, rax
|
||||
mov [rbx + 0], rax
|
||||
mov [rbx + 8], rax
|
||||
|
||||
add rsp, 16
|
||||
pop r15
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
@@ -0,0 +1,140 @@
|
||||
; =============================================================================
|
||||
; const_time.asm -- primitives a temps d'execution constant.
|
||||
;
|
||||
; Contrainte projet : aucune comparaison de cle ou de MAC ne doit sortir tot.
|
||||
; Toutes les fonctions de ce fichier ont un flot de controle qui ne depend que
|
||||
; de la LONGUEUR des donnees, jamais de leur VALEUR. Concretement : pas un seul
|
||||
; saut conditionnel dont la condition derive d'un octet secret.
|
||||
;
|
||||
; API publique :
|
||||
; uint32_t vc_ct_memcmp (const void *a, const void *b, size_t len);
|
||||
; uint64_t vc_ct_mask_eq_u32(uint32_t a, uint32_t b);
|
||||
; uint64_t vc_ct_mask_lt_u32(uint32_t a, uint32_t b);
|
||||
; void vc_ct_cmov (void *dst, const void *src, size_t len,
|
||||
; uint64_t mask);
|
||||
; void vc_ct_memzero (void *p, size_t len);
|
||||
;
|
||||
; Convention des masques : 0xFFFFFFFFFFFFFFFF pour vrai, 0 pour faux. Un masque
|
||||
; se combine par and/or/xor sans jamais brancher.
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : la technique est integralement portable (Thumb-2 a
|
||||
; sbc, rsb et les memes drapeaux). Sont x86-64-specifiques :
|
||||
; - l'idiome sbb reg, reg pour materialiser CF en masque (equivalent
|
||||
; Thumb-2 : sbc r, r, r) ;
|
||||
; - rep stosb.
|
||||
; Attention au portage : sur Cortex-M il faudra verifier que le compilateur ne
|
||||
; reintroduit pas de branche, et que vc_ct_memzero ne soit pas remplace par un
|
||||
; memset optimisable. Le fait de l'ecrire en assembleur est precisement la
|
||||
; garantie recherchee ici -- un memset C peut etre supprime par le compilateur
|
||||
; sur un tampon mort, pas ce code.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
section .text
|
||||
|
||||
global vc_ct_memcmp_i
|
||||
global vc_ct_memzero_i
|
||||
global vc_ct_cmov_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; uint32_t vc_ct_memcmp(const void *a, const void *b, size_t len)
|
||||
; Retourne 0 si les zones sont identiques, 1 sinon.
|
||||
; Les len octets sont TOUJOURS lus, quelle que soit la position du premier
|
||||
; ecart : l'accumulateur agrege les differences par ou, sans sortie anticipee.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ct_memcmp
|
||||
VC_ARGS ; rdi = a, rsi = b, rdx = len
|
||||
call vc_ct_memcmp_i
|
||||
VC_RET
|
||||
|
||||
vc_ct_memcmp_i:
|
||||
xor eax, eax ; accumulateur de differences
|
||||
xor ecx, ecx
|
||||
test rdx, rdx
|
||||
jz .normalize ; longueur nulle : pas de secret implique
|
||||
|
||||
.loop:
|
||||
mov r8b, [rdi + rcx]
|
||||
xor r8b, [rsi + rcx]
|
||||
or al, r8b
|
||||
inc rcx
|
||||
cmp rcx, rdx ; borne = longueur, pas une valeur secrete
|
||||
jb .loop
|
||||
|
||||
.normalize:
|
||||
; al != 0 -> 1 ; al == 0 -> 0, sans branchement
|
||||
movzx eax, al
|
||||
neg eax ; CF = 1 si eax etait non nul
|
||||
sbb eax, eax ; 0xffffffff si different, 0 si egal
|
||||
and eax, 1
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; uint64_t vc_ct_mask_eq_u32(uint32_t a, uint32_t b)
|
||||
; Tout-a-un si a == b, zero sinon.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ct_mask_eq_u32
|
||||
VC_ARGS ; edi = a, esi = b
|
||||
mov eax, edi
|
||||
xor eax, esi ; 0 si et seulement si egaux
|
||||
neg eax ; CF = 1 si non nul
|
||||
sbb rax, rax ; -1 si different, 0 si egal
|
||||
not rax ; -1 si egal, 0 si different
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; uint64_t vc_ct_mask_lt_u32(uint32_t a, uint32_t b)
|
||||
; Tout-a-un si a < b (non signe), zero sinon.
|
||||
; Utilise par le gating temporel : compare l'instant d'arrivee a l'Heure
|
||||
; Cible sans produire de branche exploitable au timing.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ct_mask_lt_u32
|
||||
VC_ARGS ; edi = a, esi = b
|
||||
cmp edi, esi ; CF = 1 si a < b
|
||||
sbb rax, rax ; -1 si a < b, 0 sinon
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_ct_cmov(void *dst, const void *src, size_t len, uint64_t mask)
|
||||
; dst <- src si mask est tout-a-un, dst inchange si mask est nul.
|
||||
; Les deux zones sont lues et dst est TOUJOURS reecrit : la trace d'acces
|
||||
; memoire est la meme dans les deux cas.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ct_cmov
|
||||
VC_ARGS ; rdi = dst, rsi = src, rdx = len, rcx = mask
|
||||
call vc_ct_cmov_i
|
||||
VC_RET
|
||||
|
||||
vc_ct_cmov_i:
|
||||
test rdx, rdx
|
||||
jz .done
|
||||
xor r8, r8
|
||||
.loop:
|
||||
movzx r9d, byte [rdi + r8] ; ancien
|
||||
movzx r10d, byte [rsi + r8] ; nouveau
|
||||
xor r10d, r9d
|
||||
and r10, rcx ; masque applique a la difference
|
||||
xor r10d, r9d ; = mask ? nouveau : ancien
|
||||
mov [rdi + r8], r10b
|
||||
inc r8
|
||||
cmp r8, rdx
|
||||
jb .loop
|
||||
.done:
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_ct_memzero(void *p, size_t len)
|
||||
; Effacement qui ne peut pas etre elimine par un optimiseur, contrairement a
|
||||
; un memset C sur un tampon en fin de vie.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ct_memzero
|
||||
VC_ARGS ; rdi = p, rsi = len
|
||||
call vc_ct_memzero_i
|
||||
VC_RET
|
||||
|
||||
vc_ct_memzero_i:
|
||||
mov rcx, rsi
|
||||
xor eax, eax
|
||||
rep stosb
|
||||
ret
|
||||
@@ -0,0 +1,230 @@
|
||||
; =============================================================================
|
||||
; csprng.asm -- generateur pseudo-aleatoire cryptographique maison, bati sur le
|
||||
; SHA-256 du projet. Aucune dependance externe (contrainte projet).
|
||||
;
|
||||
; VERCORS en a besoin pour :
|
||||
; - le bourrage aleatoire des trames a taille fixe (64 octets) : le prompt
|
||||
; exige explicitement des octets de bruit, pas des zeros ;
|
||||
; - la generation isolee du Grain de Sel Temporel hebdomadaire.
|
||||
;
|
||||
; CONSTRUCTION (voir docs/adr/0004) -- DRBG a base de hachage, dans l'esprit de
|
||||
; Hash_DRBG (NIST SP 800-90A) mais volontairement simplifie :
|
||||
;
|
||||
; seed(graine) V <- SHA256(graine) ; C <- 0
|
||||
; bytes(n) pour chaque bloc de 32 octets :
|
||||
; sortie <- SHA256(V || BE64(C))
|
||||
; C <- C + 1
|
||||
; puis, une fois la demande servie :
|
||||
; V <- SHA256(0x01 || V)
|
||||
;
|
||||
; Le rafraichissement final de V donne la resistance au retour en arriere : la
|
||||
; compromission de l'etat apres coup ne permet pas de recalculer les octets
|
||||
; deja emis, ce qui protege le bourrage des trames deja transmises.
|
||||
;
|
||||
; CE QUE CE MODULE NE FAIT PAS : il ne fabrique pas d'entropie. La graine doit
|
||||
; venir de l'exterieur. Sur x86-64 le harnais de test la fournit ; sur STM32U5
|
||||
; ce sera le TRNG materiel. C'est la seule difference de fond au portage, et
|
||||
; elle est isolee derriere vc_csprng_seed.
|
||||
;
|
||||
; API publique :
|
||||
; void vc_csprng_seed (vc_csprng_ctx *ctx, const void *seed, size_t len);
|
||||
; void vc_csprng_reseed(vc_csprng_ctx *ctx, const void *seed, size_t len);
|
||||
; void vc_csprng_bytes (vc_csprng_ctx *ctx, void *out, size_t len);
|
||||
;
|
||||
; Disposition de vc_csprng_ctx (48 octets, voir include/vercors.h) :
|
||||
; +0 uint8_t V[32]
|
||||
; +32 uint64_t C compteur de blocs
|
||||
; +40 uint64_t seeded 0 = non initialise
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : entierement portable, la seule instruction
|
||||
; x86-64-specifique etant bswap (rev en Thumb-2) et rep movsb.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
%define PRNG_V 0
|
||||
%define PRNG_C 32
|
||||
%define PRNG_SEEDED 40
|
||||
%define PRNG_SIZE 48
|
||||
|
||||
extern vc_sha256_i
|
||||
extern sha256_init_i
|
||||
extern sha256_update_i
|
||||
extern sha256_final_i
|
||||
|
||||
section .text
|
||||
|
||||
global vc_csprng_seed_i
|
||||
global vc_csprng_bytes_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; vc_csprng_seed_i -- interne. rdi = ctx, rsi = graine, rdx = longueur.
|
||||
; V <- SHA256(graine), C <- 0.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_csprng_seed_i:
|
||||
push rbx
|
||||
mov rbx, rdi
|
||||
|
||||
mov rdi, rsi ; data = graine
|
||||
mov rsi, rdx ; len
|
||||
mov rdx, rbx ; out = V
|
||||
call vc_sha256_i
|
||||
|
||||
mov qword [rbx + PRNG_C], 0
|
||||
mov qword [rbx + PRNG_SEEDED], 1
|
||||
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; vc_csprng_reseed_i -- interne. rdi = ctx, rsi = graine, rdx = longueur.
|
||||
; V <- SHA256(V || graine). Melange la nouvelle entropie sans jeter
|
||||
; l'ancienne : un reseed avec une source degradee ne peut pas affaiblir
|
||||
; l'etat courant.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_csprng_reseed_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
sub rsp, 128 ; contexte SHA-256 (112) sur la pile
|
||||
|
||||
mov rbx, rdi ; ctx PRNG
|
||||
mov r12, rsi ; graine
|
||||
mov r13, rdx ; longueur
|
||||
mov r14, rsp ; contexte SHA
|
||||
|
||||
mov rdi, r14
|
||||
call sha256_init_i
|
||||
mov rdi, r14
|
||||
lea rsi, [rbx + PRNG_V]
|
||||
mov rdx, 32
|
||||
call sha256_update_i
|
||||
mov rdi, r14
|
||||
mov rsi, r12
|
||||
mov rdx, r13
|
||||
call sha256_update_i
|
||||
mov rdi, r14
|
||||
lea rsi, [rbx + PRNG_V]
|
||||
call sha256_final_i
|
||||
|
||||
mov qword [rbx + PRNG_SEEDED], 1
|
||||
|
||||
; effacement du contexte SHA
|
||||
mov rdi, r14
|
||||
mov rcx, 14
|
||||
xor eax, eax
|
||||
rep stosq
|
||||
|
||||
add rsp, 128
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; vc_csprng_bytes_i -- interne. rdi = ctx, rsi = sortie, rdx = longueur.
|
||||
;
|
||||
; Cadre de pile (r14) :
|
||||
; [r14 + 0 .. 39] bloc d'entree du hachage : V (32) || BE64(C) (8)
|
||||
; [r14 + 48 .. 79] bloc de sortie du hachage
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_csprng_bytes_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
sub rsp, 80
|
||||
|
||||
mov rbx, rdi ; ctx
|
||||
mov r12, rsi ; sortie
|
||||
mov r13, rdx ; octets restants
|
||||
mov r14, rsp
|
||||
|
||||
.block_loop:
|
||||
test r13, r13
|
||||
jz .refresh
|
||||
|
||||
; --- entree = V || BE64(C)
|
||||
mov rax, [rbx + PRNG_V + 0]
|
||||
mov [r14 + 0], rax
|
||||
mov rax, [rbx + PRNG_V + 8]
|
||||
mov [r14 + 8], rax
|
||||
mov rax, [rbx + PRNG_V + 16]
|
||||
mov [r14 + 16], rax
|
||||
mov rax, [rbx + PRNG_V + 24]
|
||||
mov [r14 + 24], rax
|
||||
mov rax, [rbx + PRNG_C]
|
||||
bswap rax
|
||||
mov [r14 + 32], rax
|
||||
|
||||
mov rdi, r14
|
||||
mov rsi, 40
|
||||
lea rdx, [r14 + 48]
|
||||
call vc_sha256_i
|
||||
|
||||
inc qword [rbx + PRNG_C]
|
||||
|
||||
; --- n = min(32, restant)
|
||||
mov rax, 32
|
||||
cmp r13, rax
|
||||
cmovb rax, r13
|
||||
|
||||
lea rsi, [r14 + 48]
|
||||
mov rdi, r12
|
||||
mov rcx, rax
|
||||
add r12, rax
|
||||
sub r13, rax
|
||||
rep movsb
|
||||
|
||||
jmp .block_loop
|
||||
|
||||
.refresh:
|
||||
; --- V <- SHA256(0x01 || V) : resistance au retour en arriere
|
||||
mov byte [r14 + 0], 0x01
|
||||
mov rax, [rbx + PRNG_V + 0]
|
||||
mov [r14 + 1], rax
|
||||
mov rax, [rbx + PRNG_V + 8]
|
||||
mov [r14 + 9], rax
|
||||
mov rax, [rbx + PRNG_V + 16]
|
||||
mov [r14 + 17], rax
|
||||
mov rax, [rbx + PRNG_V + 24]
|
||||
mov [r14 + 25], rax
|
||||
|
||||
mov rdi, r14
|
||||
mov rsi, 33
|
||||
lea rdx, [rbx + PRNG_V]
|
||||
call vc_sha256_i
|
||||
|
||||
; --- effacement du cadre (il contient V et du flot deja emis)
|
||||
mov rdi, r14
|
||||
mov rcx, 10 ; 80 octets
|
||||
xor eax, eax
|
||||
rep stosq
|
||||
|
||||
add rsp, 80
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; Enveloppes publiques
|
||||
; =============================================================================
|
||||
|
||||
VC_FUNC vc_csprng_seed
|
||||
VC_ARGS ; rdi = ctx, rsi = seed, rdx = len
|
||||
call vc_csprng_seed_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_csprng_reseed
|
||||
VC_ARGS ; rdi = ctx, rsi = seed, rdx = len
|
||||
call vc_csprng_reseed_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_csprng_bytes
|
||||
VC_ARGS ; rdi = ctx, rsi = out, rdx = len
|
||||
call vc_csprng_bytes_i
|
||||
VC_RET
|
||||
@@ -0,0 +1,56 @@
|
||||
; =============================================================================
|
||||
; factory_key.asm -- Cle Maitresse d'Usine (K_M).
|
||||
;
|
||||
; #############################################################
|
||||
; ## ##
|
||||
; ## NE PAS UTILISER EN PRODUCTION. ##
|
||||
; ## La valeur ci-dessous est un PLACEHOLDER DE TEST. ##
|
||||
; ## Elle est publique : elle vit dans un depot, en clair, ##
|
||||
; ## dans un fichier versionne. Tout boitier provisionne ##
|
||||
; ## avec cette cle est dechiffrable par quiconque lit ce ##
|
||||
; ## fichier. ##
|
||||
; ## ##
|
||||
; #############################################################
|
||||
;
|
||||
; K_M est un secret de PROVISIONING, pas un secret derive du protocole. Il sert
|
||||
; a deux choses, et c'est le meme secret dans les deux cas :
|
||||
; - [1] derivation du Grain de Sel Temporel hebdomadaire ;
|
||||
; - [6] Cold Start : cle de repli permettant une resynchronisation apres
|
||||
; perte d'etat.
|
||||
;
|
||||
; TODO PORTAGE STM32U5 -- ce fichier disparait.
|
||||
; Sur cible, K_M vivra dans l'element securise STSAFE-A110, pas en memoire du
|
||||
; microcontroleur. Consequences a traiter au portage :
|
||||
; - vc_factory_key ne retournera plus un pointeur vers de la ROM : les octets
|
||||
; de la cle ne doivent jamais transiter par la RAM du STM32U5 ;
|
||||
; - il faudra donc une API par operation (derivation, deverrouillage) plutot
|
||||
; que par exposition de la cle, et le STSAFE fera le calcul lui-meme ;
|
||||
; - le prototype x86-64 conserve la forme "pointeur" uniquement parce qu'il
|
||||
; n'a pas d'element securise. C'est la difference structurante entre ce
|
||||
; prototype et la cible, pas un simple remplacement de constante.
|
||||
;
|
||||
; Statut de la conception : HYPOTHESE PROVISOIRE, voir docs/adr/0010.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
SECT_RODATA
|
||||
|
||||
align 32
|
||||
; "PLACEHOLDER-NE-PAS-UTILISER-EN-PROD" en ASCII, complete a 32 octets. Le
|
||||
; contenu est volontairement lisible : un vidage memoire ou un dump flash doit
|
||||
; crier qu'on est en configuration de test, pas ressembler a une vraie cle.
|
||||
VC_FACTORY_KEY_PLACEHOLDER:
|
||||
db "PLACEHOLDER-NE-PAS-UTILISER-PROD" ; exactement 32 octets
|
||||
|
||||
section .text
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; const uint8_t *vc_factory_key(void)
|
||||
; Retourne un pointeur vers les 32 octets de K_M.
|
||||
; Sans argument : ni VC_ARGS ni VC_RET (qui depileraient un cadre jamais
|
||||
; empile sous ABI Microsoft).
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_factory_key
|
||||
lea rax, [VC_FACTORY_KEY_PLACEHOLDER]
|
||||
ret
|
||||
@@ -0,0 +1,472 @@
|
||||
; =============================================================================
|
||||
; sha256.asm -- SHA-256 (FIPS 180-4) en assembleur x86-64 pur, sans dependance.
|
||||
;
|
||||
; VERCORS utilise SHA-256 pour deriver l'Heure Cible a partir du Grain de Sel
|
||||
; Temporel. Aucune bibliotheque externe n'est utilisee (contrainte projet).
|
||||
;
|
||||
; API publique (arguments canoniques rdi, rsi, rdx apres traduction VC_ARGS) :
|
||||
; void vc_sha256_init (vc_sha256_ctx *ctx);
|
||||
; void vc_sha256_update(vc_sha256_ctx *ctx, const void *data, size_t len);
|
||||
; void vc_sha256_final (vc_sha256_ctx *ctx, uint8_t out[32]);
|
||||
; void vc_sha256 (const void *data, size_t len, uint8_t out[32]);
|
||||
;
|
||||
; Chaque fonction publique est une enveloppe mince autour d'un coeur interne
|
||||
; (sha256_*_i) qui suit une convention privee purement System V. Cela evite de
|
||||
; devoir respecter l'ABI Microsoft (shadow space, registres a preserver) sur
|
||||
; les appels internes.
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : la logique (planning de message, rondes, constantes)
|
||||
; est portable telle quelle. Sont x86-64-specifiques et a reecrire :
|
||||
; - l'allocation de registres 32 bits (r8d..r15d pour a..h ; en Thumb-2 il
|
||||
; faudra spiller une partie de l'etat sur la pile) ;
|
||||
; - bswap (equivalent Thumb-2 : rev) ;
|
||||
; - rep movsb / rep stosb pour les copies et mises a zero ;
|
||||
; - le tableau W de 256 octets alloue sur la pile, a verifier vis-a-vis de la
|
||||
; taille de pile des taches sur cible embarquee.
|
||||
; Aucune extension SHA-NI n'est utilisee : implementation scalaire, choisie
|
||||
; volontairement pour rester alignee sur ce que fera le Cortex-M33.
|
||||
;
|
||||
; Disposition de vc_sha256_ctx (112 octets, voir include/vercors.h) :
|
||||
; +0 uint32_t state[8]
|
||||
; +32 uint64_t bitlen longueur du message en bits
|
||||
; +40 uint64_t buflen octets en attente dans buf, 0..63
|
||||
; +48 uint8_t buf[64]
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
%define CTX_STATE 0
|
||||
%define CTX_BITLEN 32
|
||||
%define CTX_BUFLEN 40
|
||||
%define CTX_BUF 48
|
||||
%define CTX_SIZE 112
|
||||
|
||||
; =============================================================================
|
||||
SECT_RODATA
|
||||
|
||||
align 64
|
||||
K256:
|
||||
dd 0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5
|
||||
dd 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5
|
||||
dd 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3
|
||||
dd 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174
|
||||
dd 0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc
|
||||
dd 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da
|
||||
dd 0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7
|
||||
dd 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967
|
||||
dd 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13
|
||||
dd 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85
|
||||
dd 0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3
|
||||
dd 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070
|
||||
dd 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5
|
||||
dd 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3
|
||||
dd 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208
|
||||
dd 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2
|
||||
|
||||
align 32
|
||||
H256_INIT:
|
||||
dd 0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a
|
||||
dd 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19
|
||||
|
||||
; =============================================================================
|
||||
section .text
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; Une ronde de compression.
|
||||
; L'etat courant est designe par les macros RA..RH, renommees a chaque ronde
|
||||
; par ROTATE_STATE : cela supprime les 8 mov de decalage par ronde.
|
||||
; Temporaires : eax, ebx, ecx, edx. Le planning W est en [rbp + 4*i].
|
||||
; -----------------------------------------------------------------------------
|
||||
%macro SHA256_ROUND 1
|
||||
; S1 = ror(e,6) ^ ror(e,11) ^ ror(e,25)
|
||||
mov eax, RE
|
||||
mov ebx, RE
|
||||
ror eax, 6
|
||||
ror ebx, 11
|
||||
xor eax, ebx
|
||||
mov ebx, RE
|
||||
ror ebx, 25
|
||||
xor eax, ebx
|
||||
; ch = (e & f) ^ (~e & g)
|
||||
mov ebx, RE
|
||||
and ebx, RF
|
||||
mov ecx, RE
|
||||
not ecx
|
||||
and ecx, RG
|
||||
xor ebx, ecx
|
||||
; T1 = h + S1 + ch + W[i] + K[i]
|
||||
add eax, ebx
|
||||
add eax, RH
|
||||
add eax, [rbp + 4*%1]
|
||||
add eax, [K256 + 4*%1]
|
||||
; S0 = ror(a,2) ^ ror(a,13) ^ ror(a,22)
|
||||
mov ebx, RA
|
||||
mov ecx, RA
|
||||
ror ebx, 2
|
||||
ror ecx, 13
|
||||
xor ebx, ecx
|
||||
mov ecx, RA
|
||||
ror ecx, 22
|
||||
xor ebx, ecx
|
||||
; maj = (a & b) ^ (a & c) ^ (b & c)
|
||||
mov ecx, RA
|
||||
and ecx, RB
|
||||
mov edx, RA
|
||||
and edx, RC
|
||||
xor ecx, edx
|
||||
mov edx, RB
|
||||
and edx, RC
|
||||
xor ecx, edx
|
||||
add ebx, ecx ; T2 = S0 + maj
|
||||
add RD, eax ; e' = d + T1
|
||||
add ebx, eax
|
||||
mov RH, ebx ; a' = T1 + T2
|
||||
%endmacro
|
||||
|
||||
; Renommage circulaire : (a,b,c,d,e,f,g,h) <- (h,a,b,c,d,e,f,g)
|
||||
%macro ROTATE_STATE 0
|
||||
%xdefine RTMP RH
|
||||
%xdefine RH RG
|
||||
%xdefine RG RF
|
||||
%xdefine RF RE
|
||||
%xdefine RE RD
|
||||
%xdefine RD RC
|
||||
%xdefine RC RB
|
||||
%xdefine RB RA
|
||||
%xdefine RA RTMP
|
||||
%endmacro
|
||||
|
||||
; W[i] = W[i-16] + s0(W[i-15]) + W[i-7] + s1(W[i-2])
|
||||
%macro SHA256_EXPAND 1
|
||||
mov eax, [rbp + 4*(%1-15)]
|
||||
mov ebx, eax
|
||||
mov ecx, eax
|
||||
ror ebx, 7
|
||||
ror ecx, 18
|
||||
shr eax, 3
|
||||
xor ebx, ecx
|
||||
xor eax, ebx ; s0
|
||||
mov ebx, [rbp + 4*(%1-2)]
|
||||
mov ecx, ebx
|
||||
mov edx, ebx
|
||||
ror ecx, 17
|
||||
ror edx, 19
|
||||
shr ebx, 10
|
||||
xor ecx, edx
|
||||
xor ebx, ecx ; s1
|
||||
add eax, ebx
|
||||
add eax, [rbp + 4*(%1-16)]
|
||||
add eax, [rbp + 4*(%1-7)]
|
||||
mov [rbp + 4*%1], eax
|
||||
%endmacro
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; sha256_compress -- interne.
|
||||
; rdi = etat (8 dwords), rsi = bloc de 64 octets.
|
||||
; Preserve rdi, rsi, rbx, rbp, r12-r15. Clobber rax, rcx, rdx, r8-r11.
|
||||
; -----------------------------------------------------------------------------
|
||||
sha256_compress:
|
||||
push rbx
|
||||
push rbp
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
push r15
|
||||
sub rsp, 264 ; W[64] = 256 octets, +8 pour l'alignement
|
||||
mov rbp, rsp
|
||||
|
||||
; --- W[0..15] : lecture big-endian du bloc
|
||||
%assign wi 0
|
||||
%rep 16
|
||||
mov eax, [rsi + 4*wi]
|
||||
bswap eax
|
||||
mov [rbp + 4*wi], eax
|
||||
%assign wi wi+1
|
||||
%endrep
|
||||
|
||||
; --- W[16..63] : expansion
|
||||
%assign wi 16
|
||||
%rep 48
|
||||
SHA256_EXPAND wi
|
||||
%assign wi wi+1
|
||||
%endrep
|
||||
|
||||
; --- etat de travail
|
||||
%xdefine RA r8d
|
||||
%xdefine RB r9d
|
||||
%xdefine RC r10d
|
||||
%xdefine RD r11d
|
||||
%xdefine RE r12d
|
||||
%xdefine RF r13d
|
||||
%xdefine RG r14d
|
||||
%xdefine RH r15d
|
||||
|
||||
mov RA, [rdi + 0]
|
||||
mov RB, [rdi + 4]
|
||||
mov RC, [rdi + 8]
|
||||
mov RD, [rdi + 12]
|
||||
mov RE, [rdi + 16]
|
||||
mov RF, [rdi + 20]
|
||||
mov RG, [rdi + 24]
|
||||
mov RH, [rdi + 28]
|
||||
|
||||
; --- 64 rondes. 64 rotations = 8 tours complets : les %xdefine reviennent
|
||||
; exactement a leur affectation initiale, donc r8d..r15d contiennent
|
||||
; bien a..h dans l'ordre au sortir de la boucle.
|
||||
%assign wi 0
|
||||
%rep 64
|
||||
SHA256_ROUND wi
|
||||
ROTATE_STATE
|
||||
%assign wi wi+1
|
||||
%endrep
|
||||
|
||||
add [rdi + 0], r8d
|
||||
add [rdi + 4], r9d
|
||||
add [rdi + 8], r10d
|
||||
add [rdi + 12], r11d
|
||||
add [rdi + 16], r12d
|
||||
add [rdi + 20], r13d
|
||||
add [rdi + 24], r14d
|
||||
add [rdi + 28], r15d
|
||||
|
||||
add rsp, 264
|
||||
pop r15
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbp
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; Les symboles *_i sont exportes non pas pour du code C, mais pour que les
|
||||
; autres modules ASM du projet (csprng.asm, vercors_protocol.asm) puissent les
|
||||
; appeler avec la convention privee System V, sans avoir a respecter l'ABI
|
||||
; Microsoft (shadow space) sur des appels purement internes.
|
||||
; -----------------------------------------------------------------------------
|
||||
global sha256_init_i
|
||||
global sha256_update_i
|
||||
global sha256_final_i
|
||||
global vc_sha256_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; sha256_init_i -- interne. rdi = ctx.
|
||||
; -----------------------------------------------------------------------------
|
||||
sha256_init_i:
|
||||
lea rax, [H256_INIT]
|
||||
mov rcx, [rax + 0]
|
||||
mov [rdi + CTX_STATE + 0], rcx
|
||||
mov rcx, [rax + 8]
|
||||
mov [rdi + CTX_STATE + 8], rcx
|
||||
mov rcx, [rax + 16]
|
||||
mov [rdi + CTX_STATE + 16], rcx
|
||||
mov rcx, [rax + 24]
|
||||
mov [rdi + CTX_STATE + 24], rcx
|
||||
mov qword [rdi + CTX_BITLEN], 0
|
||||
mov qword [rdi + CTX_BUFLEN], 0
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; sha256_update_i -- interne. rdi = ctx, rsi = data, rdx = len.
|
||||
; Clobber rax, rcx, rdx, rsi, rdi, rbx, r8-r15 (les callee-saved utilises
|
||||
; sont sauves ici meme).
|
||||
; -----------------------------------------------------------------------------
|
||||
sha256_update_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
|
||||
test rdx, rdx
|
||||
jz .done
|
||||
|
||||
mov r13, rdi ; ctx
|
||||
mov r12, rsi ; data
|
||||
mov rbx, rdx ; octets restants
|
||||
|
||||
mov rax, rbx
|
||||
shl rax, 3
|
||||
add [r13 + CTX_BITLEN], rax
|
||||
|
||||
mov rcx, [r13 + CTX_BUFLEN]
|
||||
test rcx, rcx
|
||||
jz .main_loop
|
||||
|
||||
; --- des octets sont deja en attente : completer le buffer
|
||||
mov rax, 64
|
||||
sub rax, rcx ; place libre
|
||||
cmp rbx, rax
|
||||
jae .fill_full
|
||||
|
||||
; pas de quoi remplir un bloc : on empile et on sort
|
||||
lea rdi, [r13 + rcx + CTX_BUF]
|
||||
mov rsi, r12
|
||||
mov rcx, rbx
|
||||
rep movsb
|
||||
add [r13 + CTX_BUFLEN], rbx
|
||||
jmp .done
|
||||
|
||||
.fill_full:
|
||||
lea rdi, [r13 + rcx + CTX_BUF]
|
||||
mov rsi, r12
|
||||
mov rcx, rax
|
||||
add r12, rax
|
||||
sub rbx, rax
|
||||
rep movsb
|
||||
mov qword [r13 + CTX_BUFLEN], 0
|
||||
mov rdi, r13
|
||||
lea rsi, [r13 + CTX_BUF]
|
||||
call sha256_compress
|
||||
|
||||
.main_loop:
|
||||
cmp rbx, 64
|
||||
jb .tail
|
||||
mov rdi, r13
|
||||
mov rsi, r12
|
||||
call sha256_compress
|
||||
add r12, 64
|
||||
sub rbx, 64
|
||||
jmp .main_loop
|
||||
|
||||
.tail:
|
||||
test rbx, rbx
|
||||
jz .done
|
||||
lea rdi, [r13 + CTX_BUF]
|
||||
mov rsi, r12
|
||||
mov rcx, rbx
|
||||
rep movsb
|
||||
mov [r13 + CTX_BUFLEN], rbx
|
||||
|
||||
.done:
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; sha256_final_i -- interne. rdi = ctx, rsi = out[32].
|
||||
; -----------------------------------------------------------------------------
|
||||
sha256_final_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
|
||||
mov r13, rdi ; ctx
|
||||
mov r12, rsi ; out
|
||||
mov rbx, [r13 + CTX_BITLEN] ; a sauver : le padding ecrit dans le buffer
|
||||
|
||||
; --- octet de bourrage 0x80
|
||||
mov rcx, [r13 + CTX_BUFLEN]
|
||||
mov byte [r13 + rcx + CTX_BUF], 0x80
|
||||
inc rcx
|
||||
|
||||
; --- s'il ne reste pas 8 octets pour la longueur, fermer ce bloc d'abord
|
||||
cmp rcx, 56
|
||||
jbe .pad_tail
|
||||
|
||||
lea rdi, [r13 + rcx + CTX_BUF]
|
||||
mov rax, 64
|
||||
sub rax, rcx
|
||||
mov rcx, rax
|
||||
xor eax, eax
|
||||
rep stosb
|
||||
mov rdi, r13
|
||||
lea rsi, [r13 + CTX_BUF]
|
||||
call sha256_compress
|
||||
xor ecx, ecx
|
||||
|
||||
.pad_tail:
|
||||
; zeros de rcx jusqu'a l'offset 56
|
||||
lea rdi, [r13 + rcx + CTX_BUF]
|
||||
mov rax, 56
|
||||
sub rax, rcx
|
||||
mov rcx, rax
|
||||
xor eax, eax
|
||||
rep stosb
|
||||
|
||||
; --- longueur en bits, big-endian, sur les 8 derniers octets
|
||||
mov rax, rbx
|
||||
bswap rax
|
||||
mov [r13 + CTX_BUF + 56], rax
|
||||
|
||||
mov rdi, r13
|
||||
lea rsi, [r13 + CTX_BUF]
|
||||
call sha256_compress
|
||||
|
||||
; --- sortie big-endian
|
||||
%assign oi 0
|
||||
%rep 8
|
||||
mov eax, [r13 + CTX_STATE + 4*oi]
|
||||
bswap eax
|
||||
mov [r12 + 4*oi], eax
|
||||
%assign oi oi+1
|
||||
%endrep
|
||||
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; Enveloppes publiques
|
||||
; =============================================================================
|
||||
|
||||
VC_FUNC vc_sha256_init
|
||||
VC_ARGS ; rdi = ctx
|
||||
call sha256_init_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_sha256_update
|
||||
VC_ARGS ; rdi = ctx, rsi = data, rdx = len
|
||||
call sha256_update_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_sha256_final
|
||||
VC_ARGS ; rdi = ctx, rsi = out
|
||||
call sha256_final_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_sha256
|
||||
VC_ARGS ; rdi = data, rsi = len, rdx = out
|
||||
call vc_sha256_i
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; vc_sha256_i -- one-shot, convention interne.
|
||||
; rdi = data, rsi = len, rdx = out[32]
|
||||
; Le contexte vit sur la pile et est efface avant retour : il contient des
|
||||
; octets de message clair (ici, le Grain de Sel).
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_sha256_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
sub rsp, 128 ; >= CTX_SIZE (112)
|
||||
|
||||
mov r12, rdi
|
||||
mov r13, rsi
|
||||
mov r14, rdx
|
||||
mov rbx, rsp ; ctx
|
||||
|
||||
mov rdi, rbx
|
||||
call sha256_init_i
|
||||
mov rdi, rbx
|
||||
mov rsi, r12
|
||||
mov rdx, r13
|
||||
call sha256_update_i
|
||||
mov rdi, rbx
|
||||
mov rsi, r14
|
||||
call sha256_final_i
|
||||
|
||||
; effacement du contexte (112 octets = 14 qwords)
|
||||
mov rdi, rbx
|
||||
mov rcx, CTX_SIZE / 8
|
||||
xor eax, eax
|
||||
rep stosq
|
||||
|
||||
add rsp, 128
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
@@ -0,0 +1,568 @@
|
||||
; =============================================================================
|
||||
; vercors_keysched.asm -- points [1], [3], [5] et [6] du protocole VERCORS.
|
||||
;
|
||||
; Grain de Sel Temporel, Fenetre de Garde Dynamique, bascule de cle
|
||||
; steganographique, Cold Start.
|
||||
;
|
||||
; #############################################################################
|
||||
; ## HYPOTHESES PROVISOIRES -- A VALIDER AVANT TOUT DEPLOIEMENT REEL ##
|
||||
; ## ##
|
||||
; ## Le manifeste Gastinel Frame ne descend pas jusqu'a ce niveau de detail. ##
|
||||
; ## Les constructions de ce fichier reposent sur des hypotheses fournies ##
|
||||
; ## oralement et completees ici par des choix d'encodage. Chaque choix est ##
|
||||
; ## signale par le marqueur HYPOTHESE et documente dans docs/adr/0007 a ##
|
||||
; ## 0010. Aucun n'a valeur de specification figee. ##
|
||||
; #############################################################################
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : la logique est portable. Sont x86-64-specifiques et
|
||||
; signales sur place : div (Fenetre de Garde), bswap, xchg al/ah, rep movsb,
|
||||
; sbb/cmov pour l'arithmetique de masque.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
extern vc_sha256_i
|
||||
extern vc_csprng_bytes_i
|
||||
extern aes256_ctr_xor_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; [1] Grain de Sel -- constantes d'encodage
|
||||
;
|
||||
; HYPOTHESE : grain = SHA256( K_M(32) || semaine_ISO(uint16 BE) ||
|
||||
; compteur_anti_rejeu(uint32 BE) )
|
||||
;
|
||||
; Le numero de semaine ISO est encode sur 16 bits en big-endian, et le compteur
|
||||
; anti-rejeu sur 32 bits en big-endian, par coherence avec l'ordre reseau deja
|
||||
; retenu pour l'Heure Cible.
|
||||
;
|
||||
; POINT OUVERT SIGNALE : l'epoque d'origine des semaines n'est pas definie. Un
|
||||
; uint16 ne porte pas d'annee : "semaine 36" est ambigu sans point de depart.
|
||||
; Deux implementations qui ne partent pas de la meme origine deriveront des
|
||||
; grains differents et ne se parleront jamais. Voir docs/adr/0007.
|
||||
; -----------------------------------------------------------------------------
|
||||
%define GRAIN_INPUT_BYTES 38 ; 32 + 2 + 4
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; [3] Fenetre de Garde Dynamique -- constantes
|
||||
;
|
||||
; HYPOTHESE : elargissement LINEAIRE avec le temps ecoule depuis le dernier
|
||||
; paquet valide, PLAFONNE. Resserrement immediat des reception valide.
|
||||
;
|
||||
; demi_largeur(ecoule) = min( GUARD_MIN + ecoule * DRIFT_PPM / 1e6,
|
||||
; GUARD_MAX )
|
||||
;
|
||||
; La pente n'est pas arbitraire : elle suit la derive du quartz. Un LSE
|
||||
; d'horlogerie a 20 ppm derive de 20 us par seconde, soit environ 1,73 s par
|
||||
; jour. La fenetre s'ouvre donc exactement au rythme ou l'incertitude d'horloge
|
||||
; grandit, ni plus ni moins -- c'est ce qui evite d'ouvrir une fenetre d'attaque
|
||||
; plus large que necessaire.
|
||||
;
|
||||
; Le plafond de 30 s borne la croissance meme apres plusieurs jours de silence
|
||||
; radio : sans lui, un boitier oublie finirait par accepter n'importe quel
|
||||
; instant, ce qui annulerait le gating temporel. Avec 20 ppm, le plafond est
|
||||
; atteint apres environ 16 jours de silence -- au-dela, la resynchronisation
|
||||
; Cold Start [6] prend le relais.
|
||||
; -----------------------------------------------------------------------------
|
||||
%define GUARD_MIN_SECONDS 2 ; HYPOTHESE : demi-largeur au repos
|
||||
%define GUARD_MAX_SECONDS 30 ; plafond fourni, a valider
|
||||
%define GUARD_DRIFT_PPM 20 ; HYPOTHESE : derive du quartz LSE
|
||||
|
||||
; Disposition de vc_guard_ctx (16 octets)
|
||||
%define GUARD_LAST_VALID 0 ; uint32 instant du dernier paquet valide
|
||||
%define GUARD_OFFSET 4 ; int32 correction d'horloge appliquee
|
||||
%define GUARD_WIDTH 8 ; uint32 demi-largeur courante (cache)
|
||||
%define GUARD_FLAGS 12 ; uint32 bit 0 = deja synchronise
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; [5] Bascule de cle -- disposition de trame
|
||||
;
|
||||
; HYPOTHESE : la cle du jour suivant (32 octets) est chiffree avec la cle du
|
||||
; jour COURANT, puis logee dans la zone de bourrage. C'est un chainage de cles
|
||||
; (cle N+1 protegee par cle N), pas un envoi en clair.
|
||||
;
|
||||
; octet 0 : bit 7 = drapeau de bascule ; bits 0-6 = longueur utile L
|
||||
; octets 1..L : charge utile
|
||||
; sans bascule : octets L+1..63 = bruit CSPRNG
|
||||
; avec bascule : octets L+1..31 = bruit CSPRNG
|
||||
; octets 32..63 = cle N+1 chiffree sous la cle du jour
|
||||
;
|
||||
; Indifferenciabilite : le creneau de cle est du chiffre AES, donc uniforme,
|
||||
; donc indistinguable du bruit CSPRNG qui l'entoure. Et la trame entiere est
|
||||
; ensuite rechiffree par l'appelant sous la cle de trame : le drapeau lui-meme
|
||||
; n'est jamais observable sur l'air. La taille reste 64 octets dans tous les
|
||||
; cas, avec ou sans bascule -- c'est ce que le cas C du manifeste exige.
|
||||
;
|
||||
; DOMAINE DE COMPTEUR : le creneau de cle est chiffre avec un compteur dont
|
||||
; l'octet 0 vaut VC_CTR_DOMAIN_KEYWRAP (0x01), alors que les trames utilisent
|
||||
; VC_CTR_DOMAIN_FRAME (0x00). Sans cette separation, le meme flot de cle
|
||||
; servirait deux fois sous la meme cle du jour, ce qui revelerait le XOR des
|
||||
; deux clairs -- la faute mortelle du mode CTR.
|
||||
; -----------------------------------------------------------------------------
|
||||
%define FRAME_FLAG_KEYSW 0x80
|
||||
%define FRAME_LEN_MASK 0x7f
|
||||
%define FRAME_KEYSLOT_OFF 32
|
||||
%define FRAME_MAXPAYLOAD 63 ; sans bascule
|
||||
%define FRAME_KEYSW_MAXPAYLOAD 31 ; avec bascule
|
||||
|
||||
; Disposition de vc_frame_req (48 octets)
|
||||
%define REQ_RNG 0
|
||||
%define REQ_PAYLOAD 8
|
||||
%define REQ_LEN 16
|
||||
%define REQ_NEXTKEY 24 ; NULL = pas de bascule
|
||||
%define REQ_DAY_RK 32
|
||||
%define REQ_KEY_CTR 40
|
||||
|
||||
; Disposition de vc_frame_out (112 octets)
|
||||
%define OUT_PAYLOAD 0 ; 64 octets
|
||||
%define OUT_LEN 64
|
||||
%define OUT_HAS_KEY 72
|
||||
%define OUT_NEXTKEY 80 ; 32 octets
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; [6] Cold Start
|
||||
;
|
||||
; HYPOTHESE : la resynchronisation est declenchee localement, sans signalisation
|
||||
; dedie sur l'air. Deux causes, une seule consequence :
|
||||
; - aucun paquet valide depuis COLDSTART_TIMEOUT (le grain etant hebdomadaire,
|
||||
; un silence depassant la semaine signifie que le grain courant est perime
|
||||
; des deux cotes) ;
|
||||
; - demarrage sans etat de synchronisation (bit GUARD_FLAGS.0 a zero), cas du
|
||||
; reboot.
|
||||
; Dans les deux cas le boitier bascule temporairement sur K_M, le temps d'un
|
||||
; echange de resynchronisation, puis repasse sur la derivation normale.
|
||||
; -----------------------------------------------------------------------------
|
||||
%define COLDSTART_TIMEOUT 604800 ; 7 jours, aligne sur la periode du grain
|
||||
|
||||
; =============================================================================
|
||||
section .text
|
||||
|
||||
global vc_derive_grain_i
|
||||
global vc_guard_width_i
|
||||
global vc_frame_build_i
|
||||
global vc_frame_parse_i
|
||||
|
||||
; =============================================================================
|
||||
; [1] GRAIN DE SEL TEMPOREL
|
||||
; =============================================================================
|
||||
; void vc_derive_grain(const uint8_t km[32], uint32_t week_iso,
|
||||
; uint32_t replay_counter, uint8_t out[32])
|
||||
;
|
||||
; grain = SHA256( K_M || BE16(week_iso) || BE32(replay_counter) )
|
||||
;
|
||||
; Rien de ce calcul ne passe par la radio : emetteur et recepteur, partageant
|
||||
; K_M et s'accordant sur la semaine, obtiennent le meme grain chacun de leur
|
||||
; cote. C'est la propriete centrale du protocole -- le secret ne circule jamais.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_derive_grain_i:
|
||||
push rbx
|
||||
push r12
|
||||
sub rsp, 48 ; tampon de GRAIN_INPUT_BYTES octets
|
||||
|
||||
mov rbx, rsp
|
||||
mov r12, rcx ; out
|
||||
|
||||
; --- K_M
|
||||
mov rax, [rdi + 0]
|
||||
mov [rbx + 0], rax
|
||||
mov rax, [rdi + 8]
|
||||
mov [rbx + 8], rax
|
||||
mov rax, [rdi + 16]
|
||||
mov [rbx + 16], rax
|
||||
mov rax, [rdi + 24]
|
||||
mov [rbx + 24], rax
|
||||
|
||||
; --- semaine ISO, uint16 big-endian
|
||||
mov eax, esi
|
||||
xchg al, ah ; bswap 16 bits (pas de REX : eax/ah ok)
|
||||
mov [rbx + 32], ax
|
||||
|
||||
; --- compteur anti-rejeu, uint32 big-endian
|
||||
mov eax, edx
|
||||
bswap eax
|
||||
mov [rbx + 34], eax
|
||||
|
||||
mov rdi, rbx
|
||||
mov rsi, GRAIN_INPUT_BYTES
|
||||
mov rdx, r12
|
||||
call vc_sha256_i
|
||||
|
||||
; --- effacement du tampon : il contient K_M en clair
|
||||
xor eax, eax
|
||||
mov [rbx + 0], rax
|
||||
mov [rbx + 8], rax
|
||||
mov [rbx + 16], rax
|
||||
mov [rbx + 24], rax
|
||||
mov [rbx + 32], rax
|
||||
|
||||
add rsp, 48
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; [3] FENETRE DE GARDE DYNAMIQUE
|
||||
; =============================================================================
|
||||
; uint32_t vc_guard_width(uint32_t elapsed_sec)
|
||||
; demi-largeur = min(GUARD_MIN + elapsed * DRIFT_PPM / 1e6, GUARD_MAX)
|
||||
;
|
||||
; Le calcul se fait en 64 bits : elapsed * 20 deborderait un uint32 au-dela de
|
||||
; 6,8 ans d'ecoule, ce qui est court a l'echelle d'un boitier laisse en place.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_guard_width_i:
|
||||
mov eax, edi ; zero-extension vers rax
|
||||
imul rax, rax, GUARD_DRIFT_PPM
|
||||
xor edx, edx
|
||||
mov ecx, 1000000
|
||||
div rcx ; rax = elapsed * ppm / 1e6
|
||||
add rax, GUARD_MIN_SECONDS
|
||||
mov rcx, GUARD_MAX_SECONDS
|
||||
cmp rax, rcx
|
||||
cmova rax, rcx ; plafonnement
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_guard_init(vc_guard_ctx *g)
|
||||
; Etat non synchronise : le Cold Start sera exige au premier controle.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_guard_init
|
||||
VC_ARGS ; rdi = g
|
||||
mov dword [rdi + GUARD_LAST_VALID], 0
|
||||
mov dword [rdi + GUARD_OFFSET], 0
|
||||
mov dword [rdi + GUARD_WIDTH], GUARD_MIN_SECONDS
|
||||
mov dword [rdi + GUARD_FLAGS], 0
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_guard_on_valid(vc_guard_ctx *g, uint32_t local_sec, uint32_t ref_sec)
|
||||
; Paquet valide recu : resserrement de la fenetre a sa largeur minimale, et
|
||||
; recalage d'horloge.
|
||||
;
|
||||
; Le recalage est memorise comme un DECALAGE (ref - local) plutot qu'applique
|
||||
; a l'horloge : ecrire directement dans l'horloge locale ferait sauter le
|
||||
; temps en arriere, ce qui casserait toute autre temporisation en cours dans
|
||||
; le firmware. Le decalage est ajoute au moment des comparaisons, pas avant.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_guard_on_valid
|
||||
VC_ARGS ; rdi = g, esi = local_sec, edx = ref_sec
|
||||
mov [rdi + GUARD_LAST_VALID], esi
|
||||
mov eax, edx
|
||||
sub eax, esi ; decalage signe ref - local
|
||||
mov [rdi + GUARD_OFFSET], eax
|
||||
mov dword [rdi + GUARD_WIDTH], GUARD_MIN_SECONDS
|
||||
or dword [rdi + GUARD_FLAGS], 1
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; uint32_t vc_guard_width_now(vc_guard_ctx *g, uint32_t now_sec)
|
||||
; Demi-largeur courante, et mise a jour du cache dans le contexte.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_guard_width_now
|
||||
VC_ARGS ; rdi = g, esi = now_sec
|
||||
push rbx
|
||||
mov rbx, rdi
|
||||
|
||||
mov eax, esi
|
||||
sub eax, [rbx + GUARD_LAST_VALID]
|
||||
; Une horloge qui recule (now < dernier valide) donnerait un ecoule
|
||||
; gigantesque par bouclage non signe, donc une fenetre plafonnee : on borne
|
||||
; a zero, ce qui redonne la largeur minimale.
|
||||
mov ecx, eax
|
||||
sar ecx, 31 ; -1 si negatif
|
||||
not ecx
|
||||
and eax, ecx
|
||||
|
||||
mov edi, eax
|
||||
call vc_guard_width_i
|
||||
mov [rbx + GUARD_WIDTH], eax
|
||||
|
||||
pop rbx
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; uint64_t vc_gate_accept_window(uint32_t arrival_sec, uint32_t target_sec,
|
||||
; uint32_t width_sec)
|
||||
; Masque tout-a-un si la trame est recevable.
|
||||
;
|
||||
; Recevable <=> arrival >= target - width (avec saturation a zero)
|
||||
;
|
||||
; Seul le bord INFERIEUR est relache. La Fenetre de Garde existe pour tolerer
|
||||
; la derive d'horloge sur un paquet legitime arrive un peu tot ; elle n'a pas
|
||||
; a fermer le bord superieur, puisque le protocole prevoit explicitement que
|
||||
; le premier message utile arrive APRES l'Heure Cible [5]. Poser une borne
|
||||
; haute rejetterait ce message-la.
|
||||
;
|
||||
; Sans branchement : l'Heure Cible derive du Grain de Sel, c'est un secret.
|
||||
; Un saut conditionnel rendrait l'ecart mesurable et permettrait de localiser
|
||||
; l'Heure Cible par dichotomie en faisant varier l'instant d'emission.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_gate_accept_window
|
||||
VC_ARGS ; edi = arrival, esi = target, edx = width
|
||||
mov eax, esi
|
||||
sub eax, edx ; target - width
|
||||
sbb ecx, ecx ; -1 si depassement par le bas
|
||||
not ecx ; 0 si depassement, -1 sinon
|
||||
and eax, ecx ; saturation a zero
|
||||
cmp edi, eax ; CF = 1 si arrival < seuil
|
||||
sbb rax, rax ; -1 si trop tot
|
||||
not rax ; -1 si recevable
|
||||
VC_RET
|
||||
|
||||
; =============================================================================
|
||||
; [6] COLD START
|
||||
; =============================================================================
|
||||
; int vc_coldstart_needed(const vc_guard_ctx *g, uint32_t now_sec)
|
||||
; 1 si une resynchronisation sur K_M est requise, 0 sinon.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_coldstart_needed
|
||||
VC_ARGS ; rdi = g, esi = now_sec
|
||||
; --- jamais synchronise (reboot, premier demarrage) ?
|
||||
mov eax, [rdi + GUARD_FLAGS]
|
||||
and eax, 1
|
||||
xor eax, 1 ; 1 si le bit de synchro est absent
|
||||
mov ecx, eax
|
||||
|
||||
; --- silence trop long ?
|
||||
mov eax, esi
|
||||
sub eax, [rdi + GUARD_LAST_VALID]
|
||||
mov edx, eax
|
||||
sar edx, 31
|
||||
not edx
|
||||
and eax, edx ; borne a zero si l'horloge a recule
|
||||
cmp eax, COLDSTART_TIMEOUT
|
||||
setae al
|
||||
movzx eax, al
|
||||
|
||||
or eax, ecx
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_ctr_set_domain(uint8_t ctr[16], uint8_t domain)
|
||||
; Fixe l'octet de separation de domaine du compteur CTR.
|
||||
; Voir la note DOMAINE DE COMPTEUR en tete de fichier : c'est ce qui empeche
|
||||
; le creneau de cle et la trame de partager un flot de cle.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ctr_set_domain
|
||||
VC_ARGS ; rdi = ctr, esi = domain
|
||||
mov [rdi], sil
|
||||
VC_RET
|
||||
|
||||
; =============================================================================
|
||||
; [5] CONSTRUCTION ET LECTURE DE TRAME, AVEC BASCULE DE CLE
|
||||
; =============================================================================
|
||||
; int vc_frame_build(const vc_frame_req *req, uint8_t out[64])
|
||||
; 0 si construite, -1 si la charge utile ne tient pas.
|
||||
;
|
||||
; Passage par structure et non par arguments separes : la requete en compte
|
||||
; six, or le cinquieme et le sixieme passeraient par la pile sous ABI
|
||||
; Microsoft, a un decalage qui depend des registres empiles par VC_ARGS. La
|
||||
; structure supprime ce piege et rend la signature stable entre les ABI.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_frame_build_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
push r15
|
||||
sub rsp, 32 ; copie locale du compteur de creneau
|
||||
|
||||
mov r12, rdi ; req
|
||||
mov r13, rsi ; out
|
||||
mov r14, [r12 + REQ_LEN] ; longueur utile
|
||||
mov r15, [r12 + REQ_NEXTKEY] ; cle N+1, ou NULL
|
||||
|
||||
test r15, r15
|
||||
jz .no_switch
|
||||
|
||||
cmp r14, FRAME_KEYSW_MAXPAYLOAD
|
||||
ja .too_long
|
||||
mov al, r14b
|
||||
or al, FRAME_FLAG_KEYSW
|
||||
jmp .write_hdr
|
||||
|
||||
.no_switch:
|
||||
cmp r14, FRAME_MAXPAYLOAD
|
||||
ja .too_long
|
||||
mov al, r14b
|
||||
|
||||
.write_hdr:
|
||||
mov [r13], al
|
||||
|
||||
; --- charge utile
|
||||
test r14, r14
|
||||
jz .fill
|
||||
lea rdi, [r13 + 1]
|
||||
mov rsi, [r12 + REQ_PAYLOAD]
|
||||
mov rcx, r14
|
||||
rep movsb
|
||||
|
||||
.fill:
|
||||
; --- bruit CSPRNG sur la place restante
|
||||
mov rdi, [r12 + REQ_RNG]
|
||||
lea rsi, [r13 + r14 + 1]
|
||||
test r15, r15
|
||||
jz .fill_full
|
||||
mov rdx, FRAME_KEYSW_MAXPAYLOAD ; jusqu'a l'octet 31 inclus
|
||||
jmp .fill_go
|
||||
.fill_full:
|
||||
mov rdx, FRAME_MAXPAYLOAD
|
||||
.fill_go:
|
||||
sub rdx, r14
|
||||
test rdx, rdx
|
||||
jz .keyslot
|
||||
call vc_csprng_bytes_i
|
||||
|
||||
.keyslot:
|
||||
test r15, r15
|
||||
jz .ok
|
||||
|
||||
; --- cle N+1 dans le creneau
|
||||
mov rax, [r15 + 0]
|
||||
mov [r13 + FRAME_KEYSLOT_OFF + 0], rax
|
||||
mov rax, [r15 + 8]
|
||||
mov [r13 + FRAME_KEYSLOT_OFF + 8], rax
|
||||
mov rax, [r15 + 16]
|
||||
mov [r13 + FRAME_KEYSLOT_OFF + 16], rax
|
||||
mov rax, [r15 + 24]
|
||||
mov [r13 + FRAME_KEYSLOT_OFF + 24], rax
|
||||
|
||||
; --- compteur de creneau : copie locale, l'appelant garde le sien intact
|
||||
mov rbx, rsp
|
||||
mov rax, [r12 + REQ_KEY_CTR]
|
||||
mov rcx, [rax + 0]
|
||||
mov [rbx + 0], rcx
|
||||
mov rcx, [rax + 8]
|
||||
mov [rbx + 8], rcx
|
||||
|
||||
; --- chiffrement de la cle N+1 sous la cle du JOUR COURANT
|
||||
mov rdi, [r12 + REQ_DAY_RK]
|
||||
mov rsi, rbx
|
||||
lea rdx, [r13 + FRAME_KEYSLOT_OFF]
|
||||
mov rcx, 32
|
||||
call aes256_ctr_xor_i
|
||||
|
||||
.ok:
|
||||
xor eax, eax
|
||||
jmp .done
|
||||
.too_long:
|
||||
mov eax, -1
|
||||
.done:
|
||||
add rsp, 32
|
||||
pop r15
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; int vc_frame_parse(const uint8_t in[64], const vc_aes_rk *day_rk,
|
||||
; const uint8_t *key_ctr, vc_frame_out *out)
|
||||
; 0 si l'en-tete est coherent, -1 sinon.
|
||||
;
|
||||
; ATTENTION : ce n'est pas un controle d'integrite. Sous CTR, un attaquant
|
||||
; peut retourner des bits arbitraires du clair, y compris le drapeau de
|
||||
; bascule. L'absence de MAC reste le point ouvert de l'ADR 0003 -- et elle est
|
||||
; plus grave ici qu'ailleurs : sans authentification, un attaquant peut
|
||||
; corrompre le creneau de cle et provoquer une desynchronisation durable des
|
||||
; deux extremites.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_frame_parse_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
push r15
|
||||
sub rsp, 32
|
||||
|
||||
mov r12, rdi ; trame en clair
|
||||
mov r14, rsi ; cle du jour
|
||||
mov r15, rdx ; compteur de creneau
|
||||
mov r13, rcx ; sortie
|
||||
|
||||
movzx eax, byte [r12]
|
||||
mov ebx, eax
|
||||
and ebx, FRAME_LEN_MASK ; longueur utile
|
||||
shr eax, 7 ; drapeau de bascule, 0 ou 1
|
||||
mov [r13 + OUT_HAS_KEY], rax
|
||||
|
||||
test eax, eax
|
||||
jz .plain
|
||||
cmp ebx, FRAME_KEYSW_MAXPAYLOAD
|
||||
ja .bad
|
||||
jmp .copy
|
||||
.plain:
|
||||
cmp ebx, FRAME_MAXPAYLOAD
|
||||
ja .bad
|
||||
|
||||
.copy:
|
||||
mov [r13 + OUT_LEN], rbx
|
||||
test rbx, rbx
|
||||
jz .keyslot
|
||||
lea rdi, [r13 + OUT_PAYLOAD]
|
||||
lea rsi, [r12 + 1]
|
||||
mov rcx, rbx
|
||||
rep movsb
|
||||
|
||||
.keyslot:
|
||||
mov rax, [r13 + OUT_HAS_KEY]
|
||||
test rax, rax
|
||||
jz .ok
|
||||
|
||||
mov rax, [r12 + FRAME_KEYSLOT_OFF + 0]
|
||||
mov [r13 + OUT_NEXTKEY + 0], rax
|
||||
mov rax, [r12 + FRAME_KEYSLOT_OFF + 8]
|
||||
mov [r13 + OUT_NEXTKEY + 8], rax
|
||||
mov rax, [r12 + FRAME_KEYSLOT_OFF + 16]
|
||||
mov [r13 + OUT_NEXTKEY + 16], rax
|
||||
mov rax, [r12 + FRAME_KEYSLOT_OFF + 24]
|
||||
mov [r13 + OUT_NEXTKEY + 24], rax
|
||||
|
||||
mov rbx, rsp
|
||||
mov rax, [r15 + 0]
|
||||
mov [rbx + 0], rax
|
||||
mov rax, [r15 + 8]
|
||||
mov [rbx + 8], rax
|
||||
|
||||
mov rdi, r14
|
||||
mov rsi, rbx
|
||||
lea rdx, [r13 + OUT_NEXTKEY]
|
||||
mov rcx, 32
|
||||
call aes256_ctr_xor_i
|
||||
|
||||
.ok:
|
||||
xor eax, eax
|
||||
jmp .done
|
||||
.bad:
|
||||
mov eax, -1
|
||||
.done:
|
||||
add rsp, 32
|
||||
pop r15
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; Enveloppes publiques
|
||||
; =============================================================================
|
||||
|
||||
VC_FUNC vc_derive_grain
|
||||
VC_ARGS ; rdi=km, esi=week, edx=replay, rcx=out
|
||||
call vc_derive_grain_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_guard_width
|
||||
VC_ARGS ; edi = elapsed
|
||||
call vc_guard_width_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_frame_build
|
||||
VC_ARGS ; rdi = req, rsi = out
|
||||
call vc_frame_build_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_frame_parse
|
||||
VC_ARGS ; rdi=in, rsi=rk, rdx=key_ctr, rcx=out
|
||||
call vc_frame_parse_i
|
||||
VC_RET
|
||||
@@ -0,0 +1,297 @@
|
||||
; =============================================================================
|
||||
; vercors_protocol.asm -- logique protocolaire VERCORS.
|
||||
;
|
||||
; ETAT DE CE FICHIER -- A LIRE AVANT DE L'ETENDRE
|
||||
; -----------------------------------------------
|
||||
; Le prompt demande de se baser strictement sur la description VERCORS du
|
||||
; manifeste Gastinel Frame, et d'interroger plutot que de supposer. Le dossier
|
||||
; ..\Gastinel Frame est vide sur cette machine : le manifeste n'a pas pu etre
|
||||
; lu. En consequence ce module implemente UNIQUEMENT les points que le prompt
|
||||
; lui-meme specifie de bout en bout :
|
||||
;
|
||||
; [2] Heure Cible -- entierement specifiee, implementee ici.
|
||||
; [4] Gating temporel -- ordre impose, implemente ici.
|
||||
; [7] Bourrage 64 octets -- implemente ici, SAUF la disposition interne de
|
||||
; la trame, qui est une hypothese explicite (voir
|
||||
; FRAME_LAYOUT ci-dessous).
|
||||
; [8] Chiffrement CTR -- fourni par aes256.asm, cable ici.
|
||||
;
|
||||
; NE SONT PAS IMPLEMENTES, faute de specification, et NON DEVINES :
|
||||
; [1] Grain de Sel Temporel -- la derivation hebdomadaire identique des deux
|
||||
; cotes sans transmission du secret suppose une
|
||||
; racine partagee et une numerotation de semaine
|
||||
; dont la definition est dans le manifeste.
|
||||
; [3] Fenetre de Garde -- aucune valeur numerique connue (largeur
|
||||
; initiale, loi d'elargissement, plafond).
|
||||
; [5] Bascule de cle stegano -- aucun schema de dissimulation connu.
|
||||
; [6] Cold Start -- ni detection de reboot, ni definition de la
|
||||
; Cle Maitresse d'Usine.
|
||||
; Voir README.md, section "Points bloques sur specification".
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : la logique est portable. Sont x86-64-specifiques :
|
||||
; - l'instruction div pour le reste modulo 86400 (le M33 n'a pas de division
|
||||
; entiere materielle avec reste sur 64 bits ; il faudra udiv + mls, ou une
|
||||
; reduction par soustractions constantes en temps) ;
|
||||
; - bswap (rev en Thumb-2) ;
|
||||
; - rep movsb.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
extern vc_sha256_i
|
||||
extern vc_csprng_bytes_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; Constantes du protocole
|
||||
; -----------------------------------------------------------------------------
|
||||
%define VC_DAY_SECONDS 86400 ; domaine de l'Heure Cible : 0..86399
|
||||
|
||||
; Seuil de rejet pour un tirage uniforme sur 86400 valeurs a partir d'un mot de
|
||||
; 32 bits : 2^32 - (2^32 mod 86400) = 4294967296 - 23296 = 4294944000.
|
||||
; Un simple x % 86400 biaiserait les 23296 premieres secondes de la journee,
|
||||
; qui seraient tirees une fois de plus que les autres. Le biais est infime mais
|
||||
; il est systematique et connaissable par un attaquant, donc rejete ici.
|
||||
%define VC_REJECT_LIMIT 4294944000
|
||||
|
||||
%define VC_FRAME_BYTES 64 ; taille fixe d'une trame
|
||||
%define VC_FRAME_MAXPAYLOAD 63 ; 64 - 1 octet de longueur
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; FRAME_LAYOUT -- HYPOTHESE, A CONFIRMER SUR LE MANIFESTE
|
||||
;
|
||||
; Le prompt impose une trame de 64 octets dont la queue est du bruit CSPRNG,
|
||||
; mais ne dit pas comment le recepteur retrouve la frontiere charge/bruit. Il
|
||||
; faut au minimum un champ de longueur. Disposition retenue, la plus econome :
|
||||
;
|
||||
; octet 0 : L, longueur utile (0..63)
|
||||
; octets 1..L : charge utile
|
||||
; octets L+1..63 : bruit CSPRNG
|
||||
;
|
||||
; L'ensemble des 64 octets est ensuite chiffre en AES-256-CTR, donc L n'est pas
|
||||
; observable en clair sur l'air. Si le manifeste prevoit un en-tete (version,
|
||||
; identifiant de boitier, MAC tronque), cette disposition changera : elle est
|
||||
; isolee dans vc_frame_pad / vc_frame_unpad, nulle part ailleurs.
|
||||
; -----------------------------------------------------------------------------
|
||||
|
||||
section .text
|
||||
|
||||
global vc_derive_target_hour_i
|
||||
global vc_frame_pad_i
|
||||
global vc_frame_unpad_i
|
||||
|
||||
; =============================================================================
|
||||
; [2] HEURE CIBLE
|
||||
; =============================================================================
|
||||
; uint32_t vc_derive_target_hour(const uint8_t *grain, size_t grain_len)
|
||||
;
|
||||
; h <- SHA256(grain)
|
||||
; x <- 4 premiers octets de h, lus en big-endian
|
||||
; tant que x >= VC_REJECT_LIMIT : (methode de rejet)
|
||||
; h <- SHA256(h)
|
||||
; x <- 4 premiers octets de h
|
||||
; retourner x mod 86400
|
||||
;
|
||||
; Le premier tirage est exactement SHA256(Grain de Sel) comme specifie. La
|
||||
; regle de renouvellement en cas de rejet (rehachage du condensat precedent)
|
||||
; est deterministe et sans etat : emetteur et recepteur, partant du meme grain,
|
||||
; convergent sur la meme Heure Cible sans echanger quoi que ce soit.
|
||||
;
|
||||
; Probabilite de rejet a chaque tirage : 23296 / 2^32, soit environ 5,4e-6.
|
||||
; La boucle ne s'execute donc quasiment jamais, mais elle doit exister et etre
|
||||
; identique des deux cotes, sinon les deux extremites divergent silencieusement
|
||||
; une fois tous les ~185000 grains.
|
||||
;
|
||||
; Lecture big-endian des 4 premiers octets : choix d'ordre reseau, coherent
|
||||
; avec le reste du protocole radio. A CONFIRMER sur le manifeste -- une lecture
|
||||
; little-endian donnerait une Heure Cible differente pour le meme grain, donc
|
||||
; une incompatibilite totale avec un implementeur qui aurait choisi l'autre.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_derive_target_hour_i:
|
||||
push rbx
|
||||
push r12
|
||||
sub rsp, 40 ; [rsp .. rsp+31] = condensat courant
|
||||
|
||||
mov r12, rsp
|
||||
|
||||
; --- premier tirage : h = SHA256(grain)
|
||||
; rdi = grain, rsi = grain_len deja en place
|
||||
mov rdx, r12
|
||||
call vc_sha256_i
|
||||
|
||||
.draw:
|
||||
mov eax, [r12]
|
||||
bswap eax ; 4 premiers octets, big-endian
|
||||
mov ebx, eax
|
||||
|
||||
mov eax, VC_REJECT_LIMIT
|
||||
cmp ebx, eax
|
||||
jb .accept
|
||||
|
||||
; --- rejet : h <- SHA256(h), on retire
|
||||
mov rdi, r12
|
||||
mov rsi, 32
|
||||
mov rdx, r12
|
||||
call vc_sha256_i
|
||||
jmp .draw
|
||||
|
||||
.accept:
|
||||
mov eax, ebx
|
||||
xor edx, edx
|
||||
mov ecx, VC_DAY_SECONDS
|
||||
div ecx ; edx = x mod 86400
|
||||
mov eax, edx
|
||||
|
||||
; --- effacement du condensat (derive directement du Grain de Sel)
|
||||
mov qword [r12 + 0], 0
|
||||
mov qword [r12 + 8], 0
|
||||
mov qword [r12 + 16], 0
|
||||
mov qword [r12 + 24], 0
|
||||
|
||||
add rsp, 40
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; [7] BOURRAGE A TAILLE FIXE
|
||||
; =============================================================================
|
||||
; int vc_frame_pad(vc_csprng_ctx *rng, const uint8_t *payload, size_t len,
|
||||
; uint8_t out[64])
|
||||
; Retourne 0 si la trame est construite, -1 si len > 63.
|
||||
;
|
||||
; Toute trame fait exactement 64 octets, quelle que soit la charge utile :
|
||||
; un observateur radio ne peut pas deduire la longueur du message, ni meme
|
||||
; distinguer un accuse de reception d'un releve complet. Le remplissage est
|
||||
; du bruit CSPRNG et non des zeros -- avec des zeros, la queue chiffree en
|
||||
; CTR revelerait directement le flot de cle sur cette portion, ce qui rendrait
|
||||
; triviale la falsification du reste de la trame sous le meme compteur.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_frame_pad_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
|
||||
mov r12, rdi ; rng
|
||||
mov r13, rsi ; payload
|
||||
mov rbx, rdx ; len
|
||||
mov r14, rcx ; out
|
||||
|
||||
cmp rbx, VC_FRAME_MAXPAYLOAD
|
||||
ja .too_long
|
||||
|
||||
; --- octet de longueur
|
||||
mov [r14], bl
|
||||
|
||||
; --- charge utile
|
||||
test rbx, rbx
|
||||
jz .fill
|
||||
lea rdi, [r14 + 1]
|
||||
mov rsi, r13
|
||||
mov rcx, rbx
|
||||
rep movsb
|
||||
|
||||
.fill:
|
||||
; --- bruit CSPRNG sur la place restante
|
||||
mov rdi, r12
|
||||
lea rsi, [r14 + 1 + rbx]
|
||||
mov rdx, VC_FRAME_MAXPAYLOAD
|
||||
sub rdx, rbx
|
||||
test rdx, rdx
|
||||
jz .ok
|
||||
call vc_csprng_bytes_i
|
||||
|
||||
.ok:
|
||||
xor eax, eax
|
||||
jmp .done
|
||||
|
||||
.too_long:
|
||||
mov eax, -1
|
||||
|
||||
.done:
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; int vc_frame_unpad(const uint8_t in[64], uint8_t *out, size_t *out_len)
|
||||
; Retourne 0 si l'octet de longueur est coherent, -1 sinon.
|
||||
;
|
||||
; Un octet de longueur > 63 signale une trame corrompue ou un dechiffrement
|
||||
; avec la mauvaise cle. Ce n'est PAS un controle d'integrite : sans MAC, un
|
||||
; attaquant peut retourner des bits arbitraires du clair sous CTR. La
|
||||
; question de l'authentification des trames releve du manifeste et n'est pas
|
||||
; tranchee ici (voir README, "Points bloques sur specification").
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_frame_unpad_i:
|
||||
movzx eax, byte [rdi]
|
||||
cmp eax, VC_FRAME_MAXPAYLOAD
|
||||
ja .bad
|
||||
|
||||
mov [rdx], rax ; *out_len = L
|
||||
|
||||
test rax, rax
|
||||
jz .ok
|
||||
push rax
|
||||
mov rcx, rax
|
||||
mov rax, rdi
|
||||
mov rdi, rsi
|
||||
lea rsi, [rax + 1]
|
||||
rep movsb
|
||||
pop rax
|
||||
|
||||
.ok:
|
||||
xor eax, eax
|
||||
ret
|
||||
|
||||
.bad:
|
||||
mov eax, -1
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; [4] GATING TEMPOREL
|
||||
; =============================================================================
|
||||
; uint64_t vc_gate_accept(uint32_t arrival_sec, uint32_t target_sec)
|
||||
; Masque tout-a-un si la trame est recevable (arrival >= target), zero sinon.
|
||||
;
|
||||
; Le point du protocole est l'ORDRE : ce test precede le dechiffrement. Une
|
||||
; trame arrivee avant l'Heure Cible est jetee sans qu'AES soit lance une
|
||||
; seule fois. Cout d'un paquet de brouillage : deux comparaisons, au lieu de
|
||||
; quatre blocs AES. C'est ce qui rend le boitier insensible a une inondation
|
||||
; radio, sur un STM32U5 alimente par batterie ou l'energie est la ressource
|
||||
; rare.
|
||||
;
|
||||
; Rendu en masque plutot qu'en booleen : l'Heure Cible derive du Grain de Sel,
|
||||
; donc c'est un secret. Un saut conditionnel sur cette comparaison rendrait
|
||||
; l'ecart de temps mesurable et permettrait a un attaquant de faire varier
|
||||
; son instant d'emission pour localiser l'Heure Cible par dichotomie. Le
|
||||
; masque garde le meme flot de controle dans les deux cas ; c'est a l'appelant
|
||||
; de ne pas le redetruire par un branchement en aval.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_gate_accept
|
||||
VC_ARGS ; edi = arrival, esi = target
|
||||
cmp edi, esi ; CF = 1 si arrival < target
|
||||
sbb rax, rax ; -1 si trop tot, 0 sinon
|
||||
not rax ; -1 si recevable, 0 si trop tot
|
||||
VC_RET
|
||||
|
||||
; =============================================================================
|
||||
; Enveloppes publiques
|
||||
; =============================================================================
|
||||
|
||||
VC_FUNC vc_derive_target_hour
|
||||
VC_ARGS ; rdi = grain, rsi = grain_len
|
||||
call vc_derive_target_hour_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_frame_pad
|
||||
VC_ARGS ; rdi = rng, rsi = payload, rdx = len, rcx = out
|
||||
call vc_frame_pad_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_frame_unpad
|
||||
VC_ARGS ; rdi = in64, rsi = out, rdx = out_len
|
||||
call vc_frame_unpad_i
|
||||
VC_RET
|
||||
@@ -0,0 +1,65 @@
|
||||
#!/bin/sh
|
||||
# =============================================================================
|
||||
# build.sh -- assemblage et edition de liens du prototype VERCORS x86-64.
|
||||
#
|
||||
# ./build.sh cible native (win64 sous MinGW, elf64 sous Linux)
|
||||
# ./build.sh elf64 force la cible System V / ELF
|
||||
# ./build.sh win64 force la cible Microsoft x64 / COFF
|
||||
#
|
||||
# Choix assume : pas de Makefile. make n'est pas installe sur la machine de
|
||||
# developpement, et le projet ne compte qu'une dizaine d'unites -- un script sh, lisible
|
||||
# et sans dependance, coute moins cher a maintenir qu'un Makefile qu'on ne peut
|
||||
# pas executer.
|
||||
# =============================================================================
|
||||
set -e
|
||||
|
||||
# Le chemin du projet contient un espace ("Protocole VERCORS"). On se place
|
||||
# dans la racine et on n'utilise plus que des chemins relatifs : les variables
|
||||
# de drapeaux passees non quotees a gcc ne peuvent alors pas etre coupees.
|
||||
cd "$(dirname "$0")"
|
||||
OUT=build
|
||||
mkdir -p "$OUT"
|
||||
|
||||
FMT="$1"
|
||||
if [ -z "$FMT" ]; then
|
||||
case "$(uname -s 2>/dev/null)" in
|
||||
MINGW*|MSYS*|CYGWIN*|Windows_NT) FMT=win64 ;;
|
||||
*) FMT=elf64 ;;
|
||||
esac
|
||||
fi
|
||||
|
||||
if [ "$FMT" = "win64" ]; then
|
||||
NASMFLAGS="-f win64 -DABI_WIN64"
|
||||
OBJ=obj
|
||||
EXE=.exe
|
||||
else
|
||||
NASMFLAGS="-f elf64"
|
||||
OBJ=o
|
||||
EXE=
|
||||
fi
|
||||
|
||||
echo "== cible : $FMT =="
|
||||
|
||||
for m in sha256 aes256 const_time csprng vercors_protocol vercors_keysched factory_key; do
|
||||
echo " nasm asm/$m.asm"
|
||||
nasm $NASMFLAGS -I include -o "$OUT/$m.$OBJ" "asm/$m.asm"
|
||||
done
|
||||
|
||||
CFLAGS="-std=c11 -O2 -Wall -Wextra -Iinclude -Ihal"
|
||||
|
||||
for c in hal/radio_stub hal/imu_stub hal/baro_stub; do
|
||||
echo " gcc $c.c"
|
||||
gcc $CFLAGS -c -o "$OUT/$(basename $c).$OBJ" "$c.c"
|
||||
done
|
||||
|
||||
echo " gcc test/test_vercors.c"
|
||||
gcc $CFLAGS -c -o "$OUT/test_vercors.$OBJ" test/test_vercors.c
|
||||
|
||||
echo " link build/test_vercors$EXE"
|
||||
gcc -o "$OUT/test_vercors$EXE" \
|
||||
"$OUT/test_vercors.$OBJ" \
|
||||
"$OUT/radio_stub.$OBJ" "$OUT/imu_stub.$OBJ" "$OUT/baro_stub.$OBJ" \
|
||||
"$OUT/sha256.$OBJ" "$OUT/aes256.$OBJ" "$OUT/const_time.$OBJ" \
|
||||
"$OUT/csprng.$OBJ" "$OUT/vercors_protocol.$OBJ" "$OUT/vercors_keysched.$OBJ" "$OUT/factory_key.$OBJ"
|
||||
|
||||
echo "== ok : $OUT/test_vercors$EXE =="
|
||||
+43
@@ -0,0 +1,43 @@
|
||||
# ADR 0001 — Traduction d'ABI à l'assemblage plutôt que cible Linux imposée
|
||||
|
||||
- **Statut** : accepté
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le prompt fixe la cible « Linux x86-64, convention System V AMD64 ». La machine
|
||||
de développement est sous Windows 11 et **WSL n'y est pas installé**
|
||||
(`wsl -e` répond « Le Sous-système Windows pour Linux n'est pas installé »).
|
||||
La seule chaîne x86-64 exécutable nativement est `nasm` + `gcc` MinGW fournis
|
||||
par Strawberry Perl, qui produisent du COFF/Win64.
|
||||
|
||||
Assembler en ELF64 sans pouvoir éditer les liens ni exécuter aurait donné du
|
||||
code jamais lancé une seule fois — inacceptable pour une passe dont l'objet
|
||||
même est de *valider* la logique du protocole.
|
||||
|
||||
## Décision
|
||||
|
||||
Tout le code assembleur est écrit dans un vocabulaire canonique System V
|
||||
(arguments dans `rdi, rsi, rdx, rcx`). `include/abi.inc` fournit trois macros —
|
||||
`VC_FUNC`, `VC_ARGS`, `VC_RET` — qui, sous `-DABI_WIN64`, recopient les
|
||||
arguments depuis `rcx, rdx, r8, r9` et préservent `rdi`/`rsi` (callee-saved
|
||||
sous ABI Microsoft). Sans ce define, les macros sont inertes et le code est du
|
||||
System V strict.
|
||||
|
||||
Chaque module expose en outre des symboles internes `*_i` suivant une
|
||||
convention privée System V, utilisés pour les appels entre modules assembleur.
|
||||
Aucun appel interne n'a ainsi à respecter le *shadow space* Microsoft.
|
||||
|
||||
## Conséquences
|
||||
|
||||
- Les cinq modules assemblent **sans modification** en `elf64` et en `win64` ;
|
||||
`./build.sh elf64` et `./build.sh win64` sont tous deux valides.
|
||||
- La cible de référence reste System V : c'est le mode par défaut sous Linux.
|
||||
- Coût : deux `push`/`pop` par fonction publique sous Win64. Nul sous System V.
|
||||
- `abi.inc` est intégralement x86-64-spécifique et sera remplacé par un
|
||||
équivalent AAPCS au portage Cortex-M33. Aucune logique protocolaire n'y vit.
|
||||
|
||||
## Alternative écartée
|
||||
|
||||
Installer WSL. Cela modifie la configuration système de la machine de l'auteur,
|
||||
ce qui dépasse le périmètre confié.
|
||||
@@ -0,0 +1,45 @@
|
||||
# ADR 0002 — AES logiciel plutôt qu'AES-NI
|
||||
|
||||
- **Statut** : accepté
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le prompt autorise AES-NI à condition de le signaler explicitement, en
|
||||
rappelant que le Cortex-M33 n'en dispose pas et exigera une version logicielle.
|
||||
|
||||
## Décision
|
||||
|
||||
Ne **pas** utiliser AES-NI. `asm/aes256.asm` est une implémentation logicielle
|
||||
scalaire : S-box de 256 octets, `ShiftRows` fusionné dans les indices de
|
||||
lecture, `MixColumns` par `xtime` sans branchement.
|
||||
|
||||
## Justification
|
||||
|
||||
Cette passe x86-64 sert à valider la logique VERCORS *avant* portage. Une
|
||||
implémentation AES-NI validerait un chemin d'exécution qui n'existera jamais
|
||||
sur le boîtier, et laisserait la version réellement embarquée non testée. La
|
||||
version logicielle donne un comportement bit-à-bit identique à la cible et la
|
||||
même structure de code à porter.
|
||||
|
||||
## Conséquences
|
||||
|
||||
- Plus lent qu'AES-NI. Sans importance : le débit visé est de quelques trames
|
||||
de 64 octets par jour sur 169 MHz.
|
||||
- Aucune instruction x86-64 exotique. Le portage Thumb-2 est une transcription,
|
||||
pas une réécriture.
|
||||
- **Fuite par canal auxiliaire assumée** : `SubBytes` indexe une table avec des
|
||||
données secrètes, ce qui est observable par timing de cache sur un CPU
|
||||
partagé. Accepté ici parce que (a) la cible STM32U5 n'a pas de cache de
|
||||
données partagé avec un attaquant ni de multi-tenance, (b) le modèle de
|
||||
menace du produit est un attaquant *radio distant*, pas un voisin de cache,
|
||||
(c) une version constante en temps demanderait du bitslicing, qui ne se
|
||||
transpose pas tel quel en Thumb-2 et brouillerait l'objet de cette passe.
|
||||
- Les comparaisons de secrets, elles, sont bien en temps constant — c'est ce
|
||||
que la contrainte projet exigeait nommément. Voir `asm/const_time.asm`.
|
||||
|
||||
## À revoir si
|
||||
|
||||
Le protocole devait un jour tourner sur un hôte partagé (passerelle Linux
|
||||
mutualisée, serveur de collecte). Le modèle de menace changerait alors, et le
|
||||
bitslicing ou AES-NI redeviendrait justifié — sur cette cible-là uniquement.
|
||||
@@ -0,0 +1,47 @@
|
||||
# ADR 0003 — Mode de chiffrement : CTR
|
||||
|
||||
- **Statut** : accepté, avec une réserve d'authentification à trancher
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le prompt recommande CTR pour du radio bas-débit avec IV/compteur, en demandant
|
||||
que le choix soit confirmé dans le rapport plutôt qu'imposé silencieusement.
|
||||
|
||||
## Décision
|
||||
|
||||
CTR est retenu.
|
||||
|
||||
## Justification
|
||||
|
||||
1. **Pas de bourrage cryptographique.** CTR est un chiffrement par flot : la
|
||||
trame de 64 octets est chiffrée telle quelle. Le bourrage du protocole est
|
||||
du remplissage *applicatif* à taille fixe, sans lien avec un multiple de
|
||||
bloc. En CBC il aurait fallu un bourrage PKCS#7 en plus, donc des octets
|
||||
transmis en pure perte sur une liaison où chaque octet coûte de l'énergie.
|
||||
2. **Chiffrement seul.** CTR n'utilise jamais le déchiffrement de bloc AES.
|
||||
`InvSubBytes`, `InvMixColumns` et la table inverse disparaissent : environ
|
||||
la moitié du code AES et de la ROM en moins sur STM32U5.
|
||||
3. **Pas de propagation d'erreur.** Un bit retourné par le canal radio
|
||||
corrompt un bit du clair, pas un bloc entier — utile pour diagnostiquer une
|
||||
liaison dégradée en montagne.
|
||||
4. **IV/compteur par paquet**, comme demandé au point [8] du prompt.
|
||||
|
||||
## Réserve, à trancher sur le manifeste
|
||||
|
||||
CTR ne fournit **aucune authentification**. Sous CTR, un attaquant qui connaît
|
||||
ou devine une portion du clair peut retourner les bits correspondants du
|
||||
chiffré sans être détecté. Le gating temporel filtre l'inondation, pas la
|
||||
falsification ciblée.
|
||||
|
||||
Il manque donc un MAC (HMAC-SHA-256 tronqué, ou AES-CMAC) ou un mode AEAD. Le
|
||||
SHA-256 nécessaire est déjà présent dans ce dépôt ; c'est la place du MAC dans
|
||||
la trame de 64 octets qui n'est pas décidable sans le manifeste. **Ce point est
|
||||
ouvert et n'a pas été comblé par une supposition.**
|
||||
|
||||
## Interdit absolu associé
|
||||
|
||||
Un couple (clé, compteur) ne doit jamais servir deux fois : la réutilisation
|
||||
d'un flot CTR révèle le XOR des deux clairs. La bascule de clé quotidienne [5]
|
||||
et la gestion du compteur doivent le garantir — encore un point qui dépend de
|
||||
la spécification manquante.
|
||||
@@ -0,0 +1,44 @@
|
||||
# ADR 0004 — CSPRNG maison basé sur SHA-256
|
||||
|
||||
- **Statut** : accepté
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le point [7] du prompt exige que le bourrage des trames soit du bruit produit
|
||||
par un « CSPRNG-maison », et la contrainte projet interdit toute bibliothèque
|
||||
externe. Il faut donc un générateur, et il doit être écrit ici.
|
||||
|
||||
## Décision
|
||||
|
||||
Un DRBG à base de hachage, dans l'esprit de `Hash_DRBG` (NIST SP 800-90A) mais
|
||||
volontairement réduit :
|
||||
|
||||
```
|
||||
seed(g) V <- SHA256(g) ; C <- 0
|
||||
bytes(n) par bloc de 32 : sortie <- SHA256(V || BE64(C)) ; C <- C + 1
|
||||
puis, la demande servie : V <- SHA256(0x01 || V)
|
||||
reseed(g) V <- SHA256(V || g)
|
||||
```
|
||||
|
||||
## Justification
|
||||
|
||||
- Ne réutilise que la primitive déjà présente et déjà validée sur vecteurs
|
||||
FIPS. Aucune surface cryptographique nouvelle à auditer.
|
||||
- Le rafraîchissement final de `V` donne la **résistance au retour en
|
||||
arrière** : compromettre le boîtier après coup ne permet pas de recalculer le
|
||||
bourrage des trames déjà émises.
|
||||
- `reseed` mélange la nouvelle entropie à l'ancienne au lieu de la remplacer :
|
||||
un réamorçage depuis une source dégradée ne peut pas affaiblir l'état.
|
||||
|
||||
## Conséquences
|
||||
|
||||
- **Ce module ne fabrique pas d'entropie.** La graine vient de l'extérieur :
|
||||
le harnais de test sur x86-64, le TRNG matériel sur STM32U5. C'est la seule
|
||||
différence de fond au portage, et elle est isolée derrière `vc_csprng_seed`.
|
||||
- Un générateur amorcé avec une graine prévisible produit un bourrage
|
||||
prévisible. Le câblage de `vc_csprng_seed` sur le TRNG est donc un point de
|
||||
vérification obligatoire de la revue de portage.
|
||||
- Non certifié SP 800-90A : la construction s'en inspire, ne la suit pas à la
|
||||
lettre (pas de `reseed_counter`, pas de `additional_input`, pas de tests de
|
||||
santé). À reprendre si une certification est visée.
|
||||
@@ -0,0 +1,55 @@
|
||||
# ADR 0005 — Méthode de rejet pour l'Heure Cible
|
||||
|
||||
- **Statut** : accepté
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le point [2] du prompt impose explicitement une méthode de rejet, « pas un
|
||||
simple modulo qui biaiserait la distribution ».
|
||||
|
||||
## Décision
|
||||
|
||||
```
|
||||
h <- SHA256(Grain de Sel)
|
||||
x <- 4 premiers octets de h, lus en big-endian
|
||||
tant que x >= 4294944000 : h <- SHA256(h) ; x <- 4 premiers octets de h
|
||||
retourner x mod 86400
|
||||
```
|
||||
|
||||
Le seuil vaut `2^32 - (2^32 mod 86400) = 4294967296 - 23296 = 4294944000`.
|
||||
|
||||
## Justification
|
||||
|
||||
Avec un modulo nu sur 32 bits, les 23296 premières secondes de la journée
|
||||
seraient tirées une fois de plus que les autres : un biais de l'ordre de
|
||||
5,4 × 10⁻⁶. Infime, mais **systématique et calculable par un attaquant**, qui
|
||||
saurait donc que l'Heure Cible tombe très légèrement plus souvent avant
|
||||
06:28:16. La méthode de rejet le supprime exactement.
|
||||
|
||||
Deux détails ont été fixés pour que les deux extrémités convergent :
|
||||
|
||||
- **Le premier tirage est exactement `SHA256(grain)`**, comme spécifié. La
|
||||
règle de renouvellement (rehacher le condensat précédent) ne s'applique qu'à
|
||||
partir du deuxième.
|
||||
- La boucle est déterministe et sans état : émetteur et récepteur, partant du
|
||||
même grain, obtiennent la même Heure Cible sans rien échanger.
|
||||
|
||||
La probabilité de rejet est de 23296/2³², soit environ une fois tous les
|
||||
185 000 grains. La boucle ne s'exécute quasiment jamais — raison de plus pour
|
||||
qu'elle soit identique des deux côtés, un désaccord ne se manifestant qu'à
|
||||
cette fréquence-là, c'est-à-dire jamais en test et un jour en production.
|
||||
|
||||
## Point à confirmer sur le manifeste
|
||||
|
||||
**L'ordre de lecture des 4 premiers octets.** Le prompt dit « 4 premiers octets
|
||||
→ entier 32 bits » sans préciser l'endianness. Le big-endian a été retenu
|
||||
(ordre réseau, cohérent avec le reste d'un protocole radio). Une lecture
|
||||
little-endian donnerait une Heure Cible **différente pour le même grain**, donc
|
||||
une incompatibilité totale avec une autre implémentation. Deux vecteurs de
|
||||
référence figent ce choix dans `test/test_vercors.c` :
|
||||
|
||||
| Grain | Heure Cible |
|
||||
|---------------------|-------------|
|
||||
| 32 octets `0x00` | 59181 |
|
||||
| 32 octets `0xff` | 40182 |
|
||||
@@ -0,0 +1,47 @@
|
||||
# ADR 0006 — Disposition interne de la trame : hypothèse explicite
|
||||
|
||||
- **Statut** : **provisoire — à valider sur le manifeste Gastinel Frame**
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le point [7] impose une trame de 64 octets dont la queue est du bruit CSPRNG,
|
||||
mais ne dit pas comment le récepteur retrouve la frontière entre charge utile
|
||||
et bruit. Il faut au minimum un champ de longueur. Le manifeste, qui décrit
|
||||
vraisemblablement l'en-tête réel, n'a pas pu être lu : le dossier
|
||||
`__RADIO\Gastinel Frame` est vide sur cette machine.
|
||||
|
||||
## Décision
|
||||
|
||||
Faute de spécification, et plutôt que de ne rien livrer, une disposition
|
||||
minimale est retenue **et signalée comme hypothèse** :
|
||||
|
||||
```
|
||||
octet 0 : bit 7 = drapeau de bascule ; bits 0-6 = longueur utile L
|
||||
octets 1..L : charge utile
|
||||
octets L+1..63 : bruit CSPRNG
|
||||
```
|
||||
|
||||
Le bit 7 a été ajouté par l'ADR 0009 pour signaler la bascule de clé. Sans
|
||||
bascule, L ne dépasse pas 63 et le bit reste donc naturellement à zéro.
|
||||
|
||||
**L'octet d'en-tête est à l'intérieur du chiffré.** `vc_frame_pad` /
|
||||
`vc_frame_build` construisent les 64 octets en clair, puis l'appelant chiffre le
|
||||
bloc **entier** en AES-256-CTR. Ni la longueur ni le drapeau ne circulent en
|
||||
clair : l'exigence d'indifférenciabilité du cas C est satisfaite, et toutes les
|
||||
trames font 64 octets quel que soit leur contenu.
|
||||
|
||||
## Ce que cela n'est pas
|
||||
|
||||
`vc_frame_unpad` rejette un `L > 63`. **Ce n'est pas un contrôle
|
||||
d'intégrité** : sous CTR, un attaquant peut retourner des bits arbitraires du
|
||||
clair. Voir la réserve d'authentification de l'ADR 0003.
|
||||
|
||||
## Conséquences
|
||||
|
||||
- Si le manifeste prévoit un en-tête (version de protocole, identifiant de
|
||||
boîtier, MAC tronqué, numéro de compteur), cette disposition changera.
|
||||
- Le coût de ce changement est **borné à deux fonctions** : `vc_frame_pad_i` et
|
||||
`vc_frame_unpad_i` dans `asm/vercors_protocol.asm`. Aucun autre module ne
|
||||
connaît la structure interne de la trame.
|
||||
- Les 63 octets utiles maximum diminueront d'autant que l'en-tête réel occupe.
|
||||
@@ -0,0 +1,56 @@
|
||||
# ADR 0007 — Dérivation du Grain de Sel Temporel
|
||||
|
||||
- **Statut** : **HYPOTHÈSE PROVISOIRE — à valider avant tout déploiement réel**
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le point [1] impose une génération isolée hebdomadaire : les deux extrémités
|
||||
doivent arriver au même Grain de Sel **sans jamais le transmettre**. Le
|
||||
manifeste Gastinel Frame ne descend pas à ce niveau de détail.
|
||||
|
||||
## Décision
|
||||
|
||||
```
|
||||
grain = SHA256( K_M(32) || BE16(semaine_ISO) || BE32(compteur_anti_rejeu) )
|
||||
```
|
||||
|
||||
`K_M` est la Clé Maîtresse d'Usine — le **même** secret que celui du Cold Start
|
||||
(ADR 0010), provisionné boîtier et serveur. Le compteur anti-rejeu permet de
|
||||
renouveler le grain à l'intérieur d'une semaine sans attendre la suivante.
|
||||
|
||||
Implémenté dans `vc_derive_grain` (`asm/vercors_keysched.asm`).
|
||||
|
||||
## Choix d'encodage ajoutés ici
|
||||
|
||||
Le format n'était pas donné au bit près. Ont été fixés, par cohérence avec
|
||||
l'ordre réseau déjà retenu pour l'Heure Cible (ADR 0005) :
|
||||
|
||||
- semaine ISO : **uint16 big-endian**
|
||||
- compteur anti-rejeu : **uint32 big-endian**
|
||||
- concaténation sans séparateur, dans cet ordre, longueur totale 38 octets
|
||||
|
||||
Un vecteur de référence fige ce choix dans `test/test_vercors.c` : il recalcule
|
||||
le grain avec les primitives SHA-256 en composant l'entrée à la main, et vérifie
|
||||
l'égalité avec `vc_derive_grain`.
|
||||
|
||||
## Point ouvert signalé, non tranché
|
||||
|
||||
**L'époque d'origine des semaines n'est pas définie.** Un `uint16` ne porte pas
|
||||
d'année : « semaine 36 » est ambigu sans point de départ. Deux implémentations
|
||||
qui ne partent pas de la même origine dériveront des grains différents et **ne
|
||||
se parleront jamais** — sans erreur visible, juste un silence radio permanent.
|
||||
|
||||
À trancher avant tout provisioning : époque de référence, fuseau (les semaines
|
||||
ISO changent de numéro à minuit UTC ou local ?), et comportement au
|
||||
débordement du `uint16` (65536 semaines ≈ 1258 ans, donc théorique, mais le
|
||||
choix d'un `uint16` mérite d'être confirmé plutôt que subi).
|
||||
|
||||
## Conséquences
|
||||
|
||||
- Compromettre `K_M` compromet **tous** les grains, passés et futurs, des deux
|
||||
extrémités. C'est le secret racine ; son stockage est le point critique du
|
||||
système (voir ADR 0010).
|
||||
- Aucune propriété de secret persistant : rejouer une semaine ancienne avec le
|
||||
même compteur redonne le même grain. C'est précisément le rôle du compteur
|
||||
anti-rejeu, dont la politique d'incrémentation reste à définir.
|
||||
@@ -0,0 +1,78 @@
|
||||
# ADR 0008 — Fenêtre de Garde Dynamique
|
||||
|
||||
- **Statut** : **HYPOTHÈSE PROVISOIRE — à valider avant tout déploiement réel**
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le point [3] décrit le principe — élargissement selon le temps écoulé depuis le
|
||||
dernier message valide, resserrement et recalage d'horloge dès réception
|
||||
valide — sans donner de valeurs numériques.
|
||||
|
||||
## Décision
|
||||
|
||||
Élargissement **linéaire**, **plafonné** :
|
||||
|
||||
```
|
||||
demi_largeur(écoulé) = min( GUARD_MIN + écoulé × DRIFT_PPM / 1e6 , GUARD_MAX )
|
||||
```
|
||||
|
||||
| Paramètre | Valeur | Origine |
|
||||
|---|---|---|
|
||||
| `GUARD_MAX` | 30 s | **fourni**, à valider |
|
||||
| `GUARD_MIN` | 2 s | **hypothèse ajoutée ici** |
|
||||
| `DRIFT_PPM` | 20 ppm | **hypothèse ajoutée ici** |
|
||||
|
||||
Resserrement immédiat à `GUARD_MIN` dès réception d'un paquet valide, avec
|
||||
mémorisation du recalage d'horloge.
|
||||
|
||||
## Pourquoi la pente est celle-là
|
||||
|
||||
La pente n'est pas arbitraire : elle suit la **dérive du quartz**. Un LSE
|
||||
d'horlogerie à 20 ppm dérive de 20 µs par seconde, soit environ 1,73 s par
|
||||
jour. La fenêtre s'ouvre donc exactement au rythme où l'incertitude d'horloge
|
||||
grandit — ni plus, ni moins.
|
||||
|
||||
C'est le point important : une fenêtre plus large que l'incertitude réelle est
|
||||
une surface d'attaque offerte gratuitement, une fenêtre plus étroite fait
|
||||
perdre des paquets légitimes. Caler la pente sur le quartz est la seule
|
||||
justification défendable, et elle rend le paramètre **vérifiable** — il suffit
|
||||
de mesurer la dérive réelle du composant retenu.
|
||||
|
||||
Avec ces valeurs, le plafond de 30 s est atteint après environ **16 jours** de
|
||||
silence. Au-delà, le Cold Start (ADR 0010) prend le relais à 7 jours — donc en
|
||||
pratique le plafond n'est jamais atteint en fonctionnement nominal, il n'existe
|
||||
que comme garde-fou.
|
||||
|
||||
## Le plafond est obligatoire
|
||||
|
||||
Sans lui, un boîtier oublié plusieurs mois finirait par accepter n'importe quel
|
||||
instant d'arrivée, ce qui **annulerait entièrement le gating temporel [4]** —
|
||||
c'est-à-dire la propriété qui protège la batterie contre l'inondation radio. Le
|
||||
bornage était explicitement demandé, il est implémenté et testé (10 ans de
|
||||
silence → toujours 30 s).
|
||||
|
||||
## Décisions de mise en œuvre ajoutées ici
|
||||
|
||||
- **Seul le bord inférieur de la fenêtre est relâché.** La Fenêtre de Garde
|
||||
existe pour tolérer un paquet légitime arrivé un peu tôt par dérive
|
||||
d'horloge. Poser une borne haute rejetterait le premier message utile, que
|
||||
le protocole prévoit explicitement *après* l'Heure Cible (point [5]).
|
||||
- **Saturation à zéro** quand `target - width` passe sous minuit, au lieu d'un
|
||||
bouclage vers 4 milliards qui rejetterait tout.
|
||||
- **Le recalage est mémorisé comme un décalage, pas appliqué à l'horloge.**
|
||||
Écrire directement dans l'horloge locale la ferait sauter en arrière et
|
||||
casserait toute autre temporisation en cours dans le firmware.
|
||||
- **Une horloge qui recule est bornée à zéro écoulé** : sans cela, la
|
||||
soustraction non signée produirait un écoulé gigantesque, donc une fenêtre
|
||||
immédiatement plafonnée — exactement l'inverse de ce qu'on veut.
|
||||
- Le test de fenêtre reste **sans branchement** : l'Heure Cible dérive du Grain
|
||||
de Sel, c'est un secret, et un saut conditionnel permettrait de la localiser
|
||||
par dichotomie en faisant varier l'instant d'émission.
|
||||
|
||||
## Ce qui reste à valider
|
||||
|
||||
Les trois paramètres, mais surtout `DRIFT_PPM` : il doit correspondre au quartz
|
||||
réellement monté sur le boîtier, dans sa plage de température de service. En
|
||||
montagne, l'écart de température est large et la dérive d'un quartz n'est pas
|
||||
constante — 20 ppm est une valeur de catalogue à 25 °C, pas une mesure.
|
||||
@@ -0,0 +1,69 @@
|
||||
# ADR 0009 — Bascule de clé asynchrone
|
||||
|
||||
- **Statut** : **HYPOTHÈSE PROVISOIRE — à valider avant tout déploiement réel**
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le point [5] veut la clé du lendemain cachée dans le premier message utile
|
||||
après l'Heure Cible, sans que le bourrage cesse d'être indifférenciable du
|
||||
bruit (cas C du manifeste).
|
||||
|
||||
## Décision
|
||||
|
||||
**Chaînage de clés** : la clé N+1 est chiffrée **avec la clé du jour courant
|
||||
N** avant d'être logée dans la zone de bourrage. Jamais en clair.
|
||||
|
||||
Disposition de la trame de 64 octets :
|
||||
|
||||
```
|
||||
octet 0 : bit 7 = drapeau de bascule ; bits 0-6 = longueur utile L
|
||||
octets 1..L : charge utile
|
||||
sans bascule : octets L+1..63 = bruit CSPRNG
|
||||
avec bascule : octets L+1..31 = bruit CSPRNG
|
||||
octets 32..63 = clé N+1 chiffrée sous la clé du jour
|
||||
```
|
||||
|
||||
Implémenté dans `vc_frame_build` / `vc_frame_parse`.
|
||||
|
||||
## Pourquoi c'est indifférenciable
|
||||
|
||||
Trois couches, et chacune compte :
|
||||
|
||||
1. Le créneau de clé est du **chiffré AES**, donc uniforme, donc statistiquement
|
||||
indistinguable du bruit CSPRNG qui l'entoure.
|
||||
2. La trame entière est ensuite **rechiffrée par l'appelant** sous la clé de
|
||||
trame : le drapeau de bascule lui-même n'est jamais observable sur l'air.
|
||||
3. La taille reste **64 octets dans tous les cas**, avec ou sans bascule. Un
|
||||
observateur ne peut donc pas repérer les jours de renouvellement de clé par
|
||||
analyse de trafic — c'est ce que le cas C exige.
|
||||
|
||||
## Séparation de domaine des compteurs — non négociable
|
||||
|
||||
Le créneau de clé est chiffré avec un compteur dont l'octet 0 vaut
|
||||
`VC_CTR_DOMAIN_KEYWRAP` (0x01), alors que les trames utilisent
|
||||
`VC_CTR_DOMAIN_FRAME` (0x00).
|
||||
|
||||
**Sans cette séparation, le même flot de clé servirait deux fois sous la même
|
||||
clé du jour**, ce qui révélerait le XOR des deux clairs — donc directement la
|
||||
clé N+1, puisqu'une partie du clair de trame est devinable. C'est la faute
|
||||
mortelle du mode CTR, et elle serait ici immédiatement fatale au protocole
|
||||
entier, puisque compromettre la clé N+1 compromet toute la chaîne suivante.
|
||||
|
||||
`vc_ctr_set_domain` existe pour rendre cette contrainte explicite plutôt que
|
||||
laissée à la discipline de l'appelant.
|
||||
|
||||
## Conséquences
|
||||
|
||||
- **La charge utile tombe de 63 à 31 octets** les jours de bascule. Sur une
|
||||
trame de 64 octets, une clé AES-256 en occupe la moitié : c'est arithmétique,
|
||||
pas négociable. À confirmer que 31 octets suffisent aux messages concernés.
|
||||
- Le chaînage crée une **dépendance en cascade** : perdre la trame porteuse de
|
||||
la clé N+1 désynchronise durablement. Une politique de répétition ou de
|
||||
recouvrement est nécessaire — non spécifiée, non implémentée.
|
||||
- **Aggravation du point ouvert de l'ADR 0003.** Sans MAC, un attaquant peut
|
||||
retourner des bits arbitraires du clair, y compris dans le créneau de clé.
|
||||
Il ne peut pas *choisir* la clé N+1 résultante, mais il peut la **corrompre**,
|
||||
et provoquer une désynchronisation permanente des deux extrémités avec un
|
||||
seul bit retourné. L'authentification des trames n'est pas un raffinement
|
||||
ici : c'est ce qui empêche un déni de service définitif à coût nul.
|
||||
@@ -0,0 +1,79 @@
|
||||
# ADR 0010 — Cold Start et Clé Maîtresse d'Usine
|
||||
|
||||
- **Statut** : **HYPOTHÈSE PROVISOIRE — à valider avant tout déploiement réel**
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le point [6] demande la détection d'un redémarrage, une bascule temporaire sur
|
||||
la Clé Maîtresse d'Usine, puis une resynchronisation. Le manifeste ne décrit ni
|
||||
le mécanisme de détection, ni le stockage de la clé.
|
||||
|
||||
## Décision — K_M
|
||||
|
||||
`K_M` est un **secret de provisioning distinct**, pas dérivé du protocole.
|
||||
C'est le **même** secret que celui de la dérivation du Grain de Sel (ADR 0007) :
|
||||
même clé, même stockage, une seule racine à protéger.
|
||||
|
||||
## Décision — détection
|
||||
|
||||
La resynchronisation est déclenchée **localement**, sans signalisation dédiée
|
||||
sur l'air. Deux causes, une seule conséquence :
|
||||
|
||||
- **aucun paquet valide depuis 7 jours** (`VC_COLDSTART_TIMEOUT`). La valeur est
|
||||
alignée sur la période hebdomadaire du grain : un silence dépassant la semaine
|
||||
signifie que le grain courant est périmé des deux côtés, donc qu'aucune
|
||||
reprise normale n'est possible ;
|
||||
- **démarrage sans état de synchronisation** (bit `flags.0` à zéro), c'est-à-dire
|
||||
le reboot.
|
||||
|
||||
Dans les deux cas, bascule temporaire sur `K_M` le temps d'un échange de
|
||||
resynchronisation, puis retour à la dérivation normale.
|
||||
|
||||
Implémenté dans `vc_coldstart_needed`.
|
||||
|
||||
## Le placeholder de test
|
||||
|
||||
`asm/factory_key.asm` contient une constante de 32 octets valant littéralement
|
||||
`PLACEHOLDER-NE-PAS-UTILISER-PROD`.
|
||||
|
||||
Le contenu est volontairement **lisible en ASCII** : un vidage mémoire ou un
|
||||
dump flash doit crier qu'on est en configuration de test, pas ressembler à une
|
||||
vraie clé. Une valeur aléatoire d'apparence crédible serait bien plus
|
||||
dangereuse — elle pourrait survivre à une revue sans être remarquée.
|
||||
|
||||
Cette clé est **publique** : elle vit dans un dépôt, en clair, dans un fichier
|
||||
versionné. Tout boîtier provisionné avec elle est déchiffrable par quiconque lit
|
||||
ce fichier.
|
||||
|
||||
## TODO PORTAGE — ce n'est pas un simple remplacement de constante
|
||||
|
||||
Sur cible, `K_M` vivra dans l'**élément sécurisé STSAFE-A110**, pas en mémoire
|
||||
du microcontrôleur. Ce n'est pas qu'un changement de valeur, c'est un changement
|
||||
de forme d'API :
|
||||
|
||||
- `vc_factory_key` retourne aujourd'hui un **pointeur** vers de la ROM ;
|
||||
- sur cible, les octets de `K_M` **ne doivent jamais transiter par la RAM** du
|
||||
STM32U5 — sinon l'élément sécurisé ne sert à rien ;
|
||||
- il faudra donc une API **par opération** (dériver un grain, déverrouiller une
|
||||
session) plutôt que par exposition de la clé, le STSAFE faisant le calcul
|
||||
lui-même.
|
||||
|
||||
Concrètement, `vc_derive_grain(km, ...)` deviendra quelque chose comme
|
||||
`vc_derive_grain_stsafe(week, counter, out)`, sans paramètre de clé. Le
|
||||
prototype x86-64 conserve la forme « pointeur » uniquement parce qu'il n'a pas
|
||||
d'élément sécurisé. **C'est la différence structurante entre ce prototype et la
|
||||
cible**, et le point à traiter en premier au portage.
|
||||
|
||||
## Ce qui reste à définir
|
||||
|
||||
- Le **contenu de l'échange de resynchronisation** lui-même : quelles trames,
|
||||
dans quel ordre, avec quelle preuve de fraîcheur. Seul le déclencheur est
|
||||
implémenté ici, pas le dialogue.
|
||||
- La **protection du Cold Start contre l'abus** : un attaquant qui parvient à
|
||||
maintenir le silence radio 7 jours force le boîtier sur `K_M`. Si l'échange de
|
||||
resynchronisation est plus faible que le régime nominal, c'est un chemin
|
||||
d'attaque, et il est atteignable par simple brouillage.
|
||||
- La **valeur de 7 jours**, à confronter aux conditions réelles : un boîtier en
|
||||
fond de vallée peut-il rester une semaine sans liaison en fonctionnement
|
||||
normal ?
|
||||
@@ -0,0 +1,38 @@
|
||||
/* ============================================================================
|
||||
* baro_stub.c -- barometre simule.
|
||||
*
|
||||
* Valeurs plausibles pour un boitier en montagne : environ 1500 m d'altitude.
|
||||
* ==========================================================================*/
|
||||
|
||||
#include "vc_baro.h"
|
||||
#include "vc_radio.h" /* codes VC_HAL_* */
|
||||
|
||||
static uint32_t s_pressure_pa = 84500; /* ~1500 m */
|
||||
static int32_t s_temp_centi_c = 420; /* 4,20 degres C */
|
||||
|
||||
void vc_baro_init(void)
|
||||
{
|
||||
s_pressure_pa = 84500;
|
||||
s_temp_centi_c = 420;
|
||||
}
|
||||
|
||||
int vc_baro_read_pressure(uint32_t *out_pa)
|
||||
{
|
||||
if (out_pa == 0) return VC_HAL_EIO;
|
||||
*out_pa = s_pressure_pa;
|
||||
return VC_HAL_OK;
|
||||
}
|
||||
|
||||
int vc_baro_read_temp(int32_t *out_centi_c)
|
||||
{
|
||||
if (out_centi_c == 0) return VC_HAL_EIO;
|
||||
*out_centi_c = s_temp_centi_c;
|
||||
return VC_HAL_OK;
|
||||
}
|
||||
|
||||
/* --- point de controle reserve au harnais de test ---------------------- */
|
||||
void vc_baro_stub_set(uint32_t pa, int32_t centi_c)
|
||||
{
|
||||
s_pressure_pa = pa;
|
||||
s_temp_centi_c = centi_c;
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
/* ============================================================================
|
||||
* imu_stub.c -- centrale inertielle simulee.
|
||||
*
|
||||
* Retourne une acceleration au repos (1 g sur z) et un drapeau de chute que le
|
||||
* harnais peut armer. Aucune modelisation physique : ce n'est pas l'objet de
|
||||
* cette passe, et la detection reelle vivra dans le firmware cible.
|
||||
* ==========================================================================*/
|
||||
|
||||
#include "vc_imu.h"
|
||||
#include "vc_radio.h" /* codes VC_HAL_* */
|
||||
|
||||
static int s_fall_pending;
|
||||
|
||||
void vc_imu_init(void)
|
||||
{
|
||||
s_fall_pending = 0;
|
||||
}
|
||||
|
||||
int vc_imu_read_accel(vc_imu_accel_t *out)
|
||||
{
|
||||
if (out == 0) return VC_HAL_EIO;
|
||||
out->x = 0;
|
||||
out->y = 0;
|
||||
out->z = 1000; /* 1 g, boitier au repos */
|
||||
return VC_HAL_OK;
|
||||
}
|
||||
|
||||
int vc_imu_fall_detected(void)
|
||||
{
|
||||
int f = s_fall_pending;
|
||||
s_fall_pending = 0; /* lecture destructrice, comme un drapeau materiel */
|
||||
return f;
|
||||
}
|
||||
|
||||
/* --- point de controle reserve au harnais de test ---------------------- */
|
||||
void vc_imu_stub_arm_fall(void)
|
||||
{
|
||||
s_fall_pending = 1;
|
||||
}
|
||||
@@ -0,0 +1,75 @@
|
||||
/* ============================================================================
|
||||
* radio_stub.c -- bouclage memoire tenant lieu de transceiver 169 MHz.
|
||||
*
|
||||
* Une file circulaire de trames de taille fixe. Ce que vc_radio_send depose,
|
||||
* vc_radio_recv le rend : de quoi derouler un cycle complet emetteur/recepteur
|
||||
* dans un seul processus, sans materiel.
|
||||
*
|
||||
* Le stub expose en plus vc_radio_stub_set_clock, qui n'existe PAS dans
|
||||
* vc_radio.h : c'est un point de controle reserve aux tests, pour placer
|
||||
* artificiellement l'instant d'arrivee avant ou apres l'Heure Cible. La cible
|
||||
* STM32U5 n'aura pas cette fonction, et le code protocolaire ne l'appelle
|
||||
* jamais -- seul le harnais de test le fait.
|
||||
* ==========================================================================*/
|
||||
|
||||
#include "vc_radio.h"
|
||||
#include <string.h>
|
||||
|
||||
#define STUB_QUEUE_DEPTH 8
|
||||
|
||||
static uint8_t s_queue[STUB_QUEUE_DEPTH][VC_RADIO_MTU];
|
||||
static size_t s_len[STUB_QUEUE_DEPTH];
|
||||
static unsigned s_head, s_tail, s_count;
|
||||
static uint32_t s_clock_seconds;
|
||||
static uint32_t s_last_rx_seconds;
|
||||
|
||||
void vc_radio_init(void)
|
||||
{
|
||||
s_head = s_tail = s_count = 0;
|
||||
s_clock_seconds = 0;
|
||||
s_last_rx_seconds = 0;
|
||||
memset(s_queue, 0, sizeof s_queue);
|
||||
memset(s_len, 0, sizeof s_len);
|
||||
}
|
||||
|
||||
int vc_radio_send(const uint8_t *buf, size_t len)
|
||||
{
|
||||
if (len > VC_RADIO_MTU) return VC_HAL_EOVER;
|
||||
if (s_count == STUB_QUEUE_DEPTH) return VC_HAL_EIO; /* file pleine */
|
||||
|
||||
memcpy(s_queue[s_tail], buf, len);
|
||||
s_len[s_tail] = len;
|
||||
s_tail = (s_tail + 1) % STUB_QUEUE_DEPTH;
|
||||
s_count++;
|
||||
return VC_HAL_OK;
|
||||
}
|
||||
|
||||
int vc_radio_recv(uint8_t *buf, size_t maxlen)
|
||||
{
|
||||
size_t n;
|
||||
|
||||
if (s_count == 0) return VC_HAL_EMPTY;
|
||||
|
||||
n = s_len[s_head];
|
||||
if (n > maxlen) return VC_HAL_EOVER;
|
||||
|
||||
memcpy(buf, s_queue[s_head], n);
|
||||
s_head = (s_head + 1) % STUB_QUEUE_DEPTH;
|
||||
s_count--;
|
||||
|
||||
/* Sur cible, cet horodatage viendra d'un capture timer declenche par le
|
||||
* front de reception, pas d'une variable posee par le test. */
|
||||
s_last_rx_seconds = s_clock_seconds;
|
||||
return (int)n;
|
||||
}
|
||||
|
||||
uint32_t vc_radio_last_rx_seconds(void)
|
||||
{
|
||||
return s_last_rx_seconds;
|
||||
}
|
||||
|
||||
/* --- point de controle reserve au harnais de test ---------------------- */
|
||||
void vc_radio_stub_set_clock(uint32_t seconds_since_midnight)
|
||||
{
|
||||
s_clock_seconds = seconds_since_midnight;
|
||||
}
|
||||
@@ -0,0 +1,18 @@
|
||||
/* ============================================================================
|
||||
* vc_baro.h -- interface barometre.
|
||||
* INTERFACE PERENNE, voir l'en-tete de vc_radio.h. Stub C sur x86-64.
|
||||
* ==========================================================================*/
|
||||
#ifndef VC_BARO_H
|
||||
#define VC_BARO_H
|
||||
|
||||
#include <stdint.h>
|
||||
|
||||
void vc_baro_init(void);
|
||||
|
||||
/* Pression en pascals. Retourne VC_HAL_OK ou un code d'erreur. */
|
||||
int vc_baro_read_pressure(uint32_t *out_pa);
|
||||
|
||||
/* Temperature en centiemes de degre Celsius. */
|
||||
int vc_baro_read_temp(int32_t *out_centi_c);
|
||||
|
||||
#endif /* VC_BARO_H */
|
||||
@@ -0,0 +1,26 @@
|
||||
/* ============================================================================
|
||||
* vc_imu.h -- interface centrale inertielle (detection de chute).
|
||||
* INTERFACE PERENNE, voir l'en-tete de vc_radio.h. Stub C sur x86-64.
|
||||
* ==========================================================================*/
|
||||
#ifndef VC_IMU_H
|
||||
#define VC_IMU_H
|
||||
|
||||
#include <stdint.h>
|
||||
|
||||
/* Acceleration en milli-g sur les trois axes. */
|
||||
typedef struct {
|
||||
int16_t x;
|
||||
int16_t y;
|
||||
int16_t z;
|
||||
} vc_imu_accel_t;
|
||||
|
||||
void vc_imu_init(void);
|
||||
|
||||
/* Retourne VC_HAL_OK et remplit *out, ou un code d'erreur. */
|
||||
int vc_imu_read_accel(vc_imu_accel_t *out);
|
||||
|
||||
/* 1 si une chute a ete detectee depuis le dernier appel, 0 sinon.
|
||||
* L'algorithme de detection vit cote cible ; le stub le simule. */
|
||||
int vc_imu_fall_detected(void);
|
||||
|
||||
#endif /* VC_IMU_H */
|
||||
@@ -0,0 +1,41 @@
|
||||
/* ============================================================================
|
||||
* vc_radio.h -- interface radio 169 MHz.
|
||||
*
|
||||
* INTERFACE PERENNE : cette signature est le contrat que le portage STM32U5
|
||||
* devra honorer. L'implementation x86-64 (radio_stub.c) est un bouclage en
|
||||
* memoire ; l'implementation cible pilotera le transceiver reel. Aucun code
|
||||
* protocolaire ne doit changer entre les deux.
|
||||
*
|
||||
* Ces stubs sont en C, pas en assembleur, et deliberement : il n'y a aucun
|
||||
* peripherique a piloter sur x86-64, donc rien qu'un ASM apporterait ici -- ce
|
||||
* serait du code a maintenir pour zero benefice.
|
||||
* ==========================================================================*/
|
||||
#ifndef VC_RADIO_H
|
||||
#define VC_RADIO_H
|
||||
|
||||
#include <stdint.h>
|
||||
#include <stddef.h>
|
||||
|
||||
#define VC_RADIO_MTU 64 /* trame VERCORS a taille fixe */
|
||||
|
||||
/* Codes de retour communs a la HAL. */
|
||||
#define VC_HAL_OK 0
|
||||
#define VC_HAL_EMPTY (-1) /* rien a lire */
|
||||
#define VC_HAL_EOVER (-2) /* tampon appelant trop petit */
|
||||
#define VC_HAL_EIO (-3) /* echec materiel */
|
||||
|
||||
void vc_radio_init(void);
|
||||
|
||||
/* Emet len octets. Retourne VC_HAL_OK ou un code d'erreur. */
|
||||
int vc_radio_send(const uint8_t *buf, size_t len);
|
||||
|
||||
/* Lit au plus maxlen octets. Retourne le nombre d'octets lus (>= 0),
|
||||
* VC_HAL_EMPTY si rien n'est disponible, ou un code d'erreur. */
|
||||
int vc_radio_recv(uint8_t *buf, size_t maxlen);
|
||||
|
||||
/* Horodatage d'arrivee de la derniere trame lue, en secondes depuis minuit
|
||||
* UTC. C'est cette valeur que le gating temporel compare a l'Heure Cible.
|
||||
* Sur cible, elle viendra d'un capture timer, pas d'un appel systeme. */
|
||||
uint32_t vc_radio_last_rx_seconds(void);
|
||||
|
||||
#endif /* VC_RADIO_H */
|
||||
@@ -0,0 +1,89 @@
|
||||
; =============================================================================
|
||||
; abi.inc -- Abstraction de convention d'appel (System V AMD64 / Microsoft x64)
|
||||
;
|
||||
; VERCORS cible System V AMD64 (Linux). Cette machine de developpement n'a pas
|
||||
; de WSL installe : la seule chaine x86-64 executable nativement est
|
||||
; nasm -f win64 + MinGW gcc. Plutot que de figer une ABI et de ne pas pouvoir
|
||||
; executer les tests, tout le code ASM est ecrit dans un vocabulaire canonique
|
||||
; System V (arguments dans rdi, rsi, rdx, rcx) et ces macros font la traduction
|
||||
; a l'entree de fonction quand on assemble pour Win64.
|
||||
;
|
||||
; -f elf64 -> ABI_SYSV (defaut, cible de reference)
|
||||
; -f win64 -> ABI_WIN64 (passer -DABI_WIN64)
|
||||
;
|
||||
; PORTAGE Cortex-M33 : ce fichier est integralement x86-64-specifique et sera
|
||||
; remplace par un equivalent AAPCS (arguments dans r0-r3). Aucune logique
|
||||
; protocolaire n'y reside -- c'est de la pure plomberie d'appel.
|
||||
; =============================================================================
|
||||
|
||||
%ifndef VERCORS_ABI_INC
|
||||
%define VERCORS_ABI_INC
|
||||
|
||||
default rel
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; Section de donnees en lecture seule.
|
||||
; COFF nomme .rdata, ELF nomme .rodata.
|
||||
; -----------------------------------------------------------------------------
|
||||
%macro SECT_RODATA 0
|
||||
%ifdef ABI_WIN64
|
||||
section .rdata rdata align=64
|
||||
%else
|
||||
section .rodata align=64
|
||||
%endif
|
||||
%endmacro
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; VC_FUNC nom
|
||||
; Declare et ouvre une fonction globale. Sous ELF on marque le type function
|
||||
; pour que les outils de profilage voient une taille correcte.
|
||||
; -----------------------------------------------------------------------------
|
||||
%macro VC_FUNC 1
|
||||
%ifidn __OUTPUT_FORMAT__, elf64
|
||||
global %1:function
|
||||
%else
|
||||
global %1
|
||||
%endif
|
||||
%1:
|
||||
%endmacro
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; VC_ARGS
|
||||
; A placer en toute premiere instruction d'une fonction. Apres cette macro,
|
||||
; les 4 premiers arguments entiers sont TOUJOURS dans rdi, rsi, rdx, rcx,
|
||||
; quelle que soit l'ABI.
|
||||
;
|
||||
; Win64 passe dans rcx, rdx, r8, r9 et considere rdi/rsi comme callee-saved :
|
||||
; on les sauve avant de les ecraser. L'ordre des mov est choisi pour qu'aucun
|
||||
; argument ne soit detruit avant d'avoir ete recopie (rcx est lu en premier,
|
||||
; ecrase en dernier).
|
||||
;
|
||||
; Effet sur la pile : 2 push sous Win64, 0 sous SysV. VC_RET les depile.
|
||||
; -----------------------------------------------------------------------------
|
||||
%macro VC_ARGS 0
|
||||
%ifdef ABI_WIN64
|
||||
push rdi
|
||||
push rsi
|
||||
mov rdi, rcx ; arg1
|
||||
mov rsi, rdx ; arg2
|
||||
mov rdx, r8 ; arg3
|
||||
mov rcx, r9 ; arg4
|
||||
%define VC_ARGS_STACK 16
|
||||
%else
|
||||
%define VC_ARGS_STACK 0
|
||||
%endif
|
||||
%endmacro
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; VC_RET
|
||||
; Retour de fonction. Annule exactement ce que VC_ARGS a empile.
|
||||
; -----------------------------------------------------------------------------
|
||||
%macro VC_RET 0
|
||||
%ifdef ABI_WIN64
|
||||
pop rsi
|
||||
pop rdi
|
||||
%endif
|
||||
ret
|
||||
%endmacro
|
||||
|
||||
%endif ; VERCORS_ABI_INC
|
||||
@@ -0,0 +1,212 @@
|
||||
/* ============================================================================
|
||||
* vercors.h -- interface C du coeur VERCORS ecrit en assembleur x86-64.
|
||||
*
|
||||
* Toutes les fonctions declarees ici sont implementees en assembleur, dans le
|
||||
* repertoire asm. Il n'y a aucune implementation C de la cryptographie
|
||||
* (contrainte projet).
|
||||
*
|
||||
* Les dispositions de structures doivent rester synchronisees avec les
|
||||
* %define correspondants dans les fichiers .asm. Les _Static_assert en fin de
|
||||
* fichier cassent la compilation si l'un des deux derive.
|
||||
* ==========================================================================*/
|
||||
|
||||
#ifndef VERCORS_H
|
||||
#define VERCORS_H
|
||||
|
||||
#include <stdint.h>
|
||||
#include <stddef.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/* --------------------------------------------------------------------------
|
||||
* Constantes du protocole
|
||||
* ------------------------------------------------------------------------*/
|
||||
#define VC_DAY_SECONDS 86400u /* domaine de l'Heure Cible : 0..86399 */
|
||||
#define VC_FRAME_BYTES 64u /* taille fixe d'une trame sur l'air */
|
||||
#define VC_FRAME_MAXPAYLOAD 63u /* 64 - 1 octet de longueur */
|
||||
#define VC_KEY_BYTES 32u /* AES-256 */
|
||||
#define VC_CTR_BYTES 16u
|
||||
#define VC_GRAIN_BYTES 32u /* Grain de Sel Temporel */
|
||||
|
||||
/* --------------------------------------------------------------------------
|
||||
* SHA-256 (asm/sha256.asm)
|
||||
* ------------------------------------------------------------------------*/
|
||||
typedef struct {
|
||||
uint32_t state[8]; /* +0 */
|
||||
uint64_t bitlen; /* +32 */
|
||||
uint64_t buflen; /* +40 */
|
||||
uint8_t buf[64]; /* +48 */
|
||||
} vc_sha256_ctx; /* 112 */
|
||||
|
||||
void vc_sha256_init (vc_sha256_ctx *ctx);
|
||||
void vc_sha256_update(vc_sha256_ctx *ctx, const void *data, size_t len);
|
||||
void vc_sha256_final (vc_sha256_ctx *ctx, uint8_t out[32]);
|
||||
void vc_sha256 (const void *data, size_t len, uint8_t out[32]);
|
||||
|
||||
/* --------------------------------------------------------------------------
|
||||
* AES-256 (asm/aes256.asm) -- logiciel, pas AES-NI. Chiffrement seul : le
|
||||
* mode CTR n'a jamais besoin du dechiffrement de bloc. Voir docs/adr/0002.
|
||||
* ------------------------------------------------------------------------*/
|
||||
typedef struct {
|
||||
uint8_t rk[240]; /* 15 cles de ronde de 16 octets */
|
||||
} vc_aes_rk;
|
||||
|
||||
void vc_aes256_expand_key (const uint8_t key[32], vc_aes_rk *rk);
|
||||
void vc_aes256_encrypt_block(const vc_aes_rk *rk, const uint8_t in[16],
|
||||
uint8_t out[16]);
|
||||
/* XOR sur place avec le flot CTR ; ctr est avance et laisse a jour. */
|
||||
void vc_aes256_ctr_xor (const vc_aes_rk *rk, uint8_t ctr[16],
|
||||
uint8_t *inout, size_t len);
|
||||
|
||||
/* --------------------------------------------------------------------------
|
||||
* Primitives a temps constant (asm/const_time.asm)
|
||||
* Convention de masque : 0xFFFFFFFFFFFFFFFF = vrai, 0 = faux.
|
||||
* ------------------------------------------------------------------------*/
|
||||
uint32_t vc_ct_memcmp (const void *a, const void *b, size_t len);
|
||||
uint64_t vc_ct_mask_eq_u32(uint32_t a, uint32_t b);
|
||||
uint64_t vc_ct_mask_lt_u32(uint32_t a, uint32_t b);
|
||||
void vc_ct_cmov (void *dst, const void *src, size_t len,
|
||||
uint64_t mask);
|
||||
void vc_ct_memzero (void *p, size_t len);
|
||||
|
||||
/* --------------------------------------------------------------------------
|
||||
* CSPRNG maison (asm/csprng.asm)
|
||||
* Ne fabrique pas d'entropie : la graine vient de l'exterieur (TRNG sur
|
||||
* STM32U5, harnais de test sur x86-64).
|
||||
* ------------------------------------------------------------------------*/
|
||||
typedef struct {
|
||||
uint8_t V[32]; /* +0 */
|
||||
uint64_t C; /* +32 */
|
||||
uint64_t seeded; /* +40 */
|
||||
} vc_csprng_ctx; /* 48 */
|
||||
|
||||
void vc_csprng_seed (vc_csprng_ctx *ctx, const void *seed, size_t len);
|
||||
void vc_csprng_reseed(vc_csprng_ctx *ctx, const void *seed, size_t len);
|
||||
void vc_csprng_bytes (vc_csprng_ctx *ctx, void *out, size_t len);
|
||||
|
||||
/* --------------------------------------------------------------------------
|
||||
* Protocole VERCORS (asm/vercors_protocol.asm)
|
||||
*
|
||||
* Points [2] [4] [7] [8] : entierement specifies par le cahier des charges.
|
||||
* Les points [1] [3] [5] [6] sont plus bas, dans une section a part, car ils
|
||||
* reposent sur des hypotheses provisoires et non sur une specification.
|
||||
* ------------------------------------------------------------------------*/
|
||||
|
||||
/* [2] Heure Cible : SHA256(grain) -> 4 premiers octets big-endian -> methode
|
||||
* de rejet -> uniforme sur 0..86399. */
|
||||
uint32_t vc_derive_target_hour(const uint8_t *grain, size_t grain_len);
|
||||
|
||||
/* [4] Gating temporel, a appeler AVANT tout dechiffrement.
|
||||
* Retourne un masque tout-a-un si la trame est recevable. */
|
||||
uint64_t vc_gate_accept(uint32_t arrival_sec, uint32_t target_sec);
|
||||
|
||||
/* [7] Bourrage a taille fixe. Retourne 0, ou -1 si len > 63. */
|
||||
int vc_frame_pad (vc_csprng_ctx *rng, const uint8_t *payload, size_t len,
|
||||
uint8_t out[64]);
|
||||
/* Retourne 0, ou -1 si l'octet de longueur est incoherent. */
|
||||
int vc_frame_unpad(const uint8_t in[64], uint8_t *out, size_t *out_len);
|
||||
|
||||
/* ==========================================================================
|
||||
* Points [1] [3] [5] [6] -- asm/vercors_keysched.asm
|
||||
*
|
||||
* HYPOTHESES PROVISOIRES, A VALIDER AVANT TOUT DEPLOIEMENT REEL.
|
||||
* Le manifeste Gastinel Frame ne descend pas a ce niveau de detail. Voir
|
||||
* docs/adr/0007 a 0010 et la section correspondante du README.
|
||||
* ========================================================================*/
|
||||
|
||||
/* Separation de domaine des compteurs CTR. Sans elle, le creneau de cle et la
|
||||
* trame partageraient un flot de cle sous la meme cle du jour -- reutilisation
|
||||
* de flot, faute mortelle du mode CTR. */
|
||||
#define VC_CTR_DOMAIN_FRAME 0x00u
|
||||
#define VC_CTR_DOMAIN_KEYWRAP 0x01u
|
||||
|
||||
void vc_ctr_set_domain(uint8_t ctr[16], uint8_t domain);
|
||||
|
||||
/* --- [1] Grain de Sel Temporel ------------------------------------------
|
||||
* grain = SHA256( K_M(32) || BE16(semaine_ISO) || BE32(compteur_anti_rejeu) )
|
||||
* Ne transite jamais par la radio : chaque extremite le recalcule. */
|
||||
void vc_derive_grain(const uint8_t km[32], uint32_t week_iso,
|
||||
uint32_t replay_counter, uint8_t out[32]);
|
||||
|
||||
/* --- [6] Cle Maitresse d'Usine ------------------------------------------
|
||||
* PLACEHOLDER DE TEST sur ce prototype. Sur STM32U5, K_M vivra dans
|
||||
* l'element securise STSAFE-A110 et cette API par pointeur disparaitra. */
|
||||
const uint8_t *vc_factory_key(void);
|
||||
|
||||
/* --- [3] Fenetre de Garde Dynamique -------------------------------------- */
|
||||
typedef struct {
|
||||
uint32_t last_valid_sec; /* +0 instant du dernier paquet valide */
|
||||
int32_t clock_offset; /* +4 recalage memorise, non applique */
|
||||
uint32_t width; /* +8 demi-largeur courante (cache) */
|
||||
uint32_t flags; /* +12 bit 0 = deja synchronise */
|
||||
} vc_guard_ctx; /* 16 */
|
||||
|
||||
#define VC_GUARD_MIN_SECONDS 2u /* demi-largeur au repos (hypothese) */
|
||||
#define VC_GUARD_MAX_SECONDS 30u /* plafond fourni, a valider */
|
||||
#define VC_GUARD_DRIFT_PPM 20u /* derive quartz supposee */
|
||||
#define VC_COLDSTART_TIMEOUT 604800u /* 7 jours, periode du grain */
|
||||
|
||||
void vc_guard_init (vc_guard_ctx *g);
|
||||
/* Paquet valide : resserrement + memorisation du recalage (ref - local). */
|
||||
void vc_guard_on_valid (vc_guard_ctx *g, uint32_t local_sec,
|
||||
uint32_t ref_sec);
|
||||
/* Demi-largeur pour un temps ecoule donne : lineaire, plafonnee. */
|
||||
uint32_t vc_guard_width (uint32_t elapsed_sec);
|
||||
/* Demi-largeur courante, et mise a jour du cache. */
|
||||
uint32_t vc_guard_width_now(vc_guard_ctx *g, uint32_t now_sec);
|
||||
|
||||
/* [4] + [3] : gating avec tolerance. Seul le bord inferieur est relache --
|
||||
* le protocole prevoit que le message utile arrive APRES l'Heure Cible. */
|
||||
uint64_t vc_gate_accept_window(uint32_t arrival_sec, uint32_t target_sec,
|
||||
uint32_t width_sec);
|
||||
|
||||
/* --- [6] Cold Start ------------------------------------------------------ */
|
||||
int vc_coldstart_needed(const vc_guard_ctx *g, uint32_t now_sec);
|
||||
|
||||
/* --- [5] Bascule de cle asynchrone ---------------------------------------
|
||||
* La cle du jour suivant est chiffree sous la cle du JOUR COURANT (chainage
|
||||
* cle N+1 protegee par cle N), puis logee dans la zone de bourrage. Le creneau
|
||||
* etant du chiffre AES, il est indistinguable du bruit qui l'entoure, et la
|
||||
* trame reste a 64 octets avec ou sans bascule. */
|
||||
typedef struct {
|
||||
vc_csprng_ctx *rng; /* +0 */
|
||||
const uint8_t *payload; /* +8 */
|
||||
size_t payload_len;/* +16 */
|
||||
const uint8_t *next_key; /* +24 NULL = pas de bascule */
|
||||
const vc_aes_rk *day_rk; /* +32 cle du jour courant */
|
||||
const uint8_t *key_ctr; /* +40 domaine KEYWRAP */
|
||||
} vc_frame_req; /* 48 */
|
||||
|
||||
typedef struct {
|
||||
uint8_t payload[64]; /* +0 */
|
||||
size_t payload_len; /* +64 */
|
||||
uint64_t has_next_key; /* +72 */
|
||||
uint8_t next_key[32]; /* +80 */
|
||||
} vc_frame_out; /* 112 */
|
||||
|
||||
/* Longueurs utiles maximales : la bascule consomme les octets 32..63. */
|
||||
#define VC_FRAME_KEYSW_MAXPAYLOAD 31u
|
||||
|
||||
int vc_frame_build(const vc_frame_req *req, uint8_t out[64]);
|
||||
int vc_frame_parse(const uint8_t in[64], const vc_aes_rk *day_rk,
|
||||
const uint8_t *key_ctr, vc_frame_out *out);
|
||||
|
||||
/* --------------------------------------------------------------------------
|
||||
* Verrous de coherence ASM / C
|
||||
* ------------------------------------------------------------------------*/
|
||||
#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L
|
||||
_Static_assert(sizeof(vc_sha256_ctx) == 112, "vc_sha256_ctx != CTX_SIZE asm");
|
||||
_Static_assert(sizeof(vc_csprng_ctx) == 48, "vc_csprng_ctx != PRNG_SIZE asm");
|
||||
_Static_assert(sizeof(vc_aes_rk) == 240, "vc_aes_rk != AES_RK_BYTES asm");
|
||||
_Static_assert(sizeof(vc_guard_ctx) == 16, "vc_guard_ctx != GUARD_* asm");
|
||||
_Static_assert(sizeof(vc_frame_req) == 48, "vc_frame_req != REQ_* asm");
|
||||
_Static_assert(sizeof(vc_frame_out) == 112, "vc_frame_out != OUT_* asm");
|
||||
#endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* VERCORS_H */
|
||||
@@ -0,0 +1,660 @@
|
||||
/* ============================================================================
|
||||
* test_vercors.c -- harnais de validation du coeur VERCORS assembleur.
|
||||
*
|
||||
* Deux niveaux :
|
||||
* 1. vecteurs officiels sur les primitives (FIPS 180-4, FIPS 197,
|
||||
* NIST SP 800-38A) -- si ceux-la passent, l'assembleur est juste ;
|
||||
* 2. cycle protocolaire complet sur la radio bouclee.
|
||||
*
|
||||
* Le cycle demande par le prompt s'arrete a la bascule de cle : ce point [5]
|
||||
* n'est pas specifie sans le manifeste Gastinel Frame et n'a donc pas ete
|
||||
* devine. Le test le signale explicitement plutot que de le declarer reussi.
|
||||
* ==========================================================================*/
|
||||
|
||||
#include <stdio.h>
|
||||
#include <string.h>
|
||||
#include <stdlib.h>
|
||||
|
||||
#include "vercors.h"
|
||||
#include "vc_radio.h"
|
||||
#include "vc_imu.h"
|
||||
#include "vc_baro.h"
|
||||
|
||||
/* Points de controle exposes par les stubs, absents des interfaces perennes. */
|
||||
void vc_radio_stub_set_clock(uint32_t seconds_since_midnight);
|
||||
void vc_imu_stub_arm_fall(void);
|
||||
|
||||
static int g_fail;
|
||||
|
||||
static void ok(const char *name, int cond)
|
||||
{
|
||||
printf(" [%s] %s\n", cond ? "PASS" : "FAIL", name);
|
||||
if (!cond) g_fail++;
|
||||
}
|
||||
|
||||
static void from_hex(uint8_t *d, const char *h)
|
||||
{
|
||||
size_t n = strlen(h) / 2, i;
|
||||
for (i = 0; i < n; i++) {
|
||||
unsigned v;
|
||||
sscanf(h + 2 * i, "%2x", &v);
|
||||
d[i] = (uint8_t)v;
|
||||
}
|
||||
}
|
||||
|
||||
static int hex_is(const uint8_t *d, size_t n, const char *want)
|
||||
{
|
||||
char s[257];
|
||||
size_t i;
|
||||
for (i = 0; i < n; i++) sprintf(s + 2 * i, "%02x", d[i]);
|
||||
return strcmp(s, want) == 0;
|
||||
}
|
||||
|
||||
/* ==========================================================================
|
||||
* 1. Primitives
|
||||
* ========================================================================*/
|
||||
|
||||
static void test_sha256(void)
|
||||
{
|
||||
uint8_t out[32];
|
||||
char *big;
|
||||
|
||||
puts("\n-- SHA-256 (FIPS 180-4) --");
|
||||
|
||||
vc_sha256("", 0, out);
|
||||
ok("chaine vide", hex_is(out, 32,
|
||||
"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"));
|
||||
|
||||
vc_sha256("abc", 3, out);
|
||||
ok("abc", hex_is(out, 32,
|
||||
"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad"));
|
||||
|
||||
vc_sha256("abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq", 56, out);
|
||||
ok("448 bits (2 blocs)", hex_is(out, 32,
|
||||
"248d6a61d20638b8e5c026930c3e6039a33ce45964ff2167f6ecedd419db06c1"));
|
||||
|
||||
big = malloc(1000000);
|
||||
memset(big, 'a', 1000000);
|
||||
vc_sha256(big, 1000000, out);
|
||||
ok("1 million de 'a'", hex_is(out, 32,
|
||||
"cdc76e5c9914fb9281a1c7e284d73e67f1809a48a497200e046d39ccc7112cd0"));
|
||||
free(big);
|
||||
|
||||
/* Le chemin incremental doit donner le meme resultat que le one-shot :
|
||||
* c'est le code de bufferisation partielle qui est teste ici. */
|
||||
{
|
||||
vc_sha256_ctx c;
|
||||
uint8_t inc[32], one[32];
|
||||
const char *m = "Gastinel Frame / VERCORS / 169 MHz";
|
||||
size_t i, l = strlen(m);
|
||||
vc_sha256_init(&c);
|
||||
for (i = 0; i < l; i++) vc_sha256_update(&c, m + i, 1);
|
||||
vc_sha256_final(&c, inc);
|
||||
vc_sha256(m, l, one);
|
||||
ok("incremental == one-shot", memcmp(inc, one, 32) == 0);
|
||||
}
|
||||
}
|
||||
|
||||
static void test_aes256(void)
|
||||
{
|
||||
uint8_t k[32], b[64], ctr[16], p[37], c[37];
|
||||
vc_aes_rk rk;
|
||||
int i;
|
||||
|
||||
puts("\n-- AES-256 logiciel (FIPS 197 / SP 800-38A) --");
|
||||
|
||||
from_hex(k, "000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f");
|
||||
vc_aes256_expand_key(k, &rk);
|
||||
from_hex(b, "00112233445566778899aabbccddeeff");
|
||||
vc_aes256_encrypt_block(&rk, b, b);
|
||||
ok("FIPS 197 C.3 bloc", hex_is(b, 16, "8ea2b7ca516745bfeafc49904b496089"));
|
||||
|
||||
from_hex(k, "603deb1015ca71be2b73aef0857d77811f352c073b6108d72d9810a30914dff4");
|
||||
vc_aes256_expand_key(k, &rk);
|
||||
from_hex(ctr, "f0f1f2f3f4f5f6f7f8f9fafbfcfdfeff");
|
||||
from_hex(b, "6bc1bee22e409f96e93d7e117393172a"
|
||||
"ae2d8a571e03ac9c9eb76fac45af8e51"
|
||||
"30c81c46a35ce411e5fbc1191a0a52ef"
|
||||
"f69f2445df4f9b17ad2b417be66c3710");
|
||||
vc_aes256_ctr_xor(&rk, ctr, b, 64);
|
||||
ok("SP 800-38A F.5.5 CTR", hex_is(b, 64,
|
||||
"601ec313775789a5b7a7f504bbf3d228"
|
||||
"f443e3ca4d62b59aca84e990cacaf5c5"
|
||||
"2b0930daa23de94ce87017ba2d84988d"
|
||||
"dfc9c58db67aada613c2dd08457941a6"));
|
||||
|
||||
for (i = 0; i < 37; i++) p[i] = (uint8_t)(i * 7 + 1);
|
||||
memcpy(c, p, 37);
|
||||
from_hex(ctr, "f0f1f2f3f4f5f6f7f8f9fafbfcfdfeff");
|
||||
vc_aes256_ctr_xor(&rk, ctr, c, 37);
|
||||
from_hex(ctr, "f0f1f2f3f4f5f6f7f8f9fafbfcfdfeff");
|
||||
vc_aes256_ctr_xor(&rk, ctr, c, 37);
|
||||
ok("CTR aller-retour, longueur non alignee", memcmp(p, c, 37) == 0);
|
||||
|
||||
from_hex(ctr, "ffffffffffffffffffffffffffffffff");
|
||||
memset(b, 0, 16);
|
||||
vc_aes256_ctr_xor(&rk, ctr, b, 16);
|
||||
ok("compteur : propagation de retenue",
|
||||
hex_is(ctr, 16, "00000000000000000000000000000000"));
|
||||
}
|
||||
|
||||
static void test_const_time(void)
|
||||
{
|
||||
uint8_t a[32], b[32], d[8];
|
||||
|
||||
puts("\n-- Primitives a temps constant --");
|
||||
|
||||
memset(a, 0xA5, 32);
|
||||
memcpy(b, a, 32);
|
||||
ok("memcmp : zones egales", vc_ct_memcmp(a, b, 32) == 0);
|
||||
|
||||
b[31] ^= 0x01; /* difference sur le dernier octet */
|
||||
ok("memcmp : ecart en fin", vc_ct_memcmp(a, b, 32) == 1);
|
||||
memcpy(b, a, 32);
|
||||
b[0] ^= 0x80; /* difference sur le premier octet */
|
||||
ok("memcmp : ecart en tete", vc_ct_memcmp(a, b, 32) == 1);
|
||||
|
||||
ok("mask_eq vrai", vc_ct_mask_eq_u32(42, 42) == 0xFFFFFFFFFFFFFFFFull);
|
||||
ok("mask_eq faux", vc_ct_mask_eq_u32(42, 43) == 0);
|
||||
ok("mask_lt vrai", vc_ct_mask_lt_u32(41, 42) == 0xFFFFFFFFFFFFFFFFull);
|
||||
ok("mask_lt faux", vc_ct_mask_lt_u32(42, 42) == 0);
|
||||
/* Bornes non signees : 0xFFFFFFFF ne doit pas etre vu comme negatif. */
|
||||
ok("mask_lt non signe", vc_ct_mask_lt_u32(0xFFFFFFFFu, 1) == 0);
|
||||
|
||||
memset(d, 0x11, 8);
|
||||
vc_ct_cmov(d, "ABCDEFGH", 8, 0);
|
||||
ok("cmov masque nul : inchange", d[0] == 0x11 && d[7] == 0x11);
|
||||
vc_ct_cmov(d, "ABCDEFGH", 8, 0xFFFFFFFFFFFFFFFFull);
|
||||
ok("cmov masque plein : copie", memcmp(d, "ABCDEFGH", 8) == 0);
|
||||
|
||||
memset(a, 0xFF, 32);
|
||||
vc_ct_memzero(a, 32);
|
||||
{
|
||||
int i, z = 1;
|
||||
for (i = 0; i < 32; i++) if (a[i]) z = 0;
|
||||
ok("memzero", z);
|
||||
}
|
||||
}
|
||||
|
||||
static void test_csprng(void)
|
||||
{
|
||||
vc_csprng_ctx r1, r2;
|
||||
uint8_t o1[100], o2[100], o3[100];
|
||||
int i, zeros;
|
||||
|
||||
puts("\n-- CSPRNG maison (DRBG SHA-256) --");
|
||||
|
||||
vc_csprng_seed(&r1, "graine-de-test", 14);
|
||||
vc_csprng_seed(&r2, "graine-de-test", 14);
|
||||
vc_csprng_bytes(&r1, o1, 100);
|
||||
vc_csprng_bytes(&r2, o2, 100);
|
||||
ok("deterministe a graine egale", memcmp(o1, o2, 100) == 0);
|
||||
|
||||
vc_csprng_bytes(&r1, o3, 100);
|
||||
ok("blocs successifs differents", memcmp(o1, o3, 100) != 0);
|
||||
|
||||
vc_csprng_seed(&r2, "autre-graine", 12);
|
||||
vc_csprng_bytes(&r2, o2, 100);
|
||||
ok("graines differentes divergent", memcmp(o1, o2, 100) != 0);
|
||||
|
||||
/* 100 octets tous nuls signalerait un generateur mort. */
|
||||
for (i = 0, zeros = 0; i < 100; i++) if (o1[i] == 0) zeros++;
|
||||
ok("sortie non degeneree", zeros < 10);
|
||||
|
||||
/* Le decoupage en blocs de 32 ne doit pas creer de discontinuite : une
|
||||
* demande de 100 octets doit prefixer une demande de 40. */
|
||||
vc_csprng_seed(&r1, "coupe", 5);
|
||||
vc_csprng_bytes(&r1, o1, 100);
|
||||
vc_csprng_seed(&r2, "coupe", 5);
|
||||
vc_csprng_bytes(&r2, o2, 40);
|
||||
ok("prefixe coherent (40 sur 100)", memcmp(o1, o2, 40) == 0);
|
||||
}
|
||||
|
||||
/* ==========================================================================
|
||||
* 2. Heure Cible [2]
|
||||
* ========================================================================*/
|
||||
|
||||
static void test_target_hour(void)
|
||||
{
|
||||
uint8_t grain[32];
|
||||
uint32_t h, h2;
|
||||
int i;
|
||||
unsigned long buckets[24];
|
||||
int all_in_range = 1, any_bucket_empty = 0;
|
||||
|
||||
puts("\n-- [2] Heure Cible --");
|
||||
|
||||
memset(grain, 0, 32);
|
||||
h = vc_derive_target_hour(grain, 32);
|
||||
h2 = vc_derive_target_hour(grain, 32);
|
||||
ok("deterministe : meme grain, meme heure", h == h2);
|
||||
ok("dans 0..86399", h < VC_DAY_SECONDS);
|
||||
|
||||
/* Vecteurs de reference calcules independamment de l'assembleur.
|
||||
* Grain de 32 zeros : SHA256 = 66687aad..., x = 0x66687aad = 1718123181,
|
||||
* inferieur au seuil de rejet donc accepte au premier tirage,
|
||||
* 1718123181 mod 86400 = 59181.
|
||||
* Grain de 32 octets 0xff : meme procedure, 40182.
|
||||
* Ces deux valeurs figent a la fois la lecture big-endian des 4 premiers
|
||||
* octets et la reduction modulo : tout implementeur d'une autre extremite
|
||||
* doit retrouver exactement ces nombres. */
|
||||
ok("vecteur de reference : grain nul", h == 59181u);
|
||||
{
|
||||
uint8_t gf[32];
|
||||
memset(gf, 0xff, 32);
|
||||
ok("vecteur de reference : grain 0xff",
|
||||
vc_derive_target_hour(gf, 32) == 40182u);
|
||||
}
|
||||
|
||||
/* Deux grains voisins doivent donner des heures sans rapport. */
|
||||
grain[0] = 1;
|
||||
ok("sensibilite au grain", vc_derive_target_hour(grain, 32) != h);
|
||||
|
||||
/* Repartition : 4096 grains sur 24 tranches horaires. Avec un modulo nu,
|
||||
* le biais serait de l'ordre de 5e-6, invisible ici -- ce test ne prouve
|
||||
* donc pas l'absence de biais, il detecte un generateur franchement casse
|
||||
* (heures concentrees, tranches vides). L'absence de biais tient a la
|
||||
* methode de rejet, qui est verifiee par construction dans le code. */
|
||||
memset(buckets, 0, sizeof buckets);
|
||||
for (i = 0; i < 4096; i++) {
|
||||
uint8_t g[32];
|
||||
memset(g, 0, 32);
|
||||
g[0] = (uint8_t)(i & 0xFF);
|
||||
g[1] = (uint8_t)(i >> 8);
|
||||
{
|
||||
uint32_t t = vc_derive_target_hour(g, 32);
|
||||
if (t >= VC_DAY_SECONDS) all_in_range = 0;
|
||||
buckets[t / 3600]++;
|
||||
}
|
||||
}
|
||||
for (i = 0; i < 24; i++) if (buckets[i] == 0) any_bucket_empty = 1;
|
||||
ok("4096 tirages tous dans le domaine", all_in_range);
|
||||
ok("les 24 tranches horaires sont couvertes", !any_bucket_empty);
|
||||
}
|
||||
|
||||
/* ==========================================================================
|
||||
* 3. Trame : bourrage [7] et chiffrement [8]
|
||||
* ========================================================================*/
|
||||
|
||||
static void test_frame(void)
|
||||
{
|
||||
vc_csprng_ctx rng;
|
||||
uint8_t f1[64], f2[64], out[64];
|
||||
size_t n;
|
||||
const char *msg = "ALT1483 T+4.2 BAT87";
|
||||
int i, zeros;
|
||||
|
||||
puts("\n-- [7] Bourrage a taille fixe / [8] chiffrement --");
|
||||
|
||||
vc_csprng_seed(&rng, "graine-trame", 12);
|
||||
|
||||
ok("charge trop longue refusee",
|
||||
vc_frame_pad(&rng, (const uint8_t *)msg, 64, f1) == -1);
|
||||
|
||||
ok("bourrage accepte",
|
||||
vc_frame_pad(&rng, (const uint8_t *)msg, strlen(msg), f1) == 0);
|
||||
|
||||
ok("aller-retour bourrage", vc_frame_unpad(f1, out, &n) == 0
|
||||
&& n == strlen(msg)
|
||||
&& memcmp(out, msg, n) == 0);
|
||||
|
||||
/* Le remplissage doit etre du bruit, pas des zeros : sous CTR, une queue
|
||||
* de zeros exposerait le flot de cle en clair. */
|
||||
for (i = (int)strlen(msg) + 1, zeros = 0; i < 64; i++)
|
||||
if (f1[i] == 0) zeros++;
|
||||
ok("remplissage non nul", zeros < 4);
|
||||
|
||||
/* Deux trames de meme contenu doivent differer : le bourrage varie. */
|
||||
vc_frame_pad(&rng, (const uint8_t *)msg, strlen(msg), f2);
|
||||
ok("deux trames identiques different par le bruit",
|
||||
memcmp(f1, f2, 64) != 0);
|
||||
|
||||
/* Chiffrement CTR d'une trame complete, puis dechiffrement. */
|
||||
{
|
||||
uint8_t key[32], ctr[16], ctr_save[16], cipher[64];
|
||||
vc_aes_rk rk;
|
||||
|
||||
vc_csprng_bytes(&rng, key, 32);
|
||||
vc_csprng_bytes(&rng, ctr, 16);
|
||||
memcpy(ctr_save, ctr, 16);
|
||||
vc_aes256_expand_key(key, &rk);
|
||||
|
||||
memcpy(cipher, f1, 64);
|
||||
vc_aes256_ctr_xor(&rk, ctr, cipher, 64);
|
||||
ok("le chiffre differe du clair", memcmp(cipher, f1, 64) != 0);
|
||||
|
||||
memcpy(ctr, ctr_save, 16);
|
||||
vc_aes256_ctr_xor(&rk, ctr, cipher, 64);
|
||||
ok("dechiffrement restitue la trame", memcmp(cipher, f1, 64) == 0);
|
||||
}
|
||||
}
|
||||
|
||||
/* ==========================================================================
|
||||
* 4. Cycle complet sur radio bouclee : gating temporel [4]
|
||||
* ========================================================================*/
|
||||
|
||||
static void test_full_cycle(void)
|
||||
{
|
||||
vc_csprng_ctx rng;
|
||||
vc_aes_rk rk;
|
||||
uint8_t grain[32], key[32], ctr[16], ctr_tx[16];
|
||||
uint8_t frame[64], rx[64], plain[64];
|
||||
uint32_t target, arrival;
|
||||
size_t n;
|
||||
const char *msg = "ALT1483 T+4.2 BAT87";
|
||||
int aes_calls_avoided;
|
||||
|
||||
puts("\n-- Cycle complet : grain -> heure cible -> gating -> trame --");
|
||||
|
||||
vc_radio_init();
|
||||
vc_imu_init();
|
||||
vc_baro_init();
|
||||
|
||||
/* [1] Le Grain de Sel est ici FOURNI, pas derive : sa generation isolee
|
||||
* hebdomadaire n'est pas specifiee sans le manifeste. Les deux
|
||||
* extremites partagent donc simplement le meme tableau. */
|
||||
vc_csprng_seed(&rng, "semaine-2026-36", 15);
|
||||
vc_csprng_bytes(&rng, grain, 32);
|
||||
|
||||
/* [2] Chaque cote calcule l'Heure Cible de son cote, sans rien emettre. */
|
||||
target = vc_derive_target_hour(grain, 32);
|
||||
printf(" Heure Cible = %u s (%02u:%02u:%02u)\n",
|
||||
target, target / 3600, (target / 60) % 60, target % 60);
|
||||
ok("heure cible dans la journee", target < VC_DAY_SECONDS);
|
||||
|
||||
vc_csprng_bytes(&rng, key, 32);
|
||||
vc_csprng_bytes(&rng, ctr, 16);
|
||||
vc_aes256_expand_key(key, &rk);
|
||||
|
||||
/* --- emission --- */
|
||||
vc_frame_pad(&rng, (const uint8_t *)msg, strlen(msg), frame);
|
||||
memcpy(ctr_tx, ctr, 16);
|
||||
{
|
||||
uint8_t on_air[64];
|
||||
memcpy(on_air, frame, 64);
|
||||
vc_aes256_ctr_xor(&rk, ctr_tx, on_air, 64);
|
||||
ok("emission", vc_radio_send(on_air, 64) == VC_HAL_OK);
|
||||
}
|
||||
|
||||
/* --- reception AVANT l'Heure Cible : rejet attendu, sans AES --- */
|
||||
aes_calls_avoided = 0;
|
||||
arrival = (target == 0) ? 0 : target - 1;
|
||||
vc_radio_stub_set_clock(arrival);
|
||||
ok("trame recue", vc_radio_recv(rx, sizeof rx) == 64);
|
||||
|
||||
if (target > 0) {
|
||||
uint64_t accept = vc_gate_accept(vc_radio_last_rx_seconds(), target);
|
||||
ok("gating : trame trop tot rejetee", accept == 0);
|
||||
if (accept == 0) aes_calls_avoided++; /* AES n'est pas lance */
|
||||
ok("aucun dechiffrement tente avant l'heure cible",
|
||||
aes_calls_avoided == 1);
|
||||
} else {
|
||||
puts(" [SKIP] heure cible a 0 s, pas d'instant anterieur a tester");
|
||||
}
|
||||
|
||||
/* --- reception APRES l'Heure Cible : acceptation et dechiffrement --- */
|
||||
{
|
||||
uint8_t on_air[64];
|
||||
uint8_t ctr_rx[16];
|
||||
|
||||
memcpy(on_air, frame, 64);
|
||||
memcpy(ctr_tx, ctr, 16);
|
||||
vc_aes256_ctr_xor(&rk, ctr_tx, on_air, 64);
|
||||
vc_radio_send(on_air, 64);
|
||||
|
||||
arrival = target + 30;
|
||||
if (arrival >= VC_DAY_SECONDS) arrival = VC_DAY_SECONDS - 1;
|
||||
vc_radio_stub_set_clock(arrival);
|
||||
vc_radio_recv(rx, sizeof rx);
|
||||
|
||||
ok("gating : trame a l'heure acceptee",
|
||||
vc_gate_accept(vc_radio_last_rx_seconds(), target)
|
||||
== 0xFFFFFFFFFFFFFFFFull);
|
||||
|
||||
memcpy(ctr_rx, ctr, 16);
|
||||
memcpy(plain, rx, 64);
|
||||
vc_aes256_ctr_xor(&rk, ctr_rx, plain, 64);
|
||||
|
||||
ok("dechiffrement puis retrait du bourrage",
|
||||
vc_frame_unpad(plain, (uint8_t *)rx, &n) == 0
|
||||
&& n == strlen(msg)
|
||||
&& memcmp(rx, msg, n) == 0);
|
||||
}
|
||||
|
||||
/* [5] est couvert par sa propre suite de tests, plus bas. */
|
||||
|
||||
/* HAL : verification que les stubs repondent au contrat. */
|
||||
{
|
||||
vc_imu_accel_t a;
|
||||
uint32_t pa;
|
||||
int32_t t;
|
||||
ok("HAL IMU", vc_imu_read_accel(&a) == VC_HAL_OK && a.z == 1000);
|
||||
vc_imu_stub_arm_fall();
|
||||
ok("HAL IMU drapeau de chute",
|
||||
vc_imu_fall_detected() == 1 && vc_imu_fall_detected() == 0);
|
||||
ok("HAL barometre", vc_baro_read_pressure(&pa) == VC_HAL_OK
|
||||
&& vc_baro_read_temp(&t) == VC_HAL_OK
|
||||
&& pa > 50000 && pa < 110000);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/* ==========================================================================
|
||||
* 5. Points [1] [3] [5] [6] -- hypotheses provisoires
|
||||
* ========================================================================*/
|
||||
|
||||
static void test_grain(void)
|
||||
{
|
||||
uint8_t g1[32], g2[32], g3[32];
|
||||
const uint8_t *km = vc_factory_key();
|
||||
|
||||
puts("\n-- [1] Grain de Sel Temporel (hypothese) --");
|
||||
|
||||
/* La cle de test doit crier ce qu'elle est. */
|
||||
ok("K_M de test explicitement marquee", memcmp(km, "PLACEHOLDER", 11) == 0);
|
||||
|
||||
/* Les deux extremites, partageant K_M et la semaine, derivent le meme
|
||||
* grain sans rien echanger : propriete centrale du protocole. */
|
||||
vc_derive_grain(km, 36, 0, g1);
|
||||
vc_derive_grain(km, 36, 0, g2);
|
||||
ok("derivation isolee : deux cotes, meme grain", memcmp(g1, g2, 32) == 0);
|
||||
|
||||
vc_derive_grain(km, 37, 0, g3);
|
||||
ok("semaine differente -> grain different", memcmp(g1, g3, 32) != 0);
|
||||
|
||||
vc_derive_grain(km, 36, 1, g3);
|
||||
ok("compteur anti-rejeu different -> grain different", memcmp(g1, g3, 32) != 0);
|
||||
|
||||
{
|
||||
uint8_t km2[32];
|
||||
memcpy(km2, km, 32);
|
||||
km2[0] ^= 0x01;
|
||||
vc_derive_grain(km2, 36, 0, g3);
|
||||
ok("K_M differente -> grain different", memcmp(g1, g3, 32) != 0);
|
||||
}
|
||||
|
||||
/* Vecteur de reference : fige l'encodage BE16 de la semaine et BE32 du
|
||||
* compteur. Toute autre implementation doit retrouver ce grain. */
|
||||
{
|
||||
vc_sha256_ctx c;
|
||||
uint8_t ref[32], tail[6];
|
||||
tail[0] = 0; tail[1] = 36;
|
||||
tail[2] = 0; tail[3] = 0; tail[4] = 0; tail[5] = 7;
|
||||
vc_sha256_init(&c);
|
||||
vc_sha256_update(&c, km, 32);
|
||||
vc_sha256_update(&c, tail, 6);
|
||||
vc_sha256_final(&c, ref);
|
||||
vc_derive_grain(km, 36, 7, g1);
|
||||
ok("encodage conforme (BE16 semaine, BE32 compteur)",
|
||||
memcmp(g1, ref, 32) == 0);
|
||||
}
|
||||
}
|
||||
|
||||
static void test_guard(void)
|
||||
{
|
||||
vc_guard_ctx g;
|
||||
|
||||
puts("\n-- [3] Fenetre de Garde Dynamique (hypothese) --");
|
||||
|
||||
ok("largeur au repos", vc_guard_width(0) == VC_GUARD_MIN_SECONDS);
|
||||
|
||||
/* Croissance lineaire calee sur la derive du quartz : 20 ppm, soit
|
||||
* environ 1,73 s par jour, tronque a 1 s en arithmetique entiere. */
|
||||
ok("elargissement apres un jour", vc_guard_width(86400) == 3);
|
||||
ok("monotone", vc_guard_width(3600) <= vc_guard_width(7200));
|
||||
|
||||
/* Le plafond doit tenir meme apres un silence de plusieurs jours, sinon
|
||||
* le gating temporel finirait par ne plus rien filtrer. */
|
||||
ok("plafonnee a 30 jours de silence",
|
||||
vc_guard_width(30u * 86400u) == VC_GUARD_MAX_SECONDS);
|
||||
ok("plafonnee a 10 ans de silence",
|
||||
vc_guard_width(3650u * 86400u) == VC_GUARD_MAX_SECONDS);
|
||||
|
||||
vc_guard_init(&g);
|
||||
g.last_valid_sec = 0;
|
||||
ok("fenetre large avant resynchro",
|
||||
vc_guard_width_now(&g, 20u * 86400u) == VC_GUARD_MAX_SECONDS);
|
||||
vc_guard_on_valid(&g, 20u * 86400u, 20u * 86400u + 5u);
|
||||
ok("resserrement immediat des reception valide",
|
||||
vc_guard_width_now(&g, 20u * 86400u) == VC_GUARD_MIN_SECONDS);
|
||||
ok("recalage d'horloge memorise", g.clock_offset == 5);
|
||||
ok("horloge en arriere bornee",
|
||||
vc_guard_width_now(&g, 20u * 86400u - 100u) == VC_GUARD_MIN_SECONDS);
|
||||
|
||||
/* Gating avec tolerance : seul le bord inferieur est relache. */
|
||||
ok("trop tot au-dela de la tolerance : rejete",
|
||||
vc_gate_accept_window(1000, 1100, 30) == 0);
|
||||
ok("un peu tot mais dans la tolerance : accepte",
|
||||
vc_gate_accept_window(1080, 1100, 30) == 0xFFFFFFFFFFFFFFFFull);
|
||||
ok("apres l'heure cible : accepte",
|
||||
vc_gate_accept_window(5000, 1100, 30) == 0xFFFFFFFFFFFFFFFFull);
|
||||
/* Heure Cible proche de minuit : target - width doit saturer a zero, pas
|
||||
* boucler vers quatre milliards. */
|
||||
ok("saturation a zero pres de minuit",
|
||||
vc_gate_accept_window(5, 10, 30) == 0xFFFFFFFFFFFFFFFFull);
|
||||
}
|
||||
|
||||
static void test_coldstart(void)
|
||||
{
|
||||
vc_guard_ctx g;
|
||||
|
||||
puts("\n-- [6] Cold Start (hypothese) --");
|
||||
|
||||
vc_guard_init(&g);
|
||||
ok("apres reboot : resynchro exigee", vc_coldstart_needed(&g, 0) == 1);
|
||||
|
||||
vc_guard_on_valid(&g, 1000, 1000);
|
||||
ok("apres un paquet valide : pas de resynchro",
|
||||
vc_coldstart_needed(&g, 1000) == 0);
|
||||
ok("silence de 6 jours : pas encore",
|
||||
vc_coldstart_needed(&g, 1000 + 6u * 86400u) == 0);
|
||||
ok("silence de 7 jours : resynchro exigee",
|
||||
vc_coldstart_needed(&g, 1000 + 7u * 86400u) == 1);
|
||||
}
|
||||
|
||||
static void test_key_switch(void)
|
||||
{
|
||||
vc_csprng_ctx rng;
|
||||
vc_aes_rk day_rk;
|
||||
vc_frame_req req;
|
||||
vc_frame_out out;
|
||||
uint8_t day_key[32], next_key[32], key_ctr[16], frame[64], frame2[64];
|
||||
const char *msg = "RELEVE 12H";
|
||||
int i, zeros;
|
||||
|
||||
puts("\n-- [5] Bascule de cle steganographique (hypothese) --");
|
||||
|
||||
vc_csprng_seed(&rng, "graine-bascule", 14);
|
||||
vc_csprng_bytes(&rng, day_key, 32);
|
||||
vc_csprng_bytes(&rng, next_key, 32);
|
||||
vc_csprng_bytes(&rng, key_ctr, 16);
|
||||
vc_ctr_set_domain(key_ctr, VC_CTR_DOMAIN_KEYWRAP);
|
||||
vc_aes256_expand_key(day_key, &day_rk);
|
||||
|
||||
memset(&req, 0, sizeof req);
|
||||
req.rng = &rng;
|
||||
req.payload = (const uint8_t *)msg;
|
||||
req.payload_len = strlen(msg);
|
||||
req.next_key = next_key;
|
||||
req.day_rk = &day_rk;
|
||||
req.key_ctr = key_ctr;
|
||||
|
||||
ok("trame avec bascule construite", vc_frame_build(&req, frame) == 0);
|
||||
|
||||
/* La cle N+1 est chiffree sous la cle du jour avant d'etre logee : elle ne
|
||||
* doit pas apparaitre en clair, meme avant le chiffrement de la trame. */
|
||||
ok("cle N+1 absente en clair de la trame",
|
||||
memcmp(frame + 32, next_key, 32) != 0);
|
||||
|
||||
ok("lecture de la trame",
|
||||
vc_frame_parse(frame, &day_rk, key_ctr, &out) == 0);
|
||||
ok("bascule signalee", out.has_next_key == 1);
|
||||
ok("charge utile intacte", out.payload_len == strlen(msg)
|
||||
&& memcmp(out.payload, msg, out.payload_len) == 0);
|
||||
ok("cle N+1 restituee", memcmp(out.next_key, next_key, 32) == 0);
|
||||
|
||||
req.next_key = NULL;
|
||||
ok("trame sans bascule construite", vc_frame_build(&req, frame2) == 0);
|
||||
ok("meme taille avec et sans bascule", sizeof frame == sizeof frame2);
|
||||
ok("drapeau absent sans bascule", (frame2[0] & 0x80) == 0);
|
||||
ok("lecture sans bascule",
|
||||
vc_frame_parse(frame2, &day_rk, key_ctr, &out) == 0
|
||||
&& out.has_next_key == 0 && out.payload_len == strlen(msg));
|
||||
|
||||
for (i = (int)strlen(msg) + 1, zeros = 0; i < 32; i++)
|
||||
if (frame[i] == 0) zeros++;
|
||||
ok("bourrage residuel non nul", zeros < 4);
|
||||
|
||||
/* Budget : la bascule consomme les octets 32 a 63. */
|
||||
req.next_key = next_key;
|
||||
req.payload_len = VC_FRAME_KEYSW_MAXPAYLOAD + 1;
|
||||
ok("charge trop longue avec bascule refusee",
|
||||
vc_frame_build(&req, frame) == -1);
|
||||
req.payload_len = VC_FRAME_KEYSW_MAXPAYLOAD;
|
||||
ok("charge maximale avec bascule acceptee",
|
||||
vc_frame_build(&req, frame) == 0);
|
||||
|
||||
/* Separation de domaine : creneau de cle et trame ne doivent jamais
|
||||
* partager un flot de cle sous la meme cle du jour. */
|
||||
{
|
||||
uint8_t frame_ctr[16];
|
||||
memcpy(frame_ctr, key_ctr, 16);
|
||||
vc_ctr_set_domain(frame_ctr, VC_CTR_DOMAIN_FRAME);
|
||||
ok("domaines de compteur distincts",
|
||||
memcmp(frame_ctr, key_ctr, 16) != 0
|
||||
&& frame_ctr[0] == 0x00 && key_ctr[0] == 0x01);
|
||||
}
|
||||
}
|
||||
|
||||
/* ========================================================================*/
|
||||
|
||||
int main(void)
|
||||
{
|
||||
puts("=========================================");
|
||||
puts(" VERCORS -- validation du coeur x86-64");
|
||||
puts("=========================================");
|
||||
|
||||
test_sha256();
|
||||
test_aes256();
|
||||
test_const_time();
|
||||
test_csprng();
|
||||
test_target_hour();
|
||||
test_frame();
|
||||
test_full_cycle();
|
||||
test_grain();
|
||||
test_guard();
|
||||
test_coldstart();
|
||||
test_key_switch();
|
||||
|
||||
puts("\n=========================================");
|
||||
if (g_fail == 0) {
|
||||
puts(" RESULTAT : tous les tests passent");
|
||||
puts(" Points [1] [3] [5] [6] : implementes sur HYPOTHESES");
|
||||
puts(" provisoires -- a valider avant deploiement reel.");
|
||||
puts(" Point ouvert : aucune authentification de trame.");
|
||||
} else {
|
||||
printf(" RESULTAT : %d echec(s)\n", g_fail);
|
||||
}
|
||||
puts("=========================================");
|
||||
return g_fail != 0;
|
||||
}
|
||||
@@ -0,0 +1,129 @@
|
||||
# Changelog
|
||||
|
||||
Format inspiré de [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/).
|
||||
|
||||
> **Note de convention.** Le cahier des charges demandait un CHANGELOG et des
|
||||
> ADR « cohérents avec les conventions déjà en place sur `server-infra` ».
|
||||
> Vérification faite, `server-infra` ne contient ni CHANGELOG ni répertoire
|
||||
> d'ADR. Ce fichier adopte donc Keep a Changelog, et les ADR le format MADR
|
||||
> numéroté. À réaligner si une convention maison existe ailleurs.
|
||||
|
||||
## [0.2.0] — 2026-09-02
|
||||
|
||||
Points [1], [3], [5] et [6] implémentés — **sur hypothèses, pas sur
|
||||
spécification**. Le manifeste Gastinel Frame ne descend pas à ce niveau de
|
||||
détail ; chaque ADR concerné porte le statut *hypothèse provisoire, à valider
|
||||
avant tout déploiement réel*.
|
||||
|
||||
### Ajouté
|
||||
|
||||
- `asm/vercors_keysched.asm` — les quatre points :
|
||||
- **[1]** `vc_derive_grain` : `SHA256(K_M ‖ BE16(semaine ISO) ‖ BE32(compteur
|
||||
anti-rejeu))`. Le grain ne transite jamais par la radio.
|
||||
- **[3]** Fenêtre de Garde Dynamique : élargissement linéaire calé sur la
|
||||
dérive du quartz (20 ppm), plafonné à 30 s, resserrement immédiat et
|
||||
recalage d'horloge sur paquet valide. `vc_gate_accept_window` relâche le
|
||||
bord inférieur sans branchement.
|
||||
- **[5]** Bascule de clé : chaînage, la clé N+1 est chiffrée **sous la clé du
|
||||
jour courant** avant d'être logée dans le bourrage. Drapeau en bit 7 de
|
||||
l'octet d'en-tête, créneau en octets 32–63.
|
||||
- **[6]** `vc_coldstart_needed` : déclenchement local sur reboot ou 7 jours
|
||||
sans paquet valide.
|
||||
- `asm/factory_key.asm` — placeholder de K_M, `PLACEHOLDER-NE-PAS-UTILISER-PROD`
|
||||
en ASCII lisible. **Ne pas utiliser en production.**
|
||||
- `vc_ctr_set_domain` et les constantes `VC_CTR_DOMAIN_FRAME` /
|
||||
`VC_CTR_DOMAIN_KEYWRAP` — séparation de domaine des compteurs CTR, sans
|
||||
laquelle le créneau de clé et la trame partageraient un flot de clé.
|
||||
- `vc_frame_build` / `vc_frame_parse` — construction et lecture de trame avec
|
||||
bascule optionnelle, passage par structure pour éviter le cinquième argument
|
||||
sur la pile sous ABI Microsoft.
|
||||
- 42 tests supplémentaires (86 au total) : vecteur de référence d'encodage du
|
||||
grain, plafonnement de la fenêtre à 10 ans de silence, horloge qui recule,
|
||||
saturation près de minuit, absence de la clé en clair, budget de charge utile
|
||||
en mode bascule, distinction des domaines de compteur.
|
||||
- ADR 0007 à 0010, tous marqués *hypothèse provisoire*.
|
||||
|
||||
### Modifié
|
||||
|
||||
- ADR 0006 reformulé : l'en-tête de trame porte désormais un drapeau de bascule
|
||||
en bit 7, et le fait que **l'en-tête soit à l'intérieur du chiffré** est
|
||||
affirmé explicitement plutôt que laissé déductible.
|
||||
|
||||
### Confirmé
|
||||
|
||||
- **L'octet de longueur ne circule pas en clair.** La trame de 64 octets est
|
||||
construite en clair puis chiffrée **en entier** en AES-256-CTR. Ni la
|
||||
longueur ni le drapeau ne sont observables sur l'air, et toutes les trames
|
||||
font 64 octets quel que soit leur contenu. Aucune correction n'était requise.
|
||||
- Big-endian sur les 4 premiers octets du condensat (Heure Cible) : conservé.
|
||||
|
||||
### Points ouverts
|
||||
|
||||
- **Aucune authentification de trame.** Aggravé par la bascule de clé : sans
|
||||
MAC, un seul bit retourné dans le créneau de clé désynchronise durablement
|
||||
les deux extrémités. Voir ADR 0003 et 0009.
|
||||
- **L'époque d'origine des semaines n'est pas définie** (ADR 0007). Deux
|
||||
implémentations partant d'origines différentes ne se parleront jamais, sans
|
||||
erreur visible.
|
||||
- **Contenu de l'échange de resynchronisation** Cold Start : seul le
|
||||
déclencheur est implémenté, pas le dialogue (ADR 0010).
|
||||
|
||||
### TODO portage
|
||||
|
||||
- `asm/factory_key.asm` disparaît : K_M passe dans l'élément sécurisé
|
||||
**STSAFE-A110**. Changement de forme d'API, pas simple remplacement de
|
||||
constante — les octets de la clé ne doivent jamais transiter par la RAM du
|
||||
STM32U5. Voir ADR 0010.
|
||||
|
||||
## [0.1.0] — 2026-09-02
|
||||
|
||||
Première passe : cœur cryptographique et sous-ensemble protocolaire, en
|
||||
assembleur x86-64 pur.
|
||||
|
||||
### Ajouté
|
||||
|
||||
- `asm/sha256.asm` — SHA-256 complet (FIPS 180-4), API incrémentale et
|
||||
one-shot. Validé sur 4 vecteurs officiels dont le message de 1 Mo.
|
||||
- `asm/aes256.asm` — AES-256 logiciel, chiffrement de bloc et mode CTR. Validé
|
||||
sur FIPS 197 C.3 et NIST SP 800-38A F.5.5.
|
||||
- `asm/const_time.asm` — `memcmp`, masques d'égalité et d'infériorité,
|
||||
déplacement conditionnel et effacement, tous à temps constant.
|
||||
- `asm/csprng.asm` — DRBG maison à base de SHA-256, avec résistance au retour
|
||||
en arrière.
|
||||
- `asm/vercors_protocol.asm` — Heure Cible [2] avec méthode de rejet, gating
|
||||
temporel [4], bourrage à taille fixe [7].
|
||||
- `include/abi.inc` — abstraction de convention d'appel System V / Microsoft
|
||||
x64, permettant d'assembler les mêmes sources pour les deux cibles.
|
||||
- `include/vercors.h` — interface C, avec verrous `_Static_assert` sur les
|
||||
tailles de structures partagées avec l'assembleur.
|
||||
- `hal/` — stubs C radio 169 MHz (bouclage mémoire), IMU et baromètre, avec
|
||||
interfaces pérennes destinées au portage STM32U5.
|
||||
- `test/test_vercors.c` — harnais de 44 tests : vecteurs officiels sur les
|
||||
primitives, puis cycle protocolaire complet sur radio bouclée.
|
||||
- `build.sh` — assemblage et édition de liens, détection automatique de cible.
|
||||
- `docs/adr/0001` à `0006` — décisions d'architecture.
|
||||
|
||||
### Non implémenté à cette version — traité en 0.2.0 sur hypothèses
|
||||
|
||||
Le manifeste Gastinel Frame n'a pas pu être lu (`__RADIO\Gastinel Frame` est
|
||||
vide). Conformément à la consigne de ne rien supposer silencieusement, les
|
||||
points suivants étaient laissés ouverts à cette version :
|
||||
|
||||
- **[1]** Grain de Sel Temporel — fonction de dérivation hebdomadaire inconnue.
|
||||
- **[3]** Fenêtre de Garde Dynamique — aucune valeur numérique fournie.
|
||||
- **[5]** Bascule de clé asynchrone — schéma stéganographique non décrit.
|
||||
- **[6]** Cold Start / resynchronisation — ni détection, ni Clé Maîtresse
|
||||
d'Usine.
|
||||
|
||||
### Soulevé
|
||||
|
||||
- **Authentification des trames.** Le mode CTR retenu ne fournit aucune
|
||||
intégrité : un attaquant peut retourner des bits du clair sans détection. Un
|
||||
MAC ou un mode AEAD manque. La place d'un MAC dans la trame de 64 octets
|
||||
dépend du manifeste. Voir ADR 0003.
|
||||
|
||||
### Connu et assumé
|
||||
|
||||
- AES logiciel expose une fuite par timing de cache via la S-box. Accepté pour
|
||||
la cible STM32U5, à revoir si le protocole tourne un jour sur un hôte
|
||||
partagé. Voir ADR 0002.
|
||||
@@ -0,0 +1,230 @@
|
||||
# VERCORS — prototype x86-64 en assembleur
|
||||
|
||||
*Variable Encryption Rendez-vous Clock-Over-Radio System* — écosystème Gastinel
|
||||
Frame, boîtiers radio bas-débit 169 MHz en montagne.
|
||||
|
||||
Cette passe est un **prototype x86-64 sur PC**, pas la cible finale. Objectif :
|
||||
valider la logique du protocole en assembleur pur avant portage STM32U5
|
||||
(Cortex-M33, Thumb-2).
|
||||
|
||||
---
|
||||
|
||||
## Construire et exécuter
|
||||
|
||||
```bash
|
||||
./build.sh
|
||||
```
|
||||
|
||||
Sans argument, le script détecte la plate-forme : `win64` sous MinGW/MSYS,
|
||||
`elf64` ailleurs. On peut forcer : `./build.sh elf64` ou `./build.sh win64`.
|
||||
Puis :
|
||||
|
||||
```bash
|
||||
./build/test_vercors.exe
|
||||
```
|
||||
|
||||
**Choix de build.** Pas de Makefile : `make` n'est pas installé sur la machine
|
||||
de développement, et le projet ne compte qu'une dizaine d'unités de compilation. Un
|
||||
script `sh` sans dépendance coûte moins cher à maintenir qu'un Makefile qu'on
|
||||
ne peut pas exécuter. Les fonctions assembleur sont appelées depuis un harnais
|
||||
C compilé avec `gcc` — c'était le seul moyen de confronter le code aux vecteurs
|
||||
officiels FIPS/NIST, ce qui était l'enjeu principal de cette passe.
|
||||
|
||||
État actuel : **86 tests, tous au vert.**
|
||||
|
||||
---
|
||||
|
||||
## Ce qui est fait
|
||||
|
||||
### Cryptographie — assembleur pur, aucune dépendance externe
|
||||
|
||||
Pas d'OpenSSL, pas de libsodium, pas une ligne de C dans le chemin
|
||||
cryptographique.
|
||||
|
||||
| Module | Contenu | Validation |
|
||||
|---|---|---|
|
||||
| `asm/sha256.asm` | SHA-256 complet (init/update/final + one-shot) | 4 vecteurs FIPS 180-4, dont 1 Mo, plus l'équivalence incrémental/one-shot |
|
||||
| `asm/aes256.asm` | AES-256 logiciel, chiffrement + mode CTR | FIPS 197 C.3, NIST SP 800-38A F.5.5, bloc partiel, retenue de compteur |
|
||||
| `asm/const_time.asm` | Comparaisons et sélections à temps constant | Écarts en tête et en fin de zone, bornes non signées |
|
||||
| `asm/csprng.asm` | DRBG maison à base de SHA-256 | Déterminisme, divergence, cohérence de préfixe |
|
||||
|
||||
### Protocole — points spécifiés
|
||||
|
||||
| Point du cahier des charges | État |
|
||||
|---|---|
|
||||
| [2] Heure Cible | **Fait** — SHA-256 → 4 octets big-endian → méthode de rejet → uniforme sur 0–86399 |
|
||||
| [4] Gating temporel avant déchiffrement | **Fait** — rejet sans lancer AES, rendu en masque |
|
||||
| [7] Bourrage aléatoire à 64 octets | **Fait** — bruit CSPRNG |
|
||||
| [8] Chiffrement/déchiffrement AES-256 CTR | **Fait** — compteur avancé et chaîné |
|
||||
|
||||
### Protocole — points sur hypothèses
|
||||
|
||||
> **Ces quatre points ne reposent pas sur une spécification.** Le manifeste
|
||||
> Gastinel Frame ne descend pas à ce niveau de détail. Les constructions
|
||||
> ci-dessous viennent d'hypothèses de travail, complétées ici par des choix
|
||||
> d'encodage. Chacune est documentée en ADR avec le statut *hypothèse
|
||||
> provisoire*. **Rien de tout cela ne doit être déployé sans validation.**
|
||||
|
||||
| Point | Construction retenue | ADR |
|
||||
|---|---|---|
|
||||
| [1] Grain de Sel Temporel | `SHA256(K_M ‖ BE16(semaine ISO) ‖ BE32(compteur anti-rejeu))` — ne transite jamais par la radio | [0007](docs/adr/0007-grain-de-sel-derivation.md) |
|
||||
| [3] Fenêtre de Garde | Élargissement linéaire calé sur la dérive du quartz (20 ppm), plafonné à 30 s, resserrement immédiat | [0008](docs/adr/0008-fenetre-de-garde-dynamique.md) |
|
||||
| [5] Bascule de clé | Chaînage : clé N+1 chiffrée **sous la clé N** avant d'être logée dans le bourrage | [0009](docs/adr/0009-bascule-de-cle-steganographique.md) |
|
||||
| [6] Cold Start | Déclenchement local : reboot, ou 7 jours sans paquet valide → repli sur K_M | [0010](docs/adr/0010-cold-start-cle-maitresse.md) |
|
||||
|
||||
**Trois points méritent d'être lus avant d'aller plus loin :**
|
||||
|
||||
1. **L'époque d'origine des semaines n'est pas définie** ([ADR 0007](docs/adr/0007-grain-de-sel-derivation.md)).
|
||||
Un `uint16` ne porte pas d'année : « semaine 36 » est ambigu. Deux
|
||||
implémentations partant d'origines différentes dérivent des grains
|
||||
différents et **ne se parleront jamais** — sans erreur visible, juste un
|
||||
silence radio permanent.
|
||||
2. **La bascule de clé fait tomber la charge utile de 63 à 31 octets** les jours
|
||||
de renouvellement. Une clé AES-256 occupe la moitié d'une trame de 64 octets :
|
||||
c'est arithmétique. À confirmer que 31 octets suffisent.
|
||||
3. **La séparation de domaine des compteurs CTR n'est pas négociable**
|
||||
([ADR 0009](docs/adr/0009-bascule-de-cle-steganographique.md)). Sans elle, le
|
||||
créneau de clé et la trame partageraient un flot de clé sous la même clé du
|
||||
jour, ce qui révélerait la clé N+1. `vc_ctr_set_domain` existe pour rendre
|
||||
cette contrainte explicite plutôt que laissée à la discipline de l'appelant.
|
||||
|
||||
### Clé Maîtresse d'Usine
|
||||
|
||||
`asm/factory_key.asm` contient un **placeholder de test** valant littéralement
|
||||
`PLACEHOLDER-NE-PAS-UTILISER-PROD`, en ASCII lisible pour qu'un dump mémoire
|
||||
crie ce qu'il est. Cette clé est publique : elle vit en clair dans un fichier
|
||||
versionné.
|
||||
|
||||
**TODO PORTAGE — ce n'est pas un simple remplacement de constante.** Sur cible,
|
||||
K_M vivra dans l'élément sécurisé **STSAFE-A110**. Les octets de la clé ne
|
||||
doivent alors jamais transiter par la RAM du STM32U5, sinon l'élément sécurisé
|
||||
ne sert à rien. L'API devra donc passer d'une exposition de clé
|
||||
(`vc_factory_key` retourne un pointeur) à une API **par opération**, le STSAFE
|
||||
faisant le calcul lui-même : `vc_derive_grain(km, ...)` deviendra
|
||||
`vc_derive_grain_stsafe(week, counter, out)`, sans paramètre de clé. C'est la
|
||||
différence structurante entre ce prototype et la cible, et le premier point à
|
||||
traiter au portage. Détail dans l'[ADR 0010](docs/adr/0010-cold-start-cle-maitresse.md).
|
||||
|
||||
### Couche d'abstraction matérielle
|
||||
|
||||
`hal/` — stubs **en C**, comme demandé, avec des `.h` définissant l'interface
|
||||
pérenne que le portage STM32U5 devra honorer :
|
||||
|
||||
- `vc_radio.h` / `radio_stub.c` — bouclage mémoire tenant lieu de transceiver
|
||||
169 MHz ; `vc_radio_send`, `vc_radio_recv`, `vc_radio_last_rx_seconds`
|
||||
- `vc_imu.h` / `imu_stub.c` — accéléromètre, drapeau de chute
|
||||
- `vc_baro.h` / `baro_stub.c` — pression, température
|
||||
|
||||
Chaque stub expose en plus une ou deux fonctions `*_stub_*` **absentes des
|
||||
en-têtes** : ce sont des points de contrôle réservés au harnais de test
|
||||
(déplacer l'horloge d'arrivée, armer une chute). Le code protocolaire ne les
|
||||
appelle jamais, et la cible ne les aura pas.
|
||||
|
||||
---
|
||||
|
||||
## Confirmation demandée sur la trame
|
||||
|
||||
L'octet d'en-tête (longueur + drapeau de bascule) est **déjà à l'intérieur du
|
||||
chiffré** : `vc_frame_pad` / `vc_frame_build` construisent les 64 octets en
|
||||
clair, puis l'appelant chiffre le bloc **entier** en AES-256-CTR. Ni la
|
||||
longueur ni le drapeau ne circulent en clair sur l'air, et toutes les trames
|
||||
font 64 octets quel que soit leur contenu — l'exigence d'indifférenciabilité du
|
||||
cas C est satisfaite. Aucune correction n'était nécessaire ; l'ADR 0006 a été
|
||||
reformulé pour que ce soit explicite plutôt que déductible.
|
||||
|
||||
---
|
||||
|
||||
## Point ouvert : aucune authentification de trame
|
||||
|
||||
CTR ne fournit **aucune intégrité**. Un attaquant peut retourner des bits
|
||||
arbitraires du clair sans être détecté. Le gating temporel filtre l'inondation,
|
||||
pas la falsification ciblée.
|
||||
|
||||
La bascule de clé aggrave l'enjeu : sans MAC, un attaquant ne peut pas
|
||||
*choisir* la clé N+1, mais il peut la **corrompre**, et provoquer une
|
||||
désynchronisation permanente des deux extrémités avec un seul bit retourné.
|
||||
L'authentification n'est pas un raffinement ici — c'est ce qui empêche un déni
|
||||
de service définitif à coût nul.
|
||||
|
||||
Il manque donc un MAC (HMAC-SHA-256 tronqué, ou AES-CMAC) ou un mode AEAD. Le
|
||||
SHA-256 nécessaire est déjà présent dans ce dépôt. C'est la place du MAC dans
|
||||
les 64 octets qui reste à décider — et le budget est serré les jours de
|
||||
bascule, où il ne reste que 31 octets utiles. Voir
|
||||
[ADR 0003](docs/adr/0003-mode-ctr.md) et
|
||||
[ADR 0009](docs/adr/0009-bascule-de-cle-steganographique.md).
|
||||
|
||||
---
|
||||
|
||||
## Écarts par rapport au cahier des charges, et pourquoi
|
||||
|
||||
| Écart | Justification |
|
||||
|---|---|
|
||||
| Cible Win64 exécutable en plus d'ELF64/System V | WSL n'est pas installé : assembler en ELF sans pouvoir exécuter aurait produit du code jamais lancé, alors que l'objet de la passe est de *valider*. Une abstraction d'ABI (`include/abi.inc`) rend les mêmes sources valides dans les deux formats. **System V reste la cible de référence.** ADR 0001 |
|
||||
| AES logiciel, pas AES-NI | Le prompt l'autorisait à condition de le signaler ; le choix inverse a été fait pour que le code testé soit celui qui sera porté. ADR 0002 |
|
||||
| Pas de Makefile | `make` absent de la machine ; six unités de compilation. |
|
||||
| Disposition interne de la trame | **Hypothèse explicite** faute de manifeste, isolée dans quatre fonctions. ADR 0006, 0009 |
|
||||
| Points [1] [3] [5] [6] | Implémentés sur **hypothèses**, pas sur spécification. Chaque ADR concerné porte le statut *hypothèse provisoire*. ADR 0007 à 0010 |
|
||||
| ADR/CHANGELOG : conventions non reprises de `server-infra` | Le prompt demande la cohérence avec `server-infra`, mais ce dépôt **ne contient ni CHANGELOG ni ADR** (vérifié). Format MADR standard retenu par défaut ; à réaligner si une convention existe ailleurs. |
|
||||
|
||||
---
|
||||
|
||||
## Ce qui devra être réécrit pour Cortex-M33
|
||||
|
||||
Le découpage a été fait pour que cette liste soit courte et localisée. La
|
||||
logique — planning de message SHA-256, S-box AES, `MixColumns`, méthode de
|
||||
rejet, construction du DRBG — est portable telle quelle.
|
||||
|
||||
| Élément x86-64 | Équivalent / travail Thumb-2 |
|
||||
|---|---|
|
||||
| `include/abi.inc` en entier | À remplacer par un équivalent AAPCS (arguments dans `r0-r3`). Aucune logique protocolaire n'y réside. |
|
||||
| `r8d..r15d` pour l'état SHA-256 (a..h) | Thumb-2 n'a que `r0-r12` utilisables : il faudra spiller une partie de l'état sur la pile. |
|
||||
| `bswap` | `rev` |
|
||||
| `ror` 32 bits | `ror` — portable tel quel |
|
||||
| `rep movsb` / `rep stosb` / `rep stosq` | Boucles explicites |
|
||||
| `div` (reste modulo 86400) | Le M33 n'a pas de division entière avec reste sur 64 bits : `udiv` + `mls`, ou réduction par soustractions à temps constant |
|
||||
| `sbb reg, reg` (masque depuis la retenue) | `sbc r, r, r` |
|
||||
| `cmovb` | `it`/`mov` conditionnel, ou arithmétique de masque |
|
||||
| Demi-registre haut `ah` dans `SUBWORD` | Pas d'équivalent : `ubfx` / `bfi` |
|
||||
| Tableau `W` de 256 octets sur la pile (SHA-256) | À vérifier vis-à-vis de la taille de pile des tâches embarquées |
|
||||
| Amorçage du CSPRNG | À câbler sur le TRNG matériel du STM32U5 — **point de vérification obligatoire de la revue de portage** |
|
||||
| `asm/factory_key.asm` en entier | Disparaît : K_M passe dans l'élément sécurisé STSAFE-A110, avec changement de forme d'API. ADR 0010 |
|
||||
| `xchg al, ah` (encodage BE16 du grain) | Pas d'équivalent : `rev16`, ou `ubfx`/`bfi` |
|
||||
|
||||
Aucune extension SIMD, AES-NI ou SHA-NI n'est utilisée nulle part.
|
||||
|
||||
---
|
||||
|
||||
## Arborescence
|
||||
|
||||
```
|
||||
asm/ sha256, aes256, const_time, csprng,
|
||||
vercors_protocol (points 2, 4, 7, 8)
|
||||
vercors_keysched (points 1, 3, 5, 6 -- hypotheses)
|
||||
factory_key (placeholder K_M, disparait au portage)
|
||||
include/ abi.inc (macros d'ABI), vercors.h (interface C)
|
||||
hal/ stubs radio / IMU / baromètre, en C
|
||||
test/ harnais de cycle complet
|
||||
docs/adr/ décisions d'architecture numérotées
|
||||
build.sh assemblage et édition de liens
|
||||
```
|
||||
|
||||
## Sécurité — ce qui est garanti et ce qui ne l'est pas
|
||||
|
||||
**Garanti** : comparaisons de secrets à temps constant (`const_time.asm`,
|
||||
aucun saut conditionnel sur une valeur secrète) ; effacement non optimisable
|
||||
des tampons sensibles ; gating temporel strictement antérieur à AES ; bourrage
|
||||
en bruit et non en zéros.
|
||||
|
||||
**Garanti aussi** : séparation de domaine des compteurs CTR entre trame et
|
||||
créneau de clé ; clé N+1 jamais en clair, même avant le chiffrement de trame ;
|
||||
fenêtre de garde bornée quoi qu'il arrive, y compris horloge qui recule.
|
||||
|
||||
**Non garanti** : résistance au timing de cache d'AES logiciel (ADR 0002,
|
||||
assumé pour cette cible) ; intégrité/authenticité des trames sous CTR
|
||||
(ADR 0003 et 0009, **ouvert**) ; qualité de l'entropie d'amorçage, qui dépend
|
||||
de l'appelant (ADR 0004) ; protection de K_M, qui n'existe pas sur ce prototype
|
||||
(ADR 0010).
|
||||
|
||||
**Non validé** : les quatre constructions [1] [3] [5] [6] sont des hypothèses.
|
||||
Elles sont cohérentes et testées, mais rien ne dit qu'elles correspondent au
|
||||
protocole VERCORS réel.
|
||||
@@ -0,0 +1,426 @@
|
||||
; =============================================================================
|
||||
; aes256.asm -- AES-256 logiciel en assembleur x86-64 pur, sans dependance.
|
||||
;
|
||||
; DECISION (voir docs/adr/0002) : implementation LOGICIELLE, pas AES-NI.
|
||||
; Le prompt autorise AES-NI a condition de le signaler. Le choix inverse a ete
|
||||
; fait volontairement : cette passe x86-64 sert a valider la logique VERCORS
|
||||
; avant portage Cortex-M33, or le M33 n'a pas d'accelerateur AES accessible de
|
||||
; la meme facon. Ecrire ici la version logicielle donne un comportement
|
||||
; strictement identique a celui de la cible, et la meme structure de code a
|
||||
; porter. Une variante AES-NI serait plus rapide mais validerait un chemin
|
||||
; d'execution qui n'existera jamais sur le boitier.
|
||||
;
|
||||
; DECISION (voir docs/adr/0003) : mode CTR, comme suggere. Consequence directe
|
||||
; ici : CTR n'utilise QUE le chiffrement de bloc. Aucune fonction de
|
||||
; dechiffrement (InvSubBytes, InvMixColumns, table inverse) n'est necessaire --
|
||||
; c'est environ la moitie du code et de la ROM en moins sur STM32U5.
|
||||
;
|
||||
; API publique :
|
||||
; void vc_aes256_expand_key (const uint8_t key[32], vc_aes_rk *rk);
|
||||
; void vc_aes256_encrypt_block(const vc_aes_rk *rk, const uint8_t in[16],
|
||||
; uint8_t out[16]);
|
||||
; void vc_aes256_ctr_xor (const vc_aes_rk *rk, uint8_t ctr[16],
|
||||
; uint8_t *inout, size_t len);
|
||||
;
|
||||
; vc_aes256_ctr_xor travaille EN PLACE (4 arguments). Une signature separant
|
||||
; entree et sortie aurait fait 5 arguments, donc un passage par la pile sous
|
||||
; ABI Microsoft dont l'offset depend des registres empiles par VC_ARGS. CTR
|
||||
; etant une simple XOR involutive, le sur-place est naturel et evite ce piege.
|
||||
;
|
||||
; MISE EN GARDE TEMPORELLE : les SubBytes passent par une table S de 256 octets
|
||||
; indexee par des donnees secretes. Sur un CPU a cache partage, cela expose une
|
||||
; fuite par timing de cache. C'est accepte ici et documente dans l'ADR 0002 :
|
||||
; - la cible reelle (STM32U5) n'a pas de cache de donnees partage avec un
|
||||
; attaquant, ni de multi-tenance ; le modele de menace radio est distant ;
|
||||
; - une version constante en temps demanderait du bitslicing, qui ne se porte
|
||||
; pas tel quel en Thumb-2 et brouillerait l'objectif de cette passe.
|
||||
; Les comparaisons de secrets, elles, sont bien en temps constant (const_time.asm).
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : la logique (S-box, ShiftRows, MixColumns, cadencement
|
||||
; de cles) est portable telle quelle. Sont x86-64-specifiques :
|
||||
; - l'allocation de registres et l'usage de rbp comme base d'etat sur pile ;
|
||||
; - l'astuce d'acces au demi-registre haut (ah) dans SUBWORD, qui n'a pas
|
||||
; d'equivalent Thumb-2 (il faudra des ubfx/bfi) ;
|
||||
; - ror sur 32 bits, disponible en Thumb-2 (ror), donc portable.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
%define AES_ROUNDS 14
|
||||
%define AES_RK_BYTES 240 ; (14 + 1) * 16
|
||||
|
||||
; =============================================================================
|
||||
SECT_RODATA
|
||||
|
||||
align 64
|
||||
SBOX:
|
||||
db 0x63,0x7c,0x77,0x7b,0xf2,0x6b,0x6f,0xc5,0x30,0x01,0x67,0x2b,0xfe,0xd7,0xab,0x76
|
||||
db 0xca,0x82,0xc9,0x7d,0xfa,0x59,0x47,0xf0,0xad,0xd4,0xa2,0xaf,0x9c,0xa4,0x72,0xc0
|
||||
db 0xb7,0xfd,0x93,0x26,0x36,0x3f,0xf7,0xcc,0x34,0xa5,0xe5,0xf1,0x71,0xd8,0x31,0x15
|
||||
db 0x04,0xc7,0x23,0xc3,0x18,0x96,0x05,0x9a,0x07,0x12,0x80,0xe2,0xeb,0x27,0xb2,0x75
|
||||
db 0x09,0x83,0x2c,0x1a,0x1b,0x6e,0x5a,0xa0,0x52,0x3b,0xd6,0xb3,0x29,0xe3,0x2f,0x84
|
||||
db 0x53,0xd1,0x00,0xed,0x20,0xfc,0xb1,0x5b,0x6a,0xcb,0xbe,0x39,0x4a,0x4c,0x58,0xcf
|
||||
db 0xd0,0xef,0xaa,0xfb,0x43,0x4d,0x33,0x85,0x45,0xf9,0x02,0x7f,0x50,0x3c,0x9f,0xa8
|
||||
db 0x51,0xa3,0x40,0x8f,0x92,0x9d,0x38,0xf5,0xbc,0xb6,0xda,0x21,0x10,0xff,0xf3,0xd2
|
||||
db 0xcd,0x0c,0x13,0xec,0x5f,0x97,0x44,0x17,0xc4,0xa7,0x7e,0x3d,0x64,0x5d,0x19,0x73
|
||||
db 0x60,0x81,0x4f,0xdc,0x22,0x2a,0x90,0x88,0x46,0xee,0xb8,0x14,0xde,0x5e,0x0b,0xdb
|
||||
db 0xe0,0x32,0x3a,0x0a,0x49,0x06,0x24,0x5c,0xc2,0xd3,0xac,0x62,0x91,0x95,0xe4,0x79
|
||||
db 0xe7,0xc8,0x37,0x6d,0x8d,0xd5,0x4e,0xa9,0x6c,0x56,0xf4,0xea,0x65,0x7a,0xae,0x08
|
||||
db 0xba,0x78,0x25,0x2e,0x1c,0xa6,0xb4,0xc6,0xe8,0xdd,0x74,0x1f,0x4b,0xbd,0x8b,0x8a
|
||||
db 0x70,0x3e,0xb5,0x66,0x48,0x03,0xf6,0x0e,0x61,0x35,0x57,0xb9,0x86,0xc1,0x1d,0x9e
|
||||
db 0xe1,0xf8,0x98,0x11,0x69,0xd9,0x8e,0x94,0x9b,0x1e,0x87,0xe9,0xce,0x55,0x28,0xdf
|
||||
db 0x8c,0xa1,0x89,0x0d,0xbf,0xe6,0x42,0x68,0x41,0x99,0x2d,0x0f,0xb0,0x54,0xbb,0x16
|
||||
|
||||
; Rcon[j] pour j = 1..7 (AES-256 : i/Nk va de 1 a 7).
|
||||
; Le mot est stocke en little-endian, donc l'octet de poids faible correspond
|
||||
; a b0, l'octet le plus a gauche du mot AES : Rcon vaut bien 0x000000xx.
|
||||
align 16
|
||||
RCON:
|
||||
dd 0x00000001, 0x00000002, 0x00000004, 0x00000008
|
||||
dd 0x00000010, 0x00000020, 0x00000040
|
||||
|
||||
; =============================================================================
|
||||
section .text
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; XTIME %1 -- multiplication par x dans GF(2^8), sans branchement.
|
||||
; %1 : registre 32 bits contenant une valeur 0..255 (entree/sortie)
|
||||
; %2 : registre 32 bits scratch
|
||||
; Le masque est derive du bit 7 par neg, donc pas de saut conditionnel
|
||||
; dependant de la donnee.
|
||||
; -----------------------------------------------------------------------------
|
||||
%macro XTIME 2
|
||||
mov %2, %1
|
||||
shr %2, 7
|
||||
and %2, 1
|
||||
neg %2 ; 0x00000000 ou 0xffffffff
|
||||
and %2, 0x1b
|
||||
add %1, %1
|
||||
and %1, 0xff
|
||||
xor %1, %2
|
||||
%endmacro
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; SUBWORD -- applique la S-box aux 4 octets de eax.
|
||||
; Entree/sortie : eax. Clobber : ecx, edx. Base S-box attendue dans rbx.
|
||||
; N'utilise que des registres herites (ah interdit avec un prefixe REX).
|
||||
; -----------------------------------------------------------------------------
|
||||
%macro SUBWORD 0
|
||||
movzx ecx, al
|
||||
movzx edx, ah
|
||||
mov cl, [rbx + rcx]
|
||||
mov dl, [rbx + rdx]
|
||||
mov al, cl
|
||||
mov ah, dl
|
||||
ror eax, 16
|
||||
movzx ecx, al
|
||||
movzx edx, ah
|
||||
mov cl, [rbx + rcx]
|
||||
mov dl, [rbx + rdx]
|
||||
mov al, cl
|
||||
mov ah, dl
|
||||
ror eax, 16
|
||||
%endmacro
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; Symboles exportes pour les autres modules ASM du projet (convention privee
|
||||
; System V), pas pour du code C. Voir la note equivalente dans sha256.asm.
|
||||
; -----------------------------------------------------------------------------
|
||||
global aes256_expand_key_i
|
||||
global aes256_encrypt_block_i
|
||||
global aes256_ctr_xor_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; aes256_expand_key_i -- interne. rdi = cle 32 octets, rsi = rk (240 octets).
|
||||
;
|
||||
; Cadencement AES-256 : Nk = 8, Nr = 14, 60 mots de 32 bits.
|
||||
; w[i] = w[i-8] ^ f(w[i-1]) avec f = SubWord(RotWord(.)) ^ Rcon si i%8 == 0
|
||||
; f = SubWord(.) si i%8 == 4
|
||||
; f = identite sinon
|
||||
; La branche supplementaire a i%8 == 4 est propre a AES-256 (absente en 128).
|
||||
; -----------------------------------------------------------------------------
|
||||
aes256_expand_key_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
|
||||
; --- w[0..7] = cle
|
||||
mov rax, [rdi + 0]
|
||||
mov [rsi + 0], rax
|
||||
mov rax, [rdi + 8]
|
||||
mov [rsi + 8], rax
|
||||
mov rax, [rdi + 16]
|
||||
mov [rsi + 16], rax
|
||||
mov rax, [rdi + 24]
|
||||
mov [rsi + 24], rax
|
||||
|
||||
lea rbx, [SBOX]
|
||||
lea r13, [RCON]
|
||||
mov r12, 8 ; i
|
||||
|
||||
.loop:
|
||||
mov eax, [rsi + 4*r12 - 4] ; temp = w[i-1]
|
||||
|
||||
mov r8d, r12d
|
||||
and r8d, 7
|
||||
jnz .maybe_mid
|
||||
|
||||
; --- i % 8 == 0
|
||||
ror eax, 8 ; RotWord
|
||||
SUBWORD
|
||||
mov r8d, r12d
|
||||
shr r8d, 3 ; j = i / 8, dans 1..7
|
||||
xor eax, [r13 + 4*r8 - 4] ; ^ Rcon[j]
|
||||
jmp .combine
|
||||
|
||||
.maybe_mid:
|
||||
cmp r8d, 4
|
||||
jne .combine
|
||||
; --- i % 8 == 4 : SubWord seule (specifique AES-256)
|
||||
SUBWORD
|
||||
|
||||
.combine:
|
||||
xor eax, [rsi + 4*r12 - 32] ; ^ w[i-8]
|
||||
mov [rsi + 4*r12], eax
|
||||
|
||||
inc r12
|
||||
cmp r12, 60
|
||||
jb .loop
|
||||
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; aes256_encrypt_block_i -- interne.
|
||||
; rdi = rk, rsi = bloc clair 16 octets, rdx = bloc chiffre 16 octets.
|
||||
; in et out peuvent etre confondus.
|
||||
;
|
||||
; Cadre de pile (rbp) :
|
||||
; [rbp + 0 .. 15] etat courant
|
||||
; [rbp + 16 .. 31] etat intermediaire (apres SubBytes+ShiftRows)
|
||||
; [rbp + 32 .. 39] pointeur de sortie (rdx est ecrase pendant les rondes)
|
||||
; -----------------------------------------------------------------------------
|
||||
aes256_encrypt_block_i:
|
||||
push rbx
|
||||
push rbp
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
push r15
|
||||
sub rsp, 48
|
||||
mov rbp, rsp
|
||||
|
||||
mov [rbp + 32], rdx ; pointeur de sortie, a l'abri
|
||||
|
||||
; --- etat = bloc ^ rk[0] (AddRoundKey initial)
|
||||
mov rax, [rsi + 0]
|
||||
xor rax, [rdi + 0]
|
||||
mov [rbp + 0], rax
|
||||
mov rax, [rsi + 8]
|
||||
xor rax, [rdi + 8]
|
||||
mov [rbp + 8], rax
|
||||
|
||||
lea rbx, [SBOX]
|
||||
lea r14, [rdi + 16] ; pointeur de cle de ronde courante
|
||||
mov r13, 1 ; numero de ronde
|
||||
|
||||
.round_loop:
|
||||
; --- SubBytes + ShiftRows, fusionnes : etat -> intermediaire.
|
||||
; out[r + 4c] = S[ in[r + 4*((c + r) mod 4)] ]
|
||||
; Les index sont resolus a l'assemblage, il n'y a aucun calcul
|
||||
; d'adresse dependant de la donnee.
|
||||
%assign idx 0
|
||||
%rep 16
|
||||
%assign rr (idx & 3)
|
||||
%assign cc (idx >> 2)
|
||||
movzx eax, byte [rbp + (rr + 4*((cc + rr) & 3))]
|
||||
mov al, [rbx + rax]
|
||||
mov [rbp + 16 + idx], al
|
||||
%assign idx idx+1
|
||||
%endrep
|
||||
|
||||
; --- MixColumns, sautee a la derniere ronde
|
||||
cmp r13, AES_ROUNDS
|
||||
je .add_round_key
|
||||
|
||||
%assign cc 0
|
||||
%rep 4
|
||||
movzx eax, byte [rbp + 16 + 4*cc + 0] ; a0
|
||||
movzx ecx, byte [rbp + 16 + 4*cc + 1] ; a1
|
||||
movzx edx, byte [rbp + 16 + 4*cc + 2] ; a2
|
||||
movzx r8d, byte [rbp + 16 + 4*cc + 3] ; a3
|
||||
|
||||
mov r9d, eax
|
||||
xor r9d, ecx
|
||||
xor r9d, edx
|
||||
xor r9d, r8d ; t = a0^a1^a2^a3
|
||||
|
||||
; b0 = a0 ^ t ^ xtime(a0 ^ a1)
|
||||
mov r11d, eax
|
||||
xor r11d, ecx
|
||||
XTIME r11d, r15d
|
||||
xor r11d, r9d
|
||||
xor r11d, eax
|
||||
mov [rbp + 16 + 4*cc + 0], r11b
|
||||
; b1 = a1 ^ t ^ xtime(a1 ^ a2)
|
||||
mov r11d, ecx
|
||||
xor r11d, edx
|
||||
XTIME r11d, r15d
|
||||
xor r11d, r9d
|
||||
xor r11d, ecx
|
||||
mov [rbp + 16 + 4*cc + 1], r11b
|
||||
; b2 = a2 ^ t ^ xtime(a2 ^ a3)
|
||||
mov r11d, edx
|
||||
xor r11d, r8d
|
||||
XTIME r11d, r15d
|
||||
xor r11d, r9d
|
||||
xor r11d, edx
|
||||
mov [rbp + 16 + 4*cc + 2], r11b
|
||||
; b3 = a3 ^ t ^ xtime(a3 ^ a0)
|
||||
mov r11d, r8d
|
||||
xor r11d, eax
|
||||
XTIME r11d, r15d
|
||||
xor r11d, r9d
|
||||
xor r11d, r8d
|
||||
mov [rbp + 16 + 4*cc + 3], r11b
|
||||
|
||||
%assign cc cc+1
|
||||
%endrep
|
||||
|
||||
.add_round_key:
|
||||
mov rax, [rbp + 16]
|
||||
xor rax, [r14 + 0]
|
||||
mov [rbp + 0], rax
|
||||
mov rax, [rbp + 24]
|
||||
xor rax, [r14 + 8]
|
||||
mov [rbp + 8], rax
|
||||
|
||||
add r14, 16
|
||||
inc r13
|
||||
cmp r13, AES_ROUNDS
|
||||
jbe .round_loop
|
||||
|
||||
; --- ecriture du resultat
|
||||
mov rdx, [rbp + 32]
|
||||
mov rax, [rbp + 0]
|
||||
mov [rdx + 0], rax
|
||||
mov rax, [rbp + 8]
|
||||
mov [rdx + 8], rax
|
||||
|
||||
; --- effacement de l'etat intermediaire (contient du clair partiel)
|
||||
xor eax, eax
|
||||
mov [rbp + 0], rax
|
||||
mov [rbp + 8], rax
|
||||
mov [rbp + 16], rax
|
||||
mov [rbp + 24], rax
|
||||
|
||||
add rsp, 48
|
||||
pop r15
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbp
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; ctr_inc_i -- interne. rdi = compteur 16 octets, incremente en big-endian
|
||||
; sur la totalite du bloc (NIST SP 800-38A, compteur standard sur 128 bits).
|
||||
; Duree d'execution dependante de la retenue, mais le compteur n'est pas secret.
|
||||
; -----------------------------------------------------------------------------
|
||||
ctr_inc_i:
|
||||
mov rcx, 15
|
||||
.loop:
|
||||
inc byte [rdi + rcx]
|
||||
jnz .done
|
||||
dec rcx
|
||||
jns .loop
|
||||
.done:
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; Enveloppes publiques
|
||||
; =============================================================================
|
||||
|
||||
VC_FUNC vc_aes256_expand_key
|
||||
VC_ARGS ; rdi = key32, rsi = rk
|
||||
call aes256_expand_key_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_aes256_encrypt_block
|
||||
VC_ARGS ; rdi = rk, rsi = in, rdx = out
|
||||
call aes256_encrypt_block_i
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_aes256_ctr_xor(const vc_aes_rk *rk, uint8_t ctr[16],
|
||||
; uint8_t *inout, size_t len)
|
||||
; XOR sur place avec le flot CTR. Le compteur est avance et laisse a jour
|
||||
; pour permettre un chainage sur plusieurs appels.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_aes256_ctr_xor
|
||||
VC_ARGS ; rdi = rk, rsi = ctr, rdx = inout, rcx = len
|
||||
call aes256_ctr_xor_i
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; aes256_ctr_xor_i -- interne. rdi = rk, rsi = ctr, rdx = inout, rcx = len.
|
||||
; -----------------------------------------------------------------------------
|
||||
aes256_ctr_xor_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
push r15
|
||||
sub rsp, 16 ; tampon de flot
|
||||
|
||||
mov r12, rdi ; rk
|
||||
mov r13, rsi ; ctr
|
||||
mov r14, rdx ; inout
|
||||
mov r15, rcx ; len
|
||||
mov rbx, rsp ; keystream
|
||||
|
||||
.block_loop:
|
||||
test r15, r15
|
||||
jz .finish
|
||||
|
||||
mov rdi, r12
|
||||
mov rsi, r13
|
||||
mov rdx, rbx
|
||||
call aes256_encrypt_block_i
|
||||
|
||||
mov rdi, r13
|
||||
call ctr_inc_i
|
||||
|
||||
; n = min(16, len)
|
||||
mov rax, 16
|
||||
cmp r15, rax
|
||||
cmovb rax, r15
|
||||
|
||||
xor rcx, rcx
|
||||
.xor_loop:
|
||||
mov dl, [rbx + rcx]
|
||||
xor [r14 + rcx], dl
|
||||
inc rcx
|
||||
cmp rcx, rax
|
||||
jb .xor_loop
|
||||
|
||||
add r14, rax
|
||||
sub r15, rax
|
||||
jmp .block_loop
|
||||
|
||||
.finish:
|
||||
; effacement du dernier bloc de flot
|
||||
xor rax, rax
|
||||
mov [rbx + 0], rax
|
||||
mov [rbx + 8], rax
|
||||
|
||||
add rsp, 16
|
||||
pop r15
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
@@ -0,0 +1,140 @@
|
||||
; =============================================================================
|
||||
; const_time.asm -- primitives a temps d'execution constant.
|
||||
;
|
||||
; Contrainte projet : aucune comparaison de cle ou de MAC ne doit sortir tot.
|
||||
; Toutes les fonctions de ce fichier ont un flot de controle qui ne depend que
|
||||
; de la LONGUEUR des donnees, jamais de leur VALEUR. Concretement : pas un seul
|
||||
; saut conditionnel dont la condition derive d'un octet secret.
|
||||
;
|
||||
; API publique :
|
||||
; uint32_t vc_ct_memcmp (const void *a, const void *b, size_t len);
|
||||
; uint64_t vc_ct_mask_eq_u32(uint32_t a, uint32_t b);
|
||||
; uint64_t vc_ct_mask_lt_u32(uint32_t a, uint32_t b);
|
||||
; void vc_ct_cmov (void *dst, const void *src, size_t len,
|
||||
; uint64_t mask);
|
||||
; void vc_ct_memzero (void *p, size_t len);
|
||||
;
|
||||
; Convention des masques : 0xFFFFFFFFFFFFFFFF pour vrai, 0 pour faux. Un masque
|
||||
; se combine par and/or/xor sans jamais brancher.
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : la technique est integralement portable (Thumb-2 a
|
||||
; sbc, rsb et les memes drapeaux). Sont x86-64-specifiques :
|
||||
; - l'idiome sbb reg, reg pour materialiser CF en masque (equivalent
|
||||
; Thumb-2 : sbc r, r, r) ;
|
||||
; - rep stosb.
|
||||
; Attention au portage : sur Cortex-M il faudra verifier que le compilateur ne
|
||||
; reintroduit pas de branche, et que vc_ct_memzero ne soit pas remplace par un
|
||||
; memset optimisable. Le fait de l'ecrire en assembleur est precisement la
|
||||
; garantie recherchee ici -- un memset C peut etre supprime par le compilateur
|
||||
; sur un tampon mort, pas ce code.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
section .text
|
||||
|
||||
global vc_ct_memcmp_i
|
||||
global vc_ct_memzero_i
|
||||
global vc_ct_cmov_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; uint32_t vc_ct_memcmp(const void *a, const void *b, size_t len)
|
||||
; Retourne 0 si les zones sont identiques, 1 sinon.
|
||||
; Les len octets sont TOUJOURS lus, quelle que soit la position du premier
|
||||
; ecart : l'accumulateur agrege les differences par ou, sans sortie anticipee.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ct_memcmp
|
||||
VC_ARGS ; rdi = a, rsi = b, rdx = len
|
||||
call vc_ct_memcmp_i
|
||||
VC_RET
|
||||
|
||||
vc_ct_memcmp_i:
|
||||
xor eax, eax ; accumulateur de differences
|
||||
xor ecx, ecx
|
||||
test rdx, rdx
|
||||
jz .normalize ; longueur nulle : pas de secret implique
|
||||
|
||||
.loop:
|
||||
mov r8b, [rdi + rcx]
|
||||
xor r8b, [rsi + rcx]
|
||||
or al, r8b
|
||||
inc rcx
|
||||
cmp rcx, rdx ; borne = longueur, pas une valeur secrete
|
||||
jb .loop
|
||||
|
||||
.normalize:
|
||||
; al != 0 -> 1 ; al == 0 -> 0, sans branchement
|
||||
movzx eax, al
|
||||
neg eax ; CF = 1 si eax etait non nul
|
||||
sbb eax, eax ; 0xffffffff si different, 0 si egal
|
||||
and eax, 1
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; uint64_t vc_ct_mask_eq_u32(uint32_t a, uint32_t b)
|
||||
; Tout-a-un si a == b, zero sinon.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ct_mask_eq_u32
|
||||
VC_ARGS ; edi = a, esi = b
|
||||
mov eax, edi
|
||||
xor eax, esi ; 0 si et seulement si egaux
|
||||
neg eax ; CF = 1 si non nul
|
||||
sbb rax, rax ; -1 si different, 0 si egal
|
||||
not rax ; -1 si egal, 0 si different
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; uint64_t vc_ct_mask_lt_u32(uint32_t a, uint32_t b)
|
||||
; Tout-a-un si a < b (non signe), zero sinon.
|
||||
; Utilise par le gating temporel : compare l'instant d'arrivee a l'Heure
|
||||
; Cible sans produire de branche exploitable au timing.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ct_mask_lt_u32
|
||||
VC_ARGS ; edi = a, esi = b
|
||||
cmp edi, esi ; CF = 1 si a < b
|
||||
sbb rax, rax ; -1 si a < b, 0 sinon
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_ct_cmov(void *dst, const void *src, size_t len, uint64_t mask)
|
||||
; dst <- src si mask est tout-a-un, dst inchange si mask est nul.
|
||||
; Les deux zones sont lues et dst est TOUJOURS reecrit : la trace d'acces
|
||||
; memoire est la meme dans les deux cas.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ct_cmov
|
||||
VC_ARGS ; rdi = dst, rsi = src, rdx = len, rcx = mask
|
||||
call vc_ct_cmov_i
|
||||
VC_RET
|
||||
|
||||
vc_ct_cmov_i:
|
||||
test rdx, rdx
|
||||
jz .done
|
||||
xor r8, r8
|
||||
.loop:
|
||||
movzx r9d, byte [rdi + r8] ; ancien
|
||||
movzx r10d, byte [rsi + r8] ; nouveau
|
||||
xor r10d, r9d
|
||||
and r10, rcx ; masque applique a la difference
|
||||
xor r10d, r9d ; = mask ? nouveau : ancien
|
||||
mov [rdi + r8], r10b
|
||||
inc r8
|
||||
cmp r8, rdx
|
||||
jb .loop
|
||||
.done:
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_ct_memzero(void *p, size_t len)
|
||||
; Effacement qui ne peut pas etre elimine par un optimiseur, contrairement a
|
||||
; un memset C sur un tampon en fin de vie.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ct_memzero
|
||||
VC_ARGS ; rdi = p, rsi = len
|
||||
call vc_ct_memzero_i
|
||||
VC_RET
|
||||
|
||||
vc_ct_memzero_i:
|
||||
mov rcx, rsi
|
||||
xor eax, eax
|
||||
rep stosb
|
||||
ret
|
||||
@@ -0,0 +1,230 @@
|
||||
; =============================================================================
|
||||
; csprng.asm -- generateur pseudo-aleatoire cryptographique maison, bati sur le
|
||||
; SHA-256 du projet. Aucune dependance externe (contrainte projet).
|
||||
;
|
||||
; VERCORS en a besoin pour :
|
||||
; - le bourrage aleatoire des trames a taille fixe (64 octets) : le prompt
|
||||
; exige explicitement des octets de bruit, pas des zeros ;
|
||||
; - la generation isolee du Grain de Sel Temporel hebdomadaire.
|
||||
;
|
||||
; CONSTRUCTION (voir docs/adr/0004) -- DRBG a base de hachage, dans l'esprit de
|
||||
; Hash_DRBG (NIST SP 800-90A) mais volontairement simplifie :
|
||||
;
|
||||
; seed(graine) V <- SHA256(graine) ; C <- 0
|
||||
; bytes(n) pour chaque bloc de 32 octets :
|
||||
; sortie <- SHA256(V || BE64(C))
|
||||
; C <- C + 1
|
||||
; puis, une fois la demande servie :
|
||||
; V <- SHA256(0x01 || V)
|
||||
;
|
||||
; Le rafraichissement final de V donne la resistance au retour en arriere : la
|
||||
; compromission de l'etat apres coup ne permet pas de recalculer les octets
|
||||
; deja emis, ce qui protege le bourrage des trames deja transmises.
|
||||
;
|
||||
; CE QUE CE MODULE NE FAIT PAS : il ne fabrique pas d'entropie. La graine doit
|
||||
; venir de l'exterieur. Sur x86-64 le harnais de test la fournit ; sur STM32U5
|
||||
; ce sera le TRNG materiel. C'est la seule difference de fond au portage, et
|
||||
; elle est isolee derriere vc_csprng_seed.
|
||||
;
|
||||
; API publique :
|
||||
; void vc_csprng_seed (vc_csprng_ctx *ctx, const void *seed, size_t len);
|
||||
; void vc_csprng_reseed(vc_csprng_ctx *ctx, const void *seed, size_t len);
|
||||
; void vc_csprng_bytes (vc_csprng_ctx *ctx, void *out, size_t len);
|
||||
;
|
||||
; Disposition de vc_csprng_ctx (48 octets, voir include/vercors.h) :
|
||||
; +0 uint8_t V[32]
|
||||
; +32 uint64_t C compteur de blocs
|
||||
; +40 uint64_t seeded 0 = non initialise
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : entierement portable, la seule instruction
|
||||
; x86-64-specifique etant bswap (rev en Thumb-2) et rep movsb.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
%define PRNG_V 0
|
||||
%define PRNG_C 32
|
||||
%define PRNG_SEEDED 40
|
||||
%define PRNG_SIZE 48
|
||||
|
||||
extern vc_sha256_i
|
||||
extern sha256_init_i
|
||||
extern sha256_update_i
|
||||
extern sha256_final_i
|
||||
|
||||
section .text
|
||||
|
||||
global vc_csprng_seed_i
|
||||
global vc_csprng_bytes_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; vc_csprng_seed_i -- interne. rdi = ctx, rsi = graine, rdx = longueur.
|
||||
; V <- SHA256(graine), C <- 0.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_csprng_seed_i:
|
||||
push rbx
|
||||
mov rbx, rdi
|
||||
|
||||
mov rdi, rsi ; data = graine
|
||||
mov rsi, rdx ; len
|
||||
mov rdx, rbx ; out = V
|
||||
call vc_sha256_i
|
||||
|
||||
mov qword [rbx + PRNG_C], 0
|
||||
mov qword [rbx + PRNG_SEEDED], 1
|
||||
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; vc_csprng_reseed_i -- interne. rdi = ctx, rsi = graine, rdx = longueur.
|
||||
; V <- SHA256(V || graine). Melange la nouvelle entropie sans jeter
|
||||
; l'ancienne : un reseed avec une source degradee ne peut pas affaiblir
|
||||
; l'etat courant.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_csprng_reseed_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
sub rsp, 128 ; contexte SHA-256 (112) sur la pile
|
||||
|
||||
mov rbx, rdi ; ctx PRNG
|
||||
mov r12, rsi ; graine
|
||||
mov r13, rdx ; longueur
|
||||
mov r14, rsp ; contexte SHA
|
||||
|
||||
mov rdi, r14
|
||||
call sha256_init_i
|
||||
mov rdi, r14
|
||||
lea rsi, [rbx + PRNG_V]
|
||||
mov rdx, 32
|
||||
call sha256_update_i
|
||||
mov rdi, r14
|
||||
mov rsi, r12
|
||||
mov rdx, r13
|
||||
call sha256_update_i
|
||||
mov rdi, r14
|
||||
lea rsi, [rbx + PRNG_V]
|
||||
call sha256_final_i
|
||||
|
||||
mov qword [rbx + PRNG_SEEDED], 1
|
||||
|
||||
; effacement du contexte SHA
|
||||
mov rdi, r14
|
||||
mov rcx, 14
|
||||
xor eax, eax
|
||||
rep stosq
|
||||
|
||||
add rsp, 128
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; vc_csprng_bytes_i -- interne. rdi = ctx, rsi = sortie, rdx = longueur.
|
||||
;
|
||||
; Cadre de pile (r14) :
|
||||
; [r14 + 0 .. 39] bloc d'entree du hachage : V (32) || BE64(C) (8)
|
||||
; [r14 + 48 .. 79] bloc de sortie du hachage
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_csprng_bytes_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
sub rsp, 80
|
||||
|
||||
mov rbx, rdi ; ctx
|
||||
mov r12, rsi ; sortie
|
||||
mov r13, rdx ; octets restants
|
||||
mov r14, rsp
|
||||
|
||||
.block_loop:
|
||||
test r13, r13
|
||||
jz .refresh
|
||||
|
||||
; --- entree = V || BE64(C)
|
||||
mov rax, [rbx + PRNG_V + 0]
|
||||
mov [r14 + 0], rax
|
||||
mov rax, [rbx + PRNG_V + 8]
|
||||
mov [r14 + 8], rax
|
||||
mov rax, [rbx + PRNG_V + 16]
|
||||
mov [r14 + 16], rax
|
||||
mov rax, [rbx + PRNG_V + 24]
|
||||
mov [r14 + 24], rax
|
||||
mov rax, [rbx + PRNG_C]
|
||||
bswap rax
|
||||
mov [r14 + 32], rax
|
||||
|
||||
mov rdi, r14
|
||||
mov rsi, 40
|
||||
lea rdx, [r14 + 48]
|
||||
call vc_sha256_i
|
||||
|
||||
inc qword [rbx + PRNG_C]
|
||||
|
||||
; --- n = min(32, restant)
|
||||
mov rax, 32
|
||||
cmp r13, rax
|
||||
cmovb rax, r13
|
||||
|
||||
lea rsi, [r14 + 48]
|
||||
mov rdi, r12
|
||||
mov rcx, rax
|
||||
add r12, rax
|
||||
sub r13, rax
|
||||
rep movsb
|
||||
|
||||
jmp .block_loop
|
||||
|
||||
.refresh:
|
||||
; --- V <- SHA256(0x01 || V) : resistance au retour en arriere
|
||||
mov byte [r14 + 0], 0x01
|
||||
mov rax, [rbx + PRNG_V + 0]
|
||||
mov [r14 + 1], rax
|
||||
mov rax, [rbx + PRNG_V + 8]
|
||||
mov [r14 + 9], rax
|
||||
mov rax, [rbx + PRNG_V + 16]
|
||||
mov [r14 + 17], rax
|
||||
mov rax, [rbx + PRNG_V + 24]
|
||||
mov [r14 + 25], rax
|
||||
|
||||
mov rdi, r14
|
||||
mov rsi, 33
|
||||
lea rdx, [rbx + PRNG_V]
|
||||
call vc_sha256_i
|
||||
|
||||
; --- effacement du cadre (il contient V et du flot deja emis)
|
||||
mov rdi, r14
|
||||
mov rcx, 10 ; 80 octets
|
||||
xor eax, eax
|
||||
rep stosq
|
||||
|
||||
add rsp, 80
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; Enveloppes publiques
|
||||
; =============================================================================
|
||||
|
||||
VC_FUNC vc_csprng_seed
|
||||
VC_ARGS ; rdi = ctx, rsi = seed, rdx = len
|
||||
call vc_csprng_seed_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_csprng_reseed
|
||||
VC_ARGS ; rdi = ctx, rsi = seed, rdx = len
|
||||
call vc_csprng_reseed_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_csprng_bytes
|
||||
VC_ARGS ; rdi = ctx, rsi = out, rdx = len
|
||||
call vc_csprng_bytes_i
|
||||
VC_RET
|
||||
@@ -0,0 +1,56 @@
|
||||
; =============================================================================
|
||||
; factory_key.asm -- Cle Maitresse d'Usine (K_M).
|
||||
;
|
||||
; #############################################################
|
||||
; ## ##
|
||||
; ## NE PAS UTILISER EN PRODUCTION. ##
|
||||
; ## La valeur ci-dessous est un PLACEHOLDER DE TEST. ##
|
||||
; ## Elle est publique : elle vit dans un depot, en clair, ##
|
||||
; ## dans un fichier versionne. Tout boitier provisionne ##
|
||||
; ## avec cette cle est dechiffrable par quiconque lit ce ##
|
||||
; ## fichier. ##
|
||||
; ## ##
|
||||
; #############################################################
|
||||
;
|
||||
; K_M est un secret de PROVISIONING, pas un secret derive du protocole. Il sert
|
||||
; a deux choses, et c'est le meme secret dans les deux cas :
|
||||
; - [1] derivation du Grain de Sel Temporel hebdomadaire ;
|
||||
; - [6] Cold Start : cle de repli permettant une resynchronisation apres
|
||||
; perte d'etat.
|
||||
;
|
||||
; TODO PORTAGE STM32U5 -- ce fichier disparait.
|
||||
; Sur cible, K_M vivra dans l'element securise STSAFE-A110, pas en memoire du
|
||||
; microcontroleur. Consequences a traiter au portage :
|
||||
; - vc_factory_key ne retournera plus un pointeur vers de la ROM : les octets
|
||||
; de la cle ne doivent jamais transiter par la RAM du STM32U5 ;
|
||||
; - il faudra donc une API par operation (derivation, deverrouillage) plutot
|
||||
; que par exposition de la cle, et le STSAFE fera le calcul lui-meme ;
|
||||
; - le prototype x86-64 conserve la forme "pointeur" uniquement parce qu'il
|
||||
; n'a pas d'element securise. C'est la difference structurante entre ce
|
||||
; prototype et la cible, pas un simple remplacement de constante.
|
||||
;
|
||||
; Statut de la conception : HYPOTHESE PROVISOIRE, voir docs/adr/0010.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
SECT_RODATA
|
||||
|
||||
align 32
|
||||
; "PLACEHOLDER-NE-PAS-UTILISER-EN-PROD" en ASCII, complete a 32 octets. Le
|
||||
; contenu est volontairement lisible : un vidage memoire ou un dump flash doit
|
||||
; crier qu'on est en configuration de test, pas ressembler a une vraie cle.
|
||||
VC_FACTORY_KEY_PLACEHOLDER:
|
||||
db "PLACEHOLDER-NE-PAS-UTILISER-PROD" ; exactement 32 octets
|
||||
|
||||
section .text
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; const uint8_t *vc_factory_key(void)
|
||||
; Retourne un pointeur vers les 32 octets de K_M.
|
||||
; Sans argument : ni VC_ARGS ni VC_RET (qui depileraient un cadre jamais
|
||||
; empile sous ABI Microsoft).
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_factory_key
|
||||
lea rax, [VC_FACTORY_KEY_PLACEHOLDER]
|
||||
ret
|
||||
@@ -0,0 +1,472 @@
|
||||
; =============================================================================
|
||||
; sha256.asm -- SHA-256 (FIPS 180-4) en assembleur x86-64 pur, sans dependance.
|
||||
;
|
||||
; VERCORS utilise SHA-256 pour deriver l'Heure Cible a partir du Grain de Sel
|
||||
; Temporel. Aucune bibliotheque externe n'est utilisee (contrainte projet).
|
||||
;
|
||||
; API publique (arguments canoniques rdi, rsi, rdx apres traduction VC_ARGS) :
|
||||
; void vc_sha256_init (vc_sha256_ctx *ctx);
|
||||
; void vc_sha256_update(vc_sha256_ctx *ctx, const void *data, size_t len);
|
||||
; void vc_sha256_final (vc_sha256_ctx *ctx, uint8_t out[32]);
|
||||
; void vc_sha256 (const void *data, size_t len, uint8_t out[32]);
|
||||
;
|
||||
; Chaque fonction publique est une enveloppe mince autour d'un coeur interne
|
||||
; (sha256_*_i) qui suit une convention privee purement System V. Cela evite de
|
||||
; devoir respecter l'ABI Microsoft (shadow space, registres a preserver) sur
|
||||
; les appels internes.
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : la logique (planning de message, rondes, constantes)
|
||||
; est portable telle quelle. Sont x86-64-specifiques et a reecrire :
|
||||
; - l'allocation de registres 32 bits (r8d..r15d pour a..h ; en Thumb-2 il
|
||||
; faudra spiller une partie de l'etat sur la pile) ;
|
||||
; - bswap (equivalent Thumb-2 : rev) ;
|
||||
; - rep movsb / rep stosb pour les copies et mises a zero ;
|
||||
; - le tableau W de 256 octets alloue sur la pile, a verifier vis-a-vis de la
|
||||
; taille de pile des taches sur cible embarquee.
|
||||
; Aucune extension SHA-NI n'est utilisee : implementation scalaire, choisie
|
||||
; volontairement pour rester alignee sur ce que fera le Cortex-M33.
|
||||
;
|
||||
; Disposition de vc_sha256_ctx (112 octets, voir include/vercors.h) :
|
||||
; +0 uint32_t state[8]
|
||||
; +32 uint64_t bitlen longueur du message en bits
|
||||
; +40 uint64_t buflen octets en attente dans buf, 0..63
|
||||
; +48 uint8_t buf[64]
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
%define CTX_STATE 0
|
||||
%define CTX_BITLEN 32
|
||||
%define CTX_BUFLEN 40
|
||||
%define CTX_BUF 48
|
||||
%define CTX_SIZE 112
|
||||
|
||||
; =============================================================================
|
||||
SECT_RODATA
|
||||
|
||||
align 64
|
||||
K256:
|
||||
dd 0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5
|
||||
dd 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5
|
||||
dd 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3
|
||||
dd 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174
|
||||
dd 0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc
|
||||
dd 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da
|
||||
dd 0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7
|
||||
dd 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967
|
||||
dd 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13
|
||||
dd 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85
|
||||
dd 0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3
|
||||
dd 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070
|
||||
dd 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5
|
||||
dd 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3
|
||||
dd 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208
|
||||
dd 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2
|
||||
|
||||
align 32
|
||||
H256_INIT:
|
||||
dd 0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a
|
||||
dd 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19
|
||||
|
||||
; =============================================================================
|
||||
section .text
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; Une ronde de compression.
|
||||
; L'etat courant est designe par les macros RA..RH, renommees a chaque ronde
|
||||
; par ROTATE_STATE : cela supprime les 8 mov de decalage par ronde.
|
||||
; Temporaires : eax, ebx, ecx, edx. Le planning W est en [rbp + 4*i].
|
||||
; -----------------------------------------------------------------------------
|
||||
%macro SHA256_ROUND 1
|
||||
; S1 = ror(e,6) ^ ror(e,11) ^ ror(e,25)
|
||||
mov eax, RE
|
||||
mov ebx, RE
|
||||
ror eax, 6
|
||||
ror ebx, 11
|
||||
xor eax, ebx
|
||||
mov ebx, RE
|
||||
ror ebx, 25
|
||||
xor eax, ebx
|
||||
; ch = (e & f) ^ (~e & g)
|
||||
mov ebx, RE
|
||||
and ebx, RF
|
||||
mov ecx, RE
|
||||
not ecx
|
||||
and ecx, RG
|
||||
xor ebx, ecx
|
||||
; T1 = h + S1 + ch + W[i] + K[i]
|
||||
add eax, ebx
|
||||
add eax, RH
|
||||
add eax, [rbp + 4*%1]
|
||||
add eax, [K256 + 4*%1]
|
||||
; S0 = ror(a,2) ^ ror(a,13) ^ ror(a,22)
|
||||
mov ebx, RA
|
||||
mov ecx, RA
|
||||
ror ebx, 2
|
||||
ror ecx, 13
|
||||
xor ebx, ecx
|
||||
mov ecx, RA
|
||||
ror ecx, 22
|
||||
xor ebx, ecx
|
||||
; maj = (a & b) ^ (a & c) ^ (b & c)
|
||||
mov ecx, RA
|
||||
and ecx, RB
|
||||
mov edx, RA
|
||||
and edx, RC
|
||||
xor ecx, edx
|
||||
mov edx, RB
|
||||
and edx, RC
|
||||
xor ecx, edx
|
||||
add ebx, ecx ; T2 = S0 + maj
|
||||
add RD, eax ; e' = d + T1
|
||||
add ebx, eax
|
||||
mov RH, ebx ; a' = T1 + T2
|
||||
%endmacro
|
||||
|
||||
; Renommage circulaire : (a,b,c,d,e,f,g,h) <- (h,a,b,c,d,e,f,g)
|
||||
%macro ROTATE_STATE 0
|
||||
%xdefine RTMP RH
|
||||
%xdefine RH RG
|
||||
%xdefine RG RF
|
||||
%xdefine RF RE
|
||||
%xdefine RE RD
|
||||
%xdefine RD RC
|
||||
%xdefine RC RB
|
||||
%xdefine RB RA
|
||||
%xdefine RA RTMP
|
||||
%endmacro
|
||||
|
||||
; W[i] = W[i-16] + s0(W[i-15]) + W[i-7] + s1(W[i-2])
|
||||
%macro SHA256_EXPAND 1
|
||||
mov eax, [rbp + 4*(%1-15)]
|
||||
mov ebx, eax
|
||||
mov ecx, eax
|
||||
ror ebx, 7
|
||||
ror ecx, 18
|
||||
shr eax, 3
|
||||
xor ebx, ecx
|
||||
xor eax, ebx ; s0
|
||||
mov ebx, [rbp + 4*(%1-2)]
|
||||
mov ecx, ebx
|
||||
mov edx, ebx
|
||||
ror ecx, 17
|
||||
ror edx, 19
|
||||
shr ebx, 10
|
||||
xor ecx, edx
|
||||
xor ebx, ecx ; s1
|
||||
add eax, ebx
|
||||
add eax, [rbp + 4*(%1-16)]
|
||||
add eax, [rbp + 4*(%1-7)]
|
||||
mov [rbp + 4*%1], eax
|
||||
%endmacro
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; sha256_compress -- interne.
|
||||
; rdi = etat (8 dwords), rsi = bloc de 64 octets.
|
||||
; Preserve rdi, rsi, rbx, rbp, r12-r15. Clobber rax, rcx, rdx, r8-r11.
|
||||
; -----------------------------------------------------------------------------
|
||||
sha256_compress:
|
||||
push rbx
|
||||
push rbp
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
push r15
|
||||
sub rsp, 264 ; W[64] = 256 octets, +8 pour l'alignement
|
||||
mov rbp, rsp
|
||||
|
||||
; --- W[0..15] : lecture big-endian du bloc
|
||||
%assign wi 0
|
||||
%rep 16
|
||||
mov eax, [rsi + 4*wi]
|
||||
bswap eax
|
||||
mov [rbp + 4*wi], eax
|
||||
%assign wi wi+1
|
||||
%endrep
|
||||
|
||||
; --- W[16..63] : expansion
|
||||
%assign wi 16
|
||||
%rep 48
|
||||
SHA256_EXPAND wi
|
||||
%assign wi wi+1
|
||||
%endrep
|
||||
|
||||
; --- etat de travail
|
||||
%xdefine RA r8d
|
||||
%xdefine RB r9d
|
||||
%xdefine RC r10d
|
||||
%xdefine RD r11d
|
||||
%xdefine RE r12d
|
||||
%xdefine RF r13d
|
||||
%xdefine RG r14d
|
||||
%xdefine RH r15d
|
||||
|
||||
mov RA, [rdi + 0]
|
||||
mov RB, [rdi + 4]
|
||||
mov RC, [rdi + 8]
|
||||
mov RD, [rdi + 12]
|
||||
mov RE, [rdi + 16]
|
||||
mov RF, [rdi + 20]
|
||||
mov RG, [rdi + 24]
|
||||
mov RH, [rdi + 28]
|
||||
|
||||
; --- 64 rondes. 64 rotations = 8 tours complets : les %xdefine reviennent
|
||||
; exactement a leur affectation initiale, donc r8d..r15d contiennent
|
||||
; bien a..h dans l'ordre au sortir de la boucle.
|
||||
%assign wi 0
|
||||
%rep 64
|
||||
SHA256_ROUND wi
|
||||
ROTATE_STATE
|
||||
%assign wi wi+1
|
||||
%endrep
|
||||
|
||||
add [rdi + 0], r8d
|
||||
add [rdi + 4], r9d
|
||||
add [rdi + 8], r10d
|
||||
add [rdi + 12], r11d
|
||||
add [rdi + 16], r12d
|
||||
add [rdi + 20], r13d
|
||||
add [rdi + 24], r14d
|
||||
add [rdi + 28], r15d
|
||||
|
||||
add rsp, 264
|
||||
pop r15
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbp
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; Les symboles *_i sont exportes non pas pour du code C, mais pour que les
|
||||
; autres modules ASM du projet (csprng.asm, vercors_protocol.asm) puissent les
|
||||
; appeler avec la convention privee System V, sans avoir a respecter l'ABI
|
||||
; Microsoft (shadow space) sur des appels purement internes.
|
||||
; -----------------------------------------------------------------------------
|
||||
global sha256_init_i
|
||||
global sha256_update_i
|
||||
global sha256_final_i
|
||||
global vc_sha256_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; sha256_init_i -- interne. rdi = ctx.
|
||||
; -----------------------------------------------------------------------------
|
||||
sha256_init_i:
|
||||
lea rax, [H256_INIT]
|
||||
mov rcx, [rax + 0]
|
||||
mov [rdi + CTX_STATE + 0], rcx
|
||||
mov rcx, [rax + 8]
|
||||
mov [rdi + CTX_STATE + 8], rcx
|
||||
mov rcx, [rax + 16]
|
||||
mov [rdi + CTX_STATE + 16], rcx
|
||||
mov rcx, [rax + 24]
|
||||
mov [rdi + CTX_STATE + 24], rcx
|
||||
mov qword [rdi + CTX_BITLEN], 0
|
||||
mov qword [rdi + CTX_BUFLEN], 0
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; sha256_update_i -- interne. rdi = ctx, rsi = data, rdx = len.
|
||||
; Clobber rax, rcx, rdx, rsi, rdi, rbx, r8-r15 (les callee-saved utilises
|
||||
; sont sauves ici meme).
|
||||
; -----------------------------------------------------------------------------
|
||||
sha256_update_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
|
||||
test rdx, rdx
|
||||
jz .done
|
||||
|
||||
mov r13, rdi ; ctx
|
||||
mov r12, rsi ; data
|
||||
mov rbx, rdx ; octets restants
|
||||
|
||||
mov rax, rbx
|
||||
shl rax, 3
|
||||
add [r13 + CTX_BITLEN], rax
|
||||
|
||||
mov rcx, [r13 + CTX_BUFLEN]
|
||||
test rcx, rcx
|
||||
jz .main_loop
|
||||
|
||||
; --- des octets sont deja en attente : completer le buffer
|
||||
mov rax, 64
|
||||
sub rax, rcx ; place libre
|
||||
cmp rbx, rax
|
||||
jae .fill_full
|
||||
|
||||
; pas de quoi remplir un bloc : on empile et on sort
|
||||
lea rdi, [r13 + rcx + CTX_BUF]
|
||||
mov rsi, r12
|
||||
mov rcx, rbx
|
||||
rep movsb
|
||||
add [r13 + CTX_BUFLEN], rbx
|
||||
jmp .done
|
||||
|
||||
.fill_full:
|
||||
lea rdi, [r13 + rcx + CTX_BUF]
|
||||
mov rsi, r12
|
||||
mov rcx, rax
|
||||
add r12, rax
|
||||
sub rbx, rax
|
||||
rep movsb
|
||||
mov qword [r13 + CTX_BUFLEN], 0
|
||||
mov rdi, r13
|
||||
lea rsi, [r13 + CTX_BUF]
|
||||
call sha256_compress
|
||||
|
||||
.main_loop:
|
||||
cmp rbx, 64
|
||||
jb .tail
|
||||
mov rdi, r13
|
||||
mov rsi, r12
|
||||
call sha256_compress
|
||||
add r12, 64
|
||||
sub rbx, 64
|
||||
jmp .main_loop
|
||||
|
||||
.tail:
|
||||
test rbx, rbx
|
||||
jz .done
|
||||
lea rdi, [r13 + CTX_BUF]
|
||||
mov rsi, r12
|
||||
mov rcx, rbx
|
||||
rep movsb
|
||||
mov [r13 + CTX_BUFLEN], rbx
|
||||
|
||||
.done:
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; sha256_final_i -- interne. rdi = ctx, rsi = out[32].
|
||||
; -----------------------------------------------------------------------------
|
||||
sha256_final_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
|
||||
mov r13, rdi ; ctx
|
||||
mov r12, rsi ; out
|
||||
mov rbx, [r13 + CTX_BITLEN] ; a sauver : le padding ecrit dans le buffer
|
||||
|
||||
; --- octet de bourrage 0x80
|
||||
mov rcx, [r13 + CTX_BUFLEN]
|
||||
mov byte [r13 + rcx + CTX_BUF], 0x80
|
||||
inc rcx
|
||||
|
||||
; --- s'il ne reste pas 8 octets pour la longueur, fermer ce bloc d'abord
|
||||
cmp rcx, 56
|
||||
jbe .pad_tail
|
||||
|
||||
lea rdi, [r13 + rcx + CTX_BUF]
|
||||
mov rax, 64
|
||||
sub rax, rcx
|
||||
mov rcx, rax
|
||||
xor eax, eax
|
||||
rep stosb
|
||||
mov rdi, r13
|
||||
lea rsi, [r13 + CTX_BUF]
|
||||
call sha256_compress
|
||||
xor ecx, ecx
|
||||
|
||||
.pad_tail:
|
||||
; zeros de rcx jusqu'a l'offset 56
|
||||
lea rdi, [r13 + rcx + CTX_BUF]
|
||||
mov rax, 56
|
||||
sub rax, rcx
|
||||
mov rcx, rax
|
||||
xor eax, eax
|
||||
rep stosb
|
||||
|
||||
; --- longueur en bits, big-endian, sur les 8 derniers octets
|
||||
mov rax, rbx
|
||||
bswap rax
|
||||
mov [r13 + CTX_BUF + 56], rax
|
||||
|
||||
mov rdi, r13
|
||||
lea rsi, [r13 + CTX_BUF]
|
||||
call sha256_compress
|
||||
|
||||
; --- sortie big-endian
|
||||
%assign oi 0
|
||||
%rep 8
|
||||
mov eax, [r13 + CTX_STATE + 4*oi]
|
||||
bswap eax
|
||||
mov [r12 + 4*oi], eax
|
||||
%assign oi oi+1
|
||||
%endrep
|
||||
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; Enveloppes publiques
|
||||
; =============================================================================
|
||||
|
||||
VC_FUNC vc_sha256_init
|
||||
VC_ARGS ; rdi = ctx
|
||||
call sha256_init_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_sha256_update
|
||||
VC_ARGS ; rdi = ctx, rsi = data, rdx = len
|
||||
call sha256_update_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_sha256_final
|
||||
VC_ARGS ; rdi = ctx, rsi = out
|
||||
call sha256_final_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_sha256
|
||||
VC_ARGS ; rdi = data, rsi = len, rdx = out
|
||||
call vc_sha256_i
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; vc_sha256_i -- one-shot, convention interne.
|
||||
; rdi = data, rsi = len, rdx = out[32]
|
||||
; Le contexte vit sur la pile et est efface avant retour : il contient des
|
||||
; octets de message clair (ici, le Grain de Sel).
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_sha256_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
sub rsp, 128 ; >= CTX_SIZE (112)
|
||||
|
||||
mov r12, rdi
|
||||
mov r13, rsi
|
||||
mov r14, rdx
|
||||
mov rbx, rsp ; ctx
|
||||
|
||||
mov rdi, rbx
|
||||
call sha256_init_i
|
||||
mov rdi, rbx
|
||||
mov rsi, r12
|
||||
mov rdx, r13
|
||||
call sha256_update_i
|
||||
mov rdi, rbx
|
||||
mov rsi, r14
|
||||
call sha256_final_i
|
||||
|
||||
; effacement du contexte (112 octets = 14 qwords)
|
||||
mov rdi, rbx
|
||||
mov rcx, CTX_SIZE / 8
|
||||
xor eax, eax
|
||||
rep stosq
|
||||
|
||||
add rsp, 128
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
@@ -0,0 +1,568 @@
|
||||
; =============================================================================
|
||||
; vercors_keysched.asm -- points [1], [3], [5] et [6] du protocole VERCORS.
|
||||
;
|
||||
; Grain de Sel Temporel, Fenetre de Garde Dynamique, bascule de cle
|
||||
; steganographique, Cold Start.
|
||||
;
|
||||
; #############################################################################
|
||||
; ## HYPOTHESES PROVISOIRES -- A VALIDER AVANT TOUT DEPLOIEMENT REEL ##
|
||||
; ## ##
|
||||
; ## Le manifeste Gastinel Frame ne descend pas jusqu'a ce niveau de detail. ##
|
||||
; ## Les constructions de ce fichier reposent sur des hypotheses fournies ##
|
||||
; ## oralement et completees ici par des choix d'encodage. Chaque choix est ##
|
||||
; ## signale par le marqueur HYPOTHESE et documente dans docs/adr/0007 a ##
|
||||
; ## 0010. Aucun n'a valeur de specification figee. ##
|
||||
; #############################################################################
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : la logique est portable. Sont x86-64-specifiques et
|
||||
; signales sur place : div (Fenetre de Garde), bswap, xchg al/ah, rep movsb,
|
||||
; sbb/cmov pour l'arithmetique de masque.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
extern vc_sha256_i
|
||||
extern vc_csprng_bytes_i
|
||||
extern aes256_ctr_xor_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; [1] Grain de Sel -- constantes d'encodage
|
||||
;
|
||||
; HYPOTHESE : grain = SHA256( K_M(32) || semaine_ISO(uint16 BE) ||
|
||||
; compteur_anti_rejeu(uint32 BE) )
|
||||
;
|
||||
; Le numero de semaine ISO est encode sur 16 bits en big-endian, et le compteur
|
||||
; anti-rejeu sur 32 bits en big-endian, par coherence avec l'ordre reseau deja
|
||||
; retenu pour l'Heure Cible.
|
||||
;
|
||||
; POINT OUVERT SIGNALE : l'epoque d'origine des semaines n'est pas definie. Un
|
||||
; uint16 ne porte pas d'annee : "semaine 36" est ambigu sans point de depart.
|
||||
; Deux implementations qui ne partent pas de la meme origine deriveront des
|
||||
; grains differents et ne se parleront jamais. Voir docs/adr/0007.
|
||||
; -----------------------------------------------------------------------------
|
||||
%define GRAIN_INPUT_BYTES 38 ; 32 + 2 + 4
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; [3] Fenetre de Garde Dynamique -- constantes
|
||||
;
|
||||
; HYPOTHESE : elargissement LINEAIRE avec le temps ecoule depuis le dernier
|
||||
; paquet valide, PLAFONNE. Resserrement immediat des reception valide.
|
||||
;
|
||||
; demi_largeur(ecoule) = min( GUARD_MIN + ecoule * DRIFT_PPM / 1e6,
|
||||
; GUARD_MAX )
|
||||
;
|
||||
; La pente n'est pas arbitraire : elle suit la derive du quartz. Un LSE
|
||||
; d'horlogerie a 20 ppm derive de 20 us par seconde, soit environ 1,73 s par
|
||||
; jour. La fenetre s'ouvre donc exactement au rythme ou l'incertitude d'horloge
|
||||
; grandit, ni plus ni moins -- c'est ce qui evite d'ouvrir une fenetre d'attaque
|
||||
; plus large que necessaire.
|
||||
;
|
||||
; Le plafond de 30 s borne la croissance meme apres plusieurs jours de silence
|
||||
; radio : sans lui, un boitier oublie finirait par accepter n'importe quel
|
||||
; instant, ce qui annulerait le gating temporel. Avec 20 ppm, le plafond est
|
||||
; atteint apres environ 16 jours de silence -- au-dela, la resynchronisation
|
||||
; Cold Start [6] prend le relais.
|
||||
; -----------------------------------------------------------------------------
|
||||
%define GUARD_MIN_SECONDS 2 ; HYPOTHESE : demi-largeur au repos
|
||||
%define GUARD_MAX_SECONDS 30 ; plafond fourni, a valider
|
||||
%define GUARD_DRIFT_PPM 20 ; HYPOTHESE : derive du quartz LSE
|
||||
|
||||
; Disposition de vc_guard_ctx (16 octets)
|
||||
%define GUARD_LAST_VALID 0 ; uint32 instant du dernier paquet valide
|
||||
%define GUARD_OFFSET 4 ; int32 correction d'horloge appliquee
|
||||
%define GUARD_WIDTH 8 ; uint32 demi-largeur courante (cache)
|
||||
%define GUARD_FLAGS 12 ; uint32 bit 0 = deja synchronise
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; [5] Bascule de cle -- disposition de trame
|
||||
;
|
||||
; HYPOTHESE : la cle du jour suivant (32 octets) est chiffree avec la cle du
|
||||
; jour COURANT, puis logee dans la zone de bourrage. C'est un chainage de cles
|
||||
; (cle N+1 protegee par cle N), pas un envoi en clair.
|
||||
;
|
||||
; octet 0 : bit 7 = drapeau de bascule ; bits 0-6 = longueur utile L
|
||||
; octets 1..L : charge utile
|
||||
; sans bascule : octets L+1..63 = bruit CSPRNG
|
||||
; avec bascule : octets L+1..31 = bruit CSPRNG
|
||||
; octets 32..63 = cle N+1 chiffree sous la cle du jour
|
||||
;
|
||||
; Indifferenciabilite : le creneau de cle est du chiffre AES, donc uniforme,
|
||||
; donc indistinguable du bruit CSPRNG qui l'entoure. Et la trame entiere est
|
||||
; ensuite rechiffree par l'appelant sous la cle de trame : le drapeau lui-meme
|
||||
; n'est jamais observable sur l'air. La taille reste 64 octets dans tous les
|
||||
; cas, avec ou sans bascule -- c'est ce que le cas C du manifeste exige.
|
||||
;
|
||||
; DOMAINE DE COMPTEUR : le creneau de cle est chiffre avec un compteur dont
|
||||
; l'octet 0 vaut VC_CTR_DOMAIN_KEYWRAP (0x01), alors que les trames utilisent
|
||||
; VC_CTR_DOMAIN_FRAME (0x00). Sans cette separation, le meme flot de cle
|
||||
; servirait deux fois sous la meme cle du jour, ce qui revelerait le XOR des
|
||||
; deux clairs -- la faute mortelle du mode CTR.
|
||||
; -----------------------------------------------------------------------------
|
||||
%define FRAME_FLAG_KEYSW 0x80
|
||||
%define FRAME_LEN_MASK 0x7f
|
||||
%define FRAME_KEYSLOT_OFF 32
|
||||
%define FRAME_MAXPAYLOAD 63 ; sans bascule
|
||||
%define FRAME_KEYSW_MAXPAYLOAD 31 ; avec bascule
|
||||
|
||||
; Disposition de vc_frame_req (48 octets)
|
||||
%define REQ_RNG 0
|
||||
%define REQ_PAYLOAD 8
|
||||
%define REQ_LEN 16
|
||||
%define REQ_NEXTKEY 24 ; NULL = pas de bascule
|
||||
%define REQ_DAY_RK 32
|
||||
%define REQ_KEY_CTR 40
|
||||
|
||||
; Disposition de vc_frame_out (112 octets)
|
||||
%define OUT_PAYLOAD 0 ; 64 octets
|
||||
%define OUT_LEN 64
|
||||
%define OUT_HAS_KEY 72
|
||||
%define OUT_NEXTKEY 80 ; 32 octets
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; [6] Cold Start
|
||||
;
|
||||
; HYPOTHESE : la resynchronisation est declenchee localement, sans signalisation
|
||||
; dedie sur l'air. Deux causes, une seule consequence :
|
||||
; - aucun paquet valide depuis COLDSTART_TIMEOUT (le grain etant hebdomadaire,
|
||||
; un silence depassant la semaine signifie que le grain courant est perime
|
||||
; des deux cotes) ;
|
||||
; - demarrage sans etat de synchronisation (bit GUARD_FLAGS.0 a zero), cas du
|
||||
; reboot.
|
||||
; Dans les deux cas le boitier bascule temporairement sur K_M, le temps d'un
|
||||
; echange de resynchronisation, puis repasse sur la derivation normale.
|
||||
; -----------------------------------------------------------------------------
|
||||
%define COLDSTART_TIMEOUT 604800 ; 7 jours, aligne sur la periode du grain
|
||||
|
||||
; =============================================================================
|
||||
section .text
|
||||
|
||||
global vc_derive_grain_i
|
||||
global vc_guard_width_i
|
||||
global vc_frame_build_i
|
||||
global vc_frame_parse_i
|
||||
|
||||
; =============================================================================
|
||||
; [1] GRAIN DE SEL TEMPOREL
|
||||
; =============================================================================
|
||||
; void vc_derive_grain(const uint8_t km[32], uint32_t week_iso,
|
||||
; uint32_t replay_counter, uint8_t out[32])
|
||||
;
|
||||
; grain = SHA256( K_M || BE16(week_iso) || BE32(replay_counter) )
|
||||
;
|
||||
; Rien de ce calcul ne passe par la radio : emetteur et recepteur, partageant
|
||||
; K_M et s'accordant sur la semaine, obtiennent le meme grain chacun de leur
|
||||
; cote. C'est la propriete centrale du protocole -- le secret ne circule jamais.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_derive_grain_i:
|
||||
push rbx
|
||||
push r12
|
||||
sub rsp, 48 ; tampon de GRAIN_INPUT_BYTES octets
|
||||
|
||||
mov rbx, rsp
|
||||
mov r12, rcx ; out
|
||||
|
||||
; --- K_M
|
||||
mov rax, [rdi + 0]
|
||||
mov [rbx + 0], rax
|
||||
mov rax, [rdi + 8]
|
||||
mov [rbx + 8], rax
|
||||
mov rax, [rdi + 16]
|
||||
mov [rbx + 16], rax
|
||||
mov rax, [rdi + 24]
|
||||
mov [rbx + 24], rax
|
||||
|
||||
; --- semaine ISO, uint16 big-endian
|
||||
mov eax, esi
|
||||
xchg al, ah ; bswap 16 bits (pas de REX : eax/ah ok)
|
||||
mov [rbx + 32], ax
|
||||
|
||||
; --- compteur anti-rejeu, uint32 big-endian
|
||||
mov eax, edx
|
||||
bswap eax
|
||||
mov [rbx + 34], eax
|
||||
|
||||
mov rdi, rbx
|
||||
mov rsi, GRAIN_INPUT_BYTES
|
||||
mov rdx, r12
|
||||
call vc_sha256_i
|
||||
|
||||
; --- effacement du tampon : il contient K_M en clair
|
||||
xor eax, eax
|
||||
mov [rbx + 0], rax
|
||||
mov [rbx + 8], rax
|
||||
mov [rbx + 16], rax
|
||||
mov [rbx + 24], rax
|
||||
mov [rbx + 32], rax
|
||||
|
||||
add rsp, 48
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; [3] FENETRE DE GARDE DYNAMIQUE
|
||||
; =============================================================================
|
||||
; uint32_t vc_guard_width(uint32_t elapsed_sec)
|
||||
; demi-largeur = min(GUARD_MIN + elapsed * DRIFT_PPM / 1e6, GUARD_MAX)
|
||||
;
|
||||
; Le calcul se fait en 64 bits : elapsed * 20 deborderait un uint32 au-dela de
|
||||
; 6,8 ans d'ecoule, ce qui est court a l'echelle d'un boitier laisse en place.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_guard_width_i:
|
||||
mov eax, edi ; zero-extension vers rax
|
||||
imul rax, rax, GUARD_DRIFT_PPM
|
||||
xor edx, edx
|
||||
mov ecx, 1000000
|
||||
div rcx ; rax = elapsed * ppm / 1e6
|
||||
add rax, GUARD_MIN_SECONDS
|
||||
mov rcx, GUARD_MAX_SECONDS
|
||||
cmp rax, rcx
|
||||
cmova rax, rcx ; plafonnement
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_guard_init(vc_guard_ctx *g)
|
||||
; Etat non synchronise : le Cold Start sera exige au premier controle.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_guard_init
|
||||
VC_ARGS ; rdi = g
|
||||
mov dword [rdi + GUARD_LAST_VALID], 0
|
||||
mov dword [rdi + GUARD_OFFSET], 0
|
||||
mov dword [rdi + GUARD_WIDTH], GUARD_MIN_SECONDS
|
||||
mov dword [rdi + GUARD_FLAGS], 0
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_guard_on_valid(vc_guard_ctx *g, uint32_t local_sec, uint32_t ref_sec)
|
||||
; Paquet valide recu : resserrement de la fenetre a sa largeur minimale, et
|
||||
; recalage d'horloge.
|
||||
;
|
||||
; Le recalage est memorise comme un DECALAGE (ref - local) plutot qu'applique
|
||||
; a l'horloge : ecrire directement dans l'horloge locale ferait sauter le
|
||||
; temps en arriere, ce qui casserait toute autre temporisation en cours dans
|
||||
; le firmware. Le decalage est ajoute au moment des comparaisons, pas avant.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_guard_on_valid
|
||||
VC_ARGS ; rdi = g, esi = local_sec, edx = ref_sec
|
||||
mov [rdi + GUARD_LAST_VALID], esi
|
||||
mov eax, edx
|
||||
sub eax, esi ; decalage signe ref - local
|
||||
mov [rdi + GUARD_OFFSET], eax
|
||||
mov dword [rdi + GUARD_WIDTH], GUARD_MIN_SECONDS
|
||||
or dword [rdi + GUARD_FLAGS], 1
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; uint32_t vc_guard_width_now(vc_guard_ctx *g, uint32_t now_sec)
|
||||
; Demi-largeur courante, et mise a jour du cache dans le contexte.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_guard_width_now
|
||||
VC_ARGS ; rdi = g, esi = now_sec
|
||||
push rbx
|
||||
mov rbx, rdi
|
||||
|
||||
mov eax, esi
|
||||
sub eax, [rbx + GUARD_LAST_VALID]
|
||||
; Une horloge qui recule (now < dernier valide) donnerait un ecoule
|
||||
; gigantesque par bouclage non signe, donc une fenetre plafonnee : on borne
|
||||
; a zero, ce qui redonne la largeur minimale.
|
||||
mov ecx, eax
|
||||
sar ecx, 31 ; -1 si negatif
|
||||
not ecx
|
||||
and eax, ecx
|
||||
|
||||
mov edi, eax
|
||||
call vc_guard_width_i
|
||||
mov [rbx + GUARD_WIDTH], eax
|
||||
|
||||
pop rbx
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; uint64_t vc_gate_accept_window(uint32_t arrival_sec, uint32_t target_sec,
|
||||
; uint32_t width_sec)
|
||||
; Masque tout-a-un si la trame est recevable.
|
||||
;
|
||||
; Recevable <=> arrival >= target - width (avec saturation a zero)
|
||||
;
|
||||
; Seul le bord INFERIEUR est relache. La Fenetre de Garde existe pour tolerer
|
||||
; la derive d'horloge sur un paquet legitime arrive un peu tot ; elle n'a pas
|
||||
; a fermer le bord superieur, puisque le protocole prevoit explicitement que
|
||||
; le premier message utile arrive APRES l'Heure Cible [5]. Poser une borne
|
||||
; haute rejetterait ce message-la.
|
||||
;
|
||||
; Sans branchement : l'Heure Cible derive du Grain de Sel, c'est un secret.
|
||||
; Un saut conditionnel rendrait l'ecart mesurable et permettrait de localiser
|
||||
; l'Heure Cible par dichotomie en faisant varier l'instant d'emission.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_gate_accept_window
|
||||
VC_ARGS ; edi = arrival, esi = target, edx = width
|
||||
mov eax, esi
|
||||
sub eax, edx ; target - width
|
||||
sbb ecx, ecx ; -1 si depassement par le bas
|
||||
not ecx ; 0 si depassement, -1 sinon
|
||||
and eax, ecx ; saturation a zero
|
||||
cmp edi, eax ; CF = 1 si arrival < seuil
|
||||
sbb rax, rax ; -1 si trop tot
|
||||
not rax ; -1 si recevable
|
||||
VC_RET
|
||||
|
||||
; =============================================================================
|
||||
; [6] COLD START
|
||||
; =============================================================================
|
||||
; int vc_coldstart_needed(const vc_guard_ctx *g, uint32_t now_sec)
|
||||
; 1 si une resynchronisation sur K_M est requise, 0 sinon.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_coldstart_needed
|
||||
VC_ARGS ; rdi = g, esi = now_sec
|
||||
; --- jamais synchronise (reboot, premier demarrage) ?
|
||||
mov eax, [rdi + GUARD_FLAGS]
|
||||
and eax, 1
|
||||
xor eax, 1 ; 1 si le bit de synchro est absent
|
||||
mov ecx, eax
|
||||
|
||||
; --- silence trop long ?
|
||||
mov eax, esi
|
||||
sub eax, [rdi + GUARD_LAST_VALID]
|
||||
mov edx, eax
|
||||
sar edx, 31
|
||||
not edx
|
||||
and eax, edx ; borne a zero si l'horloge a recule
|
||||
cmp eax, COLDSTART_TIMEOUT
|
||||
setae al
|
||||
movzx eax, al
|
||||
|
||||
or eax, ecx
|
||||
VC_RET
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; void vc_ctr_set_domain(uint8_t ctr[16], uint8_t domain)
|
||||
; Fixe l'octet de separation de domaine du compteur CTR.
|
||||
; Voir la note DOMAINE DE COMPTEUR en tete de fichier : c'est ce qui empeche
|
||||
; le creneau de cle et la trame de partager un flot de cle.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_ctr_set_domain
|
||||
VC_ARGS ; rdi = ctr, esi = domain
|
||||
mov [rdi], sil
|
||||
VC_RET
|
||||
|
||||
; =============================================================================
|
||||
; [5] CONSTRUCTION ET LECTURE DE TRAME, AVEC BASCULE DE CLE
|
||||
; =============================================================================
|
||||
; int vc_frame_build(const vc_frame_req *req, uint8_t out[64])
|
||||
; 0 si construite, -1 si la charge utile ne tient pas.
|
||||
;
|
||||
; Passage par structure et non par arguments separes : la requete en compte
|
||||
; six, or le cinquieme et le sixieme passeraient par la pile sous ABI
|
||||
; Microsoft, a un decalage qui depend des registres empiles par VC_ARGS. La
|
||||
; structure supprime ce piege et rend la signature stable entre les ABI.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_frame_build_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
push r15
|
||||
sub rsp, 32 ; copie locale du compteur de creneau
|
||||
|
||||
mov r12, rdi ; req
|
||||
mov r13, rsi ; out
|
||||
mov r14, [r12 + REQ_LEN] ; longueur utile
|
||||
mov r15, [r12 + REQ_NEXTKEY] ; cle N+1, ou NULL
|
||||
|
||||
test r15, r15
|
||||
jz .no_switch
|
||||
|
||||
cmp r14, FRAME_KEYSW_MAXPAYLOAD
|
||||
ja .too_long
|
||||
mov al, r14b
|
||||
or al, FRAME_FLAG_KEYSW
|
||||
jmp .write_hdr
|
||||
|
||||
.no_switch:
|
||||
cmp r14, FRAME_MAXPAYLOAD
|
||||
ja .too_long
|
||||
mov al, r14b
|
||||
|
||||
.write_hdr:
|
||||
mov [r13], al
|
||||
|
||||
; --- charge utile
|
||||
test r14, r14
|
||||
jz .fill
|
||||
lea rdi, [r13 + 1]
|
||||
mov rsi, [r12 + REQ_PAYLOAD]
|
||||
mov rcx, r14
|
||||
rep movsb
|
||||
|
||||
.fill:
|
||||
; --- bruit CSPRNG sur la place restante
|
||||
mov rdi, [r12 + REQ_RNG]
|
||||
lea rsi, [r13 + r14 + 1]
|
||||
test r15, r15
|
||||
jz .fill_full
|
||||
mov rdx, FRAME_KEYSW_MAXPAYLOAD ; jusqu'a l'octet 31 inclus
|
||||
jmp .fill_go
|
||||
.fill_full:
|
||||
mov rdx, FRAME_MAXPAYLOAD
|
||||
.fill_go:
|
||||
sub rdx, r14
|
||||
test rdx, rdx
|
||||
jz .keyslot
|
||||
call vc_csprng_bytes_i
|
||||
|
||||
.keyslot:
|
||||
test r15, r15
|
||||
jz .ok
|
||||
|
||||
; --- cle N+1 dans le creneau
|
||||
mov rax, [r15 + 0]
|
||||
mov [r13 + FRAME_KEYSLOT_OFF + 0], rax
|
||||
mov rax, [r15 + 8]
|
||||
mov [r13 + FRAME_KEYSLOT_OFF + 8], rax
|
||||
mov rax, [r15 + 16]
|
||||
mov [r13 + FRAME_KEYSLOT_OFF + 16], rax
|
||||
mov rax, [r15 + 24]
|
||||
mov [r13 + FRAME_KEYSLOT_OFF + 24], rax
|
||||
|
||||
; --- compteur de creneau : copie locale, l'appelant garde le sien intact
|
||||
mov rbx, rsp
|
||||
mov rax, [r12 + REQ_KEY_CTR]
|
||||
mov rcx, [rax + 0]
|
||||
mov [rbx + 0], rcx
|
||||
mov rcx, [rax + 8]
|
||||
mov [rbx + 8], rcx
|
||||
|
||||
; --- chiffrement de la cle N+1 sous la cle du JOUR COURANT
|
||||
mov rdi, [r12 + REQ_DAY_RK]
|
||||
mov rsi, rbx
|
||||
lea rdx, [r13 + FRAME_KEYSLOT_OFF]
|
||||
mov rcx, 32
|
||||
call aes256_ctr_xor_i
|
||||
|
||||
.ok:
|
||||
xor eax, eax
|
||||
jmp .done
|
||||
.too_long:
|
||||
mov eax, -1
|
||||
.done:
|
||||
add rsp, 32
|
||||
pop r15
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; int vc_frame_parse(const uint8_t in[64], const vc_aes_rk *day_rk,
|
||||
; const uint8_t *key_ctr, vc_frame_out *out)
|
||||
; 0 si l'en-tete est coherent, -1 sinon.
|
||||
;
|
||||
; ATTENTION : ce n'est pas un controle d'integrite. Sous CTR, un attaquant
|
||||
; peut retourner des bits arbitraires du clair, y compris le drapeau de
|
||||
; bascule. L'absence de MAC reste le point ouvert de l'ADR 0003 -- et elle est
|
||||
; plus grave ici qu'ailleurs : sans authentification, un attaquant peut
|
||||
; corrompre le creneau de cle et provoquer une desynchronisation durable des
|
||||
; deux extremites.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_frame_parse_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
push r15
|
||||
sub rsp, 32
|
||||
|
||||
mov r12, rdi ; trame en clair
|
||||
mov r14, rsi ; cle du jour
|
||||
mov r15, rdx ; compteur de creneau
|
||||
mov r13, rcx ; sortie
|
||||
|
||||
movzx eax, byte [r12]
|
||||
mov ebx, eax
|
||||
and ebx, FRAME_LEN_MASK ; longueur utile
|
||||
shr eax, 7 ; drapeau de bascule, 0 ou 1
|
||||
mov [r13 + OUT_HAS_KEY], rax
|
||||
|
||||
test eax, eax
|
||||
jz .plain
|
||||
cmp ebx, FRAME_KEYSW_MAXPAYLOAD
|
||||
ja .bad
|
||||
jmp .copy
|
||||
.plain:
|
||||
cmp ebx, FRAME_MAXPAYLOAD
|
||||
ja .bad
|
||||
|
||||
.copy:
|
||||
mov [r13 + OUT_LEN], rbx
|
||||
test rbx, rbx
|
||||
jz .keyslot
|
||||
lea rdi, [r13 + OUT_PAYLOAD]
|
||||
lea rsi, [r12 + 1]
|
||||
mov rcx, rbx
|
||||
rep movsb
|
||||
|
||||
.keyslot:
|
||||
mov rax, [r13 + OUT_HAS_KEY]
|
||||
test rax, rax
|
||||
jz .ok
|
||||
|
||||
mov rax, [r12 + FRAME_KEYSLOT_OFF + 0]
|
||||
mov [r13 + OUT_NEXTKEY + 0], rax
|
||||
mov rax, [r12 + FRAME_KEYSLOT_OFF + 8]
|
||||
mov [r13 + OUT_NEXTKEY + 8], rax
|
||||
mov rax, [r12 + FRAME_KEYSLOT_OFF + 16]
|
||||
mov [r13 + OUT_NEXTKEY + 16], rax
|
||||
mov rax, [r12 + FRAME_KEYSLOT_OFF + 24]
|
||||
mov [r13 + OUT_NEXTKEY + 24], rax
|
||||
|
||||
mov rbx, rsp
|
||||
mov rax, [r15 + 0]
|
||||
mov [rbx + 0], rax
|
||||
mov rax, [r15 + 8]
|
||||
mov [rbx + 8], rax
|
||||
|
||||
mov rdi, r14
|
||||
mov rsi, rbx
|
||||
lea rdx, [r13 + OUT_NEXTKEY]
|
||||
mov rcx, 32
|
||||
call aes256_ctr_xor_i
|
||||
|
||||
.ok:
|
||||
xor eax, eax
|
||||
jmp .done
|
||||
.bad:
|
||||
mov eax, -1
|
||||
.done:
|
||||
add rsp, 32
|
||||
pop r15
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; Enveloppes publiques
|
||||
; =============================================================================
|
||||
|
||||
VC_FUNC vc_derive_grain
|
||||
VC_ARGS ; rdi=km, esi=week, edx=replay, rcx=out
|
||||
call vc_derive_grain_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_guard_width
|
||||
VC_ARGS ; edi = elapsed
|
||||
call vc_guard_width_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_frame_build
|
||||
VC_ARGS ; rdi = req, rsi = out
|
||||
call vc_frame_build_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_frame_parse
|
||||
VC_ARGS ; rdi=in, rsi=rk, rdx=key_ctr, rcx=out
|
||||
call vc_frame_parse_i
|
||||
VC_RET
|
||||
@@ -0,0 +1,297 @@
|
||||
; =============================================================================
|
||||
; vercors_protocol.asm -- logique protocolaire VERCORS.
|
||||
;
|
||||
; ETAT DE CE FICHIER -- A LIRE AVANT DE L'ETENDRE
|
||||
; -----------------------------------------------
|
||||
; Le prompt demande de se baser strictement sur la description VERCORS du
|
||||
; manifeste Gastinel Frame, et d'interroger plutot que de supposer. Le dossier
|
||||
; ..\Gastinel Frame est vide sur cette machine : le manifeste n'a pas pu etre
|
||||
; lu. En consequence ce module implemente UNIQUEMENT les points que le prompt
|
||||
; lui-meme specifie de bout en bout :
|
||||
;
|
||||
; [2] Heure Cible -- entierement specifiee, implementee ici.
|
||||
; [4] Gating temporel -- ordre impose, implemente ici.
|
||||
; [7] Bourrage 64 octets -- implemente ici, SAUF la disposition interne de
|
||||
; la trame, qui est une hypothese explicite (voir
|
||||
; FRAME_LAYOUT ci-dessous).
|
||||
; [8] Chiffrement CTR -- fourni par aes256.asm, cable ici.
|
||||
;
|
||||
; NE SONT PAS IMPLEMENTES, faute de specification, et NON DEVINES :
|
||||
; [1] Grain de Sel Temporel -- la derivation hebdomadaire identique des deux
|
||||
; cotes sans transmission du secret suppose une
|
||||
; racine partagee et une numerotation de semaine
|
||||
; dont la definition est dans le manifeste.
|
||||
; [3] Fenetre de Garde -- aucune valeur numerique connue (largeur
|
||||
; initiale, loi d'elargissement, plafond).
|
||||
; [5] Bascule de cle stegano -- aucun schema de dissimulation connu.
|
||||
; [6] Cold Start -- ni detection de reboot, ni definition de la
|
||||
; Cle Maitresse d'Usine.
|
||||
; Voir README.md, section "Points bloques sur specification".
|
||||
;
|
||||
; PORTABILITE Cortex-M33 : la logique est portable. Sont x86-64-specifiques :
|
||||
; - l'instruction div pour le reste modulo 86400 (le M33 n'a pas de division
|
||||
; entiere materielle avec reste sur 64 bits ; il faudra udiv + mls, ou une
|
||||
; reduction par soustractions constantes en temps) ;
|
||||
; - bswap (rev en Thumb-2) ;
|
||||
; - rep movsb.
|
||||
; =============================================================================
|
||||
|
||||
%include "abi.inc"
|
||||
|
||||
extern vc_sha256_i
|
||||
extern vc_csprng_bytes_i
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; Constantes du protocole
|
||||
; -----------------------------------------------------------------------------
|
||||
%define VC_DAY_SECONDS 86400 ; domaine de l'Heure Cible : 0..86399
|
||||
|
||||
; Seuil de rejet pour un tirage uniforme sur 86400 valeurs a partir d'un mot de
|
||||
; 32 bits : 2^32 - (2^32 mod 86400) = 4294967296 - 23296 = 4294944000.
|
||||
; Un simple x % 86400 biaiserait les 23296 premieres secondes de la journee,
|
||||
; qui seraient tirees une fois de plus que les autres. Le biais est infime mais
|
||||
; il est systematique et connaissable par un attaquant, donc rejete ici.
|
||||
%define VC_REJECT_LIMIT 4294944000
|
||||
|
||||
%define VC_FRAME_BYTES 64 ; taille fixe d'une trame
|
||||
%define VC_FRAME_MAXPAYLOAD 63 ; 64 - 1 octet de longueur
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; FRAME_LAYOUT -- HYPOTHESE, A CONFIRMER SUR LE MANIFESTE
|
||||
;
|
||||
; Le prompt impose une trame de 64 octets dont la queue est du bruit CSPRNG,
|
||||
; mais ne dit pas comment le recepteur retrouve la frontiere charge/bruit. Il
|
||||
; faut au minimum un champ de longueur. Disposition retenue, la plus econome :
|
||||
;
|
||||
; octet 0 : L, longueur utile (0..63)
|
||||
; octets 1..L : charge utile
|
||||
; octets L+1..63 : bruit CSPRNG
|
||||
;
|
||||
; L'ensemble des 64 octets est ensuite chiffre en AES-256-CTR, donc L n'est pas
|
||||
; observable en clair sur l'air. Si le manifeste prevoit un en-tete (version,
|
||||
; identifiant de boitier, MAC tronque), cette disposition changera : elle est
|
||||
; isolee dans vc_frame_pad / vc_frame_unpad, nulle part ailleurs.
|
||||
; -----------------------------------------------------------------------------
|
||||
|
||||
section .text
|
||||
|
||||
global vc_derive_target_hour_i
|
||||
global vc_frame_pad_i
|
||||
global vc_frame_unpad_i
|
||||
|
||||
; =============================================================================
|
||||
; [2] HEURE CIBLE
|
||||
; =============================================================================
|
||||
; uint32_t vc_derive_target_hour(const uint8_t *grain, size_t grain_len)
|
||||
;
|
||||
; h <- SHA256(grain)
|
||||
; x <- 4 premiers octets de h, lus en big-endian
|
||||
; tant que x >= VC_REJECT_LIMIT : (methode de rejet)
|
||||
; h <- SHA256(h)
|
||||
; x <- 4 premiers octets de h
|
||||
; retourner x mod 86400
|
||||
;
|
||||
; Le premier tirage est exactement SHA256(Grain de Sel) comme specifie. La
|
||||
; regle de renouvellement en cas de rejet (rehachage du condensat precedent)
|
||||
; est deterministe et sans etat : emetteur et recepteur, partant du meme grain,
|
||||
; convergent sur la meme Heure Cible sans echanger quoi que ce soit.
|
||||
;
|
||||
; Probabilite de rejet a chaque tirage : 23296 / 2^32, soit environ 5,4e-6.
|
||||
; La boucle ne s'execute donc quasiment jamais, mais elle doit exister et etre
|
||||
; identique des deux cotes, sinon les deux extremites divergent silencieusement
|
||||
; une fois tous les ~185000 grains.
|
||||
;
|
||||
; Lecture big-endian des 4 premiers octets : choix d'ordre reseau, coherent
|
||||
; avec le reste du protocole radio. A CONFIRMER sur le manifeste -- une lecture
|
||||
; little-endian donnerait une Heure Cible differente pour le meme grain, donc
|
||||
; une incompatibilite totale avec un implementeur qui aurait choisi l'autre.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_derive_target_hour_i:
|
||||
push rbx
|
||||
push r12
|
||||
sub rsp, 40 ; [rsp .. rsp+31] = condensat courant
|
||||
|
||||
mov r12, rsp
|
||||
|
||||
; --- premier tirage : h = SHA256(grain)
|
||||
; rdi = grain, rsi = grain_len deja en place
|
||||
mov rdx, r12
|
||||
call vc_sha256_i
|
||||
|
||||
.draw:
|
||||
mov eax, [r12]
|
||||
bswap eax ; 4 premiers octets, big-endian
|
||||
mov ebx, eax
|
||||
|
||||
mov eax, VC_REJECT_LIMIT
|
||||
cmp ebx, eax
|
||||
jb .accept
|
||||
|
||||
; --- rejet : h <- SHA256(h), on retire
|
||||
mov rdi, r12
|
||||
mov rsi, 32
|
||||
mov rdx, r12
|
||||
call vc_sha256_i
|
||||
jmp .draw
|
||||
|
||||
.accept:
|
||||
mov eax, ebx
|
||||
xor edx, edx
|
||||
mov ecx, VC_DAY_SECONDS
|
||||
div ecx ; edx = x mod 86400
|
||||
mov eax, edx
|
||||
|
||||
; --- effacement du condensat (derive directement du Grain de Sel)
|
||||
mov qword [r12 + 0], 0
|
||||
mov qword [r12 + 8], 0
|
||||
mov qword [r12 + 16], 0
|
||||
mov qword [r12 + 24], 0
|
||||
|
||||
add rsp, 40
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; [7] BOURRAGE A TAILLE FIXE
|
||||
; =============================================================================
|
||||
; int vc_frame_pad(vc_csprng_ctx *rng, const uint8_t *payload, size_t len,
|
||||
; uint8_t out[64])
|
||||
; Retourne 0 si la trame est construite, -1 si len > 63.
|
||||
;
|
||||
; Toute trame fait exactement 64 octets, quelle que soit la charge utile :
|
||||
; un observateur radio ne peut pas deduire la longueur du message, ni meme
|
||||
; distinguer un accuse de reception d'un releve complet. Le remplissage est
|
||||
; du bruit CSPRNG et non des zeros -- avec des zeros, la queue chiffree en
|
||||
; CTR revelerait directement le flot de cle sur cette portion, ce qui rendrait
|
||||
; triviale la falsification du reste de la trame sous le meme compteur.
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_frame_pad_i:
|
||||
push rbx
|
||||
push r12
|
||||
push r13
|
||||
push r14
|
||||
|
||||
mov r12, rdi ; rng
|
||||
mov r13, rsi ; payload
|
||||
mov rbx, rdx ; len
|
||||
mov r14, rcx ; out
|
||||
|
||||
cmp rbx, VC_FRAME_MAXPAYLOAD
|
||||
ja .too_long
|
||||
|
||||
; --- octet de longueur
|
||||
mov [r14], bl
|
||||
|
||||
; --- charge utile
|
||||
test rbx, rbx
|
||||
jz .fill
|
||||
lea rdi, [r14 + 1]
|
||||
mov rsi, r13
|
||||
mov rcx, rbx
|
||||
rep movsb
|
||||
|
||||
.fill:
|
||||
; --- bruit CSPRNG sur la place restante
|
||||
mov rdi, r12
|
||||
lea rsi, [r14 + 1 + rbx]
|
||||
mov rdx, VC_FRAME_MAXPAYLOAD
|
||||
sub rdx, rbx
|
||||
test rdx, rdx
|
||||
jz .ok
|
||||
call vc_csprng_bytes_i
|
||||
|
||||
.ok:
|
||||
xor eax, eax
|
||||
jmp .done
|
||||
|
||||
.too_long:
|
||||
mov eax, -1
|
||||
|
||||
.done:
|
||||
pop r14
|
||||
pop r13
|
||||
pop r12
|
||||
pop rbx
|
||||
ret
|
||||
|
||||
; -----------------------------------------------------------------------------
|
||||
; int vc_frame_unpad(const uint8_t in[64], uint8_t *out, size_t *out_len)
|
||||
; Retourne 0 si l'octet de longueur est coherent, -1 sinon.
|
||||
;
|
||||
; Un octet de longueur > 63 signale une trame corrompue ou un dechiffrement
|
||||
; avec la mauvaise cle. Ce n'est PAS un controle d'integrite : sans MAC, un
|
||||
; attaquant peut retourner des bits arbitraires du clair sous CTR. La
|
||||
; question de l'authentification des trames releve du manifeste et n'est pas
|
||||
; tranchee ici (voir README, "Points bloques sur specification").
|
||||
; -----------------------------------------------------------------------------
|
||||
vc_frame_unpad_i:
|
||||
movzx eax, byte [rdi]
|
||||
cmp eax, VC_FRAME_MAXPAYLOAD
|
||||
ja .bad
|
||||
|
||||
mov [rdx], rax ; *out_len = L
|
||||
|
||||
test rax, rax
|
||||
jz .ok
|
||||
push rax
|
||||
mov rcx, rax
|
||||
mov rax, rdi
|
||||
mov rdi, rsi
|
||||
lea rsi, [rax + 1]
|
||||
rep movsb
|
||||
pop rax
|
||||
|
||||
.ok:
|
||||
xor eax, eax
|
||||
ret
|
||||
|
||||
.bad:
|
||||
mov eax, -1
|
||||
ret
|
||||
|
||||
; =============================================================================
|
||||
; [4] GATING TEMPOREL
|
||||
; =============================================================================
|
||||
; uint64_t vc_gate_accept(uint32_t arrival_sec, uint32_t target_sec)
|
||||
; Masque tout-a-un si la trame est recevable (arrival >= target), zero sinon.
|
||||
;
|
||||
; Le point du protocole est l'ORDRE : ce test precede le dechiffrement. Une
|
||||
; trame arrivee avant l'Heure Cible est jetee sans qu'AES soit lance une
|
||||
; seule fois. Cout d'un paquet de brouillage : deux comparaisons, au lieu de
|
||||
; quatre blocs AES. C'est ce qui rend le boitier insensible a une inondation
|
||||
; radio, sur un STM32U5 alimente par batterie ou l'energie est la ressource
|
||||
; rare.
|
||||
;
|
||||
; Rendu en masque plutot qu'en booleen : l'Heure Cible derive du Grain de Sel,
|
||||
; donc c'est un secret. Un saut conditionnel sur cette comparaison rendrait
|
||||
; l'ecart de temps mesurable et permettrait a un attaquant de faire varier
|
||||
; son instant d'emission pour localiser l'Heure Cible par dichotomie. Le
|
||||
; masque garde le meme flot de controle dans les deux cas ; c'est a l'appelant
|
||||
; de ne pas le redetruire par un branchement en aval.
|
||||
; -----------------------------------------------------------------------------
|
||||
VC_FUNC vc_gate_accept
|
||||
VC_ARGS ; edi = arrival, esi = target
|
||||
cmp edi, esi ; CF = 1 si arrival < target
|
||||
sbb rax, rax ; -1 si trop tot, 0 sinon
|
||||
not rax ; -1 si recevable, 0 si trop tot
|
||||
VC_RET
|
||||
|
||||
; =============================================================================
|
||||
; Enveloppes publiques
|
||||
; =============================================================================
|
||||
|
||||
VC_FUNC vc_derive_target_hour
|
||||
VC_ARGS ; rdi = grain, rsi = grain_len
|
||||
call vc_derive_target_hour_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_frame_pad
|
||||
VC_ARGS ; rdi = rng, rsi = payload, rdx = len, rcx = out
|
||||
call vc_frame_pad_i
|
||||
VC_RET
|
||||
|
||||
VC_FUNC vc_frame_unpad
|
||||
VC_ARGS ; rdi = in64, rsi = out, rdx = out_len
|
||||
call vc_frame_unpad_i
|
||||
VC_RET
|
||||
@@ -0,0 +1,93 @@
|
||||
#!/bin/sh
|
||||
# =============================================================================
|
||||
# build.sh -- assemblage et edition de liens du prototype VERCORS x86-64.
|
||||
#
|
||||
# ./build.sh cible native (win64 sous MinGW, elf64 sous Linux)
|
||||
# ./build.sh elf64 force la cible System V / ELF
|
||||
# ./build.sh win64 force la cible Microsoft x64 / COFF
|
||||
#
|
||||
# Choix assume : pas de Makefile. make n'est pas installe sur la machine de
|
||||
# developpement, et le projet ne compte qu'une dizaine d'unites -- un script sh, lisible
|
||||
# et sans dependance, coute moins cher a maintenir qu'un Makefile qu'on ne peut
|
||||
# pas executer.
|
||||
# =============================================================================
|
||||
set -e
|
||||
|
||||
# Le chemin du projet contient un espace ("Protocole VERCORS"). On se place
|
||||
# dans la racine et on n'utilise plus que des chemins relatifs : les variables
|
||||
# de drapeaux passees non quotees a gcc ne peuvent alors pas etre coupees.
|
||||
cd "$(dirname "$0")"
|
||||
OUT=build
|
||||
mkdir -p "$OUT"
|
||||
|
||||
FMT="$1"
|
||||
if [ -z "$FMT" ]; then
|
||||
case "$(uname -s 2>/dev/null)" in
|
||||
MINGW*|MSYS*|CYGWIN*|Windows_NT) FMT=win64 ;;
|
||||
*) FMT=elf64 ;;
|
||||
esac
|
||||
fi
|
||||
|
||||
if [ "$FMT" = "win64" ]; then
|
||||
NASMFLAGS="-f win64 -DABI_WIN64"
|
||||
OBJ=obj
|
||||
EXE=.exe
|
||||
else
|
||||
NASMFLAGS="-f elf64"
|
||||
OBJ=o
|
||||
EXE=
|
||||
fi
|
||||
|
||||
echo "== cible : $FMT =="
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# Garde-fou sur la Cle Maitresse d'Usine.
|
||||
#
|
||||
# L'ADR 0010 rend la cle factice VISIBLE (ASCII lisible dans un dump). Visible
|
||||
# ne suffit pas : il faut qu'elle soit IMPOSSIBLE A LIVRER PAR INADVERTANCE.
|
||||
# Le build echoue donc tant que le placeholder est present, sauf opt-in
|
||||
# explicite -- et l'opt-in est bruyant.
|
||||
# -----------------------------------------------------------------------------
|
||||
CDEFS=""
|
||||
if grep -q 'PLACEHOLDER-NE-PAS-UTILISER-PROD' asm/factory_key.asm; then
|
||||
if [ "${VC_ALLOW_PLACEHOLDER_KEY:-0}" != "1" ]; then
|
||||
echo "" >&2
|
||||
echo "REFUS DE COMPILER : asm/factory_key.asm contient encore la K_M" >&2
|
||||
echo "factice. Tout boitier provisionne avec elle est dechiffrable par" >&2
|
||||
echo "quiconque lit ce depot." >&2
|
||||
echo "" >&2
|
||||
echo " - pour un build de developpement :" >&2
|
||||
echo " VC_ALLOW_PLACEHOLDER_KEY=1 ./build.sh $FMT" >&2
|
||||
echo " - pour un build reel : remplacer la cle (voir docs/adr/0010)." >&2
|
||||
echo "" >&2
|
||||
exit 1
|
||||
fi
|
||||
echo " !! K_M FACTICE -- build de developpement uniquement, NE PAS LIVRER"
|
||||
CDEFS="-DVC_ALLOW_PLACEHOLDER_KEY"
|
||||
else
|
||||
echo " -- K_M de production (aucun placeholder detecte)"
|
||||
fi
|
||||
|
||||
for m in sha256 aes256 const_time csprng vercors_protocol vercors_keysched factory_key; do
|
||||
echo " nasm asm/$m.asm"
|
||||
nasm $NASMFLAGS -I include -o "$OUT/$m.$OBJ" "asm/$m.asm"
|
||||
done
|
||||
|
||||
CFLAGS="-std=c11 -O2 -Wall -Wextra -Iinclude -Ihal $CDEFS"
|
||||
|
||||
for c in hal/radio_stub hal/imu_stub hal/baro_stub; do
|
||||
echo " gcc $c.c"
|
||||
gcc $CFLAGS -c -o "$OUT/$(basename $c).$OBJ" "$c.c"
|
||||
done
|
||||
|
||||
echo " gcc test/test_vercors.c"
|
||||
gcc $CFLAGS -c -o "$OUT/test_vercors.$OBJ" test/test_vercors.c
|
||||
|
||||
echo " link build/test_vercors$EXE"
|
||||
gcc -o "$OUT/test_vercors$EXE" \
|
||||
"$OUT/test_vercors.$OBJ" \
|
||||
"$OUT/radio_stub.$OBJ" "$OUT/imu_stub.$OBJ" "$OUT/baro_stub.$OBJ" \
|
||||
"$OUT/sha256.$OBJ" "$OUT/aes256.$OBJ" "$OUT/const_time.$OBJ" \
|
||||
"$OUT/csprng.$OBJ" "$OUT/vercors_protocol.$OBJ" "$OUT/vercors_keysched.$OBJ" "$OUT/factory_key.$OBJ"
|
||||
|
||||
echo "== ok : $OUT/test_vercors$EXE =="
|
||||
@@ -0,0 +1,180 @@
|
||||
# Revue de sécurité et d'optimisation — 2026-09-16
|
||||
|
||||
## Périmètre, et ce qu'il ne couvre pas
|
||||
|
||||
Lus intégralement : `README.md`, les ADR 0006/0007/0009/0010, `include/vercors.h`,
|
||||
`asm/csprng.asm`, `asm/factory_key.asm`, `build.sh`, `test/test_vercors.c`, et les
|
||||
sections de `asm/vercors_keysched.asm` et `asm/vercors_protocol.asm` concernant la
|
||||
Fenêtre de Garde, le Cold Start et l'Heure Cible.
|
||||
|
||||
**Non relus ligne à ligne** : `sha256.asm`, `aes256.asm`, `const_time.asm`. Ils sont
|
||||
couverts par des vecteurs FIPS/NIST, ce qui valide leur **fonction** mais pas leurs
|
||||
propriétés de canal auxiliaire ni leur gestion de pile.
|
||||
|
||||
**Compilé et exécuté** (mise à jour du même jour) : un toolchain a été installé sur la
|
||||
machine d'analyse — NASM 2.16.03 et GCC 16.2.0 (MinGW-w64 UCRT), dans
|
||||
`Documents/_CODE/8-outils/_tools`. `VC_ALLOW_PLACEHOLDER_KEY=1 ./build.sh` produit
|
||||
`build/test_vercors.exe` sans avertissement sous `-Wall -Wextra`.
|
||||
|
||||
**Résultat : 100 tests, 0 échec** (86 avant cette revue).
|
||||
|
||||
Les deux défauts trouvés en lecture sont donc **confirmés par l'exécution**, pas
|
||||
seulement par l'analyse statique.
|
||||
|
||||
Source : copie de la sauvegarde Drive du poste BeQuit, état du 2026-09-02.
|
||||
|
||||
---
|
||||
|
||||
## Sécurité
|
||||
|
||||
### 1. CSPRNG non initialisé — le garde-fou existe et n'est jamais lu · **élevé**
|
||||
|
||||
`vc_csprng_ctx` porte un champ `seeded`. Il est écrit dans `vc_csprng_seed_i` et
|
||||
`vc_csprng_reseed_i`. Il n'est **lu nulle part** — vérifié sur l'ensemble du dépôt.
|
||||
|
||||
`vc_csprng_bytes` sert donc un contexte vierge sans broncher, et produit
|
||||
`SHA256(0^32 || BE64(0))` puis la suite déterministe qui en découle. Conséquences :
|
||||
|
||||
- le bourrage des trames, qui doit être **indistinguable du bruit**, devient une
|
||||
constante connue de quiconque lit ce dépôt ;
|
||||
- elle est **identique sur tous les boîtiers** ;
|
||||
- les jours de bascule (ADR 0009), ce bourrage prévisible jouxte la clé N+1 chiffrée,
|
||||
dans un bloc chiffré en CTR — c'est-à-dire du clair connu en face d'un flot de clé.
|
||||
|
||||
C'est le seul défaut trouvé aujourd'hui qui soit à la fois nouveau, silencieux et
|
||||
d'effet cryptographique direct.
|
||||
|
||||
**Exploitabilité vérifiée par l'exécution.** `test_csprng_unseeded` ne se contente pas
|
||||
de montrer que deux boîtiers vierges produisent le même bourrage : il recalcule
|
||||
`SHA256(0^40)` avec le SHA-256 du projet et vérifie que c'est **exactement** le premier
|
||||
bloc servi. Un attaquant fait ce calcul chez lui, sans rien observer. Le bourrage n'est
|
||||
pas seulement non aléatoire — il est **publiquement calculable hors ligne**.
|
||||
|
||||
**Correctif : à décider, non appliqué.** La correction évidente — lire `seeded` en tête
|
||||
de `vc_csprng_bytes_i` et refuser de servir — n'est pas locale : `vc_csprng_bytes_i` est
|
||||
appelé depuis `vercors_keysched.asm` (ligne 412) et `vercors_protocol.asm` (ligne 202),
|
||||
qui n'attendent aucun code de retour. Refuser sans canal d'erreur laisserait ces deux
|
||||
appelants continuer sur un tampon non écrit, ce qui serait **pire** que le défaut actuel.
|
||||
|
||||
Trois options, à trancher par le propriétaire du protocole :
|
||||
|
||||
1. **Canal d'erreur** — `vc_csprng_bytes` rend un `int`, les deux appelants propagent.
|
||||
`vc_frame_pad` rend déjà un `int` : la convention existe. Le plus propre, le plus
|
||||
invasif.
|
||||
2. **Arrêt franc** — `ud2` ou `abort` sur contexte vierge. Correct pour un prototype de
|
||||
validation, discutable dans une bibliothèque embarquée.
|
||||
3. **Garantie par construction** — supprimer le champ `seeded`, et rendre l'obtention
|
||||
d'un contexte impossible sans passer par `vc_csprng_seed`. Déplace le problème du
|
||||
contrôle à l'API, ce qui est généralement le bon endroit.
|
||||
|
||||
Documenté dans `include/vercors.h`, démontré par `test_csprng_unseeded`.
|
||||
|
||||
### 2. Aucune authentification de trame · **élevé** — connu, ADR 0003
|
||||
|
||||
Rien de neuf, mais cela reste le point qui rend le protocole non déployable. Voir
|
||||
l'analyse déjà faite et l'ADR 0012, qui libère le budget nécessaire.
|
||||
|
||||
### 3. Aucune protection contre le rejeu · **élevé** — voir ADR 0013
|
||||
|
||||
Le champ `compteur_anti_rejeu` ne protège pas du rejeu : il varie à l'échelle de la
|
||||
semaine, pas de la trame. Une trame valide capturée et réémise dans la fenêtre est
|
||||
acceptée à l'identique. La propriété annoncée par le nom du champ n'existe pas.
|
||||
|
||||
### 4. Le Cold Start est atteignable par brouillage · **moyen** — ADR 0010 le signale
|
||||
|
||||
Sept jours de silence forcé font basculer le boîtier sur `K_M`, la racine unique. Un
|
||||
attaquant capable de brouiller une semaine choisit donc le régime dans lequel il
|
||||
affronte le boîtier. Tant que le dialogue de resynchronisation n'est pas spécifié, on ne
|
||||
peut pas savoir si ce régime est plus faible que le nominal — mais c'est la question à
|
||||
se poser en l'écrivant, pas après.
|
||||
|
||||
### 5. La force du gating dépend d'un secret · **moyen** — ADR 0014
|
||||
|
||||
Selon l'Heure Cible du jour, le gating laisse passer la journée entière ou la dernière
|
||||
heure. Le bénéfice du point [4] n'est obtenu qu'en moyenne.
|
||||
|
||||
### 6. Passage de minuit · **moyen, disponibilité** — ADR 0014
|
||||
|
||||
Rejette des trames légitimes quelques jours par an, de façon irreproductible.
|
||||
|
||||
### 7. Corrigés aujourd'hui
|
||||
|
||||
- **Époque des semaines non définie** — ADR 0011, constante + vecteurs.
|
||||
- **Clé factice livrable par inadvertance** — `build.sh` refuse désormais de compiler
|
||||
tant que le placeholder est présent, sauf `VC_ALLOW_PLACEHOLDER_KEY=1`, et le test
|
||||
suit la configuration au lieu d'exiger la clé factice.
|
||||
|
||||
---
|
||||
|
||||
## Optimisation
|
||||
|
||||
### Le vrai levier n'est pas la cryptographie
|
||||
|
||||
Sur un boîtier sur batterie, le poste dominant est le **temps d'écoute radio**, pas les
|
||||
cycles de calcul. Chiffrer 64 octets coûte des microsecondes ; garder le récepteur
|
||||
allumé coûte des milliampères-heures.
|
||||
|
||||
Or `vc_gate_accept_window` est une demi-droite sans borne supérieure : une fois l'Heure
|
||||
Cible passée, la fenêtre reste ouverte **jusqu'à minuit**. Si le boîtier écoute tant que
|
||||
la fenêtre est ouverte, il écoute en moyenne une demi-journée.
|
||||
|
||||
**Borner la fenêtre par le haut (ADR 0014) est donc simultanément le correctif de
|
||||
disponibilité et la plus grosse optimisation énergétique disponible.** C'est le même
|
||||
changement, et c'est pour cela qu'il devrait passer avant toute optimisation de code.
|
||||
|
||||
À l'inverse, optimiser `sha256.asm` au cycle près améliorerait une dépense déjà
|
||||
négligeable. À ne pas faire.
|
||||
|
||||
### Au portage STM32U5
|
||||
|
||||
1. **Utiliser l'AES matériel plutôt que l'AES logiciel.** Plus rapide, et surtout cela
|
||||
supprime la réserve de canal auxiliaire de l'ADR 0002 au lieu de la porter. Le
|
||||
raisonnement de l'ADR 0002 (« le code testé doit être le code porté ») est bon pour
|
||||
ce prototype ; il cesse de l'être sur une cible qui a le périphérique.
|
||||
2. **Le TRNG matériel règle le défaut n° 1 à la source** — sous réserve d'appeler
|
||||
quand même `vc_csprng_seed` avant tout usage, et d'ajouter la vérification de
|
||||
`seeded` : le matériel ne protège pas d'un ordre d'initialisation fautif.
|
||||
3. `K_M` dans le STSAFE : l'ADR 0012, s'il est retenu, divise par sept les appels à
|
||||
l'élément sécurisé (une dérivation par semaine au lieu d'une par jour).
|
||||
4. **Pile** : `sha256.asm` place un tableau `W` de 256 octets sur la pile,
|
||||
`vc_csprng_bytes_i` un cadre de 80, `vc_csprng_reseed_i` un contexte SHA de 128. À
|
||||
confronter aux tailles de pile des tâches embarquées — le README le signale déjà.
|
||||
5. `rep movsb` / `rep stosq` / `div` : boucles explicites et `udiv`+`mls`. Déjà inventorié.
|
||||
|
||||
### Point mineur
|
||||
|
||||
L'alignement de pile aux appels internes en 64 bits (`rsp ≡ 8 mod 16` au `call` dans
|
||||
`vc_csprng_bytes_i`) ne respecte pas la convention System V. Sans conséquence tant
|
||||
qu'aucun appelé n'utilise d'accès SSE alignés — ce qui semble être le cas — mais c'est
|
||||
le genre de latence qui explose le jour où on ajoute une primitive vectorisée. À
|
||||
vérifier plutôt qu'à supposer.
|
||||
|
||||
---
|
||||
|
||||
## Ce qui tient
|
||||
|
||||
Pour équilibrer, et parce que c'est vrai : la méthode de rejet pour l'Heure Cible traite
|
||||
correctement un biais que la plupart des implémentations ignorent ; le recalage
|
||||
d'horloge mémorisé comme décalage plutôt qu'appliqué évite de casser les temporisations
|
||||
du firmware ; la saturation à zéro sur une horloge qui recule est explicitement gérée ;
|
||||
le rafraîchissement `V <- SHA256(0x01 || V)` donne une vraie résistance au retour en
|
||||
arrière ; les tampons sensibles sont effacés en sortie de fonction ; et l'absence de
|
||||
branchement dans le gating est justifiée par le bon argument — l'Heure Cible est un
|
||||
secret, un saut conditionnel la rendrait localisable par dichotomie.
|
||||
|
||||
La qualité du raisonnement est au-dessus de la moyenne de ce qu'on voit dans ce genre de
|
||||
projet. Les défauts trouvés sont des défauts d'angle mort, pas de méthode.
|
||||
|
||||
---
|
||||
|
||||
## Ordre recommandé
|
||||
|
||||
1. ~~Compiler et faire tourner la suite~~ — **fait** : 100 tests, 0 échec, toolchain
|
||||
installé dans `Documents/_CODE/8-outils/_tools`.
|
||||
2. **Choisir l'option de correction du défaut n° 1** parmi les trois ci-dessus, puis
|
||||
l'appliquer. C'est le point le plus urgent.
|
||||
3. **Répondre à la question du point [5]** — elle débloque l'ADR 0012, donc le budget
|
||||
du MAC.
|
||||
4. **Trancher `duree_de_session`** — elle débloque l'ADR 0014, donc la correction de
|
||||
minuit *et* l'autonomie.
|
||||
5. **Le MAC**, avec le budget que (3) aura libéré.
|
||||
@@ -0,0 +1,180 @@
|
||||
# Revue de sécurité et d'optimisation — 2026-09-16
|
||||
|
||||
## Périmètre, et ce qu'il ne couvre pas
|
||||
|
||||
Lus intégralement : `README.md`, les ADR 0006/0007/0009/0010, `include/vercors.h`,
|
||||
`asm/csprng.asm`, `asm/factory_key.asm`, `build.sh`, `test/test_vercors.c`, et les
|
||||
sections de `asm/vercors_keysched.asm` et `asm/vercors_protocol.asm` concernant la
|
||||
Fenêtre de Garde, le Cold Start et l'Heure Cible.
|
||||
|
||||
**Non relus ligne à ligne** : `sha256.asm`, `aes256.asm`, `const_time.asm`. Ils sont
|
||||
couverts par des vecteurs FIPS/NIST, ce qui valide leur **fonction** mais pas leurs
|
||||
propriétés de canal auxiliaire ni leur gestion de pile.
|
||||
|
||||
**Compilé et exécuté** (mise à jour du même jour) : un toolchain a été installé sur la
|
||||
machine d'analyse — NASM 2.16.03 et GCC 16.2.0 (MinGW-w64 UCRT), dans
|
||||
`Documents/_CODE/_tools`. `VC_ALLOW_PLACEHOLDER_KEY=1 ./build.sh` produit
|
||||
`build/test_vercors.exe` sans avertissement sous `-Wall -Wextra`.
|
||||
|
||||
**Résultat : 100 tests, 0 échec** (86 avant cette revue).
|
||||
|
||||
Les deux défauts trouvés en lecture sont donc **confirmés par l'exécution**, pas
|
||||
seulement par l'analyse statique.
|
||||
|
||||
Source : copie de la sauvegarde Drive du poste BeQuit, état du 2026-09-02.
|
||||
|
||||
---
|
||||
|
||||
## Sécurité
|
||||
|
||||
### 1. CSPRNG non initialisé — le garde-fou existe et n'est jamais lu · **élevé**
|
||||
|
||||
`vc_csprng_ctx` porte un champ `seeded`. Il est écrit dans `vc_csprng_seed_i` et
|
||||
`vc_csprng_reseed_i`. Il n'est **lu nulle part** — vérifié sur l'ensemble du dépôt.
|
||||
|
||||
`vc_csprng_bytes` sert donc un contexte vierge sans broncher, et produit
|
||||
`SHA256(0^32 || BE64(0))` puis la suite déterministe qui en découle. Conséquences :
|
||||
|
||||
- le bourrage des trames, qui doit être **indistinguable du bruit**, devient une
|
||||
constante connue de quiconque lit ce dépôt ;
|
||||
- elle est **identique sur tous les boîtiers** ;
|
||||
- les jours de bascule (ADR 0009), ce bourrage prévisible jouxte la clé N+1 chiffrée,
|
||||
dans un bloc chiffré en CTR — c'est-à-dire du clair connu en face d'un flot de clé.
|
||||
|
||||
C'est le seul défaut trouvé aujourd'hui qui soit à la fois nouveau, silencieux et
|
||||
d'effet cryptographique direct.
|
||||
|
||||
**Exploitabilité vérifiée par l'exécution.** `test_csprng_unseeded` ne se contente pas
|
||||
de montrer que deux boîtiers vierges produisent le même bourrage : il recalcule
|
||||
`SHA256(0^40)` avec le SHA-256 du projet et vérifie que c'est **exactement** le premier
|
||||
bloc servi. Un attaquant fait ce calcul chez lui, sans rien observer. Le bourrage n'est
|
||||
pas seulement non aléatoire — il est **publiquement calculable hors ligne**.
|
||||
|
||||
**Correctif : à décider, non appliqué.** La correction évidente — lire `seeded` en tête
|
||||
de `vc_csprng_bytes_i` et refuser de servir — n'est pas locale : `vc_csprng_bytes_i` est
|
||||
appelé depuis `vercors_keysched.asm` (ligne 412) et `vercors_protocol.asm` (ligne 202),
|
||||
qui n'attendent aucun code de retour. Refuser sans canal d'erreur laisserait ces deux
|
||||
appelants continuer sur un tampon non écrit, ce qui serait **pire** que le défaut actuel.
|
||||
|
||||
Trois options, à trancher par le propriétaire du protocole :
|
||||
|
||||
1. **Canal d'erreur** — `vc_csprng_bytes` rend un `int`, les deux appelants propagent.
|
||||
`vc_frame_pad` rend déjà un `int` : la convention existe. Le plus propre, le plus
|
||||
invasif.
|
||||
2. **Arrêt franc** — `ud2` ou `abort` sur contexte vierge. Correct pour un prototype de
|
||||
validation, discutable dans une bibliothèque embarquée.
|
||||
3. **Garantie par construction** — supprimer le champ `seeded`, et rendre l'obtention
|
||||
d'un contexte impossible sans passer par `vc_csprng_seed`. Déplace le problème du
|
||||
contrôle à l'API, ce qui est généralement le bon endroit.
|
||||
|
||||
Documenté dans `include/vercors.h`, démontré par `test_csprng_unseeded`.
|
||||
|
||||
### 2. Aucune authentification de trame · **élevé** — connu, ADR 0003
|
||||
|
||||
Rien de neuf, mais cela reste le point qui rend le protocole non déployable. Voir
|
||||
l'analyse déjà faite et l'ADR 0012, qui libère le budget nécessaire.
|
||||
|
||||
### 3. Aucune protection contre le rejeu · **élevé** — voir ADR 0013
|
||||
|
||||
Le champ `compteur_anti_rejeu` ne protège pas du rejeu : il varie à l'échelle de la
|
||||
semaine, pas de la trame. Une trame valide capturée et réémise dans la fenêtre est
|
||||
acceptée à l'identique. La propriété annoncée par le nom du champ n'existe pas.
|
||||
|
||||
### 4. Le Cold Start est atteignable par brouillage · **moyen** — ADR 0010 le signale
|
||||
|
||||
Sept jours de silence forcé font basculer le boîtier sur `K_M`, la racine unique. Un
|
||||
attaquant capable de brouiller une semaine choisit donc le régime dans lequel il
|
||||
affronte le boîtier. Tant que le dialogue de resynchronisation n'est pas spécifié, on ne
|
||||
peut pas savoir si ce régime est plus faible que le nominal — mais c'est la question à
|
||||
se poser en l'écrivant, pas après.
|
||||
|
||||
### 5. La force du gating dépend d'un secret · **moyen** — ADR 0014
|
||||
|
||||
Selon l'Heure Cible du jour, le gating laisse passer la journée entière ou la dernière
|
||||
heure. Le bénéfice du point [4] n'est obtenu qu'en moyenne.
|
||||
|
||||
### 6. Passage de minuit · **moyen, disponibilité** — ADR 0014
|
||||
|
||||
Rejette des trames légitimes quelques jours par an, de façon irreproductible.
|
||||
|
||||
### 7. Corrigés aujourd'hui
|
||||
|
||||
- **Époque des semaines non définie** — ADR 0011, constante + vecteurs.
|
||||
- **Clé factice livrable par inadvertance** — `build.sh` refuse désormais de compiler
|
||||
tant que le placeholder est présent, sauf `VC_ALLOW_PLACEHOLDER_KEY=1`, et le test
|
||||
suit la configuration au lieu d'exiger la clé factice.
|
||||
|
||||
---
|
||||
|
||||
## Optimisation
|
||||
|
||||
### Le vrai levier n'est pas la cryptographie
|
||||
|
||||
Sur un boîtier sur batterie, le poste dominant est le **temps d'écoute radio**, pas les
|
||||
cycles de calcul. Chiffrer 64 octets coûte des microsecondes ; garder le récepteur
|
||||
allumé coûte des milliampères-heures.
|
||||
|
||||
Or `vc_gate_accept_window` est une demi-droite sans borne supérieure : une fois l'Heure
|
||||
Cible passée, la fenêtre reste ouverte **jusqu'à minuit**. Si le boîtier écoute tant que
|
||||
la fenêtre est ouverte, il écoute en moyenne une demi-journée.
|
||||
|
||||
**Borner la fenêtre par le haut (ADR 0014) est donc simultanément le correctif de
|
||||
disponibilité et la plus grosse optimisation énergétique disponible.** C'est le même
|
||||
changement, et c'est pour cela qu'il devrait passer avant toute optimisation de code.
|
||||
|
||||
À l'inverse, optimiser `sha256.asm` au cycle près améliorerait une dépense déjà
|
||||
négligeable. À ne pas faire.
|
||||
|
||||
### Au portage STM32U5
|
||||
|
||||
1. **Utiliser l'AES matériel plutôt que l'AES logiciel.** Plus rapide, et surtout cela
|
||||
supprime la réserve de canal auxiliaire de l'ADR 0002 au lieu de la porter. Le
|
||||
raisonnement de l'ADR 0002 (« le code testé doit être le code porté ») est bon pour
|
||||
ce prototype ; il cesse de l'être sur une cible qui a le périphérique.
|
||||
2. **Le TRNG matériel règle le défaut n° 1 à la source** — sous réserve d'appeler
|
||||
quand même `vc_csprng_seed` avant tout usage, et d'ajouter la vérification de
|
||||
`seeded` : le matériel ne protège pas d'un ordre d'initialisation fautif.
|
||||
3. `K_M` dans le STSAFE : l'ADR 0012, s'il est retenu, divise par sept les appels à
|
||||
l'élément sécurisé (une dérivation par semaine au lieu d'une par jour).
|
||||
4. **Pile** : `sha256.asm` place un tableau `W` de 256 octets sur la pile,
|
||||
`vc_csprng_bytes_i` un cadre de 80, `vc_csprng_reseed_i` un contexte SHA de 128. À
|
||||
confronter aux tailles de pile des tâches embarquées — le README le signale déjà.
|
||||
5. `rep movsb` / `rep stosq` / `div` : boucles explicites et `udiv`+`mls`. Déjà inventorié.
|
||||
|
||||
### Point mineur
|
||||
|
||||
L'alignement de pile aux appels internes en 64 bits (`rsp ≡ 8 mod 16` au `call` dans
|
||||
`vc_csprng_bytes_i`) ne respecte pas la convention System V. Sans conséquence tant
|
||||
qu'aucun appelé n'utilise d'accès SSE alignés — ce qui semble être le cas — mais c'est
|
||||
le genre de latence qui explose le jour où on ajoute une primitive vectorisée. À
|
||||
vérifier plutôt qu'à supposer.
|
||||
|
||||
---
|
||||
|
||||
## Ce qui tient
|
||||
|
||||
Pour équilibrer, et parce que c'est vrai : la méthode de rejet pour l'Heure Cible traite
|
||||
correctement un biais que la plupart des implémentations ignorent ; le recalage
|
||||
d'horloge mémorisé comme décalage plutôt qu'appliqué évite de casser les temporisations
|
||||
du firmware ; la saturation à zéro sur une horloge qui recule est explicitement gérée ;
|
||||
le rafraîchissement `V <- SHA256(0x01 || V)` donne une vraie résistance au retour en
|
||||
arrière ; les tampons sensibles sont effacés en sortie de fonction ; et l'absence de
|
||||
branchement dans le gating est justifiée par le bon argument — l'Heure Cible est un
|
||||
secret, un saut conditionnel la rendrait localisable par dichotomie.
|
||||
|
||||
La qualité du raisonnement est au-dessus de la moyenne de ce qu'on voit dans ce genre de
|
||||
projet. Les défauts trouvés sont des défauts d'angle mort, pas de méthode.
|
||||
|
||||
---
|
||||
|
||||
## Ordre recommandé
|
||||
|
||||
1. ~~Compiler et faire tourner la suite~~ — **fait** : 100 tests, 0 échec, toolchain
|
||||
installé dans `Documents/_CODE/_tools`.
|
||||
2. **Choisir l'option de correction du défaut n° 1** parmi les trois ci-dessus, puis
|
||||
l'appliquer. C'est le point le plus urgent.
|
||||
3. **Répondre à la question du point [5]** — elle débloque l'ADR 0012, donc le budget
|
||||
du MAC.
|
||||
4. **Trancher `duree_de_session`** — elle débloque l'ADR 0014, donc la correction de
|
||||
minuit *et* l'autonomie.
|
||||
5. **Le MAC**, avec le budget que (3) aura libéré.
|
||||
@@ -0,0 +1,43 @@
|
||||
# ADR 0001 — Traduction d'ABI à l'assemblage plutôt que cible Linux imposée
|
||||
|
||||
- **Statut** : accepté
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le prompt fixe la cible « Linux x86-64, convention System V AMD64 ». La machine
|
||||
de développement est sous Windows 11 et **WSL n'y est pas installé**
|
||||
(`wsl -e` répond « Le Sous-système Windows pour Linux n'est pas installé »).
|
||||
La seule chaîne x86-64 exécutable nativement est `nasm` + `gcc` MinGW fournis
|
||||
par Strawberry Perl, qui produisent du COFF/Win64.
|
||||
|
||||
Assembler en ELF64 sans pouvoir éditer les liens ni exécuter aurait donné du
|
||||
code jamais lancé une seule fois — inacceptable pour une passe dont l'objet
|
||||
même est de *valider* la logique du protocole.
|
||||
|
||||
## Décision
|
||||
|
||||
Tout le code assembleur est écrit dans un vocabulaire canonique System V
|
||||
(arguments dans `rdi, rsi, rdx, rcx`). `include/abi.inc` fournit trois macros —
|
||||
`VC_FUNC`, `VC_ARGS`, `VC_RET` — qui, sous `-DABI_WIN64`, recopient les
|
||||
arguments depuis `rcx, rdx, r8, r9` et préservent `rdi`/`rsi` (callee-saved
|
||||
sous ABI Microsoft). Sans ce define, les macros sont inertes et le code est du
|
||||
System V strict.
|
||||
|
||||
Chaque module expose en outre des symboles internes `*_i` suivant une
|
||||
convention privée System V, utilisés pour les appels entre modules assembleur.
|
||||
Aucun appel interne n'a ainsi à respecter le *shadow space* Microsoft.
|
||||
|
||||
## Conséquences
|
||||
|
||||
- Les cinq modules assemblent **sans modification** en `elf64` et en `win64` ;
|
||||
`./build.sh elf64` et `./build.sh win64` sont tous deux valides.
|
||||
- La cible de référence reste System V : c'est le mode par défaut sous Linux.
|
||||
- Coût : deux `push`/`pop` par fonction publique sous Win64. Nul sous System V.
|
||||
- `abi.inc` est intégralement x86-64-spécifique et sera remplacé par un
|
||||
équivalent AAPCS au portage Cortex-M33. Aucune logique protocolaire n'y vit.
|
||||
|
||||
## Alternative écartée
|
||||
|
||||
Installer WSL. Cela modifie la configuration système de la machine de l'auteur,
|
||||
ce qui dépasse le périmètre confié.
|
||||
@@ -0,0 +1,45 @@
|
||||
# ADR 0002 — AES logiciel plutôt qu'AES-NI
|
||||
|
||||
- **Statut** : accepté
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le prompt autorise AES-NI à condition de le signaler explicitement, en
|
||||
rappelant que le Cortex-M33 n'en dispose pas et exigera une version logicielle.
|
||||
|
||||
## Décision
|
||||
|
||||
Ne **pas** utiliser AES-NI. `asm/aes256.asm` est une implémentation logicielle
|
||||
scalaire : S-box de 256 octets, `ShiftRows` fusionné dans les indices de
|
||||
lecture, `MixColumns` par `xtime` sans branchement.
|
||||
|
||||
## Justification
|
||||
|
||||
Cette passe x86-64 sert à valider la logique VERCORS *avant* portage. Une
|
||||
implémentation AES-NI validerait un chemin d'exécution qui n'existera jamais
|
||||
sur le boîtier, et laisserait la version réellement embarquée non testée. La
|
||||
version logicielle donne un comportement bit-à-bit identique à la cible et la
|
||||
même structure de code à porter.
|
||||
|
||||
## Conséquences
|
||||
|
||||
- Plus lent qu'AES-NI. Sans importance : le débit visé est de quelques trames
|
||||
de 64 octets par jour sur 169 MHz.
|
||||
- Aucune instruction x86-64 exotique. Le portage Thumb-2 est une transcription,
|
||||
pas une réécriture.
|
||||
- **Fuite par canal auxiliaire assumée** : `SubBytes` indexe une table avec des
|
||||
données secrètes, ce qui est observable par timing de cache sur un CPU
|
||||
partagé. Accepté ici parce que (a) la cible STM32U5 n'a pas de cache de
|
||||
données partagé avec un attaquant ni de multi-tenance, (b) le modèle de
|
||||
menace du produit est un attaquant *radio distant*, pas un voisin de cache,
|
||||
(c) une version constante en temps demanderait du bitslicing, qui ne se
|
||||
transpose pas tel quel en Thumb-2 et brouillerait l'objet de cette passe.
|
||||
- Les comparaisons de secrets, elles, sont bien en temps constant — c'est ce
|
||||
que la contrainte projet exigeait nommément. Voir `asm/const_time.asm`.
|
||||
|
||||
## À revoir si
|
||||
|
||||
Le protocole devait un jour tourner sur un hôte partagé (passerelle Linux
|
||||
mutualisée, serveur de collecte). Le modèle de menace changerait alors, et le
|
||||
bitslicing ou AES-NI redeviendrait justifié — sur cette cible-là uniquement.
|
||||
@@ -0,0 +1,47 @@
|
||||
# ADR 0003 — Mode de chiffrement : CTR
|
||||
|
||||
- **Statut** : accepté, avec une réserve d'authentification à trancher
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le prompt recommande CTR pour du radio bas-débit avec IV/compteur, en demandant
|
||||
que le choix soit confirmé dans le rapport plutôt qu'imposé silencieusement.
|
||||
|
||||
## Décision
|
||||
|
||||
CTR est retenu.
|
||||
|
||||
## Justification
|
||||
|
||||
1. **Pas de bourrage cryptographique.** CTR est un chiffrement par flot : la
|
||||
trame de 64 octets est chiffrée telle quelle. Le bourrage du protocole est
|
||||
du remplissage *applicatif* à taille fixe, sans lien avec un multiple de
|
||||
bloc. En CBC il aurait fallu un bourrage PKCS#7 en plus, donc des octets
|
||||
transmis en pure perte sur une liaison où chaque octet coûte de l'énergie.
|
||||
2. **Chiffrement seul.** CTR n'utilise jamais le déchiffrement de bloc AES.
|
||||
`InvSubBytes`, `InvMixColumns` et la table inverse disparaissent : environ
|
||||
la moitié du code AES et de la ROM en moins sur STM32U5.
|
||||
3. **Pas de propagation d'erreur.** Un bit retourné par le canal radio
|
||||
corrompt un bit du clair, pas un bloc entier — utile pour diagnostiquer une
|
||||
liaison dégradée en montagne.
|
||||
4. **IV/compteur par paquet**, comme demandé au point [8] du prompt.
|
||||
|
||||
## Réserve, à trancher sur le manifeste
|
||||
|
||||
CTR ne fournit **aucune authentification**. Sous CTR, un attaquant qui connaît
|
||||
ou devine une portion du clair peut retourner les bits correspondants du
|
||||
chiffré sans être détecté. Le gating temporel filtre l'inondation, pas la
|
||||
falsification ciblée.
|
||||
|
||||
Il manque donc un MAC (HMAC-SHA-256 tronqué, ou AES-CMAC) ou un mode AEAD. Le
|
||||
SHA-256 nécessaire est déjà présent dans ce dépôt ; c'est la place du MAC dans
|
||||
la trame de 64 octets qui n'est pas décidable sans le manifeste. **Ce point est
|
||||
ouvert et n'a pas été comblé par une supposition.**
|
||||
|
||||
## Interdit absolu associé
|
||||
|
||||
Un couple (clé, compteur) ne doit jamais servir deux fois : la réutilisation
|
||||
d'un flot CTR révèle le XOR des deux clairs. La bascule de clé quotidienne [5]
|
||||
et la gestion du compteur doivent le garantir — encore un point qui dépend de
|
||||
la spécification manquante.
|
||||
@@ -0,0 +1,44 @@
|
||||
# ADR 0004 — CSPRNG maison basé sur SHA-256
|
||||
|
||||
- **Statut** : accepté
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le point [7] du prompt exige que le bourrage des trames soit du bruit produit
|
||||
par un « CSPRNG-maison », et la contrainte projet interdit toute bibliothèque
|
||||
externe. Il faut donc un générateur, et il doit être écrit ici.
|
||||
|
||||
## Décision
|
||||
|
||||
Un DRBG à base de hachage, dans l'esprit de `Hash_DRBG` (NIST SP 800-90A) mais
|
||||
volontairement réduit :
|
||||
|
||||
```
|
||||
seed(g) V <- SHA256(g) ; C <- 0
|
||||
bytes(n) par bloc de 32 : sortie <- SHA256(V || BE64(C)) ; C <- C + 1
|
||||
puis, la demande servie : V <- SHA256(0x01 || V)
|
||||
reseed(g) V <- SHA256(V || g)
|
||||
```
|
||||
|
||||
## Justification
|
||||
|
||||
- Ne réutilise que la primitive déjà présente et déjà validée sur vecteurs
|
||||
FIPS. Aucune surface cryptographique nouvelle à auditer.
|
||||
- Le rafraîchissement final de `V` donne la **résistance au retour en
|
||||
arrière** : compromettre le boîtier après coup ne permet pas de recalculer le
|
||||
bourrage des trames déjà émises.
|
||||
- `reseed` mélange la nouvelle entropie à l'ancienne au lieu de la remplacer :
|
||||
un réamorçage depuis une source dégradée ne peut pas affaiblir l'état.
|
||||
|
||||
## Conséquences
|
||||
|
||||
- **Ce module ne fabrique pas d'entropie.** La graine vient de l'extérieur :
|
||||
le harnais de test sur x86-64, le TRNG matériel sur STM32U5. C'est la seule
|
||||
différence de fond au portage, et elle est isolée derrière `vc_csprng_seed`.
|
||||
- Un générateur amorcé avec une graine prévisible produit un bourrage
|
||||
prévisible. Le câblage de `vc_csprng_seed` sur le TRNG est donc un point de
|
||||
vérification obligatoire de la revue de portage.
|
||||
- Non certifié SP 800-90A : la construction s'en inspire, ne la suit pas à la
|
||||
lettre (pas de `reseed_counter`, pas de `additional_input`, pas de tests de
|
||||
santé). À reprendre si une certification est visée.
|
||||
@@ -0,0 +1,55 @@
|
||||
# ADR 0005 — Méthode de rejet pour l'Heure Cible
|
||||
|
||||
- **Statut** : accepté
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le point [2] du prompt impose explicitement une méthode de rejet, « pas un
|
||||
simple modulo qui biaiserait la distribution ».
|
||||
|
||||
## Décision
|
||||
|
||||
```
|
||||
h <- SHA256(Grain de Sel)
|
||||
x <- 4 premiers octets de h, lus en big-endian
|
||||
tant que x >= 4294944000 : h <- SHA256(h) ; x <- 4 premiers octets de h
|
||||
retourner x mod 86400
|
||||
```
|
||||
|
||||
Le seuil vaut `2^32 - (2^32 mod 86400) = 4294967296 - 23296 = 4294944000`.
|
||||
|
||||
## Justification
|
||||
|
||||
Avec un modulo nu sur 32 bits, les 23296 premières secondes de la journée
|
||||
seraient tirées une fois de plus que les autres : un biais de l'ordre de
|
||||
5,4 × 10⁻⁶. Infime, mais **systématique et calculable par un attaquant**, qui
|
||||
saurait donc que l'Heure Cible tombe très légèrement plus souvent avant
|
||||
06:28:16. La méthode de rejet le supprime exactement.
|
||||
|
||||
Deux détails ont été fixés pour que les deux extrémités convergent :
|
||||
|
||||
- **Le premier tirage est exactement `SHA256(grain)`**, comme spécifié. La
|
||||
règle de renouvellement (rehacher le condensat précédent) ne s'applique qu'à
|
||||
partir du deuxième.
|
||||
- La boucle est déterministe et sans état : émetteur et récepteur, partant du
|
||||
même grain, obtiennent la même Heure Cible sans rien échanger.
|
||||
|
||||
La probabilité de rejet est de 23296/2³², soit environ une fois tous les
|
||||
185 000 grains. La boucle ne s'exécute quasiment jamais — raison de plus pour
|
||||
qu'elle soit identique des deux côtés, un désaccord ne se manifestant qu'à
|
||||
cette fréquence-là, c'est-à-dire jamais en test et un jour en production.
|
||||
|
||||
## Point à confirmer sur le manifeste
|
||||
|
||||
**L'ordre de lecture des 4 premiers octets.** Le prompt dit « 4 premiers octets
|
||||
→ entier 32 bits » sans préciser l'endianness. Le big-endian a été retenu
|
||||
(ordre réseau, cohérent avec le reste d'un protocole radio). Une lecture
|
||||
little-endian donnerait une Heure Cible **différente pour le même grain**, donc
|
||||
une incompatibilité totale avec une autre implémentation. Deux vecteurs de
|
||||
référence figent ce choix dans `test/test_vercors.c` :
|
||||
|
||||
| Grain | Heure Cible |
|
||||
|---------------------|-------------|
|
||||
| 32 octets `0x00` | 59181 |
|
||||
| 32 octets `0xff` | 40182 |
|
||||
@@ -0,0 +1,47 @@
|
||||
# ADR 0006 — Disposition interne de la trame : hypothèse explicite
|
||||
|
||||
- **Statut** : **provisoire — à valider sur le manifeste Gastinel Frame**
|
||||
- **Date** : 2026-09-02
|
||||
|
||||
## Contexte
|
||||
|
||||
Le point [7] impose une trame de 64 octets dont la queue est du bruit CSPRNG,
|
||||
mais ne dit pas comment le récepteur retrouve la frontière entre charge utile
|
||||
et bruit. Il faut au minimum un champ de longueur. Le manifeste, qui décrit
|
||||
vraisemblablement l'en-tête réel, n'a pas pu être lu : le dossier
|
||||
`__RADIO\Gastinel Frame` est vide sur cette machine.
|
||||
|
||||
## Décision
|
||||
|
||||
Faute de spécification, et plutôt que de ne rien livrer, une disposition
|
||||
minimale est retenue **et signalée comme hypothèse** :
|
||||
|
||||
```
|
||||
octet 0 : bit 7 = drapeau de bascule ; bits 0-6 = longueur utile L
|
||||
octets 1..L : charge utile
|
||||
octets L+1..63 : bruit CSPRNG
|
||||
```
|
||||
|
||||
Le bit 7 a été ajouté par l'ADR 0009 pour signaler la bascule de clé. Sans
|
||||
bascule, L ne dépasse pas 63 et le bit reste donc naturellement à zéro.
|
||||
|
||||
**L'octet d'en-tête est à l'intérieur du chiffré.** `vc_frame_pad` /
|
||||
`vc_frame_build` construisent les 64 octets en clair, puis l'appelant chiffre le
|
||||
bloc **entier** en AES-256-CTR. Ni la longueur ni le drapeau ne circulent en
|
||||
clair : l'exigence d'indifférenciabilité du cas C est satisfaite, et toutes les
|
||||
trames font 64 octets quel que soit leur contenu.
|
||||
|
||||
## Ce que cela n'est pas
|
||||
|
||||
`vc_frame_unpad` rejette un `L > 63`. **Ce n'est pas un contrôle
|
||||
d'intégrité** : sous CTR, un attaquant peut retourner des bits arbitraires du
|
||||
clair. Voir la réserve d'authentification de l'ADR 0003.
|
||||
|
||||
## Conséquences
|
||||
|
||||
- Si le manifeste prévoit un en-tête (version de protocole, identifiant de
|
||||
boîtier, MAC tronqué, numéro de compteur), cette disposition changera.
|
||||
- Le coût de ce changement est **borné à deux fonctions** : `vc_frame_pad_i` et
|
||||
`vc_frame_unpad_i` dans `asm/vercors_protocol.asm`. Aucun autre module ne
|
||||
connaît la structure interne de la trame.
|
||||
- Les 63 octets utiles maximum diminueront d'autant que l'en-tête réel occupe.
|
||||
Affichage de 100 fichiers sur 118. Ce diff contient trop de modifications pour tout afficher.
Voir plus
Référencer dans un nouveau ticket
Bloquer un utilisateur