Neargrid MQTT Driver

Følgende integration kan bruges til at sende målinger fra sites via MQTT og modtage kommandoer for de forskellige installerede enhedstyper.

Python demo script

Kontakt SmartgridOne for at anmode om et demo script.

Forudsætninger

Cloud Controller

Sites styres via en Cloud Controller. Kontakt venligst Controller for opsætning af en ny Cloud Controller.

Site Opsætning

Når en Cloud Controller er oprettet, vil den indeholde et unikt serienummer (standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>).

Nye sites kan genereres på Cloud Controlleren ved brug af unikke site-filtre standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/.

Disse to variable skal bruges i MQTT Topics og Body.

Enhedsvalg

MQTT Legitimationer

SmartgridOne leverer MQTT-legitimationer. MQTT brugernavnet skal indtastes ved generering af et nyt site.

Afsendelse af målinger

For at sende målinger til SmartgridOne Controller, kan følgende MQTT topic bruges til publicering: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/

Valgfrie felter er nævnt i kursiv.

Følgende felter kan sendes pr. enhedstype:

• Lager

  • mean_soc_perc
  • active_power_W
  • today_charged_Wh
  • today_discharged_Wh
  • energy_stored_Wh

• Sol

  • active_power_W
  • today_energy_Wh

• Varmepumper

  • operation_modes
    • Mulige driftstilstande er off, on
  • active_power_W
    • Svarende til nominel effekt mens varmepumpen er on

• Målere

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

Beskeden skal struktureres som følger:

{
    "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"
}

Måledata Bekræftelse

Når en måling er modtaget korrekt, sendes en bekræftelse på følgende topic: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>

Denne bekræftelse kan bruges til at:

1. Bekræfte at målebeskeden er modtaget korrekt.
2. Bekræfte at målebeskeden indeholdt alle nødvendige data.

Modtagelse af kommandoer

For at modtage kommandoer fra SmartgridOne Controller, abonnér på følgende MQTT topic: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/

Svaret er struktureret som følger:

{
    "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
    }
}

Listen over politikker der kan modtages findes her: List of Potential Policies