Taylor MQTT-drivrutin
Följande integration kan användas för att skicka mätvärden från anläggningen via MQTT och ta emot kommandon för de olika installerade enhetstyperna.
Python-demonstrationsskript
Kontakta Sofar för att begära ett demonstrationsskript.
Förutsättningar
Cloud Controller
Anläggningarna kommer att styras via en Cloud Controller. Kontakta EMS för att konfigurera en ny Cloud Controller.
Anläggningsinställning
När en Cloud Controller har skapats, kommer den att ha ett unikt serienummer (standard1/rp_one_s/taylor_ack/<site_filter>/<Controller SN>).
Nya anläggningar kan skapas på Cloud Controller med hjälp av unika anläggningsfilter standard1/outbound/taylor_cmd/<site_filter>/<Controller SN>/.
Dessa två variabler måste användas i MQTT Topics och Body.
Varning
Att använda identiska anläggningsfilter kommer att resultera i fel.
Enhetsval
| Device Type | Stöds |
|---|---|
| Solar Inverters | ✅ |
| Storage Devices | |
| Heatpumps | |
| Grid & Consumption Meters | |
| EV Chargers | ❌ |
Not
Enheterna i en anläggning kan inte redigeras efter skapandet.
MQTT-behörigheter
Sofar kommer att tillhandahålla MQTT-behörigheter. MQTT-användarnamnet måste anges vid skapande av en ny anläggning.
Not
Behörigheterna behöver endast tilldelas en gång. En uppsättning MQTT-behörigheter kan användas för att styra alla anläggningar.
Skicka mätvärden
För att skicka mätvärden till Sofar EMS, kan följande MQTT-topic användas vid publicering: standard1/outbound/taylor_meas/<site_filter>/<Controller SN>/
Valfria fält anges med kursiv stil.
Följande fält kan skickas per enhetstyp:
-
Lagring
- mean_soc_perc
- active_power_W
- today_charged_Wh
- today_discharged_Wh
- energy_stored_Wh
-
Sol
- active_power_W
- today_energy_Wh
-
Värmepumpar
- operation_modes
- Möjliga driftlägen är off, on
- active_power_W
- Motsvarar nominell effekt medan värmepumpen är på*
- operation_modes
-
Mätare
- active_power_W
- today_imported_energy_Wh
- today_exported_energy_Wh
Meddelandet måste vara strukturerat enligt följande:
{
"time": "<Unix Timestamp>",
"data": {
"state": {
"grid": {
"active_power_W": <Nätets aktiva effekt i watt>,
"today_imported_energy_Wh": <Inmatad energi från nätet i wattimmar>,
"today_exported_energy_Wh": <Utmatad energi till nätet i wattimmar>,
},
"meter": {
"active_power_W": <Nätets aktiva effekt i watt>,
"today_imported_energy_Wh": <Inmatad energi från nätet i wattimmar>,
"today_exported_energy_Wh": <Utmatad energi till nätet i wattimmar>,
},
"storage": {
"energy_stored_Wh": <Lagrad energi i wattimmar>,
"mean_soc_perc": <Genomsnittlig laddningsgrad i procent>,
"active_power_W": <Aktiv effekt i watt>,
"today_charged_Wh": <Laddad energi under dagen i wattimmar>,
"today_discharged_Wh": <Utladdad energi under dagen i wattimmar>,
},
"solar": {
"active_power_W": <Solens aktiva effekt i watt>,
"today_energy_Wh": <Producerad energi idag i wattimmar>.
},
"heat_pump": {
"active_power_W": <Värmepumpens aktiva effekt i watt>,
"operation_modes": <Värmepumpens driftläge>
}
},
"response_code": <Svarskod>
},
"fields": {},
"requestTime": "<Unix Timestamp>",
"time": "<Unix Timestamp>",
"siteNodeId": "<site_filter"
}Mätbekräftelse
När en mätning har mottagits framgångsrikt, skickas en bekräftelse på följande topic: standard1/rp_one_s/taylor_ack/<site_filter>/<Controller SN>
Denna bekräftelse kan användas för att:
- Verifiera att mätmeddelandet mottagits korrekt.
- Verifiera att mätmeddelandet innehöll all nödvändig data.
Ta emot kommandon
För att ta emot kommandon från Sofar EMS, prenumerera på följande MQTT-topic: standard1/outbound/taylor_cmd/<site_filter>/<Controller SN>/
Svaret är strukturerat enligt följande:
{
"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
}
}Listan över policies som kan mottas finns här: List of Potential Policies
