Contador Modbus TCP en Home Assistant: guía de configuración

Integrar un medidor de energía Modbus TCP en Home Assistant

Modbus TCP es una de las formas más rápidas de conectar un medidor de energía a Home Assistant. Funciona a través de la red local, no depende de una conexión a Internet y resulta adecuado para monitorizar la potencia en tiempo real, automatizar el excedente solar, controlar cargas y utilizar el Energy Dashboard de Home Assistant.

Todos los medidores de energía IAMMETER actuales admiten Modbus TCP. Se pueden integrar con Home Assistant de dos maneras:

Integración IAMMETER HACS Modbus — configuración desde la interfaz, creación automática de entidades e intervalo de sondeo configurable.
Integración Modbus incorporada en Home Assistant — configuración YAML con control directo sobre registros y sensores.

Esta guía explica las diferencias y ayuda a configurar el método adecuado.

¿HACS Modbus o la integración Modbus de Home Assistant?

Ambos métodos leen los mismos datos Modbus TCP locales del medidor. La principal diferencia es cómo se configuran las entidades de Home Assistant.

Función	IAMMETER HACS Modbus	Modbus incorporado en Home Assistant
Configuración en Home Assistant	Interfaz de usuario	YAML
Configuración de registros	Creada por la integración	Definida manualmente
Intervalo de sondeo	Configurable; 3 segundos de forma predeterminada	Configurable por sensor
Metadatos del Energy Dashboard	Incluidos para las entidades de energía compatibles	Deben configurarse en YAML
Detección automática/asistida	Configuración asistida por SSDP	No
Funcionamiento local	Sí	Sí
Puede seguir utilizando IAMMETER Cloud	Sí	Sí
Recomendado para	La mayoría de usuarios de Home Assistant	Usuarios avanzados y registros personalizados

Para la mayoría de usuarios, la integración HACS Modbus es la opción más sencilla. Utilice la integración Modbus incorporada en Home Assistant si necesita una lista de registros personalizada, un esquema propio para nombrar entidades, una regla de escalado o un intervalo de sondeo distinto para cada sensor.

Si no necesita actualizaciones rápidas, compare las alternativas HTTP y MQTT en la descripción general de las integraciones de medidores de energía con Home Assistant.

Antes de empezar

Necesita:

un medidor de energía IAMMETER conectado a la misma LAN que Home Assistant;
la dirección IP local del medidor;
acceso al puerto TCP 502 entre Home Assistant y el medidor;
una versión reciente del firmware del medidor;
HACS instalado si elige la integración IAMMETER HACS.

Es aconsejable reservar la dirección IP del medidor en el router. Un cambio en la dirección DHCP es una causa habitual de que una integración Modbus que funcionaba deje de estar disponible más adelante.

Método 1: configurar IAMMETER Modbus mediante HACS

La integración IAMMETER HACS Modbus está diseñada para quienes desean obtener datos locales rápidos sin definir manualmente cada registro en YAML.

Paso 1: instalar la integración

Abra HACS en Home Assistant.
Busque IamMeter Modbus.
Instale la versión más reciente.
Reinicie Home Assistant si se le solicita.

Información del proyecto y sus versiones:

Utilice la última versión disponible. La integración actualizada admite el ajuste del intervalo de sondeo y lo transmite al DataUpdateCoordinator.

Paso 2: añadir el medidor en Home Assistant

Vaya a Ajustes → Dispositivos y servicios.
Seleccione Añadir integración.
Busque IamMeter Modbus.
Introduzca la dirección IP del medidor y el puerto Modbus TCP.
Seleccione el tipo de medidor o la configuración de fases apropiada.
Defina el intervalo de sondeo o mantenga el valor predeterminado de 3 segundos.
Envíe el formulario y confirme que se hayan creado el dispositivo y las entidades.

La integración crea un número diferente de entidades para los medidores monofásicos, de dos canales y trifásicos. Una lista más corta de entidades no significa que un modelo monofásico tenga compatibilidad limitada con Home Assistant.

Paso 3: comprobar las entidades

