Hoymiles HiBattery 1920 AC in Home Assistant integrieren — MQTT & Cloud-API

8. Mai 2026

Hinweis: Dieser Artikel ist technisch. Er richtet sich an Nutzer, die Home Assistant bereits betreiben und Grundkenntnisse in YAML sowie der HA-Oberfläche mitbringen. Für eine einfachere Einrichtung ohne Smarthome-Kenntnisse empfehlen wir den EcoTracker IR Einrichtungsartikel.

Die Hoymiles HiBattery 1920 AC ist ein kompakter Hausbatteriespeicher, der sich gut mit einem Balkonkraftwerk kombinieren lässt. Was viele nicht wissen: Die HiBattery lässt sich vollständig in Home Assistant einbinden — entweder lokal per MQTT oder über die Hoymiles Cloud API. Wer das einmal aufgesetzt hat, kann den Speicher nach eigenem Ermessen automatisieren: Laden, wenn der Strom günstig ist, entladen, wenn er teuer wird, und alles im HA Energy-Dashboard im Blick behalten.

Dieser Artikel richtet sich an Personen, die Home Assistant bereits betreiben und wissen wollen, wie die Anbindung der HiBattery konkret funktioniert. Er ist kein Einstiegsguide für Home Assistant selbst.

Warum Home Assistant und HiBattery zusammen?

Die HiBattery hat einen eingebauten KI-Modus, der den Speicher automatisch verwaltet. Der Modus ist komfortabel, aber nicht flexibel: Er kennt keine Echtzeitstrompreise, kann nicht auf externe Signale reagieren und lässt sich nicht in eine breitere Hausautomation einbetten.

Home Assistant schließt diese Lücke. Mit HA lassen sich Betriebsmodi der Batterie gezielt schalten, Ladezeitfenster nach dynamischen Strompreisen steuern und alle Energieflüsse zentral visualisieren. Das ist echte bedarfsgerechte Steuerung — nichts, was die S-Miles App alleine leisten kann.

Zwei Wege im Überblick — kurze Entscheidungshilfe

Kriterium	MQTT (lokal)	Cloud-Integration
Internetabhängigkeit	keine (lokales Netz)	ja (Hoymiles Cloud)
Einrichtungsaufwand	mittel (Broker nötig)	gering (HACS-Installation)
Steuerung	eingeschränkt (Leistung per MQTT)	vollständig (alle Betriebsmodi)
Auth-Unterstützung	derzeit nicht im Adapter	via Hoymiles Account
Empfohlen für	Datenschutz-bewusste Nutzer	Einfache Einrichtung, volle Kontrolle

Wer maximale Kontrolle ohne Cloud möchte, nimmt den MQTT-Weg. Wer schnell ans Ziel kommen will und alle Betriebsmodi steuern möchte, ist mit der Cloud-Integration besser bedient.

Weg 1 — Lokale MQTT-Integration

Voraussetzungen

Home Assistant läuft (z. B. auf Raspberry Pi 4 oder Mini-PC, HAOS empfohlen)
Mosquitto MQTT Broker als HA Add-on installiert
HiBattery und HA-Gerät im selben lokalen Netzwerk
Aktuelle Firmware auf der HiBattery

Schritt 1: MQTT-Service in der S-Miles Home App aktivieren

Öffne die S-Miles Home App und navigiere zu:

Einstellungen → MQTT-Service → aktivieren

Dort trägst du folgendes ein:

Broker-IP: IP-Adresse deines Home Assistant-Servers (z. B. 192.168.1.100)
Port: Standard-MQTT-Port 1883
Benutzername / Passwort: leer lassen (siehe Hinweis unten)

Wichtig — Auth-Problem: Der aktuelle MQTT-Adapter der HiBattery unterstützt keine Passwortauthentifizierung ^¹. Das bedeutet: Der MQTT-Broker muss ohne Passwortschutz erreichbar sein, oder du konfigurierst einen separaten Listener ohne Authentifizierung auf einem anderen Port (z. B. 1884), der nur im lokalen Netz erreichbar ist. Wer seinen Broker bisher mit Passwort betrieben hat, muss hier umdenken.

Schritt 2: Mosquitto in Home Assistant einrichten

Falls noch nicht vorhanden, installiere das Mosquitto-Add-on:

