TonUINO

Die DIY Musikbox (nicht nur) für Kinder.

• TonUINO
  • English Readers (für unsere englischsprachige Leserschaft)
  • Zusammenfassung
  • Drei Bausteine
  • Mikrocontroller-Hardware
    • Notwendige Grundausstattung (ca. 50 EUR)
    • Optionale erweiterte Hardwareausstattung (ca. 30-50 EUR)
  • Systemnahe Programmierung
    • Für Benutzer
    • Für Entwickler
  • Gehäusebau
    • Notwendige Grundausstattung
    • Optionale erweiterte Gehäuseausstattung

English Readers (für unsere englischsprachige Leserschaft)

For various reasons, we've decided to write this guide in German only. However, you can copy the text from this web page and paste it to DeepL to easily translate the whole documentation at once.

Zusammenfassung

Kinder zu beschenken ist nie einfach. Das Ziel des Projektes TonUINO von Thorsten Voss ist es, eine “Musikbox (nicht nur) für Kinder” selbst zu bauen. Es macht einen riesigen Spaß, die meisten Kinder sind begeistert und diese Seite soll der großartigen Community etwas wieder geben. Denn so gut die Webseite, das Forum und die Videos auch sind, der Bau der ersten Box(en) wäre mit weniger Zeitaufwand möglich.

Insbesondere unterstützt diese Anleitung hier “Newbies” bei der Auswahl der Hardware, geht sequenzieller durch die notwendigen Schritte, beinhaltet Links zu den wichtigsten Informationsquellen und optimiert den Code für Softwareentwickler. Hoffentlich werden diese Anregungen hier irgendwann in die offizielle Dokumentation aufgenommen und machen diese Seite damit zukünftig überflüssig. Jede Art von Pull Requests oder Issues, die die Dokumentation oder den Code gemeinsam verbessern, sind mehr als willkommen!

Drei Bausteine

Es ist wichtig zu wissen, dass die Kunst ein TonUINO zu bauen grundsätzlich als ein Zusammenspiel von drei unterschiedlichen Disziplinen angesehen werden kann: Mikrocontroller-Hardware, systemnahe Programmierung und Gehäusebau. Im Folgenden wird für jeden der Bereiche die notwendige Grundausstattung und sinnvolle Erweiterungen sehr knapp vorgestellt. Das Forum ist ein Quell vieler weiterer Ideen.

Mikrocontroller-Hardware

Es muss gelötet werden. Wir gehen davon aus, dass Lötkolben, Lötzinn und Löterfahrung vorhanden sind. Eine sehr gute Anleitung gibt es bei YouTube und einen Schaltplan auf der offiziellen Webseite. Da hier jedoch die genaue Orientierung der Pins nicht ersichtlich ist, hilft auch noch ein alternativer Schaltplan von dieser Webseite, um die richtigen Pins zu identifizieren. Auf Basis eines Forum-Beitrages im Folgenden eine tabellarische Übersicht:

Die passenden Abbildungen:

Notwendige Grundausstattung (ca. 50 EUR)

Die notwendigen Komponenten können über Reichelt, Conrad, Amazon, E-Bay oder Alibaba bezogen werden. Meist lohnt sich jetzt schon die Planung von mehreren TonUINO-Boxen (dann kostet eine Box deutlich weniger). Im Folgenden Amazon-Affiliate-Links von Komponenten, die Thorsten und andere aus der Community erfolgreich verbaut haben. In der Community Hardware FAQ gibt es weitere wertvolle Hinweise.

Optionale erweiterte Hardwareausstattung (ca. 30-50 EUR)

Es gibt zahllose weitere Ergänzungen, wie LED-Stripes etc. pp. Positive Erfahrungen sollten gerne in diese Liste hier integriert werden.

Systemnahe Programmierung

Es muss nicht unbedingt programmiert werden. Die Installation der Firmware auf den Arduino ist sehr einfach. Ganz einfach geht es mit dem Online-Update. Alternativ kann die Anleitung auf der offiziellen Webseite genutzt werden. Wenn jedoch mehr Knöpfe angesprochen werden sollen (siehe oben), muss die Software dann noch geringfügig angepasst werden.

Es gibt zwar, wie bei jeder Software, ein paar kleine Software-Fehler, die jedoch in unterschiedlichen Branches gefixt wurden. Ziel ist es, diese Änderungen in so wenigen Branches wie möglich pflegen zu müssen.

Für Benutzer

Als einfacher Benutzer sollte die Programmierung so einfach gestaltet sein wie möglich. Deshalb gibt es das Online-Update. Ist der Upload erfolgreich abgeschlossen, kannst du direkt mit befüllen der SD-Karte weitermachen.

Alternativ im Folgenden die notwendigen Schritte, wenn das Online-Update nicht verwendet wird. Eine Community Software FAQ gibt weitere Hilfestellungen. Unten gibt es einen Ablauf als Video.

