Sterownik Neargrid MQTT

Poniższa integracja może być użyta do wysyłania pomiarów z instalacji za pomocą MQTT oraz odbierania poleceń dla różnych typów zainstalowanych urządzeń.

Skrypt demonstracyjny w Pythonie

Skontaktuj się z Sofar, aby otrzymać skrypt demonstracyjny.

Wymagania wstępne

Cloud Controller

Instalacje będą zarządzane przez Cloud Controller. Prosimy o kontakt z EMS, aby utworzyć nowy Cloud Controller.

Konfiguracja instalacji

Po utworzeniu Cloud Controller, będzie on posiadał unikalny numer seryjny (standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>).

Nowe instalacje mogą być generowane na Cloud Controller za pomocą unikalnych filtrów instalacji standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/.

Te dwie zmienne muszą być użyte w tematach i treści MQTT.

Wybór urządzeń

Dane uwierzytelniające MQTT

Sofar dostarczy dane uwierzytelniające do MQTT. Nazwa użytkownika MQTT musi być podana podczas tworzenia nowej instalacji.

Wysyłanie pomiarów

Aby wysłać pomiary do Sofar EMS, można użyć następującego tematu MQTT do publikacji: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/

Pola opcjonalne są oznaczone kursywą.

Poniżej pola, które można wysyłać dla każdego typu urządzenia:

• Magazyn energii

  • mean_soc_perc
  • active_power_W
  • today_charged_Wh
  • today_discharged_Wh
  • energy_stored_Wh

• Energia słoneczna

  • active_power_W
  • today_energy_Wh

• Pompy ciepła

  • operation_modes
    • Możliwe tryby pracy to off, on
  • active_power_W
    • Równe mocy nominalnej podczas gdy pompa ciepła jest on

• Liczniki

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

Wiadomość musi być zbudowana w następujący sposób:

{
    "time": "<Unix Timestamp>",
    "data": {
        "state": {
            "grid": {
                "active_power_W": <Moc czynna sieci w watach>,
                "today_imported_energy_Wh": <Energia zaimportowana z sieci w watogodzinach>,
                "today_exported_energy_Wh": <Energia wyeksportowana do sieci w watogodzinach>,
            },
            "meter": {
                "active_power_W": <Moc czynna licznika w watach>,
                "today_imported_energy_Wh": <Energia zaimportowana przez licznik w watogodzinach>,
                "today_exported_energy_Wh": <Energia wyeksportowana przez licznik w watogodzinach>,
            },
            "storage": {
                "energy_stored_Wh": <Energia zgromadzona w watogodzinach>,
                "mean_soc_perc": <Średni stan naładowania w procentach>,
                "active_power_W": <Moc czynna w watach>,
                "today_charged_Wh": <Energia naładowana dzisiaj w watogodzinach>,
                "today_discharged_Wh": <Energia rozładowana dzisiaj w watogodzinach>,
            },
            "solar": {
                "active_power_W": <Moc czynna energii słonecznej w watach>,
                "today_energy_Wh": <Energia wyprodukowana dzisiaj w watogodzinach>.
            },
            "heat_pump": {
                "active_power_W": <Moc czynna pompy ciepła w watach>,
                "operation_modes": <Tryb pracy pompy ciepła>
            }
        },
        "response_code": <Kod odpowiedzi>
    },
    "fields": {},
    "requestTime": "<Unix Timestamp>",
    "time": "<Unix Timestamp>",
    "siteNodeId": "<site_filter"
}

Potwierdzenie odbioru pomiaru

Po pomyślnym odebraniu pomiaru, potwierdzenie zostanie wysłane na następujący temat: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>

Potwierdzenie to można wykorzystać do:

1. Zweryfikowania pomyślnego odebrania wiadomości pomiarowej.
2. Zweryfikowania, czy wiadomość pomiarowa zawierała wszystkie niezbędne dane.

Odbiór poleceń

Aby odbierać polecenia z Sofar EMS, subskrybuj następujący temat MQTT: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/

Odpowiedź jest zbudowana następująco:

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

Lista polityk, które mogą być odbierane, znajduje się tutaj: List of Potential Policies