Home Assistant(HA) 2025.12.2 버전에서 Midea 기기를 연동하는 가장 안정적이고 기능이 충실한 방법은 여전히 커뮤니티 통합의 로컬 LAN(Local LAN) 방식입니다. Midea가 2024~2025년에 클라우드 정책을 변경했지만 로컬 프로토콜은 계속 사용할 수 있습니다.
아래는 Home Assistant 2025.12.2 환경에서 검증한 상세 단계별 튜토리얼이며, 가장 권장되는 Midea AC LAN 통합 방식을 사용합니다.
🟢 핵심 방식 선택
- 권장 방식: HACS로 Midea AC LAN 설치(작성자: wuwentao).
- 장점:
- 완전 로컬 제어: 설정이 끝나면 인터넷이 끊겨도 사용할 수 있고 응답 속도가 매우 빠릅니다.
- 기능이 완전함: 에어컨, 제습기, 선풍기, 온수기 등 다양한 기기를 지원하며 스윙, 건조, ECO 등 고급 모드도 지원합니다.
- Token 자동 획득: 새 버전 통합은 계정 로그인으로 기기의 Key/Token을 자동으로 얻을 수 있어 번거로운 패킷 캡처가 필요 없습니다.
🔧 사전 준비
- Midea 기기가 이미 네트워크에 연결됨: Midea 기기가 집의 Wi-Fi에 연결되어 있는지 확인하세요.
- 강력 권장: Meiju 또는 NetHome Plus 앱으로 기기 네트워크를 설정하세요. 새로 구매한 기기라면 서드파티 토큰 추출에 더 친화적인 NetHome Plus(국제판)를 먼저 시도하는 것이 좋습니다.
Home Assistant에 HACS가 이미 설치됨:
- HACS(Home Assistant Community Store)를 아직 설치하지 않았다면 먼저 공식 문서를 참고해 설치하세요. 비공식 기기를 연동하는 데 반드시 필요한 스토어입니다.
📝 상세 단계별 튜토리얼
1단계: HACS에서 통합 다운로드
- Home Assistant를 열고 왼쪽 사이드바의 HACS를 클릭합니다.
- Integrations(통합)를 클릭합니다.
- 오른쪽 아래의 + Explore & Download Repositories(저장소 탐색 및 다운로드)를 클릭합니다.
- 검색창에 Midea AC LAN을 입력합니다.
- wuwentao가 개발한 Midea AC LAN을 찾아 클릭해서 들어갑니다.
- 주의: 작성자가 wuwentao인지 확인하세요. 현재 가장 활발하게 유지 관리되는 버전입니다.
오른쪽 아래의 Download를 클릭합니다. 다운로드가 끝나면 시스템이 Home Assistant 재시작을 안내합니다.
설정 -> 시스템 -> 오른쪽 위 전원 버튼 -> Home Assistant 다시 시작으로 이동합니다.
2단계: 통합 추가 및 구성
재시작이 끝나면 기기 추가를 시작합니다.
- 왼쪽 사이드바의 설정(Settings) -> 기기 및 서비스(Devices & Services)를 클릭합니다.
- 오른쪽 아래의 + 통합 추가(Add Integration)를 클릭합니다.
- Midea AC LAN을 검색하고 클릭합니다.
- 구성 모드를 선택합니다:
- 몇 가지 옵션이 표시됩니다. 보통 “Auto”(자동 스캔) 또는 “Add device by account”(계정으로 기기 추가)를 선택합니다.
- 초보자 권장 방식: “Add device by account”(계정으로 추가)를 선택합니다. 2025년에 가장 간단한 Token 획득 방법이며 수동 패킷 캡처가 필요 없습니다.
3단계: Token 자동 획득과 기기 추가
Midea 기기는 로컬 LAN 제어를 위해 Token과 Key가 필요하며, 이 단계가 핵심입니다.
- 나타나는 계정 로그인 화면에서:
- Account Type(계정 유형): “Meiju”를 사용한다면 Meiju를, “NetHome Plus”를 사용한다면 NetHome Plus를 선택합니다.
- Username/Password: 앱의 계정과 비밀번호를 입력합니다.
Submit(제출)을 클릭합니다.
통합이 자동으로 Midea 클라우드에 연결하여 계정에 바인딩된 모든 기기의 IP 주소, ID, Token, Key를 가져옵니다.
가져오기에 성공하면 목록에 발견된 기기가 표시됩니다. 추가할 기기를 체크하고 제출을 클릭합니다.
중요: 추가에 성공하면 통합은 로컬 LAN 모드 제어로 전환됩니다. 이때 앱 비밀번호를 바꾸거나 집의 외부 네트워크가 끊겨도 HA와 에어컨이 같은 공유기 아래에 있으면 제어할 수 있습니다.
💡 고급 구성과 자주 묻는 질문(FAQ)
1. 엔티티 이름 지정과 카드
추가에 성공하면 “개요” 페이지에서 표준 에어컨 카드(Climate Entity)를 볼 수 있습니다.
- 기능 테스트: 스위치를 눌러 보고 온도를 조절해 보세요. 응답이 거의 “초 단위”로 앱보다도 빠르다는 것을 알 수 있습니다.
- 고급 속성: 카드 오른쪽 위의 점 세 개(또는 엔티티 아이콘)를 클릭하면 Swing(스윙), Fan Mode(풍량), Preset(ECO/Boost 등 프리셋 모드) 같은 더 많은 제어 옵션을 볼 수 있습니다.
2. 자동 검색이 실패하면? (수동 IP 방식)
계정으로도 기기를 찾을 수 없다면 기기가 다른 대역(VLAN)에 있거나 UDP 브로드캐스트가 공유기에 차단된 것일 수 있습니다.
- 공유기 관리 페이지에서 Midea 기기의 IP 주소를 확인합니다(IP 변경으로 인한 연결 끊김을 막기 위해 공유기에서 Midea 기기에 고정 IP를 지정하는 것을 권장합니다).
- 통합을 추가할 때 “Add device manually”(수동으로 추가)를 선택합니다.
- IP 주소를 입력합니다. 이때 Token과 Key를 수동으로 입력해야 할 수 있습니다.
- Token 획득 대안: 통합이 자동으로 가져오지 못하면 PC용 Python 도구 msmart-ng를 사용합니다.
- PC 터미널에서 실행: pip install msmart-ng 후 msmart-ng discover를 실행하면 로컬 네트워크를 스캔해 Token 계산을 시도합니다.
3. 일부 센서가 표시되지 않는 이유는?
기본적으로 성능을 위해 일부 비핵심 센서(실외 온도, 전력 통계 등)가 비활성화되어 있을 수 있습니다.
- 설정 -> 기기 및 서비스 -> Midea AC LAN 클릭 -> 해당 기기 클릭으로 들어갑니다.
- “엔티티” 목록에서 회색으로 표시된 엔티티를 클릭하고 설정에서 Enable(활성화)하면 잠시 후 데이터가 표시됩니다.
4. Matter에 대하여 (신형 기기 전용)
사용 중인 기기가 2024년 이후 생산된 고급형(Midea U형 창문형 에어컨 신형 등)이고 포장에 Matter 로고가 인쇄되어 있다면.
- HA의 Matter (BETA) 통합으로 기기 본체의 QR 코드를 바로 스캔해 연결할 수 있습니다.
- 단점: 현재 Matter 프로토콜의 에어컨 지원은 기초적인 수준이라 “직풍 방지”, “셀프 클리닝” 같은 특화 기능을 제어하지 못할 수 있습니다. 이런 기능이 필요하다면 위의 LAN 방식을 계속 사용하세요.
✅ 정리
2025.12.2 버전 HA 사용자에게 HACS + Midea AC LAN(wuwentao 버전)은 여전히 최선의 해답입니다. Midea 클라우드의 불안정성을 피하고 완전한 로컬 제어를 구현했으며, 현재 가장 “완벽한” 연동 방식입니다.
