Fügen Sie der Konfiguration einen MQTT-Switch hinzu Home Assistant

4 Minuten des Lesens
ZIELE DES FÜHRERS
  • Fügen Sie der Konfiguration von einen MQTT-Switch hinzu Home Assistant
  • Schwierigkeitsgrad: basso
KONZEPTE GEGENÜBER:
  • Installation und Konfiguration der Software
VERWENDETE SOFTWAREKOMPONENTEN:
Voraussetzungen
VERWENDETE PHYSIKALISCHE GERÄTE:
  • Das Gerät, auf dem es sich befindet Home Assistant
  • Ein intelligenter Switch, der eine MQTT-Schnittstelle bietet
GUIDE mehr angezeigt für:

Alle Umgebungen

Hinweise und Haftungsausschluss
  • qualsiasi modifica all'impianto elettrico dev'essere effettuata da personale qualificato;
  • Änderungen in provorher ist a proEigenverantwortung sowie a proErstes Risiko und erste Gefahr (dieser Leitfaden dient nur zu Bildungszwecken);
  • Änderungen in probevor ein Gerät die Garantie erlischt.
Fahrbericht: 1

Abstrakt

Home Assistant Bietet native Unterstützung ab den frühesten Versionen al proMQTT tocollo durch eine aufgerufene Komponente, für dieappgesalbt "MQTT“. Wenn Sie einen intelligenten Schalter haben ausgestattet mit MQTT-Unterstützung (zB a Sonoff riproprogrammiert Sonoff-Tasmota) ist es möglich, die Steuerung auf sehr einfache Weise einzubinden Home Assistant.

Auf dieser Seite sehen wir, wie dies mit der Komponente gemacht wirdSwitch"Von Home Assistantspeziell die Plattform (Unterkomponente) “MQTT Switch .

Damit die Konfiguration das macht appwir bleiben, um funktionen auszuführen, ist es notwendig, dass die MQTT-Komponente di Home Assistant ist bereits konfiguriert. Wir empfehlen dies zu lesen Dies Führung.


Wir empfehlen dringend, dass Sie die folgende Anleitung lesen, bevor Sie diese Anleitung lesen:

So fügen Sie Schalter und Sensoren hinzu Sonoff a Home Assistant

Installation

Es muss nichts installiert werden: einfach zur Konfiguration von hinzufügen Home Assistant den Eintrag für den Schalter, den Sie hinzufügen möchten.

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

Also mal sehen, wie es geht.
Der minimale Satz Konfiguration zur Datei hinzufügen "configuration.yaml"Von Home Assistant ist das Folgende:

switch:
  - platform: mqtt
    name: "Ventilatore",
    command_topic: "cmnd/Ventilatore/POWER"

Einmal gespeichert und die Konfiguration neu gestartet / aktualisiert Home Assistant, appEs erscheint ein neuer Schalter (wie in der Beispielkonfiguration):

Home Assistant Switch

Konfigurationsvariablen:

name

(Schnur)(Optional) Der Name, der dem Switch zugeordnet werden soll
Standardwert: MQTT Switch

icon

(Schnur)(Optional) Wechselsymbol (z. B. mdi: Heizkörper).

state_topic
(Schnur)(Erforderlich) Das MQTT-Thema zu unterschreiben von Home Assistant um den Schalterstatus zu erhalten (ein / aus). Offensichtlich ändert sich das Zustandsthema basierend zur MQTT-Konfiguration des Geräts.
command_topic(Schnur)(erforderlich) Das MQTT-Thema, das von veröffentlicht werden soll Home Assistant um den Status des Schalters zu ändern. Offensichtlich ändert sich das Befehlsthema basierend zur MQTT-Konfiguration des Geräts.
availability_topic(Schnur)(Optional) Das MQTT-Thema zu unterschreiben von Home Assistant um den Status (online / offline) des Switches zu erhalten. Offensichtlich ändert sich das Verfügbarkeitsthema basierend zur MQTT-Konfiguration des Geräts. In der Regel wird das Thema verwendet Lwt.
payload_on

(Schnur)(Optional) Die Nutzlast, die rappZeigt den Zugang (zusammen mit gesendet command_topic).
Standardwert: true

payload_off

