WordClock-Source V0.10  (338)
===================================================================

Projektteam
~~~~~~~~~~~

   Vlad Tepesch (vlad_tepesch)
   Rene H. (promeus)
   Torsten Giese (wawibu)
   Frank M. (ukw)


  
ACHTUNG!
~~~~~~~~
Dies ist lediglich eine Vorabversion des Source-Codes zum
Wordclock-Projekt, siehe auch

Artikel
   http://www.mikrocontroller.net/articles/Word_Clock
bzw. Thread, der alles zum Auslsen gebracht hat:
   Beitrag "Brauche Hilfe beim Bau einer Uhr"
   http://www.mikrocontroller.net/topic/156661

   
   
Inhalt des Zip-Files
~~~~~~~~~~~~~~~~~~~~

Dateien in diesem ZIP-Archiv (nicht alphabetisch sortiert):
|
+-- README.txt             Diese Datei ;)
+-- ChangeLog.txt          Beschreibt die wichtigsten nderungen
+-- Benutzer-Handbuch.pdf  Benutzerhandbuch (auch als docx beiliegend)
+-- [art]                  Enthlt Frontplattendesign
+-+ [AVRootloader]         Enthlt Hagen Re's Bootloader
| +-- [AVR]                  Enthlt den fr die WordClock vorkonfigurieren AVR-Code fr den 
| |                          Bootloader (das Binary ist im wcFirmware/out_mega168 - Ordner)
| +-- [Windows]              Enthlt das Flashtool inklusive der vorkonfigurierten ini-Datei
+-- [Schaltplan]           Schaltplne und Layout zur Wordclock
+-+ [wcFirmware]           Hauptverzeichnis des Quelcodes mit Projektdateien
  +-- [src]                  der gesamte Source Code mit *.c und *.h files
  +-- [doxy]                 zustzliche Dateien fr Doxygen
  +-+ [out_mega168]          Enthlt die Binaries. 
  | +-- AVRootloader.hex       Bootloader (nicht notwendig) siehe auch weiter unten.
  | +-- wc_m168_ger2.hex       Binary fr 'alte' 2-sprachige deutsche Front
  | +-- wc_m168_ger3.hex       Binary fr aktuelle 3-sprachige deutsche Front
  |                          Zu beachten ist, dass die Dateien der 
  |                          Eindeutigkeit halber umbenannt wurden. 
  |                          Wird die Software neu compiliert, entsteht ein neues Hex-File.
  +-- wordclock.aps          Avr Studio Projekt (wichtigstes Projektfile)
  +-- Doxyfile               Projektdatei fr  Doxygen (Generieren von Dokumentation aus Quellcode)
  +-- WordClock_VS.sln       Visual Stuio Solution
  +-- flash.bat              zum Flashen aus VS - muss an eigenen Flasher angepasst werden.
  +-- WordClock_VS.vcproj    Visual Stuio Projekt datei
                             Um aus dem Visual Studio heraus zu compilieren, muss vorher einmal mit
                             dem AVR-Studio bersetzt werden, um die Make-Files zu generieren.
                             Um aus dem Studio heraus flashen zu knnen muss in den Projekt-Settings
                             folgendes unter Debug eingetragen werden
                             Command: flash.bat
                             Command Arguments: m168 out_mega168/wordclock_mega168 WE
                             ("start without debugging" (Strg+F5) startet dann den Flashvorgang)
                         

Aufbau der WordClock
~~~~~~~~~~~~~~~~~~~~                         

Die Dokumentation zum Aufbau der WordClock ist noch im Aufbau,
als Vorabversion kann der Artikel

   http://www.mikrocontroller.net/articles/Word_Clock

dienen, in welchem alles Wissenswerte festgehalten ist.

Lediglich das vorlufige Benutzerhandbuch zur Inbetriebnahme der
WordClock liegt schon einmal in diesem ZIP-Verzeichnis dabei.

Noch ein Wort zum Flashen mit der Hex-Datei: die Fuse-Werte mssen
auf

  lfuse: 0xE2 hfuse: 0xDC efuse: 0xFD
eingestellt werden, damit die WordClock auch richtig "tickt" ;-)

Ein Schreiben des EEPROM ist nicht notwendig, dieser wird automatisch mit 
Defaultwerten beschrieben, wenn die gespeicherte Struktur nicht in Gre 
und SW-Version mit der Firmware bereinstimmt. 
Dies heit im Umkehrschluss: 
wenn man im Code nur an den Werten etwas ndert, sollte die Versionsnummer 
verndert werden, oder der EEPROM beim Programmieren gelscht werden, 
wenn man die EESAVE Fuse gesetzt hat.

Zum Bootloaders  
~~~~~~~~~~~~~~~
Verwednung findet der Bootloader von Hagen Re.
--> http://www.mikrocontroller.net/articles/AVR-Bootloader_mit_Verschl%C3%BCsselung_von_Hagen_Re
Dieser Bootloader zeichnet sich durch einen groen Funktionsumfang, einfache Inbetriebnahme, 
sowie komfortable Benutzung aus.

Hagen Re war so freundlich und hat das OK zur Integration in die WordClock-Auslieferung 
gegeben. Dies hat den Vorteil, dass der fertig konfigurierte Bootloader, 
sowie die Windows vorkonfigurierte Flash-Anwendung beiliegen und nicht extra geladen 
werden mssen. 
Vielen Dank an Hagen fr diesen tollen Bootloader!

Die vorkompilierten WordClock-Hexfiles sollten sowohl mit, als auch ohne Bootloader 
funktionionstchtig sein.
Das senden eines 'R' per UART lst ein Reset (und damit ein Starten des Bootloaders) aus.

Verwednung des Bootloaders:
- setzten der BOOTRST-Fuse 
  Damit ergibt sich folgende Konfiguration der Fuses:
    lfuse: 0xE2 hfuse: 0xDC efuse: 0xFC
- flashen des AVRootloader-hexfile auf bisherigem Weg
- Starten der AVRootloader.exe
- Auswahl des Com-Ports
- Baudrate auf 9600
- Sign auf WCMB (WordClock Main Board)
- "Connect to device" -> Button wird zu "Disconnect"
- Auswahl des Hexfiles
- Klick auf Program
  
Das Tool ist so konfiguiert, dass es von sich aus ein 'R' schickt, 
um die WordClock zu resetten und den Bootloader zu betreten.

  
  

So, dass war das wichtigste.
Viel Spa, 
wnscht das WordClock-Team
