LaborTageBadge2011: Unterschied zwischen den Versionen
Marcus (Diskussion | Beiträge) (repository moved) |
Keine Bearbeitungszusammenfassung |
||
Zeile 1: | Zeile 1: | ||
{{ProjektInfoBox | {{ProjektInfoBox | ||
|name = | |name = Labortage Badge 2011 | ||
|status = Stable | |status = Stable | ||
|image = Badge2011TopRender.jpg | |image = Badge2011TopRender.jpg |
Version vom 7. April 2017, 22:52 Uhr
Labortage Badge 2011 Release status: Stable [box doku] | |
---|---|
![]() | |
Description | Badge der Labortage 2011 |
Author(s) | Suschman, bg |
Last Version | 1.0 |
Platform | AVR (ATtiny45) |
License | GPL |
Download | GIT |
„Stable“ befindet sich nicht in der Liste (experimental, beta, stable, obsolete, unknown) zulässiger Werte für das Attribut „Pr status“.
About
Das "Ticket" der Labortage 2011 ist dieses mal kein Ram-Riegel, sondern eine echte Platine mit Funktion!
Genießt das Logo der Labortage auf der einen Seite, und bestückt euch euren eigenen RGB-LED Controller mit USB auf der anderen.
Second Run
Auf der Seite LaborTageBadge2011/SecondRun können sich alle eintragen, die Interesse haben Bauteile zu bestellen, um ihr Badge noch zu vervollständigen.
Funktion
Der AVR kommuniziert mit dem PC über USB mit Hilfe der vUSB library. Darüber kann man dann mittels eines commandline Programms die LED steuern, sowie den Taster abfragen und den Temperatursensor des AVR auslesen.
Grundsätzlich kann man die Firmware auf dem Badge als black box betrachten und sich am commandline tool austoben :).
Dies auch, weil der der AVR über USB aufgrund der Funktionsweise seiner selfprogram-Funktion nicht (ohne Klimmzüge) über USB programmierbar ist und der vorgesehene serielle one-pin Bootloader nicht fertig wurde...
Schaltung
Platine
Die Platine ist zweilagig mit Lötstoplack, Bestückungsdruck und HAL-Zinn. Auf der einen Seite befindet sich die Schaltung, auf der anderen das Logo der Labortage. Die Platine wurde mit freundlicher Unterstützung von Basista Leiterplatten gefertigt.
Stückliste
Name | Part | Reichelt |
C1 | SMD 0603 100nF | X7R-G0603 100N |
R1 | SMD 0603 1,8 kOhm | SMD-0603 1,8K |
R2-R6 | SMD 0603 68 Ohm | SMD-0603 68 |
AVR | ATtiny45 SO8 | ATTINY 45-20SU |
D1,D2 | MiniMelf 1N4148 | 1N 4148 SMD |
USB | MiniUSB Buchse SMD | USB BWM SMD |
SW | Kurzhubtaster SMD | TASTER 9314 |
LED | OSRAM MultiLED PLCC-4 | LATB T66C |
http://www.reichelt.de/?ACTION=20;AWKID=514176;PROVID=2084
Aufbau
Der Aufbau erfordert durch die relativ dichte Bestückung in SMD und mit 0603 Bauteilen etwas Erfahrung im Löten von SMD. Wenn ihr es euch nicht zutraut, sucht euch einen Bastler der für etwas Mate Hand anlegt ;).
Bestückt wird von den niedrigen zu den hohen Bauteilen. Also zuerst C1, R1 und R2 bis R6 verlöten. Dann die beiden Dioden D1 und D2, dabei auf die Polarität achten. Nun die LED, deren abgeschrägte Kante auf Pad1 richtung Aussenkante-Stitleiste zeigt. Der AVR hat einen Punkt zur Markierung der mit dem Bestückungsdruck übereinstimmen muss. Zum Schluss kommen der Taster und die Mini USB Buchse. Diese deren Masseanschlüsse festbraten, und dann vorsichtig mit minimal Lötzinn die eigentlichen Pins verlöten. Die Stiftleiste wird nicht bestückt, ausser ihr last die LED weg und möchtet eine andere abgesetzt anschliessen, z.B den Diodermod.
Arbeitet sorgfältig und macht immer mal wieder eine Sichtprüfung auf Kurzschlüsse und schlechte Lötstellen.
Software
Der AVR ist im Bauteilesatz der Labortage vorprogrammiert, das Binary für den PC muss unter Linux noch mit libusb übersetzt werden. Für Windows kann es prinzipiell auch übersetzt werden, dies ist aber nicht getestet.
Bauen für Linux
Debian/Ubuntu wird angenommen:
sudo aptitude install build-essential git libusb-dev git clone http://www.das-labor.org/usergit/labortage2011badge/ cd ./labortage2011badge/commandline make
./badge-tool usage: ./badge-tool [<option>] <command> <parameter string> where <option> is one of the following: -p --pad[=<pad value>] ............................ pad writing data with <pad value> (default 0) to specified length -f --file <name> .................................. use file <name> for reading or writing data --i-am-sure ....................................... do not ask safety question -l --loop <value> ................................. execute action <value> times <command> is one of the following -s --set-rgb <red>:<green>:<blue> ................. set color -g --get-rgb ...................................... read color from device and print -j --fade-rgb <rd>:<gd>:<bd>:<cnt> ................ change color by <rd>, <rg> and<cnt> times (all 8ms) -r --read-mem <addr>:<length> ..................... read RAM -w --write-mem <addr>:<length>[:data] ............. write RAM -z --read-flash <addr>:<length> ................... read flash -q --reset[=<delay>] .............................. reset the controller with delay in range 0..9 -b --read-button .................................. read status of button -k --wait-for-button[=(on|off)] ................... wait for button press (default: on) -t --read-temperature ............................. read temperature sensor and output raw value Please note: If you use optional parameters you have to use two different ways to specify the parameter, depending on if you use short or long options. Short options: You have to put the parameter directly behind the option letter. Exp: -koff Long options: You have to seperate the option from the parameter with '='. Exp: --pad=0xAA
Wenn die LED zu dunkel ist: der Parameter für -s ist 16 Bit Dezimal, also bis 65535.
Wenn noch jemand einen Bausatz hat und keinen programmierten Prozessor, der melde sich bei Suschman, ich schicke ihn dann zu.
Funktionen
Helligkeitswerte sind 16-Bit lang, d.h. maximale Helligkeit entspricht 65535 oder 0xffff. Bei sehr niedrigen Werten, kann es jedoch sein, dass das Tastverhältnis so ungünstig ist, dass ein Flackern wahrgenommen werden kann.
Set Color
-s --set-rgb <red>:<green>:<blue>
Setzt die Farbe auf die RGB-Werte <red>:<green>:<blue>
Fade
-j --fade-rgb <rd>:<gd>:<bd>:<cnt>
Das Badge kann selbstständig linear (ohne Gammakorrektur) faden. Die ersten drei Parameter geben den Wert an, um den die Farbe alle 8ms (wirklich 8ms?) geändert wird. Der vierte Parameter gibt an wie viele Zyklen gemacht werden, bis das Faden aufhört. Gefadet werden kann in beide Richtungen, um den Farbwert zu verringern muss die 16-Bit 2-er-Komplement Darstellung angegeben werden (also 0xffff für -1 0xfffe für -2 ... 0x8000 für -32768).
Berechtigungen
Wenn sich das Programm nur als root nutzen lässt, kann dass an einer fehlenden udev-rule liegen. Abhilfe kann eine Regel wie die folgende schaffen:
BUS=="usb",OWNER="root",GROUP="dialout"
In der Datei /etc/udev/rules.d/20-usb.rules . Euer user sollte dann natürlich in der Gruppe dialout sein. Ihr könnt natürlich auch eine beliebige andere Gruppe oder Eigentümer wählen.
Zu beachten ist, dass bei dem obigen Beispiel ALLE USB Geräte unter dem Zugriff der entsprechenden Gruppe und Eigentümer steht. Alternativ kann per
SUBSYSTEM=="usb", ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="05df", GROUP="user"
nur der Zugriff auf das Labor-Badge der Gruppe erlaubt werden. Ach ja, und wer will, kann die Zeile mit einem freundlichen
RUN+="...../labortage2011badge/commandline/badge-tool -s 65535:32535:0"
beenden (... mit dem korrekten Pfad ersetzen) und kann damit die initiale Farbe des badges steuern.
Beispielcode
Blink
Kleines farbliches Blinktool als Bash script.
#!/bin/bash cd ./labortage2011badge/commandline echo Das Labor echo BLINKEN FOO while true; do { ./badge-tool -s 30000:00000:00000 ./badge-tool -s 00000:30000:00000 ./badge-tool -s 00000:00000:30000 ./badge-tool -s 30000:30000:00000 ./badge-tool -s 00000:30000:30000 ./badge-tool -s 30000:00000:30000 ./badge-tool -s 30000:00000:30000 ./badge-tool -s 30000:30000:00000 ./badge-tool -s 00000:30000:30000 ./badge-tool -s 30000:00000:00000 ./badge-tool -s 00000:30000:00000 ./badge-tool -s 00000:00000:30000 } done
CPU Load
One-liner der die cpu load im system anzeigt (c muss auf die anzahl cpus angepasst werden):
./badge-tool -s 0:0:0;\ (while true; do cat /proc/loadavg; sleep 1; done)|\ awk 'BEGIN{m=0x07fff; c=2}{print "./badge-tool", "-s", int($1 * m) ":" 0 ":" int((c - $1) * m); fflush() }'|\ sh
NET Load
One-liner der die netzwerk load im system anzeigt:
(while true; do cat /proc/net/dev; sleep 1; done)|awk 'BEGIN{m=0x0ffff;c=0}/eth0/{d1=($2-c1)/10; d2=($10-c2)/10; if (d1>m) d1=m; if (d2>m) d2=m; print "./badge-tool", "-s", int(d1) ":" int(d2) ":" int(0); fflush(); c1=$2; c2=$10; }' | sh