Ir al contenido

← Guía MQTT | Contenido

12. Integración con Home Assistant

Version: 1.2.0
Date: 2025-12-24

Guía completa para integrar ACRouter con Home Assistant mediante MQTT Auto-Discovery.



Tabla de contenido



Descripción general

ACRouter es compatible con MQTT Auto-Discovery, lo que significa que Home Assistant crea automáticamente todas las entidades cuando el dispositivo se conecta. ¡No se requiere configuración YAML manual!


Características

  • Creación automática de dispositivos y entidades
  • Sensores de monitoreo de potencia en tiempo real
  • Control de selección de modo
  • Ajuste de parámetros (ganancia, umbral)
  • Botón de parada de emergencia
  • Seguimiento de disponibilidad (en línea/fuera de línea)
  • Agrupación de dispositivos con información del fabricante



Requisitos previos

  1. Home Assistant instalado y en funcionamiento
  2. Broker MQTT (Mosquitto recomendado)
  3. Puede ser el complemento Mosquitto de Home Assistant
  4. O un broker externo
  5. Integración MQTT configurada en Home Assistant
  6. ACRouter con MQTT habilitado



Configuración


Paso 1: Instalar el broker MQTT

Opción A: Complemento de Home Assistant (Recomendado)

  1. Vaya a Ajustes > Complementos > Tienda de complementos
  2. Search for "Mosquitto broker"
  3. Haga clic en Instalar
  4. Inicie el complemento
  5. Configure las credenciales en la configuración del complemento

Opción B: Broker externo

Consulte 11_MQTT_GUIDE.md para la configuración de Mosquitto.


Paso 2: Configurar la integración MQTT

  1. Vaya a Ajustes > Dispositivos y servicios
  2. Click "Add Integration"
  3. Search for "MQTT"
  4. Introduzca los datos del broker:
  5. Broker: localhost (si usa el complemento) o IP del broker
  6. Puerto: 1883
  7. Usuario/Contraseña (si está configurado)


Paso 3: Configurar ACRouter

A través de la consola serie:

bash
# Set broker URL
mqtt-broker mqtt://192.168.1.10:1883

# Set credentials (if required)
mqtt-user homeassistant
mqtt-pass your_password

# Set friendly device name
mqtt-device-name "Solar Router"

# Ensure HA Discovery is enabled
mqtt-ha-discovery 1

# Enable MQTT
mqtt-enable


Paso 4: Verificar el descubrimiento

  1. Vaya a Ajustes > Dispositivos y servicios > MQTT
  2. Look for "ACRouter Solar" device
  3. Todas las entidades deberían haberse creado automáticamente



Entidades descubiertas automáticamente


Sensores

Entidad Descripción Unidad Clase de dispositivo
sensor.acrouter_grid_power Potencia de importación/exportación de red W power
sensor.acrouter_solar_power Potencia de generación solar W power
sensor.acrouter_load_power Potencia de consumo de la carga W power
sensor.acrouter_voltage Voltaje AC V voltage
sensor.acrouter_dimmer Nivel del dimmer % -
sensor.acrouter_wifi_signal Intensidad de señal WiFi dBm signal_strength


Select

Entidad Descripción Opciones
select.acrouter_router_mode Modo de operación del enrutador off, auto, eco, offgrid, manual, boost


Numbers

Entidad Descripción Rango
number.acrouter_control_gain Ganancia del controlador P 10–1000
number.acrouter_balance_threshold Banda muerta de balance 0–1000 W
number.acrouter_manual_level Nivel manual del dimmer 0–100%


Buttons

Entidad Descripción
button.acrouter_emergency_stop Parada de emergencia
button.acrouter_reboot Reiniciar dispositivo
button.acrouter_refresh Forzar actualización de datos


Información del dispositivo

Todas las entidades están agrupadas bajo un único dispositivo con:

  • Nombre: ACRouter Solar (o nombre personalizado)
  • Fabricante: RBdimmer
  • Modelo: ACRouter
  • Versión de SW: 1.2.0
  • URL de configuración: http://device_ip



