diff --git a/docs/cellular/domaine/point-de-depart.md b/docs/cellular/domaine/point-de-depart.md new file mode 100644 index 0000000..1e2a5d0 --- /dev/null +++ b/docs/cellular/domaine/point-de-depart.md @@ -0,0 +1,62 @@ +# Cellular : point de départ + +Note de départ du domaine `cellular` (D-030). Elle se complète au fil du skill `nouveau-domaine` ; les pistes passent dans les fiches quand les analyses s'écrivent. + +## Question du domaine + +La liaison 4G de la station est-elle assez bonne pour que ses données arrivent, et se dégrade-t-elle ? + +## Ce que mesure le collecteur + +Source : `docs/aimsight/collecteur_system_info.py`, `get_modem_info`, `parse_*` et `map_csq_*` ; export par `SYNC_SPEC` (rubrique `modem`). Le modem n'est relu qu'un cycle sur dix ; entre deux lectures, la dernière réponse est reprise. + +| Métrique | Commande AT | Valeurs | Sens | +|---|---|---|---| +| `rsrp_dBm` | AT+CESQ | dBm, de −140 à −43 ; 255 = inconnu | puissance reçue du signal de référence LTE | +| `rsrq_dB` | AT+CESQ | dB, de −19,5 à −2,5 par pas de 0,5 | qualité reçue : RSRP rapporté à la puissance totale (bruit et interférences compris) | +| `rssi_dbm` | AT+CSQ | dBm, de −113 à −51 par pas de 2 ; 99 = inconnu | puissance totale reçue | +| `ber_percent` | AT+CSQ | %, codes 0 à 7 → 0,1 / 0,3 / 0,6 / 1,2 / 2,4 / 5 / 9 / 13 | taux d'erreur binaire | +| `registration` | AT+CEREG? | home, roaming, searching, denied, not_registered, unknown | enregistrement au réseau | +| `link` | AT+CGACT? et AT+CGPADDR | up, down | `up` si le contexte de données a une adresse IP | +| `network_technology` | AT+COPS? | GSM, UMTS, LTE, E-UTRAN | technologie radio | +| `network_operator` | AT+COPS? | texte | opérateur | + +- `SIM_CCID` et l'adresse IP du modem sont aussi exportés : ce sont des identifiants de station, à ne jamais recopier dans `docs/`. + +## Ce que montrent les données + +- **Instantanés** (`data/metadata.md`, 2026-10-09) : + - WILDSTRUBEL : RSRP −81 dBm, RSRQ −13,5 dB, RSSI −51 dBm, BER 2,4 %, E-UTRAN, `home`, `link` up ; + - VERMONT : RSRP −105 dBm, RSRQ −10 dB. +- **WEISSHORN** (`data/WEISSHORN/`, export du 2026-10-13, du 03/10 07:00 au 13/10 07:00 UTC) : + - moyennes horaires : RSRP de −98,25 à −60,50 dBm ; RSRQ de −18,75 à −5,00 dB ; RSSI de −67,5 à −51,0 dBm (le plafond est atteint) ; BER de 0,53 à 13,00 % ; + - les métriques texte sont la liste des échantillons de l'heure, un toutes les 15 minutes (ex. `['up', 'up', 'up', 'up']`). Sur tout l'export : `link` toujours `up`, `registration` toujours `home`, toujours `E-UTRAN`, un seul opérateur. Chaque heure a 4 échantillons, sauf la première et la dernière de l'export (2), coupées par l'extraction. + +## Ce qu'en dit la doc AIMsight + +- Manuel de la station (§ 4G Connectivity Setup) : le « Link status » doit passer à « Up » ; antenne dégagée, loin du métal et des autres antennes. +- FAQ : « A 4G connection may take a few minutes to become available after the station starts » ; réception faible en intérieur, en sous-sol, derrière du béton ou du métal ; « Loss of remote connectivity does not necessarily mean that the measurement station itself has stopped operating ». +- Contexte support (§ 5.1) : « Is the modem alive? », avec « modem state » comme preuve candidate. + +## Pièges connus + +- **Une donnée absente peut être l'anomalie elle-même** : quand le lien tombe, les mesures du modem n'arrivent plus. Distinguer un trou pendant une coupure d'énergie (croiser avec Energy), un trou avec la station alimentée (piste : le lien), et un trou rempli plus tard par une remontée différée. +- **RSSI à −51 dBm veut dire « −51 dBm ou plus »** : la valeur sature. +- Si la lecture du modem échoue, le collecteur rapporte `link = down` avec toutes les valeurs vides : un lien `down` sans mesures n'est pas un signal faible. +- **Moyennes de codes** : `ber_percent` et `rssi_dbm` sont des codes AT moyennés sur l'heure. Une moyenne comme 0,53 % ne correspond à aucun code. +- **Moyennes horaires en dB** : la moyenne de valeurs en dB n'est pas la moyenne des puissances, et elle aplatit les décrochages brefs. +- **Métriques texte** : `common.stations.load_csv` ne lit que des nombres et les ignore. +- **`SIM_CCID` se charge comme un nombre** (notation flottante) : il apparaît parmi les séries numériques. Ne jamais l'afficher ni le tracer. +- **Aucun seuil de qualité** (« bon », « faible ») n'a encore de source : il en faudra une (doc du module radio, opérateur, expert), ou bien comparer la station à son propre passé. + +## CSV reçus et manquants + +- Reçus (WEISSHORN) : toutes les métriques du modem de `SYNC_SPEC`, et `last_sync` (heures de synchronisation, toutes les 15 minutes ; piste pour un futur domaine « Communication »). +- Non reçu : l'adresse du VPN (`ip_address{interface="nebula"}`), hors de ce domaine. +- L'export couvre 10 jours : assez pour l'état du jour, court pour comparer la station à son propre passé. Un historique plus long le remplacera. + +## Pistes d'analyses (non décidées) + +- Le niveau du jour (médiane du RSRP), comparé au passé de la station. +- La part des heures avec `link = up`. +- Les heures sans mesure alors que la station est alimentée. diff --git a/docs/storage/domaine/point-de-depart.md b/docs/storage/domaine/point-de-depart.md new file mode 100644 index 0000000..bd44470 --- /dev/null +++ b/docs/storage/domaine/point-de-depart.md @@ -0,0 +1,51 @@ +# Storage : point de départ + +Note de départ du domaine `storage` (D-030). Elle se complète au fil du skill `nouveau-domaine` ; les pistes passent dans les fiches quand les analyses s'écrivent. + +## Question du domaine + +La station a-t-elle encore assez d'espace disque pour continuer à stocker ses mesures, et pour combien de temps ? + +## Ce que mesure le collecteur + +Source : `docs/aimsight/collecteur_system_info.py`, `get_proc_info` et `SYNC_SPEC` (rubrique `proc`). + +| Métrique exportée | Unité | Sens | +|---|---|---| +| `data_storage_free_gb` | GiB (÷ 1024³) | espace libre de la partition `/data` (`psutil.disk_usage('/data')`) | +| `data_storage_used_gb` | GiB | espace utilisé | +| `data_storage_total_gb` | GiB | taille de la partition | +| `data_storage_percent` | % | utilisé / (utilisé + libre), calcul de `psutil` | + +- Le collecteur publie les trois premières sous une seule métrique `data_storage_gb`, avec un label `state` (`free`, `used`, `total`). L'export CSV aplatit ce label dans le nom de la métrique. + +## Ce que montrent les données + +- **Instantanés** (`data/metadata.md`, 2026-10-09) : + - WILDSTRUBEL : total 5,98, libre 5,61, utilisé 0,04 GiB ; + - VERMONT expose d'autres noms, absents de notre copie du collecteur : `total_disk_1k-blk` (3 849 952), `used_disk_1k-blk` (2 829 916) et `avail_disk_1k-blk` (793 940), en blocs de 1 kio, ainsi que `DB_file_size`, `DB_total_entries`, `DB_uploaded`, `DB_not_uploaded`. +- **WEISSHORN** (`data/WEISSHORN/`, export du 2026-10-13, du 03/10 07:00 au 13/10 07:00 UTC, moyennes horaires) : libre de 3,21 à 3,48 GiB, utilisé de 2,17 à 2,45 GiB, total 5,98 GiB. + +## Ce qu'en dit la doc AIMsight + +- Manuel de la station (`AIMsight Test Manual.pdf`, § Disk) : « Monitor available capacity, especially for frequent schedules, long time series, or image-heavy acquisitions ». Après l'enregistrement d'un schedule, vérifier « available internal storage ». +- Contexte support (`AIMsight_agentic_support_project_context.md`, § 5.1) : « Is storage available? », avec « disk usage » comme preuve candidate ; « storage remaining » figure parmi les « Likely high-value future signals ». + +## Pièges connus + +- **Utilisé + libre ≠ total** : 5,65 contre 5,98 GiB chez WILDSTRUBEL ; 3,46 contre 3,67 GiB chez VERMONT. Un écart de 5 à 6 % est cohérent avec les blocs réservés d'ext4, mais ce n'est pas vérifié. Le pourcentage de `psutil` se calcule sans eux. +- **Deux familles de métriques** : `data_storage_*` (WEISSHORN, WILDSTRUBEL) et `*_disk_1k-blk` (VERMONT), selon la version du logiciel ou la partition mesurée. Laquelle vaut pour chaque station : question ouverte. +- **Les totaux diffèrent** d'une station à l'autre (3,67 et 5,98 GiB, peut-être pas la même partition) : raisonner en espace libre et en vitesse de remplissage, pas sur un pourcentage fixe. +- Un trou de mesure pendant une coupure d'énergie n'est pas un problème de disque : croiser avec Energy. + +## CSV reçus et manquants + +- Reçus (WEISSHORN) : `data_storage_free_gb`, `data_storage_used_gb`, `data_storage_total_gb`. +- Manquants : `data_storage_percent` (calculable à partir des deux premiers), et les métriques `DB_*` de VERMONT (base locale, envois en attente). +- L'export couvre 10 jours : assez pour l'état du jour, court pour une vitesse de remplissage. Un historique plus long le remplacera. + +## Pistes d'analyses (non décidées) + +- L'espace libre du jour. +- La vitesse de remplissage et les jours avant saturation (espace libre ÷ pente sur plusieurs jours). +- Les purges : sauts de l'espace libre vers le haut. diff --git a/src/cellular/__init__.py b/src/cellular/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/src/storage/__init__.py b/src/storage/__init__.py new file mode 100644 index 0000000..e69de29