X-Git-Url: https://git.rohieb.name/stratum0-wiki.git/blobdiff_plain/e68d4b1ad109d2d2cb127a05a10d9327dc7260f4..974f7f4182a8f8a5f17afe4219bf72d81f3cdff5:/S0light.mw?ds=inline

diff --git a/S0light.mw b/S0light.mw
index b4ad6e79c..8e24dfacd 100644
--- a/S0light.mw
+++ b/S0light.mw
@@ -1,31 +1,165 @@
 {{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 ==
+[[Datei:S0light h V1 back.jpg|thumb|Stratum 0 light "H" back]]
+[[Datei:S0light h V1 top.jpg|thumb|Stratum 0 light "H" front]]
 Blinkendes Herz <3. Natürlich mit roter Platine. Und roten LEDs.
 * ATMEGA328P
 * 20 LEDs
 * Taster
 * < (50 x 50) mm²
-
 Schwierigkeit: ++ (SMD 0603)
-[[Datei:S0light h V1 back.jpg|thumb|Stratum 0 light "H" back]]
-[[Datei:S0light h V1 top.jpg|thumb|Stratum 0 light "H" front]]
 
+Es gibt vom ''H'' zwei Hardware-Versionen. Beide Versionen sind Software-Kompatibel und sehen fast gleich aus.
+* HW V1: Hat noch keine Aufhänge-Schlaufen. Spannungsversorgung ist nur über den Programmier-Anschluss vorgesehen. Das Board hat keine Beschriftungen auf der Rückseite.
+* HW V2: (Diese Version wurde nicht gefertigt)
+* HW V3: Das Board hat Aufhänge-Schlaufen am oberen Ende. Über diese Schlaufen kann die Platine sogar mit Spannung versorgt werden. Die Rückseite hat nun eine Beschriftung für alle elektrischen Bauteile.
 
 === Stückliste ===
-* 1x Leiterplatte: 0,90€ (df-robot.com)
-* 1x Controller ATMEGA328P-AU: 3,10€ (reichelt.de)
+Ein Bausatz ab HW Version 3 besteht aus folgenden Teilen:
+* 1x Leiterplatte (df-robot.com)
+* 1x Controller ATMEGA328P-AU
 * 20x LEDs SOT23 rot: 
-** Reichelt: 20x0,19€ = 3,80€
-** ebay: 20x0,058€ = 1,16€
-* 20x Widerstand 1k 0603: 20x0,0019€ = 0,024€
-* 1x Taster "RAFI 100.503": Reichelt: 0,46€
-* 2x Kondensator 100nF 0603: 2x0,002€ = 0,004€
-* 1x Widerstand 10k 0603: 0,0019€ = 0,0019€
-* '''Summe:''' 5,65€
-
-Als Controller kann sicherlich ein kleinerer Atmel verwendet werden. Für den Taster muss noch ein günstiger Ersatz gefunden werden.
+* 21x Widerstand 1k 0603
+* 1x Taster 
+* 2x Kondensator 100nF 0603
+* 1x 6-Pol Wanne
+* 1x ca. 40cm Litze
+
+''Im Space liegen noch ein paar wenige HW Version 1 Bausätze herum. Diese weichen hiervon leicht ab.''
+
+=== Aufbau und Inbetriebnahme: HW V3===
+Das H mit der HW-Version 3 wird mit geflashten Controller ausgeliefert. Für die Inbetriebnahme benötigt man daher keinen Programmer. Möchte man allerdings eigene Animationen entwickeln, wird ein Programmer benötigt. Für Hacker im Stratum0: Im Space befinden sich mindestens ein USBASP und ein STK500 - ''irgendwo''.
+
+==== 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.
+* Da der Controller bereits geflasht ist, ist der ISP-Anschluss optional. Dieser kann an dieser Stelle, oder auch einfach später aufgelötet werden.
+* 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: 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 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.
+
+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
+
+
+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
+
+ Mit einem Atmel STK500V2
+ # avrdude -v -B 1 -p m328p -P /dev/ttyUSB0 -c stk500v2 -U flash:w:s0light.hex
+
+Direkt nach de Flash-Vorgang sollte das H mit einer Animation beginnen.
+
+=== 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
+
+
+=== Stückliste ===
+Für HW01:
+
+    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
+
+
+=== 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]]
+
+
+* 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)
+
+==== 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]]