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.

Shelly Plug S Integráció az ADA P1 Meter-rel

ADA P1 Meter Firmware verzió: 1.2.77 vagy újabb szükséges

Működési elv

  1. 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)

  2. 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.

  3. Az ADA P1 Server beilleszti az érkező adatokat a saját JSON struktúrájába, a plugins kulcs alá.

  4. 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.