Integración del sensor con Home Assistant

La integración del sensor de nivel Senvolon en Home Assistant se realiza mediante MQTT. A partir de la versión de firmware 3.8, el sensor admite MQTT Discovery, con lo que Home Assistant detecta e incorpora automáticamente los valores del sensor. En ese caso, el paso 3 de estas instrucciones no es necesario. La configuración manual sigue siendo posible. Estas instrucciones muestran todos los pasos que debe seguir en Home Assistant para recibir y mostrar los valores medidos del sensor. Si todavía está empezando, en nuestra página de resumen encontrará todo lo importante para medir y controlar el nivel de llenado de su aljibe: desde la elección del sensor adecuado hasta el montaje.

Por qué usar MQTT para el sensor de nivel

• Comunicación fiable entre el sensor y Home Assistant
• Detección automática mediante MQTT Discovery
• Actualización rápida de los valores medidos
• Ampliabilidad flexible con más sensores

Requisitos para la integración

• Sensor de nivel Senvolon a partir de la versión 3.8
• Home Assistant
• Un broker MQTT como Mosquitto
• Topic MQTT correctamente configurado en el sensor

1. Instalar el broker MQTT en Home Assistant

Si todavía no dispone de un broker MQTT:

1. Abra Configuración → Complementos
2. Vaya a la tienda de complementos
3. Instale el broker MQTT Mosquitto

2. Activar y configurar MQTT en Home Assistant

1. Vaya a Configuración → Dispositivos y servicios
2. Añada la integración MQTT
3. Realice la configuración

Nota: si Mosquitto se instaló como complemento, el broker utiliza automáticamente la dirección IP de Home Assistant. El nombre de usuario y la contraseña coinciden con sus datos de acceso de Home Assistant.

3. Ampliar configuration.yaml

Para que Home Assistant lea correctamente todos los valores del sensor, se amplía el archivo de configuración central.

Instalar el editor de archivos

1. Abra Configuración → Complementos → Tienda de complementos
2. Instale el File Editor
3. Active su visualización en la barra lateral
4. Abra el archivo configuration.yaml

Añadir los sensores MQTT

Sustituya TOPIC por el topic MQTT que haya configurado en el sensor de nivel.

mqtt:
  sensor:
    - name: "Level"
      unique_id: "LS_Level"
      state_topic: "stat/TOPIC/REL_LEVEL"
      unit_of_measurement: "%"
      icon: mdi:car-coolant-level
      device:
        identifiers: "LevelSensor"
        manufacturer: "Senvolon"
        name: "Level Sensor"
        model: "V1"

    - name: "Fluid"
      unique_id: "LS_Fluid"
      state_topic: "stat/TOPIC/FILLING"
      unit_of_measurement: "l"
      icon: mdi:water
      device:
        identifiers: "LevelSensor"
        manufacturer: "Senvolon"
        name: "Level Sensor"
        model: "V1"

    - name: "Distance"
      unique_id: "LS_Distance"
      state_topic: "stat/TOPIC/DISTANCE"
      unit_of_measurement: "cm"
      icon: mdi:waves-arrow-up
      device:
        identifiers: "LevelSensor"
        manufacturer: "Senvolon"
        name: "Level Sensor"
        model: "V1"

    - name: "Height"
      unique_id: "LS_Height"
      state_topic: "stat/TOPIC/LEVEL"
      unit_of_measurement: "cm"
      icon: mdi:waves
      device:
        identifiers: "LevelSensor"
        manufacturer: "Senvolon"
        name: "Level Sensor"
        model: "V1"

    - name: "Alert"
      unique_id: "LS_Alert"
      state_topic: "stat/TOPIC/ALERT"
      icon: mdi:alert-circle-outline
      device:
        identifiers: "LevelSensor"
        manufacturer: "Senvolon"
        name: "Level Sensor"
        model: "V1"

Comprobar la sintaxis y guardar

• Signo de exclamación rojo = error
• Marca de verificación verde = sintaxis correcta
• A continuación, guarde el archivo

4. Reiniciar Home Assistant

Recárguelo una vez mediante Herramientas de desarrollo → Reiniciar.

5. Ver el sensor de nivel en Home Assistant

Tras el reinicio, Home Assistant detecta el sensor automáticamente. Los valores se actualizan en cuanto llegan nuevos datos del sensor. En cuanto lleguen los valores medidos, en el siguiente paso podrá crear un panel del aljibe con indicador de consumo y previsión de lluvia.