Agregue un conmutador MQTT a la configuración Home Assistant

4 minutos de lectura
OBJETIVOS DE LA GUÍA
  • Agregue un modificador MQTT a la configuración de Home Assistant
  • Nivel de dificultad: basso
CONCEPTOS ENFRENTADOS:
  • Instalación y configuración de software.
COMPONENTES DE SOFTWARE UTILIZADOS:
Requisitos previos
DISPOSITIVOS FÍSICOS UTILIZADOS:
  • El dispositivo en el que reside Home Assistant
  • Un interruptor inteligente que ofrece una interfaz MQTT
GUÍA más indicada para:

Todos los ambientes

Notas y descargo de responsabilidad
  • qualsiasi modifica all'impianto elettrico dev'essere effettuata da personale qualificato;
  • cualquier cambio implementado en proantes es un proresponsabilidad personal, así como un proprimer riesgo y peligro (esta guía es solo para fines educativos);
  • cualquier cambio implementado en proantes de que un dispositivo anule la garantía.
Revisión de manejo: +1.4

Abstract

Home Assistant proporciona soporte nativo desde las primeras versiones al proTocollo MQTT a través de un componente llamado, para elappungido "MQTT". Si tienes un interruptor inteligente equipado con soporte MQTT (por ejemplo, a Sonoff riproprogramado Sonoff-Tasmota), es posible integrar el control de una manera muy simple en Home Assistant.

En esta página veremos cómo hacerlo usando el componente "Switch"de Home Assistant, específicamente la plataforma (subcomponente) "MQTT Switch".

Para que la configuración haga eso appnos quedamos por realizar funciones, es necesario que el componente MQTT di Home Assistant ya está configurado Recomendamos leer esto de este orientar.


Le recomendamos encarecidamente que lea la siguiente guía antes de revisar esta guía:

Cómo agregar interruptores y sensores Sonoff a Home Assistant

instalación

No es necesario instalar nada: solo agregue a la configuración de Home Assistant la entrada para el conmutador que desea agregar.

NB Para usar esta plataforma es necesario que el componente "MQTT" de Home Assistant ha sido configurado previamente (ver primera parte de la tarjeta dedicada al componente "MQTT"). También recomendamos leer con cuidado la guía dedicada al tema de configuración de los componentes MQTT en el proprimera domótica.

Configuración

Entonces, veamos cómo hacerlo.
El conjunto minimalista configuración para agregar al archivo "configuration.yaml"de Home Assistant es el siguiente:

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

Una vez guardada la configuración y relanzada / actualizada Home Assistant, appaparecerá un nuevo interruptor (como en la configuración de ejemplo):

Home Assistant Switch

Variables de configuración:

name

(cadena)(Opcional) El nombre para atribuir al conmutador
Valor predeterminado: MQTT Switch

icon

(cadena)(Opcional) Cambiar icono (p. Ej. MDI: Radiador).

state_topic
(cadena)(Obligatorio) El tema MQTT ser firmado por Home Assistant para recibir el estado del interruptor (activar / desactivar). Obviamente, el tema del estado cambia según a la configuración MQTT del dispositivo.
command_topic(cadena)(requerido) El tema MQTT que publicará Home Assistant para cambiar el estado del interruptor. Obviamente, el tema del comando cambia según a la configuración MQTT del dispositivo.
availability_topic(cadena)(Opcional) El tema MQTT ser firmado por Home Assistant para recibir el estado (en línea / fuera de línea) del conmutador. Obviamente, el tema de disponibilidad cambia según a la configuración MQTT del dispositivo. Usualmente se usa el tema Lwt.
payload_on

(cadena)(Opcional) La carga útil que rappmuestra el acceso (enviado junto con command_topic).
Valor predeterminado: verdadero

payload_off

(cadena)(Opcional) La carga útil que rapprestablece el apagado (enviado junto con command_topic).
Valor predeterminado: falso

payload_available

(cadena)(Opcional) La carga útil que interpreta el estado como "en línea"
Valor predeterminado: "Online". Usualmente se usa la carga útil Lwt.

payload_not_available

(cadena)(Opcional) La carga útil que interpreta el estado como "sin conexión"
Valor predeterminado: "Offline". Usualmente se usa la carga útil Lwt.

optimistic

(Boole)(Opcional) Indicador que define si el conmutador funciona en modo optimista
Valor predeterminado: verdadero si no state_topic está definido, de lo contrario false.

qos

(entero) (Opcional) Indica la calidad de servicio que se utilizará. Valor predeterminado: 0 (¿Qué es la calidad del servicio?)

retain

(Booleano) (Opcional) Indica si los mensajes MQTT publicados para este conmutador deben usar retener.
Valor predeterminado: falso

value_template

(string) (Oational) Define si usar o no una plantilla para extraer un cierto valor en la carga útil de estado

A la luz de estos parámetros, un interruptor de tipo appestán en la configuración de la siguiente manera:

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
NOTA

Es posible integrar el mismo tipo de configuración no solo para presentar Home Assistant de los interruptores pero también de las luces. Consideremos el caso en el que está utilizando un Sonoff Basic (modificado Tasmota) como un interruptor en una lámpara de noche: en la domótica definida en Home Assistant nos gustaría ese cambio appcomo un punto de luz, en lugar de como un interruptor. El bloque de configuración será el mismo que el descrito anteriormente, pero se indica en "ligero:":

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

Censo de estado al inicio de Home Assistant

Al comienzo de Home Assistant ese ambiente no conoce el estado de los conmutadores MQTT posiblemente incluido en la configuración. Para garantizar que este estado se detecte de inmediato (y no después de unos minutos, con el otronameinterruptor automático por parte de los diversos interruptores) es necesario insertar en la configuración un automatismo que publique en el intermediario un tema de comando al interruptor (s) a actualizar que da como resultado una telemetría:

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

Debajo del bloque "action:"Será posible indicar qué temas MQTT se deben indicar (en este caso" cmnd / Fan / POWER ") para forzar una respuesta de los componentes MQTT para obtener el estado.

Cómo agregar interruptores y sensores Sonoff a Home Assistant


ITEAD Sonoff BasicATTENZIONE: recuerda que hay en nuestra comunidad FORO una sección ad hoc dedicada a Sonoff (y más generalmente a dispositivos ESP8266), para cualquier duda, pregunta, información en el mérito específico de estos componentes.


Por favor comente abajo