Ejemplo de panel de control


Tarjeta Lovelace YAML

yaml
type: entities
title: ACRouter Home Assistant Integration Guide — MQTT
entities:
  - entity: select.acrouter_router_mode
    name: Mode
  - entity: sensor.acrouter_dimmer
    name: Dimmer Level
  - type: divider
  - entity: sensor.acrouter_grid_power
    name: Grid Power
  - entity: sensor.acrouter_solar_power
    name: Solar Power
  - entity: sensor.acrouter_load_power
    name: Load Power
  - type: divider
  - entity: sensor.acrouter_voltage
    name: Voltage
  - entity: sensor.acrouter_wifi_signal
    name: WiFi Signal


Tarjeta de medidor para potencia

yaml
type: gauge
entity: sensor.acrouter_grid_power
name: Grid Power
min: -3000
max: 3000
severity:
  green: -3000
  yellow: 0
  red: 500


Tarjeta de botón personalizada

yaml
type: horizontal-stack
cards:
  - type: button
    entity: button.acrouter_emergency_stop
    name: STOP
    icon: mdi:stop
    tap_action:
      action: call-service
      service: button.press
      target:
        entity_id: button.acrouter_emergency_stop
    show_state: false
  - type: button
    entity: button.acrouter_reboot
    name: Reboot
    icon: mdi:restart
    tap_action:
      action: call-service
      service: button.press
      target:
        entity_id: button.acrouter_reboot
    show_state: false


Vista completa del panel de control

yaml
title: ACRouter Home Assistant Integration Guide — MQTT
views:
  - title: Overview
    cards:
      - type: vertical-stack
        cards:
          - type: entities
            title: Status
            entities:
              - entity: select.acrouter_router_mode
              - entity: sensor.acrouter_dimmer
              - entity: sensor.acrouter_voltage

          - type: glance
            title: Power
            entities:
              - entity: sensor.acrouter_grid_power
                name: Grid
              - entity: sensor.acrouter_solar_power
                name: Solar
              - entity: sensor.acrouter_load_power
                name: Load

          - type: entities
            title: Settings
            entities:
              - entity: number.acrouter_control_gain
              - entity: number.acrouter_balance_threshold
              - entity: number.acrouter_manual_level

          - type: horizontal-stack
            cards:
              - type: button
                entity: button.acrouter_emergency_stop
                name: Emergency Stop
                icon: mdi:stop-circle
              - type: button
                entity: button.acrouter_refresh
                name: Refresh
                icon: mdi:refresh



Automatizaciones


Modo Boost nocturno (Tarifa reducida)

yaml
alias: "Solar Router - Night Boost"
description: Integrate ACRouter solar power router with Home Assistant via MQTT. Covers MQTT discovery, energy dashboard, automations, and Lovelace dashboard cards.
trigger:
  - platform: time
    at: "23:00:00"
action:
  - service: select.select_option
    target:
      entity_id: select.acrouter_router_mode
    data:
      option: "boost"
mode: single


Modo automático por la mañana

yaml
alias: "Solar Router - Morning Auto"
description: Integrate ACRouter solar power router with Home Assistant via MQTT. Covers MQTT discovery, energy dashboard, automations, and Lovelace dashboard cards.
trigger:
  - platform: time
    at: "07:00:00"
action:
  - service: select.select_option
    target:
      entity_id: select.acrouter_router_mode
    data:
      option: "auto"
mode: single


Parada de emergencia por potencia alta

yaml
alias: "Solar Router - Emergency High Power"
description: Integrate ACRouter solar power router with Home Assistant via MQTT. Covers MQTT discovery, energy dashboard, automations, and Lovelace dashboard cards.
trigger:
  - platform: numeric_state
    entity_id: sensor.acrouter_load_power
    above: 3000
    for:
      seconds: 10
