Befüllen der SD-Karte

Grundsätzlich funktioniert der TonUINO mit Micro-SD-Karten bis 32 GB.
Die SD-Karte kann nicht über den USB-Anschluss der Arduino befüllt werden, sie muss separat mit dem Computer verbunden werden.
Theoretisch kann man eine USB-Buchse an den DFPlayer anlöten und dann die SD-Karte auch direkt befüllen. Hiervon wird allerdings abgeraten, weil es sehr langsam und fehleranfällig ist.

Formatieren

Die SD-Karte sollte normal formatiert werden, keine Schnellformatierung. Als Formatierung muss FAT32 verwendet werden. Hierfür eignet sich am besten der SD Memory Card Formater zum Formatieren von SD Karten.

Sprachansagen

Es müssen die Ordner „mp3“- und „advert“ mit den entsprechenden Dateien vorhanden sein. Diese können für die offizielle Software direkt von www.tonuino.de heruntergeladen werden. Alternativ findest du die Dateien auch im Repository auf GitHub. Die zip-Datei musst du dann entpacken und die beiden Ordner auf SD-Karte verschieben.
Die Dateien können auch selbst erzeugt werden. Dazu braucht man eine Lizenz bei AWS oder Google oder man muss coqui (siehe https://www.thorsten-voice.de) installieren. Im Ordner tools auf Github findest du dafür das Skript create_audio_messages.py. Du kannst die Texte aus der Audiomessages Datei natürlich auch selbst einsprechen.

:warning: Wichtig ist, immer die passenden Dateien zur verwendeten Firmware zu benutzen. Wenn du also eine andere Software ausprobierst, denk daran auch den Inhalt des mp3- und advert-Ordners zu ändern.

Eigene Dateien

Am besten verwendet man mp3-Dateien. Das wav-Format kann auch verwendet werden, allerdings braucht das sehr viel mehr Speicherplatz und wird deshalb nicht empfohlen.
Eigene Ordner müssen 01 bis 99 heißen, Dateien in den eigenen Ordnern müssen mit einer dreistelligen Nummer beginnen ( 001 bis 255 ), können aber weitere Zeichen enthalten.
Beispiele: 001.mp3 , 002Lied.mp3 oder 003-Hoerspiel.mp3 wären erlaubt.
Achtung: Nicht alle DFPlayer akzeptieren im Dateinamen Zeichen hinter der dreistelligen Nummer. Außerdem wurde die Erfahrung gemacht, dass längere Dateinamen den TonUINO langsamer werden lassen.
Es sind keine Lücken bei den Dateinummern erlaubt.
Die Struktur der Verzeichnisse und Dateien auf der SD-Karte sollte so aussehen:
16%20AM

Dateien für das Quiz-Spiel

Dateien für Quiz-Spiele müssen zwar denselben Regeln (Nummerierung, Dateinamen) genügen, wie die allgemeinen Dateien auch. Für die Varianten des Quiz-Spiels erhalten sie allerdings durch die Reihenfolge im Ordner eine besondere und wichtige Funktion für das Quiz-Spiel.
Jede mögliche Spielvariante des Quiz benötigt eine eigene Anordnung der „Dateipakete“ passender Größe. Da technisch nur max. 255 Dateien in einem Ordner sein dürfen, variiert die Anzahl möglicher Fragen für jede Spielvariante des Quiz. Detaillierte Beschreibungen zu den möglichen Spielvatianten sind in den folgenden Abschnitten aufgeführt.

Quiz mit 2 Antworten

Das Quiz-Spiel mit 2 Antworten benötigt ein Dateipaket aus 3 Dateien pro Frage:

  1. Die Frage
  2. Antwort 1
  3. Antwort 2

Nach diesem Muster sind maximal 85 Fragen pro Ordner möglich.

Dabei muss aus programmtechnischen Gründen Antwort 1 immer die richtige sein.
Keine Sorge, im Spiel werden die Antworten zufällig gemischt, so dass im Spiel kein wiederkehrendes Muster für die richtige Antwort entsteht.
Als Grafik sieht die Anordnung der Dateipakete dann so aus:

Quiz mit 4 Antworten

Das Quiz-Spiel mit 4 Antworten benötigt ein Dateipaket aus 5 Dateien pro Frage:

  1. Die Frage
  2. Antwort 1
  3. Antwort 2
  4. Antwort 3
  5. Antwort 4

Nach diesem Muster sind maximal 51 Fragen pro Ordner möglich.

Dabei muss aus programmtechnischen Gründen Antwort 1 immer die richtige sein.
Keine Sorge, im Spiel werden die Antworten zufällig gemischt, so dass im Spiel kein wiederkehrendes Muster für die richtige Antwort entsteht.
Als Grafik sieht die Anordnung der Dateipakete dann so aus:

Quiz mit 2 Antworten + Lösung

Das Quiz-Spiel mit 2 Antworten + Ansage der Lösung / Erklärung benötigt ein Dateipaket aus 4 Dateien pro Frage:

  1. Die Frage
  2. Antwort 1
  3. Antwort 2
  4. Lösung / Erklärung

Nach diesem Muster sind maximal 63 Fragen pro Ordner möglich.

Dabei muss aus programmtechnischen Gründen Antwort 1 immer die richtige sein.
Keine Sorge, im Spiel werden die Antworten zufällig gemischt, so dass im Spiel kein wiederkehrendes Muster für die richtige Antwort entsteht.
Als Grafik sieht die Anordnung der Dateipakete dann so aus:

Quiz mit 4 Antworten + Lösung

Das Quiz-Spiel mit 4 Antworten + Ansage der Lösung / Erklärung benötigt ein Dateipaket aus 6 Dateien pro Frage:

  1. Die Frage
  2. Antwort 1
  3. Antwort 2
  4. Antwort 3
  5. Antwort 4
  6. Lösung / Erklärung

Nach diesem Muster sind maximal 42 Fragen pro Ordner möglich.

Dabei muss aus programmtechnischen Gründen Antwort 1 immer die richtige sein.
Keine Sorge, im Spiel werden die Antworten zufällig gemischt, so dass im Spiel kein wiederkehrendes Muster für die richtige Antwort entsteht.
Als Grafik sieht die Anordnung der Dateipakete dann so aus:

Quiz mit Buzzer + Lösung

Das Quiz-Spiel mit Buzzer + Ansage der Lösung / Erklärung benötigt nur ein Dateipaket aus 2 Dateien pro Frage pro Frage:

  1. Die Frage
  2. Lösung / Erklärung

Nach diesem Muster sind maximal 127 Fragen pro Ordner möglich.

Als Grafik sieht die Anordnung der Dateipakete dann so aus:
Quiz_B+L

Es gibt eine umfangreiche Fragensammlung zum Quiz-Spiel mit Beispielen für die unterschiedlichen Spielvarianten

Dateien für das Memory-Spiel

Wie bei jedem Memory-Spiel werden auch hier 2 Dateien benötigt, die ein zusammengehöriges Paar bilden.

Ordnerstruktur und Dateianordnung

Aus programmtechnischen Gründen müssen diese Dateien im Ordner unmittelbar zusammen liegen. Daraus ergibt sich dann diese Datenstruktur:
Memory-Spiel
Theoretisch können also 127 Paare gebildet werden.
Da die ersten Memory-Spiele aber mit einer einfachen 4 x 4 Matrix (16 Karten) gespielt werden, genügt die Bildung von nur 8 Paaren für den Start vollkommen.

Tipps und Tricks

Die falsche Reihenfolge beim Aufspielen oder nachträgliches Löschen/Einfügen von Dateien kann Fehler verursachen, die man mit bspw. dem FAT Sorter beheben kann. Selbst wenn keine Fehler auftreten, kann der Player dadurch träger/ langsamer werden. Wenn es also länger dauert, bis etwas abgespielt wird, kann der FAT Sorter oder das neu Befüllen der SD-Karte helfen.

Es gibt viele Programme, die einem das korrekte Befüllen der SD-Karte erleichtern. Diese findest du in der Übersicht der Tools / Anleitungen für den TonUINO. Zusätzlich zu dem Abschnitt mit Programmen von der Community, gibt es unten auch einen Abschnitt mit weiteren nützlichen Tools.

Häufige Fehler

Es sind unnötige Dateien auf der Karte vorhanden.
MacOS legst solche auf der SD-Karte ab (Spotlight, Apple Double Files und Co.). Gegen Apple Double Files hilft dot_clean /Volumes/<volumename> . Wobei <volumename> der Name der SD Karte im System ist.
Der von Windows erzeugte Ordner System Volume Information, stört im Allgemeinen nicht. Willst du ihn dennoch entfernen, findest du hier eine Anleitung.
Linux erstellt teilweise einen versteckten Ordner .Trash-1000. Dieser sollte nicht stören. Du kannst ihn aber trotzdem entfernen.