ZS05 mit SmartIR: Einrichtung in Zigbee2MQTT

Integration des ZS05 Zigbee-IR-Controllers mit SmartIR über Zigbee2MQTT

Der ZS05 Zigbee-IR-Controller verbindet sich mit Home Assistant über Zigbee2MQTT und die SmartIR-Integration. Die Hauptherausforderung besteht darin, die MQTT-Topics korrekt zu konfigurieren und IR-Befehle vom Broadlink-Format in Raw MQTT umzuwandeln. Dies ermöglicht die Steuerung von Klimageräten, Fernsehern und Projektoren ohne die typischen Fehler, die bei ZHA auftreten.

Systemanforderungen

Sie benötigen:

• Home Assistant, aktuelle Version.
• Zigbee2MQTT als Add-on oder in Docker.
• SmartIR über HACS.
• Einen ZS05-Controller oder eine kompatible Alternative.

Hinzufügen des Geräts in Zigbee2MQTT

• Aktivieren Sie Permit Join in Zigbee2MQTT.
• Setzen Sie den ZS05 zurück, indem Sie die Taste gedrückt halten, bis die LED blinkt.
• Das Gerät erscheint in der Z2M-Oberfläche.
• Vergeben Sie einen Anzeigenamen, z.B. ir_wohnzimmer – dieser bestimmt das MQTT-Topic zigbee2mqtt/ir_wohnzimmer.

Überprüfen Sie die Logs: Das Gerät sollte Nachrichten senden und empfangen. Topics wie zigbee2mqtt/ir_wohnzimmer bestätigen die Verbindung.

Installation von SmartIR

Suchen Sie in HACS nach dem SmartIR-Repository, installieren Sie es und starten Sie HA neu. Die Integration erstellt Entitäten wie climate und media_player, die MQTT zum Senden von IR-Signalen verwenden.

Korrekte Konfiguration in configuration.yaml

Ein häufiger Fehler in der SmartIR-Dokumentation ist das falsche Untertopic in controller_data. Für den ZS05 verwenden Sie /set/ir_code_to_send, nicht /command.

Beispiel für eine Klima-Entität:

smartir:

climate:
  - platform: smartir
    name: Klimaanlage Wohnzimmer IR
    unique_id: klimaanlage_wohnzimmer_ir
    device_code: 1200
    controller_data: zigbee2mqtt/ir_wohnzimmer/set/ir_code_to_send
    temperature_sensor: sensor.temperatur
    humidity_sensor: sensor.luftfeuchtigkeit
    power_sensor: binary_sensor.klimaanlage_strom
    power_sensor_restore_state: true

Wichtige Parameter:

• controller_data: zigbee2mqtt/{anzeigename}/set/ir_code_to_send – der genaue Pfad für ZS05-Befehle.
• device_code: Numerischer Code aus der SmartIR-Bibliothek (smartir/codes/climate). Für seltene Marken, passen Sie nach Protokoll an (z.B. Gree, Midea).
• Temperatur-/Luftfeuchtigkeit-/Stromsensoren – optional für vollständige Automatisierung.

Umwandlung von IR-Codes in Raw MQTT

Die SmartIR-Bibliothek speichert Codes im Broadlink-Format. Der ZS05 benötigt Base64 Raw MQTT. Konvertieren Sie die Dateien:

• Laden Sie JSON aus dem smartir/codes/{typ}-Repository herunter.
• Verwenden Sie einen Online-Broadlink-zu-Raw-MQTT-Konverter oder ein Python-Skript.
• Platzieren Sie die konvertierte Datei über Samba in /config/custom_components/smartir/codes/climate.

In device_code geben Sie nur die Nummer aus dem Dateinamen an (z.B. 9990).

Beispiel konvertierte Befehle für Tosot T09H-SNa/I (Heizen, niedrig, 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=="
      }
    }
  }
}

Vollständige Befehle für alle Modi/Temperaturen sind nach der Konvertierung in der Bibliothek verfügbar.

Testen und Debuggen

• Starten Sie HA neu.
• Ändern Sie in der Klima-Oberfläche die Temperatur oder den Modus.
• Überprüfen Sie in Entwicklerwerkzeuge → MQTT oder Z2M-Logs die Veröffentlichungen an zigbee2mqtt/ir_wohnzimmer/set.
• Blinkende LED am ZS05 und Geräteresponse bestätigen den Erfolg.

Wichtige Punkte

• Verwenden Sie das genaue Topic /{anzeigename}/set/ir_code_to_send in controller_data.
• Konvertieren Sie Codes zu Raw MQTT für Kompatibilität mit dem ZS05.
• Passen Sie device_code nach Protokoll an, testen Sie an ähnlichen Modellen.
• Z2M- und MQTT-Logs sind die primären Debugging-Tools.
• Zigbee2MQTT ist stabiler als ZHA für IR-Controller.

— Editorial Team