Neargrid MQTT Treiber

Die folgende Integration kann verwendet werden, um Standortmessungen ü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 SmartgridOne, um einen neuen Cloud-Controller einzurichten.

Standortkonfiguration

Sobald ein Cloud-Controller erstellt wurde, enthält er eine eindeutige Seriennummer (<Controller SN>).

Neue Standorte können auf dem Cloud-Controller mit einzigartigen Standortfiltern <site_filter> erstellt werden.

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

Gerät Auswahl

MQTT-Anmeldeinformationen

SmartgridOne wird die MQTT-Anmeldeinformationen bereitstellen. Der MQTT-Benutzername muss bei der Erstellung eines neuen Standorts eingegeben werden.

Messwerte senden

Um Messwerte an die SmartgridOne Controller zu senden, kann folgendes MQTT-Thema zum Veröffentlichen verwendet werden: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/

Optionale Felder werden in kursiv erwähnt.

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 aus, ein
  • active_power_W
    • Entspricht der Nennleistung, während die Wärmepumpe einschaltet

• 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": <Grid Aktive Leistung in Watt>,
                "today_imported_energy_Wh": <Grid Importierte Energie in Wattstunden>,
                "today_exported_energy_Wh": <Grid Exportierte Energie in Wattstunden>,
            },
            "meter": {
                "active_power_W": <Grid Aktive Leistung in Watt>,
                "today_imported_energy_Wh": <Grid Importierte Energie in Wattstunden>,
                "today_exported_energy_Wh": <Grid Exportierte Energie in Wattstunden>,
            },
            "storage": {
                "energy_stored_Wh": <Energie gespeichert in Wattstunden>,
                "mean_soc_perc": <Mittlerer Ladezustandsprozentsatz>,
                "active_power_W": <Aktive Leistung in Watt>,
                "today_charged_Wh": <Energie, die am aktuellen Tag in Wattstunden geladen wurde>,
                "today_discharged_Wh": <Energie, die am aktuellen Tag in Wattstunden entladen wurde>,
            },
            "solar": {
                "active_power_W": <Solar Aktive Leistung in Watt>,
                "today_energy_Wh": <Energie, die heute in Wattstunden produziert wurde>.
            },
            "heat_pump": {
                "active_power_W": <Wärmepumpen Aktive Leistung in Watt>,
                "operation_modes": <Betriebsmodus der Wärmepumpe>
            }
        },
        "response_code": <Antwortcode>
    },
    "fields": {},
    "requestTime": "<Unix Timestamp>",
    "time": "<Unix Timestamp>",
    "siteNodeId": "<site_filter"
}

Messwertbestätigung

Wenn ein Messwert erfolgreich empfangen wurde, wird eine Bestätigung auf folgendem 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 Messwertnachricht erfolgreich empfangen wurde.
2. Zu überprüfen, ob die Messwertnachricht alle erforderlichen Daten enthielt.

Befehle empfangen

Um Befehle von der SmartgridOne Controller zu empfangen, abonnieren Sie folgendes 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 empfangbaren Richtlinien finden Sie hier: Liste der möglichen Richtlinien