機械翻訳であり、ネイティブスピーカーによる確認は行われていません。英語版が基準です。

このページの7件の部分は、翻訳後に変更されたため、英語で表示しています。

受信機の信頼性と海事GitHub で編集ソース:docs/MARITIME-TRUST.md

海事向けの信頼性:ブリッジはこの測位解を信頼できるか

kshana receiver-trust は、移動する船について、あらゆる受信機がすでにバスに流している情報(まず NMEA 0183)から、位置の測位解ごとに 0-100 の信頼度をリアルタイムで採点し、どのチェックがそれを下げたかを示せます。これは受信機の隣に置くソフトウェア層です。受信機ではなく、受信機の代わりにはならず、測位解をより正確にするものでもありません。

助言用ソフトウェア。Kshana は、型式承認を受けた航法装置(IEC 61108、IEC 61162)ではなく、いかなる性能規格に対しても評価を受けていません。そのスコアとゲートは、航海士の判断を助けるものです。船舶の安全な航行、および測位解に依拠する、または依拠をやめるという判断の責任は、引き続き運用者にあります。

このページでは、チェックが何を見ているか、それぞれが何を捕捉でき、何を捕捉できないか、リアルタイムでの実行方法、ゲートの動作を説明します。スコアの対応付けとすべての既定値は RECEIVER-TRUST.md にあります。

読み取る内容#

船はセッションファイルで宣言され、その限界値は実行前に明記されます:

[platform]
kind = "vessel"
max_speed_kn = 20.0        # includes any current you want to allow for: it limits speed over ground
max_accel_mps2 = 0.2
max_turn_rate_dps = 2.0
antenna_height_m = 18.0    # antenna above the waterline
heading_sensor = true      # the stream carries a gyro or compass heading
センテンス 読み取る内容
GGA 位置、測位品質(0 = 測位なし)、平均海面からの高度、ジオイド分離、HDOP
RMC ステータス(A は有効、V は無効)、対地速力と対地針路、日付、モード
VTG RMC にない場合の対地速力と対地針路
HDT、THS 船首方位(THS はモードが V でない場合のみ)
VHW、VBW 対水速力(VBW はステータスが A の場合のみ)
ZDA 時刻
GSV 衛星ごとの信号強度(dB-Hz)、仰角、方位角(ジオメトリ用)
GSA DOP(精度低下率)と使用衛星(ジオメトリ用で、GSV が空を与えない場合や、ガードが比較する、申告された HDOP のため)
$PKSOS,<A/F/N> 受信機が報告した OSNMA のステータスで、受信機を読み取るアダプターがこのセンテンスに変換したもの:A は認証済み、F は失敗、N は結果なし

受信機自身が衛星による測位解ではないと述べているエポック(GGA の品質 0、または 6 から 8:推定、手動、シミュレーター。RMC のステータス V、またはモード E、M、S、N)は、位置のチェックには使われず、どちらの方向の証拠にもなりません:受信機がすでにそう述べているためです。

最初の calibration_s 秒はベースラインを形成し、採点されません。すべてのモニターは現在と過去のエポックだけを見るため、あるエポックでの判断は、後のデータが届いても変わらず、ライブのストリームは、同じテキストをファイルとして読んだ場合と同じスコアを与えます。

各チェックが捕捉できること、できないこと#

測位解の間の方向(旋回率チェックで使う航跡方位、二つの位置から導かれる針路)は、それらの間の弦の方向であり、これは最初の測位解での前方方位角ではなく、測位解の間の測地線の平均方位角です。この二つは、測位解の間の子午線収束角のおよそ半分だけ異なります(緯度 59.5 度で基線 260 m のとき 0.001 度)。

偽造された位置は、船の物理や船の他のセンサーと整合しなければなりません。各チェックは、測位解をそのうちの一つと比較します。チェックの独立性は、その相手のソースと同程度にとどまります:GNSS コンパスからの船首方位や、GNSS から導かれた「対水速力」は、テスト対象の受信機から独立しておらず、何も加えません。

チェック 捕捉できるもの 捕捉できないもの
kinematic 位置のステップ。報告された速力と針路では説明できない動きをする航跡。明示した船の限界値を超える、導かれた速力、加速度、旋回率 報告された速力と針路が偽造された航跡に従い、限界値の範囲内にとどまるドラッグオフ(受信機は自身の解からそれらを導くため、互いに一致します)。高すぎる値で設定された速力の限界値
heading-course 明示したカニ角(偏流角)を超えて、船首の向きから外れていく航跡 針路に沿ったドラッグオフ(針路は変わりません)。同じ受信機または GNSS コンパスからの船首方位。許容値を超える横方向の流れ(誤警報)。min_speed_kn 未満の速力
speed-log 対地速力を対水速力に対して変化させるドラッグオフ GNSS から導かれたログ。許容値を超える海流(誤警報)。許容値より遅いドラッグオフ
sea-level 海面と明示したアンテナ高から求められる位置にない高度 高度をもっともらしく保つスプーファー。単独測位の垂直誤差は大きいため、許容値は広くなっています。ジオイド分離は記録されますが、エンジンにジオイドモデルがないため、検査はされません
cn0-spread, cn0-rise 一つの送信機の特徴:キャリブレーションのベースラインに対し、衛星全体の C/N0 がそろって崩れる、またはそろって上がること 衛星ごとに電力を整形するスプーファー。ベースライン自体がスプーフィングされている間のあらゆること。追従するには遅すぎる GSV の周期
time-consistency 受信機の時刻が不規則に進む、または逆行すること。このコンピューターのクロックに対しては、受信機の時刻がそこからずれていくこと(リアルタイムのストリームのみ) 整合し、安定した偽造された時刻。最初から誤っているクロック
osnma 報告された OSNMA の認証失敗 ステータスは読み取るだけで、検証はしません。報告を抑制するスプーファーは検出されません
cn0-drop, loss-of-lock, agc, jam-ind 電力の遮断と衛星の喪失(静止の場合と同じ) 環境が敵対的であることは示しますが、測位解が誤りであることは示しません

NMEA のみのモニターにできないこと。自己無矛盾な位置、速度、針路(船首方位と整合するもの)、もっともらしい衛星ごとの電力、一致する時計で、星座全体を再現するスプーファーは、上のどのチェックにも見えません:センテンスの中に、その測位解を実際のものと区別するものはありません。記録された実際の信号のリプレイも同様です。このギャップを埋めるのは、認証(OSNMA、または独自のスプーフィング対策を持つ受信機)と独立した航法センサーです。この層は、それらが報告するステータスを使うことしかできません。ベースラインが形成される間にすでにスプーフィングを受けているストリームには、クリーンなベースラインがありません。警報がないことは、測位解が良好であることの証拠ではありません。

信頼スコア#

キャリブレーション後の各エポックは、0 から 100 のスコアと、100 でない理由を得ます:どのチェックが減点したか、しきい値に対するその統計量、そしてそのポイントです。帯域(境界値はセッションで明示):90 以上が nominal、55 以上が degraded、それ未満が untrusted。対応付け、すべての重みとその理由は RECEIVER-TRUST.md にあります。これは決定論的で、ログが採点される前に固定されており、学習はなく、イベントに合わせて当てはめたものは何もありません。

船のすべての出力には、助言の記載が付きます:結果 JSON と各ライブ行の advisory キー、CSV の最初の # コメント行(リーダーはコメントオプションで読み飛ばします)、SVG の <desc> とフッター。バッチ実行の出力:session.result.json(スコアモデルとすべてのエポックの減点を含む)、session.trust.csv(score と score_reasons の列を含む)、そして session.trust.svg で、船の場合は、受信機が報告した航跡を信頼度の帯域で色分けし、その上にスコアの時間変化を示すものです。

合成デモ#

