Dies ist eine alte Version des Dokuments!
Inhaltsverzeichnis
Licht
Neue Dokumentation
Wichtig: Bitte beachtet die Dokumentation auf https://github.com/shackspace/standby.shack/wiki.
Diese Seite wird von mir nicht mehr weiter gepflegt!
UDP
UDP IDs ohne offset(Lounge)
6 | 7 | 8 | 9 | |
10 | ||||
4 | 5 | LAGER | ||
0 | 1 | 2 | 3 |
offset für die UDP-Pakete: 20
hauptschalter: Adresse: 0x0a bzw. 10 als Dezimal States: 0 ⇒ AUS 1 ⇒ EIN 2 ⇒ Aus in T-5Sekunden
versenden von UDP-Paketen
Nach Möglichkeit sollte zwar die API genutzt werden, wenn aber doch UDP Pakete versendet werden müssen, so ist hier Dokumentiert, wie die Pakete aussehen.
Es müssen 4 Byte über UPB an 'licht.shack:1337' versendet werden:
Byte 1: 0xA5
Byte 2: 0x5A
Byte 3: UDP-ID
Byte 4: state
RESTful API
Version: 1
IDs ohne offset(Lounge)
/==0=== | ==1===\ | /==4=== | ==5===\ | /==8=== | ==9===\ | # |
||
\==2=== | ==3===/ | \==6=== | ==7===/ | \==10== | ==11==/ | # |
||
# |
||||||||
<12> | [==13==] | #==14== |
||||||
# |
||||||||
[==15== | ==16==] | [==17== | ==18==] | L A G E R | # |
|||
# |
||||||||
/==19== | ==20==\ | /==21== | ==22==\ | # |
||||
\==23== | ==24==/ | \==25== | ==26==/ | # |
==X==
: Leuchtstoffröhre oder LED-Ersatz
<X>
: Runde Sparbirne
#
: Gebiet außerhalb der Lounge
offset für die API bei der Lounge: 100
Syntax
Zur Zeit liefert die API nur JSON aus, XML wird in der nächsten Zeit ergänzt.
Statusabfrage:
GET auf http://standby.shack:8080/<version>/light/<id> für einzel Abfrage
GET auf http://standby.shack:8080/<version>/light für alle Zustände
Status ändern:
PUT auf http://standby.shack:8080/<version>/light oder http://standby.shack:8080/<version>/light/5000 um auf alle Zustände zu triggern (Zur Zeit außerbetrieb)
PUT auf http://standby.shack:8080/<version>/light/<id> um einen einzigen Zustand zu ändern
Syntax PUT-Request:
zum ändern des Aktuellen Zustandes: {„type“: „toggle“}
zum Einschalten: {„type“: „switchOn“} oder {„type“: „set“, „state“: 1}
zum Einschalten: {„type“: „switchOff“} oder {„type“: „set“, „state“: 0}
Man beachte bitte, das man einen normalen double quote/normales doppelte Anführungszeichen schreiben muss(kann das dokuwiki leider nicht darstellen).