Repository navigation
Web Interface Czech
Viz úplná dokumentace Mobile API v1, která je dostupná také v Nápovědě OSPy v části API.
Běžná komunikace aplikace a doručování push jsou dvě oddělené cesty. Při běžném provozu se Android aplikace spojí s místní nebo vzdálenou adresou uloženou u instalace, ověří HTTPS, přihlásí se instalačními tokeny Mobile API v1, načte aktuální stav a posílá povolené příkazy přímo do OSPy. Aplikace zobrazuje průběh spojení a bezpečně opakuje obnovitelné síťové chyby, aniž by uloženou instalaci nahradila.
Při push doručení OSPy nečeká, až se aplikace připojí. Odpovídající událost vloží do omezené fronty na pozadí, podepíše instalační HTTPS požadavek pro relay, relay jej ověří a požádá Firebase Cloud Messaging o probuzení Androidu a zobrazení systémové notifikace. Klepnutí otevře příslušnou uloženou instalaci. Selhání relay nebo FCM se zaznamená, ale nezablokuje zavlažování.
V Nastavení → Mobilní aplikace, mezi kartami Uživatelé a Zabezpečení, správce nastaví HTTPS adresu push relay a zapne okamžité notifikace. Push zůstává ve výchozím stavu vypnutý, ale upravitelné pole relay je předvyplněno oficiální adresou OSPy relay. Stránka používá stejný seznam zařízení jako mobilní API a u každého telefonu ukazuje uživatele, roli, verzi aplikace, čas spárování a poslední aktivity, stav push a poslední úspěšné či neúspěšné doručení. Lze zvolit oznámení o spuštění a zastavení stanice, dešti, diagnostice, aktualizacích a ostatních událostech, odeslat test, odregistrovat push nebo zrušit celé zařízení včetně přihlašovacích tokenů. Aktivní zařízení musí být před trvalým smazáním záznamu nejprve odvoláno; odvolané záznamy lze mazat jednotlivě nebo všechny najednou. Opětovné přihlášení ze stejné uložené instalace Androidu použije její původní identitu a nahradí tokeny bez přidání dalšího řádku.
OSPy neukládá Firebase klíče ani FCM token telefonu. Mobilní aplikace zaregistruje FCM token přímo u relay a OSPy dostane pouze identifikátor předplatného a instalační podpisový klíč. Události se odesílají podepsané v samostatném omezeném pracovním vlákně; nedostupný Internet nebo relay proto nezdržuje plánovač ani ventily. Push je ve výchozím stavu vypnutý a vyžaduje HTTPS. Periodická synchronizace v otevřené aplikaci zůstává záložním mechanismem. Přesný kontrakt je v Mobile API v1.
Společný footer OSPy obsahuje přímý odkaz na oficiální aplikaci pro Android v Google Play.
Jakmile Diagnostika oznámí Připravenost SQLite primary beta: Připraven, zpřístupní Nastavení v poli Režim ukládání nastavení volbu SQLite primární (beta). OSPy před přechodem do tohoto režimu i návratem z něj vytvoří úplnou systémovou zálohu, společně potvrdí ověřenou SQLite a shelve/DBM kopii a restartuje se. Při dalším startu SQLite před použitím jako zdroje nastavení nezávisle ověří; synchronizovaná shelve/DBM kopie zůstává okamžitou zálohou. Chybějící aktivační marker, poškozená databáze, neshoda kontrolního součtu či schématu nebo neplatné nastavení bezpečně ponechá OSPy na shelve/DBM a problém zobrazí Diagnostika. K automatickému přepnutí nikdy nedojde a návrat do režimu Ověřovací je kdykoli dostupný stejným postupem se zálohou a restartem.
Instalace OSPy
Přihlásit se
Domácí stránka
Normální - % doby programu
Aktivní - Zpoždění při dešti
Plánovač - Ručně
Povoleno - Zakázáno
Zastavit všechny stanice
Graf vodní bilance
Potlačeno zpožděním při dešti
Detekován déšť
Teplota CPU
Využití CPU
Program OSPy verze
Vnější IP adresa
V provozu
Diagnostika
Zpětná vazba (Feedback)
Programy
Přidat nový program
Skupiny programů
Přidat skupinu
Přejmenovat skupinu
Zap/Vyp skupinu
Kopírovat skupinu
Smazat skupinu
Spustit nyní
Úprava
Kopírovat
Přesunout do skupiny
Smazat vše
Zap/Vyp program
Upozornění na kolize
Typ plánovače
Vybrané dny (Jednoduchý)
Čas startu
Trvání
Opakovat
Opakování
Pauza
Vybrané dny (Rozšířené)
Plánovač
Opakování (Jednoduché)
Interval zavlažování
Start ve dni
Čas startu
Trvání
Opakovat
Opakování
Pauza
Opakování (Rozšířené)
Interval zavlažování
Start ve dni
Plánovač
Týdenní (Rozšířené)
Pondělí-Neděle
Vlastní
Interval zavlažování
Start ve dni
Den 1 - Den 7
Týdenní (Předpověď počasí)
Minimální zavlažování
Maximální zavlažování
Maximální dávka
Poměr pauzy
Upřednostnění okamžiku provedení
Den
Čas startu
Přednost
Přidat - Smazat
Žádné úpravy
Odříznout
Aktivovat hlavní
Jednorázový
Spustit nyní
Smazat čas
Rozšíření
Spravovat
Instalovat nové rozšíření
Vlastní rozšíření (ZIP)
Github (https://github.com/martinpihrt/OSPy-plugins/archive/master.zip)
Vypnout vše
Zapnout vše
Povolit kontrolu aktualizací
Načíst změny
Změny
Auto aktualizace
Záznam
Záznam událostí
Stáhnout záznam jako
Smazat záznam
Smazat záznam Email
Nastavení
Systém
Zobrazit nápovědu
Název systému
Šablona webu
24-hodinový čas
HTTP IP adresa
O čísle portu
HTTP/S port
Zobrazit rozšíření na home
Zobrazit snímače na home
Jazyk
Zobrazit obrázky na stanicích
Počasí
Použít počasí
Poskytovatel počasí
Stormglass API klíč
Umístění
Uživatelé
Bez hesla
Jméno správce
Aktuální heslo
Nové heslo
Potvrďte heslo
Další uživatelé
Bezpečnost
Ochrana formulářů
Použít HTTPS
Jméno domény
Použít vlastní HTTPS
API CORS povolený origin
Povolit API JSONP
Zapamatovaná přihlášení v prohlížeči
Snímače
Heslo pro nahrávání firmwaru
Nastavení stanic
Maximální využití
O sekvenčních a souběžných režimech
Počet výstupů
Pauza mezi stanicemi
Min čas běhu
Nastavení hl. stanice
Hlavní stanice
Hlavní stanice 2
Aktivovat relé
Posun startu hlavní stanice
Posun vypnutí hlavní stanice
Posun startu hlavní stanice 2
Posun vypnutí hlavní stanice 2
Dešťový senzor
Používat senzor
V klidu rozpojen
Nastavit zpoždění deště
Doba zpoždění deště
Protokolování
Aktivovat záznam
Max záznamů
Aktivovat záznam Emailů
Max záznamů
Povolit protokol událostí
Max záznamů
Povolit ladění
Restartovat systém
Restart OSPy
Restart HW
Vypnout
Smazat nastavení
Záloha a obnovení
Stáhnout
Nahrát
Certifikát SSL
Nahrát
Generovat
Stanice
Stanice
Jméno
Využití
Závlaha
Zásoba
ETo faktor
Zůstatek
Připojeno
Ignorovat Déšť
ZAP Hlavní?
Nepoužito
ZAP Hlavní
ZAP Hlavní 2
ZAP Hlavní 1/2 programem
Poznámky
Obrázek
Snímače
Přidat nový snímač
Vlastnosti snímačů
Smazat všechny snímače
Nápověda
OSPy
Readme
Changelog
Programs
Web Interface Guide - Czech
Web Interface Guide - English
Web Interface Guide - German
Web Interface Guide - Polish
Web Interface Guide - Russian
Web Interface Guide - Serbian
Web Interface Guide - Slovak
API
Readme
Details
Plug-ins
Readme
Usage Statistics
LCD Display
Pressure Monitor
Voice Notification
Pulse Output Test
Button Control
CLI Control
System Watchdog
Voltage and Temperature Monitor
Remote Notifications
System Information
MQTT
Air Temperature and Humidity Monitor
Wind Speed Monitor
Weather-based Rain Delay
Relay Test
UPS Monitor
Water Consumption Counter
SMS Modem
Signaling Examples
Email Notifications
Remote FTP Control
System Update
Water Meter
Elektroměr
Webcam Monitor
Weather-based Water Level Netatmo
Direct 16 Relay Outputs
MQTT Zone Broadcaster
System Debug Information
Weather-based Water Level
Real Time and NTP time
Water Tank
Humidity Monitor
Monthly Water Level
Pressurizer
Ping monitor
Temperature Switch
Pool Heating
E-mail Notifications SSL
Sunrise and Sunset
Photovoltaic Boiler
IP CAM
Modbus stations
CHMI
Proto
Label Maker
IP Scanner
Database Connector
OSPy Backup
MQTT Home Assistant
Shelly Cloud Integration
Current loop tanks monitor
Doporučená čistá instalace používá Raspberry Pi OS nebo Debian 12 a Python 3.11 či novější. Instalátor vždy stahuje stabilní větev OSPy master. Při prvním spuštění se na přihlašovací stránce zobrazí vygenerované heslo správce; po přihlášení je ihned změňte v Nastavení.
Přihlaste se do Pi pomocí SSH. Zadejte nebo zkopírujte a vložte následující příkaz: Pamatujte: Příkazy na Raspberry Pi rozlišují velká a malá písmena.
wget https://raw.githubusercontent.com/martinpihrt/OSPy/master/ospy_setup.sh
sudo bash ospy_setup.shNabídka odděluje základní požadavky od volitelného MQTT a multimediálních balíčků. Lze zvolit instalaci do /opt nebo domovského adresáře. Existující Git instalátor nesmaže, neresetuje ani automaticky neaktualizuje. Službu vytvoří z verzované šablony systemd, spustí ji a ověří její stav; při chybě vypíše poslední záznamy služby. Restart je doporučen jen kvůli I²C nebo změně skupin. Úspěšnou instalaci otevřete na portu 8080. Podrobný bezpečný postup, ruční aktualizace a obnova přístupu jsou v dokumentu Clean installation v Nápovědě.
Po kliknutí na tlačítko "Odhlásit se" se uživatel odhlásí ze systému.
Volitelný plugin Automation Rules vytváří grafická pravidla AND/OR z hodnot monitorovacích pluginů, povolených snímačů OSPy Pihrt nebo Shelly, místního data a času a systémových stavů OSPy určených pouze ke čtení. Pravidlo může čekat na trvalé splnění podmínek, opakovat upozornění a oznámit návrat do normálu přes Home, prohlížeč, e-mail, Telegram nebo mobilní push. Samostatný, ve výchozím stavu vypnutý přepínač řízení povoluje chráněné akce: zastavení vybraných stanic, všech výstupů nebo běžících programů, vypnutí plánovače, jednorázové nebo časově omezené cyklické zapínání konkrétního výstupu v ručním režimu, změnu globální úrovně vody nebo vyvolání akce výslovně deklarované jiným poskytovatelem. Historie akcí ukládá každé spuštění cyklu, pauzu, další běh, chybu a konečné zastavení včetně jeho důvodu. Water Meter 1.2.1 poskytuje první konkrétní akci poskytovatele pro výslovné vynulování nahromaděných čítačů. Testovací režim akce pouze simuluje a ukládá výsledky. Volitelné uzamčení incidentu vyžaduje potvrzení správce až poté, co jsou všechny podmínky dostupné a neaktivní; odemknutí nikdy nevrací provedenou akci zpět.
Volitelný plugin Irrigation Safety propojuje skutečný stav stanic a master výstupů OSPy s hodnotami z mezipaměti pluginů Water Meter, Pressure Monitor a monitorů nádrží. Každá povolená stanice může mít očekávaný minimální a maximální průtok, prodlevu po spuštění a dobu potvrzení závady. Automatické učení přijímá vzorky až po uplynutí prodlevy a pouze tehdy, když běží právě jedna stanice; následně uloží robustní rozsah rozšířený o nastavitelnou bezpečnostní rezervu. Při souběhu kompletně nastavených stanic se jejich rozsahy sčítají. Plugin umí také rozpoznat průtok bez zavlažování, nedostupný průtok, chybějící tlak a nízkou nebo nedostupnou hladinu nádrže.
Při uvádění do provozu použijte režim Pouze sledování. Aktivní ochrana může zastavit všechny právě sepnuté výstupy, vypnout samostatné master relé, zakázat plánovač a ponechat incident uzamčený, dokud jej správce po odeznění závady nepotvrdí. Časově omezené obejití potlačí řídicí zásahy, ale sledování a upozornění zůstanou aktivní. Bezpečnostní akce proběhnou před asynchronním odesláním e-mailu nebo mobilní push zprávy. Stránka na pozadí obnovuje měření, aktivní stanice, průběh učení, incidenty a omezenou historii.
Kompatibilní spuštění poskytovatelé přidávají vlastní chráněné akce. Venetian Blind může otevřít, zastavit, zavřít nebo nastavit náklon 1–4; Water Tank Monitor může zastavit regulaci a vynulovat zaznamenané minimum a maximum; Current Loop Tanks Monitor může zastavit regulaci jedné nebo všech nádrží; OSPy Backup může vytvořit archiv dat pluginů.
Dvoufázové ověření chrání hlavní administrátorský účet druhým krokem po zadání hesla. Otevřete Nastavení → Dvoufázové zabezpečení → Nastavit a zvolte právě jednu možnost: Autentizační aplikace (TOTP), Kód zaslaný e-mailem, nebo Vypnuto. Obě metody nelze používat současně.
Pro TOTP spusťte jednou python setup.py install, pokud OSPy oznámí chybějící podporu QR. Zobrazený QR kód naskenujte pomocí Google Authenticatoru, Microsoft Authenticatoru, 2FAS, Aegis nebo jiné TOTP aplikace a zadejte její aktuální šestimístný kód. OSPy tajný klíč aktivuje až po tomto potvrzení. TOTP vyžaduje správně nastavený systémový čas.
E-mailové ověření je dostupné pouze tehdy, když je plugin E-mail Notifications SSL nainstalovaný, spuštěný a má nastavený SMTP server, účet, heslo a příjemce. Při zapnutí OSPy ihned odešle potvrzovací kód. Přihlašovací kódy platí pět minut a nikdy se neukládají do fronty pluginu pro pozdější odeslání.
Po zapnutí kterékoli metody bezpečně uložte zobrazené jednorázové záložní kódy. Každý může jednou nahradit běžný druhý faktor a poté se smaže; znovu se nezobrazí. Změna nebo vypnutí 2FA zruší všechna zapamatovaná přihlášení. Prohlížeč se zapamatuje až po úspěšném zadání hesla i druhého faktoru. Při ztrátě telefonu nebo výpadku e-mailu použijte záložní kód; bez něj je nutné obnovit zálohu konfigurace nebo 2FA lokálně resetovat na zařízení OSPy. Odhlásit se
Přihlašovací stránka představuje textové pole pro zadání jména a hesla. Výchozí jméno je admin. Při první instalaci bude vygenerováno náhodné heslo (toto heslo je pak nutné změnit v nastavení na jiné heslo! Na stránce - záložce "Nastavení" se doporučuje změnit si heslo (nebo i jméno) na Vaše nové vlastní heslo. Zadejte jméno, heslo a klikněte na tlačítko PŘIHLÁSIT SE.
Domovská stránka je hlavním ovládacím centrem webového rozhraní. To zahrnuje:
- Hodiny zobrazující aktuální čas Na všech stránkách.
- Navigační lišta v horní části pro pohyb mezi stránkami. Rozhraní se také nachází na ostatních stránkách kromě přihlašovací stránky.
- Sada tlačítek pro provádění globálních změn chování systému.
- Časová osa, která poskytuje informace o dokončených a naplánovaných zavlažovacích událostech.
- Graf, který poskytuje informace o zavlažovacích událostech.
- Zápatí, které je přítomno na všech stránkách (pokud je přihlášený uživatel). Zápatí obsahuje: Teplota procesoru, Využití procesoru, Verze softwaru, Externí IP adresa, Doba provozu OS.
- Některá rozšíření umějí injektovat domácí stránku a přidávat další prvky. Například rozšíření astral přidává do časové osy grafické znázorněná východu a západu slunce. Rozšíření tank monitor grafické sloupce s objemem a množstvím vody.
Tlačítko, které umožňuje nastavit „hladinu vody“ jako celkové procento doby běhu pro všechny zavlažovací programy (u programů prodloužit, nebo zkrátit jejich nastavenou dobu).
Zpoždění při dešti. Tlačítko, které umožňuje na zadanou dobu pozastavení zavlažování pro všechny stanice kromě těch, které byly nastaveny tak, aby ignorovaly déšť na stránce Stanice.
Plánovač - Ručně. Tlačítko, které přepíná systém mezi plánem (automatickým režimem) a manuálním režimem, který umožňuje přímé ovládání stanic.
Tlačítko pro povolení, nebo zakázání běhu OSPy programu (při zakázáno nepoběží plánovač).
Tlačítko „Zastavit všechny stanice“ slouží pro okamžité zrušení spuštěného zavlažovacího programu nebo aktivní stanice.
Pro každou povolenou stanici zařazenou do zavlažovacího programu zobrazuje graf ve spodní části domovské stránky průběžnou vodní bilanci. Každý den započítává evapotranspiraci (ETo) upravenou ETo faktorem stanice, déšť, pokud jej stanice nemá ignorovat, a dokončené nebo naplánované zavlažování. Podrobnosti bodu rozlišují ETo, déšť, příspěvky jednotlivých programů a výsledný součet pro minulé i předpovězené dny.
Je-li zapnuta volba Používat počasí, pochází ETo a déšť ze zvoleného poskytovatele Open-Meteo, ČHMÚ ALADIN nebo Stormglass. API klíč je nutný pouze pro Stormglass; Open-Meteo ani ČHMÚ nesmějí záviset na starém klíči Dark Sky. Při vypnutém počasí se použije ETo faktor stanice a nulový déšť. Pokud se data bilance nepodaří načíst, domovská stránka zobrazí viditelnou chybovou hlášku a OSPy zapíše technické podrobnosti do logu, místo aby graf beze slova zůstal prázdný.
Je-li aktivováno zpoždění při dešti, zobrazí se „Potlačeno dešťovým zpožděním“ a všechny stanice (kromě těch, které byly nastaveny tak, aby ignorovaly déšť na stránce Stanice) budou po určitou dobu blokovány.
Pokud je aktivován dešťový senzor, zobrazí se „Potlačeno dešťovým senzorem“ a všechny stanice (kromě těch, které byly nastaveny tak, aby ignorovaly déšť na stránce Stanice) budou blokovány.
Teplota procesoru Raspberry pi. Zobrazenou teplotu lze přepínat mezi C a F.
Využití procesoru Raspberry pi. Využití je zobrazené v %.
Odkaz na úložiště softwaru projektu a číslo revize nainstalovaného softwaru.
Stabilní sestavení z větve master používá číselnou verzi, například 3.0.238. Testovací sestavení z větve beta zobrazuje stejnou revizi s příponou -beta, například 3.0.238-beta. Po přesunu stejného commitu do master přípona zmizí, ale číslo revize se nezmění.
Rozšíření System Update před každou aktualizací nejprve uloží nastavení a vytvoří ověřenou bezpečnostní zálohu. Potom, ještě před změnou sledovaných souborů Git, spustí externí watchdog. Na instalacích se systemd běží watchdog v samostatné dočasné službě a zůstává aktivní i během restartu OSPy. Bez systemd se použije oddělený pomocný proces.
Nový proces OSPy potvrdí úspěšnou aktualizaci teprve tehdy, když plánovač vytvoří novou odezvu heartbeat a webové rozhraní začne přijímat spojení. Pokud se zdravý start nepotvrdí do 120 sekund, watchdog automaticky obnoví předchozí commit i původní větev a znovu spustí OSPy. Jestliže watchdog nelze spustit, aktualizace se zastaví dříve, než se změní sledované soubory. Výsledek watchdogu je dostupný také v Diagnostice ve stavu rozšíření System Update.
System Update zobrazuje úplný commit právě spuštěné verze i přesný cílový commit z vybraného kanálu. Za ověřené stabilní vydání považuje pouze anotovaný Git tag ve tvaru vX.Y.Z, jehož commit je součástí origin/master. Zpráva anotovaného tagu slouží jako stručné poznámky k vydání. Lehké tagy, jiné názvy a tagy mimo master se nenabízejí.
Návrat na poslední ověřené stabilní vydání i ruční návrat na starší commit nejprve uloží nastavení, vytvoří ověřenou bezpečnostní zálohu a spustí stejný externí watchdog jako běžná aktualizace. Stabilní návrat přepne pracovní větev na master. Tag vydání vytváří správce projektu ručně až po úspěšných testech; samotný plugin tagy nevytváří.
Externí IP adresa pro systém OSPy (adresa vašeho poskytovatele připojení - routeru). Testováno prostřednictvím služby pihrt.com.
Doba běhu systému Raspberry pi od zapnutí (nebo restartu).
Řádek Databáze navíc zobrazuje aktivní úložiště nastavení a připravenost SQLite. Tato přechodná verze nadále čte a zapisuje stávající soubory shelve/DBM. Samotná kontrola připravenosti používá pouze dočasnou databázi v paměti a nevytváří soubor ani migraci dat. Pokud podpora SQLite v Pythonu není dostupná, OSPy dál používá shelve/DBM a důvod zobrazí pouze jako pasivní informaci, nikoli jako poruchu systému.
Po každém úspěšném uložení nastavení vytvoří OSPy vedle aktivních souborů shelve/DBM také ověřenou stínovou kopii options.sqlite3. Zapisuje ji přes dočasný soubor a atomicky ji nahradí teprve po úspěšné kontrole schématu, klíčů, hodnot a integrity. Při spuštění OSPy ze stínové kopie nikdy nenačítá nastavení. Selhání synchronizace ponechá autoritativní uložení shelve nedotčené a zobrazí se jako varování v řádku Databáze; chybějící stínová kopie čeká na další uložení nastavení.
Při spuštění OSPy porovná autoritativní hodnoty shelve s kontrolními součty SHA-256 uloženými ve stínovém schématu 2. Při této automatické kontrole nerozbaluje hodnoty pickle ze stínové kopie a nikdy je nepoužije k obnově ani spuštění OSPy. Shodná kopie se označí jako ověřená; chybějící, změněné nebo neočekávané klíče a poškození kontrolního součtu či databáze se zobrazí jako varování, zatímco shelve zůstane v provozu. Stínová kopie schématu 1 z předchozí přechodné fáze se nečte a při dalším uložení nastavení se bezpečně nahradí.
Při startu a po každém úspěšném nahrazení stínové kopie provede OSPy zkušební rozbalení teprve tehdy, když se v jediném snímku pouze pro čtení shodují všechny klíče a kontrolní součty, a na rekonstruované SQLite hodnoty použije běžnou validaci nastavení. Rekonstruovaný slovník se zahodí a nikdy se nepřiřadí běžící konfiguraci. Diagnostika uvede, zda tento test čtení SQLite prošel; selhání zůstane varováním a OSPy pokračuje výhradně s již aktivním nastavením shelve.
Stínové schéma 3 obsahuje také manifest s celkovým počtem záznamů a kontrolním součtem nad úplným seřazeným seznamem klíčů a jejich součtů. Nezávisle tak před rozbalením odhalí odstraněný nebo přidaný řádek. OSPy provede a zahodí úplnou zkoušku obnovy pro aktuální SQLite kopii i předchozí kopii v záložním adresáři. Diagnostika zobrazí oba výsledky. Neúspěšný nebo nedostupný kandidát obnovy nikdy nezmění volbu při startu; autoritativní zůstává shelve/DBM.
Při spuštění OSPy použije prvního nezávisle ověřeného kandidáta SQLite pouze ke zkoušce obnovy v izolovaném dočasném adresáři. Vytvoří z něj dočasnou databázi shelve/DBM, znovu ji otevře, ověří všechna nastavení a porovná jejich serializované hodnoty; poté dočasný adresář odstraní. Aktivní databáze ani zdroj nastavení při startu se nemění. Pokud je aktuální SQLite kopie poškozená, zkouška může použít ověřenou záložní kopii, zatímco běžící nastavení se stále načte z autoritativního shelve. Výsledek, zdroj a počet nastavení zobrazuje řádek Databáze v Diagnostice.
OSPy navíc pouze nasimuluje nouzové rozhodnutí pro případ, že by byly neplatné všechny shelve/DBM databáze. Přednost má nezávisle ověřená aktuální SQLite kopie; ověřená záloha by se zvolila jen při chybě aktuální kopie. Vybraný slovník se zahodí a nikdy se nepřiřadí do běžících nastavení, takže ani tento stav zatím neaktivuje obnovu ze SQLite. Diagnostika zobrazuje připravenost, hypotetický zdroj a počet nastavení.
Volba Povolit nouzovou obnovu nastavení ze SQLite v kategorii Úložiště nastavení je experimentální a ve výchozím stavu vypnutá. Po zapnutí vytvoří OSPy nesekretní atomický aktivační marker až po nezávislém ověření SQLite schématu 3; povolení musí současně obsahovat i samotná ověřená SQLite kopie, takže marker ani databáze nestačí samostatně. Obnova se použije pouze tehdy, když jsou neplatné aktuální, dočasná i záložní databáze shelve/DBM. OSPy upřednostní aktuální SQLite kopii, případně ověřenou zálohu, obnoví a znovu ověří shelve databázi v dočasném adresáři a teprve tu načte. Stávající aktuální a záložní adresáře tento krok nepřepíše a běžné ukládání zůstává shelve/DBM. Vypnutí odstraní marker ještě před zápisem nastavení. Skutečné použití nebo chyba se zobrazí v Diagnostice a ve zprávě o obnově při startu; po obnově zkontrolujte systém a vytvořte zálohu.
Experimentální volba Upřednostnit ověřené čtení nastavení ze SQLite v kategorii Úložiště nastavení je také ve výchozím stavu vypnutá. Po zapnutí OSPy vždy nejprve načte a ověří shelve/DBM, potom porovná úplnou sadu klíčů a kontrolních součtů SQLite s tímto přesným autoritativním snímkem a nezávisle dekóduje a ověří každou hodnotu. Teprve při úplné shodě přiřadí ekvivalentní slovník SQLite do běžících nastavení. Chybějící kopie, rozdíl, poškození nebo chyba dekódování ponechá již načtené shelve bez přerušení. Zápisy, rotace adresářů a zálohy nadále používají výhradně shelve/DBM; SQLite zůstává ověřenou stínovou kopií. Diagnostika ukazuje použití, vypnutí nebo návrat k shelve.
Experimentální volba Vyžadovat ověřené SQLite pro potvrzení nastavení v kategorii Úložiště nastavení je ve výchozím stavu vypnutá. Po zapnutí smí nový adresář nastavení nahradit aktivní data pouze tehdy, když se v dočasném adresáři úspěšně zapíše a nezávisle ověří shelve/DBM i jeho SQLite kopie. Pokud SQLite není dostupné nebo zápis či ověření selže, OSPy odstraní celý nepotvrzený dočasný adresář, zachová předchozí aktivní nastavení i čas posledního uložení a ohlásí chybu zápisu. Vypnutí obnoví kompatibilní chování s prioritou shelve. Úspěšný přísný zápis lze číst ověřenou SQLite cestou, ale shelve/DBM zůstává formátem ukládání a záloh. Aktivní politiku potvrzení zobrazuje Diagnostika.
Diagnostika uchovává neautoritativní důkaz migrace SQLite: počty po sobě jdoucích úspěšných startů s ověřeným čtením a přísných dvojitých zápisů. Chyba vynuluje pouze příslušnou řadu a uloží čas a důvod. Samostatný atomicky zapisovaný soubor neobsahuje nastavení a nikdy se nepoužívá ke spuštění, obnově ani rozhodování o úložišti.
Jazyk rozhraní se při časném startu nadále nejprve načte z platné databáze shelve/DBM. Je-li povoleno ověřené čtení SQLite, bootstrap porovná všechny klíče a kontrolní součty s tímto přesným shelve snímkem a teprve po úplné shodě načte ze SQLite jedinou hodnotu lang. Chybějící, starší, rozdílná nebo poškozená SQLite kopie vždy bezpečně použije jazyk ze shelve. Kontrola chybějící databáze sama nevytváří žádný prázdný soubor.
Selector Režim ukládání nastavení sdružuje bezpečné přechodové volby. Kompatibilní ponechá shelve/DBM jako hlavní úložiště a SQLite jako volitelnou stínovou kopii. Ověřovací zapne nouzovou obnovu, ověřené čtení a přísný dvojí zápis; ani tento režim nedělá z SQLite hlavní databázi. Jednotlivé přepínače zůstávají dostupné pro pokročilé řízení a jejich smíšená kombinace se automaticky označí jako Vlastní pokročilé nastavení. Starší instalace odvodí režim z již uložených přepínačů bez změny jejich hodnot.
Diagnostika navíc vyhodnocuje pasivní kontrolu Připravenost SQLite primary beta. Stav Připraven vyžaduje režim Ověřovací, ověřenou aktuální stínovou kopii, úspěšné testy čtení a obnovy aktuální i záložní kopie, úspěšnou zkoušku obnovy a nouzového výběru, zapnutou nouzovou obnovu, ověřené čtení a přísný dvojí zápis a nejméně pět po sobě jdoucích ověřených startů a dvacet přísných zápisů. Do té doby Diagnostika ukazuje sběr důkazů nebo konkrétní blokující kontroly. Tato kontrola nikdy automaticky nepřepne úložiště; hlavní zůstává shelve/DBM.
Tlačítko Diagnostika v patičce otevře administrátorskou stránku pro kontrolu, jak OSPy a jeho rozšíření využívají systém.
Když Diagnostika zjistí chybu, otevře červené okno s popisem problému, dostupnými podrobnostmi, možným řešením a odkazem na související stránku. Administrátor může stejné okno zapnout také na domovské stránce volbou Nastavení > Diagnostika > Zobrazovat chyby diagnostiky na domovské stránce. Chybové okno má přednost před upozorněním na aktualizaci. Vypnutí volby se týká pouze domovské stránky; chyby zůstávají viditelné v Diagnostice.
Stránka používá rozbalovací sekce Stav systému, Výkon a procesy a Kontrola zabezpečení. Klepnutím na tmavý pruh se sekce rozbalí nebo sbalí. Stav systému přiřazuje každé provozní oblasti stav v pořádku, varování, chyba nebo nenakonfigurováno. Sleduje heartbeat plánovače, poslední úspěšný výpočet plánu a nejbližší běh, zápisy příkazů do výstupů, komunikaci senzorů, dostupnost databáze nastavení, volné místo, chyby povolených rozšíření, připravenost e-mailu, počasí, internetové připojení a nejnovější dostupnou zálohu. Úspěšný zápis výstupu potvrzuje, že OSPy předalo požadovaný stav ovladači; bez hardwarové zpětné vazby nepotvrzuje fyzické sepnutí relé.
Poslední řádek Stav operačního systému spouští na pozadí bezpečně ošetřenou kontrolu Linuxu a kořenového úložiště a výsledek ukládá na deset minut do mezipaměti. Celý řádek používá zelený stav V pořádku, žluté Varování a červené Kritické; každá dílčí kontrola je navíc označena jako V pořádku, Varování, Kritické nebo Informace. Kontroluje režim připojení root filesystemu, místo, inody, malý synchronizovaný test zápisu a čtení, dostupná metadata EXT4 a identitu SD karty, napájení a throttling Raspberry Pi, teplotu CPU, paměť, zatížení, selhané služby systemd a omezenou část kernelového logu pro chyby MMC, I/O, EXT4, přepnutí pouze pro čtení, panic, lockup a nedostatek paměti. Chybějící příkazy nebo oprávnění se zobrazí bez zastavení OSPy. Kontrola nepoužívá sudo a nikdy nespouští fsck ani jinou opravu na připojeném root filesystemu.
Sekce Jak OSPy funguje nabízí interaktivní diagramy programu a plánovače, rozhodování o spuštění stanice, master stanice, počasí, snímačů, životního cyklu rozšíření, bezpečné aktualizace, ukládání nastavení a zálohy s obnovou. Diagram lze přiblížit, otevřít přes celou šířku, vytisknout nebo stáhnout jako SVG či PNG. Uzly s přerušovaným obrysem otevírají související stránku OSPy; samostatné tlačítko vede do odpovídající nápovědy. Mermaid renderer je uložen přímo v OSPy a diagramy nepotřebují internet.
Bezpečnostní témata dále vysvětlují celý chráněný průchod webového požadavku, HTTPS a certifikáty, přihlášení s dvoufázovým ověřením, relace s CSRF a zapamatovacími tokeny a zabezpečení API i snímačů. Diagramy rozlišují autentizaci od oprávnění role a od CORS, ukazují ochranu proti hrubé síle a připomínají, že OSPy ukládá pouze hash tajné části dlouhodobého přihlašovacího tokenu.
Další diagramy pokrývají priority a souběh zavlažování, déšť a vodní bilanci, cestu příkazu do výstupního hardwaru, role uživatelů, události a incidenty, doručování oznámení, start a ukončení OSPy, schvalování oprávnění rozšíření, celý životní cyklus snímače a bezpečné zpřístupnění OSPy v síti. Diagram Čistá instalace OSPy popisuje skutečný bezpečný instalátor od kontroly Linuxu a Pythonu přes stabilní větev master, závislosti, SQLite a systemd až po první přihlášení a změnu vygenerovaného hesla.
Řádek Jazyky porovnává každý překladový katalog s aktuální šablonou a u každého jazyka ukazuje procento přeložených a přesný počet chybějících řetězců. Úplný překlad je zelený, pokrytí od 80 % je žluté a nižší pokrytí červené. Jde pouze o informaci pro správce překladů: stav jazyků nemění celkový stav systému ani neotevírá chybové okno Diagnostiky.
Kontrola zabezpečení pasivně vyhodnocuje HTTPS, anonymní přístup, dvoufaktorové ověřování, autentizaci senzorového API, ochranu API proti CSRF, CORS, heslo senzorů a doporučené bezpečnostní HTTP hlavičky. Heslo senzoru nikdy nezobrazuje a nemění žádné nastavení. Profil Domácí síť hodnotí vybrané kompromisy kvůli kompatibilitě jako varování, zatímco profil Přístup z internetu vyžaduje šifrovaný, ověřený a omezený přístup. Každý nález obsahuje aktuální stav, doporučení a odkaz na související nastavení. Reverzní proxy může bezpečnostní HTTP hlavičky doplnit až poté, co odpověď opustí OSPy; Diagnostika uvádí pouze to, co může zaručit samotné OSPy.
Zachycené provozní chyby jádra se zobrazují ve Stavu systému jako samostatné problémy. Záznam uvádí dotčenou součást, počet opakování, poslední výskyt, technickou příčinu a doporučený postup opravy. Po úspěšném opakování operace se aktivní problém automaticky odstraní; úplný traceback zůstává v záznamu událostí. Očekávané kompatibilní fallbacky se jako chyby nezobrazují.
Rozbalovací sekce Historie incidentů uchovává nejvýše 200 posledních problémů i po restartu OSPy. Lze filtrovat všechny, aktivní, vyřešené a restartem přerušené incidenty. Opakování stejného aktivního problému zvyšuje jeho počítadlo místo vytváření duplicit; tabulka uvádí čas otevření, poslední výskyt a vyřešení. Historie je atomicky ukládána do omezeného validovaného JSON souboru a neukládá celé tracebacky.
Souhrn systému ukazuje aktuální využití CPU, teplotu CPU, dobu běhu systému, load average, využití CPU procesem OSPy, využití paměti OSPy, počet vláken, informace o platformě a čas posledního obnovení.
Tabulka rozšíření ukazuje všechna dostupná rozšíření, zda běží a zda jsou povolená, jejich vlastní provozní stav, aktuální zátěž CPU, celkový čas CPU, počet vláken, čas spuštění, počet restartů a dostupné akce. Rozšíření může volitelně poskytovat funkci health(), která vrací například {'status': 'ok', 'summary': '...', 'details': '...'}; povolené stavy jsou ok, warning, error a unknown. Starší rozšíření bez této funkce zůstávají plně kompatibilní a zobrazují stav „nehlášeno“. Chyba nebo překročení časového limitu kontroly stavu nezastaví rozšíření ani stránku Diagnostika. Data se obnovují automaticky, takže stránku lze nechat otevřenou při sledování zatížení systému.
Ve výchozím stavu jsou rozšíření seřazena podle aktuální zátěže CPU od nejvyšší po nejnižší. Pomocí volby Řadit rozšíření lze přepnout řazení podle názvu rozšíření nebo podle celkového času CPU, pokud je potřeba stabilní seznam nebo hledání dlouhodobých spotřebitelů CPU.
Akce Otevřít otevře stránku rozšíření. Restart plugin restartuje pouze vybrané běžící rozšíření; nerestartuje celé OSPy.
Pokud se zobrazí varování při obnovování, poslední automatické čtení z diagnostického API selhalo nebo vrátilo kontrolovanou chybu. Stávající data mohou zůstat zobrazená do dalšího úspěšného obnovení a varování se po úspěšném obnovení automaticky smaže.
Tlačítko Feedback v hlavičce vlevo od názvu systému otevře stránku pro hlášení chyb, návrhů a dotazů. Stránka je dostupná přihlášenému správci i uživateli; na přihlašovací stránce se tlačítko nezobrazuje.
Vyberte typ hlášení Bug report (chyba), Feature request (návrh vylepšení) nebo Question (dotaz), zadejte stručný název a podrobný popis. Tlačítko Continue to GitHub otevře na GitHubu předvyplněné nové Issue. Uživatel se na GitHubu přihlásí, obsah ještě zkontroluje a teprve potom jej odešle. OSPy neukládá přístupový token GitHubu a samo Issue bez tohoto potvrzení nevytváří.
Volba pro přiložení systémových informací je ve výchozím stavu zapnutá a před odesláním ukazuje přesný náhled údajů: verzi a datum OSPy, architekturu, distribuci a verzi operačního systému a verzi Pythonu. Název systému OSPy, jméno obsluhy, IP adresy ani jedinečný identifikátor statistik používání se nepřikládají. Zaškrtnutí lze zrušit a odeslat pouze vlastní text.
Tlačítko View existing reports otevře seznam GitHub Issues. Tlačítko GitHub Discussions vede přímo do diskusí projektu, které jsou vhodné pro obecné otázky a společné návrhy. Snímky obrazovky a další soubory lze přidat po otevření GitHubu.
Formulář využívá přihlášení a ochranu formulářů OSPy (CSRF). Při přechodu na GitHub se neposílá adresa otevřené stránky OSPy jako HTTP referrer.
Tlačítkem "Přidat nový program" vytvoříme nový program plánovače.
Programy lze uspořádat do rozbalovacích skupin. Skupiny se hodí například pro oddělení letních a zimních programů, nebo pro přehledné rozdělení podle části zahrady.
Tlačítkem "Přidat skupinu" vytvoříme novou skupinu programů.
Akce pro přejmenování skupiny změní pouze název skupiny. Programy přiřazené do skupiny zůstanou zachované.
Akce ZAP/VYP u skupiny povolí nebo zakáže všechny programy v dané skupině najednou. Je vhodná například pro sezónní přepínání více programů.
Akce kopírování vytvoří novou skupinu a zkopíruje do ní všechny programy z původní skupiny. Zkopírované programy jsou vytvořené jako zakázané, aby se nespustily dříve, než je zkontrolujeme.
Smazání skupiny vyžaduje potvrzení. Programy ze smazané skupiny se přesunou do výchozí skupiny.
Tlačítko "Odložit skupinu" vedle tlačítka "Přidat nový program" jednorázově přesune nejbližší plánovaný běh celé skupiny. Zvolíme nový datum a čas spuštění prvního programu a před potvrzením se zobrazí náhled původního a nového časového rozsahu. Nový začátek musí být pozdější než původní začátek, musí být v budoucnosti a lze jej nastavit nejvýše 30 dní dopředu.
OSPy vyhledá nejbližší budoucí běh každého povoleného programu ve skupině a všechny tyto běhy posune o stejný časový rozdíl. Pořadí programů, jejich délky a vzájemné časové rozestupy zůstanou zachované. Například skupinu naplánovanou dnes od 18:00 do 22:00 můžeme odložit na zítřek od 07:00; přesunutý běh pak skončí přibližně v 11:00.
Odklad nemění běžné nastavení programů ani jejich další plánované dny. Původní nejbližší běh se pouze jednorázově přeskočí a jeho náhrada se spustí v novém čase. Odložené programy nadále respektují zapnutí plánovače, dešťové blokace, dešťový senzor, omezení zatížení výstupů a prodlevy mezi stanicemi. Odklad je uložen v nastavení a přežije restart služby OSPy. Pro jednu skupinu lze mít pouze jeden aktivní odklad.
Aktivní odklad je zobrazen u skupiny jako původní čas, šipka a nový čas. Tlačítkem "Zrušit odklad" jej můžeme odstranit. Pokud původní čas ještě nenastal, obnoví se normální původní běh. Pokud už původní čas nastal, původní běh se z bezpečnostních důvodů znovu nespustí a zruší se pouze náhradní odložený běh. Skupinu s aktivním odkladem nelze smazat; nejprve musíme odklad zrušit. Vytvoření i zrušení odkladu je dostupné pouze administrátorovi a je chráněné přihlášením a CSRF kontrolou.
Tlačítkem "Spustit nyní" spustíme program okamžitě bez ohledu na čas a datum plánovače.
Tlačítko "Úprava" slouží k upravení parametrů již vytvořeného programu.
Tlačítko "Kopírovat" vytvoří kopii vybraného programu. Kopie je ve výchozím stavu zakázaná, takže ji můžeme bezpečně upravit před použitím v plánovači.
Program lze přiřadit do skupiny na stránce úpravy programu. Tím se změní pouze jeho umístění na stránce Programy.
Tlačítko "Smazat vše" odstraní po potvrzení všechny existující programy.
Přepínač "ZAP/VYP" umožňuje vytvořený program povolit/zakázat v plánovači.
Při uložení programu OSPy kontroluje povolené programy a hledá překryvy plánovaného běhu na stejné stanici/výstupu. Pokud je ve stejném čase naplánovaný jiný program, stránka Programy zobrazí upozornění s dobou překryvu. Jde pouze o upozornění, program se automaticky nezablokuje ani neupraví.
Typ plánovače umožňuje zvolit vhodný typ programu podle našeho požadavku (vybrané dny, opakování, týdenní, vlastní a programy založené na předpovědi počasí).
Změnou typu se změní zobrazená pole i způsob, kterým OSPy sestavuje plán. Po změně typu proto před uložením zkontrolujte všechny hodnoty. V grafickém plánovači prvním kliknutím označíte začátek a druhým konec intervalu; křížkem u existujícího intervalu jej odstraníte. Časy se vyhodnocují v místním čase systému OSPy.
Každý stávající opakovaný program lze dále omezit kalendářními pravidly. Povolené měsíce lze označit jednotlivě nebo zkratkou pro jaro, léto, podzim, zimu a celý rok. Parita kalendářního dne povolí všechny, liché nebo sudé datumy a do pole Dny v měsíci lze zadat vybraná čísla od 1 do 31. Pravidla se kombinují s běžnými dny týdne nebo intervalem opakování; výchozí hodnoty zachovávají původní plán.
Do pole Zakázané termíny se zadává jedna položka na řádek: přesné datum (RRRR-MM-DD), včetně krajních dnů přesný rozsah (RRRR-MM-DD..RRRR-MM-DD) nebo každoročně opakovaný rozsah (MM-DD..MM-DD). Roční rozsah může přecházet přes Nový rok. Zablokovaný běh zůstane v plánu viditelný s uvedeným důvodem. Volba Nespouštět o státních svátcích používá místně nainstalovaný kalendář svátků. Zemi OSPy zjistí z polohy počasí; jiný dvoupísmenný kód lze zadat v Nastavení → Počasí → Vlastní země pro svátky. Pokud knihovna nebo země nejsou dostupné, bezpečně se zablokují pouze programy, které vyloučení svátků požadují; OSPy i ostatní programy běží dál.
V části Servisní odstávky na stránce Programy lze vytvořit pojmenovaný globální interval začátku a konce. Překrývající se automatické běhy se zobrazí jako blokované, ale Spustit nyní zůstane dostupné pro záměrnou servisní zkoušku. Odstávky zůstanou uložené i po restartu OSPy.
Typy programu podle východu a západu Slunce jsou dostupné pouze tehdy, když je zapnutý stávající plugin Sunrise and Sunset, je aktivní jeho výpočet Astral a je k dispozici platná poloha. Program může začít před vypočteným jevem nebo po něm pomocí kladného či záporného posunu v minutách. Nejčasnější a nejpozdější povolený čas výsledek omezí; běh mimo okno lze přesunout na nejbližší hranici nebo přeskočit. Nadále platí trvání, pauza, opakování, vybrané dny týdne i všechna kalendářní pravidla. Při nedostupném pluginu OSPy nehádá pevný čas a uložený program zachová do obnovení poskytovatele.
Spouští stejný jednoduchý plán ve všech označených dnech týdne. Vyberte jeden nebo více dnů a nastavte první spuštění.
Čas, kdy v každém vybraném dni začne první běh programu.
Doba jednoho běhu každé vybrané stanice v minutách.
Zapne další běhy ve stejném vybraném dni po dokončení prvního běhu.
Počet dalších běhů po prvním. Hodnota 2 tedy znamená celkem tři běhy.
Počet minut mezi koncem jednoho běhu a začátkem dalšího opakování.
Spouští ručně zakreslené intervaly ve všech vybraných dnech týdne. Hodí se pro několik navzájem nezávislých časů spuštění a zastavení během dne.
V grafickém řádku 24 hodin vytvořte jeden nebo více intervalů začátek/konec. Stejné intervaly se použijí pro každý označený den týdne.
Spouští jednoduchý plán po zadaném počtu dnů; cyklus je ukotven počátečním datem, nikoli pevnými dny týdne.
Počet dnů mezi aktivními dny. Hodnota 1 znamená každý den, 2 každý druhý den.
Počet dnů od dneška do prvního aktivního dne. Hodnota 0 zahájí cyklus dnes.
Čas prvního běhu v každém aktivním dni.
Doba jednoho běhu každé vybrané stanice v minutách.
Zapne další běhy ve stejném aktivním dni.
Počet dalších běhů po prvním běhu.
Prodleva v minutách mezi jednotlivými opakovanými běhy.
Opakuje grafický denní plán v pevném intervalu několika dnů.
Počet dnů mezi provedeními zakresleného plánu.
Posun od dneška v počtu dnů k datu, které ukotví opakovací cyklus.
Zakreslete všechny intervaly začátek/konec pro jeden aktivní den. OSPy celou sadu zopakuje po zadaném intervalu zavlažování.
Umožňuje vytvořit samostatný grafický plán pro každý den týdne a celou sadu opakuje po sedmi dnech.
Intervaly zakreslujte přímo do řádku požadovaného dne. Každý den může obsahovat několik intervalů nebo zůstat prázdný.
Vytváří přesně určený vícedenní opakovací cyklus. Použijte jej, pokud požadované pořadí nelze vyjádřit jednoduchými ani rozšířenými typy.
Délka opakovacího cyklu ve dnech. Po posledním dni cyklu se plán vrátí na Den 1.
Počet dnů od dneška, po kterých začne Den 1 vlastního cyklu.
V zobrazených dnech cyklu zakreslete nezávislé intervaly začátek/konec. Intervaly se ukládají jako minuty od začátku Dne 1.
Plánuje zavlažování podle vodní bilance stanic a předpovědi počasí. Zadané okamžiky jsou pouze příležitosti; OSPy je může vynechat nebo zkrátit, pokud vypočtený deficit zavlažování nevyžaduje.
Minimální deficit vody v milimetrech, od kterého je dovoleno zavlažování spustit.
Největší množství vody v milimetrech, které lze dodat jedné stanici při jednom upřednostněném okamžiku.
Největší množství vody v milimetrech, které lze dodat nepřetržitě před vložením pauzy.
Délka pauzy v procentech předchozího nepřetržitého běhu. Například 50 % vloží pauzu o poloviční délce běhu.
Seřazený seznam týdenních příležitostí, ve kterých může program podle počasí běžet. Je nutné zadat alespoň jeden okamžik.
Den týdne pro danou příležitost ke spuštění.
Místní čas, kdy OSPy vyhodnotí a případně zahájí danou příležitost.
Relativní preference mezi okamžiky. Vyšší hodnota upřednostní daný okamžik, pokud lze zavlažování odložit.
Přidá další upřednostněný okamžik nebo odstraní vybraný řádek. Po smazání všech řádků nezůstane žádná příležitost ke spuštění.
Na tento program nebudou použity žádné úpravy (například zkrácení, nebo prodloužení doby)
Pokud by upravená doba běhu programu byla kratší než tato nastavená doba, tak se program přeskočí (například upravená doba běhu z rozšíření předpovědi počasí, nebo měsíční úprava množství vody a jiných rozšíření). Doba se nastavuje v procentech.
Všechny stanice, které mají nastavenou možnost „Aktivovat Master 1/2 programem“, aktivují hlavní stanici 1/2 podle tohoto přiřazení v programu. Oznámení! u stanic, které mají nastavenou možnost „Aktivovat hlavní 1/2 programem“, nelze použít možnost ovládání „spustit jednorázově“ a „ručně“. Spustí se pouze stanice, nikoli hlavní stanice (1 nebo 2)! Toto nastavení je k dispozici, pouze pokud používáte obě hlavní stanice!
Stránka "Jednorázový" představuje seznam povolených stanic s polem minuty a sekundy pro každou z nich. Tato stránka může být použita pro testování a poskytnutí dodatečného zavlažování jednorázově.
Tlačítko aktivuje všechny vybrané předvolené stanice.
Tlačítko odstraní veškeré přednastavené časy u všech stanic.
Na stránce "Rozšíření" můžeme nakonfigurovat nebo ovládat všechna rozšíření v systému OSPy.
Po kliknutí na tlačítko "Spravovat" se otevře okno správce rozšíření v systému OSPy. Všechna dostupná rozšíření lze zapínat, vypínat, instalovat z repozitáře atd...
Rozšíření používá soubor plugin.json s názvem, verzí, popisem, autorem, domovskou stránkou a licencí. Správce tato metadata zobrazí, pokud jsou dostupná. U již nainstalovaných starších rozšíření bez manifestu zůstává zachována zpětná kompatibilita a OSPy načte jejich název z __init__.py; pravidla pro novou instalaci jsou popsána níže.
Manifest může v seznamu dependencies deklarovat závislosti na jiných rozšířeních podle názvu jejich adresáře. Povinná závislost musí být nainstalovaná a povolená. Volitelná závislost rozšíření neblokuje, ale pokud jsou povolená obě rozšíření, OSPy nejprve spustí poskytovatele. Při vypínání se použije opačné pořadí a cyklické závislosti se nespustí. Při hromadné instalaci lze povinnou závislost dodat ve stejném ZIPu; samostatná instalace závislého rozšíření vyžaduje, aby již byl poskytovatel nainstalovaný.
Před zapnutím OSPy kontroluje deklarované verze OSPy a Pythonu, požadované Python moduly, podporovanou platformu, dostupnost GPIO/I²C a konflikty s již povolenými rozšířeními, GPIO piny nebo I²C adresami. Blokující problém zabrání zapnutí a volba zapnout vše takové rozšíření přeskočí. Správce a Diagnostika zobrazují podrobnosti i deklarovaná oprávnění k síti, souborům, I²C, GPIO, e-mailu, podprocesům nebo systému. Oprávnění jsou informací pro správce, nikoli izolovaným systémovým sandboxem.
Od OSPy 3.0.294 musí správce před prvním spuštěním nově nainstalovaného rozšíření výslovně schválit oprávnění uvedená v manifestu. Jednorázová migrace při aktualizaci automaticky zachová schválení všech již nainstalovaných rozšíření, včetně vypnutých, takže aktualizace OSPy nenaruší stávající instalaci. Stejný nebo menší rozsah oprávnění zůstává schválený; přidání oprávnění zastaví ruční i automatickou aktualizaci, dokud správce novou sadu nezkontroluje a neschválí. Odebrání schválení rozšíření současně vypne. Schválení se ukládá v OSPy jako rozhodnutí správce a záznam pro audit; nevytváří systémový sandbox.
Nová rozšíření mohou používat společnou správu vláken se stop signálem OSPy. Při vypnutí rozšíření OSPy nejprve odešle stop signál, zavolá jeho stávající funkci stop() a nejvýše pět sekund čeká na registrovaná vlákna. Vlákna, která se nezastaví, se zobrazí jako chyba v Diagnostice a brání spuštění druhé kopie rozšíření. Stávající rozšíření bez tohoto rozhraní zůstávají kompatibilní.
Před importem a spuštěním proběhne automatický statický test, který nespouští kód rozšíření ani nepřistupuje k hardwaru. Kontroluje adresář, __init__.py, syntaxi a velikost Python souborů, volitelný manifest a u rozšíření s manifestem přítomnost funkcí start() a stop(); starší rozšíření bez manifestu si zachovávají dosavadní kompatibilitu. Symbolické odkazy nenásleduje. Chyba zabrání aktivaci a podrobnosti jsou dostupné ve Správě rozšíření a Diagnostice. Ve Správě rozšíření jsou kompatibilita, manifest a výsledek testu zobrazeny v kontrastních stavových panelech, které jsou čitelné u zapnutých i vypnutých rozšíření.
Po kliknutí na tlačítko "Instalovat nové rozšíření" se otevře okno se vzdáleným repozitářem, kde si můžeme vybrat dostupná rozšíření pro instalaci do systému OSPy a přečíst si všeobecné informace k rozšířením.
OSPy před kopírováním souborů bezpečně načte plugin.json přímo ze staženého ZIP archivu a u každého rozšíření zobrazí stav kompatibility i konkrétní důvody případného problému. Nekompatibilní rozšíření nelze nainstalovat ani ručně aktualizovat. Rozšíření pouze s varováním lze po zobrazení varování nainstalovat. Hromadná instalace nainstaluje kompatibilní rozšíření a nekompatibilní přeskočí s uvedením důvodu. Stejná kontrola platí pro vlastní ZIP soubory, jednotlivé a hromadné operace i aktualizace. Chybějící, neplatný nebo příliš velký plugin.json je při nové instalaci chybou; již nainstalovaná starší rozšíření bez manifestu mohou nadále fungovat v režimu zpětné kompatibility.
Pokud může I2C rozšíření používat jednu z několika alternativních adres, kontrola kompatibility chápe deklaraci jako jeden volitelný prostředek, nikoli jako současné obsazení všech adres. Instalace z repozitáře i vlastního ZIPu je povolena, pokud zůstává dostupná odlišná adresa. Při aktivaci si rozšíření ponechá upřednostněnou adresu nebo vybere volnou alternativu. Jeho nastavení odmítne adresu, kterou již používá jiné aktivní rozšíření, zachová všechna předchozí nastavení a zobrazí konflikt v červeném stavovém pruhu bez opuštění stránky.
OSPy ověří celý ZIP dříve, než zapíše jediný soubor rozšíření. Archiv musí obsahovat alespoň jeden adresář rozšíření se souborem __init__.py a platným UTF-8 souborem plugin.json, jehož id odpovídá názvu adresáře. Rozšíření může dále obsahovat Python moduly, README.md a adresáře templates, static, script, docs, i18n a data. Repozitářový archiv může mít rozšíření v adresáři plugins/; vlastní archiv může obsahovat rozšíření přímo v kořeni.
Zakázány jsou absolutní cesty a cesty do nadřazeného adresáře, nepřenositelné názvy, duplicitní cesty nebo identifikátory rozšíření, symbolické odkazy, speciální či šifrované položky a poškozené archivy. Limity jsou 64 MiB stažených ZIP dat, 4 096 položek archivu, 256 rozšíření, 32 MiB na jeden rozbalený soubor, celkem 128 MiB rozbalených dat a kompresní poměr nejvýše 200:1. Instalace každého rozšíření je atomická: soubory se nejprve připraví, stávající adresář data se zachová a při chybě výměny nebo spuštění se obnoví předchozí verze.
Správce rozšíření umožňuje do systému OSPy nainstalovat i vlastní rozšíření, které není zveřejněné ve vzdáleném repozitáři (například vaše nějaké osobní rozšíření). Pomocí tlačítka "procházet" zvolíme požadovaný soubor v našem počítači k instalaci do systému OSPy. Soubor rozšíření (zip) musí obsahovat kompletní strukturu rozšíření (init, templates, i18n, readme atd).
Správce rozšíření používá ve výchozím stavu stabilní kanál master. Správce může přepnout na testovací kanál beta; zvolený kanál je viditelný ve správě i při instalaci a používá se pro seznam, ruční instalace, hromadné operace i automatické aktualizace. Testovací verze mohou obsahovat chyby. Přepnutí kanálu zahodí staženou cache předchozí větve a další kontrola načte data z nové větve. Po otevření stránky nainstalovaného rozšíření se nad jeho obsahem zobrazí název a verze načtená z plugin.json.
Stránka správce se otevře bez čekání na GitHub. Data repozitáře se načtou na pozadí a souhrn nahoře ukazuje průběh kontroly, chybu, stav „vše aktuální“ nebo počet a názvy dostupných aktualizací. Každý název aktualizace odkazuje přímo na dotčené rozšíření.
Kompatibilita, schválení oprávnění, manifest a test před spuštěním jsou u každého rozšíření sbalené v části Technické podrobnosti. Kontrola repozitáře se automaticky spustí jen tehdy, když ještě nejsou dostupná žádná data; běžné zapnutí nebo vypnutí rozšíření ji neopakuje. Schválit všechna oprávnění jedním potvrzením uloží aktuálně deklarovaná oprávnění všech nainstalovaných rozšíření. Aktualizovat vše po potvrzení zobrazeného zdroje aktualizuje pouze nainstalovaná rozšíření, pro která byla zjištěna nová verze.
Na výše uvedeném umístění se nachází repozitář s dostupnými rozšířeními pro systém OSPy.
Instalace nebo aktualizace rozšíření spouští kód z vybraného zdroje. OSPy před instalací nebo aktualizací zobrazí URL repozitáře a požádá o potvrzení. Akce Načíst změny během kontaktování vzdáleného repozitáře zobrazí zprávu o probíhající kontrole.
Tlačítko zakáže všechna nainstalovaná rozšíření.
Tlačítko povolí všechna nainstalovaná rozšíření.
Když je tlačítko aktivní, tak se automaticky po hodině kontroluje ve vzdáleném repozitáři dostupnost nové verze rozšíření. Při dostupnosti nové verze se u rozšíření zobrazí hláška "aktualizovat".
Tlačítko načte nejnovější seznam dostupných změn ze vzdáleného repozitáře rozšíření.
Tlačítko otevře přehled dostupných změn rozšíření a informací k aktualizacím.
Když je tlačítko aktivní, tak se při dostupnosti nové kompatibilní verze rozšíření automaticky provede aktualizace tohoto rozšíření. Nekompatibilní nová verze se automaticky nenainstaluje a správce zobrazí důvod. Upozornění: systém OSPy se neustále vyvíjí a pokud dojde k zásadní změně v systému OSPy a uživatel systém OSPy nebude aktualizovat, může dojít k tomu, že rozšíření po aktualizaci nebude pracovat. Vždy nejprve aktualizujte systém OSPy a následně všechna rozšíření!
Pomocí stránky "Záznam" můžeme zobrazit veškeré protokoly zaznamenané v systému OSPy. Počet záznamů se nastavuje na stránce "Nastavení".
Záznam událostí je provozní a auditní historie oddělená od záznamu běhu stanic i od technického debug logu. Zaznamenává zásahy do zavlažování a zablokované běhy, změny konfigurace, události uživatelů a zabezpečení, operace systému a rozšíření a události nebo stavy senzorů. Každý záznam obsahuje datum, čas, úroveň, kategorii, předmět a podrobnosti. Úroveň je rozlišena také barvou: informace modře, úspěch zeleně, varování oranžově, chyba červeně a kritická událost tmavě červeně. Pomocí seznamu Kategorie událostí lze zobrazit všechny události nebo jednu kategorii. Export events.csv obsahuje sloupce Date, Time, Level, Category, Subject a Status. Existující debug protokolování ani jeho soubor events.log nejsou těmito ovládacími prvky ovlivněny.
Do stejného auditního záznamu se ukládají také změnové operace provedené přes ověřené API, například ovládání stanic a programů, změny konfigurace, smazání záznamu a systémové operace. Neúspěšná autentizace API a dočasné zablokování při brute-force útoku se zobrazují v kategorii Uživatelé a zabezpečení. Běžné čtení z API ani každé úspěšné Basic ověření se nezaznamenává, aby častý API provoz nezaplnil záznam.
Odkaz "Stáhnout záznam jako Excel log.csv" umožní uložit do počítače záznam o běhu zavlažování jako soubor csv (program Excel).
- Struktura tabulky je: Date, Start Time, Zone, Duration, Program. Data jsou oddělena čárkou.
- Příklad: 2019-08-12 05:00:00 Filtrace 60:00 Filtrace
Odkaz "Stáhnout záznam jako Excel log email.csv." umožní uložit do počítače záznam o odeslaných emailech jako soubor csv (program Excel).
- Struktura tabulky je: Date, Time, Subject, Body, Status. Data jsou oddělena čárkou.
- Příklad: 2019-08-12 06:00:04 Odesláno CHATA SYSTÉM Ukončené zalévání-> Program: Filtrace , Stanice: Filtrace , Začátek: 2019-08-12 05:00:00 , Trvání: 60:00 , Water-> Množství vody v zásobníku: Level: 170 cm (90 %), Ping: 95 cm, Volume: 1.28 m3 , Temperature DS1-DS6-> SKLEP: 21.1 ℃ ČERPADLO: 33.5 ℃ BOJLER: 26.6 ℃ UVNITŘ: 22.1 ℃ STUDNA: 12.2 ℃
Po stisknutí tlačítka "Smazat záznam" dojde k vymazání všechn záznamů o běhu zavlažování. Akce je nevratná.
Po stisknutí tlačítka "Smazat záznam Email" dojde k vymazání všechn záznamů o odeslaných emailech ze systému. Akce je nevratná.
Na stránce "Nastavení" můžeme upravovat nastavení celého OSPy systému. Stránka obsahuje několik skládacích oddílů. Kliknutím na pruh otevřeme nebo zavřeme požadovanou část.
- Kliknutím na tlačítko "Zobrazit nápovědu" zobrazíme, nebo skryjeme informace o každé možnosti.
Pojmenování systému je užitečné při práci s několika OSPy systémy.
- Zadejte jedinečný popisný název systému.
- Klepnutím na tlačítko "Potvrdit změny" ve spodní části stránky uložte změny.
Název systému je ve výchozím stavu "OpenSprinkler Pi" a bude zobrazen v záhlaví každé stránky pro snadnou identifikaci systému.
Určuje vzhled GUI. V seznamu je k dispozici několik témat (zelený režim, černobílý režim...)
Volba 24-hodinový čas vybírá mezi mezinárodním formátem 24 hodin, někdy označovaným jako vojenský čas, a formátem 12 hodin-AM / PM.
- Zrušte zaškrtnutí políčka a vyberte 12 hodinový formát AM/PM.
- Klepnutím na tlačítko "Potvrdit změny" ve spodní části stránky uložte změny.
Budete přesměrováni na domovskou stránku a hodiny budou ve vybraném formátu.
IP adresa pro HTTP/S server. IPv4 nebo IPv6 adresa (projeví se až po restartu.) Výchozí je 0.0.0.0.
Číslo portu HTTP/S je součástí webové adresy. Port 80 je výchozí číslo pro webové stránky a jako takové nemusí být zahrnuto, když je adresa URL zadána do adresního řádku prohlížeče. Mnoho webových serverů standardně používá port 80. Pokud provozujete jiný server na stejném Raspberry Pi jako OSPy a používáte stejné číslo portu, dojde ke konfliktu a OSPy se nemusí spustit. Konfliktu se můžete vyhnout změnou čísla portu OSPy na stránce Možnosti na něco jiného například 8080. Pokud změníte číslo portu, které OSPy používá, budete muset zahrnout toto číslo, kterému předchází dvojtečka, do adresy URL pro webové rozhraní OSPy. Například: [URL Raspberry pi]: 8080
Číslo portu HTTP/S je součástí webové adresy. Port 80 je výchozí číslo pro webové stránky.
- Klikněte do textového pole vedle možnosti HTTP/ S port.
- Zadejte číslo portu, který chcete použít, např. 8080.
- Klikněte na tlačítko "Potvrdit změny" ve spodní části stránky.
Vrátíte se na domovskou stránku. Systém se restartuje, ale ve webovém rozhraní není viditelná indikace restartu. Počkejte alespoň 60 sekund, poté přidejte nové číslo portu do adresy URL Pi, před kterým je dvojtečka (:), a zkuste se znovu připojit k OSPy.
Pokud chceme na úvodní (domácí stránce) zobrazovat pod grafem naměřená data z rozšíření (vítr, teplota, hladina...) zaškrtneme políčko. V případě, že nechceme zobrazovat data z rozšíření zrušíme zaškrtnutí.
- Upozornění: aby se data zobrazovala v pořádku je nezbytné mít rozšíření povolené a správně nastavené.
Rozšíření může pomocí showOnTimeline přiřadit živou hodnotu ke konkrétní stanici. OSPy ji každé tři sekundy obnovuje vedle stavu právě běžící stanice, včetně hlavních stanic a ručního režimu. Po zastavení stanice nebo vyprázdnění hodnoty údaj zmizí; zobrazení nemění řízení výstupů ani plánování.
Pokud chceme na úvodní (domácí stránce) zobrazovat pod grafem naměřená data ze snímačů zaškrtneme políčko. V případě, že nechceme zobrazovat data ze snímačů zrušíme zaškrtnutí.
- Upozornění: aby se data zobrazovala v pořádku je nezbytné mít snímače povolené a správně nastavené.
Volbou jazyka můžeme změnit jazyk používaný ve webovém rozhraní.
- Klepnutím na šipku dolů napravo od pole jazyka zobrazíte seznam dostupných jazyků.
- Klikněte na jazyk, který chcete použít v rozhraní.
- Klikněte na tlačítko "Potvrdit změny" ve spodní části stránky.
Software se restartuje a po několika sekundách se rozhraní zobrazí ve zvoleném jazyce.
Zaškrtnutím tohoto políčka zobrazíte obrázky stanic na domovské stránce a na stránce stanic.
Sekce počasí poskytuje jednotná data pro OSPy i rozšíření, která podle předpovědi upravují zavlažování. Všichni odběratelé používají poskytovatele vybraného v Nastavení; nemusí se konfigurovat samostatně v každém rozšíření.
Povolí nebo zakáže načítání počasí od vybraného poskytovatele.
Open-Meteo – automatický model používá vhodný dostupný model bez API klíče. ČHMÚ ALADIN přes Open-Meteo vynutí model ALADIN pro území, kde je dostupný. Stormglass zachovává původní službu a vyžaduje vlastní API klíč. Open-Meteo je určen pro nekomerční použití podle podmínek služby a OSPy zobrazuje jeho zdroj u předpovědi.
Při aktualizaci starší instalace se uloženým Stormglass klíčem zůstane automaticky zvolen Stormglass. Instalace bez klíče přejde na Open-Meteo. Při dočasné chybě služby zůstávají zobrazená poslední platná data; OSPy se bez vědomí uživatele nepřepne k jinému poskytovateli.
Je nutný pouze při výběru poskytovatele Stormglass.
Název města nebo PSČ. Slouží k určení polohy pomocí OpenStreetMap pro vybraného poskytovatele počasí.
Tlačítkem Vybrat na mapě otevřete mapu vhodnou i pro dotykové ovládání, kliknete na přesný bod pro počasí a výběr potvrdíte. Použít polohu zařízení může po souhlasu uživatele umístit značku podle prohlížeče. Po uložení Nastavení jsou vybraná zeměpisná šířka a délka rozhodující polohou počasí; ruční změna textového pole Umístění přepne zpět na hledání názvu přes OpenStreetMap. Domovská stránka pod stavem souřadnic zobrazuje tři předpovědní karty pro aktuální čas, přibližně +3 a +6 hodin s místními ikonami, teplotou a srážkami. Podrobnosti uvádějí zdroj dat a čas poslední aktualizace.
Ikony předpovědi pokrývají všechny stavy počasí WMO, včetně mlhy, mrholení, mrznoucích srážek, dešťových a sněhových přeháněk, bouřek a krup. Jasno, převážně jasno a polojasno používají podle denní/noční hodnoty poskytovatele samostatnou variantu se sluncem nebo měsícem.
Pro zvýšení bezpečnosti doporučujeme změnit systémové heslo pro OSPy a uživatelské jméno z výchozího "admin". V případě potřeby můžete také požadavek na heslo deaktivovat.
- Klepnutím na trojúhelník nalevo od lišty s popiskem "Uživatelé" rozbalte sekci.
- Označte zaškrtnutím políčko "Bez hesla", pokud máte velmi dobrý důvod k deaktivaci ochrany heslem a jménem. Systém již nebude vyžadovat přihlášení uživatele. Bude umožnen přístup do všech sekcí.
- Zadejte Vaše uživatelské jméno.
- Zadejte Vaše aktuální heslo.
- Zadejte nové heslo do polí označených "Nové heslo" a "Potvrďte heslo".
- Klikněte na tlačítko "Potvrdit změny" ve spodní části stránky.
Vrátíte se na domovskou stránku. Vaše nové heslo s jméno bude vyžadováno při příštím přihlášení.
Pokud je zaškrtnuté políčko "Bez hesla" povolíme přístup do systému anonymním uživatelům bez hesla.
Do textového pole zadejte uživatelské jméno. To je při nové instalaci "admin".
Do textového pole zadejte aktuální heslo.
Zadejte nové heslo do pole označeného "Nové heslo".
Do pole označeného "Potvrďte heslo" zadejte stejné nové heslo jak v poli "Nové heslo".
Responzivní správa uživatelů zobrazuje vestavěného hlavního správce i všechny další účty včetně role, poznámky a stavu 2FA. Správce může další účet vytvořit, upravit, smazat nebo mu resetovat 2FA. Při úpravě existujícího uživatele není nutné měnit heslo; vyplněné nové heslo původní heslo nahradí a prázdné pole je zachová.
Vestavěný hlavní správce nadále používá původní nastavení 2FA OSPy. Každý další účet si může nezávisle nastavit TOTP nebo ověření e-mailem přes odkaz Zabezpečení účtu v záhlaví stránky. Starší účty zůstávají platné a po aktualizaci mají 2FA vypnuté. Párování, záložní kódy a nastavení 2FA patří konkrétnímu účtu; správce může ztracené 2FA jiného uživatele resetovat, ale neuvidí jeho tajný klíč ani záložní kódy.
Akce, které mění nastavení nebo stav systému, jsou ve webovém rozhraní chráněné tokenem formuláře. Pokud je stránka otevřená dlouho nebo vyprší relace v prohlížeči, načtěte stránku znovu a akci zopakujte.
V případě, že jsme nakonfigurovali server OSPy pro vyšší zabezpečení přenosu dat pomocí certifikátu SSL, zaškrtněte políčko "Použít HTTPS". Pokud je zaškrtnuta volba "Použít HTTPS" a server není správně nastaven, OSPy se spustí jako http server bez zabezpečení.
Serverová část je teď jednoznačná: vlastní certifikát má prioritu, jinak Let’s Encrypt; zapnutí obou voleb už nezpůsobí tiché HTTP.
Certifikát je umístěn v systému v adresáři '/etc/letsencrypt/live/' jméno domény '/fullchain.pem' a '/etc/letsencrypt/live/' jméno domény '/privkey.pem'. Certifikát je nutné pomocí nástroje "Certbot" nainstalovat do systému (Linux) ručně (použití https se projeví v OSPy až po restartu OSPy).
- Postup pro instalaci Certifikační služby nalezneme v souboru "Readme" nápovědy, nebo na Githubu.
SSL certifikát pomocí Let’s Encrypt certifikační autority. Certbot (https://certbot.eff.org/) a Let’s Encrypt (https://letsencrypt.org/).
sudo apt-get install certbotcertbot --versionsudo certbot certonly --standalone -d your_domain_namesudo certbot renewsudo cp /etc/letsencrypt/live/your.domain.com/fullchain.pem /home/pi/OSPy/sslsudo cp /etc/letsencrypt/live/your.domain.com/privkey.pem /home/pi/OSPy/sslsudo service ospy restartPokud je v nastavení OSPy vybrána možnost „Použít vlastní přístup HTTPS“, musíte do adresáře ssl v umístění OSPy vložit soubor: fullchain.pem a privkey.pem. Varování: OSPy musí být znovu restartováno.
sudo openssl req -new -newkey rsa:4096 -x509 -sha256 -days 3650 -nodes -out fullchain.pem -keyout privkey.pemDruhý způsob je pomocí tlačítka "generovat" v záložce SSL certifikát.
Tato volba nastavuje hlavičku Access-Control-Allow-Origin, kterou API používá pro klienty spuštěné v prohlížeči. Hodnota * povolí libovolný origin, lze zadat jeden origin například https://example.com, více originů oddělených čárkou, nebo ponechat pole prázdné a CORS hlavičky se nebudou posílat. Nenahrazuje to ověření API; pouze to určuje, které webové originy smí číst odpovědi API.
Tato volba povoluje starší parametr callback pro JSONP odpovědi API. Nechte ji vypnutou, pokud ji nevyžaduje stará integrace. Běžní API klienti mají používat JSON s CORS.
Přihlašovací stránka může zapamatovat prohlížeč pomocí dlouhodobého náhodného tokenu uloženého v zabezpečené cookie. OSPy ukládá pouze hash tohoto tokenu, nikoli heslo uživatele. Tlačítkem Zrušit odstraníte všechna zapamatovaná přihlášení v prohlížečích; dotčené prohlížeče se musí znovu přihlásit heslem.
Sekce snímače obsahuje nastavení pro zabezpečení snímačů.
Heslo pro nahrávání firmwaru z OSPy do snímače (pro všechny použité snímače - stejné heslo musí být použito i v nastavení snímače). Výchozí heslo je: "fg4s5b.s,trr7sw8sgyvrDfg".
Sekce "Nastavení stanic" obsahuje obecná nastavení, která ovlivňují plánování a kombinování stanic.
Určuje, jak se mohou běhy stanic překrývat. 0 znamená bez omezení využití, takže stanice mohou běžet současně, pokud se jejich programy časově překrývají. 1 znamená vždy jednu stanici najednou, pokud má každá stanice využití 1. Vyšší hodnota dovolí souběh více stanic, pokud jejich součet využití nepřekročí nastavený limit.
Toto nastavení také ovlivňuje, kdy se vloží pauza mezi stanicemi.
- Sekvenční režim se používá hlavně tehdy, když zdroj vody nezvládne napájet více větví najednou. Příklad: při Maximálním využití
1a využití stanice1musí stanice 3 skončit dříve, než může začít stanice 4. - Souběžný režim se používá tehdy, když zdroj vody zvládne více větví najednou. Příklad: při Maximálním využití
0mohou stanice 2, 3 a 4 běžet současně, pokud se jejich programy překrývají.
Celkový počet dostupných výstupů je 8 výstupů plus výstupy z rozšiřujících desek. Počet výstupů lze nastavit vyšší, než je skutečný počet fyzických výstupů, a tím vytvořit virtuální výstupy.
Pauza vložená mezi postupně spouštěné stanice, když je plánovač nemůže spustit současně, v sekundách mezi 0 a 3600. Toto neposouvá stanici vůči hlavní stanici.
Příklad: při Maximálním využití 1 a využití stanice 1 hodnota 30 spustí další stanici 30 sekund po skončení předchozí stanice.
Přeskočí pauzu mezi stanicemi, pokud byl předchozí běh kratší než tato hodnota, v sekundách mezi 0 a 86400.
Příklad: při pauze 30 a minimální době běhu 10 stanice, která běžela pouze 5 sekund, nevynutí 30sekundovou pauzu.
Sekce "Nastavení hl. stanice" vybírá hlavní stanici 1, hlavní stanici 2 a časové posuny používané při aktivaci hlavní stanice. Hlavní stanice je obvykle čerpadlo nebo hlavní ventil přívodu vody.
Hlavní stanice se použije pouze u stanic, které ji mají nastavenou na stránce Stanice, případně u programů, které vybírají hlavní stanici 1 nebo 2 pro stanice nastavené na „Aktivovat Master 1/2 programem“.
Výběr první hlavní stanice, například čerpadla nebo hlavního ventilu.
Výběr druhé hlavní stanice, například druhého čerpadla nebo jiného zdroje vody.
Pokud je zaškrtnuto, relé bude také aktivováno jako hlavní výstup.
Časový posun zapnutí hlavní stanice 1 vůči startu stanice, v sekundách mezi -1800 a +1800. Záporné hodnoty spustí hlavní stanici dříve, kladné hodnoty později.
Příklad: -10 spustí hlavní stanici 10 sekund před stanicí. +10 ji spustí 10 sekund po stanici.
Časový posun vypnutí hlavní stanice 1 vůči konci stanice, v sekundách mezi -1800 a +1800. Záporné hodnoty vypnou hlavní stanici dříve, kladné hodnoty ji nechají běžet déle.
Příklad: -5 vypne hlavní stanici 5 sekund před koncem stanice. +20 ji vypne 20 sekund po konci stanice.
Časový posun zapnutí hlavní stanice 2 vůči startu stanice. Funguje stejně jako posun startu hlavní stanice, ale jen pro hlavní stanici 2.
Časový posun vypnutí hlavní stanice 2 vůči konci stanice. Funguje stejně jako posun vypnutí hlavní stanice, ale jen pro hlavní stanici 2.
Nastaví typ spínače dešťového senzoru. Pokud používáte Raspberry Pi a chcete připojit senzor deště přímo k pinům GPIO, použijte piny 8 a 6 (gnd).
Zaškrtnutím políčka "Používat senzor" povolíme snímání deště.
Zaškrtněte políčko "V klidu rozpojen", pokud je senzor bez deště normálně rozpojený, jinak políčko zrušte. Informace o typu spínače najdete v uživatelské příručce dešťového senzoru.
Když je aktivován dešťový snímač, nastaví se zpoždění deště (to je vhodné například pro blokování programů na delší dobu, než poskytuje dešťový snímač).
Doba zpoždění deště (v hodinách), mezi 0 a 500.
Zapněte protokolování běhu a nastavte počet záznamů, které chcete zachovat. Zapněte protokolování odeslaných e-mailů a nastavte počet záznamů, které chcete uchovávat.
Zaškrtněte políčko "Aktivovat záznam". Tím se zapne protokolování a zapne se historie zavlažování na časové ose na domovské stránce. Zaznamenávat všechny běhy stanic - berte na vědomí, že opakující se psaní na SD kartu může zkrátit její životnost.
Zadejte počet záznamů, které chcete uložit do protokolu. Nastavte počet, který pokryje přiměřenou dobu, například týden nebo měsíc. To bude záviset na počtu programů a stanic, které máte. Při každém spuštění stanice bude existovat jeden záznam. 0 = bez omezení.
Zaškrtněte políčko "Aktivovat záznam E-mailů". Tím se zapne protokolování a povolí se historie zavlažování prostřednictvím E-mailu.
Zadejte počet záznamů, které chcete uložit do protokolu. Nastavte počet, který pokryje přiměřenou dobu, například týden nebo měsíc. To bude záviset na počtu programů a stanic, které máte. Pro každý E-mail bude existovat jeden záznam. 0 = bez omezení.
Povolit protokol událostí (dešťový senzor, zpoždění deště, server, internetová externí IP ...)
Počet záznamů událostí k uložení na disk, 0 = bez omezení.
Klepnutím na "Povolit ladění" uložíte veškeré interní operace v OSPy do souboru pro lepší ladění. * Poznámka: * příliš časté ukládání dat do souboru může po delší době poškodit SD kartu nebo snížit kapacitu SD karty (úložiště). Vypisují se veškeré operace (i ze všech rozšíření).
Sekce "Restart systému" obsahuje tlačítka pro restartování softwaru, pro restartování hardwaru, pro vypnutí hardwaru a vymazání všech nastavení na výchozí hodnoty.
Tlačítko "Restart OSPy" restartuje pouze software. Je to rychlý vynucený způsob, jak implementovat změny v softwaru.
Tlačítko "Restart HW" restartuje Raspberry Pi. To trvá déle, ale provede úplný restart systému.
Tlačítko "Vypnout" vypíná napájení Raspberry Pi hardwaru.
Tlačítko "Smazat nastavení" vymaže všechna uživatelská nastavení do výchozí čisté instalace OSPy.
- Veškerá nastavení se dají v OSPy smazat i ručně (v systému nalezneme složky ospy/data a ve složce smažeme všechny soubory).
Pokud chceme zálohovat všechna nastavení našeho OSPy zavlažovacího systému nebo přenést nastavení do jiného OSPy systému, použijeme tlačítko "Stáhnout" a následně "Nahrát".
Tlačítko "Stáhnout" se používá ke stažení konfiguračního souboru do počítače pro pozdější použití nebo k obnovení systému OSPy. Uloží se nejen soubor databáze (options.db), ale také složka stanic, kde jsou uloženy obrázky stanic. Současně se uloží soubor protokolu events.log (pokud existuje). Vše je uloženo v souboru zip (příklad: ospy_backup_systemname_4.12.2020_18-40-20.zip). Můžeme snadno identifikovat, ze kterého systému OSPy záloha pochází. Složka SSL, kde je certifikát, není z bezpečnostních důvodů uložena do záložního souboru zip!
Tlačítko Nahrát vám umožní vložit a obnovit systém OSPy (například při opětovné instalaci systému Linux). Nahraný soubor musí být soubor zip! Následující cesty a soubory musí být v souboru.
*.zip folder:
ospy-backup.json
ospy/data/default/options.db.*
ospy/data/backup/options.db.*
ospy/data/events.log
ospy/images/stations/station1.png
ospy/images/stations/station1_thumbnail.pngNebo jiné obrázky stanic ve stejném formátu.
Nové zálohy obsahují soubor ospy-backup.json, ve kterém je uveden formát zálohy, verze OSPy, čas vytvoření a velikost i kontrolní součet SHA-256 každého souboru. Archiv obsahuje databázi nastavení OSPy, data systémového záznamu a obrázky stanic. Soukromé klíče SSL, kód pluginů a mezipaměť Pythonu jsou záměrně vynechány; datové adresáře pluginů nadále zálohuje samostatný plugin OSPy package Backup. Před obnovou OSPy odmítne nebezpečné cesty v ZIPu, odkazy, šifrované nebo duplicitní položky, nadměrnou velikost či kompresi a každý soubor mimo ospy/data/ a ospy/images/stations/. Limit je 50 000 položek a 512 MB po rozbalení; soubor větší než 1 MB nesmí překročit kompresní poměr 200:1 a nastavený limit nahrávání může být nižší. Každý soubor se ověří podle manifestu a rozbalí do přípravného adresáře. OSPy potom automaticky vytvoří bezpečnostní zálohu stávajícího stavu, atomicky vymění data a restartuje se. Starší zálohy OSPy bez manifestu zůstávají podporované jako původní formát pouze s daty a procházejí stejnou kontrolou cest a velikosti ZIPu.
Formát zálohy 2 zapisuje hlavní úložiště nastavení, režim ukládání a schéma SQLite. Před archivací živých nastavení OSPy uloží čekající změny a zablokuje souběžné zápisy nastavení. Databázi SQLite zkopíruje transakčně pomocí SQLite Backup API a snímek nezávisle ověří kontrolou integrity, schématu, manifestu záznamů a kontrolních součtů hodnot. Obnova tuto logickou kontrolu po rozbalení zopakuje a odmítne snímek, jehož deklarovaný režim, schéma nebo počet nastavení nesouhlasí. Zálohy s manifestem formátu 1 i starší zálohy bez manifestu zůstávají obnovitelné. Aktivní webové relace se nezálohují ani neobnovují; po obnovení je nutné se znovu přihlásit. OSPy uchovává v zařízení deset nejnovějších bezpečnostních systémových záloh. Jejich seznam je v Možnostech, odkud lze vybraný archiv stáhnout a potom obnovit pomocí tlačítka Nahrát. Systémová záloha obsahuje přihlašovací a bezpečnostní nastavení, proto musí být stažené archivy bezpečně uložené.
Pokud máme svůj vlastní certifikát pro SSL (https) zabezpečení (fullchain.pem a privkey.pem) můžeme ho zde pomocí formuláře nahrát.
Pokud chceme vygenerovat SSL certifikát, stiskneme tlačítko "generovat". Do adresáře ssl se vygeneruje certifikát. Následně v nastavení/bezpečnost zaškrtneme možnost "vlastní HTTPS" a následně restartujeme OSPy.
Tlačítko "Nahrát" odešle do složky ssl v adresáři OSPy přiložené soubory (fullchain.pem a privkey.pem).
Na stránce "Stanice" nastavujeme nazvy stanic, vlastnosti okolo využívání množství vody, ovládání hlavních stanic.
Automatické číslování k označení stanic. Například 1 = stanice 1, 2 = stanice 2...
Uživatelské pojmenování stanic pro lepší identifikaci v systému, například "trávník".
Nastavení souběhu (0), nebo sekvence (>=1) pro určité stanice. Více o souběhu, nebo sekvenci v textu výše v sekci "Nastavení / O sekvenčních a souběžných režimech".
Množství vody za hodinu v mm, které rozpráší rozstřikovače na dané stanici. Používá se pro programy založené na počasí. Pro změření této hodnoty je vhodné si pořídit například plastový srážkoměr.
- Vztahuje se na čas potřebný k infiltraci daného množství vody do konkrétního typu půdy. Obecně je rychlost příjmu lehčí texturované (písčité) půdy vyšší než rychlost těžší texturované (jílovité) půdy. Zavlažování postřikovačů velkým množstvím vody však může vést k povrchovému odtoku i na písčitých půdách. Rychlost příjmu půdy pod zavlažováním je ovlivněna mnoha faktory, jako je struktura půdy, struktura půdy, zhutnění, organická hmota, stratifikované půdy, soli v půdě, kvalita vody, sedimenty ve zavlažovací vodě atd.
Množství vody, které může půda uložit nad úroveň 0. Používá se pro programy založené na počasí.
- Vztahuje se na množství půdní vlhkosti nebo obsahu vody zadržené v půdě po odtoku přebytečné vody a snížení rychlosti pohybu dolů. K tomu obvykle dochází 2–3 dny po dešti nebo zavlažování v předchozích půdách s jednotnou strukturou a strukturou.
Faktor používaný k násobení faktoru ETo pro programy založené na počasí. Použijte hodnotu vyšší než 1 v případě slunečné/suché půdy, použijte hodnotu nižší než 1 pro stín/vlhkou půdu.
- Typ půdy
Půdy mají různé vlastnosti, díky nimž jsou jedinečné. Znát druh půdy, kterou máte, vám pomůže určit její silné a slabé stránky. Zatímco půda se skládá z mnoha prvků, místo, kde začít, je s vaším typem půdy. Musíte pouze sledovat složení půdních částic. OSPy umožňuje uživatelům určit typ půdy pro každou zónu (stanici), což umožňuje přesnější a efektivnější výpočty zalévání. Různé typy půdy reagují odlišně na vodu; jílovité půdy mají sklon k odtoku, zatímco hlinité půdy mohou zadržovat vodu po dlouhou dobu atd. Množství vody obsažené v půdě po odtoku přebytečné vody a schopnost půdy zadržovat vodu se označuje jako kapacita pole (měřeno v palcích nebo milimetrech).
Jak najít přibližné proporce písku, bahna a jílu? Toto je jednoduchý test, který vám dá obecnou představu o podílech písku, bahna a jílu přítomného v půdě. Vložte 5 cm půdy do láhve a naplňte ji vodou. Vodu a půdu dobře promíchejte, odložte láhev a nedotýkejte se jí hodinu. Po hodině se voda vyčeří a uvidíte, že se větší částice usadily:
- Na hladině vody se mohou vznášet kousky organické hmoty
- Nahoře je vrstva hlíny. Pokud voda stále není čirá, je to proto, že některé z nejjemnějších jílů jsou stále smíchány s vodou
- Uprostřed je vrstva bahna
- Ve spodní části je vrstva písku
- Změřte hloubku písku, bahna a jílu a odhadněte jejich přibližný poměr.
Následující tři typy částic mohou tvořit vaši půdu: jíl, písek a bahno. Většina půd je kombinací těchto tří částic, ale typ částic, který dominuje, diktuje mnoho vlastností vaší půdy. Poměr těchto velikostí určuje typ půdy: jíl, hlína, jílovitá hlína, bahno-hlína atd.
- Ideální půda je 40% písku, 40% bahna a 20% jílu. Tato směs se označuje jako hlinitá. To bere to nejlepší z každého typu částic půdy. Má dobrou drenáž vody a umožňuje vzduchu proniknout do půdy jako písek, ale také dobře udržuje vlhkost a je úrodná jako bahno a hlína.
Zvýšení nebo snížení vodní bilance pro programy založené na počasí (pokud není nastaveno na 0).
Pokud máme stanici zapojenou (je fyzicky připojena) a chceme ji využívat (je vidět ve výběru v programech, na domovské stránce...), zaškrtneme "Připojeno". Pokud stanici nevyužíváme a nechceme zveřejnit v systému OSPy ponecháme "Připojeno" nezaškrtlé. Pokud je v systému použita některá stanice jako "hlavní stanice" nebo "2 hlavní stanice", tak ji v tabulce nelze zaškrtnout ani odškrtnout (deaktivovat). Hlavní stanice se přiřazuje v nastavení systému "Nastavení / nastavení hlavní stanice".
Pokud u některé stanice zaškrtneme "Ignorovat Déšť", tak se stanice aktivuje dle programu bez ohledu zda je nastaveno dešťové zpoždění, nebo zda dešťový senzor detekuje déšť. Tuto možnost využijeme například ve skleníku, do kterého neprší a potřebujeme zavlažovat pravidelně. nebo například ke spouštění filtrace bazénu, který také čistíme bez ohledu zda prší.
Nebude použita žádná hlavní stanice (pokud je určitá stanice aktivována, hlavní stanice nebude aktivována).
Pokud požadujeme, aby když se aktivuje určitá stanice se aktivovala i hlavní stanice (například čerpadlo, nebo hlavní ventil s vodou) vybereme položku "ZAP hlavní?".
Pokud požadujeme, aby když se aktivuje určitá stanice se aktivovala i druhá hlavní stanice (například druhé čerpadlo, nebo jiný zdroj vody) vybereme položku "ZAP hlavní 2?".
Pokud požadujeme aktivovat hlavní stanici nebo druhou hlavní stanici programem vybereme položku „ZAP hlavní 1/2 programem“. U programu je poté možné zvolit, která hlavní stanice se má pro tuto stanici použít (příklad: program 1 řídí stanice 1-4 a hlavní stanici 5. Program 2 řídí stanice 1-4 a druhou hlavní stanici 6).
Poznámky slouží pro obsluhu systému OSPy. Lze si například poznamenat: jaký typ el. ventilu, rozstřikovače atd. máme v systému použitý.
Po kliknutí na okénko se otevře stránka, na které je možné nahrát vlastní obrázek ke stanici.
Na stránce „Snímače“ můžeme přidávat nebo mazat snímače, které v systému OSPy plní různé funkce. V systému OSPy lze aktuálně používat snímače od výrobce pihrt.com a shelly.com.
Tlačítko „Přidat nový snímač“ přidá do systému nový snímač. Nastavení snímačů je uvedeno níže v části „Parametry snímačů“.
Pro snímače se používají dva druhy komunikace:
- Bezdrátová (radio) - ID rádio snímače
- Síťová (Wi-Fi/LAN) - MAC adresa, IP adresa Lze si vybrat z různých typů snímačů:
- Kontakt
- Detektor úniku
- Vlhkost
- Pohyb
- Teplota
- Multisnímač kontakt
- Multisnímač detektor úniku
- Multisnímač vlhkost
- Multisnímač pohyb
- Multisnímač teplota
- Multisnímač ultrazvuk
- Multisnímač vlhkost půdy
Aktivace nebo deaktivace tohoto snímače.
Zadejte název snímače. Názvy snímačů musí být nenulové a jedinečné.
Vyberte typ snímače.
- Otevřený program(y) Označte požadované programy, které chcete spustit.
- Nebo zastavit tyto spuštěné stanice v plánovači.
- Zavřený program(y) Označte požadované programy, které chcete spustit.
- Nebo zastavit tyto spuštěné stanice v plánovači.
- Citlivost (0-100%) Při překročení této úrovně se aktivuje(í) vysoký(é) program(y).
- Doba stabilizace (mm:ss) Po tuto nastavenou dobu nebude detektor reagovat na změnu.
- Nízký program(y) Označte požadované programy, které chcete spustit.
- Vysoký program(y) Označte požadované programy, které chcete spustit.
- Nízká úroveň (0-100%) Při překročení této úrovně se aktivuje(í) nízký(é) program(y).
- Nízký program(y) Označte požadované programy, které chcete spustit.
- Vysoká úroveň (0-100%) Při překročení této úrovně se aktivuje(í) vysoký(é) program(y).
- Vysoký program(y) Označte požadované programy, které chcete spustit.
- Program(y) Označte požadované programy, které chcete spustit.
- Nízká úroveň (0-100 °C/°F) Při překročení této úrovně se aktivuje(í) nízký(é) program(y).
- Nízký program(y) Označte požadované programy, které chcete spustit.
- Vysoká úroveň (0-100 °C/°F) Při překročení této úrovně se aktivuje(í) vysoký(é) program(y).
- Vysoký program(y) Označte požadované programy, které chcete spustit. U teploty se zobrazují stupňe Celsia, nebo stupně Fahrenheita podle toho, jak máme na titulní stránce (v pravo dole) nastavenou teplotu (kliknutím na teplotu lze změnit jednotky).
- Vzdálenost od ultrazvukového snímače (shora) k minimální hladině vody v nádrži.
- Vzdálenost od ultrazvukového snímače (shora) k maximální hladině vody v nádrži.
- Minimální hladina vody v nádrži (ode dna nádrže) pro report.
- Průměr válce pro výpočet objemu.
- Zobrazovat v litrech nebo m3.
- Zastavit stanice, pokud je minimální hladina vody.
- Doba zpoždění (hodiny).
- Zastavit stanice, pokud má ultrazvukový snímač poruchu.
- Zastavit tyto stanice v plánovači.
- Regulace maximální hladiny vody.
- Maximální udržovaná hladina vody.
- Maximální doba běhu v aktivaci.
- Minimální udržovaná hladina vody.
- Výstup pro regulaci.
- Sonda xx řídí program (zvolte v seznamu programů program, který chcete sondou 1-16 ovlivňovat).
- Kalibrace xx sondy pro 100% (zadejte úroveň napětí ve voltech pro kalibraci sondy při vlhkosti 100%).
- Kalibrace xx sondy pro 0% (zadejte úroveň napětí ve voltech pro kalibraci sondy při vlhkosti 0%).
Vyberte typ komunikace se snímačem.
Zadejte ID snímače pro váš rádiový snímač. ID snímače musí být nenulové a jedinečné.
- Zadejte MAC adresu snímače. Příklad: aa: bb: cc: dd: ee: ff
- Zadejte IP adresu snímače. Příklad: 192.168.88.10
Zadejte čas vzorkování v minutách a sekundách (mm:ss).
Povolit protokolování vzorků.
Povolit protokolování událostí.
Povolit odesílání E-mailů, když dojde k události. Pro tuto funkci je vyžadováno rozšíření e-mail notification!
Zde si můžeme dělat poznámky.
Tlačítko „Odstranit všechny snímače“ vymaže všechny přidané snímače v systému.
Snímače Shelly lze integrovat do OSPy pomocí rozšíření "shelly cloud integrator" ve kterém připojíme dostupná zařízení (buď přes cloud shelly.com, nebo v místní síti). Tato zařízení můžeme následně vyhledat v OSPy v části snímače/vyhledávání. V OSPy můžeme využívat měření například spotřeby, napětí, stavu výstupů atd...
Na stránce "Nápověda" nalezneme dokumentaci ke všem rozšířením, OSPy systému, změny v systému, přístup pomocí API, webové rozhraní. Plovoucí ikona PDF otevře tiskovou verzi právě zobrazeného článku bez navigace OSPy. V tiskovém dialogu prohlížeče lze článek uložit jako soubor PDF.
Hlavní dokumentace k OSPy, instalace systému, propojení desky, licence.
Změny v systému OSPy, nebo v rozšířeních
Interně všechny programy udržují plán, který lze přímo upravit (stejně jako vlastní program).
Pro snadnější manipulaci byly vytvořeny následující typy programů.
Každý program může být jedním z těchto typů. Nakonec lze každý program napsat také jako vlastní program.
Prog/type_data | 0 | 1 | 2 | 3 | 4 | 5 --:|:-- |:-- |:-- |:-- |:-- | DAYS_SIMPLE |start_time |duration |repeat pause |repeat times |list days to run| REPEAT_SIMPLE |start_time |duration |repeat pause |repeat times |repeat days |start_date DAYS_ADVANCED |list of intervals [start, end]|list days to run| | | | REPEAT_ADVANCED |list of intervals [start, end]|repeat days | | | | WEEKLY_ADVANCED |list of intervals [start, end]| | | | | CUSTOM |list of intervals [start, end]| | | | | WEEKLY_WEATHER | | | | | |
set_days_simple start_min, duration_min, pause_min, repeat_times, [days] set_repeat_simple start_min, duration_min, pause_min, repeat_times, repeat_days, start_date set_days_advanced [schedule], [days] set_repeat_advanced [schedule], repeat_days, start_date set_weekly_advanced [schedule] set_weekly_weather irrigation_min, irrigation_max, run_max, pause_min, pems
Nápověda k webovému rozhraní v češtině.
Nápověda k webovému rozhraní v angličtině.
Nápověda k webovému rozhraní v němčině.
Nápověda k webovému rozhraní v polštině.
Nápověda k webovému rozhraní v ruštině.
Nápověda k webovému rozhraní v srbštině.
Nápověda k webovému rozhraní ve slovenštině.
Pro moderní webové prohlížeče se doporučuje, aby rozhraní API bylo postaveno na principu CRUD pomocí formátu JSON jako formátu datových kontejnerů.
Mapování metod HTTP/s.
Aktuální základní struktura rozšíření je následující:
plugins/
└── plugin_name/
├── data/
├── docs/
├── static/
├── script/
├── templates/
├── __init__.py
├── plugin.json
└── README.md
Uvedené adresáře a soubor README.md jsou volitelné. Nová nebo aktualizovaná rozšíření distribuovaná k instalaci musí obsahovat __init__.py a platný UTF-8 soubor plugin.json, jehož id odpovídá názvu adresáře. Již nainstalovaná starší rozšíření bez manifestu zůstávají podporována v režimu zpětné kompatibility.
Statické soubory jsou dostupné pod /plugins/plugin_name/static/.... Soubory skriptů jsou dostupné pod /plugins/plugin_name/script/...; stránka rozšíření může načíst vlastní JavaScript pro volání API OSPy a úpravu zobrazení. Všechny soubory *.md v adresáři docs se zobrazují v Nápovědě. Soubor README.md, pokud existuje, je první položkou Nápovědy a může být použit také jako popis rozšíření.
- Usage Statistics (anonymní statistiky o používání OSPy systému)
- LCD Display (LCD displej 16x2 znaků připojený pomocí I2C sběrnice)
- Pressure Monitor (hlídání tlaku v potrubí - ochrana čerpadla)
- Voice Notification (zvuková upozornění - přehrávání souborů mp3)
- Pulse Output Test (test výstupů - slouží k nalezení určitého ventilu v zemi)
- Button Control (ovládání systému OSPy pomocí 8 tlačítek - slouží pro ruční spouštění programů)
- CLI Control (vzdálené ovládání periferií pomocí URL příkazů - například RF zásuvky)
- System Watchdog (hlídací pes systému Raspberry Pi, pokud systém zamrzne, dojde k restartu systému)
- Voltage and Temperature Monitor (měření napětí a teploty pomocí I2C sběrnice)
- Remote Notifications (odesílání dat na vzdálený server pomocí PHP)
- System Information (systémové informace OSPy a systém Linux)
- Air Temperature and Humidity Monitor (měření teploty 6x DS18B20 a vlhkosti DHT11 pomocí I2C sběrnice)
- Wind Speed Monitor (měření rychlosti větru pomocí I2C sběrnice)
- Weather-based Rain Delay (dešťové zpoždění založené na předpovědi počasí)
- Relay Test (testuje relé pro hlavní čerpadlo)
- UPS Monitor (hlídá výpadek napájení systému, odesílá email a ukončuje Linux systém)
- Water Consumption Counter (virtuální měřič průtoku vody založený na výpočtu běhu hlavní stanice)
- SMS Modem (vzdálené ovládání pomocí SMS a USB modemu)
- Signaling Examples (příklad notifikací tupu "signal" v systému OSPy)
- E-mail Notifications (odesílání E-mailů ze systému - toto rozšíření využívají i některá jiná rozšíření, například: Wind Speed Monitor, Pressure Monitor, Air Temperature and Humidity Monitor...)
- Remote FTP Control (zjednodušené vzdálené ovládání OSPy pomocí serveru s PHP a FTP)
- System Update (pomocí tohoto rozšíření lze jednoduše aktualizovat systém OSPy z GIThubu namísto systémových příkazů)
- Water Meter (měření průtoku pomocí vodoměru s pulsním výstupem pomocí I2C sběrnice)
Water Meter v1.1.1 měří nepřetržitě v sekundových intervalech a samostatný přehled obnovuje každou sekundu. Přehled zobrazuje aktuální l/s, odpovídající l/min, spotřebu v aktuální minutě a hodině, celkovou spotřebu a graf průtoku. Nastavení řídí lokální JSON a volitelné SQL logování, zobrazovaný zdroj, interval v sekundách, vynechání nulového průtoku a maximální počet záznamů, kde 0 znamená bez omezení. Volitelná hodnota na Home zobrazuje
aktuální l/s (aktuální l/min)a mobilní API v1 poskytuje živé karty a omezenou historii z vybraného zdroje. Čítač se čte přímo z registrů PCF8583 0x01–0x03; chyba inicializace nebo měření zavře sběrnici, automaticky opakuje inicializaci a zobrazí chybu v přehledu. - Elektroměr Elektroměr v1.0.1 sleduje libovolný počet třífázových elektroměrů Shelly Pro 3EM a Shelly 3EM-63T Gen3. Výchozí a doporučené připojení čte zařízení přímo v místní síti podle IP adresy nebo DNS názvu bez cloudu a internetu; alternativně lze použít data z běžícího a nastaveného rozšíření Shelly Cloud Integration. Každý elektroměr má roli přípojka sítě, výroba FVE, samostatná spotřeba nebo pomocné měření a lze obrátit směr. Přehled odděluje odběr a dodávku do sítě, zobrazuje L1–L3 a součet, dnešek, včerejšek, měsíc a rok, náklady, příjem za přetoky, historii, grafy a CSV. Při současném měření sítě a FVE vypočítá spotřebu domu, vlastní spotřebu, energetickou soběstačnost a úsporu; samotnou dodávku do sítě nikdy nevydává za výrobu. Atomicky uložené čítače navazují po restartu OSPy a bezpečně rozpoznají reset nebo výměnu elektroměru. Ceny a časové tarify se zapisují do každého intervalu, historie může být v lokálním JSON, SQL přes Database Connector nebo v obou úložištích a data jsou dostupná na Home, v diagnostice a v mobilním API.
- Webcam Monitor (pořizuje fotografie z USB webkamery)
- Weather-based Water Level Netatmo (nastavení množství vody pro zavlažování z meteostanice Netatmo)
- Direct 16 Relay Outputs (pomocí tohoto rozšíření můžeme ovládat 16 relé (stanic) připojených přímo k Raspberry Pi, ovšem některá ostatní rozšíření nebudou dostupná)
- MQTT (hlášení stavu OSPy pomocí MQTT protokolu, ovládání stanic přes MQTT...)
- System Debug Information (informace o dění v systému OSPy, pokud máme v nastavení povolen debug "Povolit ladění", tak zde v rozšíření se zobrazuje uložený záznam)
- Weather-based Water Level (nastavení množství vody pro zavlažování založený na předpovědi počasí)
- Real Time and NTP time (rozšíření, které nastavuje systémový čas - Linux a HW RTC čas z NTP serveru, HW RTC používá I2C sběrnici)
- Water Tank (měření hladiny vody pomocí ultrazvuku - například ve studni pomocí I2C sběrnice)
- Monthly Water Level (nastavení množství vody pro jednotlivé měsíce)
- Pressurizer (tlakování čerpadla před spuštěním programů)
- Ping monitor (měření výpadků sítě)
- Temperature Switch (regulátor teploty, který umožnuje 3 nezávislé zóny)
- Pool Heating (regulace teploty bazénu dle solárního ohřevu)
- E-mail reader (ovládání OSPy pomocí E-mailových zpráv)
- Weather Stations (zobrazení hodnot z ostatních rozšíření ve stylu ručičkových budíků) verze 1.0
- Telegram Bot (komunikace s OSPy pomocí telegram.org app)
- Door Opening (otevření zámku dveří, nebo posuvné brány)
- Voice Station (zvuková upozornění na základě události stanic- přehrávání souborů wav a mp3)
- Ovládání žaluzií (toto rozšíření odesílá přes REST API příklazy do Wi-Fi relátek firmy Shelly, nebo podobných relé)
- Monitor rychlosti Internetového připojení (odezva, stahování, nahrávání)
- E-mail Notifications SSL (odesílání E-mailů ze systému - toto rozšíření využívají i některá jiná rozšíření, například: Wind Speed Monitor, Pressure Monitor, Air Temperature and Humidity Monitor...) Toto rozšíření je modernější variantou původního rozšíření E-mailová oznámení (Připojení přes vrstvu SSL).
- Sunrise and Sunset (výpočet astronomických dat jako je východ a západ slunce. Dle těchto výpočtů umožňuje následně spouštět programy).
- FVE bojler (nahřívání bojleru z distribuční sítě, nebo FVE elektrárny).
- IP kamery (umožňuje sledování z IP kamer. Jako JPEG náhled, nebo GIF obrázek, nebo MJPEG stream z kamery).
- CHMI (umožňuje z meteoradaru ČHMI načítat aktuální počasí a dle něho nastavovat časové spoždění. Zároveň zobrazovat RGB stav počasí na HW mapě).
- Proto (výchozí plugin pro tvorbu dalších nových pluginů. Plugin nic závratného nedělá, ale vysvětluje jak pracuje).
- Label Maker (vytváření EAN a QR kódů).
- IP Scanner (hledání IP a MAC v síti).
- Database Connector (propojení do databáze pro ukládání dat z čidel a senzorů).
- OSPy Backup (zálohování adresáře data ze všech rozšíření do souborů zip).
- MQTT Home Assistant (integrace do HASS pomocí MQTT).
- Shelly Cloud Integration (načítání stavů z cloudu výrobce zařízení Shelly).
- Current Loop Tanks Mmonitor (měření hladiny ze 4 snímačů).
- Network Ping Monitor (monitoring dostupnosti 3 zařízení v síti).
- Weather Dashboard (zobrazení hodnot z ostatních rozšíření ve stylu ručičkových budíků) verze 2.0
- Termostat
Po kliknutí na tlačítko "Odhlásit se" se uživatel odhlásí ze systému.
OSPy repository · Releases · Plug-ins · Issues · Discussions