examples/maritime-trust/ には、タリン発ヘルシンキ行きのフェリーの作成した NMEA ログがあります(50 分の抜粋、約 17 kn、1 Hz:GGA、RMC、VTG、ジャイロの船首方位、速力ログ、もっともらしい空を持つ GSV)。このログでは、1500 s から、位置のドラッグオフが報告された位置を船の実際の位置から引き離します。受信機は最後まで有効な測位解を報告し続けます。下がるのは信頼スコアで、degraded の帯域を通って untrusted の帯域に入ります。session.toml は、実行前に、すべてのしきい値、船の限界値、すべてのスコアの重みを明示します。

kshana receiver-trust examples/maritime-trust/session.toml
kshana receiver-trust live examples/maritime-trust/session.toml \
  --file examples/maritime-trust/tallinn-helsinki.nmea --gate --json trust.jsonl > gated.nmea

このログは、cargo run --example gen_maritime_trust_demo がファイルに書き出したテキストです:無線信号はモデル化せず、何も送信しません。測定値ではなく、航路は例示用であり、海図ではありません。tests/receiver_trust_maritime_demo.rs は、合成データに対する回帰ガードとして、ログと期待される出力を固定します。実際の干渉に対してどのモニターがどう動作するかについては、何も述べません。

一つの合成の航行にわたる信頼スコア。エンジン v0.41.0 の examples/maritime-trust(タリン発ヘルシンキ行きのフェリーの作成した NMEA ログ、1 Hz で 3001 エポック)での実際の実行によるもの。三つのレーンが一つの時間軸を共有します。上段:受信機が報告する位置と船の実際の位置との距離で、ログの台本どおりの位置のドラッグオフがこれを引き離す 1576 s 頃まで数メートル以内にとどまり、その間も受信機は有効な測位解を報告し続けます。中段:0 から 100 の信頼スコアで、最初の 300 s のキャリブレーション中は計算されず、ドラッグオフまでは nominal の帯域(90 以上)にあり、その後 degraded の帯域(55 以上)を通って untrusted の帯域に下がります。下段:各エポックの帯域を、名前付きの色付きリボンで示したもの。スコアは助言です。助言用ソフトウェアであり、型式承認を受けた航法装置(IEC 61108、IEC 61162)ではありません。船舶の航行の責任は引き続き運用者にあります。このログは、形式とモニターを示すために作成したもので、測定値ではなく、いかなる受信機がどのように動作するかについても何も述べません。一つの合成の航行にわたる信頼スコア。エンジン v0.41.0 の examples/maritime-trust(タリン発ヘルシンキ行きのフェリーの作成した NMEA ログ、1 Hz で 3001 エポック)での実際の実行によるもの。三つのレーンが一つの時間軸を共有します。上段:受信機が報告する位置と船の実際の位置との距離で、ログの台本どおりの位置のドラッグオフがこれを引き離す 1576 s 頃まで数メートル以内にとどまり、その間も受信機は有効な測位解を報告し続けます。中段:0 から 100 の信頼スコアで、最初の 300 s のキャリブレーション中は計算されず、ドラッグオフまでは nominal の帯域(90 以上)にあり、その後 degraded の帯域(55 以上)を通って untrusted の帯域に下がります。下段:各エポックの帯域を、名前付きの色付きリボンで示したもの。スコアは助言です。助言用ソフトウェアであり、型式承認を受けた航法装置(IEC 61108、IEC 61162)ではありません。船舶の航行の責任は引き続き運用者にあります。このログは、形式とモニターを示すために作成したもので、測定値ではなく、いかなる受信機がどのように動作するかについても何も述べません。

この図は、このデモの実際の実行(kshana receiver-trust examples/maritime-trust/session.toml)から tools/gen_readme_assets.py が描画したものです。スコアは助言であり、ログは作成したものです。

Studio のビュー仕様#

船の実行の Studio ビューを作る方へ。このセクションの内容は、まだ Studio には実装されていません。エンジン側(下記のデータ)は実装済みです。

