Vom Programmcode zur Firmware

1. Die Software, eigentlich der aktuelle Programm-Code, muss heruntergeladen werden
2. Nach dem Herunterladen liegt der Programmcode als ZIP-Archiv vor und kann so noch nicht verwendet werden.
   Um den Programm-Code verwenden zu können muss das ZIP-Archiv "entpackt" werden, so dass alle enthaltenen Dateien im Originalformat verfügbar sind.
3. Wenn die Dateien des Programm-Codes im Originalformat vorliegen, können (wenn gewünscht) Anpassungen und Änderungen vorgenommen werden.
4. Der Programm-Code muss (nachdem ev. Anpassungen vorgenommen) in Maschinen-Code für den verwendeten Arduino übersetzt (compiliert) werden.
5. Nach dem (erfolgeichen) Compilieren liegt nun die Firmware vor und kann auf den Arduino "hochgeladen" werden

Download der TonUINO Software

• Dazu dort unter dem Button "Code" den Menüpunkt "Download ZIP" auswählen
• Das angebotene ZIP-Archiv in einem Verzeichnis auf dem PC speichern

Entpacken der TonUINO Software

1. Schritt 1
   Mit dem "Windows Exlorer" das Verzeichnis öffnen, in das die Datei "TonUINO-TNG-main.zip" heruntergeladen wurde.
   Dort die Datei mit einem Doppelklick im Windows Explorer öffnen.
   In der Archiv-Datei befindet sich ein Verzeichnis "TonUINO-TNG-main"
   
2. Schritt 2
   Das Verzeichnis "TonUINO-TNG-main" auswählen und mit der rechten Maustaste das Kontextmenü öffnen und die Funktion "Kopieren" auswählen.
   Anschließend wieder in das Verzeichnis "TonUINO" zurückkehren.
   
3. Schritt 3
   Zunächst im Verzeichnis "TonUINO" mit der linken Maustate in einen freien Bereich klicken und anschließend dort mit der rechten Maustaste das Kontextmenü öffnen.
   Im Kontextmenü die Funktion "Einfügen" auswählen.
   Das Entpacken beginnt umgehend
   
   
4. Schritt 4
   Wenn das Entpacken abgeschlossen ist, gibt es nun ein Verzeichnis "TonUINO-TNG-main"
   Dieses Verzeichnis muss abschließend noch umbenannt werden zu "TonUINO-TNG"
   
