ZS05와 SmartIR: Zigbee2MQTT에서 설정

ZS05 Zigbee IR 컨트롤러를 SmartIR 및 Zigbee2MQTT와 통합하기

ZS05 Zigbee IR 컨트롤러는 Zigbee2MQTT와 SmartIR 통합을 통해 Home Assistant에 연결됩니다. 주요 과제는 MQTT 토픽을 올바르게 구성하고 Broadlink 형식의 IR 명령을 Raw MQTT로 변환하는 것입니다. 이를 통해 ZHA에서 흔히 발생하는 오류 없이 에어컨, TV, 프로젝터와 같은 기기를 제어할 수 있습니다.

시스템 요구사항

필요한 구성 요소:

• 최신 버전의 Home Assistant.
• 애드온 또는 Docker로 설치한 Zigbee2MQTT.
• HACS를 통한 SmartIR 설치.
• ZS05 컨트롤러 또는 호환 가능한 대안.

Zigbee2MQTT에서 장치 추가하기

• Zigbee2MQTT에서 Permit Join을 활성화합니다.
• ZS05의 버튼을 눌러 LED가 깜빡일 때까지 유지하여 리셋합니다.
• 장치가 Z2M 인터페이스에 나타납니다.
• ir_livingroom과 같은 Friendly Name을 지정합니다 — 이는 MQTT 토픽 zigbee2mqtt/ir_livingroom을 결정합니다.

로그를 확인하세요: 장치가 메시지를 발행하고 수신해야 합니다. zigbee2mqtt/ir_livingroom과 같은 토픽이 연결을 확인시켜 줍니다.

SmartIR 설치하기

HACS에서 SmartIR 저장소를 검색하여 설치하고 HA를 재시작합니다. 이 통합은 climate 및 media_player와 같은 엔티티를 생성하며, 이들은 MQTT를 통해 IR 신호를 전송합니다.

configuration.yaml에서 올바른 구성 설정

SmartIR 문서에서 흔히 발생하는 오류는 controller_data의 잘못된 서브토픽입니다. ZS05의 경우 /command가 아닌 /set/ir_code_to_send를 사용하세요.

기후 엔티티 예시:

smartir:

climate:
  - platform: smartir
    name: 거실 에어컨 IR
    unique_id: living_room_ac_ir
    device_code: 1200
    controller_data: zigbee2mqtt/ir_livingroom/set/ir_code_to_send
    temperature_sensor: sensor.temperature
    humidity_sensor: sensor.humidity
    power_sensor: binary_sensor.ac_power
    power_sensor_restore_state: true

주요 매개변수:

• controller_data: zigbee2mqtt/{friendly_name}/set/ir_code_to_send — ZS05 명령을 위한 정확한 경로입니다.
• device_code: SmartIR 라이브러리(smartir/codes/climate)의 숫자 코드입니다. 희귀 브랜드의 경우 프로토콜(예: Gree, Midea)로 일치시킵니다.
• 온도/습도/전원 센서 — 전체 자동화를 위한 선택 사항입니다.

IR 코드를 Raw MQTT로 변환하기

SmartIR 라이브러리는 코드를 Broadlink 형식으로 저장합니다. ZS05는 Base64 Raw MQTT가 필요합니다. 파일을 변환하세요:

• smartir/codes/{type} 저장소에서 JSON을 다운로드합니다.
• 온라인 Broadlink → Raw MQTT 변환기 또는 Python 스크립트를 사용합니다.
• 변환된 파일을 Samba를 통해 /config/custom_components/smartir/codes/climate에 배치합니다.

device_code에서는 파일명의 숫자만 지정하세요(예: 9990).

Tosot T09H-SNa/I(난방, 낮음, 16°C)에 대한 변환된 명령 예시:

{
  "manufacturer": "Tosot",
  "supportedModels": ["T09H-SJ"],
  "supportedController": "MQTT",
  "commandsEncoding": "Raw",
  "minTemperature": 16,
  "maxTemperature": 30,
  "precision": 1,
  "operationModes": ["heat", "cool", "dry", "fan_only", "heat_cool"],
  "fanModes": ["low", "medium", "high", "auto"],
  "commands": {
    "off": "CRgjnBElAm0GJQLgCwHgAxfAC+APK+ALO8AD4A9X4AtfAQpO4B1j4AdX4B+X4Bur",
    "heat": {
      "low": {
        "16": "BRgjnBElAsABAW0G4AEDwA/gLwHgB0vgBxvgB1/AawEKTuAdd+AHV+Azq+AHRw=="
      }
    }
  }
}

모든 모드/온도에 대한 전체 명령은 변환 후 라이브러리에서 확인할 수 있습니다.

테스트 및 디버깅

• HA를 재시작합니다.
• 기후 인터페이스에서 온도나 모드를 변경합니다.
• Developer Tools → MQTT 또는 Z2M 로그에서 zigbee2mqtt/ir_livingroom/set로의 발행을 확인합니다.
• ZS05의 LED 깜빡임과 장치 응답으로 성공을 확인합니다.

핵심 포인트

• controller_data에서 정확한 토픽 /{friendly_name}/set/ir_code_to_send를 사용하세요.
• ZS05와의 호환성을 위해 코드를 Raw MQTT로 변환하세요.
• 유사 모델에서 테스트하며 프로토콜로 device_code를 일치시키세요.
• Z2M 및 MQTT 로그가 주요 디버깅 도구입니다.
• IR 컨트롤러의 경우 Zigbee2MQTT가 ZHA보다 더 안정적입니다.

— Editorial Team