Sterownik MQTT Neargrid

Następująca integracja może być używana do przesyłania pomiarów lokalnych za pośrednictwem MQTT oraz odbierania poleceń dla różnych typów zainstalowanych urządzeń.

Przykładowy skrypt w Pythonie

Skontaktuj się z Eniris, aby poprosić o przykładowy skrypt.

Wymagania wstępne

Kontroler chmurowy

Lokalizacje będą kontrolowane za pomocą Kontrolera Chmurowego. Proszę skontaktować się z Eniris, aby skonfigurować nowy Kontroler Chmurowy.

Konfiguracja lokalizacji

Po utworzeniu Kontrolera Chmurowego, będzie on zawierał unikalny numer seryjny (<Controller SN>).

Nowe lokalizacje mogą być generowane na Kontrolerze Chmurowym przy użyciu unikalnych filtrów lokalizacji <site_filter>.

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

warning

Użycie identycznych filtrów lokalizacji spowoduje błędy.

Wybór urządzenia

Device Type	Obsługiwane
Inwertery słoneczne	✅
Urządzenia magazynujące
Pompy ciepła
Liczniki energii i zużycia
Ładowarki EV	❌

informacja

Urządzenia w lokalizacji nie mogą być edytowane po utworzeniu.

Poświadczenia MQTT

Eniris dostarczy poświadczenia MQTT. Nazwa użytkownika MQTT musi być wpisana podczas generowania nowej lokalizacji.

informacja

Poświadczenia muszą być dostarczone tylko raz. Jeden zestaw poświadczeń MQTT można użyć do kontrolowania wszystkich lokalizacji.

Wysyłanie pomiarów

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

Opcjonalne pola są oznaczone kursywą.

Następujące pola można wysyłać dla każdego typu urządzenia:

• Magazyn

  • mean_soc_perc
  • active_power_W
  • today_charged_Wh
  • today_discharged_Wh
  • energy_stored_Wh

• Słońce

  • active_power_W
  • today_energy_Wh

• Pompy ciepła

  • operation_modes
    • Możliwe tryby pracy to wyłączony, włączony
  • active_power_W
    • Równy nominalnej mocy podczas pracy pompy ciepła

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

Potwierdzenie pomiaru

Gdy pomiar zostanie pomyślnie odebrany, potwierdzenie zostanie wysłane na następujący temat: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>

To potwierdzenie może być użyte do:

1. Weryfikacji, że wiadomość z pomiarami została odebrana pomyślnie.
2. Weryfikacji, że wiadomość z pomiarami zawierała wszystkie niezbędne dane.

Odbieranie poleceń

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

Odpowiedź jest zbudowana w następujący sposób:

{
    "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 można otrzymać, znajduje się tutaj: Lista potencjalnych polityk