Se rendre au contenu

← Guide MQTT | Sommaire

12. Intégration Home Assistant

Version: 1.2.0
Date: 2025-12-24

Guide complet pour intégrer ACRouter avec Home Assistant via MQTT Auto-Discovery.



Sommaire



Vue d'ensemble

ACRouter prend en charge MQTT Auto-Discovery, ce qui signifie que Home Assistant crée automatiquement toutes les entités lorsque l'appareil se connecte. Aucune configuration YAML manuelle requise !


Fonctionnalités

  • Création automatique des appareils et entités
  • Capteurs de surveillance de puissance en temps réel
  • Contrôle de sélection de mode
  • Réglage des paramètres (gain, seuil)
  • Bouton d'arrêt d'urgence
  • Suivi de disponibilité (en ligne/hors ligne)
  • Regroupement d'appareils avec informations du fabricant



Prérequis

  1. Home Assistant installé et fonctionnel
  2. Broker MQTT (Mosquitto recommandé)
  3. Peut être le module complémentaire Mosquitto de Home Assistant
  4. Ou un broker externe
  5. Intégration MQTT configurée dans Home Assistant
  6. ACRouter avec MQTT activé



Configuration


Étape 1 : Installer le broker MQTT

Option A : Module complémentaire Home Assistant (Recommandé)

  1. Allez dans Paramètres > Modules complémentaires > Boutique
  2. Search for "Mosquitto broker"
  3. Cliquez sur Installer
  4. Démarrez le module complémentaire
  5. Configurez les identifiants dans la configuration du module

Option B : Broker externe

Voir 11_MQTT_GUIDE.md pour la configuration de Mosquitto.


Étape 2 : Configurer l'intégration MQTT

  1. Allez dans Paramètres > Appareils et services
  2. Click "Add Integration"
  3. Search for "MQTT"
  4. Entrez les détails du broker :
  5. Broker : localhost (si module complémentaire utilisé) ou IP du broker
  6. Port : 1883
  7. Nom d'utilisateur/Mot de passe (si configuré)


Étape 3 : Configurer ACRouter

Via la console série :

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


Étape 4 : Vérifier la découverte

  1. Allez dans Paramètres > Appareils et services > MQTT
  2. Look for "ACRouter Solar" device
  3. Toutes les entités devraient être créées automatiquement



Entités découvertes automatiquement


Capteurs

Entité Description Unité Classe d'appareil
sensor.acrouter_grid_power Puissance import/export réseau W power
sensor.acrouter_solar_power Puissance de production solaire W power
sensor.acrouter_load_power Puissance de consommation de la charge W power
sensor.acrouter_voltage Tension AC V voltage
sensor.acrouter_dimmer Niveau du variateur % -
sensor.acrouter_wifi_signal Puissance du signal WiFi dBm signal_strength


Select

Entité Description Options
select.acrouter_router_mode Mode de fonctionnement du routeur off, auto, eco, offgrid, manual, boost


Numbers

Entité Description Plage
number.acrouter_control_gain Gain du régulateur P 10–1000
number.acrouter_balance_threshold Bande morte d'équilibrage 0–1000 W
number.acrouter_manual_level Niveau manuel du variateur 0–100%


Buttons

Entité Description
button.acrouter_emergency_stop Arrêt d'urgence
button.acrouter_reboot Redémarrer l'appareil
button.acrouter_refresh Forcer l'actualisation des données


Informations sur l'appareil

Toutes les entités sont regroupées sous un seul appareil avec :

  • Nom : ACRouter Solar (ou nom personnalisé)
  • Fabricant : RBdimmer
  • Modèle : ACRouter
  • Version logicielle : 1.2.0
  • URL de configuration : http://device_ip



Exemple de tableau de bord


Carte 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


Carte jauge pour la puissance

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


Carte bouton personnalisée

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


Vue complète du tableau de bord

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



Automatisations


Mode Boost nocturne (Tarif réduit)

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


Mode automatique le matin

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


Arrêt d'urgence en cas de puissance élevée

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


Notification en cas de déconnexion

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


Routage de surplus solaire

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



Tableau de bord énergie


Configurer les capteurs d'énergie

Les capteurs de puissance d'ACRouter peuvent être intégrés au tableau de bord énergie de Home Assistant.

  1. Allez dans Paramètres > Tableaux de bord > Énergie
  2. Ajoutez la consommation réseau : sensor.acrouter_grid_power (lorsque positif)
  3. Ajoutez la production solaire : sensor.acrouter_solar_power

Remarque : Le tableau de bord énergie nécessite des capteurs d'énergie (kWh), pas des capteurs de puissance (W). Vous devrez peut-être créer des capteurs template ou utiliser des assistants d'intégration.


Capteur template pour l'énergie (Optionnel)

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 %}



Dépannage


Appareil non découvert

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

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

  3. Vérifier l'intégration MQTT dans HA :

  4. Paramètres > Appareils et services > MQTT

  5. Click "Configure" > Check broker settings

  6. Restart discovery:
    bash mqtt-reconnect


Entities Show "Unavailable"

  1. Vérifier que l'appareil est en ligne :
  2. Consultez le topic status/online

  3. Devrait être online

  4. Check WiFi connection:
    bash wifi-status

  5. Vérifier la connexion au broker :

  6. Vérifiez que le broker est accessible depuis HA
  7. Testez avec mosquitto_sub


Les valeurs ne se mettent pas à jour

  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 sélection du mode ne fonctionne pas

  1. Vérifier l'abonnement au topic de commande :

  2. L'appareil devrait journaliser : MQTT: Command: mode = auto

  3. Vérifier que le mode est valide :

  4. Doit être : off, auto, eco, offgrid, manual, boost

  5. Vérifier la compatibilité du mode :

  6. Certains modes nécessitent des capteurs spécifiques configurés



Voir aussi

Dernière mise à jour : 2025-12-24

← Guide MQTT | Sommaire

Sommaire Vue d'ensemble Prérequis Configuration Entités découvertes automatiquement Exemple de tableau de bord Automatisations Tableau de bord énergie Dépannage Voir aussi