Íoslódáil sonraí staire

Tá sonraí staire gach gléis i gcomhaid téacs (datalogs) ar a fhreastalaí gléis. Clúdaíonn gach comhad lá amháin, mí amháin nó an stair iomlán. Teastaíonn cead léimh ar an ngléas uait.

Le haghaidh easpórtála gan chód, úsáid tuarascálacha na haipe. Féach do shonraí.

Nós imeachta

1. Aimsigh freastalaí an ghléis. Glaoigh ar get_device_info.php agus léigh an réimse device_server. Féach an REST API.
2. Aimsigh ord na gcolún. Glaoigh ar get_device_definitions.php?family_id=<family> agus léigh readings agus output_names.
3. Ríomh an leibhéal agus uimhir an chomhaid (bin) don tréimhse is mian leat.
4. Íoslódáil gach comhad ó fhreastalaí an ghléis.
5. Cuir na sraitheanna le chéile, sórtáil iad de réir stampa ama agus líon na réimsí folmha.

An t-iarratas

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

Cuir luach an réimse device_server den ghléas in áit DEVICE_SERVER.

Paraiméadar	Luach
serialno	Sraithuimhir an ghléis
id	<level>.<bin>, mar shampla 0.20740
ver	2

Le haghaidh fíordheimhnithe, seol an ceanntásc Authorization: Bearer-API YOUR_API_KEY nó Authorization: Bearer YOUR_ACCESS_TOKEN.

Is féidir leis an bhfreastalaí an comhad a sheoladh comhbhrúite (gzip nó br). Díchomhbhrúnn an rogha curl --compressed é.

Cód HTTP	Brí
200	An comhad, mar text/plain
400	serialno nó id mícheart
403	Níl cead léimh agat ar an ngléas
404	Níl sonraí ann don chomhad seo

Leibhéil agus uimhreacha comhad

Úsáideann na ríomhanna go léir UTC.

Leibhéal	Comhad amháin do gach	Ríomh an bhin	Sampla
0	Lá	floor(unix_seconds / 86400)	14 Deireadh Fómhair 2026 = 0.20740
1	Mí	(year - 1970) * 12 + (month - 1)	Deireadh Fómhair 2026 = 1.681
2	Stair iomlán	m i gcónaí	2.m

Tá sraitheanna uile an lae i leibhéal 0. Tá thart ar shraith amháin in aghaidh an lae i leibhéal 1. Tá thart ar shraith amháin in aghaidh na míosa i leibhéal 2.

Úsáideann an aip leibhéal 0 do thréimhsí suas le 7 lá agus leibhéal 1 do thréimhsí suas le 5 mhí. Do thréimhsí níos faide, úsáideann sí 2.m.

Leid

Do thréimhse fhada ar leibhéal 0, teastaíonn iarratas amháin in aghaidh an lae. Seolann an aip suas le 6 iarratas ag an am céanna. Déan an rud céanna i do ríomhchlár.

Formáid na sraithe

Is tomhas amháin gach sraith. Tá ; idir na réimsí.

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

• Is soicindí unix (UTC) é an timestamp. Is féidir deachúlacha a bheith ann.
• Ansin tagann na léamha, in ord readings an teaghlaigh.
• Ansin tagann na haschuir, in ord output_names.
• Ciallaíonn réimse folamh nár athraigh an luach. Úsáid an luach deireanach ó shraith níos luaithe.
• Ciallaíonn an luach 2147483648 go bhfuil an léamh in easnamh.
• Ní bhíonn na sraitheanna sórtáilte i gcónaí. Sórtáil iad de réir timestamp.

Sampla

Tá readings = ["T", "GI", "GIC", "GI2", "GI2C"] ag gléas den teaghlach e11 agus níl aschuir aige.

1791936198.977;2120;1;0;1;0

Réimse	Luach	Brí
timestamp	1791936198.977	Am an tomhais
T	2120	21.20 °C, mar is é divide_by_100 tiontú T
GI	1	Staid an chéad ionchuir
GIC	0	Áiritheoir an chéad ionchuir
GI2	1	Staid an dara hionchur
GI2C	0	Áiritheoir an dara hionchur

Faigheann tú na tiontuithe agus na haonaid i bhfoclóir readings na sainmhínithe. Féach an REST API.

Sampla blaoisce

Íoslódálann an sampla seo na 3 lá deireanacha de ghléas.

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

Modh eile

Tá an uirlis get_device_history ag an bhfreastalaí MCP. Glacann sé leis na leibhéil agus na binní céanna.