5. Schritt 5
   Das Verzeichnis "TonUINO-TNG" sollte nun Struktur und Inhalt wie nebenstehenden gezeigt haben.
   Damit ist der Download und das Enpacken beendet und der Programm-Code des TonUINO für die nächsten Schritte bereit.
   

   ---

   Konfiguration / Modifikation der TonUINO Software

   Nach dem Download ist nun der gesamte Quellcode des TonUINO verfügbar und
   • MUSS zwingend für mögliche / vorhandene Hardware konfiguriert werden
   • kann zusätzlich durch aktivieren / deaktivieren von Funktionen individuell geändert oder angepasst werden.
   
   Geeignete Programme dazu sind "Arduino IDE und PlatformIO
   Wirkliche Ändeungen am Programm-Code sollten allerdings nur erfahrene Programmierer oder Experten vornehmen.
   Anpassungen an die verwendete Hardware und die Aktivierung von zusätzlichen Funktionen können einfach vom Anwender vorgenommen werden, da bereits die notwendigen Programmteile und Parameter so vorbereitet sind, dass sie nur noch über die Änderung einer einzigen Programmzeile aktiviert werden müssen.
   Alle für Änderungen vorgesehenen Programmzeilen befinden sich in der Datei "constants.hpp" und beginnen mit dem Schlusselwort "#define"
   • 2 Schrägstriche vor dem Schlüsselwort deaktivieren die dami verbundenen Programmteile und / oder Parameter
   • das Schlüsselwort OHNE führende Schrägstriche aktiviert die verbundenen Programmteile und / oder Parameter
   Konfiguration der Hardware ist erforderlich für
   • Varianten des Arduino Mikrocontrollers
   • Varianten des DF-Players
   • Bedienfeld (Anzahl der Tasten)
   OHNE Konfiguration für Hardware kann das Programm nicht compiliert werden!
   "TonUINO-TNG Konfigurationsmöglichkeiten und Funktionen" enthält eine vollständige Übersicht der Möglichkeiten
   
   

   ---

   Compilieren der TonUINO Software

   Ist die Konfiguration / Anpassung des Programmcodes vollständig und korrekt ausgeführt, kann der Code nun compiliert werden.
   War das Compilieren erfolgreich, wird das Hochladen der Firmware auf den Mikrocontroller automatisch eingeleitet.
   Leider kommt es beim Compilieren auch zu Fehlern und der Vorgang wird abgebrochen. In diesen Fällen erzeugt der Compiler eine Reihe von Fehlermeldungen deren Analyse Hinweise auf die Ursache geben kann.
   Die potenziellen Fehlermeldungen sind so vielfältig, das es nicht möglich ist, auf alle einzugehen und bis zu einer Lösung zu analysieren. In den folgenden Beispielen sind einige typische Fehlermeldungen mit Hinweisen gezeigt, die als Interpretationshilfe dienen sollen.
   Diese Fehlermeldungen wurden auf einem funktionierenden System (bestehnd aus PC, Arduino IDE und TonUINO) für Dokumentatinszwecke gezielt provoziert.

   ---

   • Variante 1 - (kein Mikrocontroller in constants.hpp angegeben)

     In file included from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\tonuino.hpp:11:0,
                      from C:\Daten\Arduino-Projekte\TonUINO-TNG\TonUINO-TNG.ino:1:
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\mp3.hpp:268:26: error: 'maxTracksInFolder' was not declared in this scope
        typedef queue track_queue;
                               ^~~~~~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\mp3.hpp:268:43: error: template argument 2 is invalid
        typedef queue track_queue;
                                                ^
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\mp3.hpp: In member function 'uint8_t Mp3::getCurrentTrack()':
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\mp3.hpp:234:50: error: request for member 'get' in '((Mp3*)this)->Mp3::q', which is of non-class type 'Mp3::track_queue {aka int}'
        uint8_t getCurrentTrack() { return playing ? q.get(current_track) : 0; }
                                                       ^~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\mp3.hpp: In member function 'bool Mp3::isLastTrack()':
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\mp3.hpp:236:52: Mp3::q', which is of non-class type 'Mp3::track_queue {aka int}'
        bool isLastTrack() { return current_track+1 >= q.size(); }
                                                         ^~~~
     													
     Mehrere Bibliotheken wurden für "SoftwareSerial.h" gefunden
       Benutzt: C:\Users\nobl\AppData\Local\Arduino15\packages\arduino\hardware\avr\1.8.6\libraries\SoftwareSerial
       Nicht benutzt: C:\Daten\Arduino-Projekte\libraries\EspSoftwareSerial
     exit status 1
     
     Compilation error: 'maxTracksInFolder' was not declared in this scope
     

     Die markierten Teile der Fehlermeldung zeigen, dass einige Variablen nicht definiert wurden. Diese Definitionen erfolgen (passend) für jeden Mikrocontroller in dem spezifischen Programmteil. Fehlen diese Definitionen, deutet das darauf hin, dass noch kein Mikrocontroller angegeben wurde.
     Nach Angabe eines Mikrocontrollers in der "constants.hpp" und entsprechender Einstellung in der Arduino IDE kommt es zu keiner Fehlermeldung beim Compilieren mehr.

   ---

   • Variante 2 - (unterschiedliche Mikrocontroller in Programmcode und Arduino IDE angegeben)

     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\tonuino.cpp: In member function 'void Tonuino::setup_adc()':
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\tonuino.cpp:159:19: error: 'INTERNAL2V5' was not declared in this scope
        analogReference(INTERNAL2V5);
                        ^~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\tonuino.cpp:159:19: note: suggested alternative: 'INTERNAL'
        analogReference(INTERNAL2V5);
                        ^~~~~~~~~~~
                        INTERNAL
     Mehrere Bibliotheken wurden für "SoftwareSerial.h" gefunden
       Benutzt: C:\Users\nobl\AppData\Local\Arduino15\packages\arduino\hardware\avr\1.8.6\libraries\SoftwareSerial
       Nicht benutzt: C:\Daten\Arduino-Projekte\libraries\EspSoftwareSerial
     exit status 1
     
     Compilation error: 'INTERNAL2V5' was not declared in this scope
     

     Diese Fehlermeldungen wurden ausgelöst, obwohl ein Mikrocontroller definiert wurde.
     Allerdings passte die Auswahl des Mikrocontrollers in der Arduino IDE nicht zum im Programmcode angegebenen Board.
     Nach Anpassung der Mikrocontrollerauswahl in der Arduino IDE kommt es zu keiner Fehlermeldung beim Compilieren mehr.

   ---

   • Variante 3 - Arduino Nano Every nicht mit Board-Paket MegaCoreX compiliert)

     ^~~~~~~~~~~~~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:430:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr uint8_t       shutdownPin      = 7;
                                     ^~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:434:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr levelType     shutdownPinType  = levelType::activeLow;
                                     ^~~~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:436:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr uint8_t       openAnalogPin    = A7;
                                     ^~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:437:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr unsigned long cycleTime        = 50;
                                     ^~~~~~~~~
     In file included from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\logger.hpp:4:0,
                      from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\modifier.hpp:7,
                      from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\tonuino.hpp:12,
                      from C:\Daten\Arduino-Projekte\TonUINO-TNG\TonUINO-TNG.ino:1:
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\modifier.hpp: In member function 'virtual bool ToddlerMode::handleButton(command)':
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\log.hpp:13:6: warning: 'if constexpr' only available with -std=c++1z or -std=gnu++1z
        if constexpr ( Logger_::will_log(Severity_) )                                  \
           ^
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\modifier.hpp:77:38: note: in expansion of macro 'LOG'
        bool handleButton(command) final { LOG(modifier_log, s_debug, F("ToddlerMode::Button -> LOCKED!")); return true; }
                                           ^~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\TonUINO-TNG.ino: In function 'void setup()':
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\log.hpp:13:6: warning: 'if constexpr' only available with -std=c++1z or -std=gnu++1z
        if constexpr ( Logger_::will_log(Severity_) )                                  \
           ^
     C:\Daten\Arduino-Projekte\TonUINO-TNG\TonUINO-TNG.ino:31:3: note: in expansion of macro 'LOG'
        LOG(init_log, s_error, F("\n _____         _____ _____ _____ _____"));
        ^~~
     

     Hier wurden etliche Zeilen der Fehlermeldung entfernt

     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:434:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr levelType     shutdownPinType  = levelType::activeLow;
                                     ^~~~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:436:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr uint8_t       openAnalogPin    = A7;
                                     ^~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:437:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr unsigned long cycleTime        = 50;
                                     ^~~~~~~~~
     In file included from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\logger.hpp:4:0,
                      from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\commands.cpp:4:
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\commands.cpp: In member function 'command Commands::getCommand(commandRaw, state_for_command)':
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\log.hpp:13:6: warning: 'if constexpr' only available with -std=c++1z or -std=gnu++1z
        if constexpr ( Logger_::will_log(Severity_) )                                  \
           ^
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\commands.cpp:88:5: note: in expansion of macro 'LOG'
          LOG(button_log, s_info , F("btn/cmd: "), getCommandRawStr(b), F("/"), getCommandStr(ret));
          ^~~
     Mehrere Bibliotheken wurden für "SoftwareSerial.h" gefunden
       Benutzt: C:\Users\nobl\AppData\Local\Arduino15\packages\arduino\hardware\megaavr\1.8.8\libraries\SoftwareSerial
       Nicht benutzt: C:\Daten\Arduino-Projekte\libraries\EspSoftwareSerial
     exit status 1
     
     Compilation error: 'printStatusCode' function uses 'auto' type specifier without trailing return type
     

     
     Hier verwendet ein Funktionsaufruf im Programmcode andere Parameter als sie durch das Board-Paket erwartet werden.
     In der Konfiguration der Hardware ist "TonUINO-Every" ausgewählt und entsprechend in der Arduino IDE auch "Arduino Nano Every" ausgewählt worden.
     NICHT berücksichtigt wurde, dass der Programmcode ab Version 3.2.0 auf Verwendung des Board-Paketes "MegaCoreX für den Nano Every umgestellt wurde.
     Nachdem das Board-Paket MegaCoreX V 1.1.2 (Achtung nicht 1.1.3!) installiert wurde und in der Arduino IDE dazu passend das Board "ATmega4809" für den Arduino Nano Every ausgewählt wurde, kommt es zu keiner Fehlermeldung beim Compilieren mehr.

     Es gibt auch einen Klon des Arduino Nano Every bestückt mit einem ATmega4808 Prozessor. Wird ein solcher Klon verwendet, muss natürlich die Board-Einstellung in der Arduino IDE "ATmega4808" geändert werden.
     

     ---

   • Variante 4 - fehlende Datei platform.local.txt

     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:414:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr uint8_t       dfPlayer_transmitPin     = 3;
                                     ^~~~~~~~~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:417:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr uint8_t       maxTracksInFolder        = 255;
                                     ^~~~~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:418:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr uint8_t       dfPlayer_busyPin         = 4;
                                     ^~~~~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:419:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr levelType     dfPlayer_busyPinType     = levelType::activeHigh;
                                     ^~~~~~~~~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:425:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr unsigned long dfPlayer_timeUntilStarts = 1200;
                                     ^~~~~~~~~~~~~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:430:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr uint8_t       shutdownPin      = 7;
                                     ^~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:434:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr levelType     shutdownPinType  = levelType::activeLow;
                                     ^~~~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:436:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr uint8_t       openAnalogPin    = A7;
                                     ^~~~~~~~~~~~~
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:437:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z<
      inline constexpr unsigned long cycleTime        = 50;
                                     ^~~~~~~~~
     In file included from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\logger.hpp:4:0,
                      from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\modifier.hpp:7,
                      from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\tonuino.hpp:12,
                      from C:\Daten\Arduino-Projekte\TonUINO-TNG\TonUINO-TNG.ino:1:
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\modifier.hpp: In member function 'virtual bool ToddlerMode::handleButton(command)':
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\log.hpp:13:6: warning: 'if constexpr' only available with -std=c++1z or -std=gnu++1z
        if constexpr ( Logger_::will_log(Severity_) )                                  \
           ^
     

     Hier wurden etliche Zeilen der Fehlermeldung entfernt
     

     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\constants.hpp:437:32: warning: inline variables are only available with -std=c++1z or -std=gnu++1z
      inline constexpr unsigned long cycleTime        = 50;
                                     ^~~~~~~~~
     In file included from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\logger.hpp:4:0,
                      from C:\Daten\Arduino-Projekte\TonUINO-TNG\src\commands.cpp:4:
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\commands.cpp: In member function 'command Commands::getCommand(commandRaw, state_for_command)':
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\log.hpp:13:6: warning: 'if constexpr' only available with -std=c++1z or -std=gnu++1z
        if constexpr ( Logger_::will_log(Severity_) )                                  \
           ^
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\commands.cpp:88:5: note: in expansion of macro 'LOG'
          LOG(button_log, s_info , F("btn/cmd: "), getCommandRawStr(b), F("/"), getCommandStr(ret));
          ^~~
     Mehrere Bibliotheken wurden für "SoftwareSerial.h" gefunden
       Benutzt: C:\Users\nobl\AppData\Local\Arduino15\packages\arduino\hardware\avr\1.8.6\libraries\SoftwareSerial
       Nicht benutzt: C:\Daten\Arduino-Projekte\libraries\EspSoftwareSerial
     exit status 1
     
     Compilation error: 'printStatusCode' function uses 'auto' type specifier without trailing return type
     

     Unzählige "Warning" Meldungen und der Fehler weisen darauf hin, dass der Compiler den Programmcode nicht korrekt "versteht". Dies ist ein Indiz dafür, dass dem Compiler die für den Programmcode verwendete Sprachversion noch nicht bekannt ist.
     Die genaue Sprachversion ist in der Datei "platform.local.txt" angegeben, die genau nach Anweisung aus der "Readme.md" des Programmcodes in das angegebene Verzeichnis kopiert werden muss. Der Kopiervorgang muss für jedes Board-Paket vorgenommen werden, da die Zielverzeichnisse für jedes Board-Paket leicht unterschiedlich sind.
     Nachdem die "platform.local.txt" in das korrekte Verzeichnis kopiert wurde muss die Arduino IDE geschlossen und neu gestartet werden.
     Ist die Arduino IDE wieder betriebsbereit kommt es zu keinen Warn- oder Fehlermeldungen beim Compilieren mehr.

     ---

   • Variante 5 - fehlende Bibliothek

     In file included from C:\Program Files\TonUINO-TNG\src\settings.hpp:8:0,
     from C:\Program Files\TonUINO-TNG\src\tonuino.hpp:4,
     from C:\Program Files\TonUINO-TNG\TonUINO-TNG.ino:1:
     C:\P
     
     rogram Files\TonUINO-TNG\src\chip_card.hpp:6:10: fatal error: MFRC522.h: No such file or directory
     #include 
     ^~~~~~~~~~~
     compilation terminated.
     exit status 1
     Compilation error: MFRC522.h: No such file or directory
     

     Die Fehlermeldung weist ganz klar auf eine fehlende Datei. In diesem Beispiel eine Bibliothek für die Baugruppe MFRC522 (den Kartenleser)
     Nach korrekter Installation der Bibliothek kommt es zu keinen Warn- oder Fehlermeldungen beim Compilieren mehr.

   ---

   Hochladen der TonUINO Software

   Istder Programmcode erfolgreich compiliert worden, beginnt das Hochladen der Firmware automatisch.
   Hierbei kann es zu folgenden Fehlermeldungen kommen:

   • Variante 1 - keine Verbindung PC <--> TonUINO

     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\logger.hpp:6:1: warning: type 'struct tonuino_log' violates the C++ One Definition Rule [-Wodr]
      DEFINE_LOGGER(tonuino_log , s_debug  , void);
      ^
     C:\Daten\Arduino-Projekte\TonUINO-TNG\src\logger.hpp:6:1: note: a type with different bases is defined in another translation unit
      DEFINE_LOGGER(tonuino_log , s_debug  , void);
      ^
     Der Sketch verwendet 28322 Bytes (92%) des Programmspeicherplatzes. Das Maximum sind 30720 Bytes.
     Globale Variablen verwenden 1518 Bytes (74%) des dynamischen Speichers, 530 Bytes für lokale Variablen verbleiben. Das Maximum sind 2048 Bytes.
     avrdude: ser_open(): can't open device "\\.\COM14": Das System kann die angegebene Datei nicht finden.
     

   Diese Fehlermeldung sagt deutlich, dass keine Verbindung zwischen TonUINO und PC über die angegebene Schnittstelle (hier: COM14) beswteht.
   Zur Abhilfe muss zunächst die Verbindung TonUINO <--> PC hergestellt werden.

   ---

   • Variante 2 - falscher / fehlerhafter Bootloader

     Bei bestehender Verbindung TonUINO <--> PC kann es dennoch zu einem Fehler kommen, wenn das Übertragungsprogramm (Bootloader) keine zuverlässige Kommunikation aqufbauen kann.
     Diese Fehlermeldung zeigt, dass zwar eine Datenverbindung zwischen TonUINO und PC besteht, das Übertragungsprogramm aber nicht in der Lage war, Daten erfolgreich zu übertragen.
     

     Globale Variablen verwenden 9 Bytes (0%) des dynamischen Speichers, 2039 Bytes für lokale Variablen verbleiben. Das Maximum sind 2048 Bytes.
     
     avrdude: stk500_getsync() attempt 1 of 10: not in sync: resp=0xec
     avrdude: stk500_getsync() attempt 2 of 10: not in sync: resp=0x3d
     avrdude: stk500_getsync() attempt 3 of 10: not in sync: resp=0x31
     avrdude: stk500_getsync() attempt 4 of 10: not in sync: resp=0x53
     avrdude: stk500_getsync() attempt 5 of 10: not in sync: resp=0x0a
     avrdude: stk500_getsync() attempt 6 of 10: not in sync: resp=0xe6
     avrdude: stk500_getsync() attempt 7 of 10: not in sync: resp=0x0a
     avrdude: stk500_getsync() attempt 8 of 10: not in sync: resp=0xe6
     avrdude: stk500_getsync() attempt 9 of 10: not in sync: resp=0x0c
     avrdude: stk500_getsync() attempt 10 of 10: not in sync: resp=0xdd
     Fehlgeschlagenes Hochladen: Hochladefehler: exit status 1
     
     

     Weil Kommunikationsprobleme auch durch Störungen auf den Verbindungsleitungen entstehen können, wird der Verbindungsaufbau (bis zu 10 mal) versucht. Sind alle Versuche fehlgeschlagen, wird der Vorgang mit der gezeigten Fehlermeldung abgebrochen.
     Diese Fehlermeldung zeigt, dass zwar eine (funktionierende!) Datenverbindung zwischen TonUINO und PC besteht, der Bootloader aber nicht in der Lage war, Daten erfolgreich zu übertragen.
     Dieser Fehler tritt nur auf, wenn als Mikrocontroller der Arduino Nano verwendet wird. Dieses Board wird je nach Charge und Herkunft mit unterschiedlichen Bootloadern ausgeliefert.
     Dies ist bereits in der Arduino IDE berücksichtigt indem dort zwischen 2 Bootloadern gewählt werden kann.
     Leider lässt sich nicht vorher feststellen, mit welchem Bootloader der Mikrocontroller ausgeliefert wurde, sa dass der Upload zunächst "auf gut Glück" versucht werden muss.
     Kommt es beim Hochladen zu dieser Fehlermeldung, hilft eine Umstellung auf den jeweils anderen Bootloader.
     

   ---

   TonUINO-TNG Uploader

   Mit dem "TonUINO-TNG Uploader" kann die Firmware für unterschiedliche Hardwarekonfigurationen mit den Standardeinstellungen direkt auf den TonUINO geladen werden.
   
   
   Es muss der entsprechende COM-Anschluss ausgewählt werden, uber den der TonUINO mit dem PC verbunden ist.
   (siehe dazu "Kontrolle / Herstellung der Verbindung")
   
   Sobald die vorliegende Hardware-Konfiguration für Mikrocontroller und Bedienfeld ausgewählt ist, kann der Upload gestartet werden.
   
   Der erfolgreiche Upload wird bestätigt.
   Funktionierende Hardware vorausgesetzt, ist der TonUINO nun nach einem Neustart einsatzbereit.
   

   ---

   Anpassung der Firmware in Datei "constants.hpp".

   Der Programmcode des TonUINO ist bereits für alle Funktionen vorbereitet und enthält auch bereits den dazu notwendigen Programmcode. Es ist wegen des begrenzten Programmspeichers des Arduino Nano jedoch nicht möglich, alle Programmanteile zu kompilieren und in den Arduino Nano zu laden.
   Aus diesem Grunde gibt es die Datei "constants.hpp" über die Programmteile einfach aktiviert und deaktiviert werden können.
   Die Programmteile, die zur Auswahl stehen, sind in der Datei mit dem Schlüsselwort "define" und einem charakteristischen Begriff für die Programmfunktion gekennzeichnet.
   Typisch wird diese Zeile in der constants.hpp mit 2 Schrägstrichen (//) eingeleitet
   Diese Schrägstriche am Zeilenanfang bedeuten, dass der entsprechende Programmteil NICHT aktiviert ist.
   Soll der Programmteil aktiviert werden, müssen lediglich die 2 Schrägstriche am Zeilenanfang entfernt werden.
   Beispiel:
   Im folgenden Programmcode ist die Funktion "USE_POLOLU_SHUTDOWN" nicht aktiviert, da die Zeile mit 2 Schrägstrichen beginnt.

   // ######################################################################
   
   /* uncomment the below lines if you use Pololu Powerswitch or Traeger Platine for shutdown
    * wenn der Pololu Powerswitch oder die Traeger Platine für das Shutdown verwendet wird, in den nächsten Zeile den Kommentar entfernen
    */
   //#define USE_POLOLU_SHUTDOWN
   //#define USE_TRAEGER_PLATINE_SHUTDOWN
   

   Im nächsten Abschnitt wurden die Schrägstriche am Zeilenanfang im Programmcode entfernt womit die Funktion "USE_POLOLU_SHUTDOWN" nun aktiviert ist.

   // ######################################################################
   
   /* uncomment the below lines if you use Pololu Powerswitch or Traeger Platine for shutdown
    * wenn der Pololu Powerswitch oder die Traeger Platine für das Shutdown verwendet wird, in den nächsten Zeile den Kommentar entfernen
    */
   #define USE_POLOLU_SHUTDOWN
   //#define USE_TRAEGER_PLATINE_SHUTDOWN
   
   

   Bei diesen Änderungen ist mit großer Sorgfalt vorzugehen, da alle anderen Zeichen (auch Satzzeichen !) zum Programmcode gehören und eine Veränderung zu Fehlern beim Compilieren führt.
   Nachdem alle Änderungen vorgenommen sind, muss die Firmware erneut compiliert werden.

   ---