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
start [2016/02/27 12:48] multitrickerstart [2022/12/15 15:20] (aktuální) 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 dokumentaci ke službě TMEP ======
  
-====== Princip fungování ======+Naleznete zde dokumentaci k funkcím portálu a také návody jak s touto službou zprovoznit různá zařízení (včetně vlastních).
  
-V nastavení této webové aplikace přidáte čidlo, kterému přiřadíte vlastní doménu a další nastavení. Na tuto doménu //domena//.tmep.cz +Služba běží na doménách https://tmep.cz a https://tmep.eu - je jen na Vás, na které z domén si vytvoříte účet pro svá čidla. Na TMEP.eu je méně uživatelů a tedy více volných subdomén pro čidla.
-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íža její součástí byly parametry s naměřenými údaji. +
-Konkrétní nastavení čidla a příklady volání naleznete níže.+
  
-----+===== Základní princip fungování =====
  
-====== Popis položek v nastavení čidla na tmep.cz ======+Na portálu TMEPu si založíte účet a v nastavení přidáte čidlo. Čidlo pojmenujete a vyberete mu vlastní subdoménu. Na tuto subdoménu **//domena//.tmep.cz** (nebo ještě lépe na automaticky vygenerovanou subdoménu pro zápis, kterou naleznete v nastavení hned pod tou vámi zvolenou)  
 +je následně potřeba nechat zasílat každých 1-10 minut až tři měřené hodnoty (typicky teplotu ve stupních Celsia spolu s vlhkostí a třeba tlakem, ale můžete měřit i jiné hodnoty). 
 +Způsob zasílání je velmi prostý - požadavkem typu HTTP GET na port 80/443. Tedy jako byste chtěli otevřít webovou adresu v internetovém prohlížeči a její součástí jsou parametry s naměřenými údaji. 
  
 +{{ :portal:schema-jak-to-funguje-wiki.png?650&nolink |}}
  
-**Doména se statistikami DOMENA.tmep.cz**\\ +Samotná měření jsou poté včetně jejich historie dostupná v aplikaci, která se zobrazí po otevření adresy **//domena//.tmep.cz** v internetovém prohlížeči. Aplikace je optimalizovaná i pro zobrazení na tabletech a mobilních telefonech. Můžete také využít nativní aplikace pro [[portal:android_widget|iOS i Android]] s widgety na plochu a k dispozici je i [[portal:windows_widget|ření pro Windows]].
-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**\\ +===== Založil jsem si ve službě čidlo, co dál? =====
-Pojmenování pro přehled čidel v administraci.\\+
  
-**Nadpis (na webu čidla)**\\ +<WRAP group> 
-Nadpis stránky se statistikami.\\+<WRAP half column> 
 +<WRAP centeralign><color #2b73b7><fs 24px>Mám produkt od výrobce</fs></color></WRAP>
  
-**Umístění (na webu čidla)**\\ +{{:pasted:20221215-151556.png?nolink}}
-Informace na stránce se statistikami.\\+
  
-**GUID (zasílaný řetězec s hodnotou teploty)**\\ +Postupujteprosím, podle návodu k čidlu, nebo se podívejte do návodů na konkrétní zařízení v levém menu "Od výrobce"Čidlo budete potřebovat nastavit do svojí (Wi-Fi) sítě vyplnit v něm doménu, kterou jste pro čidlo zvolili v administraci. 
-Jméno parametrujehož hodnota bude obsahovat naměřenou teplotuPro čidla TME TH2E nevyplňujte.\\+</WRAP> 
 +<WRAP half column> 
 +<WRAP centeralign><color #2b73b7><fs 24px>Chci napojit vlastní zařízení</fs></color></WRAP>
  
-**Povolené IP adresy, ze kterých může zařízení zasílat hodnoty**\\ +{{:pasted:20221215-152040.png?nolink}}
-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**\\ +Odesílání hodnot do TMEPu je stejně jednoduché jako otevřít webovou adresu prohlížeči.
-Pokud je volba zaškrtnutá, pak se v aplikaci se statistikami zobrazují pole pro zobrazení naměřené vlhkosti a aplikace očekává parametru **humV** hodnotu vlhkosti v procentech 0 až 100.\\+
  
-**Výchozí jazyk**\\ +Potřebujete vědět jaké hodnoty a jak můžete posílat - pokračujte prosím na stránku [[zarizeni:vlastni_hardware|Zasílané hodnoty]]. 
-Jazyk aplikace se statistikami.\\+</WRAP> 
 +</WRAP>
  
-**Výchozí jednotka**\\ +===== Nechodí mi hodnoty, co mám dělat? =====
-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)**\\ +{{ :pasted:20221215-133831.png?150&nolink}}Zkontrolujte následující:
-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**\\ +  Je zařízení v pořádku připojené do elektrické sítě a napájené? 
-Nevíte-li, nechte zvolené "Obecné"Bude fungovat jak s vlastním volánímtak s většinou čidel od Papoucha.+  Funguje v síti se zařízením přístup do internetu? 
 +  Máte zařízení v pořádku zapojené do své lokální sítě? 
 +    * Měli byste ho minimálně vidět připojené v síti, většina zařízení odpovídá na ping nebo jde otevřít v prohlížeči jejich webová stránka. Máte-li tu možnostpodívejte se v routeru, jestli komunikuje do internetu. 
 +  * Máte v zařízení správně vyplněné IP adresy (IP adresamaska, brána, DNS server), pokud je nemáte dynamicky přiřazené z DHCP serveru? 
 +  * Podívejte se na debugovací stránku pro ono čidlo administraci - viz [[portal:debug_prichozich_hodnot|Debug příchozích hodnot]]. Chodí na server nějaké hodnoty? Pokud ne, zkontrolujte opět všechny předchozí body. 
 +  * Pokud podle debugu na server nějaké hodnoty z čidla chodí, zkontrolujte v administraci na našem webu u čidla: 
 +    * Hodnotu GUID - máte ji správně vyplněnou na název proměnné s měřenou hodnotou (je-li to pro Váš typ čidla potřeba)? 
 +    * Hodnotu povolené IP adresy - máte-li zapnutou tuto ochranu, aby se měření zapisovala jen pokud přichází z konkrétní internetové adresy (což důrazně doporučujeme), pak se tato adresa mohla změnit. Podívejte se, prosím, opět na [[portal:debug_prichozich_hodnot|Debug příchozích hodnot]] z jaké adresy měření chodí, porovnejte je a případně adresu aktualizujte.
  
----- 
- 
-====== 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 
-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**