Neargrid MQTT Drivrutin

Följande integration kan användas för att skicka platsmätningar via MQTT och ta emot kommandon för de olika enhetstyper som är installerade.

Python demo-skript

Kontakta Eniris för att begära ett demo-skript.

Förutsättningar

Molnkontroller

Platsen kommer att kontrolleras via en Molnkontroller. Vänligen kontakta Eniris för att ställa in en ny Molnkontroller.

Platsinställning

När en Molnkontroller har skapats kommer den att innehålla ett unikt serienummer (<Controller SN>).

Nya platser kan genereras på Molnkontrollen med hjälp av unika platsfilter <site_filter>.

Dessa två variabler måste användas i MQTT-ämnen och kropp.

warning

Att använda identiska platsfilter kommer att resultera i fel.

Enhetsval

Device Type	Stödd
Solpaneler	✅
Lagringsenheter
Värmepumpar
Nät- & Förbrukningsmätare
Elbilsladdare	❌

info

Enheterna på en plats kan inte redigeras efter skapandet.

MQTT-uppgifter

Eniris kommer att tillhandahålla MQTT-uppgifter. MQTT-användarnamnet måste anges vid generering av en ny plats.

info

Uppgifterna måste endast lämnas en gång. Ett set med MQTT-uppgifter kan användas för att kontrollera alla platser.

Skicka mätningar

För att skicka mätningar till SmartgridOne Controller, kan följande MQTT-ämne användas för publicering: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/

Valfria fält anges i kursiv.

Följande fält kan skickas per enhetstyp:

• Lagring

  • mean_soc_perc
  • active_power_W
  • today_charged_Wh
  • today_discharged_Wh
  • energy_stored_Wh

• Solenergi

  • active_power_W
  • today_energy_Wh

• Värmepumpar

  • operation_modes
    • Möjliga driftlägen är av, på
  • active_power_W
    • Lika med nominell effekt medan värmepumpen är på

• Mätare

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

Meddelandet måste struktureras enligt följande:

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

Bekräftelse av mätning

När en mätning har mottagits framgångsrikt, kommer en bekräftelse att skickas på följande ämne: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>

Denna bekräftelse kan användas för att:

1. Verifiera att mätningens meddelande mottogs framgångsrikt.
2. Verifiera att mätningens meddelande innehöll alla nödvändiga data.

Mottagning av kommandon

För att ta emot kommandon från SmartgridOne Controller, prenumerera på följande MQTT-ämne: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/

Svaret är strukturerat som följer:

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

Listan över policyer som kan tas emot finns här: Lista över potentiella policyer