Webservices

Různé příkazy webové služby lze použít k získání informací z Miniserveru, provedení nastavení nebo přepínání výstupů, například prostřednictvím adresního řádku prohlížeče. Podrobnější informace o rozhraní API

VŠEOBECNÉ

Příkazy webové služby jsou podporovány pro interní i externí přístup. Současný Miniserver podporuje také HTTPS. Struktura příkazu webové služby je následující:

http://Uživatel:Heslo@IPAdresaMiniserveru/příkaz/ovládání/hodnota

Při použití protokolu HTTP jsou přístupové údaje v adrese URL přenášeny v prostém textu!
Při použití protokolu HTTP (Miniserver Gen.1) je proto třeba při zadávání příkazu do adresního řádku přístupové údaje prozatím vynechat. Přístupové údaje jsou pak vyžádány prostřednictvím okna v prohlížeči:

Některé příkazy vyžadují přístupové údaje uživatele s plným přístupem. Poté se příkaz provede a výsledek se zobrazí v prohlížeči. V následujícím příkladu získáme aktuální verzi softwaru miniserveru:

Komunikace (API) s webovými službami Loxone

Loxone umožňuje ovládání a konfiguraci přes jednoduché webové příkazy.

Jednoduchá komunikace

Prostřednictvím Miniserveru a jeho webových služeb lze pomocí http příkazů odesílat informace, provádět nastavení, … Pro komunikaci s Miniserverem se používá technika Restful-webservices.

Obecně

Struktura webových služeb

(Použita technika Restful-webservices)

http://Uzivatel:Heslo@AdresaMiniserveru/prikaz/control/hodnota

  • „control“: může se jednat o jakýkoliv vstup a nebo výstup (také virtuální). Výstupy mohou být použity pouze k vrácení stavu (pouze dotaz na stav).
  • „hodnota“: Pokud „hodnota“ neexistuje, bude zpět nastavena hodnota „control“. Přijatelné jsou následující hodnoty: ‚Ein‘, ‚On‘, ‚Aus‘, ‚Off‘, ‚Impuls‘, ‚Pulse‘ a nebo desetinné hodnoty (za desetinnou čárkou)
  • Pro digitální vstupy se dvěma výstupy (od verze 1.5.4.16) jsou možné následující hodnoty:
ImpulsPlus
ImpulsMinus
PulseUp
PulseDown
ImpulsAuf
ImpulsAb
PulseOpen
PulseClose
PlusEin
PlusAus
UpOn
UpOff
AufEin
AufAus
OpenOn
OpenOff
MinusEin
MinusAus
DownOn
DownOff
AbEin
AbAus
CloseOff
CloseOff
  • U digitálních vstupů a výstupů se používá pro ‚On‘ vždy 1 a pro ‚Off‘ vždy 0.
  • Analogové vstupy (0-10V) se pracuje v rozsahu 0-10,00. Neexistuje žádný formální limit (například i EIB teplotního senzoru 21,5 nebo -5,2)
  • Pro výstupy se používá desetinná tečka místo desetinné čárky.

Stavy a přepínání

Dotaz na stav

Příkaz http://miniserver/dev/sps/io/SvetlaKuchyne/state
Funkce Vrátí status vstupu
Odezva <LL control=“dev/sps/io/SvetlaKuchyne“ value=“0“ Code=“200“/>
Příkaz http://miniserver/dev/sps/io/SvetlaKuchyne/astate
Funkce Vrací hodnoty přiřazených výstupů (buď jednoznačnou hodnotu pro všechny a nebo různé hodnoty)
Odezva <LL control=“dev/sps/io/SvetlaKuchyne“ value=“1“ Code=“200“/>
Příkaz http://miniserver/dev/sps/io/SvetlaKuchyne/all
Funkce Vrací počet přiřazených výstupů a seznam jejich hodnot
Odezva <LL control=“dev/sps/io/SvetlaKuchyne/all“ value=“8″ Code=“200″ n1=“Aktor (Relais) Q1″ u1=“68347a0e-3bfc-11df-85f6ea34eeb9b08a“ v1=“0″ n2=“Aktor (Relais) Q2″ u2=“68347a0e-3bfc-11df-85f6ea34eeb9b08a“ v2=“0″ n3=“Aktor (Relais) Q3″ u3=“68347a0e-3bfc-11df-85f6ea34eeb9b08a“ v3=“0″ n4=“Aktor (Relais) Q4″ u4=“68347a0e-3bfc-11df-85f6ea34eeb9b08a“ v4=“0″ n5=“Aktor (Relais) Q5″ u5=“68347a0e-3bfc-11df-85f6ea34eeb9b08a“ v5=“0″ n6=“Aktor (Relais) Q6″ u6=“68347a0e-3bfc-11df-85f6ea34eeb9b08a“ v6=“1″ n7=“Aktor (Relais) Q7″ u7=“68347a0e-3bfc-11df-85f6ea34eeb9b08a“ v7=“0″ n8=“Aktor (Relais) Q8″ u8=“68347a0e-3bfc-11df-85f6ea34eeb9b08a“ v8=“0″/>
Příkaz http://miniserver/data/status
Funkce Zobrazí seznam a stav všech zařízení, připojených k Miniserveru
Odezva <Status Modified=““>
<Miniserver Name=“Miniserver kancelář“ Internalname=““ IP=““ Mask=““ Gateway=““ DHCP=““ DNS1=““ DNS2=““ MAC=““ Device=““ Version=““>
<Extension Name=““ Internalname=““ Serial=““ Version=““ Online=““/>
</Miniserver>
</Status>