Abra el dispositivo IAMMETER en Ajustes → Dispositivos y servicios. Según el modelo, las entidades disponibles pueden incluir:

tensión;
corriente;
potencia activa;
factor de potencia;
energía importada;
energía exportada;
potencia reactiva o energía reactiva cuando el medidor y el conjunto de registros correspondiente las proporcionen.

Las entidades de energía importada y exportada utilizan kWh e incluyen los metadatos de energía de Home Assistant que necesita el Energy Dashboard.

Paso 4: elegir un intervalo de sondeo adecuado

El intervalo de sondeo predeterminado es de 3 segundos. Es un punto de partida práctico para paneles en tiempo real y automatizaciones basadas en la potencia.

Valores iniciales recomendados:

Aplicación	Intervalo de sondeo sugerido
Control de relés o excedente solar en tiempo real	1–5 segundos
Panel de potencia en tiempo real	3–10 segundos
Monitorización general de energía	10–30 segundos

Un ajuste de un segundo es una solicitud de sondeo, no garantiza que todos los paneles de Home Assistant se actualicen visiblemente una vez por segundo. La latencia de la red, el número de registros, la carga del recorder y el comportamiento de actualización de la interfaz también afectan al resultado.

Evite un sondeo innecesariamente agresivo. Para la mayoría de las automatizaciones, una actualización estable cada 2–5 segundos resulta más útil que el intervalo más corto posible.

Método 2: utilizar la integración Modbus incorporada en Home Assistant

Home Assistant incluye una integración Modbus estándar. Este método funciona totalmente en local y no necesita HACS, pero la conexión y los sensores se definen en YAML.

El siguiente ejemplo lee la tensión y la potencia activa de un medidor monofásico:

modbus:
  - name: iammeter_hub
    type: tcp
    host: 192.168.1.6
    port: 502
    sensors:
      - name: IAMMETER Voltage
        slave: 1
        address: 0
        input_type: holding
        data_type: uint16
        scale: 0.01
        precision: 1
        unit_of_measurement: V
        device_class: voltage
        state_class: measurement
        scan_interval: 5

      - name: IAMMETER Active Power
        slave: 1
        address: 2
        input_type: holding
        data_type: int32
        unit_of_measurement: W
        device_class: power
        state_class: measurement
        scan_interval: 5

Sustituya 192.168.1.6 por la dirección IP real del medidor. Consulte el mapa de registros correspondiente antes de añadir más sensores:

Registros Modbus habituales de IAMMETER

Las siguientes direcciones muestran los bloques de fase estándar utilizados por los medidores IAMMETER más comunes. Utilice siempre la documentación vigente de los registros como referencia principal.

Medición	Fase A / monofásica	Fase B	Fase C	Tipo de datos
Tensión	0	10	20	`uint16`
Corriente	1	11	21	`uint16`
Potencia activa	2	12	22	`int32`
Energía importada	4	14	24	`uint32`
Energía exportada	6	16	26	`uint32`

Utilice la escala, la precisión y el orden de palabras documentados para cada registro. No deduzca el escalado de la energía a partir del ejemplo de tensión.

Después de editar el archivo YAML:

ejecute la comprobación de configuración de Home Assistant;
reinicie Home Assistant;
abra Herramientas para desarrolladores → Estados;
confirme que las nuevas entidades muestran valores y unidades razonables.

Añadir la energía importada y exportada al Energy Dashboard

El Energy Dashboard de Home Assistant necesita entidades de energía acumulada, no potencia instantánea.

Para un sensor de energía Modbus configurado manualmente, incluya los metadatos apropiados:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

A continuación, vaya a Ajustes → Paneles → Energía y seleccione la entidad de energía importada como consumo de la red y la entidad de energía exportada como retorno a la red.

No seleccione una entidad de potencia activa medida en vatios para un campo de energía del Energy Dashboard. La potencia muestra el valor instantáneo; los kWh importados/exportados registran la energía acumulada.

Modelos IAMMETER compatibles

Todos los medidores de energía IAMMETER actuales admiten tanto HACS Modbus como la integración Modbus incorporada en Home Assistant.

Modelo	Configuración del medidor	Nota para Home Assistant
WEM3080	Monofásico	Conjunto de entidades monofásicas
WEM2067	Dos canales para aplicaciones monofásicas	Dos canales de medición
WEM3080T	Trifásico	Tres fases/grupos de entidades
WEM3050T	Trifásico o split-phase	Tres canales de medición
WEM3080TD	Trifásico de tres hilos y cableados especiales	Interpretar las entidades según el modo de cableado
WEM3046T / WEM3046TE	Entrada de TC externo de 5 A	Aplicar la relación del TC externo

WEM3046T y WEM3046TE miden la salida secundaria de 5 A de un transformador de corriente externo. Para obtener la corriente, la potencia y la energía reales del lado primario, debe aplicarse la relación de TC correcta. Esta es una característica del sistema de medición con TC de 5 A, no una limitación de compatibilidad con Home Assistant o Modbus.

¿Pueden funcionar Modbus e IAMMETER Cloud al mismo tiempo?

Sí. Home Assistant lee Modbus TCP localmente mientras el medidor puede seguir enviando datos a IAMMETER Cloud. No es necesario cambiar el medidor al modo de envío MQTT para utilizar Modbus.

De este modo se obtienen dos perspectivas complementarias:

datos locales rápidos y automatizaciones en Home Assistant;
informes a largo plazo, análisis del coste de la electricidad, análisis solar y acceso remoto en IAMMETER Cloud.

Evitar varios clientes Modbus de alta frecuencia

Como modelo de instalación seguro, utilice un solo cliente de sondeo Modbus TCP activo por medidor. No configure Home Assistant, Node-RED, un PLC y otro registrador para que consulten de forma independiente el mismo medidor con alta frecuencia.

Si varios sistemas necesitan las mismas mediciones en tiempo real, permita que un único sistema lea Modbus y redistribuya los datos, o utilice una arquitectura MQTT en la que varios consumidores se suscriban a un broker.

Solución de problemas

Home Assistant no puede conectarse al puerto 502

Confirme que Home Assistant y el medidor están en la misma red accesible.
Verifique la dirección IP del medidor y resérvela en el router.
Compruebe que el puerto TCP 502 no esté bloqueado por un firewall o una regla de VLAN.
Asegúrese de que otro cliente Modbus no mantiene abierta la conexión ni la vuelve a abrir continuamente.

Las entidades no están disponibles o los valores no cambian

Confirme el tipo de medidor/fase seleccionado en la integración HACS.
Con YAML, verifique el ID del esclavo, la dirección del registro, el tipo de datos, la escala y el orden de palabras.
Aumente temporalmente el intervalo de sondeo para descartar un sondeo demasiado agresivo.
Reinicie la integración después de cambiar la dirección IP del medidor.

Los valores son inverosímilmente altos o bajos

Compruebe el escalado del registro y el tipo de datos.
Para WEM3046T/WEM3046TE, verifique la relación del TC externo.
Confirme que la entidad corresponde a la fase o al canal de medición esperado.

Las entidades de energía no aparecen en el Energy Dashboard

Utilice la energía importada/exportada acumulada en kWh.
Confirme device_class: energy.
Confirme state_class: total_increasing.
No utilice una entidad de potencia en vatios.

Crear automatizaciones con datos de potencia en tiempo real

Cuando las entidades Modbus estén operativas, Home Assistant podrá utilizar la potencia activa o la potencia exportada a la red para controlar otros dispositivos. Algunos ejemplos:

controlar un relé con los datos de potencia Modbus en tiempo real;
cargar un vehículo eléctrico cuando la exportación solar supere un umbral;
calentar agua con el excedente solar disponible;
avisar al usuario cuando la demanda del hogar supere un límite;
reducir una carga controlable antes de importar electricidad cara en horario punta.

Mantenga la guía de integración centrada primero en establecer datos fiables. Añada la lógica de control solo después de comprobar la convención de signos, las unidades, el intervalo de actualización y el comportamiento cuando el medidor deje de estar disponible.