Editing Blinkencontrol

{{Project
|name=Blinkencontrol
|description=generischer Blinkenlightfoo
|project category=Hardware
|location=Laptop Lounge
|image=blinkencontrol hardware.jpg
|status=beta
|people={{U|derf}}
|source=https://github.com/derf/dorfmap{{!}}github
}}

[[File:Blinkencontrol.png|Schaltplan für RGB|200x200px|framed|right]]

Eine Instanz hängt in der [[Laptop Lounge]] und steuert den RGB-Streifen im Schaufenster. Angeschlossen per GPIO an {{H|donationprint}}, Ansteuerung wie gewohnt per [http://dorfmap/blinkencontrol/lounge_rggb dorfmap] (siehe [[Lichtsteuerung]]).

== Protokoll ==

Die Firmware führt beliebige Animationen aus, wobei eine Animation aus bis zu 24 Schritten aus Farbe und Fadedauer besteht. Nach einer Übertragung wird die Animation immer vom ersten bis zum letzten übertragenen Schritt ausgeführt.

Eine Animation mit nur einem Schritt entspricht Dauerleuchten, über die Fadedauer kann aber eingestellt werden, wie schnell der Übergang von der aktuellen Farbe dauert.

Animationen können immer nur schrittweise übertragen werden, da sie beim letzten übertragenen Enden, sollte der letzte Schritt auch zuletzt gesendet werden.

Das Datenformat ist <tt>slot delay red green blue addrhi addrlo</tt>, wobei <tt>slot</tt> der Animationsschritt (0 .. 23) ist.
Beispiel für rotes Pulsieren (wechselnd an/aus):<tt>0 64 255 0 0 0 1</tt>, <tt>1 64 0 0 0 0 1</tt>.

<tt>red</tt>, <tt>green</tt> und <tt>blue</tt> sind PWM-Level von 0 (aus) bis 255 (maximale Helligkeit). Beachten: Es findet derzeit keine Helligkeitsanpassung statt, d.h. es wird linear gefadet, während das menschliche Auge Helligkeit [http://www.mikrocontroller.net/articles/LED-Fading logarithmisch wahrnimmt].

== netcat-API ==

Obiges Protokoll (teils in Variationen) kann zur Ansteuerung diverser Geräte benutzt wrden. Die erste Zeile wählt das Blinkendevice aus (z.B. "blinkencontrol1" oder "charwrite1"), alle weiteren gehen an das jeweilige Programm. Nach den Daten muss teilweise noch die 16bit-Adresse übertragen werden, erst high byte, dann low byte. Der Daemon lauscht auf <tt>donationprint:25465</tt>.

Diese netcat-API wird bald abgeschaltet und durch eine API in der [[Lichtsteuerung]] (dorfmap) ersetzt.

=== charwrite1 ===

Nimmt vier Zeichen (ASCII, 0-9a-zA-Z) an und überträgt sie bei einer Newline. Zum Beispiel:

<source lang="bash">
echo "charwrite1\nohai" | nc donationprint 25465
</source>