/* Anwendungen */
[stratum0-wiki.git] / S0light.mw
index d364a3e..8e24dfa 100644 (file)
@@ -1,5 +1,5 @@
 {{Projekt|verantwortlich=Pecca, [[Benutzer:chrissi^|Chrissi^]]|status=aktiv|beschreibung=So light, much blink!|bild=S0light-h.jpg
-|bildbeschreibung=Stratum 0 light "H" in seiner natürlichen Umgebung (bei Dunkelheit)|interessenten=|source=|lizenz=|download=[http://svn.tinyhost.de/svn/s0light/ SVN]|version=}}
+|bildbeschreibung=Stratum 0 light "H" in seiner natürlichen Umgebung (bei Dunkelheit)|interessenten=|source=|lizenz=|download=[https://gitli.stratum0.org/chrissi/s0-light Sourcen]|version=}}
 Dieses Projekt möchte awesome Blink-Boards bauen!
 
 == H ==
@@ -45,10 +45,12 @@ Es bietet sich an die Platine in den folgenen Schritten zu bestücken:
 * Zuletzt folgt nun die Spannungsversorgung. Hierzu dienen die Näh-Augen, Lötflächen und Durchkontaktierungen im oberen Teil.
 {{Todo|Abbildung der Spannungsversorgungs-Möglichkeiten}}
 
-=== Spannungsversorgung ===
-Das H ist mit einer Spannung zwischen 3V und 5,5V zufrieden. Damit kann es sowohl mit einer CR2032, einem alten Handy-Akku oder einem USB-Anschluss versorgt werden. Egal welche Quelle genutzt wird: Umbedingt auf richtige Polarität achten. Andernfalls kann das H oder auch die Quelle beschädigt werden.
+==== Spannungsversorgung ====
+Das H ist mit einer Spannung zwischen 3V und 5,5V zufrieden. Damit kann es sowohl mit einer CR2032, einem alten Handy-Akku oder einem USB-Anschluss versorgt werden. Egal welche Quelle genutzt wird: Unbedingt auf richtige Polarität achten. Andernfalls kann das H oder auch die Quelle beschädigt werden.
 
-Das H benötigt je nach Spannung und Anzahl der LEDs unterschiedlich viel Strom. Mit nur einer LED an 3V wird die Stromaufnahme unter 3mA liegen. Mit allen LEDs an an 5V rund 100mA verbrauchen.
+Das H benötigt je nach Spannung und Anzahl der LEDs unterschiedlich viel Strom. Mit nur einer LED an 3V wird die Stromaufnahme unter 3mA liegen. Mit allen LEDs an 5V werden rund 100mA verbraucht.
+
+Durch Drücken des Tasters auf der Rückseite wird das H in den StandBy versetzt. Hierbei werden alle LEDs ausgeschaltet, und der Controller in den tiefsten Schlafmodus versetzt. So ausgeschaltet benötigt das H nur noch wenige µA. Selbst mit einer Knopfzelle sollte es so ''sehr lange''™ halten.
 
 ==== Flashen ====
 Der Controller ist bereits geflasht. Diese Anleitung ist also nur relevant, wenn das H mit einer anderen Software versorgt werden soll.
@@ -61,7 +63,7 @@ Zunächst werden die Fuses gesetzt, sodass der Controller mit 8MHz internem Takt
  avrdude -v -B 64 -p m328p -P /dev/ttyUSB0 -c stk500v2 -U lfuse:w:0xe2:m -U hfuse:w:0xd9:m -U efuse:w:0xfe:m
 
 
-Anschließend kann ein Hex-File aus dem Repository geflasht werden; z.b. [http://svn.tinyhost.de/svn/s0light/SW/tags/S0light_h%20V1/workspace/S0light/Release/S0light.hex dieses]:
+Anschließend kann ein Hex-File aus dem Repository geflasht werden; z.b. [http://svn.tinyhost.de/svn/s0light/SW/tags/S0light_h%20V2/workspace/s0light/Release/s0light.hex dieses]:
  Mit einem usbasp:
  avrdude -p m328p -P usb -c usbasp -U flash:w:s0light.hex
 
@@ -70,39 +72,94 @@ Anschließend kann ein Hex-File aus dem Repository geflasht werden; z.b. [http:/
 
 Direkt nach de Flash-Vorgang sollte das H mit einer Animation beginnen.
 
-=== Aufbau und Inbetriebnahme: HW V1===
-Das H mit der HW-Version 1 wird noch ohne geflashten Controller ausgeliefert. Für die Inbetriebnahme wird somit noch ein Atmel ISP-Programmer (z.B. ein USBASP) benötigt. Mindestens einer davon befindet sich meist irgendwo im Frickelraum. 
+=== Eigene Animationen für das H ===
+Möchte man eigene Animationen hinzufügen, muss man eine eigene Software compilieren. 
+{{TODO|Eine Anleitung finden, die erklärt, wie man das unter z.B. Win und Linux macht}}
+Als Grundlage kann die aktuelle Software aus [http://svn.tinyhost.de/svn/s0light/SW/tags/ dem Repository] verwendet werden. In der ''main.c'' findet sich das Feld 
+ const uint8_t PROGMEM frames[][NUM_LEDS+1] {...};
+In diesem Feld werden die einzelnen Frames der Animation definiert. Ein Frame besteht dabei aus einer Dauer, gefolgt von den Helligkeiten der 20 LEDs. Eine Dauer von 1 entspricht dabei ca 8ms. Helligkeiten können zwischen 0 (aus) und 7 (maximal hell) eingestellt werden. Eine einfache Animation sieht dann so aus:
+ const uint8_t PROGMEM frames[][NUM_LEDS+1] {
+ {10, 7, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 7, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 7, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 7, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 7, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 7, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 7 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,7 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,7 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,7 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 7, 0, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 7, 0, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 7, 0, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 7, 0, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 7, 0, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 7, 0, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 7, 0, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 7, 0, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 7, 0},
+ {10, 0, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 7},
+ {10, 255, 0, 0, 0, 0, 0, 0 ,0 ,0 ,0 , 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}
+ }
+Diese Animation lässt eine einzelne, helle LED ein Mal um das Herz laufen. Die letzte Zeile (mit der LED-Helligkeit von 255) zeigt das Ende der Liste an und muss entsprechend immer am Ende stehen.
+
+=== Historie: HW V1===
+Das H mit der HW-Version 1 entspricht im Wesentlichen der Version 3. Die Software ist auch kompatibel. Falls Du noch eine HW1 hast, folge der Anleitung zur HW3.
+
+
+== F ==
+Das S0light F soll ein leuchtender Pfeil für den Einsatz am Whiteboard werden. Der Eyecatcher, um endlich zeigen zu können, wo in den wirren Aufzeichnen denn nun die wichtige Erkenntnis steht.
+[[Datei:S0light F erster Entwurf.jpg|thumb|Erster Entwurf des S0light F.]]
+
+'''Schwierigkeit:''' ++ (SMD 0603) 
+
+=== Versionen ===
+Es gibt vom S0light F folgende Versionen:
+* HW01: Ohne Beschriftung auf der Unterseite, je nach Batteriehalter verdeckt die Platine ihn nicht ganz. Diese HW ist kompatibel mit: S0light H HW01 und HW03
 
-==== Löten ====
-Für das Löten wird ein temperaturgeregelter Lötkolben mit feiner Spitze (<1mm) benötigt. Ausserdem bietet sich ''feines'' Lötzinn mit hohem Flussmittelanteil an.
-{{Todo|Heraussuchen eines guten Youtube SMD-Löt Lehrgangs.}} 
 
-Es bietet sich an die Platine in den folgenen Schritten zu bestücken:
-* Löten der LEDs: Die LEDs werden auf die Vorderseite gelötet. Die LEDs sind dabei im SOT23-Gehäuse und können somit nicht verpolt werden.
-* Löten des Controllers: Als nächstes sollte der Controller gelötet werden. Der Controller ist dann richtig ausgerichtet, wenn die Pin1-Markierung in Richtung Herzseite des (noch nicht bestückten) Tasters zeigt.
-* Anschließend werden die restlichen SMD-Bauteile auf der Unterseite gelötet. Um es einfach zu halten sollte der Taster zuletzt gelötet werden.
-* Zuletzt wird der ISP-Anschluss eingelötet. Der Schlitz muss Richtung Controller zeigen.
+=== Stückliste ===
+Für HW01:
 
-==== Flashen ====
-Der Controller muss anschließend mit einem Programmer geflasht werden. Z.B. via Software AVRdude.
+    1x Leiterplatte (df-robot.com)
+    1x Controller ATMEGA328P-AU
+    20x LEDs SOT23, z.B. rot
+    21x Widerstand 1k 0603
+    1x Taster
+    2x Kondensator 100nF 0603
+    1x 6-Pol Wanne
+    1x Batteriehalter CR2032
 
-Zunächst werden die Fuses gesetzt, sodass der Controller mit 8MHz internem Takt, ohne Vorteiler und ohne Watchdog läuft. Eventuelle Fehler im E-Fuse können ignoriert werden.
- Mit einem usbasp:
- avrdude -p m328p -P usb -c usbasp -U lfuse:w:0xe2:m -U hfuse:w:0xd9:m -U efuse:w:0xfe:m
 
- Mit einem Atmel STK500V2:
- avrdude -v -B 64 -p m328p -P /dev/ttyUSB0 -c stk500v2 -U lfuse:w:0xe2:m -U hfuse:w:0xd9:m -U efuse:w:0xfe:m
+=== Aufbau und Inbetriebnahme ===
+Diese Anleitung gilt für das S0light F HW01.
+==== Löten ====
+* Für das S0light F gelten im Wesentlichen die gleichen Hinweise, wie für das S0light H.
+[[Datei:S0light f V1 back.png|thumb|S0light f, Rückseite mit Foto gegenübergestellt.]]
+[[Datei:S0light F V1 Vorderseite.jpg|thumb|S0light F Vorderseite]]
 
-Anschließend kann ein Hex-File aus dem Repository geflasht werden; z.b. [http://svn.tinyhost.de/svn/s0light/SW/tags/S0light_h%20V1/workspace/S0light/Release/S0light.hex dieses]:
- Mit einem usbasp:
- avrdude -p m328p -P usb -c usbasp -U flash:w:s0light.hex
 
- Mit einem Atmel STK500V2
- # avrdude -v -B 1 -p m328p -P /dev/ttyUSB0 -c stk500v2 -U flash:w:s0light.hex
+* Ich empfehle folgende Reihenfolge bei der Bestückung:
+# Controller Atmega32P-AU: Pin 1 befindet sich, wenn der Pfeil vom Körper weg zeigt oben links. Siehe dazu die Abbildung der Rückseite
+# Kondensatoren am Controller: Die beiden Kondensatoren sind in der Abbildung der Rückseite mit "C" gekennzeichnet.
+# Alle Widerstände auf der Rückseite: Alle weiteren SMDs auf der Rückseite sind nun Widerstände.
+# LEDs auf der Vorderseite
+# Taster auf der Vorderseite
+# 3x2-Pin Stiftleiste
+# Batteriehalter / Batterie (optional, nächsten Abschnitt beachten)
 
-Direkt nach de Flash-Vorgang sollte das H mit einer Animation beginnen.
+==== Spannungsversorgung ====
+[[Datei:S0light CR2032.png|thumb|CR2032 Batteriehalter und Polarität]]
+Das F kann mit einer Spannung zwischen 3V und 5,5V betrieben werden. Damit kann es sowohl mit einer CR2032, einem alten Handy-Akku oder einem USB-Anschluss versorgt werden. Für die CR2032 liegt ein Batteriehalter bei. Egal welche Quelle genutzt wird: Unbedingt auf richtige Polarität achten. Andernfalls kann das H oder auch die Spannungsquelle beschädigt werden.
+
+Die Polarität der Anschlüsse des Batteriehalters kann an der Abbildung abgelesen werden. Beim Einlöten ist darauf zu achten, den Halter so zu Löten, dass die Polarität zu der in der Abbildung der Platine passt. Soll eine andere Spannungsquelle verwendet werden, so muss natürlich genau so auf die Polarität geachtet werden.
+
+Das F benötigt je nach Spannung und Anzahl der LEDs unterschiedlich viel Strom. Mit nur einer LED an 3V wird die Stromaufnahme unter 3mA liegen. Mit allen LEDs an 5V werden rund 100mA verbraucht.
 
+Durch Drücken des Tasters auf der Rückseite wird das F in den StandBy versetzt. Hierbei werden alle LEDs ausgeschaltet, und der Controller in den tiefsten Schlafmodus versetzt. So ausgeschaltet benötigt das F nur noch wenige µA. Selbst mit einer Knopfzelle sollte es so ''sehr lange''™ halten.
 
 
+=== Flashen ===
+Für das F gelten die gleichen Hinweise, [[S0light#F wie für das H]].
 
 [[Kategorie:Projekte]]
This page took 0.031864 seconds and 4 git commands to generate.