Sterownik Scholt MQTT

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

Skrypt demonstracyjny w Pythonie

Ten testowy kod wykonuje proste zadanie ciągłego wysyłania przykładowych pomiarów do instalacji oraz odbierania poleceń:

Proszę pobrać poniższy plik w swoim ulubionym IDE dla Pythona. Wprowadź swój numer seryjny, filtr instalacji oraz dane uwierzytelniające MQTT i uruchom skrypt:

Wymagania wstępne

Kontroler w chmurze

Instalacje będą kontrolowane za pomocą Kontrolera w chmurze. Proszę skontaktować się z EMS, aby utworzyć nowy Kontroler w chmurze.

Konfiguracja instalacji

Po utworzeniu Kontrolera w chmurze, będzie on posiadał unikalny numer seryjny (standard1/rp_one_s/scholt_ack/<site_filter>/<Controller SN>).

Nowe instalacje można tworzyć na Kontrolerze w chmurze, używając unikalnych filtrów instalacji standard1/outbound/scholt_cmd/<site_filter>/<Controller SN>/.

Zmienne te muszą być użyte w tematach i treści MQTT.

[!UWAGA] Użycie identycznych filtrów instalacji spowoduje błędy.

Wybór urządzenia

[!UWAGA] Urządzeń w instalacji nie można edytować po jej utworzeniu.

Dane uwierzytelniające MQTT

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

[!UWAGA] Dane uwierzytelniające należy podać tylko raz. Jeden zestaw danych MQTT może być użyty do kontrolowania wszystkich instalacji.

Wysyłanie pomiarów

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

Pola opcjonalne są oznaczone kursywą.

Poniższe pola mogą być wysyłane 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
    • Dostępne tryby pracy: off, on
  • active_power_W
    • Równa się mocy znamionowej podczas pracy pompy ciepła w trybie on

• Liczniki

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

Wiadomość musi mieć strukturę:

{
    "time": "<Unix Timestamp>",
    "data": {
        "state": {
            "grid": {
                "active_power_W": <Moc czynna sieci w watach>,
                "today_imported_energy_Wh": <Energia zaimportowana sieci w watogodzinach>,
                "today_exported_energy_Wh": <Energia wyeksportowana sieci w watogodzinach>,
            },
            "meter": {
                "active_power_W": <Moc czynna licznika w watach>,
                "today_imported_energy_Wh": <Energia zaimportowana licznika w watogodzinach>,
                "today_exported_energy_Wh": <Energia wyeksportowana licznika 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 dziś w watogodzinach>,
                "today_discharged_Wh": <Energia rozładowana dziś w watogodzinach>,
            },
            "solar": {
                "active_power_W": <Moc czynna paneli słonecznych w watach>,
                "today_energy_Wh": <Energia wyprodukowana dziś 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 pomiaru

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

To potwierdzenie można wykorzystać do:

1. Weryfikacji, że wiadomość pomiarowa została poprawnie odebrana.
2. Weryfikacji, że wiadomość pomiarowa zawierała wszystkie niezbędne dane.

Odbieranie poleceń

Aby odbierać polecenia z Sofar EMS, należy zasubskrybować następujący temat MQTT: standard1/outbound/scholt_cmd/<site_filter>/<Controller SN>/

Odpowiedź ma strukturę:

{
    "extraTags": {
        "nodeId": "<Controller SN>_site_0"
    },
    "time": "<Unix Timestamp>",
    "fields": {
        "solar_policy": "<polityka>",
        "solar_power_setpoint_w": 5000,
        "storage_policy": "<polityka>",
        "storage_power_setpoint_w": -5000
    }
}

Listę polityk, które można otrzymać, można znaleźć tutaj: List of Potential Policies