Shelly Plug S Integráció az ADA P1 Meter-rel
Ez a dokumentáció bemutatja, hogyan lehet egy Shelly Plug S eszközt integrálni az ADA P1 Meter rendszerébe, amely a lokális hálózaton keresztül fogadja az eszköz által gyűjtött mérési adatokat, majd azokat továbbítja az okosvillanyora.hu rendszerbe.

ADA P1 Meter Firmware verzió: 1.2.77 vagy újabb szükséges
Működési elv
-
A Shelly Plug S egyedi mérési adatokat szolgáltat:
-
Feszültség (Voltage)
-
Áramerősség (Current)
-
Teljesítmény (Power)
-
Fogyasztás összesen (Total Energy)
-
-
A Shelly meghatározott időközönként (pl. 60 mp) HTTP POST kérést küld az ADA P1 Server /write végpontjára.
-
Az ADA P1 Server beilleszti az érkező adatokat a saját JSON struktúrájába, a
plugins
kulcs alá. -
Az okosvillanyora.hu dashboard felismeri a plugin adatokat, grafikonon megjeleníti azokat.
JSON adatformátum
A Shelly az alábbi formátumú JSON adatot küld:
{
"device": "Shelly01",
"values": [
{ "index": 0, "name": "Shelly01_total", "value": 1234.56, "unit": "Wh" },
{ "index": 1, "name": "Shelly01_voltage", "value": 230.1, "unit": "V" },
{ "index": 2, "name": "Shelly01_current", "value": 0.41, "unit": "A" },
{ "index": 3, "name": "Shelly01_power", "value": 94.4, "unit": "W" }
]
}
Az ADA P1 firmware automatikusan feldolgozza az ilyen formában érkező adatokat, amennyiben azok a plugins
alá illeszkednek.
Shelly scriptrészlet (Shelly Plug S belső szkripting)
Timer.set(60000, true, function () {
Shelly.call("Switch.GetStatus", { id: 0 }, function (res) {
if (res && res.apower !== undefined) {
let jsonData = {
device: "plugins", // ⬅️ kötelező kulcs!
values: [
{ index: 0, name: "Shelly01_total", value: res.aenergy.total, unit: "Wh" },
{ index: 1, name: "Shelly01_voltage", value: res.voltage, unit: "V" },
{ index: 2, name: "Shelly01_current", value: res.current, unit: "A" },
{ index: 3, name: "Shelly01_power", value: res.apower, unit: "W" }
]
};
let payload = JSON.stringify(jsonData);
print("Küldés: " + payload);
Shelly.call("HTTP.POST", {
url: "http://okosvillanyora.local:8989/write",
headers: { "Content-Type": "application/json" },
body: payload
}, function (response, error_code, error_msg) {
if (error_code === 0) {
print("✅ Sikeres küldés");
} else {
print("❌ Hiba a küldésnél: " + error_msg);
}
});
} else {
print("❌ Nem sikerült lekérni a Switch státuszt.");
print(JSON.stringify(res));
}
});
});
A fenti kód 1 percenként átadja a Shelly Plug S konnektor adatait az ADA P1 Meter-nek. Ezeket az adatokat az ADA P1 Meter feldolgozza és publikálja JSON kimenetén. Ugyanezt a JSON stringet küldi el MQTT brokeren a Home Assistant és az okosvillanyora.hu felé is.
Ajánlás: Adatküldés gyakorisága
Az ADA P1 Server ESP32-alapú mikrokontrolleren fut, amely egyszerre több feladatot kezel. Fontos, hogy ne terheljük feleslegesen a /write végpontot.
Ajánlott küldési gyakoriság:
-
Legalább 60 mp időköz a POST kérések között
-
Egyszerre maximum 4-5 érték küldése javasolt
-
Minden eszköz kapjon egyedi
name
nevet
Az így beküldött adatok az okosvillanyora.hu rendszerében is automatikusan elmentésre kerülnek.
Vizualizáció
Az átküldött mérési adatok a dashboardon automatikusan megjelennek a "plugin" prefixű mezők alatt, valamint elérhetők a CSV exportban is plugin_Shelly01_total
, plugin_Shelly01_voltage
stb. néven.
Ha több Shelly eszköz üzemel a hálózaton, mindegyik egyedi name
kulcsot használjon, pl.: Shelly01
, Shelly02
, stb. Ez lehetővé teszi a különböző eszközök megkülönböztetését a dashboard felületen.
Bővített mérések a Shelly eszközökkel – új lehetőségek a rendszer átláthatóságában
A Shelly termékcsaládban több olyan modell is található, amely nem csupán vezérlésre, hanem precíz áram- és feszültségmérésre is alkalmas. Ezek közé tartoznak a Shelly EM és Shelly 3EM eszközök, amelyek lehetővé teszik a két- vagy háromfázisú áramkörök teljesítményének folyamatos megfigyelését, akár az inverter kimenetén is, külső lakatfogó szenzorok segítségével.
Ennek az integrációnak az előnye, hogy az eddig külön-külön megjelenített inverteres és fogyasztási adatokat most egy felületen tudja összevetni a felhasználó az okosvillanyora.hu dashboard-on.
Milyen előnyöket jelent ez a gyakorlatban?
-
Valós idejű összevetés a hálózati P1 port által küldött adatok és a helyi Shelly-mérés között.
-
Pontos visszacsatolás arról, hogy a termelt energia mekkora része kerül ténylegesen visszatáplálásra, és mennyi fogy el helyben.
-
Energiahatékonysági elemzések, például az inverter hatásfokának követése különböző napszakokban.
-
Rendszerszintű hibák felismerése: ha például az inverter termel, de nincs hálózati visszatáplálás, az problémára utalhat (pl. túlterhelt fázis, hibás beállítás, stb.).
-
Automatizálható működés: a mért értékek alapján akár helyi relék vagy okoseszközök is vezérelhetők, például fogyasztók indítása túltermelés esetén.
Mely Shelly eszközökkel érhető el ez a funkció?
-
Shelly EM – Két mérőcsatornás, lakatfogós, ideális egyfázisú inverterhez vagy részleges terhelésfigyeléshez.
-
Shelly 3EM – Háromfázisú rendszerhez, képes az összes fázis egyidejű mérésére, ideális teljes rendszerfigyeléshez.
Az eszközök API-n keresztül integrálódnak az ADA P1 Meterrel, így nincs szükség külön alkalmazásra, minden érték közvetlenül megjelenik a megszokott dashboard-on.