設定とステーション ID
各設定値がどこから来るか、再起動後に何が残り何が残らないか、ステーションの設定、そしてステーションの 2 つの番号(ローカルの番号と、雷観測ネットワークが割り当てる番号)の関係を説明します。
1. 設定値の出どころ
設定値は 4 か所から与えられます:
| 出どころ | 適用されるとき | 再起動後 |
|---|---|---|
| 1. 既定値 | 電源投入時から使われます。保存済みまたはダウンロードした設定が値を与えるまで使われます。ダウンロードに失敗した場合はそれまでの設定が使われ、未知のキーは無視されます。 | 元に戻ります。変更はファームウェアの更新でのみ可能です。 |
| 2. リモート(フリート)設定 | ステーションが定期的(interval の設定、既定では 5 分ごと。現在のフリートのファイルは 60 秒ごとを指定)にダウンロードするファイル。フリート全体向けの行と、プロセッサ ID ごとの基板別ブロックがあり、基板別ブロックに書かれたキーはそちらが優先されます。基板に保存されるので、サーバーに接続できない間も適用されます。 | 残り、定期的に更新されます。 |
| 3. 実行中の変更 | ライブページと信号経路ページの設定欄、および POST /api/cfg。変更はすぐに適用されます。 | 失われます。たいていはそれより前に、次のリモート取得で上書きされます。 |
| 4. 本機に保存した選択 | 次の 3 つはあえて扱いを変えています:入力の有効/無効、入力ごとの極性、ネットワークへの参加。これらは基板に保存されます。所有者がダッシュボードで新しく保存したネットワークの選択は次回の設定ダウンロードで適用され、それ以外のときは、その後に本機で行った選択が有効なままです。 | 残ります(再び変更するまで)。 |
Web インターフェースからはまったく設定できないキーがあります:register、station、send_gap、verified、pick、gnss_mtk_plan はフリートで決めるもの、channel_mask は 4 行目の本機に保存した選択に属するものです。実行中の変更でこれらを指定しても無視され、これらしか含まない送信はそのものが拒否されます(no editable config keys)。
2. ステーション ID:2 つの番号
DENKO Blue のステーションには番号が 2 つあり、診断ページには両方が表示されます:
| 番号 | 出どころ |
|---|---|
| ローカル番号(8000〜8999) | station の設定値。リモート設定で割り当てない限り 8000 です。8xxx 番台は DENKO Blue のステーション用で、慣例として、下の桁を割り当てられた公開番号にそろえることができます。診断ページでは Station(ステーション)の行に表示され、設定ファイルから来た値には remote、そうでなければ の印が付きます。 |
| 雷観測ネットワークの番号 | 登録の際に雷観測ネットワークのサーバーが、基板のプロセッサ ID をもとに割り当てます。プロセッサ ID は診断ページに表示される長い 16 進数の文字列で、基板をアカウントにひも付けるときに伝える登録キーです。割り当てられると、この番号がステーションの公開 ID になり、雷観測ネットワーク(Lightning network)の行に station N と表示されます。 |
登録は、次の 3 つがすべてそろっている間だけ行われます:
registerが有効であること(既定ではオンで、基板ごとにフリートのファイルで決めます)、- プロセッサ ID が雷観測ネットワークのアカウントにひも付けられていること、
- GPS 受信機が 3D 測位していること(一度 3D 測位できれば、その後に測位を失っても登録は止まりません)。
衛星で測位できていない基板がローカル番号のままである理由。登録ではステーションの座標を申告し、各ステーションの申告座標は全員の位置計算に使われます。そのためファームウェアは、持っていない位置を登録しません。測位がなければ「北緯 0° 東経 0° を申告しない」、2D 測位なら「海抜 0 m の高度を申告しない」ということです。本当の 3D 測位が得られるまで登録は待機し、その間もステーションはローカルの 8xxx 番号で測定と報告を続けます。これは正常な動作で、故障ではありません。
3. 全設定の一覧
既定値は初期値で、リモート設定がフリート単位または基板単位でそれを置き換えます。数値の範囲の多くは丸められ、範囲外の値は範囲内のいちばん近い値になります。未知の protocol の値は無視され、範囲外の led_mode はクラシック(0)になります。収集先のアドレスとポートは、丸めではなく検証されます。所有者のログイン設定の組が不完全または無効な場合は、それまでの設定が使われます。channel_mask が主チャンネル channel を含んでいない場合も、その入力は有効になります。通常の設定と、それがリモートのファイルから来たかどうかは診断ページで確認できます。
| 設定 | 内容 | 既定値 | 範囲 |
|---|---|---|---|
trigger | 検出のしきい値。ベースラインから上下それぞれの ADC カウント値(1 カウント ≈ 0.79 mV)。ライブページのトリガー選択。ファームウェア v482 以降、trig_auto がオンの間は、この値を 2 つのゲイン段の既定の総合ゲイン(×16)でのしきい値として扱い、実際に設定されたゲインに合わせて換算します。trig_auto がオフなら設定値のまま使います。 | 99 | 20–2000 |
gain_pre、gain_post | 2 段のプログラマブルゲイン。ラダーのコード 0〜7 で、それぞれ ×1、×2、×4、×5、×8、×10、×16、×32。ライブページと図のゲイン選択。これらの既定値はファームウェア v451 から適用されます。リモート設定で変更できます。 | 4(×8)、1(×2) | 0–7 |
channel | 主チャンネル(表示・診断する入力)、1〜4。 | 1 | 1–4 |
interval | リモート設定を取得する間隔(秒)。 | 300 | 30–86400 |
pga_count | このコントローラーに実装されているプログラマブルゲイン段の数。保守用の設定です。お使いの基板向けに指定された値のままにしてください。 | 8 | 2–8 |
station | ローカルのステーション番号(2 節)。フリートでのみ設定。 | 8000 | 8000–8999 |
buzzer | ファームウェア v482 以降は、雷の表示(ledmode)と同じ雷に反応し、強度メーターの目盛り 1 つにつき 1 回、最大 7 回鳴ります。0 = オフ（既定）、1 = オン。ライブページで切り替えられます。それより前のファームウェアでは、オンの間、信号を捕捉するたびに 1 回クリック音を鳴らします。 | 0 | 0/1 |
ledmode | ファームウェア v482 以降、雷の表示で選ぶ対象。0 = 位置特定に当ステーションの時刻が使用された雷（既定）。1 = 当ステーションが参加していなくても、ネットワークが位置を特定した 250 km 以内の雷。見た目を選ぶ led_mode とは別の設定です。時刻が使用された雷は、当ステーションが報告した信号の強度の目盛りで表示します。付近の雷は Denko のサービスが提供する強度で表示し、衛星による現在地が必要です。 | 0 | 0/1 |
rate_max | 捕捉数(毎秒)がこの値以上になると検出器を抑制します。故障した入力やノイズであふれた入力でも、基板を操作できる状態に保つための上限です。 | 200 | 1–2000 |
caprank | 1 秒間の捕捉数が rate_max で許される数を超えたとき、先に届いた捕捉ではなく、信号の強い捕捉を優先して残します。0 = 先に届いたものを残す（既定）、1 = 信号の強いものを残す。試験的な機能です。Denko から依頼がない限り、0 のままにしてください。1 の間は、ステーションが 1 秒あたりに調べる捕捉の数が増えるため、入力のノイズが非常に多いときは、ほかの処理に使える時間が少なくなります。 | 0 | 0/1 |
send_gap | verified に指定された入力を含まないパケットの送信の最小間隔(秒)。間隔はそのようなパケットの前回の送信から数え、指定された入力からのパケットはこれを待たず、遅らせもしません。保留したパケットはsend_gap により保留として数えられます。register がオンのときは、この値にかかわらず 10 以上が適用されます。フリートでのみ設定。 | 10 | 0–3600 |
verified | 位置が特定された雷と照合し、雷を捉えていると確認できた入力。ビット 0–3 が入力 1–4 に対応します。この入力を含むパケットは send_gap で保留されず、標準的なステーションと同じ間隔で送られます:前のパケットから 0.604 ms 以上、どの 3 秒間にも 240 個まで、どの 60 秒間にも 3,660 個まで。ほかのパケットには引き続き send_gap が適用され、どのパケットにも同じ上限が適用されます。これらの上限で保留したパケットは /api/status の paced に数えられます。0(既定値)はどの入力も指定しないので、すべてのパケットに試用期間の間隔(send_gap)が適用されます。フリートでのみ設定。 | 0 | 0–15 |
pick | send_gap がどのパケットを通すか。0(既定値):間隔が空いた後の最初のパケット(従来どおり)。1:間隔が空いた後、それ自体の信号対雑音比がステーションのしきい値を超えた最初のパケット。しきい値は、間隔ごとに数個が超える程度に自動で調整されます。見送ったパケットはsend_gap により保留として数えられます。verified の入力からのパケットには影響しません。フリートでのみ設定。 | 0 | 0/1 |
encrypt | 暗号鍵が有効なときにパケットを封印(暗号化)します。既定はオン。診断の際に暗号化を経路から外せるように用意されています。 | 1 | 0/1 |
preamp_gain | アンプヘッドの申告ゲイン。実測値ではなく申告値です(信号経路ページを参照)。 | 10 | 1–1000 |
trig_auto | 実測したノイズフロアでトリガーのしきい値を引き上げられるようにします。ノイズが増えたチャンネルはあふれる代わりに静かになります。オフにするとしきい値が固定され、試験台ではそのほうが便利です。ファームウェア v482 以降は、オンの間 trigger も設定したゲインに合わせて換算されます(trigger を参照)。 | 1 | 0/1 |
filter_hz | ローパスフィルターの遮断周波数の要求値(Hz)。設定として受け付ける範囲は 1,000〜200,000 Hz ですが、遅延測定の有効範囲は 10,000〜100,000 Hz（両端を含む）です。有効な実測値をその入力のフィルター遅延補正に使用し、範囲内で測定結果が不確かな場合は代替値(fallback)を使用していると表示します。ファームウェア v482 以降は、そのような入力はバイパスを使用し、要求した遮断周波数が測定範囲外の間はすべての入力がバイパスを使用します。公称のフィルター補正は使わず、フィルター遅延補正はゼロです。それより前のファームウェアでは、これらの場合もフィルターを経路に残し、公称値で補正します。動作するフィルターが検出されなかった入力もバイパスを使用します。 | 25200 | 1000–200000 |
gain_auto | ファームウェアが noise_target に向けてゲインを自動調整します。調整は収束するように設計されています:上げた場合にその先のノイズの水準が目標の帯域の上限を超えないときだけゲインを 1 段上げます。上げると帯域を大きく超えてしまうような場合は、より静かな下の段に留まります。また、静かになった読み取りが 10 秒間続いて初めてその上げを実行します。上げた直後に下げに戻るような場合、その入力は下の段に留まり、その上げは初回は 5 分、以後は往復するたびに 2 倍(最長 1 時間)のあいだ再試行されません。ノイズフロアの上昇による最初の保留は、その後ノイズが十分に下がれば早めに終わることがあります。2 倍に延びた以降の保留や、クリップによる保留は最後まで続きます。クリップによってゲインを下げた後に元の段へ戻る上げでは 10 秒の待ちはなく、1 回の判定で 1 段ずつ上がります。下げは即時です。クリップやノイズフロアの上昇によっては、すぐにゲインが下がります。ファームウェア v451 から、自動ゲインは既定でオンです。旧フリート既定値の gain_auto 0、gain_pre 6、gain_post 5 は、初期ゲイン設定 4/1 の自動ゲインに移行されます。基板固有の gain_auto 0 で自動調整を無効にできます。旧フリート設定の場合、この指定で手動ゲインの初期設定 6/5 を維持します。実行中の変更は、次に設定のダウンロードに成功するか、再起動するまで有効です。 | 1 | 0/1 |
noise_target | gain_auto が目指す静かなときのノイズの大きさ。変換器での RMS カウント値(32 ≈ 25 mV)。 | 32 | 20–2000 |
noise_target_a、noise_target_b、noise_target_c、noise_target_d | 入力 1〜4 それぞれに別の noise_target を設定します。単位は変換器での RMS カウント値で、noise_target と同じです。入力ごとにノイズフロアが異なる基板向けの設定です。0(既定)ではその入力は noise_target に従います。0 以外で 20 未満の値は 20 に引き上げられます。 | 0 | 0 または 20–2000 |
gain_ceiling | gain_auto 使用時に、信号が変換器の片側振幅の何 % まで使ってよいかを指定します。この値を超えた場合に、その入力のゲインを 1 段下げます。1 秒の大部分のウィンドウが閾値を超えないと作動しないため、1 回の雷だけでは反応しません。上限が有効な間は、上限またはクリップによってゲインを下げると、その入力のゲインは 300 秒(5 分)の間再上昇しません。0(既定)でオフ。0 以外で 50 未満の値は 50 に引き上げられます。 | 0 | 0 または 50–95 |
gnss_sys | 要望する測位衛星系のビットマスク:1 GPS、2 GLONASS、4 Galileo、8 BeiDou。要望であり、受信機ができる範囲に合わせて調整されます(第3章)。 | 5 | 1–15 |
ant_ocd | GPS アンテナの短絡に加えて開放も検出するよう受信機に求めます。既定はオフで、オフのときの「正常」は「短絡していない」という意味にすぎません。 | 0 | 0/1 |
register | 雷観測ネットワークに登録します(2 節)。フリートでのみ設定。 | 1 | 0/1 |
mux_pre | 1 段目のゲインの入力経路:0 = 増幅経路(×4)、1 = 直結経路(×1)。 | 0 | 0/1 |
mux_post | 2 段目のゲインの入力経路:0 = フィルター経由、1 = バイパス。ノイズを抑えるため、実装されているフィルターは既定で経路に入れます。ファームウェア v450 以降は、起動時に入力ごとにフィルターを確認し、動作するフィルターが検出されなかった入力を自動でバイパスにします。ファームウェア v482 以降は、測定でフィルターの動作を確認できなかった入力もバイパスにします。ほかの入力は、それぞれの経路を使用します。時刻の補正には、トリガーした入力が使用している経路の遅延を使用します。 | 0 | 0/1 |
protocol | 送信に使う純正互換プロファイル:94、101、110(純正 9.4、10.1、11.x)。101 と 110 は、登録によって有効な鍵を得てからでないと送信しません(第7章の nokey)。ライブページのプロトコル選択。 | 94 | 94/101/110 |
fw_seq | 自動更新のスイッチ:0 以外(既定は 1)なら、段階的な配信でこのステーションに提供された新しい更新を許可し、0 にするとこの基板では無効になります(第5章)。 | 1 | 0–65535 |
channel_mask | フリートの入力有効マスク。ビット 0〜3 が入力 1〜4。本機に保存した入力の選択があれば、そちらが優先されます(第2章)。 | 15 | 1–15 |
reject_hz | 単一周波数のトーン除去。連続した妨害トーンが乗っていて、そのままでは周期ごとにトリガーしてしまう入力のためのものです。0(既定)ではステーションに任せます:ライブ信号を監視し、安定したトーンを最大 4 つまで自動で捕まえます(トーン追跡の行が学習中、次に使用中になります)。0 以外の値を指定するとその周波数(Hz)で除去し、自動追跡は止まります(手動設定)。 | 0 | 0–240000 |
reject_pct | 区間を除去するために、そのピークのうちトーンで説明できなければならない割合(%)。 | 75 | 1–99 |
reject_lo | 自動トーン追跡(reject_hz を参照)が、3 kHz 未満の安定したトーン(約 1.9 kHz まで)も監視するようにします。0(既定)では 3 kHz 以上を監視します。 | 0 | 0/1 |
band_lo | バンド除去の下限(Hz)。取り込んだ信号のうち、エネルギーが band_lo 〜 band_hi の帯域に集中している部分は、送信される前に取り除かれます(件数は第8章で数えられます)。単一周波数のトーンではない、低周波の広いバーストへの対処です。 | 1500 | 0–60000 |
band_hi | バンド除去の上限(Hz)。既定値の 1500 と 4000 は、この除去が対象とするバースト妨害の帯域を指定したものです。 | 4000 | 0–60000 |
band_pct | 除去のしきい値(%)。信号の部分について、エネルギーの少なくともこの割合が帯域内にある場合に取り除きます。0(既定)でオフになり、この除去は検出に影響しません。測定可能な周波数が 1 つも含まれない帯域は除去されません。この機能には次の引き換えがあります:バーストのエネルギーがウィンドウの大部分を占める場合、その上に乗った雷の信号も一緒に取り除かれます。 | 0 | 0–99 |
hp_hz | 検出器のハイパスフィルターの遮断周波数(Hz)。ファームウェア v442 から。入力に常時乗っている低周波の安定したトーン(キャリア)がある設置場所で、そのトーンにしきい値が乗ってしまうのを防ぐための、基板ごとの設定です。除かれるのはトリガーの判定だけで、取り込んだ信号、ライブページ、送信されるすべてのパケットは生のままです。フィルターがかかるのはトリガーの判定と、そのしきい値のもとになるノイズフロアだけです。このときライブページでは各チャンネルが 2 本描かれ、実線が送信どおりの生の信号、破線がトリガーが実際に判定した信号です(第1章)。0(既定)でオフのときは、検出器はこれまでどおり動作します。0 以外の値はフィルターの実用範囲(3000〜20000)に収まるよう調整されます。また、有効な入力が 2 つまでの間だけ動作し、3 つ以上の間はオフのままです。静かな環境では雷の最初の部分の大きさをわずかに削るため、既定はオフで、必要な基板だけに設定するものです。 | 0 | 0 または 3000–20000 |
led_mode | 状態表示の LED に何を表示するか:0 クラシック(LED ごとに意味がある)、1 強度メーター、2 消灯(制御できる LED をすべて消灯)。ライブページの LED 選択。各モードは第7章で説明しています。 | 1 | 0–2 |
auth_req | ステーションの所有者によるログインの設定:1 = オン、0 = オフ。Denko ダッシュボードから設定します。ログインの手順は5 節に従い、この設定値は所有者に任せてください。 | 0 | 0–1 |
auth_nb | 所有者によるログインのリセット時刻(Unix 秒)。auth_req とともにダッシュボードから管理されます。所有者に任せてください。 | 0 | 0–4294967295 |
netenable | Denko ダッシュボードでステーションの所有者が選んだネットワーク(第8章):1 が雷観測ネットワーク、2 が Denko です。Denko は常に含まれるため、0 と 2 はどちらも Denko のみ、1 と 3 は両方を意味します。リモート設定のこのステーション固有のセクションからのみ読み取ります。ダッシュボードで新しく保存すると次の設定取得時に適用され、それ以外のときは基板に保存された選択が保たれます。ファームウェア v482 以降。 | — | 0–3 |
gnss_mtk_plan | 対応する衛星受信機向けの、測位衛星系の組み合わせ方の選択(任意)。0 = 従来の組み合わせ方、1 = 要求した測位衛星系を優先順に試します。Denko が基板ごとに設定します。ほかの種類の受信機では無視されます。フリートでのみ設定。 | 0 | 0/1 |
collector_ip | このステーション用に指定された Denko の収集先。0 では通常の収集先を使います。フリートでのみ設定。Denko に任せてください。 | 0 | 0 または有効なユニキャスト IPv4 の値 |
collector_port | collector_ip のポート。収集先を置き換えるには、アドレスとポートの両方が必要です。0 で置き換えを取り消します。フリートでのみ設定。 | 0 | 0–65535 |
collector2_ip | 任意の追加の収集先。写しを受け取るもので、Denko の収集先を置き換えるものではありません。0 = オフ。フリートでのみ設定。Denko に任せてください。 | 0 | 0 または有効なユニキャスト IPv4 の値 |
collector2_port | collector2_ip のポート。追加の収集先を使うには、アドレスとポートの両方が必要です。0 = オフ。フリートでのみ設定。 | 0 | 0–65535 |
network_revision | ダッシュボードで新しく保存されたネットワークの選択を識別します。これにより、その後に本機で行った選択が、内容の変わらないダウンロードで元に戻されることはありません。ダッシュボードが管理します。編集しないでください。 | 0 | 0–4294967295 |
4. 自分で設定を変更する
ページが送るのと同じ差分を、手作業で送ることもできます。キー 値 の行を POST します:
curl -X POST --data-binary $'trigger 130\ngain_pre 5\n' http://<IP アドレス>/api/cfg
- 差分は部分的で、指定しなかったキーは現在の値のままです。すぐに適用されますが、次のリモート取得で上書きされ、再起動すると何も残りません。
register、station、send_gap、verified、pick、gnss_mtk_plan、channel_maskは、ステーション自身の設定をそのまま送り返した場合でも、この送信では無視されます。- 本機に保存する選択には専用のエンドポイントがあります:
POST /api/channelsにmask 0..15(0 で再びフリートに従う)、POST /api/polarityに同じ形式。こちらは再起動しても残ります。
ステーションは設定された値で最もよく動作します。意味を理解している場合だけ変更してください。状況を悪くした実行中の変更は、基板を再起動するか、次の取得を待つだけで元に戻ります。
5. トークンによるログイン
ページでログインを求められたら、ステーションの所有者が Denko ダッシュボードから発行したログイントークンを使ってください。トークンは dk1. で始まる長いテキストです。
ライブページ、信号経路ページ、またはテストページを開きます。右下のボックスでログインを押し、トークン全体を貼り付けて、もう一度ログインを押します。トークンを確認しています…の後、ボックスにログイン有効期限とその時刻が表示されます。設定を確認し、変更をもう一度適用してください。終わったらログアウトを押します。ファームウェアページにはログインボックスがありません。先にこれらのページのどれかでログインしてから、同じブラウザータブでファームウェアページを開いてください。
再起動の後やログインの期限が切れた後は、もう一度ログインしてください。トークンで許可されていない操作には、所有者に適切なトークンを依頼してください。ダッシュボードからコンソールを使っている場合は、再試行する前にコンソールのメッセージに従ってください。コンソールが中断しただけでは、変更が行われたかどうかはわかりません。
起動時、ステーションは設定を待ちます。最初のダウンロードは起動から約 20 秒後に予定されていますが、接続にはそれより時間がかかることがあります。待機中のメッセージが続く場合は、ステーションのインターネット接続を確認し、所有者にログイン設定の確認を依頼してください。
| メッセージ | 意味と対処方法 |
|---|---|
| 局の設定を待っています。この状態が続く場合は、所有者にこの局のログイン設定の確認を依頼してください。観測と自動更新は継続します。 | ステーションが設定を待っています。最初のダウンロードは起動から約 20 秒後に予定されています。表示が続く場合は、ステーションのインターネット接続を確認し、所有者にこのステーションのログイン設定の確認を依頼してください。 |
| 観測局の時計がまだ設定されていません。GNSSが測位してから再試行してください。 | ステーションは、トークンを確認する前に、GPS 受信機から時刻を得る必要があります。GPS ページで測位が表示されるまで待ち、その後、再試行してください。 |
| このトークンは有効期限が切れています。観測局の所有者に新しいトークンを依頼してください。 | トークンの使用期限が過ぎています。所有者に新しいトークンを発行してもらってください。 |
| このトークンは失効しています。観測局の所有者に新しいトークンを依頼してください。 | 所有者がこのトークンとそれ以前に発行したすべてのトークンを失効させました。所有者に新しいトークンを発行してもらってください。 |
| このトークンはまだ有効ではありません。観測局の時計を確認してください。 | 数分待ってから再試行してください。それでも続く場合は、ステーションの時計を確認し、所有者に新しいトークンを発行してもらってください。 |
| 試行回数が多すぎます。1分待ってから再試行してください。 | 短い時間に複数のログイン試行が行われました。1分待ってから再試行してください。 |
| 観測局が処理中です。少し待ってから再試行してください。 | ステーションがちょうどログインを受け付けられませんでした。少し待ってから再試行してください。 |
| このトークンはこの観測局では使えません。 | トークンは別のステーション用に作成されていたり、全体が貼り付けられていなかった可能性があります。正しいステーションであることを確認し、トークンをすべて貼り付けてください。 |
| 変更が適用された可能性があります。再度変更する前に、観測局の現在の状態を確認してください。 | すでに行われた操作を繰り返さないよう、再試行の前に現在の設定や結果を読み直してください。 |
| コンソールのセッションが期限切れか、利用できなくなりました。ダッシュボードからコンソールを開き直してください。観測局のログイントークンはまだ有効な場合があります。 | ダッシュボードから観測局コンソールを開き直し、現在の状態を確認してください。 |
| このリクエストではコンソールへのアクセスが拒否されました。ダッシュボードに戻ってアクセス権を確認してください。観測局のログイントークンはまだ有効な場合があります。 | 再試行する前に、ダッシュボードに戻ってアクセス権を確認してください。 |