Neargrid MQTT Driver
De volgende integratie kan worden gebruikt om site-metinggegevens te verzenden via MQTT en om commando's te ontvangen voor de verschillende geïnstalleerde apparaattype.
Python demo script
Neem contact op met SmartgridOne om een demo script aan te vragen.
Vereisten
Cloud Controller
De sites worden aangestuurd via een Cloud Controller. Neem contact op met Controller om een nieuwe Cloud Controller op te zetten.
Site Setup
Zodra een Cloud Controller is aangemaakt, bevat deze een uniek serienummer (standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>).
Nieuwe sites kunnen worden aangemaakt op de Cloud Controller met behulp van unieke site-filters standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/.
Deze twee variabelen moeten worden gebruikt in de MQTT Topics en Body.
Waarschuwing
Het gebruik van identieke site-filters zal resulteren in fouten.
Apparaat Selectie
| Device Type | Ondersteund |
|---|---|
| Solar Inverters | ✅ |
| Storage Devices | |
| Heatpumps | |
| Grid & Consumption Meters | |
| EV Chargers | ❌ |
Opmerking
De apparaten in een site kunnen niet worden aangepast nadat ze zijn aangemaakt.
MQTT Referenties
SmartgridOne zal MQTT-referenties leveren. De MQTT-gebruikersnaam moet worden ingevuld bij het genereren van een nieuwe site.
Opmerking
De referenties hoeven maar één keer opgegeven te worden. Eén set MQTT-referenties kan worden gebruikt om alle sites te beheren.
Metingen verzenden
Om metingen te versturen naar de SmartgridOne Controller, kan het volgende MQTT topic worden gebruikt om te publiceren: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/
Optionele velden worden weergegeven 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
-
Zonne-energie
- active_power_W
- today_energy_Wh
-
Warmtepompen
- operation_modes
- Mogelijke bedrijfsmodi zijn off, on
- active_power_W
- Gelijk aan nominaal vermogen terwijl 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 Actief Vermogen in Watt>,
"today_imported_energy_Wh": <Grid Geïmporteerde Energie in Wattuur>,
"today_exported_energy_Wh": <Grid Geëxporteerde Energie in Wattuur>,
},
"meter": {
"active_power_W": <Grid Actief Vermogen in Watt>,
"today_imported_energy_Wh": <Grid Geïmporteerde Energie in Wattuur>,
"today_exported_energy_Wh": <Grid Geëxporteerde Energie in Wattuur>,
},
"storage": {
"energy_stored_Wh": <Energie Opgeslagen in Wattuur>,
"mean_soc_perc": <Gemiddeld Laadpercentage>,
"active_power_W": <Actief Vermogen in Watt>,
"today_charged_Wh": <Vandaag Geoplaade Energie in Wattuur>,
"today_discharged_Wh": <Vandaag Ontladen Energie in Wattuur>,
},
"solar": {
"active_power_W": <Zonne Actief Vermogen in Watt>,
"today_energy_Wh": <Vandaag Geproduceerde Energie in Wattuur>.
},
"heat_pump": {
"active_power_W": <Warmtepomp Actief Vermogen in Watt>,
"operation_modes": <Bedrijfsmodus Warmtepomp>
}
},
"response_code": <Response Code>
},
"fields": {},
"requestTime": "<Unix Timestamp>",
"time": "<Unix Timestamp>",
"siteNodeId": "<site_filter"
}Ontvangstbevestiging Meting
Wanneer een meting succesvol ontvangen is, wordt een ontvangstbevestiging gestuurd op het volgende topic: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>
Deze ontvangstbevestiging kan worden gebruikt om:
- Te verifiëren dat het meetbericht succesvol is ontvangen.
- Te verifiëren dat het meetbericht alle benodigde gegevens bevatte.
Commando's ontvangen
Om commando's te ontvangen van de SmartgridOne Controller, abonneer op het volgende MQTT topic: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/
De respons 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 met beleid die kan worden ontvangen is hier te vinden: List of Potential Policies