入力。次のいずれか:

  • バッチ実行の結果 JSON(kshana receiver-trust <session.toml>、または WebAssembly パッケージでログをインラインにして receiver_trust(toml) 経由で同じもの):score_model(帯域の境界値、ランプ、証拠の保持、すべての重み)、monitors_run、states、そして epochs[](それぞれに t_s、state、alarms、score.{score,band,deductions[]}、marine.{position:[lat,lon], stats, ratios}、0.36 以降は geometry と各減点の class が含まれ、最上位に geometry_model と geometry_summary があります)。または
  • 上記のスキーマによるライブ JSON ライン。ストリームの進行に合わせて追記され、一エポックにつき一つのオブジェクトです。各行には、受信機が報告したposition(スキーマ 1.1)が含まれます。

デモ用のセットはexamples/maritime-trust/です。session.toml、tallinn-helsinki.nmea(ログ)、tallinn-helsinki.truth.csv(t_s,true_lat_deg,true_lon_deg:船が実際にいた位置で、実際のログにはありません)で構成されます。ビューはセッションを実行し、あわせて真値ファイルを読み込む必要があります。

描画する内容。

  1. 航跡:北を上にし、両軸を同一スケールとします。受信機が報告した位置を、そのエポックのバンドで色分けした線(グレーはキャリブレーション中、緑は nominal、琥珀色は degraded、赤は untrusted)で示し、開始点と終了点、スケールバーを表示します。デモでは、真の航跡をその下に細い中立色の線で重ね、引き離し(ドラッグオフ)が二本の線の乖離として見えるようにします。真の航跡の切り替えと、カーソル位置の時刻におけるメートル単位のオフセット表示も備えます。
  2. スコアのタイムライン:スコアを 0 から 100 の範囲で時間に対して示し、バンドの境界(score_modelのnominal_min、degraded_min)を破線で、バンドを下に帯として表示し、明示されたイベントの発生を目印で示します。時間軸は航跡と共有します。
  3. 理由:カーソル位置のエポックについて、減点(モニター、しきい値に対する比、点数)を、大きい順に横棒で示します。各モニターの重みはscore_model.weightsから取得して併記します。実行されて減点がなかったモニターは薄く表示し、実行されなかったモニター(monitors_runにないもの)は「未実行」と表示して、問題なしとして表示することはありません。geometryモニターにはscore_model.weightsのエントリがなく、その上限はgeometry_model.cap_in_forceです。
  4. モニターのストリップ:monitors_run内のモニターごとに、時間経過に伴う比(警報は 1)を細い帯で示し、どのチェックが最初に動いたかを読み取れるようにします。
  5. ゲートの状態:ライブビューでは、各エポックのgate(off、passed、withheld)をバンドの帯の下に帯として表示し、最新の$PKSHTも示します。バッチビューでは、ゲートが保留したであろうエポックは、リリース保持を適用したうえで、バンドが untrusted のエポックです。
  6. ジオメトリのレーン(0.36):バンドの帯の下に、geometry.statusで色分けした帯を置きます(緑は良好、琥珀色は degraded、グレーの斜線は不明)。色の系統は、不整合のレーンや環境のレーンとは区別します。凡例は「ジオメトリ:信号ではなく、空の状態」とします。理由パネルとモニターのストリップでは、減点をclass(ジオメトリ、環境、不整合)で色分けし、geometry_summaryによるクラスごとのエポック数をバンドの数の横に示します。カーソル位置のエポックについては、geometry.note、n_used、HDOP、PDOP、VDOP、source、age_sを示し、reported_derived_mismatchが設定されている場合はフラグを示します(その場合、ジオメトリの減点は不整合です)。unknownは、「ジオメトリ不明:ログに GSV も GSA もありません」と表示し、良好として示すことはありません。[geometry]のしきい値と、geometry_modelから得たその出所は、スコア設定の横に置きます。助言の注記は残します。
  7. 受信機が報告した測位解:デモの受信機は、全期間にわたって有効な測位解を報告します(GGA の品質 1、RMC のステータス A)。これがこのビューの要点なので、凡例にその旨を記します。

操作。すべてのパネルで共有する一つの時間カーソル(ドラッグ、矢印キー、1x から 60x で再生する再生ボタン)があり、航跡またはいずれかの帯の上にカーソルを置くと、それが動きます。減点をクリックすると、そのモニターが発生点を上回っていたエポックが強調表示されます。バンドのフィルター(degraded と untrusted のエポックだけを表示)、最初の減点と最初の untrusted エポックへのジャンプも備えます。各モニター名には、このページにある一行の説明をホバーテキストで表示します。セッションのしきい値と重みは、グラフの横に読み取り専用で表示し、スコアに使われた内容が画面上で分かるようにします。

守るべき文言。ページには、助言用ソフトウェアであり型式承認を受けた航法装置ではないこと、デモは作り物のドラッグオフを含む合成テキストであること、アラームのない測位解がそれだけで良い測位解であることにはならないこと(上記の限界を参照)を明記しなければなりません。ページ上のいかなる数値も、実際の干渉に対してチェックがどの程度機能するかの指標として読めるものであってはなりません。

コードから#

セッションとバイト列をメモリ上に保持する呼び出し元(ファイル、クロック、ソケットを使わず、WebAssembly でも安全)向けに、kshana::receiver_trust::assessには次の関数があります。

  • assess_vessel_log(session_toml, log_bytes) -> Result<ReceiverTrustResult, String>:ログ全体を、バッチ実行として採点します。kshana receiver-trust <session.toml>と同じ結果で、結果 JSON(score_model、monitors_run、スコアと減点を含むepochs[])にシリアライズされます。
  • assess_stream_excerpt(session_toml, excerpt_bytes) -> Result<ExcerptAssessment, String>:ストリームの一部(最大 2 MiB と 20,000 エポックまで、かつキャリブレーションウィンドウを含められる長さ)を、ライブモードと同じ方法で採点し、ライブ JSON ラインのスキーマで返します(epochs[]、最後の$PKSHT、バンドごとの数・最低スコアと最終スコア・最初の untrusted の時刻の要約)。受信機の時刻をホストのクロックと比較することはありません。長時間動作するライブモード(ソケット、追記中のファイル、ゲート)は、バイナリの担当です。

どちらも[platform] kind = "vessel"を持つセッションが必要です。その[log]テーブルは省略できます。

ライブで実行する#

# stdin: a serial port read by another tool, or a multiplexer's output
some-nmea-source | kshana receiver-trust live session.toml

# a log file that is being appended to (it starts at the beginning; --from-end skips what is there)
kshana receiver-trust live session.toml --file /var/log/nmea.log --follow

# a TCP server (a multiplexer or a terminal server) or UDP datagrams (a bridge network)
kshana receiver-trust live session.toml --tcp 192.0.2.10:10110
kshana receiver-trust live session.toml --udp 10110

An NMEA 2000 network is read through a SocketCAN interface: kshana sensor-live --kind n2k turns the position, course and speed, heading and system-time groups into NMEA 0183 sentences (see MACHINE-INPUTS.md), which this command reads as it reads any other:

candump -L can0 | kshana sensor-live --kind n2k --from - | kshana receiver-trust live session.toml

セッションはバッチ実行と同じsession.tomlで、kind = "vessel"を宣言する[platform]テーブルを持ちます。[log]テーブルは不要です。シリアルポートはまだ直接開きません。すでにお使いのツール(sttyとcat、ターミナルサーバー、マルチプレクサー)でポートを読み取り、パイプまたは転送してください。シリアルの直接入力は、今後対応する可能性があります。

完了した各エポックは、標準出力に JSON を一行書き出します。

{"seq":941,"t_s":940.0,"time":"2025-06-14T08:15:40.000Z","state":"degraded","score":60.0,
 "deductions":[{"monitor":"heading-course","ratio":1.5,"points":40.0}],
 "alarms":["heading-course"],"gate":"off","note":null,
 "position":{"lat_deg":59.8123456,"lon_deg":24.9012345,"height_m":39.4}}

stateは、calibrating、nominal、degraded、untrustedのいずれかです(スコアのバンドで、境界はセッションの[score]テーブルで指定します)。scoreはキャリブレーション中は含まれません。deductionsは、どのチェックが何点を減点したかを、大きい順に列挙します。

