T-REG DataShare je skupina výrobků, které umožňují odeslat načtená data prostřednictvím WiFi do webové databáze. Nejedná se pouze o jednoduchý WiFi teploměr, ale zařízení, které podle typu může sbírat množství dat, které odesílá do SQL databáze, nebo na MQTT server.

Přístup do databáze dat je na adrese t-reg.cz/datashare

Ukázka dat v databázi (ze zařízení DataShare-S) k nahlédnutí zde
Ukázka dat v databázi (ze zařízení PowerRouter) k nahlédnutí zde
Ukázková data jsou z testovacích zařízení a mohou obsahovat různé chyby a fragmenty.

Jednotlivé výrobky T-REG DataShare:
DataShare-S

• Data ze zařízení je možné odesílat do databáze T-REG DataShare – lze tak přistupovat k nedávným hodnotám* prostřednictvím webu. Nejsou potřeba žádné přihlašovací údaje, pouze sériové číslo zařízení. Data se zobrazují podle parametrů nastavených přímo v zařízení.
• Dále je možné použít libovolnou kompatibilní službu pro záznam dat, zobrazení grafů apod. Data je tak možné zaznamenávat např. na populární český web TMEP.CZ, živýobraz.eu, ThingSpeak apod.
• Data ve formátu MQTT je možné odeslat na libovolný MQTT server.
• Pokud chcete zachovat soukromí a data uchovávat na svém serveru, ve své databázi a libovolně s nimi pracovat – je k dispozici ukázkový kód a nastavení databáze pro zpracování dat.

Podle typu zařízení v databázi zůstává zachováno posledních 300, nebo 1500 záznamů, což při intervalu odesílání 5 (1) minut vystačí na cca 25 hodin záznamu.

Z databáze jsou mazána data starší než 30 dní.

Přístup do databáze T-REG DataShare

Pro přístup do databáze nejsou potřeba žádné přihlašovací údaje. Stačí jít na adresu t-reg.cz/datashare a do vyhledávacího pole zadat sériové číslo vašeho zařízení. Vyhledávací pole umožňuje zadání více sériových čísel oddělených čárkou. Potom jsou na jedné obrazovce zobrazena data všech nalezených zařízení.
Id zařízení lze zadat přímo v adrese, není teda potřebo používat vyhledávací pole. Formát adresy je t-reg.cz/datashare?id=xxxx, kde xxxx je Id zařízení (případně více id oddělených čárkou).

Hodnoty se zobrazují ve čtvercích, které jsou konfigurovatelné přímo v zařízení. Není zde žádná konfigurace na straně serveru, ale vždy pouze v zařízení. Zobrazují se data z režimu FullField (viz níže) – tedy název, jednotka, barva a hodnota doplněné o ID zařízení a datum a čas posledního záznamu.
Po kliknutí na čtverec se zobrazí graf se všemi dostupnými daty z databáze. Graf lze přibližovat kolečkem myši.
Barva je daná vzorníkem CSS barev (viz tabulka). Barvy jsou číslovány od 0. Např. barva „4“ je azurová, barva „7“ je černá.

Konfigurace – nastavení odesílání do databáze

Některá zařízení nepatřící přímo do skupiny DataShare (BeerMeter, PowerRouter, …) mohou mít omezené možnosti nastavení). Zde je obecný popis principu odesílání dat. Konkrétní možnosti nastavení jsou vždy uvedeny u každého zařízení.

Konfigurace zařízení je jednoduchá, ale umožňuje poměrně rozsáhlé možnosti nastavení odesílání.
Zařízení si naměřené hodnoty interně ukládá do tzv. registrů – každé zařízení má podle množství měřených hodnot určité množství registrů. Hodnotu z registru je pak možné přiřadit tzv. fieldu, který se odesílá do webové služby. Fieldu lze přiřadit název, barvu a veličinu, která může být společně s daty odesílána.

