Cómo integrar un inversor solar Enphase en Home Assistant con la API local: Guía paso a paso

La monitorización solar se ha convertido en una pieza clave para maximizar el rendimiento de las instalaciones fotovoltaicas. En este artículo, te guiaremos paso a paso para integrar tu inversor solar Enphase con Home Assistant utilizando la API local, una solución que te permite acceder a datos en tiempo real sin depender de la nube. Aprenderás desde los requisitos previos hasta la creación de automatizaciones avanzadas, pasando por la configuración del flujo de energía y la resolución de problemas comunes. Si buscas un control total sobre tu producción solar, esta guía es para ti.

Introducción a la integración de Enphase con Home Assistant

La integración de sistemas de energía solar con plataformas de domótica como Home Assistant ha ganado una popularidad enorme en los últimos años. Los propietarios de instalaciones fotovoltaicas buscan cada vez más independencia de las aplicaciones propietarias y desean tener todos sus datos energéticos centralizados en un solo lugar. En este contexto, Enphase Energy, uno de los fabricantes líderes en microinversores, ofrece una API local que permite acceder a los datos de producción y consumo de manera directa, sin necesidad de pasar por sus servidores en la nube.

Home Assistant, por su parte, es un sistema de automatización del hogar de código abierto que se ha convertido en el estándar de facto para la domótica local. Su capacidad para integrar cientos de dispositivos y servicios lo convierte en la plataforma ideal para centralizar la monitorización de tu sistema solar. Al combinar la API local de Enphase con Home Assistant, obtienes una solución robusta, rápida y privada que te permite tomar decisiones informadas sobre tu consumo energético.

En esta guía, te explicaremos en detalle cómo llevar a cabo esta integración, desde la preparación del hardware y software hasta la configuración avanzada de sensores y automatizaciones. No importa si eres un principiante en Home Assistant o un usuario experimentado; aquí encontrarás toda la información necesaria para sacar el máximo partido a tu inversor Enphase.

Requisitos previos para la integración

Antes de comenzar con la integración, es fundamental asegurarse de que disponemos de todos los elementos necesarios. La API local de Enphase requiere que el sistema esté configurado en modo local, lo que implica tener un dispositivo de puerta de enlace (Envoy) actualizado y accesible en nuestra red local. A continuación, detallamos los requisitos técnicos y de software imprescindibles.

Hardware necesario

El componente principal es el Envoy-S o Envoy-S Standard, que es la puerta de enlace que Enphase instala junto con los microinversores. Este dispositivo se conecta a tu router mediante cable Ethernet o Wi-Fi, y es el que se comunica con los microinversores para recopilar los datos de producción. Para acceder a la API local, necesitas conocer su dirección IP dentro de tu red. También es recomendable tener un ordenador o dispositivo donde esté instalado Home Assistant, ya sea en una Raspberry Pi, un servidor NAS o una máquina virtual.

Software y herramientas

En cuanto al software, necesitarás tener Home Assistant instalado y funcionando. Si aún no lo tienes, puedes instalarlo en una Raspberry Pi con el sistema operativo Home Assistant OS, o en cualquier otro sistema compatible. Además, es recomendable tener acceso a la línea de comandos o a la interfaz web de Home Assistant para poder editar los archivos de configuración.

También necesitarás conocer las credenciales de acceso al Envoy. Por defecto, el acceso local se realiza mediante un token de autenticación que se genera en la aplicación Enphase Enlighten. Este token se utiliza para autenticar las solicitudes a la API local. Aprenderemos a obtenerlo en la siguiente sección.

Configuración de la API local de Enphase

La API local de Enphase es una interfaz RESTful que expone datos como la producción actual, el consumo del hogar, el estado de los microinversores y la energía acumulada. Para utilizarla, primero debemos habilitarla en el Envoy y obtener un token de acceso.

Paso 1: Habilitar la API local en el Envoy

Para habilitar la API local, debes acceder a la interfaz web del Envoy. Abre tu navegador e introduce la dirección IP del Envoy (por ejemplo, http://192.168.1.100). Se te pedirá que inicies sesión con las credenciales de instalador (usuario y contraseña que suelen estar en la etiqueta del dispositivo). Una vez dentro, busca la sección de 'Configuración' o 'Ajustes' y localiza la opción 'API local' o 'Acceso local'. Actívala y guarda los cambios.

En algunos modelos, es posible que necesites generar un token de acceso desde la aplicación Enphase Enlighten. Para ello, inicia sesión en la aplicación, ve a 'Configuración' y busca la opción 'Acceso local'. Ahí podrás generar un token que deberás copiar y guardar de forma segura.

Paso 2: Obtener el token de autenticación

El token de autenticación es una cadena alfanumérica que se utiliza en las cabeceras de las solicitudes HTTP. Para obtenerlo, puedes seguir estos pasos:

• A través de la aplicación Enlighten: Inicia sesión en la aplicación móvil o web de Enphase Enlighten. Ve a 'Configuración' y busca la sección 'Acceso local'. Genera un nuevo token y cópialo.
• Mediante la interfaz web del Envoy: Si tu Envoy tiene la opción de generar token en su interfaz, puedes hacerlo directamente. Busca la sección de 'API' o 'Seguridad' y sigue las instrucciones.

Paso 3: Probar la API local

Antes de integrar con Home Assistant, es recomendable probar que la API funciona correctamente. Puedes hacerlo utilizando herramientas como cURL o Postman. Por ejemplo, para obtener la producción actual, puedes ejecutar el siguiente comando en tu terminal:

curl -X GET "http:///api/v1/production" -H "Authorization: Bearer "

Si todo está correcto, recibirás una respuesta JSON con los datos de producción. Si obtienes un error, verifica la dirección IP, el token y que la API local esté habilitada.

Integración con Home Assistant

Una vez que la API local funciona, podemos proceder a integrarla con Home Assistant. Existen varias formas de hacerlo: mediante la integración oficial de Enphase (si está disponible), mediante integraciones personalizadas de la comunidad, o creando sensores REST manualmente. En esta guía, nos centraremos en la integración oficial y en la configuración manual con RESTful, ya que son las más fiables y fáciles de mantener.

Opción A: Usar la integración oficial de Enphase (si está disponible)

Home Assistant cuenta con una integración oficial para Enphase que utiliza la API local. Para instalarla, sigue estos pasos:

1. 1
   Ve a 'Configuración' > 'Dispositivos y servicios' en Home Assistant.
2. 2
   Haz clic en 'Agregar integración' y busca 'Enphase Envoy'.
3. 3
   Introduce la dirección IP del Envoy y el token de acceso.
4. 4
   La integración detectará automáticamente los sensores disponibles y los añadirá a tu sistema.

Esta integración crea sensores para la producción actual, la energía producida hoy, el consumo del hogar, el estado de cada microinversor, entre otros. Es la forma más sencilla y recomendada para la mayoría de los usuarios.

Opción B: Configuración manual con sensores RESTful

Si prefieres un control total o la integración oficial no está disponible, puedes crear sensores RESTful manualmente en tu archivo configuration.yaml. Esta opción te permite personalizar qué datos quieres monitorizar y cómo se muestran. A continuación, te mostramos un ejemplo de configuración para obtener la producción actual y la energía diaria.

sensor:
  - platform: rest
    name: "Producción Solar Actual"
    resource: http://192.168.1.100/api/v1/production
    method: GET
    headers:
      Authorization: Bearer TU_TOKEN
    value_template: "{{ value_json.wattsNow }}"
    unit_of_measurement: "W"
    device_class: power
    scan_interval: 60

  - platform: rest
    name: "Energía Producida Hoy"
    resource: http://192.168.1.100/api/v1/production
    method: GET
    headers:
      Authorization: Bearer TU_TOKEN
    value_template: "{{ value_json.wattHoursToday }}"
    unit_of_measurement: "Wh"
    device_class: energy
    scan_interval: 300

Sensores y entidades disponibles en la API

La API local de Enphase expone una gran cantidad de datos. A continuación, presentamos una tabla comparativa con los endpoints más útiles y los sensores que se pueden crear a partir de ellos.

Con estos endpoints, puedes crear sensores para monitorizar cada aspecto de tu sistema solar. Por ejemplo, puedes crear un sensor para la producción total de por vida, o para el consumo instantáneo del hogar.

Creación de tarjetas y visualización en el dashboard

Una vez que los sensores están configurados, es hora de visualizarlos en tu dashboard de Home Assistant. Puedes crear tarjetas personalizadas con Lovelace para mostrar los datos de forma clara y atractiva. A continuación, te mostramos un ejemplo de una tarjeta de entidad simple para mostrar la producción actual.

type: entities
entities:
  - entity: sensor.produccion_solar_actual
    name: Producción Actual
  - entity: sensor.energia_producida_hoy
    name: Energía Hoy
  - entity: sensor.consumo_hogar_actual
    name: Consumo Actual

También puedes utilizar tarjetas más avanzadas, como la tarjeta de energía (Energy Dashboard) que integra datos de producción y consumo para mostrar un balance energético. Para ello, ve a 'Energía' en el panel lateral y configura los sensores de producción y consumo.

Automatizaciones basadas en datos solares

Uno de los mayores beneficios de integrar Enphase con Home Assistant es la posibilidad de crear automatizaciones inteligentes. Por ejemplo, puedes programar el encendido de electrodomésticos cuando la producción solar supere un umbral, o activar un sistema de almacenamiento de energía cuando el consumo sea bajo. A continuación, presentamos algunas ideas de automatizaciones.

Automatización para activar un cargador de vehículo eléctrico

Imagina que tienes un vehículo eléctrico y quieres cargarlo solo cuando tu producción solar sea suficiente. Puedes crear una automatización que active el cargador cuando la producción actual supere los 3000 W y se desactive cuando baje de 2000 W.

automation:
  - alias: "Cargar coche con excedente solar"
    trigger:
      - platform: numeric_state
        entity_id: sensor.produccion_solar_actual
        above: 3000
    condition:
      - condition: state
        entity_id: switch.cargador_coche
        state: 'off'
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.cargador_coche
  - alias: "Parar carga cuando no hay excedente"
    trigger:
      - platform: numeric_state
        entity_id: sensor.produccion_solar_actual
        below: 2000
    condition:
      - condition: state
        entity_id: switch.cargador_coche
        state: 'on'
    action:
      - service: switch.turn_off
        target:
          entity_id: switch.cargador_coche

Automatización para controlar un termo eléctrico

Otra opción es calentar el agua del termo eléctrico durante las horas de máxima producción solar. Puedes programar una automatización que encienda el termo cuando la producción supere un valor y lo apague cuando caiga.

Solución de problemas comunes

A pesar de que la integración es sencilla, pueden surgir problemas. A continuación, presentamos los errores más comunes y cómo solucionarlos.

Preguntas frecuentes

Conclusiones y plan de acción recomendado

Integrar tu inversor solar Enphase con Home Assistant mediante la API local es una excelente manera de obtener control total sobre tu sistema de energía. No solo te permite monitorizar la producción y el consumo en tiempo real, sino que también te habilita para crear automatizaciones inteligentes que optimizan tu autoconsumo y reducen tus costes energéticos.

El proceso, aunque requiere ciertos pasos técnicos, es accesible para cualquier usuario con conocimientos básicos de configuración. La integración oficial simplifica enormemente la tarea, mientras que la configuración manual ofrece una flexibilidad adicional para los más avanzados.

Con esta guía, ya tienes todos los conocimientos necesarios para llevar a cabo la integración. No dudes en explorar la documentación oficial de Enphase y de Home Assistant para profundizar en aspectos específicos. ¡Disfruta de tu energía solar monitorizada al máximo!