監視とトラブルシューティング

推測ではなく証拠を使う

まず鉄道を安全にします。正確な時刻と最後に成功した操作を記録し、アドレス、ルート、形状を変える前に関連モニターを確認します。変更は1度に1つだけ行い、同じテストを繰り返します。複数オブジェクトを無作為に変えると原因を隠し、新しい不整合を作ります。拒否画面、状態ツールチップ、ログは停止理由を示すためのものなので、作り直す前に読んでください。

どの層が誤っているか特定する

プロジェクトモデル

線路、コネクター、ブロック、フィードバック所属、アクセサリ、ルート、列車配置、設定です。プロジェクト統計とプレビューが主に検証します。

RailKernelランタイム

ライブ在線、アクセサリ状態、予約、待機・一時停止運転、停車セッション、計算ルートです。各モニターが表示します。

コマンドステーション

RailKernelが送信するメッセージと受信イベントです。CS概要、接続状態、プロトコルログで確認します。

実物鉄道

実際の分岐位置、検出器配線、車両、電源、脱線、機械故障です。直接観察だけが確認できます。

プロジェクト統計から始める

自動運転試験前に「表示」>「プロジェクト統計」を開きます。緑または赤の準備状況と、線路、接続、運転定義の概要を表示します。赤は切替可能線路にアクセサリ定義が不足するなど、自動運転を妨げる問題を示します。経路に参加するすべての分岐器、曲線分岐器、交差、ダブルスリップ、3方向分岐器に定義が必要です。内部GUIDではなくカタログ名、分かりやすい種類、キャンバス位置で特定します。

概要

線路オブジェクト数、模型・実物換算線路長、接続区間、未接続コネクター、アクセサリ、フィードバック、ブロック、機関車、列車を表示します。技術的なグラフノード・エッジ数も補助情報として残ります。

自動運転

必要なアクセサリ設備が完全か明示します。対応が必要なら各切替線路の種類とx/y位置を示し、キャンバスで探せます。

レイアウト問題

未接続コネクターと最大接続部分の外にある線路を一覧にします。可能なら名前、コネクター番号、位置を使用します。ブロック生成や経路探索前に修正してください。

フィードバック整合性

どのブロックにも属さないもの、複数ブロック所属、物理アドレス重複を検出し、運転名と完全アドレスで表示します。

信頼性

不安定と記録したフィードバックとアクセサリを、名前、アドレス、種類、プロトコルで一覧化します。保守リストであり、反復故障を無視する指示ではありません。

GUIDは、利用者向けオブジェクトへ解決できない破損・孤立プロジェクト項目の内部参照としてだけ表示されます。修正後に統計を開き直し、準備バナーと詳細タブを確認してください。構造変更後は保存ルートも点検します。

フィードバックモニター：どこが在線か

プロジェクトとCSが認識するライブ接点を表示します。アドレス、バス、モジュール割当を確認し、検出器を1つずつ操作してFREE/OCCUPIED変化を観察します。CSでは動くがRailKernelでは動かない場合、最後の接点番号だけでなく完全ID、バス長、選択CSを比較します。予期しない変化は証拠です。配線と極性を理解せず単に反転しないでください。

アクセサリモニター：プロジェクトとCSを比較

レイアウトアクセサリと対応CSからインポートした機器を重ね、レイアウトのみ、一致、CSのみ、競合を区別します。アドレスなしアクセサリはライブ比較に無関係です。競合をダブルクリックすると理由が出ます。分岐器が動かなければCS、プロトコル、アドレス、ポート半分、複数アドレス定義、現在・既定状態、物理デコーダーを確認します。ログに正しい指令があり物理動作がなければ、経路ではなくCS、デコーダー、配線、機構を疑います。

列車モニター：なぜ列車が待っているか

待機、走行、駅停車、一時停止、予約中の全運転を表示します。「解放」や「中止」前に状態ツールチップ、目的地、予約ブロックを読みます。PAUSEDは安全なコリドー待ちであることが多く、設備解放後に自動再開できます。開始、サイクル停止、中止、緊急停止は結果が異なります。専用ページを参照してください。

運転ログ：判断を再構成する

ルート選択、コリドー予約、アクセサリ要件、機関車指令、フィードバック変化、制動、停車、継続、一時停止、解放、警報の順序を記録します。症状の正確な時刻周辺を探し、1つの列車名を追います。「何が失敗したか」だけでなく「RailKernelが最後に証明できた安全条件は何か」を問います。再起動前に関連部分をコピーしてください。

コマンドステーションのプロトコルログ

対応CS3、ECoS、Z21接続の制限付きライブログを提供します。時刻、読みやすいニーモニック、生フレームまたはメッセージを表示し、消去、コピー、閉じる操作があります。「RailKernelは期待した指令を送ったか」「CSは期待した応答・イベントを返したか」を分けて判断します。送信なしはアプリ状態・設定、正しい送信に応答なしは接続・プロトコル、正しい通信に物理動作なしはハードウェアを示唆します。短い再現直前に消去してください。

コマンドステーションが接続しない場合

• 接続設定で有効になり、種類、表示名、ホスト、ポートが正しいか確認する。
• 起動進行表示から、設定読込み、接続、CSデータ取得、初期状態読込みのどこが遅いか確認する。
• 対応する場合はネットワークスキャンを使い、検出機器が操作対象CSか確認する。
• コンピューターとCSが到達可能なネットワークにあり、他アプリがインターフェースを占有していないか確認する。
• プロトコルログを開いて小さな操作を1回行う。通信なしと拒否通信は別の障害である。
• 起動・タイムアウト切分け時は無関係なCSを一時無効化する。

よくある症状と最初の確認

列車を配置できない

無効項目の説明を開き、出口フィードバック在線、一意なブロック所属、予約、未配置シンプルトレインを確認します。

列車を移動できない

理由画面を使い、整合性、出発速度、CSのGO、列車・機関車ID、次ブロック在線、不足アクセサリ保護を確認します。

列車が一時停止のまま

列車モニターの理由と予約コリドーを読みます。まず妨害列車を待ち、この列車自身の予約が古いと分かる場合だけ解放します。

分岐器が画面上だけ動く

アクセサリモニターと送信ログを比較し、デコーダーアドレス、ポート、電源、機構を確認します。

分岐器が物理的にだけ動く

返却イベントを探し、プロジェクトと同じCS、プロトコル、アドレスへ対応するか確認します。

変更後は正しいが起動時だけフィードバックが誤る

初期通信と完全なバス/モジュール/接点IDを確認します。後のライブ変化成功は起動時検出・同期の正しさを証明しません。

緊急停止が繰り返される

報告フィードバックと時刻から、予期しない車両、接点チャタリングや極性、誤ブロック所属、アクション規則、実物と配置位置の差を確認します。

ルートプレビューに設備がない

保存ルートと計算アクセサリ区間を確認します。プレビューは実際のルート内容を描くため、オレンジ設備の欠落は通常描画問題ではなくルートデータ不足です。

有用な問題報告を準備する

RailKernel版、OS、CS種類とソフトウェア版、正確な現地時刻、最小再現手順、期待・実結果、関連モニター画像、運転ログまたはプロトコルログを含めます。形状・経路問題ならプロジェクトをエクスポートまたは非公開アップロードします。再起動後も起きるか、1台のCSだけでも起きるかを記載し、ライセンス、パスワード、秘密鍵、無関係な個人情報は公開しないでください。

既知の正常点を保存する

構造編集や経路実験前にソース変更をコミットし、日付付きプロジェクトバックアップを保管します。退行が出たら1度再現して証拠を保存し、最後の正常状態と比較します。孤立した1変更を戻す方が、推測修正の連鎖を直すより安全です。監視は後付けではなく、複雑な物理・デジタル系を保守可能にする基盤です。