action:
  - service: button.press
    target:
      entity_id: button.acrouter_emergency_stop
  - service: notify.mobile_app
    data:
      message: "ACRouter emergency stop triggered - load exceeded 3000W"
mode: single


Notificación por desconexión

yaml
alias: "Solar Router - Offline Alert"
description: Integrate ACRouter solar power router with Home Assistant via MQTT. Covers MQTT discovery, energy dashboard, automations, and Lovelace dashboard cards.
trigger:
  - platform: state
    entity_id: select.acrouter_router_mode
    to: "unavailable"
    for:
      minutes: 5
action:
  - service: notify.mobile_app
    data:
      message: "ACRouter is offline!"
      title: "Solar Router Alert"
mode: single


Enrutamiento de excedente solar

yaml
alias: "Solar Router - Auto Enable on Surplus"
description: Integrate ACRouter solar power router with Home Assistant via MQTT. Covers MQTT discovery, energy dashboard, automations, and Lovelace dashboard cards.
trigger:
  - platform: numeric_state
    entity_id: sensor.acrouter_grid_power
    below: -100
    for:
      minutes: 1
condition:
  - condition: state
    entity_id: select.acrouter_router_mode
    state: "off"
action:
  - service: select.select_option
    target:
      entity_id: select.acrouter_router_mode
    data:
      option: "auto"
mode: single



Panel de energía


Configurar sensores de energía

Los sensores de potencia de ACRouter se pueden integrar con el panel de energía de Home Assistant.

  1. Vaya a Ajustes > Paneles de control > Energía
  2. Añada consumo de red: sensor.acrouter_grid_power (cuando sea positivo)
  3. Añada producción solar: sensor.acrouter_solar_power

Nota: El panel de energía requiere sensores de energía (kWh), no sensores de potencia (W). Es posible que necesite crear sensores template o usar asistentes de integración.


Sensor template para energía (Opcional)

yaml
# configuration.yaml
template:
  - sensor:
      - name: "ACRouter Grid Import Energy"
        unit_of_measurement: "kWh"
        device_class: energy
        state_class: total_increasing
        state: >
          {% set power = states('sensor.acrouter_grid_power') | float(0) %}
          {% if power > 0 %}
            {{ (power / 1000) | round(3) }}
          {% else %}
            0
          {% endif %}



Solución de problemas


Dispositivo no descubierto

  1. Check MQTT connection:
    bash mqtt-status
    Should show State: Connected

  2. Check HA Discovery enabled:
    bash mqtt-ha-discovery 1 mqtt-publish

  3. Verificar la integración MQTT en HA:

  4. Ajustes > Dispositivos y servicios > MQTT

  5. Click "Configure" > Check broker settings

  6. Restart discovery:
    bash mqtt-reconnect


Entities Show "Unavailable"

  1. Verificar que el dispositivo esté en línea:
  2. Consulte el topic status/online

  3. Debería ser online

  4. Check WiFi connection:
    bash wifi-status

  5. Verificar la conexión al broker:

  6. Asegúrese de que el broker sea accesible desde HA
  7. Pruebe con mosquitto_sub


Los valores no se actualizan

  1. Check publish interval:
    bash mqtt-interval 5000

  2. Force refresh:
    bash mqtt-publish

  3. Check MQTT messages are being received:
    bash mosquitto_sub -h broker_ip -t "acrouter/#" -v


La selección de modo no funciona

  1. Verificar la suscripción al topic de comando:

  2. El dispositivo debería registrar: MQTT: Command: mode = auto

  3. Verificar que el modo sea válido:

  4. Debe ser: off, auto, eco, offgrid, manual, boost

  5. Verificar la compatibilidad del modo:

  6. Algunos modos requieren sensores específicos configurados



Véase también

Última actualización: 2025-12-24

← Guía MQTT | Contenido

Tabla de contenido Descripción general Requisitos previos Configuración Entidades descubiertas automáticamente Ejemplo de panel de control Automatizaciones Panel de energía Solución de problemas Véase también