Neargrid MQTT Treiber

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

Python-Demoskript

Wenden Sie sich an Sofar, um ein Demoskript anzufordern.

Voraussetzungen

Cloud Controller

Die Standorte werden über einen Cloud Controller gesteuert. Bitte wenden Sie sich an Sofar, um einen neuen Cloud Controller einzurichten.

Standorteinrichtung

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

Neue Standorte können im Cloud Controller mithilfe eindeutiger Standortfilter generiert werden: <site_filter>

Diese beiden Variablen müssen in den MQTT-Topics und im Nachrichteninhalt verwendet werden.

Geräteauswahl

MQTT-Anmeldedaten

Fordern Sie die Eniris-MQTT-Anmeldedaten über den Eniris-Webshop an. Der bereitgestellte MQTT-Benutzername muss bei der Erstellung eines neuen Standorts eingegeben werden.

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

Messwerte senden

Um Messwerte an den Sofar EMS zu senden, kann das folgende MQTT-Topic zum Veröffentlichen verwendet werden: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/

Optionale Felder sind in Kursivschrift.

Die folgenden Felder können je nach 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 ausgeschaltet, eingeschaltet
  • active_power_W
    • Entspricht der Nennleistung, während die Wärmepumpe eingeschaltet

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

Bestätigung des Messwerterhalts

Wenn ein Messwert erfolgreich empfangen wurde, wird eine Bestätigung über das folgende Topic 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 vom Sofar EMS zu empfangen, abonnieren Sie das folgende MQTT-Topic: 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 möglicher Richtlinien