(Schnur)(Optional) Die Nutzlast, die rappsetzt das Herunterfahren zurück (zusammen mit gesendet) command_topic).
Standardwert: false

payload_available

(Schnur)(Optional) Die Nutzlast, die den Status als "online" interpretiert
Standardwert: "Online“. In der Regel wird die Nutzlast verwendet Lwt.

payload_not_available

(Schnur)(Optional) Die Nutzdaten, die den Status als "offline" interpretieren
Standardwert: "Offline“. In der Regel wird die Nutzlast verwendet Lwt.

optimistic

(Boolean)(Optional) Flag, das definiert, ob der Switch funktioniert optimistischer Modus.
Standardwert: was diese Dinge sind. wenn noessun state_topic ist sonst definiert falsch.

qos

(Ganzzahl) (Optional) Gibt die zu verwendende Dienstqualität an. Standardwert: 0 (Was ist QoS?)

retain

(Boolean) (Optional) Gibt an, ob für die veröffentlichten MQTT-Nachrichten für diesen Switch die Option "Beibehalten" verwendet werden soll.
Standardwert: false

value_template

(string) (Oational) Definiert, ob zum Extrahieren eine Vorlage verwendet werden soll ein bestimmter Wert in der Nutzlast des Staates.

In Anbetracht dieser Parameter ein Typenschalter appsind in der Konfiguration wie folgt:

switch:
  - platform: mqtt
    name: "Ventilatore"
    state_topic: "stat/Ventilatore/RESULT"
    value_template: "{{ value_json.POWER }}"
    command_topic: "cmnd/Ventilatore/POWER"
    availability_topic: "tele/Ventilatore/LWT"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    payload_available: "Online"
    payload_not_available: "Offline"
    retain: false
HINWEIS

Es ist möglich zu integrieren die gleiche Art der Konfiguration nicht nur vorzustellen Home Assistant der Schalter, sondern auch der Lichter. Betrachten wir den Fall, in dem Sie a verwenden Sonoff Basic (modifizierte Tasmota) als Schalter an einer Nachttischlampe: an der Hausautomation definiert am Home Assistant Wir möchten diesen Schalter appals Lichtpunkt, anstatt als Schalter. Der Konfigurationsblock ist derselbe wie oben beschrieben, wird jedoch unter "Licht:":

light:
  - platform: mqtt
    name: "Abat Jour"
    state_topic: "stat/AbatJour/RESULT"
    value_template: "{{ value_json.POWER }}"
    command_topic: "cmnd/AbatJour/POWER"
    availability_topic: "tele/AbatJour/LWT"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    payload_available: "Online"
    payload_not_available: "Offline"
    retain: false

Statuszählung zu Beginn von Home Assistant

Zu Beginn von Home Assistant diese Umgebung kennt den Status der MQTT-Schalter nicht möglicherweise in der Konfiguration enthalten. Um sicherzustellen, dass dieser Status sofort erkannt wird (und nicht nach ein paar Minuten, mit dem anderennameautomatische umschaltung seitens der verschiedenen switch) ist es notwendig, in die konfiguration einen automatismus einzufügen, den sie auf dem broker veröffentlichen ein Befehlsthema zu den zu aktualisierenden Schaltern, die eine Telemetrie ergeben:

automation:
  alias: "Censimento stati MQTT"
  trigger:
    platform: homeassistant
    event: start
  condition: []
  action:
    service: mqtt.publish
    data:
      topic: "cmnd/Ventilatore/POWER"
      payload: ""
      retain: false

Unter dem Block "action:Msgstr "Es ist möglich anzugeben, welche MQTT - Themen angezeigt werden sollen (in diesem Fall" cmnd / Fan / POWER "), um eine Antwort von den MQTT - Komponenten zu erzwingen um den Status zu bekommen.

So fügen Sie Schalter und Sensoren hinzu Sonoff a Home Assistant


ITEAD Sonoff BasicATTENZIONE: Denken Sie daran, dass es in unserer FORUM-Community gibt ein Ad-hoc-Bereich für Sonoff (und allgemeiner zu Geräten ESP8266), für jeden Zweifel, Frage, Information auf dem spezifischen Verdienst dieser Komponenten.


Bitte kommentieren Sie unten