Einstellungen → Add-ons → Add-on Store → Mosquitto broker

Für einen Listener ohne Authentifizierung ergänze in der Add-on-Konfiguration unter "Customize":

active: true
content: |
  listener 1884
  allow_anonymous true

Restart des Add-ons nicht vergessen. Diesen offenen Port solltest du nur im lokalen Netz zugänglich machen und nicht nach außen öffnen.

Schritt 3: MQTT-Integration in HA konfigurieren

Einstellungen → Geräte & Dienste → Integration hinzufügen → MQTT

Trage die Broker-Adresse (localhost oder 127.0.0.1) und den Port ein. Falls du den anonymen Listener auf Port 1884 nutzt, stelle sicher, dass die Integration diesen Port verwendet.

Schritt 4: Topics prüfen und erste Entities anlegen

Sobald die HiBattery Daten sendet, erscheinen die Topics im MQTT-Explorer oder im HA-Tool "MQTT → Lausche auf ein Topic". Die genaue Topic-Struktur variiert je nach Firmware. Erwarte Topics in der Form:

hoymiles/battery/<serial>/status/soc
hoymiles/battery/<serial>/status/power
hoymiles/battery/<serial>/status/voltage
hoymiles/battery/<serial>/status/mode

Beispiel für eine configuration.yaml-Ergänzung (Konzept — dein Topic-Pfad kann abweichen):

mqtt:
  sensor:
    - name: "HiBattery Ladezustand"
      state_topic: "hoymiles/battery/DEINE_SERIENNUMMER/status/soc"
      unit_of_measurement: "%"
      device_class: battery
    - name: "HiBattery Leistung"
      state_topic: "hoymiles/battery/DEINE_SERIENNUMMER/status/power"
      unit_of_measurement: "W"
      device_class: power

Für die Steuerung (Zielleistung setzen) schreibst du auf ein Command-Topic:

mqtt:
  number:
    - name: "HiBattery Zielleistung"
      command_topic: "hoymiles/battery/DEINE_SERIENNUMMER/control/power"
      min: 0
      max: 1920
      unit_of_measurement: "W"

Verifiziere die tatsächlichen Topics immer im MQTT-Explorer, bevor du Entities anlegst. Aktuelle Topic-Listen findest du in den Quellen am Ende des Artikels ^{¹ ²}.

Weg 2 — Cloud-Integration via HACS

Voraussetzungen

Home Assistant mit HACS installiert
Aktiver Hoymiles Cloud Account (S-Miles Cloud)
Der Account muss "writable battery settings" freigeschaltet haben — ggf. beim Hoymiles-Support beantragen ^³

Schritt 1: Integration über HACS installieren

HACS → Integrationen → Suche: "hoymiles"

Das Repository lautet Philra94/homeassistant-hoymiles-cloud ^³. Installiere die Integration und starte HA danach neu.

Alternativ manuell: Das Repository klonen und in den Ordner custom_components/hoymiles_cloud/ kopieren.

Schritt 2: Integration einrichten

Einstellungen → Geräte & Dienste → Integration hinzufügen → Hoymiles Cloud

Trage deine Hoymiles Cloud-Zugangsdaten ein (E-Mail und Passwort des S-Miles Cloud Accounts). Die Integration verbindet sich mit der Hoymiles API und legt automatisch Entities für alle erkannten Geräte an.

Schritt 3: Verfügbare Entitäten und Steuerung

Monitoring:

Ladezustand (SOC) in Prozent
Aktuelle Leistung (Laden / Entladen)
Tagesertrag, Gesamtertrag
Betriebsmodus (aktuell aktiver Modus)

Steuerung (erfordert freigeschaltete "writable battery settings"):

Betriebsmodus umschalten: Self-Consumption, Economy, Backup, Off-Grid, Peak Shaving, Time of Use
Reserve-SOC setzen (Mindestladung für Backup-Funktion)

Das Umschalten des Betriebsmodus geschieht in HA über einen select-Entity oder einen Service-Aufruf — direkt aus Automationen heraus steuerbar.

Das Beste daraus machen: Automatisierung nach Strompreis

