Uživatelské nástroje

Nástroje pro tento web

start

Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

Obě strany předchozí revizePředchozí verze
Následující verze		Předchozí verze
Následující verzeObě strany příští revize
start [2016/02/28 17:13] – multitrickerstart [2022/08/16 15:53] – multitricker
Řádek 1: Řádek 1:
 ~~NOTOC~~ ~~NOTOC~~
-====== 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í.+====== Vítejte v dokumentaci ke službě TMEP ======
  
-====== Základní princip fungování portálu ======+Naleznete zde dokumentaci k funkcím portálu a také návody jak s touto službou zprovoznit různá zařízení včetně těch vlastních. Služba běží na doménách https://tmep.cz i https://tmep.eu - jsou to oddělené databáze s tím, že TMEP.eu byla původně určená výhradně pro čidla společnosti MonkeyTech, ale můžete tam provozovat libovolná zařízení stejně jako na TMEP.cz. Na .eu je navíc více volných subdomén, takže je vyšší pravděpodobnost, že si tam zaregistrujete adresu, kterou chcete. Pro to, abyste měli svá čidla pohromadě pod jedním účtem je lepší se rozhodnout jen pro jednu z domén. 
 + 
 +===== 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** 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í). +je následně potřeba nechat zasílat (ideálně 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. +Způsob zasílání je velmi prostý - požadavkem typu HTTP GET na port 80. 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. Teplota ve stupních Celsia, vlhkost v procentech a parametru humV.
-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. +
- +
----- +
- +
-====== Popis položek v nastavení čidla na tmep.cz ====== +
- +
- +
-**Doména se statistikami DOMENA.tmep.cz**\\ +
-Adresa, na které bude dostupná aplikace se statistikami pro čidlo. Na tuto adresu zároveň bude potřeba zasílat měření.\\ +
- +
-**Název čidla**\\ +
-Pojmenování pro přehled čidel v administraci.\\ +
- +
-**Nadpis (na webu čidla)**\\ +
-Nadpis stránky se statistikami.\\ +
- +
-**Umístění (na webu čidla)**\\ +
-Informace na stránce se statistikami.\\ +
- +
-**GUID (zasílaný řetězec s hodnotou teploty)**\\ +
-Jméno parametru, jehož hodnota bude obsahovat naměřenou teplotu. Pro čidla TME a TH2E nevyplňujte.\\ +
- +
-**Povolené IP adresy, ze kterých může zařízení zasílat hodnoty**\\ +
-Je možné zadat více IP adres oddělených čárkou. Toto doporučuji po odzkoušení zasílání hodnot ze zařízení zadat, aby nikdo nemohl zasílat nesmyslná měření. +
-Dále je možné zadat rozsah adres ve formátu CIDR, např.: **75.28.10.0/24**\\ +
- +
-**S vlhkoměrem**\\ +
-Pokud je volba zaškrtnutá, pak se v aplikaci se statistikami zobrazují pole pro zobrazení naměřené vlhkosti a aplikace očekává v parametru **humV** hodnotu vlhkosti v procentech 0 až 100.\\ +
- +
-**Výchozí jazyk**\\ +
-Jazyk aplikace se statistikami.\\ +
- +
-**Výchozí jednotka**\\ +
-Výchozí zobrazovaná jednotka v aplikaci se statistikami. Měření je potřeba vždy provádět ve stupních Celsia. Na jiné jednotky se provádí přepočet.\\ +
- +
-**Hlídač neaktivity čidla (minut)**\\ +
-Po kolika minutách kdy neobdržíme naměřenou hodnotu z čidla má přijít mail s upozorněním. Je potřeba mít ověřenou registrovanou e-mailovou adresu, aby tato upozornění začala chodit. Ověření provedeš kliknutím na odkaz v e-mailu, který ti přijde hned po registraci na tmep.cz. +
- +
-**Typ čidla**\\ +
-Nevíte-li, nechte zvolené "Obecné". Bude fungovat jak s vlastním voláním, tak s většinou čidel od Papoucha. +
- +
----- +
- +
-====== 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: +
- +
-<code>curl http://ahoj.tmep.cz/?mojemereni=25.6</code> +
- +
-Chcete-li zároveň měřit i vlhkost, je potřeba ji předat pod parametrem **humV**: +
- +
-<code>curl http://ahoj.tmep.cz/?mojemereni=25.6&humV=60</code> +
- +
-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í +
-[[multi@tricker.cz|podělíte]] a přidám ho sem. +
- +
----- +
- +
-====== Upozornění na naměřenou hodnotu====== +
- +
-Chcete-li, aby Vám e-mailem přišlo upozornění na překročení naměřené hodnoty teploty nebo +
-vlhkosti, je potřeba k čidlu nastavit upozornění na naměřenou hodnotu. +
-Je možné nastavit více upozornění pod jedním čidlem. +
- +
-V upozorňovači vyplňte následující: +
- +
-**Upozornění na čidle:**\\ +
-Zvolte zadané čidlo, na které se má upozornění vztahovat.\\ +
- +
-**Typ hodnoty:**\\ +
-Zvolte, zda se upozornění má týkat teploty nebo vlhkosti.\\ +
- +
-**Porovnání:**\\ +
-Jaké porovnání s naměřenou hodnotou zvolit? Je větší/menší než...\\ +
- +
-**Hodnota:**\\ +
-Vůči jaké hodnotě porovnávat tu naměřenou?\\ +
- +
-**Další upozornění v případě překročení poslat nejdřív za:**\\ +
-Kdy nejdříve poslat další upozornění na to, že je hodnota překročená?\\ +
- +
-**Upozornění poslat na e-mail(y):**\\ +
-Na jaké e-maily zaslat upozornění, že naměřená hodnota vyhověla parametrům upozornění? Je možné zadat více e-mailů oddělených čárkou. +
- +
-Nastavíte-li tedy, že upozornění platí pro teplotu větší než je hodnota 15, tak Vám e-mail s upozorněním přijde při +
-naměření teploty větší než je 15 stupňů. +
- +
----- +
- +
-====== 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**: +
- +
-<code>curl http://ahoj.tmep.cz/?cidlo=1&mojemereni=25.6&vlhkost=60</code> +
-<code>curl http://ahoj.tmep.cz/?cidlo=2&mojemereni=23.2&vlhkost=78</code> +
- +
-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í: +
- +
-<code>curl http://ahoj.tmep.cz/?mojemereni=25.6&mojemereni2=18.6&humV=60&humV2=60</code> +
- +
-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 +{{ :portal:tmep-jak-to-funguje.jpg?nolink |}}
-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:**\\ +Samotná měření jsou poté včetně jejich historie dostupné v aplikaci, která se zobrazí po zobrazení adresy **//domena//.tmep.cz** v prohlížeči. Aplikace je optimalizovaná i pro zobrazení na tabletech a mobilních telefonech.
-//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**