機能詳細

TCP / UDP 通信とセッション

CommSim の基本単位は「1 ポート＝1 セッション」。サーバにもクライアントにもなり、手動送信と色分けログで通信を確認できます。

サーバにもクライアントにもなる

手動送信（テキスト / HEX バイトエディタ）

画面下部の送信バーから任意のデータを 1 回送信。HEX をオンにすると専用バイトエディタに切り替わり、2 桁ごとに自動でバイト区切り・ASCII プレビュー・バイト数表示が出ます。Wireshark やログの HEX ダンプ（01 02 / 0102 / 0x01,0x02 など）をそのまま貼り付けても自動整形されます。

色分けされた通信ログ

送受信・システム・エラーをリアルタイム表示。種別で色分けし、最新行に自動追従、最大 1000 件保持。構造体パース表示をオンにすると、受信バイトをフィールド単位に分解して表示します。

RX 受信 TX 送信 SYS ERR PROXY

オートメーション

「トリガー × 送信データ × 繰り返し」を 1 つにまとめた自動送信の仕組み。自動応答・接続あいさつ・定期送信・多段シーケンスを、すべて同じ画面で作れます。

何をきっかけに送るか — 4 つのトリガー

「パケット一致」の判定方式： ExactContainsStartsWithRegexHexPattern

何を送るか — 送信ステップ

繰り返しは「なし / 回数指定 / 無限」、間隔は最小 50ms（送信ストーム防止）。複数オートメーションは独立した受信キューで並列実行できます。

テンプレート変数で動的に組み立てる

送信データに {..} を埋め込むと送信時に実値へ展開。長さや CRC を手計算する必要はありません。

具体例（タブで切り替え）

トリガー : パケット一致 / Contains / "PING" (Utf8)
ステップ : Send  "PONG\r\n"

トリガー : 周期 1000ms / 繰り返し 無限
ステップ : Send  "STATUS\r\n"

トリガー : パケット一致 / HexPattern / "AA 01" (RawHex)
ステップ : Send  "BB {echo:2:2} {len:1} {crc:Xor8}"

  {echo:2:2} … 受信の 2 バイト目から 2 バイト (XX YY) を埋め込む
  {len:1}    … 直前まで (BB XX YY) の長さ 3 を 1 バイトで
  {crc:Xor8} … 直前までの XOR チェックサムを付加

メッセージ構造定義

独自バイナリの構造をフィールド単位で定義しておくと、受信ログを項目ごとに分解表示でき、フィールド値での応答出し分け（次節）も可能になります。

フレームをフィールドに分解する

たとえば同梱の設備ライン制御サンプル（LCP）は、次のようなフレーム構造です。定義しておくと受信ログが各フィールドに色分け分解されます。

型・役割・フレーミング

型は u8〜u64 / 符号付き i8〜i64 / 浮動小数 f32・f64 / ascii / hex / bcd / array / nested。役割に Length / Checksum / Discriminator（判別）を割り当て、可変長は「長さ元」フィールドを参照します。TCP の区切り方（フレーミング）は次から選びます。

判別フィールドとプレビュー

コマンドごとに構造が違うプロトコルでも、判別フィールドでコマンド値に応じた定義を選んで分解できます。編集ウィンドウにサンプル HEX を入れて「パース」を押せば、その場で分解結果を検証可能。構造体定義は .commsim-struct ファイルで他プロジェクトと共有できます。

バイナリ構造応答

構造体定義に基づき、フィールドの値で応答を出し分ける機能。コマンド種別やアドレスごとに異なるバイナリ応答を返せます。

フィールド条件（AND）＋ 応答テンプレート

条件は「フィールド名・演算子（= ≠ > < ≥ ≤）・値」で指定し、すべて満たすとマッチ。応答は {field:NAME} / {len:N} / {crc:KIND} / {echo:OFF:LEN} で組み立てます。優先度の小さい順に評価し、最初にマッチしたルールが先勝ち。どれにもマッチしなければ無応答です。

ルール1 (優先10)  FunctionCode = 0x03  → FC03 応答テンプレート
ルール2 (優先20)  FunctionCode = 0x04  → FC04 応答テンプレート

条件 : Address ≥ 0  かつ  Address ≤ 255   (≥ と ≤ を AND)
応答 : B0 {echo:1:2} 01 {crc:Xor8}

中継とキャプチャ

セッションに転送先（上流＝実機）を設定すると、アプリと実機の間に入り、通信を記録しながら中継します。実機でしか起きない不具合の調査・再現に。

受信パケットの処理順序

1. オートメーション（パケット一致）を評価

   マッチすれば CommSim が応答し、実機へは転送しない。フック＝差し替え

2. バイナリ構造応答を評価

   マッチすれば CommSim が応答（実機へ転送しない）。

3. いずれもマッチなし → 実機へ転送

   そのまま上流へ流し、往復をキャプチャに記録。素通し

フック（狙った 1% だけ差し替える）

中継中もルールが有効です。マッチした受信だけ実機へ通さず CommSim が応答を返します（＝フォールト/値の注入）。キャプチャの「注入」列で区別できます。実機 99% ＋狙った 1% だけ偽装が、ルールを 1 つ足すだけで実現します。

キャプチャした通信は、転送先なしの別セッションでオートメーション・バイナリ構造応答として組み直せば、実機なしで同じ通信パターンを再現できます。

スクリプト応答

テンプレートだけでは表しにくい計算・分岐・状態保持が必要なとき、オートメーションの Script ステップで C# を書いて応答バイト列を動的生成できます。

同梱の modbus-tcp-script.commsim（ポート 503）は、FC03 の要求 Quantity に応じて動的長の応答を返すスクリプト応答の実例です。

複数セッション・プロジェクト

複数のポートを同時に扱い、まとめて 1 ファイルで保存・復元できます。