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.

Apparaatselectie

MQTT-inloggegevens

SmartgridOne zal MQTT-inloggegevens leveren. De MQTT-gebruikersnaam moet worden ingevoerd bij het genereren van een nieuwe site.

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

• 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:

1. Te verifiëren dat het meetbericht succesvol is ontvangen.
2. 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