HADTUSCAN 사용 설명: LAN DTU용 설치 불필요 설정 도구

HADTUSCAN이 해결하는 것은 “기기가 아직 네트워크에 연결되지 않았지만 먼저 네트워크에 연결하고 싶다”는 상황입니다. 기기가 브라우저에서 열리는 상태일 필요는 없으며, PC와 기기가 같은 2계층 네트워크에만 있으면 UDP 브로드캐스트로 기기를 찾아내고 네트워크 파라미터를 다시 쓸 수 있습니다.

1.1 사용 상황

1. 공장이나 현장에서 다수의 DTU에 고정 IP 또는 DHCP를 빠르게 설정할 때.
2. 상위 시스템에 연결하기 전에 네트워크 파라미터 초기화와 확인을 끝낼 때.
3. Home Assistant / ESPHome 환경에서 mDNS로 기기를 빠르게 찾아 웹 설정 화면을 열 때.

1.2 실행 환경

아무것도 없는 상태에서 기기 한 대를 설정하기까지는 네 단계면 충분합니다:

1. HADTUSCAN.exe를 더블클릭하여 실행합니다(설치 불필요).
2. 상단에서 올바른 네트워크 어댑터를 선택합니다(기기와 같은 서브넷의 유선 어댑터 권장).
3. “기기 검색(UDP)“을 눌러 설정 가능한 기기를 찾습니다. mDNS만 지원하는 기기는 “HA mDNS 검색“으로 찾습니다.
4. 목록에서 기기를 선택하고 대상 네트워크 파라미터와 PIN을 입력한 뒤 “설정 기록“을 클릭합니다.

메인 화면은 위에서 아래로 네 영역으로 나뉩니다. 각 영역의 역할만 알면 헷갈리지 않습니다:

UDP 검색은 선택한 어댑터의 브로드캐스트 주소와 255.255.255.255로 DISCOVER_REQ를 보내고, 기기는 유니캐스트로 DISCOVER_RSP를 응답합니다. 즉 검색 성공 여부는 “브로드캐스트가 나가는가”와 “응답이 돌아오는가” 두 가지에 달려 있습니다.

4.1 자주 발생하는 문제 점검

mDNS 검색은 로컬 네트워크에서 Home Assistant / ESPHome 관련 서비스를 공개한 기기를 찾는 데 사용합니다. 다만 mDNS는 보통 IP, 호스트 이름, 서비스 이름과 소량의 TXT 필드만 제공하며, 게이트웨이, 마스크, DNS 같은 전체 네트워크 파라미터는 포함하지 않습니다. 즉 “찾는” 것은 가능하지만 “설정을 바꾸는” 것은 불가능합니다.

기록은 이 도구에서 유일한 “쓰기” 동작입니다. 잘못 쓰면 기기가 네트워크에서 끊어지므로 반드시 지켜야 할 규칙이 세 가지 있습니다:

1. 모든 기록에는 6자리 PIN이 반드시 필요합니다(기본값 123456).
2. IP 모드가 고정이면 IP / 마스크 / 게이트웨이 / DNS를 입력해야 합니다. DHCP일 때는 입력하지 않아도 됩니다(소프트웨어가 0.0.0.0을 채웁니다).
3. 적용 방식: 즉시 전환 / 기록 후 재부팅(실제 동작은 기기 펌웨어에 따라 다릅니다).

6.1 PIN 규칙

6.2 성공 / 실패 안내

하드웨어 측에서 이 프로토콜을 직접 구현한다면 다음 두 가지에 주의하세요:

현재 어떤 버전을 사용 중인지 확인하거나 최신 버전으로 바로 업데이트하려면 상단 바 맨 오른쪽의 “정보“를 클릭합니다. “HAIscan 정보” 대화상자가 열립니다.

대화상자에는 다음 항목이 표시됩니다:

대화상자 아래에는 두 개의 버튼이 있습니다: