診断ページと JSON API
ステーションが自分について知っていることのすべてを、/diagnostics の自動更新されるページ 1 枚に表示します。このページと他のページの裏にある機械可読のエンドポイントも、独自のスクリプトや監視に使えます。
このページは2 秒ごとに自動で再読み込みされ、そのたびにステーションの読み値の新しいスナップショットを取得します。連続した記録ではありません。上部の Raw JSON データのリンクは、同じ内容を 1 つの文書にしたもの(/api/status)です。行の中には、伝えることがあるときだけ表示されるものがあります。警告の行がなければ、何も起きていないということです。
1. ステーション
| 行 | 見るべき点 |
|---|---|
| ステーション | ローカルの 8xxx 番号。設定ファイルから来た値には remote、既定の 8000 なら の印が付きます(第6章)。 |
| 基板 | 基板自身の設定ピンから読み取った PCB リビジョンと PCB-Id。 |
| ファームウェア | バージョンとソースのリビジョン、イメージが確認済みか試用中か(第5章)。 |
| プロセッサ ID | 登録キーです。基板を雷観測ネットワークのアカウントにひも付けるときに伝えます。チップ固有の値で、変わることはありません。 |
| MAC | プロセッサ ID から決まるアドレス。ルーターの接続機器一覧で探すときに使います。 |
| 検出器 | 検出待機が正常です。安定化中は、起動直後や再調整直後のしばらくの間です。ファームウェア v450 以降は、起動時の遅延測定が終わるまで検出を開始せず、測定中は雷の報告を送信しません。 |
| 雷観測ネットワーク | 登録が有効なときに表示されます。登録済みなら station N、そうでなければ未登録と、登録の状況を示す注記。注記の意味は第7章にあります。 |
| 稼働時間 · 前回のリセット | 稼働時間だけではあまりわかりません。リセットの原因(power-on、reset pin、ソフトウェア、watchdog、brownout など)で、前回の起動が予定どおりだったかがわかります。ウォッチドッグ作動中と表示されているのが望ましい状態です。 |
| Boot journal | どのイメージがどれだけ動き、なぜ止まったかを新しい順に示す、再起動をまたいだステーション自身の履歴です(第7章)。 |
| Verdict | 健全性を 1 行で答えます。ファームウェア v440 からは言葉で(正常、異常あり、起動中と、あれば理由)、それより前は短いコードで表示します。すべての状態と理由を両方の表示で第7章に示します。 |
| MCU | プロセッサの温度と電源電圧。 |
2. GNSS
測位の状態、使用中の衛星の数、位置と高さ(高さがまだないときはその理由)、1PPS のロック。もう一度よく見ておきたい行:
- アンテナ(報告に対応する受信機の場合):正常、短絡、開放と、アンテナ用電源がオンかどうか。開放は標準のパッシブアンテナでは正常で、故障は短絡だけです。アンプ付きの外部アンテナ(アクティブアンテナ)を使っている場合、開放はアンテナに電源が届いていないことを示します。ケーブルとコネクターを確認してください。開放の検出がオフ(既定)のときは、「正常」が「短絡していない」という意味にすぎないことも表示されます(第3章)。
- フロントエンド:受信機の AGC、ノイズ、妨害の値。最大付近は受信している信号が非常に少ないことを示しますが、それだけで干渉と判断できるわけではありません。干渉は、妨害の値が高いことを示す印です。GPS ページでは、受信機が値を出さない場合の未測定と、妨害の測定値とを区別して表示します。
- タイマー（測定）とボーレート（検出）:1PPS で数えたステーションのタイマーと、受信機が見つかった通信速度。
- リング再同期 / UART 再同期:読み取り側が説明できなかった区間の数。データの損失ではありません。このページを表示するだけでも起こることがあります。(サンプルの損失を本当に示すのは検出器の欄のリング周回遅れで、ゼロであるべき値です。)
- Receiver TX queue(報告される場合):受信機の送信メッセージキューに入っているバイト数、現在の使用量、最大使用量。
- センテンス数 / エラー数とタイムスタンプ付き捕捉:受信機が送ったメッセージの量と、衛星に同期したタイムスタンプが付いた捕捉の数。
3. 検出器
ファームウェア v450 以降は、/api/status の chain_delay で入力ごとの遅延測定結果も確認できます。state と入力マスクで、実測値による補正、代替(fallback。ファームウェア v482 より前は公称値で補正し、v482 以降はその入力がバイパスを使用)、動作するフィルターが検出されなかった入力を区別します。遅延測定の自動再試行の状態、残りの試行回数、次の測定までの待ち時間も示します(第4章)。それ以外の経路の遅延は診断用で、時刻の補正には使用しません。
測定経路のリアルタイムの値です:変換器が動いているか、チャンネルと総合ゲイン、入力ごとの極性、トリガーの回数と頻度(毎秒と 60 秒間)、干渉の状態、カウント値とミリボルトでのしきい値、ゲインコード、ノイズとベースライン、区間の最小値と最大値、トーン除去と追跡、そして正常な運用ではゼロかそれに近いはずのカウンター群(リング周回遅れ、遅延ウィンドウ、読み取り位置の繰り上げ、タイムスタンプ破棄、使用不能なウィンドウ、ADC 再起動)。各警告の意味は第7章にあります。
ほかの読み値は JSON(/api/status)で確認できます。gain_writes — 起動以来に gain_auto が実際に適用したゲインの変更回数(第6章)。gain_holds — 上げた直後に下げに戻ったため、上げを保留した回数。band_rejects — バンド除去で取り除かれた、取り込んだ信号の部分の数。band_pct がオフの間は 0 のままです。hp_active — 実際に動作中の検出器ハイパスの遮断周波数(Hz)。フィルターがオフの間は 0 です(hp_hz が 0、または有効な入力が 2 つを超えている。第6章)。ファームウェア v482 以降の clip_captures — 入力 1〜4 それぞれについて、変換器の上限に達した(クリップした)捕捉の数。ゲインの調整が収束すると gain_writes は増えなくなります。増え続けているのはゲインが往復し続けている(狩り状態の)サインで、増えていないのが正常です。
4. ネットワークへの参加
検出器の欄の雷観測ネットワークの行で、ステーションの所有者が オンにする または オフにする を選べます。状態は オフ、オン、または登録によって送信先がまだ決まっていないときの オン · 収集サーバーが未設定 です。ファームウェア v482 以降、Denko の行は 常に参加 と表示され、ボタンはありません。ステーションは常に Denko に報告します。初期値では両方を選択しますが、任意参加のネットワークをオフにした既存の選択は保持されます。Aurora のステーション画面と、所有者または権限のある管理者向けのダッシュボードでも同じ選択ができます。ローカルの選択は基板に保存されます。ファームウェア v482 以降は、ダッシュボードで所有者が新しく保存すると、選択した値が同じでも次の設定取得時に適用され、設定に変更がない自動確認では、その後のローカルの選択が保持されます。Denko の行には送信先と送信数も表示します。v482 より前のファームウェアでは、Denko の行にも オフにする があり、ダッシュボードでの選択は反映されません。エラーメッセージは 第7章 を参照してください。
5. アンプ入力
最後の入力調査(ライブページから開始)の結果です:入力ごとのオフセット(mV)とノイズ(カウント値)。無効な入力には印が付き、使用中のチャンネルが示されます。静かな空と、何もつながっていない入力とを見分けるための診断です。症状は同じでも、対処はまったく違います。最初の調査の前は未調査と表示され、ライブページの入力を調査ボタンを案内します。
6. リモート設定
リモート設定が機能しているかどうか:取得の回数と失敗の回数、ファイルから適用したキーの数、コピーがフラッシュ保存されているか(なければ、再起動時に既定値に戻ります)。続いて、すべての設定とその現在の値、その出どころ(remote か )が並びます。第6章 3 節と同じ一覧です。
7. ファームウェア更新
自動の更新確認が何を見つけたかを示します(第5章)。マニフェスト確認は、確認の回数、成功と失敗の回数、最後の確認がどれだけ前かを示します。前回の結果と以前の結果は、各確認で更新が始まった、または始まらなかった理由を言葉で示します。再起動をまたいで保持されるので、再起動した基板でも以前に何があったかがわかります。すべての結果は第7章に一覧があります。自動更新がオフの基板では、結果は not enabled (fw_seq is 0) になります。
8. ネットワーク
リンクの状態、アドレスとプレフィックス長とゲートウェイ、DHCP の状態と取得したリースの数(意味は第7章)、Ethernet コントローラーのリビジョン、ステーションが知っている収集サーバーとそれぞれのパケット数、そして低レベルの通信量(フレーム数、ARP と ping への応答数、表示したページ数)。ファームウェア v482 以降の Ethernet RX resets は、受信エラーが起きたときや壊れたデータを受信したときに、ステーションが Ethernet の受信部を再起動した回数です。自動で回復するため、急速に増え続ける場合だけ報告してください。雷のあるときに送信パケット数が着実に増えていれば、ステーションがパケットを送信していることがわかります。受信側のサービスがそれを受け付けたことや、雷の位置を特定したことの証明にはなりません。この行にはsend_gap により保留されたパケットと、送信に失敗したパケットの数も表示されます。
9. JSON エンドポイント
どのページも小さな JSON API の上に作られていて、同じエンドポイントを独自のスクリプトから使えます。それぞれの前にステーションのアドレスを付けます(例:http://192.168.1.57/api/status)。表では、読み取り(GET)と操作(POST)を区別しています。操作の後は、ステーションの応答と現在の状態を確認してください。
| エンドポイント | メソッド | 返す内容 / 動作 |
|---|---|---|
/api/status | GET | 診断ページのすべてと、キーごとの出どころ付きの全設定。 |
/api/gnss | GET | 衛星、DOP、PPS、受信機の識別と能力。GPS ページのすべて。 |
/chain.json | GET | 信号経路の段の一覧。各値に、その値をどうやって知ったかが付きます(第2章)。 |
/api/scope | GET | 入力を自由に取り込んだスナップショット(ライブ表示のフレーム)。 |
/api/channels | GET | 4 チャンネルをそろえて取り込んだスナップショット 1 つ。無効な入力にはサンプルがありません。 |
/api/trig · /api/event | GET | 検出器が捕捉して送信した最後の区間と、トリガー前の履歴。 |
/api/captures · /api/capture/N | GET | 捕捉の履歴(直近 32 件)と、1 つの捕捉の完全な波形。 |
/api/resp | GET | 最後のスイープとゲイン確認の結果。ファームウェア v482 以降はゲインのタイミング測定も含みます(第4章)。 |
/api/alias | GET | 最後のエイリアス調査の結果。 |
/api/delay | GET | 入力ごとの遅延測定結果:フィルターの有無、各経路の実測遅延、補正に公称値を使用しているかどうか。ファームウェア v450 以降(第4章)。 |
/api/sweep | POST | 4 入力共通の診断用取り込みを要求します。m= で、有効な入力のうちどれを表示するかを選びます。マスクが 0 または省略された場合は、有効な入力を使います。 |
/api/scan | POST | 4 チャンネルの入力調査を始めます。結果は /api/status に入ります。調査中は検出が一時停止します。 |
/api/resp · /api/gaincheck · /api/alias | POST | スイープ、ゲイン確認、エイリアス調査を始めます。テストページのボタンが使います。ファームウェア v482 以降は、/api/resp に clear=… を送ると、測定を開始せずに保存済みの結果を消去します。ログインが必要です(第4章)。 |
/api/delay | POST | 全 4 入力の遅延測定を予約します。測定中は検出を一時停止し、安定してから再開します。GET で完了を確認してください。要求の受け付けは、測定の完了を意味するものではありません。ファームウェア v450 以降。 |
/api/cfg | POST | 実行中の設定の差分(第6章)。 |
/api/channels · /api/polarity | POST | 本機に保存する入力の有効マスク(mask 0..15、0 でフリートに従う)と、入力ごとの極性マスクを保存します。 |
/api/networks | POST | ネットワークへの参加を切り替えます:bo 0|1(雷観測ネットワーク)の行。ファームウェア v482 以降、Denko は常に参加し、denko 0 の行を送ってもオフになりません。それより前のファームウェアでは denko 0|1 も受け付けます。 |
/api/ota | POST | 次の定期確認を待たずに、今すぐファームウェアの更新を確認します。何をインストールしてよいかは変わりません。自動更新がオフ(fw_seq が 0)のとき、イメージが試用中のとき、確認が保留中のとき、リカバリーの更新処理が実行中のとき、前回受け付けた要求から 60 秒以内のときは拒否されます。 |
/api/reboot | POST | 再起動を要求します。更新の試用中は、確認済みになるか試用の期限が来るまで再起動を待ちます。 |
ログインの操作には GET /auth/state と、POST /auth/login、/auth/session、/auth/logout も使われます。第6章のとおり、ステーションのログイン画面を使ってください。ファームウェアの切り替えには POST /api/stockprepare、GET /api/stockready、POST /api/stock、POST /api/stockcommit が使われます。これらの操作はファームウェアページの手順に従って行ってください。
サンプルの区間は 16 進数の文字列で、12 ビットのサンプル 1 つにつき 3 文字です。1 カウントは変換器の入力で約 0.79 mV です。ゲインで割ると、アンテナでの値に換算できます。