Plattform Home Assistant "MQTT HVAC" (Heizung, Lüftung und Klimaanlage)

7 Minuten des Lesens
ProLeiter: Home Assistant Community
Verfügbarkeit: enthalten in derHUB Personal Home Assistant
Kategorie: Software
Typologie: Plattform Home Assistant
Familie: Komponente "Climate" Home Assistant
Implementierungsschwierigkeiten: Medien

Die "MQTT HVAC" -Plattform (Heizung, Lüftung und Klimaanlage, dh Heizung, Lüftung und Klimatisierungnamento), Tochter der Komponente "Climate"dient zur Definition von Wesen Kontrolle nützlich, appgesalbt, um durchzukommen Home Assistant Heizung und / oder Lüftung und / oder Zustandnamento Ausgehend von Geräten, die von gesteuert werden können proProtokoll MQTT.

Nb Diese Komponente Es ist NICHT geeignet zur Integration von Geräten / Aktoren, die obwohl sie unterstützen proMQTT tocollonicht verfügbar haben ein proerste Intelligenz pro-Eigentum für das Klimamanagement (zB einfache MQTT - Switches, wie dasITEAD Sonoff Basic). Praktisch, diese Komponente wird NUR zum einbinden verwendet Home Assistant von MQTT-Thermostate.

Eine alternative Plattform - für MQTT-Geräte, die an eine Wärmeeinheit angeschlossen sind, jedoch KEINE haben propria intelligenz im zusammenhang mit klima management - ist dieGenerisches Thermostat". Ein Beispiel von dieser Art der Implementierung ist gegeben durch proDomotisierungsstrahl einer autonomen Heizung durch sauberer Kontakt.

Geräte, die über die Plattform verwaltet werden können MQTT HVAC kann unterschiedlich sein.
Zum Beispiel:

  • Thermostate oder elektronisch an Bord enthalten des Kessels / der Wärmepumpe / der Klimaanlage, die von Haus aus MQTT unterstützen;
  • eine Software-Schnittstelle (z.B. Node-RED) Das ja frapponga zwischen der MQTT HVAC-Plattform von Home Assistant und jedes Objekt nachgeschaltet, unterschiedlich steuerbar.

Der erste Fall es ist am einfachsten zu verstehen. Die Plattformkonfiguration sendet MQTT-Befehle und empfängt MQTT-Telemetrie direkt vom gesteuerten Gerät.

Der zweite Fall es ist das Raffinierteste: Was diese Plattform (immer unbewusst) "spricht", ist kein Gerät mehr (sei es ein Thermostat, ein intelligentes Gerät, ein Aktuator) aber mit einer software welches sappia interpretieren die MQTT-Befehle von Home Assistant über die MQTT HVAC-Plattform und sie in etwas anderes übersetzen.
Dies "etwas anderes"Kann alles sein. Bringen Sie den Fall zu Node-REDWir könnten das Konzept auf die Spitze treiben, indem wir uns einen Knotenfluss vorstellen, der den über MQTT empfangenen Zündbefehl abfängt. proSenden Sie eine SMS an eine Person mit der Nachricht "Kessel einschalten!"-"Kessel ausschalten!“. Es könnte wie eine Wanderhypothese scheinen, ist es aber nicht. Visa i Hunderte Von den für diese leistungsstarke Software verfügbaren Ausgabeknoten könnten im realen Bereich verschiedene Techniken verwendet werden, um zu gelangen etwas zu domotisieren, das nicht wäre.

Diese Plattform funktioniert standardmäßig in “optimistischer Modus"Das ist nicht erhalten die Funktionszuständenameüber MQTT-Thema (so braucht es sie) und beschränkt Sie auf das Senden (Befehle), um den zuletzt vom Benutzer eingestellten Zustand zu speichern und die Umgebungstemperatur über Telemetriethemen (die auch aus anderen Quellen als dem Klimaelement stammen können, z. B. einem Ad-hoc-Sensor) zu erhalten. Dieses Verhalten kann durch Übernahme der Parameter "*_state_topic", Wie unten erklärt.

tado°  su  Home Assistant
Beispiel einer Entität "Climate"On Home Assistant
Nb Um diese Plattform zu nutzen ist es notwendig, dass die "MQTT" -Komponente von Home Assistant wurde bereits konfiguriert (siehe erster Teil der Karte, die der Komponente "MQTT" zugeordnet ist). Wir empfehlen auch zu lesen vorsichtig der Leitfaden zum Thema Konfiguration der MQTT - Komponenten im proerste Hausautomation.

Konfiguration

Zu schaffen a 'Wesen Klima Über diese Plattform wird der Block eingefügt die Konfiguration "configuration.yaml" di Home Assistant Es ähnelt im Grunde dem Folgenden:

climate:
  - platform: mqtt
    name: Salotto
    current_temperature_topic: /sensors/hvac/current_temp
    temperature_command_topic: /sensors/hvac/target_temp

Wo die proAnpassungseigenschaft sie sind:

name(Zeichenfolge, optional) - Der Name der Entität. Standard: "MQTT HVAC"
qos(Ganzzahl, optional) - Die QoS-Ebene für das state_topic. Standard: 0 (Was ist QoS?)
retain(Boolescher Wert, optional) - Stellen Sie den behalten auf veröffentlichten MQTT-Nachrichten. Voreinstellung: false
send_if_off(Boolean, optional) - Wenn "false" festgelegt ist, wird das Senden von MQTT-Nachrichten angehalten, wenn sich die Entität im Modus "off" befindet. Voreinstellung: true
initial(dezimal, optional) - Legen Sie die Zieltemperatur des Objekts fest. Voreinstellung: 21 Grad Celsius, 70 Fahrenheit.
payload_on(Zeichenfolge, optional) - Die Nutzlast, die rappes gibt den Status "on" zurück. Voreinstellung: "true".
payload_off(Zeichenfolge, optional) - Die Nutzlast, die rappSetzt den Status auf "Aus" zurück. Voreinstellung: "false".
availability_topic(Zeichenfolge, optional) - Thema MQTT, in dem registriert wird, ob das gesteuerte Gerät den Status online / offline erhält. In der Regel wird das Thema angezeigt Lwt.
payload_available
(Zeichenfolge, optional) - Die Nutzlast, die rappEs gibt den Status "Verfügbar" des gesteuerten Geräts zurück. Beispiel: "online". Es wird in abbi verwendetnamezur Variablen "availability_topic“. In der Regel wird eine Nutzlast angegeben LWT.
payload_not_available
(Zeichenfolge, optional) - Die Nutzlast, die rappes gibt den Status "nicht verfügbar" vom gesteuerten Gerät zurück Beispiel: "offline". Es wird in abbi verwendetnamezur Variablen "availability_topic“. In der Regel wird eine Nutzlast angegeben Lwt.
value_template
(Vorlage, optional) - Definiert die Vorlage zum Extrahieren (Parsen) von Daten in allen Nutzdaten "*_state_topic".
current_temperature_topic(Zeichenfolge, optional) - Thema MQTT, in das die aktuelle Temperatur eingetragen werden soll.
current_temperature_template(Vorlage, optional) - Definiert die Vorlage zum Extrahieren (Parsen) der Temperaturdaten aus dem in der Tabelle "current_temperature_template".
power_command_topic(Zeichenfolge, optional) - Thema MQTT, das gegen das Ein- / Ausschalten der Entität veröffentlicht wurde.
mode_command_topic(Zeichenfolge, optional) - Topic MQTT, das gegen eine Statusänderung der Entität veröffentlicht wurde.
mode_state_topic(Zeichenfolge, optional) - Thema MQTT, in das das Register eingetragen wird, um den Status des gesteuerten Geräts abzurufen. Wenn nicht festgelegt, arbeitet die Entität im "optimistischen Modus" (siehe nachstehende Tabelle).
mode_state_template(Vorlage, optional) - Definiert die Vorlage für das Extrahieren (Parsen) der Statusdaten aus dem in "mode_state_topic".
Modus(Liste | Zeichenfolge, optional) - Liste der verfügbaren Betriebsarten. Standardwerte: ["auto", "off", "cool", "heat", "dry", "fan_only"]
temperature_command_topic(Zeichenfolge, optional) - Thema MQTT, das gegen eine Zieltemperaturänderung der Entität veröffentlicht wurde.
temperature_state_topic(Zeichenfolge, optional) - Thema MQTT, in dem der Status von Änderungen der Zieltemperatur des gesteuerten Geräts registriert wird. Wenn nicht festgelegt, arbeitet die Entität im "optimistischen Modus" (siehe nachstehende Tabelle).
temperature_state_template(Vorlage, optional) - Definiert die Vorlage für das Extrahieren (Parsen) der Statusdaten aus dem in "temperature_state_topic".
fan_mode_command_topic(Zeichenfolge, optional) - Thema MQTT, das gegen eine Änderung des Beatmungsmodus der Entität veröffentlicht wurde.
fan_mode_state_topic(Zeichenfolge, optional) - Thema MQTT, in dem der Status von Änderungen im Beatmungsmodus des gesteuerten Geräts registriert wird. Wenn nicht festgelegt, arbeitet die Entität im "optimistischen Modus" (siehe nachstehende Tabelle).
fan_mode_state_template(Vorlage, optional) - Definiert die Vorlage für das Extrahieren (Parsen) der Statusdaten aus dem in "fan_mode_state_topic".
fan_modes(Liste | Zeichenfolge, optional) - Liste der verfügbaren Beatmungsbetriebsarten. Standardwerte: ["auto", "low", "medium", "high"]
swing_mode_command_topic(Zeichenfolge, optional) - Topic MQTT, das gegen eine Änderung des Oszillationsmodus der Entität veröffentlicht wurde.
swing_mode_state_topic(Zeichenfolge, optional) - Thema MQTT, in das Register, um den Status von Änderungen im Oszillationsmodus des gesteuerten Geräts abzurufen. Wenn nicht festgelegt, arbeitet die Entität im "optimistischen Modus" (siehe nachstehende Tabelle).
swing_mode_state_template(Vorlage, optional) - Definiert die Vorlage für das Extrahieren (Parsen) der Statusdaten aus dem in "swing_mode_state_topic".
swing_modes(Liste | Zeichenfolge, optional) - Liste der verfügbaren Oszillationsbetriebsarten. Standardwerte: ["Ein", "Aus"]
away_mode_command_topic(Zeichenfolge, optional) - Topic MQTT, das gegen eine Änderung des Abwesenheitsmodus der Entität veröffentlicht wurde.
away_mode_state_topic(Zeichenfolge, optional) - Thema MQTT, in das das Register eingetragen wird, um den Status der Änderungen im Abwesenheitsmodus des gesteuerten Geräts abzurufen. Wenn nicht festgelegt, arbeitet die Entität im "optimistischen Modus" (siehe nachstehende Tabelle).
away_mode_state_template(Vorlage, optional) - Definiert die Vorlage für das Extrahieren (Parsen) der Statusdaten aus dem in "away_mode_state_topic".
hold_command_topic(Zeichenfolge, optional) - Topic MQTT, das gegen eine Änderung des Haltemodus der Entität veröffentlicht wurde.
hold_state_topic(Zeichenfolge, optional) - Thema MQTT, in das Register, um den Status von Änderungen im "Hold" -Modus des gesteuerten Geräts abzurufen. Wenn nicht festgelegt, arbeitet die Entität im "optimistischen Modus" (siehe nachstehende Tabelle).
hold_state_topic_template(Vorlage, optional) - Definiert die Vorlage für das Extrahieren (Parsen) der Statusdaten aus dem in "hold_mode_state_topic".
aux_command_topic(Zeichenfolge, optional) - Thema MQTT veröffentlicht gegen das Ein- / Ausschalten eines Zusatzheizgeräts in der Entität.
aux_state_topic(Zeichenfolge, optional) - Thema MQTT, für das der Status des Zusatzgeräts für die Heizung des gesteuerten Geräts registriert werden soll. Wenn nicht festgelegt, arbeitet die Entität im "optimistischen Modus" (siehe nachstehende Tabelle).
aux_state_template(Vorlage, optional) - Definiert die Vorlage für das Extrahieren (Parsen) der Statusdaten aus dem in "aux_state_topic".
min_temp(dezimal, optional) - Definiert die minimale Zieltemperatur, die am Objekt eingestellt werden kann.
max_temp(dezimal, optional) - Definiert die maximale Zieltemperatur, die am Objekt eingestellt werden kann.
OPTIMISTISCHER MODUS

