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 章）。

4-1. 幽霊 COM（名前だけ残った番号）は出しません

COM ポートを開いたまま USB 機器を抜くと、Windows の COM の一覧に番号の名前だけが残ることがあります（機器はもう無く、開こうとしても「見つからない」になる）。本ソフトはこのような番号を「幽霊 COM」として一覧から外し、状態ラベルに「(幽霊 COM67 除外)」のように番号を出します。ポートを開かずに判定するので、使用中のポートには影響しません。

Windows 側に残った名前は、PC を再起動すると消えます。

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

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

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

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

実行ファイルと同じフォルダ（インストール先は C:\tool_cs\ComPortScanner\）にある device_mapping.json を編集すると、機種名を上書きできます。保存したら Refresh ボタンを押すとすぐ反映されます（押さなくても 30 秒以内に反映）。

{
  "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.x.x)）。

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

7. 保存される設定

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

8. COM 番号を変える

デバイスマネージャーの「ポートの設定 → 詳細設定 → COM ポート番号」と同じ変更を、一覧から直接できます。

変えた番号は、その機器（ID）に結び付いて覚えられます。同じ機器を同じ USB の口に挿せば、次からも新しい番号で出ます。シリアル番号の無い機器（4 章の ID 列が 8&… の形）は、別の USB の口に挿すと別の機器として扱われ、番号も別になります。

9. 変更記録（自動で残ります）

本ソフトは、機器の ID ごとに最後の COM 番号を覚えておき、変化があると記録に追記します。アプリを閉じている間に番号が変わった場合も、次に起動したときに記録されます。

記録 ボタン →「記録（新しい順）」タブで見られます。1 台だけ見たいときは、一覧または ID 表の行を右クリック →「この機器の変更記録」（ID 表ではダブルクリック）。

変更記録。COM42 の機器を COM149 に変え（手動変更）、入れ直しで一度切れてつながった（切断・接続）ところ

10. ID 表（機器ごとの一覧）

記録 ボタン →「ID 表」タブ。機器 1 台を 1 行にまとめた表です。本ソフトが見た機器に加えて、Windows が覚えている過去の COM 機器（今はつながっていない物）も並びます。並び順は「接続中 → 本ソフトの記録あり → Windows だけが覚えている物」で、それぞれ COM 番号順です。

ID 表。太字が今つながっている機器。COM4 には別の機器が 2 台登録されている（★ 1）

表の上には「機器 89 件（接続中 2・このアプリの記録あり 2）★ 番号が重なっている COM 7 個」のような合計が出ます。列見出しを押すとその列で並べ替えられます。

列の幅は、見出しの境目をドラッグして変えられます（「名前」が途中で切れるときは広げてください）。変えた幅と、窓の位置・大きさは保存され、次に開いたときも同じになります。

11. 困ったときは

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 機器がまだ一覧に残っています

抜いたあと 0.5 秒ほどで消えます。消えない番号は「幽霊 COM」として外されます（4-1）。すぐ確認したい場合は Refresh ボタンを押してください。

Q. 機器を抜いても、ずっと一覧に残っていた番号がありました

名前だけが残った「幽霊 COM」です（4-1）。最新版では一覧から外し、状態ラベルに番号を出します。PC を再起動すると Windows 側からも消えます。

Q. COM 番号を変えようとしたら「管理者の確認（UAC）で取り消されました」と出ました

確認の画面で「いいえ」を押したか、画面を閉じたためです。番号は変わっていません。もう一度変更して「はい」を押してください。管理者になれないアカウントでは番号を変えられません。

Q. 番号を変えたのに、挿し直したら別の番号になりました

シリアル番号の無い機器（ID が 8&… の形）を別の USB の口に挿すと、Windows は別の機器として扱い、別の番号を付けます。いつも同じ口に挿すか、その口で改めて番号を変えてください。ID 表で、同じ種類の機器が口ごとに別の行になっているのが確かめられます。

Q. ID 表に、知らない機器がたくさん並んでいます

Windows が覚えている過去の COM 機器です（今つながっていない物も含みます）。表示するだけで、何も変えません。

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

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

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

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

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

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

12. アンインストール

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

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