Integración custom

El presente documento tiene como objetivo servir de guía de usuario para la puesta en funcionamiento de la integración custom Viaris EV charger, cuya finalidad es la de monitorizar a través de Home Assistant medidas, estados y configuraciones propias de los cargadores modelo UNI y COMBIPLUS. Para ello se sirve del protocolo de comunicaciones mqtt.

1. Requisitos previos.

Para poner en funcionamiento la integración viaris hemos de realizar las siguientes instalaciones previas:

• Home Assistant Home Assistant es un asistente de hogar que 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/
• HACS Una vez se tiene en marcha Home Assistant se procederá a la instalación de HACS (Home Assistant Community Store). Para ello se seguirán los pasos de download and configuration que se detallan en su página oficial https://hacs.xyz/docs/setup/download
• Broker Mqtt Desde Home Assistant, necesitaremos instalar la integración MQTT para ello iremos a Ajustes/dispositivos y Servicios Posteriormente pulsamos añadir integración Finalmente se configura la integración MQTT con las credenciales del servidor broker al que tenemos conectado nuestro cargador Viaris. Dichas credenciales deberán coincidir con las que podemos visualizar en la web del cargador en la sección Servidor MQTT del menú comunicaciones.

2. Instalación integración Viaris EV charger.

Para la instalación de la integración nos posicionaremos desde Home Assistant en HACS/Integraciones

Posteriormente tenemos que pulsar los tres puntos de la esquina superior derecha e ir a repositorios personalizados.

En repositorios personalizados, tendremos que introducir la url del repositorio https://github.com/orbis-developers/home_assistant_viaris , así como la categoría, que en nuestro caso es una integración.

Pulsamos añadir y veremos nuestro repositorio.

Al pulsar en el nuevo repositorio viaris que aparece en verde, nos introduce en una página de información general de la integración , donde se nos da la opción de descargar dicha integración.

Al pulsar descargar se mostrará una alerta, donde se nos indica la localización de la descarga y que es necesario reiniciar Home Assistant.

Descargamos y para reiniciar Home Assistant vamos a Herramientas para desarrolladores y pulsamos verificar y posteriormente reiniciar.

Otra forma para la descarga de la integración se podría hacer pulsando explorar y descargar repositorios. Así también llegaríamos a la página de información general de la integración donde podemos descargarla, siempre y cuando lo hayamos hecho alguna vez por el método anterior y por ejemplo se hubiera dado el caso de que la hayamos borrado de nuestro panel de integraciones HACS y la queramos restablecer.

El sistema también ofrece la posibilidad de alertarnos cuando haya disponible una actualización de la integración.

Una vez descargada la integración, ya puede ser activada en Home Assistant, desde Ajustes/Dispositivos y Servicios

Posteriormente se nos pedirá el número de serie del cargador que queremos monitorizar:

Introducimos el número de serie y pulsamos ENVIAR.

Después se nos pedirá si lo queremos introducir en algún área:

Al pulsar TERMINAR se nos quedará activada la integración

Posteriormente, reiniciamos Home Assistant.

También se tiene la posibilidad de activar la integración por descubrimiento de dispositivos, siempre y cuando no tengamos ningún equipo configurado, reiniciemos Home Assistant y posteriormente los cargadores asociados:

En este caso pulsaremos en configurar para añadir los dispositivos, se nos preguntará si queremos activar la integración del cargador descubierto:

Al pulsar en enviar nos saldrá un cuadro de diálogo donde podremos elegir el área que queremos. Finalmente pulsamos Terminar.

De esta forma conseguimos que se active la integración con los cargadores descubiertos.

Tras configurar los tres equipos de ejemplo descubiertos, reiniciamos Home Assistant de la misma forma que indicamos anteriormente.

Si nos vamos a dispositivos podremos ver uno asociado a cada cargador que tengamos conectado:

Y en entidades se nos mostrará todas las asociadas a cada cargador, identificadas con su número de serie y un nombre relacionado con su funcionalidad.

En integraciones pulsando en Viaris EV charger podemos ver los dispositivos asociados, descubiertos o introducir uno nuevo.

Si pulsamos donde se nos indica el número de dispositivos y entidades de la integración, en nuestro caso1 dispositivo y 53 entidades, tendremos la siguiente información, donde aparecen el registro y cambios de entidades:

El usuario también tiene la posibilidad de generarse su dashboard yendo a Ajustes/Paneles de control y añadiendo su propio panel de control.

El sistema permite monitorizar diferentes medidas y parámetros de configuración, así como ejecutar diferentes acciones:

• Start/Stop de la carga

Mediante las entidades start connector 1 charging y start connector 2 charging se puede gobernar este comportamiento, En el ejemplo se ve como se ha activado la carga en el conector 1 y se ha parado en el 2.

• Ajuste de la corriente del conector.

Para ello se utilizaran las entidades Current limit connector 1 y 2

La corriente máxima que se puede ajustar son 32A,. Este ajuste será efectivo dependiendo de la configuración del cargador, podría estar limitado incluso a un valor menor.

En el momento en el que el cargador se reinicie perderá dicho ajuste.

• Programación parámetros trama RT.

Esta trama nos permite enviar al cargador con qué frecuencia vuelca los datos de medidas y otros parámetros. Para ello se le programará el period (entidad Rt frame period) en segundos. Un segundo parámetro timeout (entidad Rt frame period) servirá para indicar cuanto tiempo estará activo dicho volcado. En el caso de que se programe timeout = -1 estará de forma permanente.

Para enviar la configuración al cargador se pulsará Send rt config.

Dentro del panel, el usuario puede editarlo y añadir tarjetas que muestren las entidades que quiera controlar:

Un ejemplo de distribución de dashboard puede ser el siguiente: