﻿===============================================================
  TCode Device Checker  v1.0.0  (無料配布)
  - TCode Bridge 購入前動作確認ツール -
===============================================================

このツールは、お手持ちの電動機器が
  「TCode Bridge for Ikunogaman」
で動作するかを、購入前に確認するための単体テストツールです。

TCode Bridge 本体は有償版ですが、本ツールは無料で配布しています。
購入前に必ず本ツールで動作確認をお願いいたします。


----------------------------------------------------------------
  使い方
----------------------------------------------------------------
【1】機器を USB で PC に接続する

    ドライバが必要な機器の場合、あらかじめインストールを
    完了させてください (Arduino CH340 / CP210x / FTDI 等)。

【2】機器の COM ポート番号を確認する

    ▼ 設定ツール内のドロップダウンが一番早いです
      本ツール起動後、「COMポート」欄の ▼ をクリックすると
      現在 PC に接続されている COM ポートの一覧が出ます。
      候補が 1 つしかなければそれが機器です。

    ▼ 複数ある場合はデバイスマネージャーで特定
      1. スタート右クリック → デバイスマネージャー
         (または Windowsキー + X → M)
      2. 「ポート (COM と LPT)」を展開
      3. 以下のような項目の括弧内が COM 番号:
           - USB Serial Device (COM3)
           - Arduino Uno (COM5)
           - USB-SERIAL CH340 (COM7)
           - Silicon Labs CP210x USB to UART Bridge (COM8)
      4. 特定が難しい場合: USB を一度抜いて「消える項目」と
         再度差して「現れる項目」が機器です。

【3】「動作確認ツール.exe」を起動する

    - COM ポート  : 【2】で確認したもの
    - Baudrate   : 通常 115200
    - テスト軸   : 通常 L0 (上下ストローク)

【4】「テスト実行」ボタンを押す

    機器が 8 パターンの動作を順次実行します:
      1. 中央へ移動
      2. 下端付近 (0.10)
      3. 上端付近 (0.90)
      4. ゆっくり下 (0.25)
      5. ゆっくり上 (0.80)
      6. 素早く下 (0.15)
      7. 素早く上 (0.85)
      8. 中央へ戻す

    各動作の間隔はログに表示されます。実機の動作と
    ログのタイミングが一致していれば正常です。

【5】動作結果のダイアログが出る

    「はい」 → 互換性確認完了。TCode Bridge で動作します。
    「いいえ」→ 設定見直しの案内が出ます。
    「キャンセル」→ 設定を変更して再テスト可能。


----------------------------------------------------------------
  この結果で何がわかるか
----------------------------------------------------------------
本ツールで 8 パターンが期待通り動けば:
  ✅ お使いの機器は TCode v0.3 プロトコルに対応しており、
     USBシリアル経由で外部からコマンド制御が可能
  ✅ 有償版「TCode Bridge」を導入すれば、Ikunogaman 本体と
     お使いの機器を接続してゲームプレイに同期動作させられる

逆に動かなければ:
  ⚠ TCode 非対応の機器の可能性
  ⚠ TCode ファームウェアのバージョンが古い / 独自改変版の可能性
  ⚠ シリアル通信設定 (Baudrate 等) が特殊な可能性
  → 購入はお控えいただくことを推奨します


----------------------------------------------------------------
  トラブルシューティング
----------------------------------------------------------------
Q. 「COMポートを開けませんでした」と出る
A. 以下を順に確認:
     - 他のアプリ (MultiFunPlayer, funscript_gen 等) が COM を
       掴んでいないか。開いていれば閉じてください。
     - COMポート番号が正しいか
     - USBケーブルの接続が緩んでいないか

Q. ツール実行中だが機器が動かない
A. 以下を順に試してください:
     - Baudrate を 19200 や 9600 に変更 (古い TCode ファーム)
     - テスト軸を R0 に変更 (ローテーション機構のみの機器)
     - 機器の電源が入っているか
     - 機器のキャリブレーションが完了しているか

Q. 一部のパターンだけ動く
A. TCode の一部命令に対応しているが、Interval 指定
   (Iサフィックス) に未対応の可能性があります。
   本製品 (TCode Bridge) は Interval を多用するため、
   全パターンが動かない場合は非互換と判定されます。


----------------------------------------------------------------
  注意事項
----------------------------------------------------------------
- 本ツールはテスト動作中、機器を位置 0.10 〜 0.90 の範囲で
  動かします。機器のキャリブレーション範囲を超えている場合は
  先に機器側でキャリブレーションを済ませてください。
- 本ツールでの動作確認結果は TCode Bridge の動作を確約する
  ものではありません (ファームウェアの個体差や未知の条件で
  動作が変わる可能性があります)。ただし本ツールで全パターン
  動作すれば、ほぼ確実に TCode Bridge でも動作します。
- 本ツールの使用によって機器に生じた損害について、作者は
  一切の責任を負いません。


----------------------------------------------------------------
  TCode Bridge (本製品) について
----------------------------------------------------------------
本ツールで動作確認ができたら、有償版「TCode Bridge」を
ご検討ください。

 - 製品名   : TCode Bridge for Ikunogaman
 - 価格     : [販売ページ参照]
 - 動作保証 : SR1 2.0
 - 対応    : Ikunogaman Desktop版 / VR版