Neargrid MQTT Driver

De volgende integratie kan worden gebruikt om terreinmetingen via MQTT te verzenden en opdrachten te ontvangen voor de verschillende types apparaten die zijn geïnstalleerd.

Python demo script

Neem contact op met Eniris om een demo script aan te vragen.

Vereisten

Cloud Controller

De sites worden beheerd via een Cloud Controller. Neem contact op met Eniris 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 Topics en Body.

waarschuwing

Het gebruik van identieke sitefilters leidt tot fouten.

Apparaatselectie

Device Type	Ondersteund
Zonne-omvormers	✅
Opslagapparaten
Warmtepompen
Net- en verbruiksmeters
EV-opladers	❌

info

De apparaten in een site kunnen na creatie niet meer worden bewerkt.

MQTT-gegevens

Eniris zal de MQTT-gegevens verstrekken. De MQTT-gebruikersnaam moet worden ingevoerd bij het genereren van een nieuwe site.

info

De gegevens moeten slechts één keer worden verstrekt. Eén set MQTT-gegevens kan worden gebruikt om alle sites te beheren.

Metingen verzenden

Om metingen naar de SmartgridOne Controller te verzenden, kan het volgende MQTT-topic worden gebruikt voor publicatie: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/

Optionele velden worden in cursief vermeld.

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

  • active_power_W
  • today_energy_Wh

• Warmtepompen

  • operation_modes
    • Mogelijke bedrijfsmodi zijn uit, aan
  • active_power_W
    • Gelijk aan het nominale vermogen terwijl de warmtepomp aan

• Meters

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

Het bericht moet als volgt zijn gestructureerd:

{
    "time": "<Unix Timestamp>",
    "data": {
        "state": {
            "grid": {
                "active_power_W": <Grid Actief Vermogen in Watts>,
                "today_imported_energy_Wh": <Grid Geïmporteerde Energie in Watt-uur>,
                "today_exported_energy_Wh": <Grid Geëxporteerde Energie in Watt-uur>,
            },
            "meter": {
                "active_power_W": <Grid Actief Vermogen in Watts>,
                "today_imported_energy_Wh": <Grid Geïmporteerde Energie in Watt-uur>,
                "today_exported_energy_Wh": <Grid Geëxporteerde Energie in Watt-uur>,
            },
            "storage": {
                "energy_stored_Wh": <Energie Opgeslagen in Watt-uur>,
                "mean_soc_perc": <Gemiddeld Percentage van de Laadstatus>,
                "active_power_W": <Actief Vermogen in Watts>,
                "today_charged_Wh": <Energie Die Heden Is Opgeladen in Watt-uur>,
                "today_discharged_Wh": <Energie Die Heden Is Ontladen in Watt-uur>,
            },
            "solar": {
                "active_power_W": <Zonne Actief Vermogen in Watts>,
                "today_energy_Wh": <Energie Geproduceerd Heden in Watt-uur>.
            },
            "heat_pump": {
                "active_power_W": <Warmtepomp Actief Vermogen in Watts>,
                "operation_modes": <Warmtepomp Bedrijfsstijl>
            }
        },
        "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:

1. Te verifiëren dat het metingsbericht succesvol is ontvangen.
2. Te verifiëren dat het metingsbericht alle benodigde gegevens bevat.

Opdrachten Ontvangen

Om opdrachten van de SmartgridOne Controller te ontvangen, abonneer je 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 beleidsmaatregelen die kunnen worden ontvangen is hier te vinden: Lijst van Potentiële Beleidsmaatregelen