1. Download der aktuellen Firmware.
2. Die Datei TonUINO.zip landet dann im Download-Verzeichnis und muss mit einem Doppelklick entpackt werden. Es sollte dann ein Verzeichnis TonUINO existieren, in der sich die Datei Tonuino.ino befindet.
3. Anschließend muss die Arduino GUI herunter geladen und installiert werden (unter macOS mit Homebrew einfach über brew cask install arduino).
4. Nach dem Starten der Arduino GUI muss die o.g. Datei geöffnet werden und notwendige Bibliotheken herunter geladen werden. Unter Werkzeuge und dann Bibliotheken Verwalten folgende Pakete suchen und installieren:
   1. JC_Button (von dem Entwickler Jack Christiansen)
   2. DFPlayer Mini Mp3 (von dem Entwickler Makuna)
   3. MFRC522 (von dem Entwickler GitHubCommunity)
5. Nun unter Werkzeuge und dann
   1. Board den Punkt Arduino Nano auswählen
   2. Prozessor den Punkt ATmega328P (Old Bootloader) auswählen
   3. Port den Punkt /dev/cu.wchusbserial??? auswählen (je nach Betriebssystem könnte es anders aussehen)
6. Nun kann die Software unter Sketch und dann Hochladen auf den Arduino hoch geladen werden.

Kurzanleitung zum Aufspielen der Firmware für Benutzer (auf das Video klicken):

Darüber hinaus muss noch die SD-Karte vorbereitet werden:

1. Die Karte am besten mit dem SD Memory Card Formatter mit FAT32 formatieren.
2. Wurde das Online-Update genutzt, müssen noch die Dateien für die SD-Karte heruntergeladen und entpackt werden. Die Ordner mp3 und advert aus dem Ordner sd-card müssen auf die SD-Karte kopiert werden. Skripte wie create-soundfiles.sh brauchen gar nicht ausgeführt werden.
3. Auf der SD-Karte müssen die Ordner für die Musik erstellt werden (ohne Lücken beginnend mit 01, dann ggf. 02, ...) und die MP3-Dateien der Lieder müssen ohne Lücken nummeriert werden (mit 001, dann ggf. 002, ...). Am leichtesten ist es eines der Tools von der Community zu verwenden.
4. Die Codierung der NFC-Karten und des Admin-Menüs wird durch die Videos deutlich und sind weitestgehend selbsterklärend.

Für Entwickler

Der Ablauf für Entwickler sieht etwas anders aus und dieses Repository hat sich zum Ziel gesetzt, insbesondere diese Zielgruppe mit zu unterstützen. Insbesondere die Unterstützung von Arduino CLI,PlatformIO und GitHub Actions wurde umgesetzt. Für diese Zielgruppe sollte insbesondere das Makefile eine Hilfe sein, die alle o.g. Punkte und weitere Aspekte automatisiert:

$ make
TonUINO Makefile
================

 Configured to use MCU "arduino:avr:nano:cpu=atmega328old" attached to port "/dev/cu.usbserial-1410".

Available commands:
- help     : get support from the community
- install  : installation of required binaries (arduino-cli)
- init     : initialize environment (arduino-cli)
- compile  : create binary
- upload   : store binary on board flash
- find     : get information about the pluged-in board
- test     : run some basic tests on the code
- clean    : delete temporary files
- feedback : provide feedback and report issues

Kurzanleitung zum Aufspielen der Firmware für Entwickler:

Darüber hinaus gibt es

• auf der offiziellen Webseite und im Repository noch einige nützliche Skripte, die noch nicht in das Makefile integriert sind
• Firmware-Alternativen, die je nach Planung ggf. weitere notwendige Features unterstützen
• die Fritzing GUI, um kompliziertere Aufbauten zunächst am Rechner zu visualisieren und zu planen (unter macOS mit Homebrew einfach über brew cask install fritzing)
• ein change log, die Änderungen der Software dokumentiert

Gehäusebau

Man sollte kreativ werden. Nach dem Zusammenbau der Hardware, dem Aufspielen der Firmware, dem Befüllen der SD-Karte und der Codierung der ersten NFC-Karte, kann man direkt loslegen. Allerdings ist so ein Kabelsalat weder hübsch noch Kind-gerecht.

Notwendige Grundausstattung

Eine stabile Pappschachtel (z.B. die Verpackung des Mobiltelefons oder eine Taschentuchbox) zusammen mit einem günstigen Lautsprecher oder eine fertige Lautsprecherbox aus Holz. Eine Heißklebepistole oder doppelseitiges Klebeband können zum besten Freund werden.

Optionale erweiterte Gehäuseausstattung

Es gibt erstaunliche Arbeiten, die z.B. in der Gallerie aufgeführt sind, und hier kommt die eigentliche Kreativität zum Einsatz (Stofftiere, Schatzkisten, LED-bestückte Jukeboxen, ...). Hier kann mit einem 3D-Drucker kann das eigene Projekt natürlich noch auf eine ganz andere Ebene gehoben werden.