Home Assistant 2025.12.2 버전에서 Gree 에어컨 기기를 연동하는 상세 튜토리얼입니다.
이 튜토리얼은 Home Assistant 공식 내장 통합(Integration)을 우선 사용합니다. 가장 안정적이고 초보자에게 가장 적합한 방식이며 서드파티 플러그인을 설치할 필요가 없습니다.
✅ 핵심 전제 (필독)
시작하기 전에 다음 준비를 반드시 완료하세요. 그렇지 않으면 연동할 수 없습니다:
- 기기가 이미 네트워크에 연결됨: Gree 에어컨이 “Gree+” 앱으로 집의 WiFi에 연결되어 있고 휴대폰에서 정상적으로 제어할 수 있어야 합니다.
- 동일한 네트워크 환경: Home Assistant 호스트(라즈베리파이, 소프트 라우터 등)와 Gree 에어컨이 같은 로컬 네트워크(같은 공유기) 아래에 있어야 합니다.
- 주의: 공식 통합은 자동 검색 기능에 의존하므로 기기가 다른 대역(VLAN)에 있으면 검색되지 않을 수 있습니다.
WiFi 대역: 에어컨은 보통 2.4GHz WiFi만 지원합니다.
🚀 1단계: Home Assistant에서 통합 추가
- Home Assistant 열기 브라우저나 앱에서 Home Assistant 백엔드에 로그인합니다.
- “기기 및 서비스”로 들어가기
- 왼쪽 메뉴에서 설정(Settings)을 클릭합니다.
- 기기 및 서비스(Devices & Services)를 선택합니다.
통합 추가
- 오른쪽 아래의 + 통합 추가(+ ADD INTEGRATION) 버튼을 클릭합니다.
- 검색창에 Gree를 입력합니다.
- 검색 결과에서 Gree Climate 아이콘을 클릭합니다.
기기 자동 검색
- 클릭하면 시스템이 로컬 네트워크의 Gree 기기를 자동으로 스캔합니다.
- 경우 A: 자동 검색 성공(권장)
- 화면에 발견된 기기가 표시됩니다(보통 MAC 주소나 기본 이름으로 표시됩니다).
- 제출(Submit)을 클릭합니다.
- 기기에 영역(Area)을 선택할 수 있으며(예: 거실, 안방), 그런 다음 완료(Finish)를 클릭합니다.
경우 B: 기기를 찾지 못함
- 로딩이 오래 계속되다 “기기를 찾을 수 없음”이 표시되면 에어컨 전원, WiFi 상태, HA 호스트와 같은 네트워크인지 확인하세요.
- 초보자 팁: 공유기 관리 페이지에서 에어컨에 고정 IP를 할당한 뒤 에어컨과 Home Assistant를 재시작하고 다시 시도해 보세요.
🎮 2단계: 제어와 사용
추가에 성공하면 에어컨이 Home Assistant에 연동된 것입니다.
- 엔티티 찾기
- 설정 -> 기기 및 서비스로 돌아갑니다.
- Gree Climate 카드의 기기 1개(또는 여러 개)를 클릭합니다.
- 클릭해서 기기 상세 페이지로 들어갑니다.
제어 패널표준 온도 조절기 카드가 표시되며 기능은 다음과 같습니다:
- 모드 전환: 냉방(Cool), 난방(Heat), 자동(Auto), 송풍(Fan only), 제습(Dry), 전원 끔(Off).
- 온도 조절: 원형 다이얼을 드래그하거나 화살표를 클릭해 목표 온도를 조정합니다.
- 보조 스위치: 시스템이 보통 추가 스위치 엔티티(Entities)를 자동 생성합니다. 예를 들어:
- Panel Light: 에어컨 본체의 LED 디스플레이 온/오프 제어.
- Quiet: 조용한 모드.
- XFan: 건조/보조 난방 기능.
대시보드에 추가
- 기기 상세 페이지에서 “대시보드에 추가” 버튼을 클릭하면 에어컨 카드를 홈 화면에 배치해 일상 제어가 편리해집니다.
❓ 자주 묻는 질문과 문제 해결(FAQ)
Q1: 왜 기기를 검색할 수 없나요?
- 원인 1: 네트워크 격리. 공유기에서 “AP 격리”를 켰거나 HA와 에어컨이 다른 대역에 있으면 브로드캐스트 패킷이 전달되지 않아 공식 통합이 자동 검색할 수 없습니다.
- 해결: 두 기기가 같은 WiFi 신호(2.4G)에 연결되어 있는지 확인하세요.
원인 2: 기기 모델이 너무 오래되었거나 너무 최신임.
- 해결: Gree+ 앱을 지원하는 대다수 기기가 지원됩니다. 정말 안 된다면 에어컨을 한 번 재시작(전원 차단 후 재연결)해야 할 수 있습니다.
Q2: 추가 후 “사용 불가(Unavailable)”로 표시되나요?
- 이는 보통 에어컨이 오프라인 상태가 되었기 때문입니다. Gree 에어컨의 WiFi 모듈은 장시간 대기 후 간혹 절전 상태에 들어갑니다. 리모컨으로 전원을 켜 보거나 공유기에서 고정 IP 주소를 지정해 안정성을 높여 보세요.
Q3: 공식 통합이 사용하기 불편하면?
- 고급 사용자이고 공식 통합으로 요구 사항을 충족할 수 없다면(예: 다른 대역 제어가 필요할 때) HACS로 서드파티 Gree Climate Component를 설치할 수 있습니다. 수동 IP 주소 입력 연동을 지원하지만, 초보자라면 위의 공식 통합 사용을 강력히 권장합니다.
💡 검증 환경 안내
- 검증 버전: Home Assistant Core 2025.12.2
- 검증 기기: Gree+ 프로토콜을 지원하는 범용 WiFi 에어컨
- 통합 유형: Official Core Integration (HACS 불필요)
작성자 소개 — Laite Intelligent는 2010년 설립되어 스마트홈 토탈 솔루션을 전문으로 합니다. Now ALL IN HA.
