Toto je starší verze dokumentu!
TMEP.cz
Vítejte! Naleznete zde dokumentaci k funkcím portálu a také návody jak s touto službou zprovoznit různá zařízení.
Základní princip fungování portálu
V nastavení TMEP.cz přidáte čidlo, kterému přiřadíte vlastní doménu a další nastavení. Na tuto doménu domena.tmep.cz je následně potřeba nechat zasílat každou minutu naměřenou teplotu ve stupních Celsia (případně spolu s vlhkostí). Způsob zasílání je velmi prostý - požadavkem typu HTTP GET. Tedy jako byste chtěli otevřít určitou adresu v prohlížeči a její součástí byly parametry s naměřenými údaji. Konkrétní nastavení čidla a příklady volání naleznete níže.
Pro další informace a pro pohyb v dokumentaci pokračujte odkazy v levém menu.
Jak nastavit zařízení
Základní nastavení
Pro fungování zasílání hodnot z libovolného zařízení ho musíte mít správně připojené do internetu a musíte v něm mít vyplněné základní nastavení sítě ať už ručně, nebo automaticky z DHCP serveru:
- IP adresu
- Masku
- Bránu
- DNS server
Odchozí požadavky ze zařízení budou směrované na port 80 a server *.tmep.cz (78.156.32.15). Neměli byste tedy mít tento typ provozu blokovaný firewallem.
Papouch TME
V nastavení teploměru na záložce „Odesílání“ nastavte:
- Nastavení pro HTTP GET a POST
- IP adresa webového serveru: 78.156.32.15
- Jméno webového serveru: domena.tmep.cz
- Port webu: 80
- Adresář skriptů na serveru: prázdné nebo „/“ (bez uvozovek)
- GUID: to samé, co máte vyplněné zde v administraci čidla
- Perioda odesílání: 1
- HTTP GET
- Aktivovat odesílání HTTP GETu: zaškrtnout
- Název skriptu: index.php
- Parametry GETu: ponechte prázdné
Papouch TH2E
V nastavení teploměru na záložce síť aktivujte funkci odesílání na vzdálené servery protokoly HTTP (je-li tam tato možnost). Na záložce „Odesílání“ nastavte:
* Nastavení pro HTTP GET a POST
- Adresa webového serveru: domena.tmep.cz
- Port webu: 80
- Adresář skriptů na serveru: prázdné nebo „/“ (bez uvozovek)
* HTTP GET
- Perioda odesílání GETu: 1
- Název skriptu: index.php
Vlastní HW
Je potřeba vyjít ze základního principu fungování aplikace - požadavkem typu HTTP GET poslat na své čidlo naměřenou hodnotu. Zasílat ji každou minutu, teplotu ve stupních Celsia, vlhkost v procentech. Pokud máte např. v administraci zadané čidlo s doménou ahoj a GUID nastavené na „mojemereni“, pak je možné vložit hodnotu do databáze v prostředí Linuxu s nainstalovaným curl např. takto:
curl http://ahoj.tmep.cz/?mojemereni=25.6
Chcete-li zároveň měřit i vlhkost, je potřeba ji předat pod parametrem humV:
curl http://ahoj.tmep.cz/?mojemereni=25.6&humV=60
Po zprovoznění doporučuji zde v nastavení čidla nastavit z jaké IP adresy mohou měření chodit, aby měření nemohl zasílat kdokoliv. Nastavení vlastního GUID (pojmenování parametru s hodnotou měření) je také jistý stupeň ochrany.
Zprovozníte-li takto nějaké měření na vlastní desce, budu rád, když se o nastavení podělíte a přidám ho sem.
Přeposílač hodnot
K čemu slouží
Pokud zasíláte hodnoty z více čidel na jednu TMEP doménu a potřebujete tyto hodnoty rozdělit, je potřeba nastavit odpovídající počet přeposílačů. Potřebné v případě, že vaše jednotka neumí posílat měření na více domén.
Jak ho nastavit
Vždy si založte odpovídající počet čidel, do kterých budou přeposílače ukládat měření.
V přeposílači nastavíte, že pokud při přístupu na vaši doménu např. ahoj.tmep.cz existuje proměnná (volitelně s jakou hodnotou), tak se má uložit měření ze zvolené proměnné pro teplotu (a vlhkost) do jednoho z čidel pod vaším účtem.
Více samostatných jednotlivých měření
Příklad více samostatných volání, zde odlišen hodnotou v proměnné cidlo:
curl http://ahoj.tmep.cz/?cidlo=1&mojemereni=25.6&vlhkost=60
curl http://ahoj.tmep.cz/?cidlo=2&mojemereni=23.2&vlhkost=78
Poté nastavíte u domény ahoj:
Přeposílač 1:
Proměnná, která musí existovat při volání domény: cidlo
Co musí proměnná obsahovat: 1
Doména, kam se měření uloží: ahoj
Název proměnné s teplotou: mojemereni
Název proměnné s vlhkostí: vlhkost
Přeposílač 2:
Proměnná, která musí existovat při volání domény: cidlo
Co musí proměnná obsahovat: 2
Doména, kam se měření uloží: ahoj-druha
Název proměnné s teplotou: mojemereni
Název proměnné s vlhkostí: vlhkost
Více hodnot v jednom volání
Obsahuje jak mojemereni, tak mojemereni2, obdobně s vlhkostí:
curl http://ahoj.tmep.cz/?mojemereni=25.6&mojemereni2=18.6&humV=60&humV2=60
Poté nastavíte:
Přeposílač 1:
Proměnná, která musí existovat při volání domény: mojemereni
Co musí proměnná obsahovat: -prázdné-
Doména, kam se měření uloží: ahoj
Název proměnné s teplotou: mojemereni
Název proměnné s vlhkostí: humV
Přeposílač 2:
Proměnná, která musí existovat při volání domény: mojemereni2
Co musí proměnná obsahovat: -prázdné-
Doména, kam se měření uloží: ahoj-druha
Název proměnné s teplotou: mojemereni2
Název proměnné s vlhkostí: humV2
Papouch TME Multi a TME Radio
TME Multi/Radio od Papoucha posílá měření v samostatných požadavcích na server, kdy se jednotlivá měření liší hodnotou v proměnné mod. Budeme tedy v nastavení přeposílačů postupovat podobně jako v případě více samostatných volání.
Přeposílač 1:
Proměnná, která musí existovat při volání domény: mod
Co musí proměnná obsahovat: 1
Doména, kam se měření uloží: moje-cidlo-1
Název proměnné s teplotou: tempV
Název proměnné s vlhkostí: humV
Přeposílač 2 až X:
Proměnná, která musí existovat při volání domény: mod
Co musí proměnná obsahovat: x (2, 3, …)
Doména, kam se měření uloží: moje-cidlo-2 (…)
Název proměnné s teplotou: tempV
Název proměnné s vlhkostí: humV
Papouch Papago
PAPAGO od Papoucha posílá více měření v rámci jednoho požadavku na server.samostatných požadavcích, kdy se jednotlivá měření liší názvem proměnné, např. T1V1. Nastavte v PAPAGU vlastní guid na např. „tmepiste“ a nastavte obdobně přeposílače:
Přeposílač 1:
Proměnná, která musí existovat při volání domény: guid
Co musí proměnná obsahovat: tmepiste
Doména, kam se měření uloží: moje-cidlo-1
Název proměnné s teplotou: T1V1_value
Název proměnné s vlhkostí: H1V2_value
Přeposílač 2 až X:
Proměnná, která musí existovat při volání domény: guid
Co musí proměnná obsahovat: tmepiste
Doména, kam se měření uloží: moje-cidlo-2 (…)
Název proměnné s teplotou: T2V1_value
Název proměnné s vlhkostí: H2V2_value