Niżżlu data storika

Id-data storika ta’ kull apparat tinsab f’fajls tat-test (datalogs) fuq is-server tal-apparati tiegħu. Kull fajl ikopri ġurnata, xahar jew l-istorja kollha. Għandkom bżonn permess tal-qari fuq l-apparat.

Għal esportazzjoni mingħajr kodiċi, użaw ir-rapporti tal-app. Araw id-data tagħkom.

Proċedura

1. Sibu s-server tal-apparat. Sejħu get_device_info.php u aqraw il-qasam device_server. Araw ir-REST API.
2. Sibu l-ordni tal-kolonni. Sejħu get_device_definitions.php?family_id=<family> u aqraw readings u output_names.
3. Ikkalkulaw il-livell u n-numru tal-fajl (bin) għall-perjodu li tridu.
4. Niżżlu kull fajl mis-server tal-apparat.
5. Għaqqdu r-ringieli, irranġawhom skont it-timestamp u imlew l-oqsma vojta.

It-talba

curl --compressed \
  -H "Authorization: Bearer-API YOUR_API_KEY" \
  "https://DEVICE_SERVER/datalogs.php?serialno=e11:123&id=0.20740&ver=2"

Ibdlu DEVICE_SERVER bil-valur tal-qasam device_server tal-apparat.

Parametru	Valur
serialno	In-numru tas-serje tal-apparat
id	<level>.<bin>, pereżempju 0.20740
ver	2

Għall-awtentikazzjoni, ibagħtu l-header Authorization: Bearer-API YOUR_API_KEY jew Authorization: Bearer YOUR_ACCESS_TOKEN.

Is-server jista’ jibgħat il-fajl kompressat (gzip jew br). L-għażla --compressed ta’ curl tiddekompressah.

Kodiċi HTTP	Tifsira
200	Il-fajl, bħala text/plain
400	serialno jew id ħażin
403	M’għandkomx permess tal-qari fuq l-apparat
404	M’hemmx data għal dan il-fajl

Livelli u numri tal-fajls

Il-kalkoli kollha jużaw l-UTC.

Livell	Fajl wieħed għal kull	Kalkolu tal-bin	Eżempju
0	Ġurnata	floor(unix_seconds / 86400)	14 ta’ Ottubru 2026 = 0.20740
1	Xahar	(year - 1970) * 12 + (month - 1)	Ottubru 2026 = 1.681
2	L-istorja kollha	Dejjem m	2.m

Il-livell 0 għandu r-ringieli kollha tal-ġurnata. Il-livell 1 għandu madwar ringiela waħda għal kull ġurnata. Il-livell 2 għandu madwar ringiela waħda għal kull xahar.

L-app tuża l-livell 0 għal perjodi sa 7 ijiem u l-livell 1 għal perjodi sa 5 xhur. Għal perjodi itwal tuża 2.m.

Parir

Għal perjodu twil fil-livell 0 għandkom bżonn talba waħda għal kull ġurnata. L-app tibgħat sa 6 talbiet fl-istess ħin. Agħmlu l-istess fil-programm tagħkom.

Il-format tar-ringiela

Kull ringiela hija kejl wieħed. L-oqsma huma separati b’;.

timestamp;reading1;reading2;...;readingN;output1;...;outputM

• It-timestamp huwa sekondi unix (UTC). Jista’ jkollu deċimali.
• Imbagħad jiġi l-qari, fl-ordni tal-readings tal-familja.
• Imbagħad jiġu l-outputs, fl-ordni ta’ output_names.
• Qasam vojt ifisser li l-valur ma nbidilx. Użaw l-aħħar valur minn ringiela ta’ qabel.
• Il-valur 2147483648 ifisser li l-qari huwa nieqes.
• Ir-ringieli mhumiex dejjem f’ordni. Irranġawhom skont it-timestamp.

Eżempju

Apparat tal-familja e11 għandu readings = ["T", "GI", "GIC", "GI2", "GI2C"] u l-ebda output.

1791936198.977;2120;1;0;1;0

Qasam	Valur	Tifsira
timestamp	1791936198.977	Il-ħin tal-kejl
T	2120	21.20 °C, għax il-konverżjoni ta’ T hija divide_by_100
GI	1	L-istat tal-ewwel input
GIC	0	Il-kontatur tal-ewwel input
GI2	1	L-istat tat-tieni input
GI2C	0	Il-kontatur tat-tieni input

Issibu l-konverżjonijiet u l-unitajiet fid-dizzjunarju readings tad-definizzjonijiet. Araw ir-REST API.

Eżempju tax-shell

Dan l-eżempju jniżżel l-aħħar 3 ijiem ta’ apparat.

SERVER=DEVICE_SERVER
SN=e11:123
TODAY=$(( $(date -u +%s) / 86400 ))
for BIN in $(seq $((TODAY - 2)) $TODAY); do
  curl -s --compressed \
    -H "Authorization: Bearer-API YOUR_API_KEY" \
    "https://$SERVER/datalogs.php?serialno=$SN&id=0.$BIN&ver=2"
done | sort -t';' -k1,1n

Metodu ieħor

Is-server MCP għandu l-għodda get_device_history. Taċċetta l-istess livelli u bins.