Wenn einer proEigenschaft arbeitet im "optimistischen Modus" (dh wenn das entsprechende "Zustandsthema" nicht gesetzt ist, Home Assistant annehmen dass jede Änderung des Status derWesen vom Benutzer implementiert - und daher die entsprechende MQTT-Veröffentlichung von Themen und Nutzdaten im Zusammenhang mit der Variation selbst - war erfolgreich am gesteuerten Gerät, daher der Status des Unternehmens bei Home Assistant übernimmt automatisch und sofort der neue Staat.
Wenn stattdessen das "Zustandsthema" definiert wurde, ändert sich der Status der Entität es wird nicht verändert solange dieses Thema relative Nutzlast ist wurden nicht empfangen.

VERWENDUNG VON VORLAGEN

In jedem "* _state_topic”Kann definiert werden als Vorlage zum Extrahieren (Parsen) der Statusdaten. Sie kann auch mit der Taste für alle definiert werden proEigentum "value_template“. Dies übersetzt in ein großer Trost vor allem, wenn Nutzlasten eingeschrieben sind JSON-Notation.

Beispiele

VOLLSTÄNDIGE KONFIGURATION

Ein Beispiel für eine "Typ" -Konfiguration für eine Klimaanlage kompatibel mit proMQTT tocollo ist der folgende:

climate:
  - platform: mqtt
    name: Salotto
    modes:
      - off
      - cool
      - fan_only
    swing_modes:
      - on
      - off
    fan_modes:
      - high
      - medium
      - low
    power_command_topic: "study/ac/power/set"
    mode_command_topic: "study/ac/mode/set"
    temperature_command_topic: "study/ac/temperature/set"
    fan_mode_command_topic: "study/ac/fan/set"
    swing_mode_command_topic: "study/ac/swing/set"


Home Assistant Offizielles LogoATTENZIONE: Denken Sie daran, dass es in unserer FORUM-Community gibt ein Ad-hoc-Bereich für Home Assistantfür jeden Zweifel, Frage, Information auf dem spezifischen Verdienst dieser Komponenten.


Telegramm

Bleiben Sie auf dem Laufenden durch unsere Telegrammkanal!