Modbus en Home Assistant 2026.10: tutorial YAML para tu contador RS485

Fecha de publicación: 08/10/2026 · Última revisión: 08/10/2026

Qué cambia en Home Assistant 2026.10 para Modbus

Home Assistant 2026.10 estrena un panel de Conectividad en Configuración que reúne todas tus conexiones Modbus en un solo sitio. Ahí ves los puertos serie, las puertas de enlace de red y los dispositivos conectados. Antes esa información estaba repartida entre logs y pantallas de cada integración. Para quien tiene un contador por RS485, sale ganando: configuras una vez en YAML y después compruebas el estado de la conexión desde el panel, sin abrir una consola.

Los datos de este apartado salen del release oficial y de la cobertura de Programar Fácil. La instalación sigue siendo 100 % local: el cable Modbus va del contador a tu adaptador USB, y de ahí a Home Assistant, sin pasar por ninguna nube.

Material necesario

Componente	Para qué	Detalle
Adaptador USB a RS485	Traduce el bus del contador a un puerto serie que Home Assistant abra	Cualquiera con chip FTDI o CH340 funciona sin drivers extra en la mayoría del hardware
Contador con salida Modbus RTU	Publica los registros de potencia, tensión y energía	Verifica en su manual los registros, la velocidad y la paridad; cada fabricante los coloca distinto
Dos hilos del bus	A (no invertido) y B (invertido)	Conecta A con A y B con B. Si sale en negativo el valor, intercambia los dos hilos

Si tu contador ya tiene integración propia en Home Assistant, como el Eastron SDM120 o el Shelly 3EM, no la sustituyas por Modbus genérico. Esas integraciones ya traen el calibrado y las unidades del fabricante; el YAML de abajo es para contadores sin integración específica que solo hablan Modbus RTU.

Configuración YAML

Esto define una conexión serie llamada contador y un sensor que lee el registro 0 como float32. Los valores de slave, register y scale salen del manual de tu contador: no son universales.

modbus:
  - name: contador
    type: serial
    port: /dev/ttyUSB0
    baudrate: 9600
    bytesize: 8
    parity: E
    stopbits: 1

sensor:
  - platform: modbus
    registers:
      - name: Potencia activa total
        hub: contador
        slave: 1
        register: 0
        register_type: holding
        data_type: float32
        unit_of_measurement: kW
        scale: 0.001
        precision: 2

El scale es el punto donde más se atasca un primer Modbus: si tu contador devuelve 2430 y en pantalla pone 2,43 kW, está entregando el valor sin decimales. scale: 0.001 convierte 2430 en 2,43. Si el valor te sale desfasado por la misma cantidad, es multiplicación de registros, no error de conexión.

Comprobar que el puerto es el correcto

Antes de reiniciar Home Assistant, localiza el adaptador con esto en la máquina que tenga conectado el USB:

dmesg | grep tty

Verás una línea parecida a ch341-uart ttyUSB0 o ftdi_sio ttyUSB0. Si ya tenías otro adaptador en ese puerto, Home Assistant fallará al arrancar la integración Modbus. Después de ajustar el YAML, reinicia Home Assistant y mira el nuevo panel de Conectividad: el puerto debería aparecer con el contador asociado.

La forma silenciosa de que esto falle es una paridad mal puesta. Si no recibes datos, prueba las combinaciones habituales en este orden: 9600 8E1, 9600 8N1 y 9600 8N2. Una de las tres suele ser la del contador.

El YAML del domingo, cuando aún no está en ninguna página

Pruebo integraciones locales, a veces fallan, y lo que funciona lo publico aquí por turnos. Cada domingo envío un YAML nuevo ya probado y el aviso cuando una integración local se rompe tras actualizar. Nada de PDFs ni descuentos: solo lo que copio yo.

Para copiar ahora mismo

Todo lo que publico probado, junto, en la página de plantillas YAML. Si lo que buscas es medir el mismo contador pero con ESPHome, tengo la guía del Eastron SDM120 por RS485.