HADTUSCAN 使用説明：LAN 上の DTU 向けインストール不要の設定ツール

HADTUSCAN が解決するのは「デバイスはまだネットワークにつながっていないが、まずネットワークにつなぎたい」という場面です。デバイスがブラウザで開ける状態である必要はなく、PC とデバイスが同じレイヤー 2 ネットワーク上にさえあれば、UDP ブロードキャストでデバイスを見つけ出し、ネットワークパラメータを書き換えられます。

1.1 利用シーン

1. 工場や現場で、多数の DTU に固定 IP または DHCP をすばやく設定する。
2. 上位システムに接続する前に、ネットワークパラメータの初期化と確認を済ませる。
3. Home Assistant / ESPHome の環境で、mDNS からデバイスをすばやく見つけてWeb 設定画面を開く。

1.2 動作環境

ゼロから 1 台設定するまで、手順は 4 つだけです：

1. HADTUSCAN.exe をダブルクリックして起動します（インストール不要）。
2. 上部で正しいネットワークアダプターを選択します（デバイスと同じサブネットの有線アダプターを推奨）。
3. 「デバイスをスキャン（UDP）」で設定可能なデバイスを検出します。mDNS のみのデバイスは「HA mDNS スキャン」で検出します。
4. 一覧からデバイスを選び、目標のネットワークパラメータと PIN を入力して「設定を書き込む」をクリックします。

メイン画面は上から 4 つの領域に分かれています。それぞれの役割を押さえておけば迷いません：

UDP スキャンは、選択中のアダプターのブロードキャストアドレスと 255.255.255.255 に DISCOVER_REQ を送信し、デバイスはユニキャストで DISCOVER_RSP を返します。つまりスキャンの成否は「ブロードキャストが出るか」と「応答が戻るか」の2 点にかかっています。

4.1 よくあるトラブルの切り分け

mDNS スキャンは、ローカルネットワーク上で Home Assistant / ESPHome 関連のサービスを公開しているデバイスを見つけるためのものです。ただし mDNS が提供するのは通常 IP・ホスト名・サービス名とわずかな TXT フィールドだけで、ゲートウェイやマスク、DNS といった完全なネットワークパラメータは含まれません。つまり「見つける」ことはできても「設定を変える」ことはできません。

書き込みはこのツールで唯一の「書き込む」操作です。間違えるとデバイスがネットワークから落ちるため、守るべきルールが 3 つあります：

1. すべての書き込みには 6 桁の PIN が必要です（既定値は 123456）。
2. IP モードが固定の場合は IP / マスク / ゲートウェイ / DNS の入力が必須です。DHCP の場合は未入力でも構いません（ソフトが 0.0.0.0 を埋めます）。
3. 適用方法：即時切り替え / 書き込んで再起動（実際の挙動はデバイスのファームウェアに依存します）。

6.1 PIN のルール

6.2 成功 / 失敗の表示

ハードウェア側でこのプロトコルを自前で実装する場合は、次の 2 点に注意してください：

現在どのバージョンを使っているかを確認したい場合や、最新版に直接アップデートしたい場合は、上部バー右端の「について」をクリックします。「HAIscan について」ダイアログが開きます。

ダイアログには次の項目が表示されます：

ダイアログ下部には 2 つのボタンがあります：