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

11 KiB
Raw Blame History

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 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.
  • Exploration de WEISSHORN (2026-10-13, 241 heures) :
    • aucun incident : aucun trou dans les métriques du modem, link toujours up. Côté Energy, aucun trou non plus et BusVoltage ne descend jamais sous 13,91 V : pas de coupure. L'export décrit seulement le régime normal ;
    • RSRP à deux paliers : médiane −71 dBm ; hors 01–05 UTC, 126 heures sur 191 sont vers −72 dBm (−75 à −68) et 54 vers −62 dBm (−66 à −58). Le passage d'un palier à l'autre se fait d'une heure à la suivante, et un palier tient de quelques heures à plus d'une journée. 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 : 6 nuits sur 10 (04, 05, 07, 08, 09 et 11/10), le RSRP tombe à −81 / −98 dBm entre 01:00 et 06:00 UTC, puis remonte entre 03:00 et 07:00. Le RSSI quitte alors son plafond (−52 à −68 dBm), alors que le RSRQ reste dans sa plage habituelle (−8,8 à −14,2 dB) : 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,1 à −9,6 dB entre 02:00 et 04:00 UTC, de −16,0 à −16,4 dB à 10:00, 11:00 et 20:00 UTC. C'est cohérent avec la charge de la cellule, plus forte le jour (hypothèse). Médiane par jour stable, de −13,2 à −15,0 dB sur les jours complets ;
    • RSRP et RSRQ sont indépendants (r = −0,03, n = 241), ce sont deux informations distinctes. Le RSSI suit le RSRP (r = 0,80) ; le BER suit le RSRQ (r = −0,87, même cycle : médiane 1,5 % la nuit, 7 à 9,5 % le jour) et n'ajoute presque rien ;
    • aucun message perdu : 960 envois sur 960 attendus dans last_sync, espacés de 900 ± 1 s, partis 0,8 à 1,8 s après chaque quart d'heure ; à chaque heure, les métriques texte ont toutes le même nombre d'échantillons (un message isolé perdu ferait baisser le compte d'une seule). Les métriques numériques, en moyennes horaires, ne permettent pas ce compte. L'heure d'arrivée côté serveur n'est pas dans l'export : un envoi retardé par la file ne se distingue pas d'un envoi à l'heure ;
    • RSSI au plafond (−51 dBm) 220 heures sur 241 : 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 : 10 jours sans incident, le régime normal. 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).