Files
Support-Agent/docs/cellular/domaine/point-de-depart.md
T

63 lines
4.9 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/`.
## 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.