Zum Inhalt springen

← MQTT-Anleitung | Inhaltsverzeichnis

12. Home Assistant Integration

Version: 1.2.0
Date: 2025-12-24

Vollständige Anleitung zur Integration von ACRouter mit Home Assistant über MQTT Auto-Discovery.



Inhaltsverzeichnis



Übersicht

ACRouter unterstützt MQTT Auto-Discovery — das bedeutet, Home Assistant erstellt automatisch alle Entitäten, sobald das Gerät verbunden ist. Keine manuelle YAML-Konfiguration erforderlich!


Funktionen

  • Automatische Geräte- und Entitätserstellung
  • Echtzeit-Leistungsüberwachungssensoren
  • Modusauswahl-Steuerung
  • Parameteranpassung (Verstärkung, Schwellenwert)
  • Not-Aus-Taste
  • Verfügbarkeitsverfolgung (online/offline)
  • Gerätegruppierung mit Herstellerinformationen



Voraussetzungen

  1. Home Assistant installiert und betriebsbereit
  2. MQTT Broker (Mosquitto empfohlen)
  3. Kann das Home Assistant Mosquitto Add-on sein
  4. Oder ein externer Broker
  5. MQTT-Integration in Home Assistant konfiguriert
  6. ACRouter mit aktiviertem MQTT



Einrichtung


Schritt 1: MQTT Broker installieren

Option A: Home Assistant Add-on (Empfohlen)

  1. Gehen Sie zu Einstellungen > Add-ons > Add-on Store
  2. Search for "Mosquitto broker"
  3. Klicken Sie auf Installieren
  4. Starten Sie das Add-on
  5. Konfigurieren Sie die Zugangsdaten in der Add-on-Konfiguration

Option B: Externer Broker

Siehe 11_MQTT_GUIDE.md für die Mosquitto-Einrichtung.


Schritt 2: MQTT-Integration konfigurieren

  1. Gehen Sie zu Einstellungen > Geräte & Dienste
  2. Click "Add Integration"
  3. Search for "MQTT"
  4. Geben Sie die Broker-Details ein:
  5. Broker: localhost (bei Verwendung des Add-ons) oder Broker-IP
  6. Port: 1883
  7. Benutzername/Passwort (falls konfiguriert)


Schritt 3: ACRouter konfigurieren

Über die serielle Konsole:

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


Schritt 4: Discovery überprüfen

  1. Gehen Sie zu Einstellungen > Geräte & Dienste > MQTT
  2. Look for "ACRouter Solar" device
  3. Alle Entitäten sollten automatisch erstellt worden sein



Automatisch erkannte Entitäten


Sensoren

Entität Beschreibung Einheit Geräteklasse
sensor.acrouter_grid_power Netz-Import/Export-Leistung W power
sensor.acrouter_solar_power Solare Erzeugungsleistung W power
sensor.acrouter_load_power Verbrauchsleistung der Last W power
sensor.acrouter_voltage AC-Spannung V voltage
sensor.acrouter_dimmer Dimmer-Stufe % -
sensor.acrouter_wifi_signal WLAN-Signalstärke dBm signal_strength


Select

Entität Beschreibung Optionen
select.acrouter_router_mode Router-Betriebsmodus off, auto, eco, offgrid, manual, boost


Numbers

Entität Beschreibung Bereich
number.acrouter_control_gain P-Regler-Verstärkung 10–1000
number.acrouter_balance_threshold Balance-Totzone 0–1000 W
number.acrouter_manual_level Manuelle Dimmer-Stufe 0–100%


Buttons

Entität Beschreibung
button.acrouter_emergency_stop Not-Aus
button.acrouter_reboot Gerät neu starten
button.acrouter_refresh Datenaktualisierung erzwingen


Geräteinformationen

Alle Entitäten sind unter einem einzelnen Gerät gruppiert mit:

  • Name: ACRouter Solar (oder benutzerdefinierter Name)
  • Hersteller: RBdimmer
  • Modell: ACRouter
  • SW-Version: 1.2.0
  • Konfigurations-URL: http://device_ip



Dashboard-Beispiel


Lovelace Card 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


Gauge Card für Leistung

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


Benutzerdefinierte Button Card

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


Vollständige Dashboard-Ansicht

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



Automatisierungen


Nacht-Boost-Modus (Günstigter Tarif)

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


Morgens Automatik-Modus

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


Not-Aus bei hoher Leistung

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


Benachrichtigung bei Verbindungsabbruch

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


Solarüberschuss-Routing

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



Energie-Dashboard


Energiesensoren konfigurieren

Die Leistungssensoren von ACRouter können in das Home Assistant Energie-Dashboard integriert werden.

  1. Gehen Sie zu Einstellungen > Dashboards > Energie
  2. Netzverbrauch hinzufügen: sensor.acrouter_grid_power (wenn positiv)
  3. Solarproduktion hinzufügen: sensor.acrouter_solar_power

Hinweis: Das Energie-Dashboard benötigt Energiesensoren (kWh), nicht Leistungssensoren (W). Möglicherweise müssen Sie Template-Sensoren erstellen oder Integrationshilfen verwenden.


Template-Sensor für Energie (Optional)

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



Fehlerbehebung


Gerät wird nicht erkannt

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

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

  3. MQTT-Integration in HA prüfen:

  4. Einstellungen > Geräte & Dienste > MQTT

  5. Click "Configure" > Check broker settings

  6. Restart discovery:
    bash mqtt-reconnect


Entities Show "Unavailable"

  1. Prüfen, ob das Gerät online ist:
  2. Topic status/online überprüfen

  3. Sollte online sein

  4. Check WiFi connection:
    bash wifi-status

  5. Broker-Verbindung prüfen:

  6. Sicherstellen, dass der Broker von HA erreichbar ist
  7. Mit mosquitto_sub testen


Werte aktualisieren sich nicht

  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


Modusauswahl funktioniert nicht

  1. Befehlstopic-Abonnement prüfen:

  2. Gerät sollte protokollieren: MQTT: Command: mode = auto

  3. Gültigkeit des Modus überprüfen:

  4. Muss einer der folgenden sein: off, auto, eco, offgrid, manual, boost

  5. Moduskompatibilität prüfen:

  6. Einige Modi erfordern bestimmte konfigurierte Sensoren



Siehe auch

Letzte Aktualisierung: 2025-12-24

← MQTT-Anleitung | Inhaltsverzeichnis

Inhaltsverzeichnis Übersicht Voraussetzungen Einrichtung Automatisch erkannte Entitäten Dashboard-Beispiel Automatisierungen Energie-Dashboard Fehlerbehebung Siehe auch