Die Seite Diagnose und die JSON-API
Alles, was die Station über sich selbst weiß, auf einer sich selbst aktualisierenden Seite unter /diagnostics — dazu die maschinenlesbaren Endpunkte hinter dieser und den anderen Seiten, für Ihre eigenen Skripte und Ihre Überwachung.
Die Seite lädt sich alle zwei Sekunden selbst neu — jedes Neuladen erstellt eine neue Momentaufnahme der Messwerte der Station. Es handelt sich nicht um eine fortlaufende Aufzeichnung. Der Link JSON-Rohdaten oben enthält denselben Inhalt als ein Dokument: /api/status. Manche Zeilen erscheinen nur, wenn sie etwas zu melden haben — fehlt eine Warnzeile, ist nichts vorgefallen.
1. Station
| Zeile | Worauf zu achten ist |
|---|---|
| Station | Die lokale 8xxx-Nummer, gekennzeichnet mit remote, wenn sie aus der Konfigurationsdatei stammt, und mit , wenn es der Standardwert 8000 ist (Kapitel 6). |
| Platine | Die PCB-Revision und die PCB-Id, ermittelt aus den eigenen Brücken der Platine. |
| Firmware | Version und genaue Quellrevision sowie die Angabe, ob das Image bestätigt oder im Probebetrieb ist (Kapitel 5). |
| Prozessor-ID | Der Registrierungsschlüssel: Geben Sie ihn an, wenn Sie die Platine im Blitzmessnetz mit einem Konto verknüpfen. Fest im Silizium hinterlegt; ändert sich nie. |
| MAC | Aus der Prozessor-ID abgeleitet — die Adresse, nach der Sie in der Client-Liste des Routers suchen. |
| Detektor | scharf ist der Normalzustand; schwingt ein bezeichnet die ersten Augenblicke nach dem Start oder einer Neuabstimmung. Ab Firmware v450 bleibt der Detektor außerdem während der Verzögerungsprüfung beim Start unscharf; währenddessen werden keine Blitzmeldungen gesendet. |
| Blitzmessnetz | Wird angezeigt, wenn die Registrierung aktiviert ist: nach erfolgter Registrierung Station N, andernfalls nicht registriert, mit einem Hinweis zum Stand der Registrierung. Die Hinweise werden in Kapitel 7 erläutert. |
| Betriebszeit · Letzter Neustart | Die Betriebszeit allein sagt wenig; die Ursache des Neustarts (power-on, reset pin, software, watchdog, brownout …) zeigt, ob der letzte Start geplant war. Watchdog scharf ist das, was Sie sehen möchten. |
| Boot journal | Welche Images gelaufen sind, wie lange und warum jedes beendet wurde, neueste zuerst — der eigene Verlauf der Station über Neustarts hinweg (Kapitel 7). |
| Bewertung | Die Zustandsantwort in einer Zeile — ab Firmware v440 in Worten (in Ordnung, nicht in Ordnung, startet, mit allen Gründen), davor als Kurzcode. Alle Zustände und Gründe in beiden Formen: Kapitel 7. |
| MCU | Prozessortemperatur und Versorgungsspannung. |
2. GNSS
Fix-Status, verwendete Satelliten, Position und Höhe (mit dem Grund, solange noch keine Höhe vorliegt) sowie die 1PPS-Synchronisation. Zeilen, die einen zweiten Blick verdienen:
- Antenne (bei Empfängern, die sie melden): OK, KURZSCHLUSS oder OFFEN, und ob die Antennenversorgung ein ist. OFFEN ist mit der passiven Standardantenne normal; nur KURZSCHLUSS ist ein Fehler. Verwenden Sie eine externe Antenne mit Verstärker (aktive Antenne), bedeutet OFFEN, dass sie nicht versorgt wird: Prüfen Sie Kabel und Stecker. Ist die Erkennung offener Antenne ausgeschaltet (Standard), ergänzt die Zeile, dass „OK“ nur „kein Kurzschluss“ bedeutet (Kapitel 3).
- Eingangsstufe: AGC-, Rausch- und Störsignalwerte des Empfängers. nahe am Maximum bedeutet sehr wenig empfangenes Signal; das allein weist noch nicht auf Störungen hin. Störung kennzeichnet einen erhöhten Störsignalwert. Die Seite GPS unterscheidet außerdem eine Störsignalmessung von nicht gemessen, wenn der Empfänger keinen Wert liefert.
- Timer, gemessen und Baudrate, erkannt: der gegen 1PPS gezählte Timer der Station und die Geschwindigkeit, mit der der Empfänger gefunden wurde.
- Ringpuffer-Neusynchronisierungen / UART-Neusynchronisierungen: Intervalle, die das Auslesen nicht zuordnen konnte. Kein Datenverlust — schon das Ausliefern dieser Seite kann eine auslösen. (Der Zähler, der tatsächlich verlorene Abtastwerte bedeutet, ist Ringpuffer-Überholungen im Abschnitt Detektor, und er sollte null anzeigen.)
- Receiver TX queue (falls gemeldet): Bytes in der Warteschlange, aktuelle und maximale Auslastung der Warteschlange für ausgehende Nachrichten des Empfängers.
- Sätze / Fehler und Erfassungen mit Zeitstempel: wie viel der Empfänger gesendet hat und wie viele Erfassungen einen satellitengestützten Zeitstempel erhalten haben.
3. Detektor
Ab Firmware v450 enthält /api/status außerdem chain_delay, die Ergebnisse der Verzögerungsprüfung je Eingang. Dessen state und Eingangsmasken unterscheiden eine gemessene Korrektur, eine Ersatzlösung (vor Firmware v482 eine Nennwertkorrektur; ab v482 nutzt dieser Eingang den Bypass) und „Kein funktionierender Filter erkannt“. Außerdem werden der Zustand automatischer Wiederholungen der Verzögerungsprüfung, die verbleibenden Versuche und die Wartezeit bis zur nächsten Prüfung gemeldet (Kapitel 4). Die übrigen Pfadverzögerungen sind Diagnosewerte, keine Zeitstempelkorrekturen.
Die Live-Messwerte der Messkette: ob der Wandler läuft, Kanal und Gesamtverstärkung, Polarität je Eingang, Trigger-Zähler und -Raten (pro Sekunde und über 60 Sekunden), Störungszustand, die Schwelle in Zählerwerten und Millivolt, Verstärkungscode, Rauschen und Basislinie, Minimum und Maximum des Fensters, Tonunterdrückung und Tonverfolgung sowie eine Reihe von Zählern, die im gesunden Betrieb bei oder nahe null bleiben sollten — Ringpuffer-Überholungen, verspätete Fenster, Leser-Nachführungen, Zeitstempel-Ausfälle, unbrauchbare Fenster, ADC-Neustarts. Jede Warnung wird in Kapitel 7 erläutert.
Weitere Werte stehen im JSON (/api/status): gain_writes — Verstärkungsänderungen, die gain_auto seit dem Start vorgenommen hat (Kapitel 6); gain_holds — Erhöhungen, die zurückgestellt wurden, nachdem ein Schritt nach oben sofort wieder zurückging; band_rejects — Teile erfasster Signale, die durch das Band-Veto verworfen wurden; der Wert bleibt 0, solange band_pct ausgeschaltet ist; hp_active — die tatsächlich wirksame Hochpass-Eckfrequenz des Detektors in Hz, 0 bei ausgeschaltetem Filter (hp_hz 0 oder mehr als zwei aktivierte Eingänge; Kapitel 6); und ab Firmware v482 clip_captures — für jeden der Eingänge 1–4 die Anzahl der Erfassungen, die die Grenze des Wandlers erreicht haben (übersteuert). Eine eingeschwungene Verstärkungsregelung schreibt nicht mehr: Ein ständig steigendes gain_writes ist das Zeichen für Pendeln, ein gleichbleibendes das Zeichen für gesunden Betrieb.
4. Netzwerkteilnahme
Im Abschnitt Detektor kann der Stationsbesitzer in der Zeile Blitzmessnetz einschalten oder ausschalten wählen. Sie zeigt aus, ein oder ein · noch kein Kollektor, wenn die Registrierung noch kein verwendbares Ziel geliefert hat. Ab Firmware v482 zeigt die Zeile Denko immer aktiv und hat keine Schaltfläche: Die Station meldet immer an Denko. Beide Netze sind standardmäßig ausgewählt; eine bestehende Entscheidung, das optionale Netz zu verlassen, bleibt wirksam. Dieselbe Auswahl steht auf der Stationsseite von Aurora und im Dashboard für den Stationsbesitzer oder einen berechtigten Administrator zur Verfügung. Lokale Entscheidungen werden auf der Platine gespeichert; ab Firmware v482 gilt ein neues Speichern durch den Besitzer im Dashboard beim nächsten Konfigurationsabruf, auch wenn der gewählte Wert unverändert ist, und eine unveränderte automatische Prüfung erhält eine spätere lokale Entscheidung. Die Zeile Denko zeigt außerdem ihr Ziel und die Paketanzahl. Firmware vor v482 bietet auch in der Zeile Denko ausschalten an und übernimmt die Auswahl nicht aus dem Dashboard. Fehlermeldungen werden in Kapitel 7 erläutert.
5. Verstärkereingänge
Die Ergebnisse der letzten Eingangsprüfung (gestartet auf der Seite Live): Offset jedes Eingangs in mV und Rauschen in Zählerwerten, wobei deaktivierte Eingänge gekennzeichnet und der aktive Kanal markiert ist. Diese Diagnose unterscheidet einen ruhigen Himmel von einem unbestückten Eingang — identische Symptome, völlig unterschiedliche Abhilfe. Bis zur ersten Prüfung zeigt der Abschnitt noch nie geprüft und verweist auf die Schaltfläche Eingänge prüfen der Seite Live.
6. Fernkonfiguration
Ob die Fernkonfiguration funktioniert: Abrufe und Fehler, wie viele Schlüssel die Datei angewendet hat und ob eine Kopie im Flash gespeichert ist (ohne sie stellt ein Neustart die Standardwerte wieder her). Danach jede Einstellung, ihr aktueller Wert und ihre Herkunft — remote oder — dieselbe Liste wie in Kapitel 6, Abschnitt 3.
7. Firmware-Update
Was die automatischen Update-Prüfungen ergeben haben (Kapitel 5): Manifest-Abfragen zählt die Prüfungen, wie viele erfolgreich waren oder fehlgeschlagen sind und wie lange die letzte zurückliegt; Letztes Ergebnis und Frühere Ergebnisse geben in Worten an, warum eine Prüfung ein Update gestartet hat oder nicht — über Neustarts hinweg erhalten, sodass auch eine neu gestartete Platine noch mitteilt, was zuvor geschah. Alle Ergebnisse sind in Kapitel 7 aufgeführt. Auf einer Platine mit ausgeschalteter Selbstaktualisierung lautet das Ergebnis nicht aktiviert (fw_seq ist 0).
8. Netzwerk
Verbindungsstatus, Adresse und Präfix mit dem Gateway, DHCP-Zustand und bezogene Leases (erläutert in Kapitel 7), die Revision des Ethernet-Controllers, die Kollektoren, die die Station kennt, mit den Paketzählern für jeden sowie Verkehrszähler auf niedriger Ebene (Frames, ARP- und Ping-Antworten, ausgelieferte Seiten). Ab Firmware v482 zählt Ethernet RX resets, wie oft die Station ihren Ethernet-Empfänger nach einem Empfangsfehler oder beschädigten eingehenden Daten neu gestartet hat; sie erholt sich von selbst, und nur ein schnell steigender Zähler ist eine Meldung wert. Steigt Gesendete Pakete bei Gewitterwetter stetig an, zeigt das, dass die Station Pakete sendet. Es beweist nicht, dass der empfangende Dienst sie angenommen oder Blitze geortet hat. Die Zeile meldet außerdem Pakete, die durch send_gap zurückgehalten wurden, sowie fehlgeschlagene.
9. Die JSON-Endpunkte
Jede Seite basiert auf einer kleinen JSON-API, und Sie können dieselben Endpunkte in Ihren eigenen Skripten nutzen. Setzen Sie die Adresse der Station davor, zum Beispiel http://192.168.1.57/api/status. Die Tabelle unterscheidet Abfragen (GET) von Aktionen (POST). Prüfen Sie nach einer Aktion die Antwort und den aktuellen Zustand der Station.
| Endpunkt | Methode | Rückgabe / Wirkung |
|---|---|---|
/api/status | GET | Alles auf der Seite Diagnose, dazu die vollständige Konfiguration mit der Herkunft jedes Schlüssels. |
/api/gnss | GET | Satelliten, DOP, PPS, Identität und Fähigkeiten des Empfängers — alles auf der Seite GPS. |
/chain.json | GET | Die Stufenliste der Signalkette, jeder Wert mit der Angabe, woher er stammt (Kapitel 2). |
/api/scope | GET | Eine frei laufende Momentaufnahme der Eingänge (die Aufzeichnung der Live-Ansicht). |
/api/channels | GET | Eine ausgerichtete Momentaufnahme aller vier Kanäle; deaktivierte Eingänge enthalten keine Abtastwerte. |
/api/trig · /api/event | GET | Das letzte Fenster, das der Detektor erfasst und gesendet hat, mit seinem Vortrigger-Verlauf. |
/api/captures · /api/capture/N | GET | Die Liste des Erfassungsverlaufs (die letzten 32 Erfassungen) und die vollständige Wellenform einer Erfassung. |
/api/resp | GET | Ergebnisse des letzten Frequenzgang-Sweeps und der letzten Verstärkungsprüfung sowie ab Firmware v482 das Zeitverhalten der Verstärkung (Kapitel 4). |
/api/alias | GET | Ergebnis der letzten Alias-Untersuchung. |
/api/delay | GET | Ergebnisse der Verzögerungsprüfung je Eingang: Filtererkennung, gemessene Pfadverzögerungen und ob eine Nennwert-Ersatzlösung die Korrektur liefert. Ab Firmware v450 (Kapitel 4). |
/api/sweep | POST | Fordert eine gemeinsame Diagnoseerfassung aller vier Eingänge an. m= wählt, welche aktivierten Eingänge angezeigt werden; eine Maske von null oder eine fehlende Maske verwendet die aktivierten Eingänge. |
/api/scan | POST | Startet die Eingangsprüfung der vier Kanäle; die Ergebnisse erscheinen in /api/status. Während einer Prüfung ist die Erkennung pausiert. |
/api/resp · /api/gaincheck · /api/alias | POST | Starten den Sweep, die Verstärkungsprüfung und die Alias-Untersuchung. Die Schaltflächen der Seite Tests nutzen diese Endpunkte. Ab Firmware v482 akzeptiert /api/resp außerdem clear=…, um gespeicherte Ergebnisse zu entfernen, ohne einen Test zu starten; dafür ist eine Anmeldung erforderlich (Kapitel 4). |
/api/delay | POST | Stellt eine neue Verzögerungsprüfung aller vier Eingänge in die Warteschlange. Die Erkennung pausiert für die Prüfung und läuft nach dem Einschwingen weiter. Fragen Sie per GET ab, ob sie abgeschlossen ist; eine angenommene Anfrage ist noch keine abgeschlossene Messung. Ab Firmware v450. |
/api/cfg | POST | Eine Konfigurationsänderung zur Laufzeit (Kapitel 6). |
/api/channels · /api/polarity | POST | Speichern die lokale Maske der aktivierten Eingänge (mask 0..15, 0 folgt der Flotte) und die Polaritätsmaske je Eingang. |
/api/networks | POST | Schaltet die Netzwerkteilnahme: Zeilen der Form bo 0|1 (das Blitzmessnetz). Ab Firmware v482 ist Denko immer aktiv, und eine Zeile denko 0 schaltet es nicht aus; frühere Firmware akzeptiert auch denko 0|1. |
/api/ota | POST | Sucht sofort nach einem Firmware-Update, statt auf die nächste planmäßige Prüfung zu warten. Daran, was installiert werden darf, ändert sich nichts; die Anfrage wird abgelehnt, solange die Selbstaktualisierung ausgeschaltet ist (fw_seq 0), solange sich das Image im Probebetrieb befindet, solange eine Prüfung aussteht, solange der Recovery-Updater beschäftigt ist oder innerhalb von 60 Sekunden nach der letzten angenommenen Anfrage. |
/api/reboot | POST | Fordert einen Neustart an. Während eines Update-Probebetriebs wartet der Neustart auf die Bestätigung oder das Ende der Probefrist. |
Die Anmeldefunktionen nutzen außerdem GET /auth/state sowie POST /auth/login, /auth/session und /auth/logout. Verwenden Sie das Anmeldefenster der Station wie in Kapitel 6 beschrieben. Die Firmware-Umstellung nutzt POST /api/stockprepare, GET /api/stockready, POST /api/stock und POST /api/stockcommit; folgen Sie für diese Aktionen der Vorgehensweise auf der Seite Firmware.
Abtastfenster sind Hex-Zeichenketten mit drei Zeichen pro 12-Bit-Abtastwert. Ein Zählerwert entspricht am Wandler etwa 0.79 mV; teilen Sie durch die Verstärkung, um einen Wert auf die Antenne zu beziehen.