Neargrid MQTT Treiber

Die folgende Integration kann verwendet werden, um Messwerte von Standorten über MQTT zu senden und Befehle für die verschiedenen installierten Gerätetypen zu empfangen.

Python-Demo-Skript

Kontaktieren Sie SmartgridOne, um ein Demo-Skript anzufordern.

Voraussetzungen

Cloud Controller

Die Standorte werden über einen Cloud Controller gesteuert. Bitte kontaktieren Sie Controller, um einen neuen Cloud Controller einzurichten.

Standort-Einrichtung

Sobald ein Cloud Controller erstellt wurde, enthält er eine eindeutige Seriennummer (standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>).

Neue Standorte können im Cloud Controller mit eindeutigen Standortfiltern standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/ erstellt werden.

Diese beiden Variablen müssen in den MQTT-Themen und im Body verwendet werden.

Geräteauswahl

MQTT-Zugangsdaten

SmartgridOne stellt die MQTT-Zugangsdaten bereit. Der MQTT-Benutzername muss bei der Erstellung eines neuen Standorts eingegeben werden.

Senden von Messwerten

Um Messwerte an den SmartgridOne Controller zu senden, kann folgendes MQTT-Thema für das Publishing verwendet werden: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/

Optionale Felder sind kursiv angegeben.

Die folgenden Felder können pro Gerätetyp gesendet werden:

• Speicher

  • mean_soc_perc
  • active_power_W
  • today_charged_Wh
  • today_discharged_Wh
  • energy_stored_Wh

• Solar

  • active_power_W
  • today_energy_Wh

• Wärmepumpen

  • operation_modes
    • Mögliche Betriebsmodi sind off, on
  • active_power_W
    • Entspricht der Nennleistung, wenn die Wärmepumpe eingeschaltet ist

• Zähler

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

Die Nachricht muss wie folgt strukturiert sein:

{
    "time": "<Unix Timestamp>",
    "data": {
        "state": {
            "grid": {
                "active_power_W": <Netz Wirkleistung in Watt>,
                "today_imported_energy_Wh": <Netz importierte Energie in Wattstunden>,
                "today_exported_energy_Wh": <Netz exportierte Energie in Wattstunden>
            },
            "meter": {
                "active_power_W": <Netz Wirkleistung in Watt>,
                "today_imported_energy_Wh": <Netz importierte Energie in Wattstunden>,
                "today_exported_energy_Wh": <Netz exportierte Energie in Wattstunden>
            },
            "storage": {
                "energy_stored_Wh": <Gespeicherte Energie in Wattstunden>,
                "mean_soc_perc": <Durchschnittlicher Ladezustand in Prozent>,
                "active_power_W": <Wirklast in Watt>,
                "today_charged_Wh": <Heute geladene Energie in Wattstunden>,
                "today_discharged_Wh": <Heute entladene Energie in Wattstunden>
            },
            "solar": {
                "active_power_W": <Solar Wirkleistung in Watt>,
                "today_energy_Wh": <Heute erzeugte Energie in Wattstunden>
            },
            "heat_pump": {
                "active_power_W": <Wärmepumpe Wirkleistung in Watt>,
                "operation_modes": <Betriebsmodus der Wärmepumpe>
            }
        },
        "response_code": <Antwortcode>
    },
    "fields": {},
    "requestTime": "<Unix Timestamp>",
    "time": "<Unix Timestamp>",
    "siteNodeId": "<site_filter>"
}

Bestätigung der Messung

Nach erfolgreichem Empfang einer Messung wird eine Bestätigung über das folgende Thema gesendet: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>

Diese Bestätigung kann verwendet werden, um:

1. Zu überprüfen, ob die Messnachricht erfolgreich empfangen wurde.
2. Zu verifizieren, dass die Messnachricht alle notwendigen Daten enthielt.

Befehle empfangen

Um Befehle vom SmartgridOne Controller zu empfangen, abonnieren Sie das folgende MQTT-Thema: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/

Die Antwort ist wie folgt strukturiert:

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

Die Liste der möglichen Policies finden Sie hier: List of Potential Policies