ÜBER DIE BEAAM API
neoom BEAAM API (beta)
Nützliche Begriffe und Komponentennamen
Während der Interaktion mit unserem Ökosystem, wirst du immer wieder auf bestimmte Begriffe und Namen von Komponenten stoßen. Eine Erklärung dazu findest du hier: Konzepte & Begriffe
Was ist der neoom BEAAM
Jeder neoom CONNECT Standort ist mit einem BEAAM ausgestattet, der als zentraler Knotenpunkt dient, der die Konnektivität zu deinem Energiegeräten am Standort zur Überwachung und Steuerung bereitstellt. Energiegeräte gelten all jene, die mit Energie oder Energiemanagement in Zusammenhang stehen (Batteriespeicher, Wechselrichter, Wärmepumpen, Ladestationen, Heizstäbe usw.).
Mit dem BEAAM ist neoom in der Lage, neoom CONNECT-Funktionen wie historische und aktuelle Metriken in der neoom APP und auch Energiemanagement-Funktionen wie die "PV-Überschuss basierte Gerätepriorisierung" zur Verfügung zu stellen.
Darüber hinaus ermöglicht die enge Integration mit der neoom CONNECT Cloud die sichere Übergabe rechenintensiver Energiemanagementaufgaben an unsere Rechenzentren, wie KI und maschinelles Lernen, die das Laden deiner Batterie auf der Grundlage dynamischer Netzpreise optimieren. Der BEAAM macht es einfach, diese Energiegeräte in ein bestehendes Smart-Home-System zu integrieren, indem es alle herstellerspezifischen Implementierungsdetails, Protokolle und Formate abstrahiert und normalisierte und saubere Daten als entwicklerfreundliche JSON über eine REST-API bereitstellt.
API-Dokumentation
Einzelheiten zur Verwendung der BEAM-API findest du in den Dokumenten auf developer.neoom.com.
Die API stellt Daten zu Standort und Geräten am Standort bereit.
Standortspezifische Daten
Ein Standort wird durch seine Metadaten definiert, die durch die Standortkonfiguration dargestellt werden.
Neben den standortspezifischen Metadaten enthält die Standortkonfiguration die Metadaten für alle Geräte (Things; siehe auch Konzepte & Begriffe) einschließlich deren IDs, bereitgestellte Daten, Datenformate und Maßeinheiten.
Darüber hinaus enthält die Standortkonfiguration auch die gleichen Metadaten für den Energiefluss (siehe Konzepte & Begriffe), der Teil des Standortstatus ist.
Der Energiefluss ist eine abgeleitete Sicht auf die Gerätezustände und besteht aus:
- Energiedaten
- Erzeugte Energie, verbrauchte Energie, aus dem Netz entnommene und an das Netz abgegebene Energie, in der Batterie gespeicherte Energie, insgesamt verbrauchte Energie
- Leistungsdaten
- Strom aus der PV-Anlage, Strom, der aus dem Netz geliefert oder in das Netz eingespeist wird, Strom, der von allen Geräten am Standort verbraucht wird.
Weitere Informationen findest du in den Dokumentationen:
Gerätespezifische Daten
Die API stellt Energiedaten, Leistungsdaten und Statusdaten von Geräten zur Verfügung, die über den BEAAM mit neoom CONNECT verbunden sind und von diesem gesteuert werden.
Die über die BEAAM API verfügbaren Daten sind normalisiert. Das heißt, egal welche Einheit oder welches Format ein Energiegerät liefert, die BEAAM API übernimmt die Konvertierung und liefert verlässliche Daten für jeden unterstützten Hersteller, zum Beispiel wird Energie immer in Wh angegeben, auch wenn der Zähler nur kWh meldet.
Es ist zu beachten, dass die BEAAM API keine Persistenz, Langzeitverfolgung oder Aggregationen bietet. Dies bedeutet, wenn z.B. ein Zähler ausgetauscht wird, sind die Daten des alten Zählers nicht mehr über die API verfügbar und nur die Daten des neuen Zählers abrufbar, so wie sie von diesem gemeldet werden.
Eine Liste der gerätespezifischen Datenpunkte, die über die API ausgelesen werden können, findest du in der API-Spezifikation:
Schreibender Zugriff auf neoom BEAAM API
Es können keine Daten über die API in den BEAAM geschrieben werden.
.svg)
.png?width=25&height=26&name=Group%20(4).png){kind=small}
.png?width=600&height=300&name=Laptop%20neoom%20Screen%20(600%20%C3%97%20300%20px).png)
