Rozdíly

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

--- phpmicrolog [2019/08/08 18:42] – [Integrace do vlastního projektu] mypower_cz
+++ phpmicrolog [2019/08/09 12:38] – [Konfigurační proměnné] mypower_cz
@@ Řádek 1: / Řádek 1: @@
-====== PHP Microlog ======
+====== PHP MicroLog ======
 ===== Popis =====
-**PHP Microlog** je příkaz do příkazové řádky a také knihovna určená pro začlenění do dalších projektů.
+**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 83: / Řádek 85: @@
 Pole **min** a **max** jsou typu //float//, je tedy možno použít desetinnou tečku.
-Nastavení pinu v poli **opt** se skládá z pole 3 položek typu string, tedy běžný řetězec.
+Nastavení pinu v poli **opt** se skládá z pole 3 položek typu //string//.
 První položka specifikuje stav pinu a může nabývat hodnot **enabled** nebo **disabled**. Jedná se o signalizaci pro server, zdali je pin aktivní nebo neaktivní. Bez ohledu na toto nastavení jsou data daného pinu odesílána.
@@ Řádek 119: / Řádek 121: @@
 Parametry funkce jsou:
   * **$fveid** (string) - obsahuje přidělené FVEID
-  * **$pinconfig** (array) - obsahuje datovou strikturu konfigurace pinů, která je popsána výše v [[#konfigurace-pinu|nastavení]].
+  * **$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é =====
 V kódu knihovny //lib-mpw-microlog.php// jsou v úvodu 3 konfigurační proměnné.
@@ Řádek 175: / Řá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