Ajouter un commutateur MQTT à la configuration Home Assistant

4 minutes de lecture
OBJECTIFS DU GUIDE
  • Ajouter un commutateur MQTT à la configuration de Home Assistant
  • Niveau de difficulté: basso
CONCEPTS FACE:
  • Installation et configuration du logiciel
COMPOSANTS LOGICIELS UTILISÉS:
Pré-requis
DISPOSITIFS PHYSIQUES UTILISÉS:
  • L'appareil sur lequel il réside Home Assistant
  • Un commutateur intelligent offrant une interface MQTT
GUIDE plus indiqué pour:

Tous les environnements

Notes et avertissement
  • qualsiasi modifica all'impianto elettrico dev'essere progettata ed effettuata da personale qualificato;
  • tout changement mis en œuvre dans proavant est un prola responsabilité personnelle, ainsi que propremier risque et danger (le contenu de la présente page est purement pédagogique);
  • tout changement mis en œuvre dans proavant un appareil, il annule la garantie, les approbations de qualité et les certifications.
Avis de conduite: 1.4

Abstrait

Home Assistant fournit un support natif à partir des premières versions al proMQTT tocollo à travers un composant appelé, pour laappoint, "MQTT». Si vous avez un commutateur intelligent équipé du support MQTT (par exemple un Sonoff riproprogrammé Sonoff-Tasmota), il est possible d’intégrer le contrôle de manière très simple sur Home Assistant.

Sur cette page, nous verrons comment faire cela en utilisant le composant "Switch»de Home Assistant, en particulier la plate-forme (sous-composant) "MQTT Switch".

Pour que la configuration le fasse appnous restons pour remplir des fonctions, il est nécessaire que le composant MQTT di Home Assistant est déjà configuré. Nous vous recommandons de lire ceci de cette guide.


Nous vous recommandons vivement de lire le guide suivant avant de le consulter:

Comment ajouter des commutateurs et des capteurs Sonoff a Home Assistant

installation

Pas besoin d'installer quoi que ce soit: il suffit d'ajouter à la configuration de Home Assistant l'entrée pour le commutateur que vous souhaitez ajouter.

Nb Pour utiliser cette plateforme il est nécessaire que le composant "MQTT" de Home Assistant a été précédemment configuré (voir première partie de la carte dédiée au composant "MQTT"). Nous recommandons aussi lire soigneusement le guide consacré au thème de configuration des composants MQTT dans le propremière domotique.

Configuration

Voyons comment le faire.
L'ensemble minimal configuration à ajouter au fichier "configuration.yaml»de Home Assistant est la suivante:

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

Une fois la configuration sauvegardée et relancée / mise à jour Home Assistant, appun nouveau commutateur apparaîtra (comme dans l'exemple de configuration):

Home Assistant Switch

Variables de configuration:

name

(chaîne)(Facultatif) Le nom à attribuer au commutateur
Valeur par défaut: MQTT Switch

icon

(chaîne)(Facultatif) Changer d’icône (par ex. IMD: radiateur).

state_topic
(chaîne)(Obligatoire) Le sujet MQTT être signé par Home Assistant recevoir l'état du commutateur (on / off). Évidemment, le sujet de l’état change en fonction à la configuration MQTT de l'appareil.
command_topic(chaîne)(requis) Le sujet MQTT à publier par Home Assistant pour changer le statut du commutateur. Évidemment, le sujet de la commande change en fonction à la configuration MQTT de l'appareil.
availability_topic(chaîne)(Facultatif) Le sujet MQTT être signé par Home Assistant recevoir l'état (en ligne / hors ligne) du commutateur. Évidemment, le sujet de disponibilité change en fonction à la configuration MQTT de l'appareil. Habituellement, le sujet est utilisé LWT.
payload_on

(chaîne)(Facultatif) La charge utile que rappmontre l'accès (envoyé avec command_topic).
Valeur par défaut: true

payload_off

(chaîne)(Facultatif) La charge utile que rappréinitialise l’arrêt (envoyé avec command_topic).
Valeur par défaut: false

payload_available

(chaîne)(Facultatif) La charge utile qui interprète l'état comme "en ligne"
Valeur par défaut: "Online». Habituellement, la charge utile est utilisée LWT.

payload_not_available

(chaîne)(Facultatif) La charge utile qui interprète l'état comme "hors ligne"
Valeur par défaut: "Offline». Habituellement, la charge utile est utilisée LWT.

optimistic

(Boolean)(Facultatif) Indicateur définissant si le commutateur fonctionne dans mode optimiste.
Valeur par défaut: vrai si noessun state_topic est défini, sinon faux.

qos

(entier) (Facultatif) Indique la qualité de service à utiliser. Valeur par défaut: 0 (Qu'est-ce que la QoS?)

retain

(Boolean) (Facultatif) Indique si les messages MQTT publiés pour ce commutateur doivent utiliser le maintien.
Valeur par défaut: false

value_template

(chaîne) (Oational) Définit s'il faut ou non utiliser un modèle pour extraire une certaine valeur dans la charge utile de l'état.

À la lumière de ces paramètres, un commutateur de type appsont dans la configuration comme suit:

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
NOTE

Il est possible d'intégrer le même type de configuration pas seulement pour présenter Home Assistant des interrupteurs mais aussi des lumières. Prenons le cas où vous utilisez un Sonoff Basic (modifié Tasmota) comme interrupteur sur une lampe de chevet: sur la domotique définie sur Home Assistant nous voudrions que ce commutateur appcomme point de lumière, plutôt que comme un commutateur. Le bloc de configuration sera le même que décrit ci-dessus, mais indiqué sous "lumière:":

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

Etat du recensement au début de Home Assistant

Au début de Home Assistant cet environnement ne connaît pas l'état des commutateurs MQTT éventuellement inclus dans la configuration. Pour s’assurer que cet état est détecté immédiatement (et non après quelques minutes, avec l’autrenamecommutateur automatique de la part des différents commutateurs) il est nécessaire d'insérer dans la configuration un automatisme que vous publiez sur le courtier un sujet de commande au (x) commutateur (s) à mettre à jour entraînant une télémétrie:

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

Sous le bloc "action:"Il sera possible d'indiquer les sujets MQTT à indiquer (dans ce cas," cmnd / Fan / POWER ") afin de forcer une réponse des composants MQTT pour obtenir le statut.

Comment ajouter des commutateurs et des capteurs Sonoff a Home Assistant


ITEAD Sonoff BasicATTENZIONE: rappelez-vous qu'il y a sur notre communauté FORUM une section ad hoc dédiée à Sonoff (et plus généralement aux appareils ESP8266), pour tout doute, question, information sur le mérite spécifique de ces composants.


Veuillez commenter ci-dessous