plate-forme Home Assistant « MQTT Switch"

3 minutes de lecture
Proconducteur: Home Assistant Communauté
Disponibilité: inclus dans leHUB personnel Home Assistant
catégorie: logiciel
typologie: plate-forme Home Assistant
famille: composant "Switch" Home Assistant
Difficultés de mise en œuvre: Médias
Révision de la carte: 1.1

Le «MQTT Switch", fille du composant "Switch", sert à définir des simples entité type de commutateur utile, appoint, dans la gestion par Home Assistant d'actionneurs domotiques de type on / off qu'ils s'attendent à être contrôlés par proprotocole MQTT (par exemple ceux avec firmware Sonoff-Tasmota).

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.

Quoi qu'il en soit, il est conseillé d'aborder la mise en œuvre de cette plateforme unique en présence d'au moins une compétence base sur le sujet MQTT.

Configuration

Pour simplifier la compréhension de la fonction au maximumnamed'un interrupteur contrôlable via protocollo MQTT il faut savoir que, idéalement, il a un sujet de commandement et un sujet télémétrique.

Le premier (sa présence est obligatoire) est utilisé envoyer des commandes à l'actionneur, le second (généralement présent) à en recevoir les réponses à ces commandes ou dans tous les cas le statut change (peut-être déclenché manuellement via des boutons ou autre).

exemple:

  • envoi par Home Assistant du sujet de la commande au courtier adressé au périphérique;
  • le périphérique, enregistré auprès du courtier, reçoit la commande qui lui est affectée;
  • le périphérique exécute la commande et envoie un sujet de réponse télémétrique au courtier;
  • Home Assistant, est à son tour inscrit auprès du courtier, reçoit la télémétrie et confirme effectivement le statut au type «MQTT Switch”A partir de laquelle la commande a commencé.

En l'absence de sujets télémétriques (il est donc impossible de les indiquer dans la configuration de Home Assistant), leHUB se comporte d'une certaine manière optimiste, c’est-à-dire qu’il suppose que lorsqu’une commande est implémentée, elle a été exécutée. Bien entendu, aucun changement d'état implémenté directement sur l'appareil ne sera reçu par Home Assistant.

Ajouter un (élémentaire) "MQTT Switch"Ci-dessous configuration de Home Assistant, le bloc est le suivant:

switch:
  - platform: mqtt
    command_topic: "cmnd/Sonoff/POWER"

Explication des champs utilisés et utilisables:

command_topic(Chaîne, obligatoire) Sujet MQTT sur lequel publier Home Assistant afin de contrôler le commutateur.
payload_on(Chaîne, facultatif) La charge utile à envoyer avec la commande indiquée dans command_topic afin d'allumer l'interrupteur.
payload_off(Chaîne, facultatif) La charge utile à envoyer avec la commande indiquée dans command_topic afin d'éteindre l'interrupteur.
name
(Chaîne, facultatif) Décrit le nom de l'entité. Valeur par défaut: MQTT Switch
icon(Icône, facultatif) Icône graphique pour rappresite le commutateur, qui se réfèrent à ceux disponibles au public à http://materialdesignicons.com. La syntaxe prévoit d’indiquer le nom de l’icône précédée du préfixe “mdi:"
Exemple: "mdi:history».
state_topic
(Chaîne, facultatif) Sujet MQTT à enregistrer pour obtenir les modifications de l'état de fonctionnement par le périphérique contrôlé.
state_on
(Chaîne, facultatif) La charge utile qui, si elle est reçue avec le state_topic, suppose que le commutateur est activé. Si non spécifié, la valeur par défaut est "ON».
state_off(Chaîne, facultatif) La charge utile qui, si elle est reçue avec le state_topic, suppose que l’interrupteur est éteint. Si non spécifié, la valeur par défaut est "OFF».
availability_topic
(Chaîne, facultatif) Sujet MQTT auquel vous souhaitez vous inscrire pour obtenir le statut en ligne / hors ligne par le périphérique contrôlé. Habituellement, le sujet est utilisé LWT.
payload_available(Chaîne, facultatif) La charge utile qui, si elle est reçue avec le availability_topic, suppose que le commutateur est en service. Si non spécifié, la valeur par défaut est "Magasinez». Habituellement, la charge utile est utilisée LWT.
payload_not_available(Chaîne, facultatif) La charge utile qui, si elle est reçue avec le availability_topic, suppose que le commutateur est hors service. Si non spécifié, la valeur par défaut est "Offline». Habituellement, le sujet est utilisé LWT.
optimistic(Boolean, facultatif) Indique explicitement si le commutateur fonctionne en mode. optimiste ou pas. La valeur par défaut est true en l'absence de state_topicsinon c'est false.
qos(entier, facultatif) - Le niveau de QoS pour l'état_topic. Valeur par défaut: 0 (Qu'est-ce que la QoS?)
conserver(Boolean, facultatif) Définir ou non conserver. Défaut: false
json_attribues_topic(Chaîne, facultatif) Rubrique MQTT à laquelle s'abonner pour recevoir une charge JSON et définir un capteur relatif.
device(Carte, facultatif) Indique tout détail relatif au périphérique. Cela ne fonctionne que via MQTT Discovery. Plus d'infos sur la page de détail de la plateforme sur le site Home Assistant.
UTILISATION DE GABARITS

Dans chacun "* _state_topic"Peut être défini comme un modèle pour l'extraction (analyse) des données d'état. Il peut également être défini un pour tous, en utilisant le propropriété "value_template». Cela se traduit par un grand confort surtout quand il y a des charges écrites en Notation JSON.

Exemple de configuration

Vous trouverez ci-dessous une configuration légèrement plus riche que la base:

switch:
  - platform: mqtt
    name: "Interruttore Sonoff"
    state_topic: "stat/Sonoff/RESULT"
    command_topic: "cmnd/Sonoff/POWER"
    availability_topic: "tele/Sonoff/LWT"
    payload_on: "ON"
    payload_off: "OFF"
    state_on: "ON"
    state_off: "OFF"
    optimistic: false
    qos: 1
    retain: false
ESPEasy

Si des appareils dotés du micrologiciel ESPEASY sont utilisés, la configuration ad hoc est décrit ici.

guide

Un guide d'implémentation pour cette plateforme est disponible ici.

Ajouter un commutateur MQTT à la configuration Home Assistant


Home Assistant Logo officielATTENZIONE: rappelez-vous qu'il y a sur notre communauté FORUM une section ad hoc dédiée à Home Assistantpour tout doute, question, information sur le mérite spécifique de ces composants.


Veuillez commenter ci-dessous