Add the Storage and Cellular domains with their starting notes

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 09:38:33 +02:00
1 parent dd4841a6d8
commit 504c8634e3
4 files changed
+113

No files matched your search

+62
View File
@@ -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.