1. HAIOTS - 상업용 IoT 솔루션 플랫폼Home
  2. 기술 문서

Home Assistant(HA)에 Aqara(Lumi) 기기를 추가하는 방법은 보유한 하드웨어에 따라 크게 두 가지 주류 방식이 있습니다.

상황에 맞게 다음 중 하나를 선택하세요:

방법 A: Aqara 공식 게이트웨이가 있는 경우

(M1S, M2, E1, 에어컨 컴패니언 P3 등).

  • 핵심 아이디어: HomeKit을 통해 역방향으로 HA에 연동합니다.

방법 B: 범용 Zigbee 어댑터가 있는 경우

(Sonoff ZBDongle, SkyConnect 등 USB 스틱).

  • 핵심 아이디어: ZHA 또는 Zigbee2MQTT로 기기를 직접 제어합니다(권장, 완전 로컬, 게이트웨이 제약에서 벗어남).

방법 A: Aqara 공식 게이트웨이 사용(HomeKit Controller 경유)

가장 간단한 방법으로, 하드웨어를 건드리고 싶지 않고 이미 Aqara 게이트웨이를 구매한 사용자에게 적합합니다. 현재 Aqara 게이트웨이는 대부분 HomeKit을 지원하며, HA는 LAN에서 iOS 기기를 ‘모방’해 게이트웨이와 그 하위 기기를 인계받을 수 있습니다.

단계:

Aqara App에서 네트워크 설정:

휴대폰에 ‘Aqara Home’ App을 다운로드합니다(가능하면 Mi Home App을 쓰지 마세요. Aqara Home이 HomeKit 지원이 더 좋습니다).

게이트웨이와 하위 기기(센서, 스위치 등)를 Aqara Home App에 추가하고 펌웨어가 최신으로 업데이트되었는지 확인합니다.

주의:

iPhone을 사용한다면 iOS ‘홈’ App에 이 게이트웨이를 추가하지 마세요. 이미 추가했다면 iOS 홈 App에서 해당 게이트웨이를 삭제(바인딩 해제)하세요. HomeKit 기기는 보통 하나의 컨트롤러(휴대폰 또는 HA)만 단독으로 제어할 수 있기 때문입니다.

Home Assistant에서 기기 검색:

  • Home Assistant 웹 화면을 엽니다.
  • 설정(Settings) -> 기기 및 서비스(Devices & Services)로 이동합니다.
  • 보통 HA가 LAN 내 HomeKit 기기를 자동 검색하며, ‘HomeKit Device’ 아래에 검색 알림이 표시됩니다.
  • 자동 검색되지 않으면 오른쪽 아래의 통합 추가를 클릭하고 HomeKit Device를 검색합니다(HomeKit Bridge가 아님에 주의).

페어링:

  • 설정을 클릭하면 페어링 코드(Pairing Code)를 입력하라는 요청이 표시됩니다.
  • 페어링 코드는 보통 게이트웨이 바닥이나 포장 상자에 인쇄되어 있습니다(형식 XXX-XX-XXX).
  • 입력 후 몇 초 기다리면 게이트웨이와 그에 연결된 모든 하위 기기가 자동으로 HA에 나타납니다.

장점: 간단하고 공식 App으로 펌웨어를 업그레이드할 수 있습니다.

단점: 게이트웨이에 의존하며, 일부 특수 속성(예: 조도 센서의 구체적인 값 갱신 주기)은 HomeKit 프로토콜에 의해 제한될 수 있습니다.

방법 B: Zigbee USB 어댑터 사용(권장: Zigbee2MQTT)

고급 사용자와 안정성을 추구하는 사람의 첫 번째 선택입니다. Zigbee USB 동글(Sonoff ZBDongle-P 또는 -E 버전 권장)을 구매해야 합니다. 이 방식은 Aqara 게이트웨이가 필요 없고 모든 기기가 HA에 직접 연결되어 응답 속도가 가장 빠릅니다.

여기서는 가장 강력한 Zigbee2MQTT(Z2M) 방법을 소개합니다. ZHA보다 조금 복잡하지만 Aqara 기기의 독자 프로토콜 지원이 가장 좋습니다.

  • 준비 작업:

Zigbee USB 스틱을 HA가 실행되는 기기(라즈베리파이/NAS/미니 PC)에 꽂습니다. USB 3.0 간섭을 피하려면 USB 연장 케이블을 사용하는 것이 좋습니다.

  • 1단계: MQTT Broker(Mosquitto) 설치
  • HA에서 설정 -> 애드온(Add-ons) -> 애드온 스토어로 이동합니다.
  • Mosquitto broker를 검색해 설치합니다.
  • 실행하고 ‘시작 시 실행’과 ‘워치독’을 켜 두세요.

설정 -> 기기 및 서비스로 돌아가면 HA가 MQTT를 자동 검색하므로 설정을 클릭해 제출합니다.

  • 2단계: Zigbee2MQTT 설치
  • 설정 -> 애드온 -> 애드온 스토어로 이동합니다.
  • 오른쪽 위 메뉴(점 세 개) -> 저장소를 클릭하고 Z2M 저장소 주소를 추가합니다: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt (공식 것을 찾을 수 없다면 먼저 이것을 추가하세요).

새로 고친 후 Zigbee2MQTT를 설치합니다.

  • 3단계: Zigbee2MQTT 설정
  • Z2M 애드온 페이지에서 구성(Configuration) 탭을 클릭합니다.
  • MQTT 설정:
  • server: mqtt://core-mosquitto:1883
  • user: (보통 비워 두거나 HA 사용자 이름을 입력)

password: (위와 동일)

Serial 설정(핵심):

USB 스틱의 포트 경로(예: /dev/ttyUSB0)를 알아야 합니다. 설정 -> 시스템 -> 하드웨어 -> 모든 하드웨어에서 확인할 수 있습니다.

serial:
 port: /dev/ttyUSB0
 # 根据实际情况修改</li></ul>

설정에 다음을 추가합니다:

Zigbee2MQTT 애드온을 시작하고 로그를 확인해 정상적으로 시작되었는지(빨간 오류가 없는지) 확인합니다.

‘WEB UI 열기’를 클릭합니다.

  • 4단계: Aqara 기기 추가
  • Zigbee2MQTT 웹 화면 상단에서 참여 허용(Permit join)을 클릭합니다(카운트다운이 시작됩니다).
  • Aqara 기기 초기화:
  • 대부분의 Aqara 센서(인체, 도어/창, 온습도): 기기의 리셋 버튼을 5~10초간 길게 눌러 파란색 표시등이 깜빡일 때까지 기다립니다.

그때 손을 떼면 기기가 지원하는 경우 한 번 더 깜빡이며 연결 중임을 나타냅니다.

Z2M 화면을 보면 기기가 인터뷰를 거쳐 ‘Lumi’로 시작하는 모델명으로 표시됩니다.

기기 이름 옆의 파란 연필 아이콘을 클릭해 알기 쉬운 이름(예: ‘거실 인체 센서’)으로 바꾸고 ‘Home Assistant 엔터티 ID 업데이트’를 체크할 수 있습니다.

  • 장점:
  • 로컬화: 클라우드에서 완전히 벗어납니다.
  • 호환성: Aqara뿐 아니라 IKEA, Tuya 등 다른 브랜드의 Zigbee 기기도 함께 연결할 수 있습니다.

기능이 풍부함: Aqara의 많은 기기에는 숨겨진 매개변수(인체 센서의 감도, 정전 시 상태 기억 등)가 있으며 Z2M은 이를 직접 수정할 수 있지만 게이트웨이 모드에서는 대개 불가능합니다.

방법 C: ZHA(Zigbee Home Automation) 사용 – 간이형 USB 스틱 방식

  • 방법 B가 너무 복잡하다면 HA 네이티브 ZHA 통합을 사용할 수 있습니다. 이 역시 USB 스틱이 필요합니다.
  • USB 스틱을 꽂습니다.
  • 설정 -> 기기 및 서비스로 이동합니다.
  • 보통 HA가 USB 스틱을 자동 검색하고 Zigbee Home Automation을 설정할지 묻습니다.
  • 설정을 클릭하고 올바른 시리얼 포트를 선택해 네트워크를 생성합니다.
  • 설정이 완료되면 ZHA 통합 카드의 설정 -> 기기 추가를 클릭합니다.

Aqara 기기의 리셋 버튼을 길게 눌러 페어링하면 됩니다.

참고: ZHA의 Aqara 기기 지원도 좋지만, 일부 신형 모델이나 특수 매개변수 조정에서는 Zigbee2MQTT만큼 유연하지 않습니다.

요약 및 제안

초보자 / 하드웨어를 건드리고 싶지 않은 경우:

방법 A(Aqara 게이트웨이 + HomeKit)

를 사용하세요. 가장 안정적이고 App으로 기기 펌웨어도 업그레이드할 수 있습니다.

고급 사용자 / 응답 속도 중시 / 기기가 많은 경우

:

방법 B(Zigbee2MQTT)

  • 를 사용하세요. 현재 HA 커뮤니티에서 가장 권장하는 방식이며 Aqara 기기의 잠재력을 완전히 끌어냅니다. 자주 발생하는 문제 Troubleshooting
  • 기기가 자주 오프라인이 되나요?
  • Aqara의 구형 Zigbee 기기(T1 시리즈가 아닌)는 표준 Zigbee 3.0 프로토콜을 잘 따르지 않아 오프라인이 되기 쉽습니다.

해결: Zigbee 라우터 기기(즉 상시 전원 기기. Aqara 중성선 포함 벽 스위치, 스마트 플러그 등)를 늘리고, 센서가 USB 스틱에서 너무 멀리 떨어져 직접 연결되지 않도록 하세요.

  • 페어링이 안 되나요?
  • 가능한 한 USB 스틱이나 게이트웨이에 가까이 대고 페어링하세요.

Aqara 기기의 경우 리셋 버튼을 길게 눌러 램프가 깜빡인 뒤, 1초마다 버튼을 짧게 눌러 기기를 깨어 있는 상태로 유지하며 페어링이 성공할 때까지 계속하는 것을 권장합니다.

  • Mi Home App에 연결되는 게이트웨이는 어떻게 연결하나요?

구형 Xiaomi 멀티모드 게이트웨이라면 Xiaomi Gateway 3 통합(HACS 설치)을 사용할 수 있습니다. 다만 최신 기기는 HomeKit 경로를 권장합니다. Mi Home 프로토콜이 자주 바뀌고 로컬 인터페이스를 막기 때문입니다.

Previous:

Next:

相关新闻

cloud@haiots.com

QQ
微信