JSON ラインのスキーマ(バージョン 1.1)#

完了したエポックごとに JSON オブジェクトを一つ。キーはこの順序です。

キー 型 意味
seq 整数 報告されたエポックの数。1 から始まります
t_s 数値 ストリームの最初のエポックからの経過秒数
time 文字列または null ストリームが示すエポックの時刻(RMC を受信した後は日付つきの ISO-8601 UTC、それ以前はhh:mm:ss.mmm UTC (date not in log))
state 文字列 calibrating、nominal、degraded、または untrusted
score 数値または null 0 から 100、小数第一位まで。キャリブレーション中、またはnoteがスコアを出せなかった理由を示している場合は null
deductions 配列 {"monitor": string, "ratio": number, "points": number, "class": string}。点数の大きい順。ratioは統計量のしきい値に対する比(1 以上で警報)。減点したモニターだけを列挙します。class (1.3 で追加)は、geometry、environment、inconsistencyのいずれかです
alarms 文字列の配列 しきい値に達している、または超えているモニター
gate 文字列 off、passed、withheldのいずれか
note 文字列または null スコアが出なかった理由(例:宣言された方位センサーが存在しない)
position オブジェクトまたは null (1.1 で追加)このエポックで受信機が報告した位置、{"lat_deg", "lon_deg", "height_m"}(高さは、センテンスにジオイド分離が示されている場合は楕円体高、そうでない場合は平均海面上の高さ)。受信機が位置を示さなかった場合(測位解のないキャリブレーションエポックを含む)は null
advisory 文字列 (1.2 で追加)このソフトウェアが何であり、何でないか:助言用であり、型式承認を受けた航法装置ではなく、運用者が引き続き責任を負います
geometry オブジェクト (1.3 で追加)衛星のジオメトリ:status(good、degraded、ストリームに GSV の仰角と方位角も GSA もない場合はunknown)、reasons(few-satellites、high-pdop、high-hdop、sky-blocked)、source(derived、reported、none)、n_used、hdop、pdop、vdop、open_fraction、max_azimuth_gap_deg、age_s、reported_hdop、reported_derived_mismatch、note、in_view、signal_loss(衛星は視界内にあるが追尾されておらず、視界内の DOP は良好な場合:このときジオメトリの減点はenvironmentです)、label(good、fair、poor、unknown:常に報告されますが採点には使われず、スコアが減点するのはpoorの場合だけです)(RECEIVER-TRUST.mdを参照)

モニター名(ケバブケース、17 個):cn0-drop、agc、jam-ind、loss-of-lock、position-jump、raim、clock、solve-failure、kinematic、heading-course、speed-log、sea-level、cn0-spread、cn0-rise、time-consistency、osnma、そして 1.3 からgeometry。新しい名前は今後のバージョンで追加される可能性があります。利用側は、未知のモニター名もモニターとして扱ってください。後述の$PKSHTのレイアウトは、先頭のフィールドにフォーマットバージョンを持ちます。この JSON スキーマはバージョン 1.3 です。1.1 でposition、1.2 でadvisory、1.3 で末尾にgeometryと各減点にclassが追加されており、変更は末尾へのキーの追加に限られます。

認証入力#

osnmaモニターは、衛星ごとの認証ステータスを、MarineObs::sat_auth((satellite, status)のリストで、ステータスはAuthenticated、Failed、Unavailable)を通じて認証ソースから受け取り、全体のMarineObs::osnmaと並べて扱います。NMEA 側では、同じ内容を$PKSOS,<A|F|N>[,<sat>:<A|F|N>...]で伝えます。例:$PKSOS,A,E11:A,E19:F。全体または一つの衛星での失敗はいずれも、モニターの警報となり、その重み全体を減点します(比は 1.5 とされます)。成功は証拠にはなりません。Kshana はここで何も検証しません。検証を行うソースが、報告するステータスに責任を負います。

次のタイムド・センテンスが到着した時点で、エポックは完了します。それより前に到着した、低速または非同期の機器のセンテンス(受信機より数十分の一秒遅れるジャイロなど)は、そのエポックに属します。ストリームが[live] idle_flush_s(既定は 1.5 秒。受信機のタイムド・センテンスの最長の間隔より大きく設定してください)の間止まった場合、エポックはその時点の内容で完了します。ストリームの最初のcalibration_s秒がベースラインとなり、採点されることはありません。したがって、最初に接続した時点ですでにスプーフィングされているストリームには、クリーンなベースラインがありません。航海の前、または測位解が良好と分かっている間に、このレイヤーを開始してください。キャリブレーションウィンドウは、到着順で一度だけ閉じます。すでに受信した時刻より前の時刻を持つエポック(巻き戻し、ストリーム冒頭の再生)は、時刻が何を示していても、キャリブレーションにはなりません。そのエポックはtime-consistencyの減点を全量で受け、untrusted となります。ライブエンジンは、各エポックをキャリブレーションエポックとストリームの直近一分ほどにわたって採点するため、エポックあたりのコストはcalibration_sとエポックレートの積に応じて増えます。高速な受信機では、ウィンドウを短くしてください。バッファには上限があります(タイムド・センテンスのない行が大量に続いた場合は 5,000 行ごとに完了し、キャリブレーションと履歴は 20,000 エポックで上限となります)。

受信機の時刻は、このコンピューターの単調クロックとも比較されますが、これはリアルタイムで到着するストリームでのみ意味を持ちます。保存済みのログを stdin、TCP、UDP から全速で投入すると、構造上このチェックに引っかかります。その場合は--replayを指定してください(--followなしの--fileは、すでにこれを含意します)。--file ... --followは、末尾まで読み終えるまでは再生として読み込まれ、その後はホストのクロックが有効になります。そのため、溜まっていたデータがクロックの故障として読まれることはありません。ただしこのチェックには、キャリブレーションウィンドウがまだ開いている必要があります(そうでなければベースラインがなく、実行されません)。

ストリームの終了と障害:stdin と、末尾まで読み終えたファイルは、正常に終了します(終了コード 0)。続くべきストリームで、相手側によって TCP 接続が閉じられた場合は、正常な終了ではありません。レイヤーは、受信済みのすべてを採点して書き出したあと、ゼロ以外のコードで終了し、再接続はしません。そのため、再起動するスーパーバイザーの下で実行してください。センテンスを分割した UDP データグラムは結合されます。stdin、ファイル、TCP のリーダーは、送信側に押し戻す上限つきキューに支えられており(失われるものはありません)、押し戻せない UDP では、エンジンが受け付けられないデータグラムを破棄し、その旨を stderr に出力します。--udp <port>はループバックアドレスにバインドします。ほかのアドレスで待ち受けるには--udp <addr>:<port>を指定します(警告が出力されます)。

$PKSHT:独自センテンス#

すべてのエポックは、有効なチェックサムを持つ NMEA 0183 センテンスも一つ生成します。--pksht <path|->はこれをファイルまたは標準出力に書き出し、ゲートは転送されるストリームに挿入します。

$PKSHT,1,080140.25,30.0,U,W,heading-course:40.0/cn0-spread:30.0*2F
フィールド 意味
1 1:フォーマットバージョン
2 エポックの UTC 時刻、hhmmss.ss。ストリームに時刻がない場合は空
3 信頼スコア 0 から 100、小数第一位まで。キャリブレーション中、またはスコアを出せなかった場合は空
4 バンド:C キャリブレーション中、N nominal、D degraded、U untrusted
5 ゲート:- オフ、P 通過、W 保留(転送されるサイクルで測位解が無効とマークされた)
6 最大二つの理由、monitor:pointsを/で連結。減点がなければ空

アドレスは、P+メーカーのニーモニックKSH+Tです。独自センテンスを知らない機器は、これを無視します。Kshana は、入力に含まれる自身の$PKSHTを無視します。

ゲートモード#

