Neargrid MQTT Driver
De volgende integratie kan worden gebruikt om sitemetingen via MQTT te verzenden en om commando's voor de verschillende geïnstalleerde apparaattype's te ontvangen.
Python demo script
Neem contact op met SmartgridOne om een dem script aan te vragen.
Voorwaarden
Cloud Controller
De sites worden gecontroleerd via een Cloud Controller. Neem alstublieft contact op met SmartgridOne om een nieuwe Cloud Controller in te stellen.
Site Setup
Zodra een Cloud Controller is aangemaakt, bevat deze een uniek serienummer (<Controller SN>).
Nieuwe sites kunnen op de Cloud Controller worden gegenereerd met unieke sitefilters <site_filter>
Deze twee variabelen moeten worden gebruikt in de MQTT-onderwerpen en het lichaam.
Warning
Het gebruik van identieke sitefilters kan leiden tot fouten.
Apparaatselectie
| Device Type | Ondersteund |
|---|---|
| Solar Inverters | ✅ |
| Storage Devices | |
| Heatpumps | |
| Grid & Consumption Meters | |
| EV Chargers | ❌ |
Note
De apparaten in een site kunnen niet worden bewerkt na creatie.
MQTT-inloggegevens
SmartgridOne zal MQTT-inloggegevens leveren. De MQTT-gebruikersnaam moet worden ingevoerd bij het genereren van een nieuwe site.
Note
De inloggegevens moeten slechts één keer worden geleverd. Eén set MQTT-inloggegevens kan worden gebruikt om alle sites te bedienen.
Metingen verzenden
Om metingen naar de SmartgridOne Controller te verzenden, kan het volgende MQTT-onderwerp worden gebruikt voor publicatie: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/
Optionele velden worden genoemd in cursief.
De volgende velden kunnen per apparaattype worden verzonden:
-
Opslag
- mean_soc_perc
- active_power_W
- today_charged_Wh
- today_discharged_Wh
- energy_stored_Wh
-
Zon
- active_power_W
- today_energy_Wh
-
Warmtepompen
- operation_modes
- Mogelijke werkmodi zijn uit, aan
- active_power_W
- Gelijk aan nominale vermogen terwijl de warmtepomp aan is
- operation_modes
-
Meters
- active_power_W
- today_imported_energy_Wh
- today_exported_energy_Wh
Het bericht moet als volgt worden gestructureerd:
{
"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"
}Bevestiging van metingen
Wanneer een meting succesvol is ontvangen, wordt een bevestiging verzonden op het volgende onderwerp: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>
Deze bevestiging kan worden gebruikt om:
- Te verifiëren dat het meetbericht succesvol is ontvangen.
- Te verifiëren dat het meetbericht alle noodzakelijke gegevens bevat.
Ontvangen van commando's
Om commando's van de SmartgridOne Controller te ontvangen, abonneert u zich op het volgende MQTT-onderwerp: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/
Het antwoord is als volgt gestructureerd:
{
"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
}
}De lijst van beleidsmaatregelen die kunnen worden ontvangen, is hier te vinden: Lijst van potentiële beleidsmaatregelen
