Rozdíly

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

--- phpmicrolog [2019/08/09 08:24] – [Popis] mypower_cz
+++ phpmicrolog [2020/01/13 02:36] (aktuální) – upraveno mimo DokuWiki 127.0.0.1
@@ Řádek 5: / Řádek 5: @@
 **PHP MicroLog** je příkaz do příkazové řádky a také knihovna určená pro začlenění do dalších projektů.
-Projekt je vyvíjen ve scriptovacím jazyce PHP a jedná se o software k volnému užití s otevřeným zdrojovým kódem.
+{{:schema.png?350 |}} Projekt je vyvíjen ve scriptovacím jazyce PHP jako software k volnému užití s otevřeným zdrojovým kódem.
-Je určen pro dlouhodobé odesílání dat z měření fotovoltaických elektráren a jiných podobných zařízení prostřednictvím speciálního protokolu, který standardně užívá projekt [[start|MyPower MicroLog]]. Je tedy plně kompatibilní se současným měřením, kde je možné se online [[http://mypower.cz/ulogadmin-register|registrovat]], získat FVEID a logovat data na server MyPower.CZ s možností jejich následné vizualizace a realizace dalších výpočtů, dostupných na serveru.
+Je určen pro dlouhodobé odesílání dat z měření fotovoltaických elektráren a jiných podobných zařízení prostřednictvím speciálního protokolu, který standardně užívá projekt [[start|MyPower MicroLog]].
+Projekt je tedy plně kompatibilní se současným měřením, kde je možné se online [[http://mypower.cz/ulogadmin-register|registrovat]], získat FVEID a logovat data na server MyPower.CZ s možností jejich následné vizualizace a realizace dalších výpočtů, dostupných na serveru.
 Data z měření je díky tomu možno odesílat z libovolného zařízení s podporou jazyka PHP, například Raspbian pro Raspberry PI, atd. Projekt MicroLog tak získává nezávislost na platformě Arduino s níž však zachovává plnou zpětnou kompatibilitu.
@@ Řádek 73: / Řádek 75: @@
 </code>
-**Parametry pinu**
+{{ ::schema3.png?400|}}**Parametry pinu**
   * **name** - Název pinu
@@ Řádek 97: / Řádek 99: @@
   * **def** - Výchozí hodnota
-Typ pinu je možno využít v případě, že v rámci jednoho měření pořizujeme více vzorků, tedy stejně jako [[mod:sampler|sampler]] projektu MyPower MicroLog. Z těchto vzorků jsme schopni spočítat průměrnou hodnotu, efektivní hodnotu, minimální a maximální hodnotu v daném měření a nebo použít jednotlivý vzorek. Poslední varianta může vzhledem k rušení vést k nepřesným výsledkům. U střídávých průběhů (například střídavý proud) je možno použít typ pinu **rms** a zasíláme vypočtenou efektivní hodnotu. Zároveň tím serveru dáváme najevo, že posíláme efektivní hodnotu.
+Typ pinu je možno využít v případě, že v rámci jednoho měření pořizujeme více vzorků, tedy stejně jako [[mod:sampler|sampler]] projektu MyPower MicroLog. Z těchto vzorků jsme schopni spočítat průměrnou hodnotu, efektivní hodnotu, minimální a maximální hodnotu v daném měření a nebo použít jednotlivý vzorek. Poslední varianta může vzhledem k rušení vést k nepřesným výsledkům. U střídavých průběhů (například střídavý proud) je možno použít typ pinu **rms** a zasíláme vypočtenou efektivní hodnotu. Zároveň tím serveru dáváme najevo, že posíláme efektivní hodnotu.
 Třetí hodnota určuje skupinu, do které měřený PIN patří. Je možno použít jednu ze čtyř skupin, **group0**, **group1**, **group2**, **group3**. Nastavení není povinné a je určeno pro informativní účely, pokud na toto nastavení není například navázána nějaká speciální funkce na straně serveru.
@@ Řádek 121: / Řádek 123: @@
   * **$pinconfig** (array) - obsahuje datovou strukturu konfigurace pinů, která je popsána výše v [[#konfigurace-pinu|nastavení]].
   * **$data** (array) - obsahuje datovou strukturu s naměřenými hodnotami jednotlivých pinů
-Pokud se vše povede, funkce vrací pole hodnot jako výsledek odesílání dat.
-Je-li definován index pole s názvem //"message"//, pak toto obsahuje zprávu ze serveru, například o použití neplatného FVEID atd. Pokud je index s názvem //"finalresult"// roven hodnotě //"OK"//, pak odeslání proběhlo v pořádku. Ukázkové použití je ve scriptu //microlog.php//.
-Funkce je vybavena **ukládáním dat do bufferu v případě výpadku internetového spojení**, nebo selhání odeslání dat na server. Je tedy schopna výpadky spojení překlenout. Data, které nebyly odeslány při předchozím pokusu o odeslání budou odeslány prioritně dle času, ke kterému byl daný vzorek pořízen.
 Pro odesílání dat slouží datová struktura typu asociativní pole, kdy klíčem je číslo pinu (A0-A15) a hodnotou je buď přímá hodnota, nebo asociativní pole se všemi typy hodnot.
@@ Řádek 158: / Řádek 154: @@
    "A11" =>  1023,
 </code>
+{{ :schema2.png?400 |}}
+Pokud se odeslání dat podaří, funkce vrací pole hodnot jako výsledek odesílání dat.
+Je-li definován index pole s názvem //"message"//, pak toto obsahuje zprávu ze serveru, například o použití neplatného FVEID atd. Pokud je index s názvem //"finalresult"// roven hodnotě //"OK"//, pak odeslání proběhlo v pořádku. Ukázkové použití je ve scriptu //microlog.php//.
+Funkce je vybavena **ukládáním dat do bufferu v případě výpadku internetového spojení**, nebo selhání odeslání dat na server. Je tedy schopna výpadky spojení překlenout. Záznamy dat z měření, které nebyly odeslány při předchozím pokusu o odeslání budou odeslány prioritně dle času, ke kterému byl daný vzorek pořízen.
 ===== Konfigurační proměnné =====
@@ Řádek 177: / Řádek 182: @@
 Proměnná **$_microlog_failover_buffer** má opět možné hodnoty //"yes"// nebo //"no"//. Je-li volba zapnuta, je použit buffer v případě výpadku spojení nebo selhání odesílání dat. Pokud je volba vypnuta, v případě selhání jsou naměřená data zahozena.
+===== Diskuze o projektu =====
+Téma k tomuto projektu na fóru MyPower.CZ naleznete na adrese http://forum.mypower.cz/viewtopic.php?f=95&t=5199