Die folgende Integration kann verwendet werden, um Standortmessungen über MQTT zu senden und Befehle für die verschiedenen installierten Gerätetypen zu empfangen.
Kontaktieren Sie Sofar, um ein Demo-Skript anzufordern.
Die Standorte werden über einen Cloud-Controller gesteuert. Bitte kontaktieren Sie Sofar, um einen neuen Cloud-Controller einzurichten.
Sobald ein Cloud-Controller erstellt wurde, enthält er eine eindeutige Seriennummer (<Controller SN>).
Neue Standorte können auf dem Cloud-Controller mit einzigartigen Standortfiltern <site_filter> erstellt werden.
Diese beiden Variablen müssen in den MQTT-Themen und dem Body verwendet werden.
Die Verwendung identischer Standortfilter führt zu Fehlern.
| Device Type | Unterstützt |
|---|---|
| Solar Inverters | ✅ |
| Storage Devices | |
| Heatpumps | |
| Grid & Consumption Meters | |
| EV Chargers | ❌ |
Die Geräte in einem Standort können nach der Erstellung nicht mehr bearbeitet werden.
Sofar wird die MQTT-Anmeldeinformationen bereitstellen. Der MQTT-Benutzername muss bei der Erstellung eines neuen Standorts eingegeben werden.
Die Anmeldeinformationen müssen nur einmal bereitgestellt werden. Ein Satz von MQTT-Anmeldeinformationen kann zur Steuerung aller Standorte verwendet werden.
Um Messwerte an die Sofar EMS zu senden, kann folgendes MQTT-Thema zum Veröffentlichen verwendet werden: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/
Optionale Felder werden in kursiv erwähnt.
Die folgenden Felder können pro Gerätetyp gesendet werden:
Speicher
Solar
Wärmepumpen
Zähler
Die Nachricht muss wie folgt strukturiert sein:
{
"time": "<Unix Timestamp>",
"data": {
"state": {
"grid": {
"active_power_W": <Grid Aktive Leistung in Watt>,
"today_imported_energy_Wh": <Grid Importierte Energie in Wattstunden>
Wenn ein Messwert erfolgreich empfangen wurde, wird eine Bestätigung auf folgendem Thema gesendet: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>
Diese Bestätigung kann verwendet werden, um:
Um Befehle von der Sofar EMS zu empfangen, abonnieren Sie folgendes MQTT-Thema: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/
Die Antwort ist wie folgt strukturiert:
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": "<Unix Timestamp>",
"fields": {
"solar_policy": "<policy>",
"solar_power_setpoint_w": 5000,
"storage_policy": "<policy>",
"storage_power_setpoint_w": -5000
}
}Die Liste der empfangbaren Richtlinien finden Sie hier: