Viaris Home Assistant
Los cargadores Viaris permiten la posibilidad de ser monitorizados mediante el software de automatización de tareas en dispositivos Home Assistant. De esta manera el usuario podrá controlar los estados de carga, medidas de consumo y demás parámetros relacionados con el funcionamiento del cargador. Para ello se utiliza el protocolo de comunicaciones MQTT.
Esta guía de configuración de Home Assistant para cargadores Viaris, se centra en el uso de ficheros de configuración .yaml donde se establecen los sensores a monitorizar y a través de qué topics MQTT se reciben, así como en la instalación de los add-ons necesarios para su funcionamiento.
Instalación de Home Assistant.
Home Assistant permite su instalación en diferentes sistemas como Windows, Raspberry Pi, Linux, etc. Los diferentes pasos para su realización pueden consultarse en el siguiente enlace https://www.home-assistant.io/installation/
Configuración de Home Assistant.
A continuación se detallan los pasos necesarios para su configuración. Dichos pasos pueden sufrir variaciones debidas a actualizaciones en Home Assistant.
1. Instalación mosquitto broker.
instalamos el add-ons correspondiente a mosquitto broker yendo a Ajustes/complementos/Tienda de complementos instalar.
Tras la instalación de mosquitto broker lo iniciamos
2. Creación de cuenta de usuario en mosquitto broker.
Nos posicionamos en ajustes/personas/añadir persona y programamos el campo nombre. En nuestro ejemplo se ha elegido MQTTBROKER.
Activamos la opción Permitir que la persona inicie sesión, para introducir las credenciales que queramos que tenga el servidor broker.
Tras introducir los datos pulsamos crear.
3. Instalación de la integración MQTT.
Seleccionamos ajustes/dispositivos y servicios/añadir integración y buscamos la integración MQTT.
En la integración de MQTT pulsaremos configuración/aceptar/finalizar hasta que veamos que dicha configuración ha sido creada con éxito.
4. Credenciales en integración MQTT.
Pulsaremos la opción de configurar/reconfigure-MQTT e introduciremos las credenciales de la cuenta generada en el paso 1.
Para que estos cambios se actualicen, volveremos a ajustes/complementos y reiniciaremos el mosquitto broker.
5. Instalación de File-editor
Necesitaremos este add-on para editar los ficheros .yaml de configuración.
para ello iremos a ajustes/complementos/tienda de complementos/file editor
6. Edición fichero configuration.yaml
Utilizando el add-on file editor, anteriormente instalado, procederemos a editar el fichero configuration.yaml de la carpeta config. Pulsando el icono de carpeta buscamos dicho fichero.
En este archivo agregaremos los sensores mqtt que nos proporcionaran los datos de nuestro cargador.
Para ello generaremos el fichero mqtt.yaml añadiéndolo en el directorio config
En el fichero se incluyen los campos que definen a cada sensor y que se detallan a continuación.
name: nombre que veremos en el lovelace (visor de elementos de home assistant)
unique_id: nombre para dirigirnos al sensor de forma inequívoca.
state_topic: topic donde recibimos los datos. El tercer y cuarto campos estarán asociados al número de serie del cargador, de manera que EVVC351187A00 habrá que sustituirlo con el número de serie del cargador del usuario y 087AA0 se sutituirá por 0 seguido de los cinco últimos dígitos de dicho número de serie.
unit_of_measurement: unidad de medida.
value_template: campo procedente del JSON donde se obtiene el valor o estado.
icon_template: asignamos un icono al nuevo sensor.
Este fichero se incluirá en configuration.yaml introduciendo la línea: mqtt: !include mqtt.yaml
Para poder asociar los estados numéricos del cargador a textos más descriptivos, podemos ayudarnos de los sensores virtuales, que nos permiten crear un sensor nuevo a partir de otros sensores existentes. El siguiente ejemplo nos permite a partir de los estados 14, 30 y 31 del conector schuko poder mostrar una salida más aclaratoria como schuko ON, LOAD; schuko ON, NOT LOAD y schuko OFF.
Para ello introduciremos la key sensor: en el fichero configuration.yaml junto con los campos que se detallan a continuación.
platform: template, es un sensor virtual.
sensors: Indicamos así que es un sensor.
sensor_state_conn2: Ejemplo de nombre de la entidad que vamos a generar. Es el Id.
friendly_name: Opcional. Nombre que aparecerá en el lovelace.
value_template: Se asignará un valor de salida a través de la codificación que introducimos.
icon_template: asignamos un icono al nuevo sensor.
Tras tener confeccionado nuestro fichero configuration.yaml, lo salvamos. Posteriormente en herramientas para desarrolladores verificamos configuración y si está todo correcto reiniciamos. Advertir que es importante las tabulaciones en este tipo de ficheros.
Los ficheros utilizados se adjuntan a continuación. Hay que tener en cuenta que se utilizan para el cargador de número de serie EVVC351187AA0 y el usuario deberá adaptarlos para su dispositivo.
Posteriormente veremos como se asocian las entidades a la integración MQTT.
Pulsando en entidades nos aparecerá el listado de ellas.
7. Realización del panel de monitorización.
El panel de monitorización nos permitirá con el uso de entidades y automatizaciones poder visualizar configuraciones, medidas y estados de nuestro cargador.
Para generar un panel, vamos a ajustes/paneles de control/añadir panel de control.
Una vez lo hayamos generado desde cero podremos editarlo y añadir diferentes tipos de tarjetas donde incluir entidades.
En las tarjetas podemos seleccionar cada uno de los sensores anteriormente definidos en el fichero configuration.yaml y asignarles un icono.
8. Configuración de automatizaciones.
El cargador envía algunas tramas MQTT de forma espontánea, por ejemplo ante eventos, pero existen datos en los que es necesaria una petición previa, por lo que deberemos recurrir a las automatizaciones y de esta forma Home Assistant podrá realizar dichas peticiones sin necesidad de que intervenga el usuario. Para programar automatizaciones lo haremos desde ajustes/automatizaciones y escenas/crear automatización
Empezaremos con una automatización vacía.
La programación de las automatizaciones conlleva indicar un desencadenante, condición y acción. Los desencadenantes en nuestro caso pueden ser la apertura del propio Home Assistant, periódicamente en un tiempo establecido o incluso un cambio de estado y las acciones serán la publicación de un topic que tenga como fin la petición de datos, para ello seleccionaremos llamar a un servicio.
Dentro del servicio seleccionaremos un MQTT: Publish en el que indicaremos el topic a publicar junto con su payload. También nos da opción a configurar otros parámetros como la calidad de servicio.
Automatizaciones creadas en el ejemplo:
En las siguientes capturas podemos ver un ejemplo de panel para un Viaris UNI con Home Assistant, en el cual podemos monitorizar tanto las medidas, como algunos de los parámetros de configuración del cargador.
Configuración cargador.
Para que el cargador se pueda comunicar a través del protocolo MQTT con el servidor broker que hemos configurado en Home Assistant, tendremos que introducir las credenciales de dicho broker en nuestro Viaris.
Para ello accederemos a la web del cargador y en comunicaciones/MQTT server las programaremos.
