Ugrás a fő tartalomhoz

API Telegram

Az ADA P1 Meter a klasszikus Telegram formátumban is elérhetővé teszi a villanyórából kiolvasott adatokat. Ez a formátum a legtöbb európai okosmérő (pl. DSMR szabvány) által is használt, strukturált szöveges kimenet, amely soronként tartalmazza a mért értékeket.

A Telegram formátum ideális választás azok számára, akik már meglévő feldolgozó eszközöket használnak (pl. DSMR logger, OpenDatalogger, Python vagy Node.js feldolgozók), vagy egyszerűen emberi olvasásra is alkalmas szöveges megjelenítést keresnek.

Elérési útvonal​

A Telegram formátumú adat a következő címen érhető el:

http://okosvillanyora.local:8989/telegram

IP-vel is elérhető:

http://192.168.x.x:8989/telegram

Adatfrissítés​

A Telegram kimenet is 10 másodpercenként frissül, minden lekéréskor az aktuális mérési értékeket adja vissza.

Példa Telegram adat​

/AUX5440252420024796

0-0:1.0.0(250329112720W)
0-0:42.0.0(AUX1020320024796)
0-0:96.1.0(440252420024796)
0-0:96.14.0(0002)
0-0:96.50.68(ON)
0-0:17.0.0(24.000*kW)
1-0:1.8.0(008323.570*kWh)
1-0:1.8.1(004043.669*kWh)
1-0:1.8.2(004279.901*kWh)
1-0:1.8.3(000000.000*kWh)
1-0:1.8.4(000000.000*kWh)
1-0:2.8.0(000000.001*kWh)
1-0:2.8.1(000000.001*kWh)
1-0:2.8.2(000000.000*kWh)
1-0:2.8.3(000000.000*kWh)
1-0:2.8.4(000000.000*kWh)
1-0:3.8.0(000000.807*kvarh)
1-0:4.8.0(002595.725*kvarh)
1-0:5.8.0(000000.807*kvarh)
1-0:6.8.0(000000.000*kvarh)
1-0:7.8.0(000000.000*kvarh)
1-0:8.8.0(002595.725*kvarh)
1-0:15.8.0(008323.571*kWh)
1-0:32.7.0(223.7*V)
1-0:31.7.0(006*A)
1-0:33.7.0(0.947)
1-0:14.7.0(49.99*Hz)
1-0:1.7.0(01.307*kW)
1-0:2.7.0(00.000*kW)
1-0:5.7.0(00.000*kvar)
1-0:6.7.0(00.000*kvar)
1-0:7.7.0(00.000*kvar)
1-0:8.7.0(00.324*kvar)
1-0:31.4.0(200*A)
0-0:98.1.0(250301000000W)(007453.019*kWh)(003657.588*kWh)(003795.431*kWh)(000000.001*kWh)(000000.001*kWh)(000000.000*kWh)(000000.802*kvarh)(002355.831*kvarh)(000000.802*kvarh)(000000.000*kvarh)(000000.000*kvarh)(002355.831*kvarh)(007453.020*kWh)(07.284*kW)(07.284*kW)(05.608*kW)(00.000*kW)(00.000*kW)(00.000*kW)
0-0:96.13.0()
!E819

A formátumról​

