ZS05 s SmartIR: nastavení v Zigbee2MQTT

Integrace Zigbee IR ovladače ZS05 se SmartIR přes Zigbee2MQTT

Zigbee IR ovladač ZS05 se připojuje k Home Assistant pomocí Zigbee2MQTT a integrace SmartIR. Hlavní výzva spočívá ve správném nastavení MQTT témat a převodu IR příkazů z formátu Broadlink na Raw MQTT. To umožňuje ovládat klimatizace, televize a projektory bez chyb typických pro ZHA.

Požadavky na systém

Pro fungování je potřeba:

• Home Assistant aktuální verze.
• Zigbee2MQTT jako doplněk nebo v Dockeru.
• SmartIR přes HACS.
• Ovladač ZS05 nebo kompatibilní alternativa.

Připojení zařízení v Zigbee2MQTT

• Aktivujte Permit Join v Zigbee2MQTT.
• Resetujte ZS05 podržením tlačítka do blikání LED.
• Zařízení se zobrazí v rozhraní Z2M.
• Přiřaďte Friendly Name, například ir_obývák — to určuje MQTT téma zigbee2mqtt/ir_obývák.

Zkontrolujte logy: zařízení by mělo publikovat a přijímat zprávy. Témata jako zigbee2mqtt/ir_obývák potvrzují spojení.

Instalace SmartIR

V HACS najděte repozitář SmartIR, nainstalujte a restartujte HA. Integrace vytváří entity typu climate, media_player, které používají MQTT k odesílání IR signálů.

Správná konfigurace v configuration.yaml

Chyba v dokumentaci SmartIR — nesprávné podtéma v controller_data. Pro ZS05 použijte /set/ir_code_to_send, nikoli /command.

Příklad pro klimatickou entitu:

smartir:

climate:
  - platform: smartir
    name: Klimatizace IR obývák
    unique_id: klimatizace_ir_obývák
    device_code: 1200
    controller_data: zigbee2mqtt/ir_obývák/set/ir_code_to_send
    temperature_sensor: sensor.teplota
    humidity_sensor: sensor.vlhkost
    power_sensor: binary_sensor.klimatizace_napájení
    power_sensor_restore_state: true

Klíčové parametry:

• controller_data: zigbee2mqtt/{friendly_name}/set/ir_code_to_send — přesná cesta pro příkazy ZS05.
• device_code: Číselný kód z knihovny SmartIR (smartir/codes/climate). Pro vzácné značky vybírejte podle protokolu (Gree, Midea).
• Senzory teploty/vlhkosti/napájení — volitelné pro plnou automatizaci.

Převod IR kódů na Raw MQTT

Knihovna SmartIR ukládá kódy ve formátu Broadlink. ZS05 vyžaduje Base64 Raw MQTT. Převádějte soubory:

• Stáhněte JSON z smartir/codes/{type} repozitáře.
• Použijte online převodník Broadlink → Raw MQTT nebo Python skript.
• Umístěte převedený soubor do /config/custom_components/smartir/codes/climate přes Samba.

V device_code uveďte pouze číslo z názvu souboru (např. 9990).

Příklad převedených příkazů pro Tosot T09H-SNa/I (teplo, nízká, 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=="
      }
    }
  }
}

Úplné příkazy pro všechny režimy/teploty jsou dostupné v knihovně po převodu.

Testování a ladění

• Restartujte HA.
• V rozhraní climate změňte teplotu nebo režim.
• V Developer Tools → MQTT nebo logech Z2M zkontrolujte publikování v zigbee2mqtt/ir_obývák/set.
• Blikání LED na ZS05 a reakce zařízení potvrzují úspěch.

Co je důležité

• Používejte přesné téma /{friendly_name}/set/ir_code_to_send v controller_data.
• Převádějte kódy na Raw MQTT pro kompatibilitu s ZS05.
• Vybírejte device_code podle protokolu, testujte na podobných modelech.
• Logy Z2M a MQTT — hlavní nástroj pro ladění.
• Zigbee2MQTT je stabilnější než ZHA pro IR ovladače.

— Editorial Team