Arduino – dein Einstieg

11Fehlerbehebung

Es wird beim Herumexperimentieren ein Moment kommen, wo nichts funktioniert und du herausfinden musst, wie das Problem zu beheben ist. Fehlerbehebung und Debugging sind die herkömmlichen Methoden mit nur ein paar simplen Regeln, aber die besten Ergebnisse werden durch sorgfältige Arbeit und Beachtung kleinster Details erzielt. Schlau zu sein ist gut – Beharrlichkeit ist wichtiger.

Am wichtigsten ist aber, dass du nicht denkst, du hast versagt! Die meisten Maker, sowohl Amateure als auch Profis, verbringen den Großteil ihrer Zeit mit dem Beheben von Fehlern, die sie selbst gemacht haben. (Klar, wir werden besser beim Finden und Lösen von Problemen, aber wir schaffen auch immer kompliziertere Probleme.)

Je mehr du dich mit Elektronik und dem Arduino beschäftigst, umso mehr wirst du lernen und Erfahrung sammeln, was den Prozess immer weniger mühselig macht. Lass dich nicht von den Problemen entmutigen, die dir begegnen – es ist alles einfacher, als es zunächst erscheinen mag. Je mehr Fehler du machst und korrigierst, desto besser wirst du darin, sie zu finden.

Da jedes Arduino-basierte Projekt sowohl aus Hardware als auch aus Software besteht, gibt es mehr als einen Ort, an dem nachzusehen ist, wenn etwas schiefläuft. Bei der Suche nach einem Bug solltest du auf drei Schienen vorgehen: Verstehen, Vereinfachung und Segmentierung sowie Ausschluss und Gewissheit.

Verstehen

Versuche so gut wie möglich zu verstehen, wie die Teile funktionieren, mit denen zu arbeitest, und wie sie zum fertigen Projekt beitragen sollen. Diese Vorgehensweise erlaubt es dir, eine Methode zu bestimmen, jede Komponente separat zu testen. Wenn du es nicht bereits getan hast, versuche, einen Schaltplan deines Projekts aufzuzeichnen. Das hilft dir, dein Projekt zu verstehen, und es ist auch nützlich, wenn du jemanden um Hilfe bitten musst. Schaltpläne werden im Anhang D besprochen.

Vereinfachung und Segmentierung

Die alten Römer pflegten zu sagen: divide et impera – teile und regiere. Versuche, das Projekt (zumindest geistig, besser noch durch Sketching) in seine Komponenten zu zerlegen, indem du deine Kenntnisse nutzt, und finde heraus, wie genau sich der Wirkungsbereich jeder Komponente oder jedes Teils deines Programms definiert.

Ausschluss und Gewissheit

Teste bei der Untersuchung jede Komponente separat, damit du ganz sicher sein kannst, dass jede für sich funktioniert. Schrittweise wirst du lernen, besser einschätzen zu können, welche Teile eines Projekts ihre Arbeit tun und welche noch wacklig sind. Am besten nutzt du dafür die mitgelieferten Beispiele, da sie eher keine Bugs beinhalten.

Debugging ist der Begriff, der diesen auf Software angewendeten Prozess beschreibt. Der Legende nach wurde er erstmals in den 1940er-Jahren von Grace Hopper verwendet, als Computer überwiegend elektromechanisch waren und einer von ihnen die Arbeit einstellte, weil sich tatsächlich Insekten im Mechanismus verfangen hatten.

Viele der heutigen Bugs sind nicht mehr physisch: Sie sind virtuell und unsichtbar, zumindest teilweise. Deshalb erfordert es einen manchmal langwierigen und langweiligen Prozess, um sie zu identifizieren. Du musst den unsichtbaren Bug austricksen, damit er sich zu erkennen gibt.

Debugging ist ein wenig wie Detektivarbeit. Du hast ein Problem, das es zu klären gilt. Dazu musst du einige Experimente durchführen und Resultate erzielen. Anhand dieser Resultate musst du versuchen, herauszufinden, was zu deiner Problematik geführt hat. Dann musst du einige weitere Experimente durchführen, um zu testen, ob deine Schlüsse korrekt waren oder nicht. Diese Vorgehensweise ist wirklich essenziell.

Testen des Arduino-Boards

Bevor du dich an kompliziertere Experimente heranwagst, ist es weise, die einfachen Dinge zu prüfen, insbesondere dann, wenn sie nicht viel Zeit in Anspruch nehmen. Als Erstes solltest du testen, ob dein Arduino-Board funktioniert. Das allererste Beispiel, Blink, ist immer ein guter Anfang, da du damit wahrscheinlich am vertrautesten bist.

Und da bereits eine LED in deinem Arduino ist, bist du außerdem von keinen externen Komponenten abhängig.

Befolge diese Schritte, bevor du dein Projekt an deinem Arduino anschließt. Wenn du bereits Schaltdrähte zwischen deinem Arduino und deinem Projekt verlegt hast, entferne sie zuerst einmal, notiere aber sorgfältig, wo jeder Draht hingehört.

Öffne das Blink-Beispiel in der Arduino-IDE und lade es auf das Board. Die bordeigene LED sollte in einem regelmäßigen Rhythmus blinken.

Was ist, wenn Blink nicht funktioniert?

Bevor du die Schuld bei deinem Arduino suchst, solltest du bei ein paar Dingen abklären, ob sie in Ordnung sind, so wie Flugzeugpiloten, wenn sie vor dem Start eine Checkliste durchgehen, um sicherzugehen, dass das Flugzeug ordnungsgemäß fliegen wird:

Bekommt dein Arduino Strom – entweder von einem Computer über ein USB-Kabel oder von einem externen Netzgerät? Wenn sich das grüne, mit PWR gekennzeichnete Licht einschaltet, heißt das, dass dein Arduino Strom bekommt. Wenn die LED sehr schwach wirkt, dann stimmt etwas mit der Stromzufuhr nicht.
- –Wenn du einen Computer verwendest, stell sicher, dass der Computer eingeschaltet ist (ja, es klingt blöd, aber das ist schon vorgekommen). Vergewissere dich, dass das USB-Kabel an beiden Enden ganz eingesteckt ist. Probiere ein anderes USB-Kabel. Inspiziere den USB-Port des Computers und den USB-Stecker des Arduino, ob sie beschädigt sind. Probiere einen anderen USB-Port am Computer – oder gleich einen anderen Computer. Wenn du eine Menge USB-Kabel auf deiner Werkbank liegen hast, achte darauf, dass jenes, das an deinem Arduino angeschlossen ist, auch das ist, das am Computer angeschlossen ist (ja, das ist uns schon passiert).

Wenn der Arduino nagelneu ist, könnte die gelbe, mit L gekennzeichnete LED zu blinken beginnen, bevor du das Blink-Beispiel hochgeladen hast. Das ist wahrscheinlich das Testprogramm, das im Werk zum Testen des Boards geladen wurde – das ist okay. Werte das aber nicht als Zeichen, dass du erfolgreich hochgeladen hast. Ändere die delay()-Werte auf 100, um das Blinken zu beschleunigen, und überprüfe, ob du erfolgreich hochladen kannst.

Bestätige, dass der Sketch erfolgreich hochgeladen wurde.
- –Stell sicher, dass du im Tools-Menü das richtige Board gewählt hast. Wenn du beginnst, verschiedene Arduino-Boards zu sammeln, bietet es sich an, sicherzustellen, dass das gewählte Board tatsächlich jenes ist, das du angeschlossen hast.

Sobald du das Blink-Beispiel geladen hast und die LED blinkt, kannst du davon ausgehen, dass dein Arduino die grundlegende Funktionalität aufweist, und dann kannst du zum nächsten Schritt übergehen.

Testen deiner Steckplatinen-Schaltung

Der nächste Schritt ist das Überprüfen auf Kurzschlüsse zwischen 5 V und Masse in deinem Projekt. Verbinde deinen Arduino mittels eines Schaltdrahtes von den 5-V- und Masse-Anschlüssen an den positiven und negativen Schienen der Steckplatine. (Du siehst: Indem wir für dein Projekt nur diese beiden Schaltdrähte verbinden und nicht alle, befolgen wir das Prinzip »Teile und regiere«.) Wenn die grüne PWR-LED erlischt, entferne umgehend die Schaltdrähte. Das bedeutet, dass in deiner Schaltung ein schwerer Fehler vorliegt und du irgendwo einen »Kurzschluss« hast. Wenn das passiert, zieht dein Board zu viel Strom, und die Stromzufuhr wird abgeschaltet, um den Computer zu schützen.

Wenn du dir Sorgen machst, dass du deinen Computer beschädigen könntest, denk dran, dass fast alle Computer die Höhe des Stroms, die ein USB-Gerät ziehen kann, begrenzt. Wenn das Gerät versucht, zu viel Strom zu ziehen, schaltet der Computer sofort die Stromzufuhr zu dem USB-Port ab. Außerdem ist das Arduino-Board mit einer Polyfuse gesichert, einer Einrichtung zum Stromschutz, die sich selbst zurückstellt, wenn der Fehler behoben ist (rückstellende Sicherung).

Wenn du völlig paranoid bist, kannst du das Arduino-Board auch über ein USB-Hub mit eigener Stromversorgung anschließen. In dem Fall, wenn wirklich alles furchtbar schiefläuft, ist es der USB-Hub, der sich verabschiedet, nicht dein Computer.

Wenn du einen Kurzschluss hast, dann musst du den Prozess der »Vereinfachung und Segmentierung« starten. Dabei musst du jeden Sensor und jeden Stellmotor im Projekt durchgehen und jeweils nur einen anschließen, bis du das Teil oder den Anschluss identifizierst, der den Kurzschluss verursacht.

Alternativ bzw. ergänzend kannst du alle deine Schaltdrähte entfernen und deine Schaltung erneut aufbauen. Häufig korrigierst du dabei den Fehler vom ersten Mal unbewusst. Beim zweiten Aufbau deiner Schaltung hast du 100 % mehr Erfahrung!

Der erste Startpunkt ist immer die Stromversorgung (die Anschlüsse von 5 V und Masse). Schau dich um und sorg dafür, dass jeder Teil der Schaltung korrekt Strom bekommt. Der wahrscheinlichste Grund ist, dass ein Schaltdraht an der falschen Stelle sitzt. Andere Ursachen können eine falsche Komponente wie ein Kondensator mit zu geringem Wert oder ein Schalter oder Transistor sein, der 5 V mit Masse verbindet. Weniger wahrscheinlich, aber dennoch möglich ist ein Stück Draht oder eine Schraube, die irgendwo sowohl mit 5 V als auch mit Masse Kontakt hat. Prüfe auch, dass die Polarität an allen polarisierten Komponenten, ICs oder Modulen korrekt ist. Wir haben manche Komponenten erlebt, die sich beim Tausch von 5 V und Masse wie ein Kurzschluss verhalten haben.

Schritt für Schritt vorzugehen und dabei immer nur eine einzelne Änderung nach der anderen durchzuführen – das ist die wichtigste Regel bei der Fehlerbehebung. Diese Regel wurde mir von meinem Schullehrer und ersten Arbeitgeber, Maurizio Pirola, in meinen jungen Kopf eingehämmert. Jedes Mal, wenn ich etwas debugge und das Ganze nicht allzu gut aussieht (und glaub mir, das passiert oft), taucht sein Gesicht vor meinem geistigen Auge auf mit den Worten: »Eine Änderung auf einmal … eine Änderung auf einmal« – und normalerweise funktioniert dann alles. Das ist sehr wichtig, weil du dann wissen wirst, was das Problem behoben hat. (Man verliert schnell den Überblick, welche Änderung tatsächlich das Problem gelöst hat, weshalb es so wichtig ist, immer nur eine auf einmal zu machen.)

– Massimo

Jede Debugging-Erfahrung baut in deinem Kopf eine »Wissensdatenbank« zu Defekten und möglichen Lösungen auf. Und ehe du dich’s versiehst, wirst du zum Experten. Das lässt dich sehr cool wirken, denn sobald ein Neuling sagt: »Das funktioniert nicht!«, schaust du es dir kurz an und hast im Bruchteil einer Sekunde die Antwort parat.

Isolieren von Problemen

Eine weitere wichtige Regel besteht darin, eine zuverlässige Methode zum Reproduzieren eines Problems zu finden. Wenn sich deine Schaltung immer mal wieder komisch verhält, versuche mit allen Mitteln herauszufinden, was die Ursache sein könnte. Passiert es nur, wenn du einen Schalter drückst? Nur wenn eine LED aufleuchtet? Wenn du einen Schaltdraht bewegst? (Viele Probleme werden durch lose Drähte verursacht, die entweder nicht verbinden, wo sie es sollen, oder verbinden, wo sie es nicht sollen.) Versuche, die Schritte zu wiederholen, die das Problem verursachen, achte auf die kleinen Details und nimm nur jeweils eine Änderung auf einmal vor: Passiert es jedes Mal, wenn die LED aufleuchtet, oder nur, wenn du den Schalter drückst, während die LED eingeschaltet ist? Dieser Prozess erlaubt es dir, über die mögliche Ursache nachzudenken. Das ist auch sehr hilfreich, wenn du das Ganze jemand anderem erklären sollst.

Lose Verbindungen lassen sich gemeinhin schlecht aufspüren. Versuche vorsichtig, an verschiedenen Teilen deiner Schaltung herumzuwackeln, und wenn du einen Bereich identifizierst, der zu dem Problem beiträgt, verlangsame das Tempo und wackle an jeweils einem Draht oder einer Komponente herum.

Das Problem so präzise wie nur möglich zu beschreiben ist auch eine gute Möglichkeit, eine Lösung zu finden. Such dir jemanden, dem du das Problem beschreiben kannst – in vielen Fällen fällt einem dann direkt eine Lösung ein. Brian W. Kernighan und Rob Pike erzählen in »The Practice of Programming« (Addison-Wesley, 1999) die Geschichte einer Universität, die »einen Teddybär vor dem Helpdesk sitzen hatte. Studenten mit mysteriösen Bugs wurden aufgefordert, diese zunächst dem Teddy zu erklären, bevor sie mit einem menschlichen Berater sprechen durften«. Wenn du niemanden (auch keinen Teddybär) hast, mit dem du sprechen kannst, fang mal mit einer E-Mail an, in der du dein Problem beschreibst. Das ist keine verschwendete Zeit, denn (a) führt das oft zur Lösung des Problems und (b), wenn du jemanden um Hilfe bitten musst, bist du vorbereitet.

Probleme beim Installieren der Treiber in Windows

Manchmal versagt der Hardware-Assistent beim Aufspüren des korrekten Treibers. In diesem Fall musst du ihm möglicherweise manuell mitteilen, wo sich der Treiber befindet.

Der Hardware-Assistent wird dich zuerst bitten, Windows Update zu prüfen; wähle die Option »Nein, dieses Mal nicht« und klicke auf »Weiter«.

Wähle auf dem nächsten Bildschirm »Von Liste oder einem anderen Verzeichnis installieren« und klicke auf »Weiter«.

Navigiere zu und wähle die Treiberdatei des Uno mit dem Namen ArduinoUNO.inf, die sich im Treiberverzeichnis des Arduino-Software-Downloads befindet (nicht das Unterverzeichnis mit den FTDI-USB-Treibern). Windows schließt die Treiberinstallation von hier aus ab.

Probleme mit dem IDE in Windows

Wenn du beim Doppelklick auf das Arduino-Symbol eine Fehlermeldung erhältst bzw. wenn nichts passiert, versuche einen Doppelklick auf die Datei Arduino.exe als alternative Methode zum Start von Arduino.

Windows-Benutzer könnten auch auf ein Problem stoßen, wenn das Betriebssystem dem Arduino eine COM-Port-Nummer von COM10 oder höher zuweist. Wenn das passiert, kannst du Windows normalerweise überzeugen, dem Arduino eine niedrigere Port-Nummer zuzuweisen, indem (vorübergehend) ein COM-Port mit einer niedrigeren Nummer freigegeben wird.

Öffne zuerst den Gerätemanager durch Anklicken des Startmenüs, Rechtsklick auf Computer (Vista) oder My Computer (XP) und wähle Eigenschaften. Auf Windows XP klicke Hardware an und wähle den Gerätemanager. Auf Vista klicke auf den Gerätemanager (er erscheint in der Aufgabenliste im linken Bereich des Fensters).

Suche nach den seriellen Geräten in der Liste unter Ports (COM & LPT). Finde ein serielles Gerät, das du nicht benutzt, mit der Bezeichnung COM9 oder niedriger. Ein Modem oder ein serieller Port stellt einen guten Kandidaten dar. Klicke rechts und wähle aus dem Menü den Punkt »Eigenschaften«. Wähle dann die Registerkarte »Port-Einstellungen« und klicke auf »Erweitert«. Stell die COM-Port-Nummer auf COM10 oder höher ein, klicke auf OK und klicke dann erneut auf OK, um den Eigenschaften-Dialog zu schließen.

Jetzt tu dasselbe mit dem USB-Serieller-Port-Gerät, das den Arduino repräsentiert, mit einer Änderung: Weise es der COM-Port-Nummer (COM9 oder niedriger) zu, die du gerade freigegeben hast.

Identifizieren des Arduino-COM-Ports in Windows

Schließe deinen Arduino Uno mit einem USB-Kabel an deinem Computer an.

Öffne den Gerätemanager durch Anklicken des Start-Menüs, Rechtsklick auf Computer (Vista) oder My Computer (XP) und wähle Eigenschaften. Auf Windows XP klicke Hardware an und wähle den Gerätemanager. Auf Vista klicke auf den Gerätemanager (er erscheint in der Aufgabenliste im linken Bereich des Fensters).

Suche nach dem seriellen Gerät in der Liste unter Ports (COM & LPT). Der Arduino wird als Arduino Uno erscheinen und einen Namen haben wie COM7, wie in Abb. 11–1 dargestellt.

Auf manchen Windows-Maschinen hat der COM-Port eine höhere Nummer als 9; diese Nummerierung erzeugt einige Probleme, wenn der Arduino versucht, mit ihm zu kommunizieren.

Abb. 11–1Der Windows-Gerätemanager zeigt alle verfügbaren seriellen Ports an.

Weitere Debugging-Verfahren

Bitte jemand anderen, sich dein Projekt anzuschauen. Wir werden unseren eigenen Fehlern gegenüber manchmal blind. Sag dieser anderen Person nicht, welche Verbindungen du beabsichtigt hattest – lass sie bestätigen, dass du den Plan, anhand dessen du gearbeitet hast, korrekt umgesetzt hast. Auf diese Weise lieferst du ihr kein vorgefertigte Meinung dessen, was du beabsichtigt hattest, woraufhin sie den Fehler übersehen könnte. Wenn du keinen Plan vorliegen hast, solltest du einen anfertigen. Natürlich könnte der Plan auch einen Fehler beinhalten – dies wäre dann als Erstes zu überprüfen.

»Teile und regiere« funktioniert auch für Sketches. Speichere eine Kopie deines Sketches und entferne dann nach und nach die Teile deines Sketches, die nichts mit dem Teil zu tun haben, der dir Probleme bereitet. Vielleicht stößt du dabei auf eine unerwartete Interaktion zwischen einem Teil, das korrekt zu funktionieren scheint, und dem Problem. Wenn das dein Problem nicht löst, bietet es immerhin ein minimales Testprogramm, das dein Problem aufzeigt, was es leichter macht, wenn du um Hilfe bittest.

Wenn dein Projekt Sensoren (inklusive Schalter) umfasst, teste jeden einzeln mit den einfachsten entsprechenden Beispielen AnalogReadSerial und DigitalReadSerial, die du unter File Examples 01.Basics AnalogReadSerial/DigitalReadSerial findest.

Wenn ein Sensor versagt, bestätige, dass die Arduino-Eingabe korrekt funktioniert. Trenne deinen Sensor und verbinde einen Schaltdraht vom verdächtigen Eingang direkt zu 5 V und Masse (natürlich nur einen auf einmal), während du AnalogReadSerial oder DigitalReadSerial beobachtest. Du solltest 0 sehen, wenn der Eingang an Masse angeschlossen ist, und 1 oder 1023, wenn der Eingang an 5 V angeschlossen ist.

–Wenn du mehrere Sensoren hast und einer versagt, während andere funktionieren, tausche die Teile der Schaltung (eins nach dem anderen) zwischen dem, das funktioniert, und dem, das versagt, aus und schau, ob das das Problem löst.

Wenn dein Projekt Stellmotoren umfasst, teste jeden einzeln mit den einfachsten entsprechenden Beispielen Blink oder Dimmer. Wenn der Stellmotor versagt, ersetze ihn mit einer LED, um sicherzustellen, dass der Arduino-Ausgang korrekt funktioniert.

Wenn dein Sketch eine Entscheidungsfindung beinhaltet, wie zum Beispiel if-Anweisungen, dann verwende die Funktion Serial.println(), um dir mitzuteilen, was sie tut. Das ist auch in Schleifen hilfreich, um sicherzugehen, dass die Schleife dann startet und stoppt, wann du es erwartest.

Wenn du Bibliotheken verwendest, bestätige anhand der mit ihnen gelieferten Beispiele, dass sie korrekt funktionieren. Wenn du mit einer nicht von Arduino stammenden Bibliothek Probleme hast, schau, ob es ein Forum oder eine andere Online-Community für diese Bibliothek gibt, und tritt ihr bei.

Wenn diese Anregungen nicht helfen oder wenn du ein Problem hast, das hier nicht beschrieben wird, dann suche auf arduino.cc unter »troubleshooting«.

Online Hilfe bekommen

Wenn du nicht weiterkommst, verbringe nicht Tage damit, dich allein im Kreis zu drehen – bitte um Hilfe. Einer der besten Aspekte von Arduino ist seine Community. Du kannst immer Hilfe finden, wenn du dein Problem gut beschreibst.

Gewöhne dir an, Themen oder Punkte auszuschneiden und in eine Suchmaschine einzufügen, um zu sehen, ob jemand darüber spricht. Wenn die Arduino-IDE zum Beispiel eine böse Fehlermeldung ausspuckt, kopiere sie, füge sie in eine Google-Suche ein und schau, was dabei herauskommt. Du musst die Nachricht eventuell in Anführungszeichen verpacken, um zu verhindern, dass die Reihenfolge der Wörter beliebig abgeändert wird. Mach dasselbe mit Teilen des Codes, an dem du arbeitest, oder einfach mit einem bestimmten Funktionsnamen. Wenn du zu viele Ergebnisse erhältst, die nicht wirklich helfen, füge das Wort »Arduino« der Suche hinzu.

Schau dich um: Alles wurde bereits erfunden und irgendwo auf einer Webseite abgelegt. Ich bin überrascht, wie oft etwas, von dem ich annahm, dass es nur mir passiert war, im Internet gut dokumentiert ist, inklusive der Lösung.

Weitere Untersuchungen beginnst du am besten von der Haupt-Website (arduino.cc) aus und schaust unter FAQ; dann begib dich zum Arduino Playground (https://playground.arduino.cc/), einer frei editierbaren Wiki, die jeder Benutzer ändern kann, um zur Dokumentation beizutragen. Das ist mit das Beste an der ganzen Open-Source-Philosophie: Leute tragen Dokumentation und Beispiele von allem bei, was man mit Arduino tun kann. Bevor du ein Projekt startest, such im Playground und du findest bestimmt ein bisschen Code oder einen Schaltplan, um loszulegen.

(Denk darüber nach, der Open-Source-Community etwas zukommen zu lassen: Vielleicht ist dir ein Projekt eingefallen, das du beisteuern könntest, oder eine Lösung, die bisher noch nicht dokumentiert wurde. Es gibt viele Möglichkeiten, deine Arbeit zu veröffentlichen: Arduino Project Hub, Github, Instructables, Facebook, Instragram usw. – es ist wirklich egal, wie du etwas veröffentlichst, Hauptsache, du tust es und dokumentierst es so gut wie möglich mit Code, Schaltplan, Diagrammen usw. Poste nicht nur ein Teaser-Video vom funktionierenden Projekt – erzähl uns, wie du es geschafft hast!)

Wenn du auf diesem Weg immer noch keine Antwort findest, suche im Arduino-Forum (https://forum.arduino.cc/).

Nachdem du alles andere versucht hast, ist es an der Zeit, eine Frage im Arduino-Forum zu stellen. Wähle das korrekte Board für dein Problem: Es gibt verschiedene Bereiche für Software- oder Hardware-Themen und sogar Foren in verschiedenen Sprachen. Wenn du nicht sicher bist, welches Board das richtige ist, poste deine Frage im Project Guidance Board.

Formuliere deinen Post sorgfältig. Gib so viele Informationen wie möglich an und formuliere klar und detailliert. Nimm dir Zeit zur deutlichen und korrekten Beschreibung deines Problems – es ist es wirklich wert. Das zeigt auch, dass du schon so viel wie möglich selbst getan hast und dich nicht auf das Forum verlässt, deine Arbeit für dich zu erledigen. Hier sind ein paar Richtlinien:

Bevor du beginnst, suche nach und lies den Post mit dem Titel »General Guidance and How to use the Forum« (zu Deutsch: Allgemeine Anleitung und wie das Forum zu nutzen ist).

Welches Arduino-Board verwendest du?

Welches Betriebssystem verwendet du für den Betrieb der Arduino-IDE?

Welche Version der Arduino-IDE benutzt du?

Gib eine allgemeine Beschreibung dessen, was du zu tun versuchst. Wenn du unbekannte Teile verwendest, poste Links zu Datenblättern Stopf deinen Beitrag nicht mit irrelevanten Informationen voll, wie das Projektkonzept oder ein Bild des Gehäuses, wenn das mit dem Problem nichts zu tun hat.

Poste den minimalen Sketch und/oder die Schaltung (dafür eignen sich sehr gut Schaltpläne) zur Darstellung deines Problems. (Du hast das beim Debugging gefunden, nicht wahr?) Der Post »How to use this Forum« zeigt dir, wie Code zu formatieren und wie Anhänge einzuschließen sind.

Wenn du das Forum nach vorhandener Hilfe absuchst, achte auf die Kommunikationskultur, insbesondere darauf, wie die Fragen formuliert sind, die gute Hilfe erhalten, im Gegensatz zu jenen, die keine bekommen. Du solltest den Stil jener kopieren, die funktionieren.

Beschreibe genau, was deiner Ansicht nach passieren sollte und was stattdessen passiert. Sag nicht einfach: »Es funktioniert nicht.« Wenn du eine Fehlermeldung bekommst, poste den Fehler. Wenn dein Programm eine Ausgabe anzeigt, poste diese Ausgabe.

Nachdem du nun dein Problem sorgfältig beschrieben hast, geh zurück und revidiere den Betreff. Du brauchst einen Betreff, der das technische Problem zusammenfasst, nicht das Ziel deines Projekts (z. B. »Drücken mehrerer Schalter erzeugt Kurzschluss« und nicht »Hilfe zu Bedientafel für Raumschiff«).

Verwende niemals, wirklich niemals Phrasen wie BITTE LESEN oder DRINGEND!

Denk dran, dass die Anzahl der Antworten, die du erhältst, und wie schnell du sie bekommst, davon abhängt, wie gut du deine Frage formulierst.

Deine Chancen steigen, wenn du Folgendes unter allen Umständen vermeidest (diese Regeln gelten für jedes Online-Forum, nicht nur für die von Arduino):

Eingabe deiner vollständigen Nachricht in GROSSBUCHSTABEN. Das ärgert Leute ungemein, und das ist so, als würde man mit der Tätowierung »Anfänger« auf der Stirn herumlaufen (in Online-Communitys wird die Verwendung von Großbuchstaben als »Geschrei« betrachtet).

Posten derselben Nachricht an verschiedenen Stellen des Forums

Bumpen deiner Nachricht durch Folgekommentare mit der Frage: »Hey, warum antwortet niemand?«, oder, noch schlimmer, einfach nur das Wort »Bump« posten. Wenn du keine Antwort erhalten hast, schau dir deinen Beitrag an. War der Betreff klar? Hast du eine gut formulierte Beschreibung deines Problems geliefert? Warst du freundlich? Sei immer freundlich.

Schreiben von Mitteilungen wie: »Ich will ein Space Shuttle bauen und dabei Arduino verwenden. Wie mache ich das?« Das bedeutet, dass du Leute deine Arbeit für dich machen lassen willst – diese Vorgehensweise findet ein echter Tüftler nicht lustig. Es ist besser, zu erklären, was du bauen möchtest, daraufhin eine bestimmte Frage zu einem Teil des Projekts zu stellen und dann zu schauen, wo das hinführt. Ergänzend zu hilfreichen Antworten bekommst du möglicherweise auch nützliche Anregungen für dein Projekt im Ganzen.

Eine Variation des vorhergehenden Punktes ist, wenn aus der Frage deutlich hervorgeht, dass der Verfasser der Mitteilung für die Arbeit bezahlt wird. Wenn du bestimmte Fragen stellst, helfen Leute gern, aber wenn du sie bittest, all deine Arbeit zu übernehmen (und du das Geld nicht teilst), dann wird die Reaktion wahrscheinlich weniger nett ausfallen.

Posten von Mitteilungen, die verdächtig nach Schularbeiten aussehen und das Forum bitten, deine Hausaufgaben zu erledigen. Lehrer wie wir stromern durch die Foren und geben solchen Schülern eine virtuelle Backpfeife. Regelmäßige Forenbesucher erspähen diese auch mit Leichtigkeit.