Na obrázku níže je příklad uložení dat z nejmenšího modulu DataShare-S. V jednotlivých registrech jsou hodnoty z čidel (pokud není čidlo připojeno, je v registru hodnota 0). U Fieldu 1 se povolí odesílání a nastaví se příslušné parametry. Režim odesílání je vždy pro všechny fieldy stejný. Pokud je zvolen typ odesílání „FullField“ je odeslána obsah celého Fieldu + informace o sériovém čísle zařízení. V režimu odesílání „Data“ se odesílá vždy pouze název a hodnota příslušného fieldu.

Díky možnosti konfigurace je možné měnit pořadí a množství odesílaných dat.

Režim FullField

Odesílá ID zařízení a všechna nastavená data zvoleného fieldu. Není tak potřeba žádná konfigurace na straně serveru. Zobrazuje pouze surová data a vše se nastavuje v zařízení – název, jednotka, barva. Tento režim komunikace se vždy používá při komunikaci se serverem T-REG DataShare, kde není potřeba pro zobrazení hodnot žádná konfigurace, ani přihlašování. Stačí znát sériové číslo zařízení. Pokud není zadána adresa, odesílají se data na server T-REG DataShare. Pokud je adresa zadaná, odesílají se data na příslušnou adresu.

Formát odesílaných dat:
http://www.adresa-serveru.cz/dataacq.php?deviceId=12345&fieldName1=Teplota&fieldUnit1=C&fieldColor1=4&fieldValue1=22.5&fieldName2=Tlak&fieldUnit2=Pa&fieldColor2=2&fieldValue2=97885 ...

Tučně napsanou adresu lze zadat do pole adresa. Je nutné ji zadat včetně http, lomítek, otazníku atd. Zbylá data doplní zařízení podle zadaných parametrů.

Režim FieldNumber

Odesílá fixní pořadové číslo fieldu a jeho hodnotu. Tato komunikace je vhodná např. pro server ThingSpeak. Název fieldu je možné zvolit libovolný a slouží spíše pro orientaci jaká data obsahuje.

Formát odesílaných dat:
http://www.adresa-serveru.cz/dataacq.php?field1=22.5&field2=97885...

Tučně napsanou adresu lze zadat do pole adresa. Je nutné ji zadat včetně http, lomítek, otazníku atd. Zbylá data doplní zařízení podle zadaných parametrů.

Režim FieldName

Odesílá hodnotu ve formátu název fieldu = hodnota fieldu. Tento režim komunikace je vhodný např. pro server TMEP.CZ, zivyobraz.eu, kde se zadá jako název např. „temp“ a server automaticky pozná, že se jedná o teplotu.

Formát odesílaných dat:
http://www.adresa-serveru.cz/dataacq.php?Teplota=22.5&Tlak=97885 ...

Tučně napsanou adresu lze zadat do pole adresa. Je nutné ji zadat včetně http, lomítek, otazníku atd. Zbylá data doplní zařízení podle zadaných parametrů.

Režim MQTT

Odesílá data prostřednictvím MQTT brokeru. Jako MQTT topic je použit název fieldu. Pro odeslání hodnot je potřeba vyplnit MQTT server, port, uživatelské jméno a heslo. V přípravě.

Webové adresy DataShare

Některá zařízení DataShare umí kromě odesílání dat i některá data přijímat. Lze tak regulovat, nebo zohlednit nějakou hodnotu načítanou z webu. DataShare obsahuje jednoduchý parsovací algoritmus, který převede získaný text na číslo – je potřeba, aby web vrátil opravdu pouze jednu hodnotu ve správném formátu (float číslo, desetinná místa oddělená tečkou).

Zde jsou jednotlové adresy včetně příkladů, které je možné v zařízeních použít, pokud je podporují.

