ComPortScanner　取扱説明書

1. このソフトについて

USB シリアル機器（M5Stack・Arduino・FTDI 変換ケーブルなど）を複数台つないでいると、「COM12 は結局どの機器だったか」がすぐ分からなくなります。本ソフトは Windows のレジストリと WMI から各 COM ポートの VID/PID（機器の種別を表す番号）を読み取り、どの COM 番号がどの機種かを自動判別して一覧表示します。

実際の操作画面

1-1. 似たツールとの使い分け

2. 入手方法

本ソフトは「LightJockey 道具一式 一発インストール手順」でまとめて配布されるツール群の 1 つです。単体配布は行っていません。

2-1. 機種名のカスタム設定

device_mapping.json（インストール先フォルダ内）で機種名の表示をカスタマイズできます。詳細は 5 章を参照してください。

3. 初回起動時の確認

4. 画面の見方

ウィンドウは小さめ（既定 320×400 px、最小 250×300 px）で、他の作業の邪魔にならないよう常に手前に置いておける大きさです。ダークテーマの一覧画面 1 枚だけのシンプルな構成です。

列の幅・ウィンドウの位置とサイズは、閉じるときに自動保存され、次回起動時に復元されます（7 章）。

5. 機種の自動識別について

Device Name 欄の表示内容は、次の優先順位で決まります。上にあるものほど優先されます。

5-1. 内蔵の VID/PID 対応表（抜粋）

5-2. device_mapping.json のカスタマイズ

実行ファイルと同じフォルダ（インストール先は C:\tool_cs\ComPortScanner\）にある device_mapping.json を編集すると、機種名を上書きできます。保存すると次のスキャン（最大 2 秒後）または Refresh ボタンで反映されます。

{
  "deviceMappings": [
    {
      "name": "My M5Stamp",
      "patterns": [
        { "type": "serial", "value": "8&15adb4ef&2&0000" }
      ]
    },
    {
      "name": "CoreS3 + ISO RS485",
      "patterns": [
        { "type": "manual", "comPort": "COM30" }
      ]
    }
  ]
}

type: "serial" は USB のシリアル番号（デバイスマネージャーのプロパティで確認可）で指定、type: "manual" は COM 番号を直接指定します。

6. tool_M5 連携（役割名・IP アドレス表示）

社内の M5Stack 系デバイス書き込み管理ツール「tool_M5」が生成する連携ファイルを読み込むと、単なる機種名ではなく「その機器が何の役割で、どの IP アドレスを持っているか」まで Device Name 欄に表示できます（例：SuperMiniS3-SW8 (192.168.0.101)）。

• 連携ファイルは既定のパスから自動で読み込まれ、アプリの再起動なしに次のスキャンから反映されます。
• 連携ファイルにその COM 番号の登録がない場合は、5 章の優先順位に従って通常の自動判別（VID/PID 判定など）にフォールバックします。
• 連携ファイルの場所を変更したい場合は、device_mapping.json に "toolM5MapPath": "別のパス" を追記してください。

7. 保存される設定

ウィンドウを閉じるときに scanner_settings.json へ、ウィンドウの位置・サイズ・列（Port / Device Name）の幅が自動保存され、次回起動時に復元されます。設定ファイルは実行ファイルの場所を起点に探索して読み書きするため、インストール先を移動しても動作します。

8. 困ったときは

Q. Device Name が「Unknown Device」のままです

内蔵の VID/PID 対応表に無い機種です。device_mapping.json にシリアル番号または COM 番号でマッピングを追加してください（5-2 参照）。

Q. 同じ VID/PID の機器を複数挿しているのに、どれがどれか区別できません

VID/PID だけでは個体を区別できません。device_mapping.json にシリアル番号マッピングを追加するか、COM 番号が固定されているなら手動マッピング（type: "manual"）を使ってください。

Q. Device Name の末尾に「(manual)」と付いています

不具合ではありません。device_mapping.json の手動マッピング（COM 番号を直接指定した設定）が適用されていることを示す表示です。

Q. 抜いたはずの USB 機器がまだ一覧に残っています

最大 2 秒後の次回自動スキャンで消えます。すぐ確認したい場合は Refresh ボタンを押してください。

Q. Device Name に IP アドレスまで表示される機器と、機種名だけの機器があります

仕様どおりです。tool_M5 の連携ファイルに登録されている機器だけ役割名＋IP アドレスが表示されます（6 章）。登録がない機器は通常の自動判別の結果（機種名のみ）になります。

Q. 起動時に「初期化エラー」というダイアログが出ます

表示されたエラーメッセージの内容を控えたうえで、配布元までお問い合わせください。

Q. 同じ COM 番号が一覧に 2 行出ます

通常は起きません（重複除去済みです）。起きる場合はドライバーの再インストールや USB の挿し直しをお試しください。

9. アンインストール

配布フォルダの uninstall.bat をダブルクリックすると、C:\tool_cs\ComPortScanner\ とスタートメニューのショートカットが削除されます。手で消す場合の場所は次のとおりです。

10. 技術メモ（詳しい方向け）