Neargrid MQTT Driver
Følgende integration kan bruges til at sende målinger fra sites via MQTT og modtage kommandoer for de forskellige installerede enhedstyper.
Python demo script
Kontakt Sofar for at anmode om et demo script.
Forudsætninger
Cloud Controller
Sites styres via en Cloud Controller. Kontakt venligst EMS for opsætning af en ny Cloud Controller.
Site Opsætning
Når en Cloud Controller er oprettet, vil den indeholde et unikt serienummer (standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>).
Nye sites kan genereres på Cloud Controlleren ved brug af unikke site-filtre standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/.
Disse to variable skal bruges i MQTT Topics og Body.
Advarsel
Brug af identiske site-filtre vil resultere i fejl.
Enhedsvalg
| Device Type | Understøttet |
|---|---|
| Solar Inverters | ✅ |
| Storage Devices | |
| Heatpumps | |
| Grid & Consumption Meters | |
| EV Chargers | ❌ |
Note
Enhederne i et site kan ikke redigeres efter oprettelsen.
MQTT Legitimationer
Sofar leverer MQTT-legitimationer. MQTT brugernavnet skal indtastes ved generering af et nyt site.
Note
Legitimationerne skal kun leveres én gang. Ét sæt MQTT-legitimationer kan bruges til at styre alle sites.
Afsendelse af målinger
For at sende målinger til Sofar EMS, kan følgende MQTT topic bruges til publicering: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/
Valgfrie felter er nævnt i kursiv.
Følgende felter kan sendes pr. enhedstype:
-
Lager
- mean_soc_perc
- active_power_W
- today_charged_Wh
- today_discharged_Wh
- energy_stored_Wh
-
Sol
- active_power_W
- today_energy_Wh
-
Varmepumper
- operation_modes
- Mulige driftstilstande er off, on
- active_power_W
- Svarende til nominel effekt mens varmepumpen er on
- operation_modes
-
Målere
- active_power_W
- today_imported_energy_Wh
- today_exported_energy_Wh
Beskeden skal struktureres som følger:
{
"time": "<Unix Timestamp>",
"data": {
"state": {
"grid": {
"active_power_W": <Grid Active Power in Watts>,
"today_imported_energy_Wh": <Grid Imported Energy in Watt-hours>,
"today_exported_energy_Wh": <Grid Exported Energy in Watt-hours>,
},
"meter": {
"active_power_W": <Grid Active Power in Watts>,
"today_imported_energy_Wh": <Grid Imported Energy in Watt-hours>,
"today_exported_energy_Wh": <Grid Exported Energy in Watt-hours>,
},
"storage": {
"energy_stored_Wh": <Energy Stored in Watt-hours>,
"mean_soc_perc": <Mean State of Charge Percentage>,
"active_power_W": <Active Power in Watts>,
"today_charged_Wh": <Energy Charged on the Current Today in Watt-hours>,
"today_discharged_Wh": <Energy Discharged on the Current Today in Watt-hours>,
},
"solar": {
"active_power_W": <Solar Active Power in Watts>,
"today_energy_Wh": <Energy Produced Today in Watt-hours>.
},
"heat_pump": {
"active_power_W": <Heat Pump Active Power in Watts>,
"operation_modes": <Heat Pump Operation Mode>
}
},
"response_code": <Response Code>
},
"fields": {},
"requestTime": "<Unix Timestamp>",
"time": "<Unix Timestamp>",
"siteNodeId": "<site_filter"
}Måledata Bekræftelse
Når en måling er modtaget korrekt, sendes en bekræftelse på følgende topic: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>
Denne bekræftelse kan bruges til at:
- Bekræfte at målebeskeden er modtaget korrekt.
- Bekræfte at målebeskeden indeholdt alle nødvendige data.
Modtagelse af kommandoer
For at modtage kommandoer fra Sofar EMS, abonnér på følgende MQTT topic: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/
Svaret er struktureret som følger:
{
"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
}
}Listen over politikker der kan modtages findes her: List of Potential Policies