Poznámka: Dotaz na stav přes webové služby je možný pouze se vstupy / výstupy a nikoliv s funkčními bloky.

Přepnutí

Příkaz http://miniserver/dev/sps/io/VypinacSvetlaKuchyne/Ein
Funkce Zapne analogový nebo digitální vstup
Odezva <LL control=“dev/sps/io/VypinacSvetlaKuchyne“ value=“1“ Code=“200“/>

Dotaz na všechny změny výstupu

Příkaz http://miniserver/dev/sps/enablestatusupdate
Funkce Umožňuje automatické odesílání stavových změn ve WebSockets®.
Odezva Odešle aktuální stav přes WebSockety®.

Nastavení a statistika

SPS PŘÍKAZY

Příkaz Funkce
http://miniserver/dev/sps/state PLC dotaz na stav 0 – žádný stav

1 – PLC startuje
2 – PLC program je načten
3 – PLC se spustí
4 – spuštění sběrnice
5 – PLC běží
6 – PLC změna
7 – PLC chyba
8 – v současné době se provádí aktualizace

http://miniserver/dev/sps/status Dotaz na aktuální frekvenci PLC
http://miniserver/dev/sps/restart PLC restart
http://miniserver/dev/sps/stop PLC stop
http://miniserver/dev/sps/run PLC spuštění
http://miniserver/dev/sps/log PLC povolit globální statistiku
http://miniserver/dev/sps/nolog PLC vypnout globální statistiku
http://miniserver/dev/sps/enumdev Seznam všech PLC zařízení Minisever, Extensions,…)
http://miniserver/dev/sps/enumin Seznam všech PLC vstupů
http://miniserver/dev/sps/enumout Seznam všech PLC výstupů
http://miniserver/dev/sps/identify Od verze 1.5.6.7: Miniserver musí být identifikován
U rozšíření musí být sériové číslo jako paramter.

KONFIGURAČNÍ PŘÍKAZY

Příkaz Funkce
http://miniserver/dev/cfg/mac Získat MAC adresu
http://miniserver/dev/cfg/version Získat verzi firmware
http://miniserver/dev/cfg/versiondate Získat datum firmware
http://miniserver/dev/cfg/dhcp Načtení konfigurace DHCP
http://miniserver/dev/cfg/ip Získat IP adresu
http://miniserver/dev/cfg/mask Získat masku sítě
http://miniserver/dev/cfg/gateway Získat bránu
http://miniserver/dev/cfg/device Získat názvy zařízení
http://miniserver/dev/cfg/dns1 Získat adresu 1. DNS
http://miniserver/dev/cfg/dns2 Získat adresu 2. DNS
http://miniserver/dev/cfg/ntp Získat adresu NTP
http://miniserver/dev/cfg/timezoneoffset Načtení posunu časové zóny
http://miniserver/dev/cfg/http Získat HTTP port
http://miniserver/dev/cfg/ftp Získat FTP port
http://miniserver/dev/cfg/LoxPLAN Získat LoxPLAN port
http://miniserver/dev/cfg/ftllocalonly Načtení „FTP, Telnet, pouze přístup pro lokální software“

SYSTÉMOVÉ PŘÍKAZY

