Taylor MQTT Driver
Poniższą integrację można użyć do wysyłania pomiarów z lokalizacji za pomocą MQTT oraz odbierania poleceń dla różnych typów zainstalowanych urządzeń.
Skrypt demonstracyjny w Pythonie
Skontaktuj się z Sofar, aby uzyskać skrypt demonstracyjny.
Wymagania wstępne
Cloud Controller
Lokalizacje będą sterowane za pomocą Cloud Controller. Proszę skontaktować się z EMS, aby utworzyć nowy Cloud Controller.
Konfiguracja lokalizacji
Po utworzeniu Cloud Controller będzie on zawierał unikalny numer seryjny (standard1/rp_one_s/taylor_ack/<site_filter>/<Controller SN>).
Nowe lokalizacje można wygenerować na Cloud Controller przy użyciu unikalnych filtrów lokalizacji standard1/outbound/taylor_cmd/<site_filter>/<Controller SN>/.
Te dwie zmienne muszą być użyte w tematach i treści MQTT.
Ostrzeżenie
Używanie identycznych filtrów lokalizacji spowoduje błędy.
Wybór urządzeń
| Device Type | Wspierane |
|---|---|
| Solar Inverters | ✅ |
| Storage Devices | |
| Heatpumps | |
| Grid & Consumption Meters | |
| EV Chargers | ❌ |
Notatka
Urządzeń w lokalizacji nie można edytować po jej utworzeniu.
Dane uwierzytelniające MQTT
Sofar dostarczy dane uwierzytelniające MQTT. Nazwa użytkownika MQTT musi zostać wprowadzona podczas generowania nowej lokalizacji.
Notatka
Dane uwierzytelniające muszą być podane tylko raz. Jeden zestaw danych uwierzytelniających MQTT może być użyty do kontrolowania wszystkich lokalizacji.
Wysyłanie pomiarów
Aby wysłać pomiary do Sofar EMS, można użyć następującego tematu MQTT do publikowania: standard1/outbound/taylor_meas/<site_filter>/<Controller SN>/
Pola opcjonalne są podane kursywą.
Poniższe pola mogą być wysyłane w zależności od typu urządzenia:
-
Magazyn energii
- mean_soc_perc
- active_power_W
- today_charged_Wh
- today_discharged_Wh
- energy_stored_Wh
-
Fotowoltaika
- active_power_W
- today_energy_Wh
-
Pompy ciepła
- operation_modes
- Możliwe tryby pracy to off, on
- active_power_W
- Równa się mocy nominalnej, gdy pompa jest on
- operation_modes
-
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>
Potwierdzenie pomiaru
Gdy pomiar zostanie pomyślnie odebrany, potwierdzenie zostanie wysłane na następujący temat: standard1/rp_one_s/taylor_ack/<site_filter>/<Controller SN>
Potwierdzenie to może być użyte do:
- Weryfikacji, że wiadomość pomiaru została pomyślnie odebrana.
- Weryfikacji, że wiadomość pomiaru zawierała wszystkie niezbędne dane.
Odbieranie poleceń
Aby otrzymywać polecenia z Sofar EMS, subskrybuj następujący temat MQTT: standard1/outbound/taylor_cmd/<site_filter>/<Controller SN>/
Odpowiedź ma następującą strukturę:
{
"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
}
}Listę polityk, które można otrzymać, znajdziesz tutaj:
