Brauche Hilfe für die Erstellung der Anleitung

Das hört sich ja super an mit der Anleitung!
Muss für die Weihnachtsgeschenke nämlich auch ne Anleitung machen. Aber die PDF sieht ja schon super aus. Spart mir sehr viel Arbeit. Vielen Dank!

Das ist ja eine SEHR schöne Anleitung - gut verständlich und - zumindest so weit ich es sehe - auch vollständig, so dass wirklich jeder, der sich damit beschäftigen möchte, es hinbekommen kann.
Besonders wervoll finde ich den letzten Teil, in dem es um die Bedienung (von Anwenderseite aus) geht - auch hier: Super Arbeit, vielen Dank dafür!
Zwei winzige Punkte sind mir hier aufgefallen:

  1. Soweit ich das beim Überfliegen erkenne, beschreibst Du die Funktionalität der DEV Variante. Von dieser Variante wird aber in einem roten Kasten mehr oder weniger abgeraten („Für den Produktiveinsatz wird dieser nicht empfohlen.“) Hier im Forum wird doch inzwischen eigentlich immer auf die DEV verwiesen, oder?
  2. Auch wenn diese Information natürlich schnell veralten wird (oder gerade deswegen), wäre es hilfreich, den Softwarestand, den Du dokumentierst, anzugeben. Eine Angabe wie „DEV, 05.12.19“ würde schon viel helfen, wenn man irgendwo ins Detail gehen muss um Abweichungen zu suchen.

Verstehe meine Vorschläge bitte nicht falsch: Ich finde das Dokument hervorragend - es ist ein weiterer Schritt, den Tonuino einer noch größeren Gemeinde zugänglich zu machen! Und insbesondere die Möglichkeit, dass ich jemandem meine fertige Box „in die Hand drücken“ kann und auf die entsprechenden paar Seiten in dem Dokument verweisen kann, finde ich hervorrangend.

Danke für das Feedback. :slight_smile: Diese Punkte sind mir bewußt und daher hatte ich erwähnt, dass es Stand 03.2019 ist. Welche Version da aktuell war weiß ich nicht mehr und ich hatte das Forum einige Zeit nicht besucht. Daher kann es sein, dass nun dev eher empfohlen wird. Ich kenne es jedoch so, dass Bugs eher in diesen Versionen zu erwarten sind und man eine stable verwenden sollte. Ich frage am Besten bei Thorsten nach. Sofern sich jemand findet kann man gemeinsam an der Anleitung weiterschreiben. Ich hatte damals die Dinge beschrieben, welche ich als relevant erachtet hatte, um Einsteigern eine Hilfestellung zu bieten. Installation, Konfiguration et cetera damit man den TonUINO frustfrei und relativ zügig nutzen kann. Gut wäre die Verwendung der grafischen Darstellung wie @anku sie auch im Forum präsentiert hat: Cheatsheet Bedienung

Ich schaue mir im Urlaub alles noch einmal in Ruhe an und ergänze die Versionsangaben.

Edit: Die stable aus der Anleitung ist die derzeit aktuelle Version 2.01 vom 01.11.2018.

Ich habe die Anleitung überarbeitet und bitte um Rückmeldung. Insbesondere auf inhaltliche Fehler achten und ob ich etwas genauer beschreiben sollte. Es soll für Einsteiger nachvollziehbar sein.

Grober Aufbau: Benötigte Komponenten, Einrichtung Software, Einrichtung MicroSD und Bedienung sowie Zusatzinformationen.

Fehlt ansonsten noch etwas?

Edit: Einlegen der SD-Karte habe ich lokal ergänzt und es fehlt noch die Beschreibung der Masterkarte. Nebenbei muss ich noch herausfinden was passiert sofern diese verloren wurde. Vermutlich System neu aufspielen. Shortcuts fehlen auch noch. Damit werde ich mich die Tage beschäftigen.

Hallo @march,
und noch einmal: Herzlichen Dank für die Überarbeitung!

Nur weil ich das selbst letztens raussuchen musste: Die Liste der Fehlercodes beinhaltet mehr als bisher in der Tabelle steht. DIe Datei „DFMiniMp3.h“ aus der Bibliothek kennt folgende Fehler:
enum DfMp3_Error
{
// from device
DfMp3_Error_Busy = 1,
DfMp3_Error_Sleeping,
DfMp3_Error_SerialWrongStack,
DfMp3_Error_CheckSumNotMatch,
DfMp3_Error_FileIndexOut,
DfMp3_Error_FileMismatch,
DfMp3_Error_Advertise,
// from library
DfMp3_Error_PacketSize = 0x81,
DfMp3_Error_PacketHeader,
DfMp3_Error_PacketChecksum,
DfMp3_Error_General = 0xff
};
Diese zu kennen, hilft in manchen Situationen. (Entschuldigung für die schreckliche Formatierung)

Wo finde ich denn die überarbeitete Anleitung?

Vielleicht habe ich den Link zur Anleitung in diesem Thread überlesen oder er fiel mir nicht auf.

Ich habe hier einen Link auf eine PDF Datei gefunden, die laut Beschreibung von 03/19 ist und einen Link auf tonuino.de. Der Link „Anleitung“ auf tonuino.de verweist dann jedoch auf die Webseite voss.earth.

Ich habe inzwischen fast alle Teile zusammen und möchte mich demnächst an den Bau eines Tonuinos wagen.

Dann könnte ich die Anleitung gleich ausprobieren und Rückmeldung geben, was mir unklar/zu ungenau war oder was ich nicht hinbekommen habe.

@steren Leider etwas versteckt. Aber der Link befindet sich in diesem Fließtext (der Text ist alt, das verlinkte PDF ist neuer):

Wenn das ganze Dokument mal fertig ist, können wir überlegen das auf tonuino.de zu verlinken.

Als ich den Post schrieb stimmte 03/19 als letztes Bearbeitungsdatum. Beim Edit hatte ich die Passage nicht geändert. Den derzeitigen Stand sieht man im PDF. In der Fusszeile ist dieser zu ersehen. Ich räume den alten Post morgen einmal auf und platziere den Link besser. Mit dem Smartphone ist mir das zu fummelig. Es ist aber noch nicht fertig. Es fehlen u.a. Infos zur Adminkarte, Reset, Debugging, dem Ersteller des Logos… Tippfehler sind ebenfalls enthalten. Sofern ich die Tage die Zeit finde widme ich mich weiter der Anleitung.

Danke für den Hinweis auf die Datei. :slight_smile:

Hi @Dotmatrix,
ich hatte eine ähnliche Idee, wie du, eine Anleitung für die Bedienung des fertigen Tonuino zu schreiben und wollte diese dann auch für alle zur Verfügung stellen.
Was ist aus deinem Vorhaben geworden? Hast du eine Anleitung geschrieben oder ist es bei der Idee geblieben?
Meine Vorstellung wäre es als offenes Word-Dokument zu erstellen, so dass jeder es für sich selbst noch anpassen kann. Von der Formatierung her würde ich es so aufbauen, dass man es als A6 oder A5 - Büchlein drucken kann - also so dass man es auf dem heimischen A4-Drucker ausdruckt und dann schneiden und falten kann…
Ich plane aktuell den ein oder anderen Tonuino zu Weihnachten zu verschenken, habe also noch genügend Zeit bis dahin.

Viele Grüße

Hallo @Colorbirdie,

ich bin gerade zu tiefsten betrübt… Ich hatte genau wie du es sagst eine Anleitung in Word im Format DIN A5 gemacht als Büchlein… Leider habe ich gemerkt, dass ich diese beim Wechsel meines Rechners nicht mitgenommen habe und sie weg ist.

Ich kann aber gerne meinen Bekannten fragen, ob er sie abfotografieren kann, dann hat man zumindest schon mal den Text zusammen und muss es nur nochmal abschreiben.

