Files
Support-Agent/docs/cellular/domaine/point-de-depart.md
T
maximeandClaude Opus 5.5 75b681d2db Rerun the cellular analyses on the 65-day WEISSHORN export
WEISSHORN now shows its commissioning (link down on 19-20/08), a send
cadence that settles on 01/09, six days with one to three missing
sends and one DOWN day from a single down sample. Update the starting
note, both fiches and the expert questions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 12:33:10 +02:00

84 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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/`.
- **Cadence** : le collecteur tourne à 1 Hz (`refresh_rate=1`), donc le modem est relu toutes les 10 s, et sa réponse est gardée 120 s dans Redis (`_store_in_redis`). `sync` (`cmd_sync`, lancé de l'extérieur) envoie un instantané toutes les 15 minutes, cadence observée sur WEISSHORN et NORDEND mais fixée ni par le collecteur ni par la doc, sous forme d'un message par métrique dans la file Redis `aimsight:sync`, relayée ensuite par MQTT (les champs vides ne sont pas envoyés). La moyenne horaire est donc celle de 4 instantanés : ce qui se passe entre deux envois n'est pas vu.
## Ce que montrent les données
- **Instantanés** (notes de l'expert du 2026-10-09, retirées du dépôt, D-033) :
- 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 09/08 10:00 au 13/10 10:00 UTC ; l'export de 10 jours du 03-13/10, qu'il contient, est remplacé) :
- moyennes horaires : RSRP de −114 à −60,25 dBm ; RSRQ de −18,75 à −5,00 dB ; RSSI de −79 à −51 dBm (le plafond est atteint) ; BER de 0,45 à 13,00 % ;
- les métriques texte sont la liste des échantillons de l'heure, un toutes les 15 minutes (ex. `['up', 'up', 'up', 'up']`). Toujours `E-UTRAN`, un seul opérateur ; `registration` toujours `home`, sauf `searching` et `not_registered` à la mise en service (19/08).
- **Exploration de WEISSHORN** (2026-10-13, 1 301 heures mesurées, dès le 19/08 09:00) :
- **début d'historique et mise en service** : aucune mesure avant le 19/08 09:00, puis deux trous (19/08 12:00-15:00 et 19/08 16:00 au 20/08 10:00), sur tous les champs, `BusVoltage` compris. Les premiers envois (19/08 09:00 à 11:00, 20/08 10:00) disent `link = down`, le modem cherche le réseau ; `BusVoltage` vaut alors 12,94 à 13,53 V, puis ne descend plus sous 13,91 V dès le 21/08. Ensuite, plus aucun trou ;
- **cadence des envois** : du 19/08 au 31/08, des intervalles de 880 à 899 s, jusqu'à 437 s après le quart d'heure ; dès le 01/09, 900 ± 1 s, ~1 s après chaque quart d'heure (4 exceptions). Le changement coïncide avec le bloc de 1,3 GiB écrit sur `/data` le 31/08 et le début de l'acquisition (`docs/storage/domaine/point-de-depart.md`) ;
- **depuis le 21/08, quelques incidents isolés** : un échantillon `down` parmi 4 envois arrivés (03/09 15:00) ; un envoi manquant entre 01:00 et 02:00 UTC les 29/08, 30/08, 01/09, 05/09 et 06/09 ; trois le 22/08 à 17:00 et 19:00, quand `/data` écrit et efface des fichiers ; un envoi en trop le 02/09 à 14:00 ;
- **RSRP à deux paliers** : médiane −71 dBm ; hors 01–05 UTC, 729 heures sur 1 027 sont vers −72 dBm (−76 à −67) et 291 vers −62 dBm (au-dessus de −67). Le passage d'un palier à l'autre se fait d'une heure à la suivante. C'est cohérent avec deux cellules qui servent tour à tour, mais ce n'est pas vérifiable : ni l'identifiant de cellule ni la bande ne sont exportés ;
- **décrochages de nuit** : 40 nuits sur 54, le RSRP tombe sous −78 dBm entre 01:00 et 06:00 UTC (jusqu'à −99,25 dBm). Le RSSI quitte alors son plafond, alors que le RSRQ reste dans sa plage habituelle : le signal est plus faible, mais pas plus pollué. Cause non établie (autre cellule, atténuation…) : à demander à l'expert ;
- **RSRQ à cycle quotidien** : médiane par heure de −9,5 dB à 02:00 UTC, de −15,0 à −15,5 dB entre 11:00 et 21:00 UTC. C'est cohérent avec la charge de la cellule, plus forte le jour (hypothèse). Médiane par jour stable, de −15,0 à −12,6 dB sur les jours complets ;
- **RSRP et RSRQ sont presque indépendants** (r = −0,12, n = 1 297), ce sont deux informations distinctes. Le RSSI suit le RSRP (r = 0,85) ; le BER suit le RSRQ (r = −0,85, même cycle : médiane 1,8 % la nuit, 7,0 % le jour) et n'ajoute presque rien ;
- **RSSI au plafond** (−51 dBm) 1 151 heures sur 1 297 : il n'est informatif que pendant les décrochages de nuit.
- **NORDEND** (`data/NORDEND/`, export du 2026-10-13, du 26/06 08:00 au 13/10 08:00 UTC, 2 617 heures ; D-032) :
- **autre version du collecteur** : ni `link` ni `registration` ; `SIM_CCID` en texte ; en plus `ip_modem`, `ip_nebula1`, `mode` (toujours `WUP`, sens inconnu), `DB_*` ;
- **signal faible mais propre** : RSRP horaire de −115 à −91 dBm, à deux paliers (~−112 dBm, 920 heures ; ~−101 dBm) ; RSRQ de −14 à −5,8 dB ; RSSI de −84 à −70 dBm, jamais au plafond ; BER de 0,5 à 6 %. Une heure en GSM (06/09 08:00) ;
- **12 trous communs à toutes les métriques** : le premier (71 h) est le début d'historique ; les 11 autres font 1 à 23 h (106 h). Au retour, `BusVoltage` vaut 13,94 à 14,37 V, sans redémarrage à 12,6 V : cohérent avec une station alimentée, donc avec une coupure de la liaison. Rien n'arrive plus tard dans ces heures : les envois perdus le restent. 9 trous sur 11 commencent après une heure à −111,75 dBm ou moins (42 % des heures) ;
- **envois irréguliers** : 9 846 reçus ; souvent 5 à 7 par heure vers 06:00 et 09:00 UTC, et des intervalles de 0 à 14 min hors cadence. Depuis juillet, 633 heures (26 %) ont au moins un envoi sans les champs du modem : cohérent avec des lectures du modem qui échouent.
## 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 ».
- FAQ : « one measurement every 15 minutes » vise les acquisitions de la caméra, pas l'envoi de l'état de la station.
- Contexte support (§ 5.1) : « Is the modem alive? », avec « modem state » comme preuve candidate.
- Manuel (§ Approved Radio Module) : le module radio est un NimbeLink Skywire NL-SW-LTE-TC4WWG (Telit LE910C4-WWX, FCC ID RI7LE910CXWWX). La doc AIMsight ne donne aucun seuil de signal.
## 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` les charge comme la liste des échantillons de l'heure (D-031) ; `ip` aussi : ne jamais la tracer.
- **`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.
- **Une marche du RSRP n'est pas forcément une dégradation** : sur WEISSHORN, il saute de ~10 dB entre deux paliers stables (changement de cellule probable, non observable).
- **Cycles quotidiens** : le RSRQ et le BER varient selon l'heure, et le RSRP décroche souvent la nuit. Comparer des journées entières (fenêtres multiples de 24 h), pas des heures prises isolément ; un minimum du jour serait déclenché presque chaque nuit.
- **Seuils de qualité** : ni la norme ni la doc AIMsight n'en donnent. La seule source retenue est une grille publiée pour un autre modem (Quectel BG96, via KORE Wireless), reprise par `DAILY_SIGNAL_STATE` (D-031) ; les grilles en circulation diffèrent de 10 à 20 dB d'un éditeur à l'autre.
## 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.
- Non exporté : le journal de la station, où `cmd_sync` écrit le nombre de messages de chaque envoi (« Synced %d system_info metrics to cloud »).
- Non mesurés par le collecteur : l'identifiant de cellule et la bande. Ils permettraient de distinguer un changement de cellule d'une dégradation.
- WEISSHORN : 55 jours mesurés, une mise en service (`link = down`), puis le régime normal avec quelques incidents isolés. NORDEND : 109 jours, avec des coupures de la liaison, mais sans `link`.
## Analyses et pistes
- Avancement (skill `nouveau-domaine`, 2026-10-13) : étapes 1 à 3 faites (WEISSHORN, NORDEND) ; 4 en attente de l'expert (`questions-pour-l-expert.md`) ; 5 en prototype ; 6 (couleur du jour) et 7 (figure, maquettes, guide) à faire.
- Analyses écrites (D-031, D-032), fiches dans `docs/cellular/analyses/` : `DAILY_LINK_STATE` (part des envois reçus avec `link = up`) et `DAILY_SIGNAL_STATE` (médianes du jour du RSRP et du RSRQ sur la grille publiée).
- Pistes non décidées : comparer la station à son propre passé (quand l'historique sera long) ; séparer les envois manquants pendant une coupure d'énergie de ceux d'une station alimentée (croisement avec Energy).