Überblick
Atmoce Battery ist eine Integration zur lokalen Überwachung und Steuerung von Atmoce-Solar- und Batteriesystemen über Modbus TCP. Sie fügt Sensoren für Netz-, Solar- und Batteriewerte, einen Indikator für Batterieprobleme und eine Taste zum Zurücksetzen des Gateways hinzu. Die Batteriesteuerung über Modbus kann Laden oder Entladen erzwingen, mit einem Ziel-Ladestand, einer Dauer oder beidem, und das ganz ohne Konto. Mit einem optionalen Login bei atmocecloud.com stellt sie außerdem Batteriegrenzen und dauerhafte Vorgaben wie Netzladen und Einspeisung über Zahlen, Auswahlfelder und Schalter bereit. Ein optionaler Cloud-Monitoring-Fallback deckt Ausfälle des Gateways ab und benötigt Partner-API-Schlüssel, die von Atmoce ausgestellt werden. Die Einrichtung läuft in der Oberfläche, wo die Anzahl der Batterien die Kapazität und die Leistungsgrenzen festlegt.
Zusammenfassung der README und des Codes von pacorola/Atmoce_battery_HA, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Schalter
- Sensoren
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
Atmoce Gateway: Verbindung
- IP-Adresse
- Modbus-TCP-Port
- Modbus Slave ID (Bereich von 1 bis 247)Ändere das nur, wenn dein Gateway mit einer abweichenden Slave ID konfiguriert wurde. Lass es bei 1, wenn du unsicher bist.
Batterien
- Anzahl der BatterienJede Einheit fügt 7 kWh, 3,75 kW Ladeleistung und 4,5 kW Entladeleistung hinzu.
- Spezifikationen stattdessen manuell eingebenAktiviere das bei anderer Hardware oder wenn dein Wechselrichter die Gesamtleistung unter die Summe der Einheiten begrenzt.
Manuelle Batteriespezifikationen
- Nutzbare Kapazität (kWh)
- Maximale Dauerladeleistung (kW)
- Maximale Dauerentladeleistung (kW)
Konto bei atmocecloud.com (optional)
- E-Mail-Adresse für atmocecloud.comDie E-Mail-Adresse, mit der du dich bei atmocecloud.com oder in der ATMOZEN-App anmeldest.
- Passwort für atmocecloud.comDas Passwort für dasselbe Konto. Es wird in deinem Home Assistant gespeichert und erscheint nie in der Diagnose.
Cloud-Monitoring-Fallback (erweitert)
- Cloud-Monitoring-Fallback aktivierenAktiviere das nur, wenn dir der Atmoce-Support einen app_key und ein app_secret gegeben hat. Ohne sie lässt das Formular dich nicht fortfahren.
- API-Schlüssel app_key (Open API)Vom Atmoce-Support ausgestellt. Es ist nicht dein Passwort und lässt sich nicht im Portal erzeugen.
- API-Geheimnis app_secret (Open API)Wird zusammen mit dem app_key ausgestellt.
- Modbus-Fehler vor dem Cloud-FallbackWie viele aufeinanderfolgende Modbus-Fehler auftreten, bevor auf die Cloud ausgewichen wird.
Erneut anmelden: IP-Adresse des Gateways hat sich geändert
- Neue IP-Adresse
- Modbus-TCP-Port
Batteriestapel
- Anzahl der BatterienJede MS-7K-U-Einheit fügt 7 kWh, 3,75 kW Ladeleistung und 4,5 kW Entladeleistung hinzu. Eine MS-14K-U zählt als zwei Einheiten.
Nach der Einrichtung
- Modbus-Fehler vor dem Cloud-FallbackWie viele aufeinanderfolgende Modbus-Fehler auftreten, bevor auf die Cloud ausgewichen wird.
- Cloud-Monitoring-Fallback aktivierenAktiviere das nur, wenn du einen app_key und ein app_secret hast.
- API-Schlüssel app_key (Open API, optional)Beim Atmoce-Support angefragt. Lass das Feld leer, wenn du keinen hast.
- API-Geheimnis app_secret (Open API, optional)Wird zusammen mit dem app_key ausgestellt. Lass das Feld leer, wenn du keines hast.
- E-Mail-Adresse für atmocecloud.com (für SOC-Grenzen der Batterie)Die E-Mail-Adresse, mit der du dich bei atmocecloud.com oder in der ATMOZEN-App anmeldest.
- Passwort für atmocecloud.comDas Passwort für dasselbe Konto. Es ist mit dem gespeicherten Passwort vorausgefüllt: Wenn du es löschst, wird es auch aus der Konfiguration entfernt.
Texte aus dem Code von pacorola/Atmoce_battery_HA. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Entitäten
- BinärsensorenBatterieproblem
- TastenGateway zurücksetzen
- ZahlenErzwungener Ziel-SOC, Erzwungene Dauer, Erzwungene Leistung, Dispatch-Leistung, Ladegrenze SOC, Entladegrenze SOC, Backup-Reserve SOC, Netzladeleistung, Netzlade-Grenze SOC, Einspeiseleistung, Einspeisung über SOC
- AuswahlfelderBatteriebefehl, Typ des erzwungenen Modus, Selbstverwalteter Modus
- SensorenNetzspannung, Netzstrom, Netzleistung, Netzenergie täglich, Netzenergie gesamt, Verkaufter Strom täglich, Verkaufter Strom gesamt, PV-Leistung, PV-Energie täglich, PV-Energie gesamt, PV-Eigenverbrauchsquote, Batterie-SOC und 12 weitere
- SchalterFernsteuerung, Netzladen, Einspeisung ins Netz
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
Aus der README
Full local control and monitoring of Atmoce solar + battery systems over Modbus TCP, plus the settings that only exist in the Atmoce portal.
Fully tested and working with the Atmoce MS-7K-U (7 kWh LFP battery). Should be compatible with MC100, MC100-T and MG100 gateways. Try it on your installation and please report back so anything broken can be fixed.
- 24 sensors and a problem binary sensor — grid, solar, battery, plus computed autonomy and self-consumption
- Battery control over Modbus — force charge or discharge with a target SOC, a duration, or both. Entirely local; no account needed
- Battery limits — end-of-charge, end-of-discharge and backup reserve, which Modbus does not expose. Needs your ordinary atmocecloud.com login
- Standing policy — self-powered or time-of-use, grid charging and export, each with its own power cap and SOC bound. Also from the portal
- Battery count in setup — say how many units you have and capacity and power limits follow, changeable later via Reconfigure without reinstalling
- Cloud monitoring fallback (optional, rarely needed) if the gateway stops answering over Modbus. Requires partner API keys that Atmoce issues to installers
- Diagnostics — full state export with credentials and site identity redacted
- Trilingual — English, Spanish and French, entity names and select options included
Erscheint in Vulpo
Schnellumschalterkarte, Tastenkarte, Auswahl-Karte, Diagrammkarte, Apple Watch, Kontrollzentrum.Informationen
- Installationen
- 68 teilen Analysedaten
- GitHub-Sterne
- 16
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v1.5.5,
- Art
- Marketplace-Integration
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
atmoce- Probleme
- Problem melden