Wer einen dynamischen Stromtarif nutzt, kann jetzt HA als Energiemanager verwenden. Die Logik ist einfach: Strom ist stündlich unterschiedlich teuer — die Batterie soll laden, wenn er günstig ist, und entladen, wenn er teuer wird.

Dynamische Tarifintegrationen für HA (z. B. für Tibber oder Awattar) stellen stündliche Preise als Sensor bereit. Daraus lassen sich Automationen bauen.

Hinweis: Das folgende Beispiel ist eine konzeptionelle YAML-Skizze. Die genauen Entity-IDs der Hoymiles Cloud Integration und die Sensor-Namen deines Stromtarifs müssen in deiner Instanz geprüft werden. Verwende diesen Code nicht 1:1, sondern als Orientierung.

# Konzept-Automation: Batterie laden bei günstigem Strompreis
automation:
  - alias: "HiBattery laden bei niedrigem Strompreis"
    trigger:
      - platform: state
        entity_id: sensor.stromtarif_aktueller_preis
    condition:
      - condition: numeric_state
        entity_id: sensor.stromtarif_aktueller_preis
        below: 0.20  # Schwellenwert in EUR/kWh — anpassen
    action:
      - service: select.select_option
        target:
          entity_id: select.hibattery_operating_mode  # Entity-ID prüfen
        data:
          option: "Economy"  # Ladepriorität aus Netz

  - alias: "HiBattery entladen bei hohem Strompreis"
    trigger:
      - platform: state
        entity_id: sensor.stromtarif_aktueller_preis
    condition:
      - condition: numeric_state
        entity_id: sensor.stromtarif_aktueller_preis
        above: 0.35  # Schwellenwert anpassen
    action:
      - service: select.select_option
        target:
          entity_id: select.hibattery_operating_mode
        data:
          option: "Self-Consumption"

  - alias: "HiBattery maximal laden bei negativem Preis"
    trigger:
      - platform: numeric_state
        entity_id: sensor.stromtarif_aktueller_preis
        below: 0
    action:
      - service: select.select_option
        target:
          entity_id: select.hibattery_operating_mode
        data:
          option: "Economy"

Das ist echte preisbasierte Steuerung. Der eingebaute KI-Modus der HiBattery trifft seine Entscheidungen auf Basis historischer Muster — er kennt keine Live-Preise. Mit dieser Automation reagierst du auf den tatsächlichen Stundenpreis.

Weitere Möglichkeiten

HA Energy-Dashboard

Sobald die HiBattery in HA eingebunden ist, können die Leistungs-Entities dem Energy-Dashboard hinzugefügt werden. Das Dashboard zeigt Eigenverbrauch, Netzeinspeisung, Netzbezug und Batterieflüsse in einer gemeinsamen Ansicht — zusammen mit dem Ertrag des Balkonkraftwerks (sofern dessen Wechselrichter ebenfalls eingebunden ist, z. B. per OpenDTU oder AhoyDTU).

ioBroker-Alternative

Wer kein Home Assistant betreibt, sondern ioBroker, hat mit dem Adapter mcm4iob/ioBroker.hoymiles-ms ^⁵ eine Alternative. Die Steuerungsmöglichkeiten sind dort bisher begrenzter als in der HA Cloud-Integration.

Node-RED

Wer komplexere Logiken ohne YAML bauen möchte, kann Node-RED (als HA Add-on verfügbar) als Automationsschicht einsetzen. Die MQTT-Topics der HiBattery lassen sich direkt in Node-RED-Flows verarbeiten.

Fazit

Die Hoymiles HiBattery 1920 AC ist kein geschlossenes System. Wer Home Assistant betreibt, hat zwei solide Wege zur Integration: MQTT für lokale, cloudunabhängige Anbindung mit etwas mehr Konfigurationsaufwand, und die Cloud-Integration über HACS für schnelle Einrichtung mit vollem Funktionsumfang.

Der größte Mehrwert entsteht in Kombination mit einem dynamischen Stromtarif: Die Batterie wird zum aktiven Werkzeug für Kostenoptimierung statt zum Gerät, das einfach läuft.

Die HiBattery ist Teil des Hoymiles-Speichersystems, das wir bei Panelretter anbieten. Wenn du Fragen zur Kompatibilität oder zur Ersteinrichtung hast, hilft dir unser Support gerne weiter.