A Telegram adat sorai minden esetben szabványos OBIS kódokat tartalmaznak, amelyek egyértelműen meghatározzák, milyen típusú adatot tartalmaz a sor. Pl.:

  • 0-0:1.0.0 → idő (dátum és pontos időbélyeg)
  • 0-0:42.0.0 → COSEM logikai eszköznév
  • 0-0:96.1.0 → mérő sorozatszáma (eszköz ID)
  • 0-0:96.14.0 → jelenleg aktív tarifa
  • 0-0:96.50.68 → megszakító státusz
  • 0-0:17.0.0 → megszakító limiter küszöbértéke (kW)
  • 0-0:98.1.0 → hónapvégi tárolt számlázási adatok (utolsó tárolt)
  • 0-0:96.13.0 → szöveges üzenet (max. 1024 karakter)
  • 1-0:1.8.0 → teljes aktív importált energia (összes tarifa)
  • 1-0:1.8.1 → aktív importált energia T1 tarifában
  • 1-0:1.8.2 → aktív importált energia T2 tarifában
  • 1-0:1.8.3 → aktív importált energia T3 tarifában
  • 1-0:1.8.4 → aktív importált energia T4 tarifában
  • 1-0:2.8.0 → teljes aktív exportált energia (visszatáplálás)
  • 1-0:2.8.1 → aktív exportált energia T1 tarifában
  • 1-0:2.8.2 → aktív exportált energia T2 tarifában
  • 1-0:2.8.3 → aktív exportált energia T3 tarifában
  • 1-0:2.8.4 → aktív exportált energia T4 tarifában
  • 1-0:15.8.0 → abszolút aktív energia (|+A|+|-A|) összesen
  • 1-0:3.8.0 → pozitív (import) meddő energia összesen (Q+)
  • 1-0:4.8.0 → negatív (export) meddő energia összesen (Q-)
  • 1-0:5.8.0 → meddő energia, import induktív (QI)
  • 1-0:6.8.0 → meddő energia, import kapacitív (QII)
  • 1-0:7.8.0 → meddő energia, export induktív (QIII)
  • 1-0:8.8.0 → meddő energia, export kapacitív (QIV)
  • 1-0:1.7.0 → pillanatnyi fogyasztás (aktív importált teljesítmény, kW)
  • 1-0:2.7.0 → pillanatnyi visszatáplálás (aktív exportált teljesítmény, kW)
  • 1-0:5.7.0 → pillanatnyi meddő teljesítmény (QI, import induktív)
  • 1-0:6.7.0 → pillanatnyi meddő teljesítmény (QII, import kapacitív)
  • 1-0:7.7.0 → pillanatnyi meddő teljesítmény (QIII, export induktív)
  • 1-0:8.7.0 → pillanatnyi meddő teljesítmény (QIV, export kapacitív)
  • 1-0:31.7.0 → pillanatnyi áram (I) az L1 fázisban (A)
  • 1-0:51.7.0 → pillanatnyi áram (I) az L2 fázisban (A)
  • 1-0:71.7.0 → pillanatnyi áram (I) az L3 fázisban (A)
  • 1-0:32.7.0 → pillanatnyi feszültség (U) az L1 fázisban (V)
  • 1-0:52.7.0 → pillanatnyi feszültség (U) az L2 fázisban (V)
  • 1-0:72.7.0 → pillanatnyi feszültség (U) az L3 fázisban (V)
  • 1-0:13.7.0 → pillanatnyi teljesítménytényező (CosPhi, összes)
  • 1-0:33.7.0 → pillanatnyi teljesítménytényező (CosPhi, L1 fázis)
  • 1-0:53.7.0 → pillanatnyi teljesítménytényező (CosPhi, L2 fázis)
  • 1-0:73.7.0 → pillanatnyi teljesítménytényező (CosPhi, L3 fázis)
  • 1-0:14.7.0 → frekvencia (Hz)
  • 1-0:31.4.0 → korlátozás figyelés küszöbértéke L1 fázisra (A)
  • 1-0:51.4.0 → korlátozás figyelés küszöbértéke L2 fázisra (A)
  • 1-0:71.4.0 → korlátozás figyelés küszöbértéke L3 fázisra (A)

Ezeket a kódokat akár automatizált rendszer is könnyen tudja értelmezni, például reguláris kifejezésekkel, vagy a legtöbb DSMR-parszer könyvtárral.

Felhasználási lehetőségek​

  • Szöveges logolás és naplózás (pl. SD kártyára)
  • Lokális feldolgozás shell/python scriptből
  • Továbbítás MQTT-n keresztül szerverre vagy adatbázisba
  • DSMR-alapú rendszerekbe történő integráció

A Telegram formátum tehát nemcsak visszafelé kompatibilis, hanem könnyen beilleszthető bármilyen automatizálási vagy adatgyűjtő rendszerbe is.