--gateは、Kshana を、受信機とその測位解を使う機器(海図システム、航跡制御システム)の間に置きます。NMEA ストリームが入力され、標準出力に出力され、次のように扱われます。

  • エポックが untrusted でない間(およびキャリブレーション中)は変更せずに通過させ、センテンスの各サイクルの後に$PKSHTを付けます。
  • untrusted の間は無効とマークします:GGA の品質は0、RMC のステータスはV(モード指示子NとナビゲーションステータスVがある場合はそれも)、GNS のモードはすべての位置でN、GLL のステータスはVでモードはN、VTG のモードは、あるものについてはNとします。位置のフィールドはそのまま残します。要点は、機器が受信機自身が測位解を無効と宣言しているのを見て、自らアラームを上げることです。書き換えたすべてのセンテンスは、チェックサムを再計算します。

一度保留した測位解は、エポックが untrusted のバンドから[live] gate_release_s(既定は 30 秒)外れた後でなければ解放されません。そのため、バンドの境界付近のスコアで測位解がちらつくことはありません。JSON ラインは、--json <path>が指定した場所にのみ出力されます(既定ではどこにも出力されません。標準出力はストリームが使うためです)。

receiver-nmea-source | kshana receiver-trust live session.toml --gate --json trust.jsonl | downstream-equipment

チャートプロッターを直接接続できるようにするには、ゲートを通したストリームを、標準出力の代わりに TCP で提供します。

receiver-nmea-source | kshana receiver-trust live session.toml --gate --listen tcp:10110

--listen tcp:<port>はループバックアドレスで待ち受けます。tcp:<addr>:<port>はほかのアドレスで待ち受けます(そのアドレスに到達できる人なら誰でもストリームを読めるため、警告が出力されます)。クライアントはいくつでも接続でき、それぞれが接続した時点から同じストリームを受け取ります。クライアントは読み取り専用です。各クライアントには独自の上限つきキューとライターがあり、追いつけないクライアントは切り離され(接続が閉じられ、stderr に一行出力されます)、ほかのクライアントや入力を遅らせることはありません。--listenには--gateが必要です。その場合、標準出力にはストリームが何も出ないため、--json -が使えます。

ゲートが行わないこと、および使用前に知っておくべきこと:

  • ゲートはオプトインです。--gateを指定しない限り、測位解が無効とマークされることはありません。
  • ゲートは遅延を加えます。サイクルは、そのエポックが採点されるまで保持されます。これは次のタイムド・センテンスまでの時間(おおよそ一サイクル分で、1 Hz の受信機なら一秒)、またはストリームが止まった場合は最後のセンテンスからidle_flush_s後です。受信機の出力から数十ミリ秒以内にセンテンスを必要とする機器は、ゲートの後ろに置いてはなりません。
  • ゲートはチェーン上の単一点です。止まれば、ストリームも止まります。スーパーバイザーの下で実行し、ストリームがない場合に下流の機器がどう動作するかを、あらかじめ決めておいてください。
  • ゲートは自身の障害に対してフェイルクローズします。キャリブレーション後にモニターがスコアを出せない場合(宣言された方位センサーが何も送らない、キャリブレーションエポックが少なすぎるなど)、そのエポックは untrusted となり、noteが付き、保留されます。リリース保持は、スプーファーが操作できる受信機の時刻ではなく、このコンピューターのクロックで計時されます(リプレイの場合は、受信機の時刻しかありません)。
  • ゲートは、スプーフィングされた測位解を通してしまうこと(見逃し)があるだけでなく、良好な測位解を保留すること(誤警報)もあります。モニターは、船の物理的挙動やほかのセンサーと照らして測位解を検査します。そのすべてと矛盾しない偽の信号は、検出されません(後述の限界を参照)。
  • ゲートが想定するのは、純粋な NMEA 0183 テキストストリームです。ストリームに混在するバイナリフレームは変更せずに転送されますが、その場合、$PKSHTがフレームのバイトの途中に入り込むことがあります。
  • ゲートは型式承認を受けておらず、その内容のいずれも、IEC 61108 や IEC 61162 に照らして評価されていません。船舶の航行の責任は、引き続き運用者にあります。