Würde dir das helfen ?

Viele Grüße

Hi @Dotmatrix,

das ist ja wirklich schade. Aber als Ideenpool nehme ich gern auch den Scan/Fotos. Kannst du mir auch als PN schicken. @Gute_Laune hat sich auch bei mir gemeldet und mir ihre persönliche Version einer solchen Bedienungsanleitung geschickt. Ich mache dann aus beidem meine Version, die ich dann öffentlich stelle.

Grüße

1 „Gefällt mir“

Ich bin gerade dabei eine Bedienungshilfe als interaktive ExelDatei zu erstellen. Da hast du eine Hauptseite, von der alle Funktionen verlinkt sind, so dass du nicht ewig herumnavigieren musst, sondern über den betreffenden Link direkt zur gewünschten Funktion gelangst. Ich habe auch vor diese dann in PDF zu wandeln. Ich hoffe, dass die Links dann noch funktionieren. Muss ich aber erst ausprobieren.

Mal überlegt das ganze in Markdown zu machen? Weil offen und auf reinem Text basierend. Kann jeder immer und überall mit um. Via GitHub (solltest du dir eh anschaffen, im Gegensatz zu code sharing via irgendwelchen cloud drives), dann auch einfach versionier- und hostbar.

1 „Gefällt mir“

Sieht interessant aus. Werde ich mich mal mit beschäftigen.

Hallo @stephan, Hallo @Colorbirdie,

ich habe meine eingescannte Anleitung nun direkt mal auf GitHub hochgeladen und als Markdown umgesetzt. Es ist natürlich eine Anleitung welche sehr individuell ist, da ich sie für einen konkreten Tonuino geschrieben hatte, aber man kann ja ein Ford machen. Ich hoffe es ist in Ordnung, dass ich Thorstens Seite und die Community hier verlinkt habe in der README.md

Viele Grüße
Steffen

1 „Gefällt mir“

Moin zusammen,
kann mir jemand sagen wie ich das Dokument drucken kann was auf Box.com gespeichert ist?
Danke

Inzwischen habe ich meine Anleitung noch ein bisschen erweitert. Mein Ziel war dabei die Anleitung leicht auf verschiedene Bauweisen anpassen zu können, da ich diese Anleitung mit dem TonUINO verschenken will. Die Unterschiede gehen da ja schon beim Einschalten los…
Vielleich mag das ja jemand lesen und mir sagen, ob ich noch etwas vergessen habe oder ob etwas unverständlich ist.
Die Informationen auf der letzten Seite sind bisher nur Ideen, was man als zusätzliche Hinweise geben muss.
Bedienungsanleitung211022.pdf (2,5 MB)

Edit: Jetzt neu mit Hinweis auf den Reset durch drücken der 3 Taster beim Start
Edit2: Jetzt ist auch der KiTa-Modus dabei

6 „Gefällt mir“

Hallo und guten Abend,

evtl. könnte man in die Anleitung noch übernehmen, dass die Tonuino.ino Datei durch doppelklicken auf die Datei automatisch in einem neuen Arduino IDE Fenster geöffnet wird. Ich habe gestern erstmal gesucht und gesucht wie man die Datei im Arduino IDE geöffnet bekommt, dabei war es dann so einfach. Vielleicht ist das aber auch zu kleinlich gedacht und nur meinem absoluten Unverständnis geschuldet, wenn es um Programme etc geht.

Christian

Ich habe auch noch einen Vorschlag:

Vielleicht könnte man Teile als Liste, Tabelle oder Grafik darstellen?!
Manchmal sind solche Darstellungen schneller zu erfassen.
Bspw. die Admin-Untermenüs als nummiererte(?) Liste?
Oder eine (zusätzliche) grafische Bedienungsanweisung wie bspw. das o.g. Cheat Sheet.

In der Übersicht der Bedienung sind doch die Optionen im Adminmenü als Liste. Das sind immer die Überschriften dort. Du kannst an dem Beitrag ja mitarbeiten.