La page Diagnostic et l’API JSON
Tout ce que la station sait d’elle-même, sur une seule page qui s’actualise d’elle-même à l’adresse /diagnostics — ainsi que les points d’accès lisibles par machine qui alimentent cette page et les autres, pour vos propres scripts et votre supervision.
La page se recharge d’elle-même toutes les deux secondes — chaque rechargement prend un nouvel instantané des mesures de la station. Ce n’est pas un enregistrement continu. Le lien Données JSON brutes en haut de la page donne le même contenu sous forme d’un seul document : /api/status. Certaines lignes n’apparaissent que lorsqu’elles ont quelque chose à signaler — une ligne d’avertissement absente signifie qu’il ne s’est rien passé.
1. Station
| Ligne | Ce qu’il faut regarder |
|---|---|
| Station | Le numéro local 8xxx, marqué distant lorsqu’il provient du fichier de configuration et lorsqu’il s’agit de la valeur par défaut 8000 (chapitre 6). |
| Carte | La révision du PCB et le PCB-Id, décodés à partir des pontages de la carte elle-même. |
| Micrologiciel | La version et la révision exacte des sources, et si l’image est confirmé ou en essai (chapitre 5). |
| ID du processeur | La clé d’enregistrement : indiquez-la pour associer la carte à un compte sur le réseau de détection de la foudre. Fixée dans le silicium ; elle ne change jamais. |
| MAC | Dérivée de l’ID du processeur — l’adresse à rechercher dans la liste des clients du routeur. |
| Détecteur | armé est l’état normal ; stabilisation correspond aux premiers instants après le démarrage ou un réaccord. Depuis le micrologiciel v450, le détecteur reste aussi désarmé pendant la vérification du retard au démarrage ; aucun rapport de foudre n’est envoyé pendant celle-ci. |
| Réseau de détection de la foudre | Affichée lorsque l’enregistrement est activé : station N une fois enregistrée, sinon non enregistré, avec une note indiquant où en est l’enregistrement. Les notes sont expliquées au chapitre 7. |
| Durée de fonctionnement · Dernière réinitialisation | La durée de fonctionnement seule dit peu de chose ; la cause de la réinitialisation (mise sous tension, broche de reset, logiciel, chien de garde, baisse de tension …) indique si le dernier démarrage était prévu. chien de garde armé est ce que vous voulez voir. |
| Boot journal | Quelles images ont tourné, pendant combien de temps et pourquoi chacune s’est arrêtée, les plus récentes d’abord — l’historique propre de la station à travers les redémarrages (chapitre 7). |
| Verdict | La réponse d’état en une ligne — en mots depuis le micrologiciel v440 (en bon état, en défaut, démarrage en cours, avec les éventuelles raisons), sous forme de code court auparavant. Chaque état et chaque raison, sous les deux formes : chapitre 7. |
| MCU | Température et tension d’alimentation du processeur. |
2. GNSS
L’état du positionnement, les satellites utilisés, la position et l’altitude (avec la raison lorsqu’il n’y a pas encore d’altitude), et la synchronisation 1PPS. Les lignes qui méritent un second regard :
- Antenne (sur les récepteurs qui la signalent) : correct, COURT-CIRCUIT ou CIRCUIT OUVERT, et si l’alimentation de l’antenne est activé. CIRCUIT OUVERT est normal avec l’antenne passive standard ; seul COURT-CIRCUIT est un défaut. Si vous utilisez une antenne externe avec un amplificateur (antenne active), CIRCUIT OUVERT signifie qu’elle n’est pas alimentée : vérifiez son câble et son connecteur. Lorsque la détection de circuit ouvert est désactivée (par défaut), la ligne précise que « correct » signifie seulement « sans court-circuit » (chapitre 3).
- Étage d’entrée : les valeurs d’AGC, de bruit et de brouillage du récepteur. proche du maximum signifie que très peu de signal est reçu ; cela n’identifie pas à lui seul une interférence. interférence signale une mesure de brouillage élevée. La page GPS distingue aussi une mesure de brouillage de l’état non mesuré lorsque le récepteur ne fournit aucune mesure.
- Temporisateur, mesuré et Débit en bauds, détecté : le temporisateur de la station compté par rapport au 1PPS, et la vitesse à laquelle le récepteur a été trouvé.
- Resynchronisations du tampon circulaire / Resynchronisations UART : des intervalles dont le lecteur n’a pas pu rendre compte. Ce n’est pas une perte de données — le simple fait de servir cette page peut en provoquer une. (Le compteur qui signifie bien des échantillons perdus est Dépassements du tampon circulaire, dans la section Détecteur, et il doit rester à zéro.)
- Receiver TX queue (lorsqu’elle est signalée) : octets en file, occupation actuelle et occupation maximale de la file des messages sortants du récepteur.
- Trames / erreurs et Captures horodatées : la quantité d’informations envoyées par le récepteur, et le nombre de captures ayant reçu un horodatage asservi aux satellites.
3. Détecteur
Depuis le micrologiciel v450, /api/status inclut aussi chain_delay, les résultats par entrée de la vérification du retard. Son state et ses masques d’entrées distinguent une correction mesurée, un repli (une correction nominale avant le micrologiciel v482 ; depuis v482, cette entrée utilise le contournement) et l’absence de filtre fonctionnel détecté. Il indique aussi l’état des nouvelles tentatives automatiques de mesure du retard, le nombre de tentatives restantes et l’attente avant une nouvelle vérification (chapitre 4). Les autres retards de chemin sont des diagnostics, pas des corrections d’horodatage.
Les mesures en direct de la chaîne de mesure : si le convertisseur tourne, le canal et le gain total, la polarité de chaque entrée, le nombre et la cadence des déclenchements (par seconde et sur 60 secondes), l’état d’interférence, le seuil en points et en millivolts, le code de gain, le bruit et la ligne de base, le minimum et le maximum de la fenêtre, le rejet et le suivi de tonalité, ainsi qu’une famille de compteurs qui doivent rester à zéro ou presque en fonctionnement normal — dépassements du tampon circulaire, fenêtres tardives, rattrapages du lecteur, rejets d’horodatage, fenêtres inutilisables, redémarrages ADC. Chaque avertissement est expliqué au chapitre 7.
D’autres mesures sont disponibles dans le JSON (/api/status) : gain_writes — les changements de gain appliqués par gain_auto depuis le démarrage (chapitre 6) ; gain_holds — les augmentations qu’il a mises en attente après qu’une hausse a été aussitôt annulée ; band_rejects — les parties de signaux capturés écartées par le veto de bande, qui reste à 0 tant que band_pct est désactivé ; hp_active — la fréquence de coupure du passe-haut du détecteur réellement en vigueur, en Hz, 0 lorsque le filtre est désactivé (hp_hz à 0, ou plus de deux entrées activées ; chapitre 6) ; et, depuis le micrologiciel v482, clip_captures — pour chacune des entrées 1–4, le nombre de captures ayant atteint la limite du convertisseur (écrêtées). Une boucle de gain stabilisée cesse d’écrire : un gain_writes qui ne cesse d’augmenter est le signe d’une oscillation, une valeur stable le signe d’un bon fonctionnement.
4. Participation au réseau
Dans la section Détecteur, la ligne Réseau de détection de la foudre permet au propriétaire de la station de choisir activer ou désactiver. Elle affiche désactivé, activé, ou activé · aucun collecteur pour l’instant lorsque l’enregistrement n’a pas fourni de destination utilisable. Depuis le micrologiciel v482, la ligne Denko indique toujours actif et n’a pas de bouton : la station envoie toujours ses rapports à Denko. Les deux réseaux sont sélectionnés par défaut ; un choix existant de quitter le réseau facultatif reste en vigueur. La même sélection est disponible sur la page de la station Aurora et dans le tableau de bord pour le propriétaire de la station ou un administrateur autorisé. Les choix locaux sont enregistrés sur la carte ; depuis le micrologiciel v482, un nouvel enregistrement du propriétaire dans le tableau de bord s’applique à la prochaine récupération de configuration, même si la valeur sélectionnée n’a pas changé, et une vérification automatique sans changement conserve un choix local plus récent. La ligne Denko indique aussi sa destination et le nombre de paquets. Les micrologiciels antérieurs à v482 proposent aussi désactiver sur la ligne Denko et ne reprennent pas le choix du tableau de bord. Les messages d’échec sont expliqués au chapitre 7.
5. Entrées de l’amplificateur
Les résultats de la dernière analyse des entrées (lancée depuis la page En direct) : le décalage de chaque entrée en mV et son bruit en points, avec les entrées désactivées signalées et le canal actif mis en évidence. C’est le diagnostic qui distingue un ciel calme d’une entrée non équipée — symptômes identiques, remède complètement différent. Avant la première analyse, la section indique jamais analysées et renvoie au bouton Analyser les entrées de la page En direct.
6. Configuration distante
Si la configuration distante fonctionne : récupérations et échecs, nombre de clés appliquées par le fichier, et si une copie est Conservé en flash (sans copie enregistrée, un redémarrage rétablit les valeurs par défaut). Puis chaque réglage, sa valeur actuelle et sa provenance — distant ou — la même liste qu’au chapitre 6, section 3.
7. Mise à jour du micrologiciel
Ce que les vérifications automatiques de mise à jour ont trouvé (chapitre 5) : Vérifications du manifeste compte les vérifications, combien ont réussi ou échoué et depuis combien de temps la dernière a eu lieu ; Dernier résultat et Résultats précédents expliquent en mots pourquoi chaque vérification a lancé ou non une mise à jour — conservés à travers les redémarrages, de sorte qu’une carte qui a redémarré vous dit encore ce qui s’est passé avant. Tous les résultats sont répertoriés au chapitre 7. Sur une carte dont la mise à jour automatique est désactivée, le résultat indique non activé (fw_seq vaut 0).
8. Réseau
L’état de la liaison, l’adresse et le préfixe avec la passerelle, l’état DHCP et les baux obtenus (expliqués au chapitre 7), la révision du contrôleur Ethernet, les collecteurs que la station a appris avec les compteurs de paquets de chacun, et des compteurs de trafic de bas niveau (trames, réponses ARP et ping, pages servies). Depuis le micrologiciel v482, Ethernet RX resets compte combien de fois la station a redémarré son récepteur Ethernet après une erreur de réception ou des données entrantes endommagées ; elle se rétablit d’elle-même, et seul un compteur qui augmente rapidement mérite d’être signalé. Un compteur Paquets envoyés qui augmente régulièrement pendant un orage montre que la station envoie des paquets. Cela ne prouve pas que le service destinataire les a acceptés ni qu’il a localisé la foudre. La ligne indique aussi les paquets retenu par send_gap et ceux qui ont échoué.
9. Les points d’accès JSON
Chaque page repose sur une petite API JSON, et vous pouvez utiliser les mêmes points d’accès dans vos propres scripts. Faites précéder chacun de l’adresse de la station, par exemple http://192.168.1.57/api/status. Le tableau distingue les lectures (GET) des actions (POST). Vérifiez la réponse de la station et son état actuel après une action.
| Point d’accès | Méthode | Ce qu’il renvoie / fait |
|---|---|---|
/api/status | GET | Tout le contenu de la page Diagnostic, plus la configuration complète avec la provenance de chaque clé. |
/api/gnss | GET | Satellites, DOP, PPS, identité et capacités du récepteur — tout le contenu de la page GPS. |
/chain.json | GET | La liste des étages de la chaîne du signal, chaque valeur accompagnée de la manière dont elle est connue (chapitre 2). |
/api/scope | GET | Un instantané en défilement libre des entrées (la trame de la vue En direct). |
/api/channels | GET | Un instantané aligné des quatre canaux ; les entrées désactivées ne contiennent aucun échantillon. |
/api/trig · /api/event | GET | La dernière fenêtre capturée et envoyée par le détecteur, avec son historique avant déclenchement. |
/api/captures · /api/capture/N | GET | La liste de l’historique des captures (les 32 dernières captures), et la forme d’onde complète d’une capture. |
/api/resp | GET | Les résultats du dernier balayage de réponse et de la dernière vérification des gains, et depuis le micrologiciel v482 la temporisation des gains (chapitre 4). |
/api/alias | GET | Le résultat de la dernière analyse des repliements. |
/api/delay | GET | Les résultats par entrée de la vérification du retard : détection du filtre, retards de chemin mesurés et si un repli nominal fournit la correction. Depuis le micrologiciel v450 (chapitre 4). |
/api/sweep | POST | Demande une capture de diagnostic commune aux quatre entrées. m= choisit les entrées activées à afficher ; un masque nul ou absent utilise les entrées activées. |
/api/scan | POST | Lance l’analyse des entrées sur les quatre canaux ; les résultats arrivent dans /api/status. Une analyse suspend la détection. |
/api/resp · /api/gaincheck · /api/alias | POST | Lancent le balayage, la vérification des gains et l’analyse des repliements. Les boutons de la page Tests les utilisent. Depuis le micrologiciel v482, /api/resp accepte aussi clear=… pour supprimer les résultats enregistrés sans lancer de test ; cela nécessite une connexion (chapitre 4). |
/api/delay | POST | Met en file une nouvelle vérification du retard sur les quatre entrées. La détection est suspendue pendant la vérification et reprend après stabilisation. Interrogez GET pour savoir quand elle est terminée ; une demande acceptée n’est pas une mesure terminée. Depuis le micrologiciel v450. |
/api/cfg | POST | Un correctif de configuration à chaud (chapitre 6). |
/api/channels · /api/polarity | POST | Enregistrent le masque local des entrées activées (mask 0..15, 0 suit le parc) et le masque de polarité par entrée. |
/api/networks | POST | Change la participation aux réseaux : lignes bo 0|1 (le réseau de détection de la foudre). Depuis le micrologiciel v482, Denko est toujours actif, et une ligne denko 0 ne le désactive pas ; les micrologiciels antérieurs acceptent aussi denko 0|1. |
/api/ota | POST | Vérifie immédiatement la présence d’une mise à jour du micrologiciel au lieu d’attendre la prochaine vérification programmée. Cela ne change rien à ce qui peut être installé, et la demande est refusée tant que la mise à jour automatique est désactivée (fw_seq à 0), tant que l’image est en essai, tant qu’une vérification est en attente, tant que le programme de mise à jour de récupération est occupé, ou dans les 60 secondes qui suivent la dernière demande acceptée. |
/api/reboot | POST | Demande un redémarrage. Pendant un essai de mise à jour, le redémarrage attend la confirmation ou l’échéance de l’essai. |
Les commandes de connexion utilisent aussi GET /auth/state et POST /auth/login, /auth/session et /auth/logout. Utilisez la fenêtre de connexion de la station comme décrit au chapitre 6. La conversion du micrologiciel utilise POST /api/stockprepare, GET /api/stockready, POST /api/stock et POST /api/stockcommit ; suivez la procédure de la page Micrologiciel pour ces actions.
Les fenêtres d’échantillons sont des chaînes hexadécimales, trois caractères par échantillon de 12 bits. Un point vaut environ 0.79 mV au niveau du convertisseur ; divisez par le gain pour ramener une valeur à l’antenne.