Zobrazení dat podle ID zařízení
Umožňuje zobrazit poslední odeslané hodnoty ze zařízení a graf všech hodnot. Databáze uchovává pouze 300, nebo 1440 záznamů podle typu zařízení – odpovídá cca 24 hodinám záznamu při intervalu odesílání 5, nebo 1 minuta.
Je možné přistupovat přímo k ID zařízení pomocí adresy. Zle zadat i více ID zároveň.
Adresa (základní): https://t-reg.cz/datashare.php
Adresa (konkrétní id): https://t-reg.cz/datashare.php?id=123456789
Adresa (více id zároveň): https://t-reg.cz/datashare.php?id=123456788,123456789

Aktuální cena elektřiny na denním trhu (spot v Eurech/MWh)
Vrátí aktuální spotovou cenu elektrické energie v Eur/MWh v textovém formátu. Hodnota má až 2 desitánná místa oddělené tečkou. Nedostupná data vrátí „NaN“. Data jsou načítána z webu OTE Denní trh vždy na den dopředu (aktualizace se provádí 3x denně).
Adresa (aktuální hodnota): http://t-reg.cz/datashr/get_spot_price.php
Adresa (dnešek, konkrétní hodina): http://t-reg.cz/datashr/get_spot_price.php?time=7
Adresa (konkrétní datum a hodina): https://t-reg.cz/datashr/get_spot_price.php?datetime=2025-04-26_14:00 (datum a čas oddělit mezerou, nebo podtržítkem).

Aktuální čas v desetinném formátu
Zařízení, která nedokáží načítat aktuální čas z NTP serveru mohou jednoduše načítat aktuální čas ze serveru t-reg. Hodnota času je v desetnném formátu, aby fungovalo standardní porovnávání. Např. čas 21:46 je přeložen jako 21.77.
Adresa: http://t-reg.cz/datashr/get_current_time.php

Typy zařízení

Více informací ke konkrétnímu zařízení je vždy na samostatné stránce.
Aktuální seznam zařízení podporující cloud T-REG DataShare:

• BeerMeter – od v1.6 odesílá celkové množství a průtok jednou za 5 minut.
• PowerRouter – od verze 0.97 odesílá zvolené hodnoty jednou za minutu
• DataShare-S (aktuální verze 1.0)

DataShare-S (stránka produktu)

Nejmenší ze skupiny DataShare. Malý úsporný obvod dokáže sbírat data o okolní teplotě a vlhkosti. Je možné k němu připojit jedno externí teplotní čidlo DS18B20, má analogový/digitální vstup (max. 3,3 V), který dokáže i počítat počet impulzů. Disponuje konektorem uŠup, ke kterému je možné připojit další snímač BMP280 (teplota, tlak), snímač LTR390 (intenzita osvětlení, UV) a BH1750 (intenzita osvětlení). Zařízení připojený snímač automaticky rozezná a hodnoty zapíše do příslušných registrů. Postupně budou přibývat další připojitelné snímače.

DataShare-L

Zařízení ve vývoji. Parametry se ještě budou měnit…

Největší verze DataShare umožňuje odesílání více hodnot do webové databáze. Konfigurace je podobná jako u nižších verzí, hodnoty je možné zároveň zobrazit na displeji.

O připojení se stará jeden port D-Sub 15 prostřednictvím kterého je možné zařízení napájet (napájecí napětí 5 – 30 V), komunikovat po sběrnici Modbus RTU, měřit 4 analogová napětí (nebo 2 diferenciálně) s 16 bitovou přesností. Zařízení má dále digitální vstupy, které umožňují počítání impulzů. V konektoru je vyvedeno pomocné napájení 5 V pro napájení vzdálených teplotních snímačů.

• Napájení: 5 V (USB-C), nebo D-Sub15 (5 – 30 V)
• Integrovaný snímač teploty
• Připojitelné snímače
  • 4x měření analogového napětí (max. 3,3 V), nebo 2x diferenciální měření (proti GND max. 3,3 V).
  • Komunikace ModbusRTU (RS485) – čtení max. 10 registrů
  • Max. 8 externích teplotních snímačů DS18B20 (napájení 5 V)