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 Sofar om een demo script aan te vragen.

Vereisten

Cloud Controller

De sites worden aangestuurd via een Cloud Controller. Neem contact op met EMS 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.

Apparaat Selectie

MQTT Referenties

Sofar zal MQTT-referenties leveren. De MQTT-gebruikersnaam moet worden ingevuld bij het genereren van een nieuwe site.

Metingen verzenden

Om metingen te versturen naar de Sofar EMS, 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

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

1. Te verifiëren dat het meetbericht succesvol is ontvangen.
2. Te verifiëren dat het meetbericht alle benodigde gegevens bevatte.

Commando's ontvangen

Om commando's te ontvangen van de Sofar EMS, 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