Příkaz Funkce
http://miniserver/dev/lan/txp Načte počet přenesených paketů
http://miniserver/dev/lan/txe Načte počet přenesených chybových paketů
http://miniserver/dev/lan/txc Načte počet přenesených paketů s kolizí
http://miniserver/dev/lan/exh Načte počet chyb přetečené v zásobníku (buffer) při přenášení
http://miniserver/dev/lan/txu Načte počet LAN chyb podjetí
http://miniserver/dev/lan/rxp Načte počet přijatých LAN paketů
http://miniserver/dev/lan/eof Načte počet EOF LAN chyb
http://miniserver/dev/lan/rxo Načte počet chyb – přeplnění LAN
http://miniserver/dev/lan/nob Načte počet LAN „No recieve Buffer“ chyb
http://miniserver/dev/bus/packetssent Načte počet paketů poslaných na Loxone sběrnici
http://miniserver/dev/bus/packetsreceived Načte počet paketů přijatých na Loxone sběrnici
http://miniserver/dev/bus/receiveerrors Načte počet chyb přijatých na Loxone sběrnici
http://miniserver/dev/bus/frameerrors Načte počet „frame“ chyb na Loxone sběrnici
http://miniserver/dev/bus/overruns Načte počet „overflow“ chyb na Loxone sběrnici
http://miniserver/dev/bus/parityerrors Načte počet počet paritních chyb na sběrnici Loxone sběrnici
http://miniserver/dev/sys/numtasks Načte počet úkolů
http://miniserver/dev/sys/cpu Načte zatížení procesoru
http://miniserver/dev/sys/contextswitches Načte počet přepnutí mezi úkoly
http://miniserver/dev/sys/contextswitchesi Načte počet přepnutí mezi úkoly, které byly přerušeny
http://miniserver/dev/sys/heap Načte velikost paměti
http://miniserver/dev/sys/ints Načte počet přerušení systému
http://miniserver/dev/sys/comints Načte počet přerušení komunikace
http://miniserver/dev/sys/lanints Načte počet přerušení LAN
http://miniserver/dev/sys/watchdog Načte „watchdog“ bitů
http://miniserver/dev/sys/date Vrátí datum
http://miniserver/dev/sys/time Vrátí čas
http://miniserver/dev/sys/setdatetime Nastaví systémové datum a časový formát: 2010-04-20 14:35:00 nebo 2010/20/04 14:35:00
http://miniserver/dev/sys/spscycle Načte počet SPS cyklů
http://miniserver/dev/sys/ntp Vynutí NTP požadavek
http://miniserver/dev/task0/name Načte úkol pojmenovaný 0
(0- http://loxlive/dev/sys/numtasks – 1)
http://miniserver/dev/task0/priority Načte prioritu úkolu 0
http://miniserver/dev/task0/stack Načte „stack“ úkolu 0
http://miniserver/dev/task0/contextswitches Načte počet přepínání úkolů 0
http://miniserver/dev/task0/waittimeout Načte čekací dobu úkolu v ms
http://miniserver/dev/task0/state Načte stav úkolu 0
http://miniserver/dev/sys/reboot LoxLIVE bootování
http://miniserver/dev/sys/check Zobrazí aktivní připojení Loxone Config
http://miniserver/dev/sys/logoff Přeruší stávající Loxone Config připojení
http://miniserver/dev/sys/sdtest Testování SD karty
http://miniserver/dev/sys/lastcpu Ukazuje poslední hodnotu využití procesoru a počet PLC cyklů
http://miniserver/dev/sys/search Provede se hledání připojených Extensionů
http://miniserver/dev/sys/searchdata Seznam výsledků hledání
http://miniserver/dev/fslist/ Zobrazí list kořenového adresáře na SD kartě
http://miniserver/dev/fslist/path/ Zobrazí se list adresářové cesty na SD kartě
http://miniserver/dev/fsget/filepath/ Načíst soubr (cesta k souboru k nahrazení)
http://miniserver/dev/fsdel/filepath/ Odstraní soubor (podle cesty souboru)
http://miniserver/data/status Zobrazuje stav Miniserveru a všech Extensionů
http://miniserver/stats Stav statistiky
http://miniserver/data/weatheru.xml Zobrazuje údaje o počasí
http://miniserver/data/LoxAPP3.json Struktura souboru pro vizualizaci
http://miniserver/dev/fsget/log/def.log Slouží k získání informací v souboru def.log
http://miniserver/dev/sys/ExtStatistics/05000001 Získat statistiky z 1-Wire Extension (05000001 vyměňte za aktuální sériové číslo)
http://miniserver/dev/sys/AirStatistics/0C000001/DeviceIndex Získat statistiky z Air Base Extension (0C000001 vyměňte za aktuální sériové číslo)
http://miniserver/dev/sys/updatetext Začne aktualizace Extension

Příkazy pro jednotky

Následující příkazy se týkají konkrétních jednotek Air nebo Tree. Jsou vyžadovány přístupové údaje uživatele s plným přístupem.

http://miniserver/dev/sys/wsdevice/serial/ForceUpdate Vynucení aktualizace firmwaru jednotky
http://miniserver/dev/sys/wsdevice/serial/Reboot Restartování jednotky
Pro „serial“ se použije sériové číslo (bez dvojteček) zařízení. Název zařízení v Loxone Config lze však použít i zde. Musí být jedinečný a nesmí obsahovat žádné speciální znaky.

POUŽITÍ WEBOVÉHO ROZHRANÍ V RÁMCI IFRAME

Chcete-li používat webové rozhraní Miniserveru v iFrame, musí být povoleno pomocí následující webové služby, protože iframe není ve výchozím nastavení povolen pro zvýšení bezpečnosti.

http://miniserver/dev/sys/allowhttpiframe/1