{"id":4012,"date":"2023-12-11T12:52:41","date_gmt":"2023-12-11T11:52:41","guid":{"rendered":"https:\/\/cbrell.de\/blog\/?p=4012"},"modified":"2023-12-17T21:40:58","modified_gmt":"2023-12-17T20:40:58","slug":"laborberichte-schreiben-anmerkungen-und-hinweise","status":"publish","type":"post","link":"https:\/\/cbrell.de\/blog\/laborberichte-schreiben-anmerkungen-und-hinweise\/","title":{"rendered":"Laborberichte schreiben – Anmerkungen und Hinweise"},"content":{"rendered":"

Die Sammlung meiner Anmerkungen und Hinweise zu den Laborberichten im Mastermodul IoT<\/a> dient dazu zu verdeutlichen, bei welchen Textstellen ich Verbesserungsm\u00f6glichkeiten sehe. Die Sammlung mag insbesondere als Hinweisgeber f\u00fcr die Erstellung von Hausarbeiten dienen.<\/em><\/p>\n

Die Sammlung entstand w\u00e4hrend des Wintersemesters 2023. Zu jeder ersten Ausfertigung eines Laborberichtes gab es eine kurze R\u00fcckmeldung. Die R\u00fcckmeldungen sind hier noch einmal zusammengefasst.\u00a0<\/em><\/p>\n

Beachten Sie auch meine Schreibregeln.<\/a><\/em><\/p>\n

Stand 11.12.2023<\/p>\n

Allgemeine Hinweise zu „Laborberichte schreiben“<\/h2>\n

Die allgemeinen Hinweise sind eher grunds\u00e4tzlicher Natur und gehen nicht auf einzelne Formulierungen ein.<\/p>\n

a) Jeder Bericht sollte f\u00fcr sich allein lesbar sein, ohne dass ein Leser gezwungen ist zum Verst\u00e4ndnis auch einen Vorhergehenden zu lesen.
\nb) Spendieren Sie dem Leser im Anhang den kompletten Quelltext (noch einmal) zusammenh\u00e4ngend und kopierfreundlich. Dann muss jemand, der das nachbauen will, nicht alles abtippen.
\nc) Falls zwei Abbildungsunterschriften gleich sind: Das ist eher ungew\u00f6hnlich.
\nd) Schreiben Sie nichts, was Sie nicht verstehen und auch nicht erkl\u00e4ren k\u00f6nnen, sondern recherchieren Sie vorher so lange, bis Sie es in der Tiefe verstanden haben.
\ne) Bitte spendieren Sie zumindest Ihrer Hausarbeit eine Seitennummerierung \u2026
\nf) Formal: wenn Sie auf Abb. 2 verweisen, sollte diese auch Abb. 2 hei\u00dfen. Hei\u00dft sie Abbildung 2, so verweisen Sie bitte auf Abbildung 2.
\ng) Formal: Orthografie und Grammatik werden bei Ausarbeitungen in der Wirtschaftsinformatik mit bewertet.
\nh) Es gibt keine Zwischen\u00fcberschriften? Auch bei einem kurzen Text lohnt es sich, dem Leser durch eine Strukturierung Orientierung zu geben. Ein Bewertungskriterium ist auch: Wie finde ich mich zurecht?
\ni) Formal: Abbildungen enthalten zwar Abbildungsunterschriften, allerdings stehen sie bezugslos herum und es wird im Text nicht darauf verwiesen. Zudem: F\u00fcr den Leser istz es angenehm, wenn die Abbildungslegenden schon f\u00fcr sich sprechend sind. Was sieht man? Worauf ist zu achten?
\nj) Wof\u00fcr ist Ihr System gut und wie kann ich es benutzen? Die Unterlage sollte diese Frage beantworten.<\/p>\n

Im Detail<\/h2>\n

Die folgenden Anmerkungen beziehen sich jeweils auf einzelne Textstellen in unterschiedlichen Laborberichten.<\/p>\n

1.
\n\u201eDie LEDs werden so angeschlossen, dass ihre Kathode (kurzes Bein) an diese \u00e4u\u00dfere Reihe der Platine angeschlossen wird, w\u00e4hrend die Anode (l\u00e4ngeres Bein) mit den festgelegten Pins des ESP8266 verbunden wird,\u201c
\na) Es w\u00e4re lesefreundlich, wenn die Anschl\u00fcsse hier auch benannt w\u00fcrden \u2013 zus\u00e4tzlich zum Verweis auf den Quelltext.
\nb) Dass das ohne Vorwiderst\u00e4nde funktioniert, ist eher Zufall \u2013 bei anderen Mikrocontrollern funktioniert das nicht. Es k\u00f6nnte ein Satz spendiert werden, warum im speziellen Fall hier die LEDs ohne passende Vorwiderst\u00e4nde nicht sofort durchbrennen.<\/p>\n

2.
\n\u201eDiese k\u00f6nnen entweder direkt am ESP eingesteckt werden, oder wie in Abbildung 1 zu sehen, auf H\u00f6he der entsprechenden Pins. Beachten Sie, dass die Pluspole der LEDs auf H\u00f6he eines Pins sind, da wir die LEDs \u00fcber diese Pinbelegung ansteuern werden. Der Pluspol der LEDs sollte an den Pluspol des ESP8266 angeschlossen werden, w\u00e4hrend der Minuspol an den Minuspol der Steckplatine angeschlossen wird.\u201c
\na) Wo hat der ES8266 denn einen Pluspol? Den Anschluss kenne ich gar nicht.
\nb) Wieso funktioniert das ohne Vorwiderst\u00e4nde? Bei anderen Prozessoren brennen die LED sofort durch \u2026
\nc) Woran erkennt der geneigte Leser den Pluspol einer LED?
\nd) An welchen Pins des ESP (Bezeichnung) werden die LED denn nun genau angeschlossen? Eine genaue Benennung im Text w\u00fcrde dem Leser das Nachbauen erleichtern.<\/p>\n

3.
\n\u201eAbbildung 1: Eigene Abbildung\u201c
\nDas ist ein Bisschen nichtssagend. Eine sprechende Abbildungsunterschrift w\u00e4re g\u00fcnstiger.
\nAllgemein: In wissenschaftlichen Ver\u00f6ffentlichungen ist es oft Usus, die Abbildungslegende schon selbsterkl\u00e4rend auszugestalten, so dass ein Leser schon wei\u00df, um was es sich handelt, ohne den ganzen Text gelesen zu haben. In Publikumszeitschriften l\u00f6sen die Redakteure das mit sogenanten \u201eK\u00e4sten\u201c, in denen sich ein Bild und etwas erkl\u00e4render Text befindet. Wie so etwas beispielhaft aussehen kann, finden Sie hier: http:\/\/bieneviernull.de\/wp-content\/uploads\/2023\/10\/MesselkenWurmBrell2023Temperaturmessungen-im-BienenstockEntomologie-heute-34-SONDERDRUCK.pdf<\/p>\n

4.
\n\u201eWie in der Abbildung 1 zu erkennen, wurden die jeweiligen LED mit den Steckpl\u00e4tzen des ESP8266 verbunden.\u201c
\nDamit ein Leser, der das nachbauen will, nichts falschmacht, w\u00e4re eine Benennung der Anschl\u00fcsse hilfreich, also was wird mit wem verbunden. Eine kleine Tabelle kann schneller zu erfassen sein als l\u00e4ngerer Flie\u00dftext.<\/p>\n

5.
\n\u201eDie Zwischenschaltung der Widerst\u00e4nde ist notwendig, da es ansonsten zu einer erh\u00f6hten Spannung kommen kann\u201c
\nDas ist inhaltlich falsch. Die Widerst\u00e4nde begrenzen nicht die Spannung (an welchen Punkten denn?) sondern den Strom durch \u2026 (welches Bauteil)<\/p>\n

6.
\n\u201eHierf\u00fcr wurde sich am Tutorial, welches auf der Website
\ncbrell.com verlinkt wurde, orientiert.\u201c
\nSo sollten im Master Quellenangaben nicht mehr aussehen. Geben Sie die Quelle direkt an. Die Website cbrell.com existiert nicht. Ich verbuche das bis hierhin als nicht ausreichend sorgf\u00e4ltig.<\/p>\n

7.
\n(I)\u201edrei LED-Lampen in das
\nBoard eingesteckt und mit Widerst\u00e4nden am Minus-Pol angeschlossen\u201c
\nLED sind keine Lampen. An Minuspol von was wurden sie angeschlossen? Ich vermute, ein Leser kann mit dieser Ausf\u00fchrung das Projekt nicht nachbauen.
\n(II)\u201edie rote als auch gr\u00fcne Lampe\u201c
\nEine LED ist keine Lampe.
\n(III)\u201eEs leuchtet nun immer die Lampe, die \u00fcber das erste Verzeichnis angesteuert wird\u201c
\nEine LED ist keine Lampe, auch wenn sie leuchtet. Ein Gl\u00fchw\u00fcrmchen ist auch keine Lampe \u2026<\/p>\n

8.
\n\u201e\u00fcber jeweils ein Kabel an
\ndie Output Pinslots des Arduinos verbunden\u201c
\nWas sind Pinslots? Den Begriff habe ich in diesem Umfeld noch nicht kennen gelernt. Wenn Sie die GPIO meinen \u2026 an welche wird was angeschlossen? Ich vermute, dass das so ein nachbauwilliger Leser nicht nachbauen kann.<\/p>\n

9.
\n\u201eDas Projekt befasst sich mit der Verwendung der im letzten Projekt erarbeiteten Ampel mit dem ESP8266 D1 Mini, dessen LEDs nun in einem deterministischen Chaos angesteuert werden sollen.\u201c
\nEin geneigter Leser ist nun gezwungen, auch den letzten Bericht zu suchen. Es w\u00e4re entgegenkommend, wenn es keinen Verweis sondern \u2013 ganz kurz und knapp \u2013 eine kurze Beschreibung der Ampel g\u00e4be.<\/p>\n

10.
\n\u201eDas Ziel ist es, eine Farbe aus einem Internetverzeichnis auszulesen, die entsprechende LED anzuschalten und abh\u00e4ngig von dieser Farbe eine andere Farbe in ein zweites Verzeichnis zu schreiben.\u201c
\nWas der Leser nun nicht wei\u00df, ist, dass genau das nun auch ein anderes System tut und das gegenseitige Beschreiben eben das Chaos erzeugt\u2026.
\nIn Tabelle 1 wird die Zuordnung zwar erkl\u00e4rt, es wird aber nicht ganz deutlich.<\/p>\n

11.
\n\u201eDie LEDs werden mit ihrer Kathode (kurzes Bein) an dieser \u00e4u\u00dferen Reihe angeschlossen, w\u00e4hrend die Anode (langes Bein) mit den definierten Pins des ESP8266 verbunden werden, die im Steuercode f\u00fcr die Farbsignale zust\u00e4ndig sind\u201c
\nWie k\u00f6nnte man das so beschreiben, dass es einem Leser leicht f\u00e4llt, das nachzubauen, ohne suchen und hin und herklicken zu m\u00fcssen?
\nWieso funktioniert das hier ohne dass die LEDs sofort durchbrennen? Beim Arduino ginge das nicht \u2026<\/p>\n

12.
\n\u201eDiese k\u00f6nnen entweder direkt am ESP eingesteckt werden, oder wie in Abbildung 1 zu sehen, auf H\u00f6he der entsprechenden Pins. Beachten Sie, dass die Pluspole der LEDs auf H\u00f6he eines Pins sind, da wir die LEDs \u00fcber diese Pinbelegung ansteuern werden. Der Pluspol der LEDs sollte an den Pluspol des ESP8266 angeschlossen werden, w\u00e4hrend der Minuspol an den Minuspol der Steckplatine angeschlossen wird.\u201c
\na) Wo hat der ES8266 denn einen Pluspol? Den Anschluss kenne ich gar nicht.
\nb) Wieso funktioniert das ohne Vorwiderst\u00e4nde? Bei anderen Prozessoren brennen die LED sofort durch \u2026
\nc) Woran erkennt der geneigte Leser den Pluspol einer LED?
\nd) An welchen Pins des ESP (Bezeichnung) werden die LED denn nun genau angeschlossen? Eine genaue Benennung im Text w\u00fcrde dem Leser das Nachbauen erleichtern.<\/p>\n

13.
\n\u201eDurch Ver\u00e4nderung des Jumperkabels soll die Farbwahl (gruen = off oder rot = on) \u00fcber einen Webserver ge\u00e4ndert werden.\u201c
\nOk soweit, jedoch: Wird ein Lehrer aufgrund dieses Satzes verstehen, was das System tut und wie das Ganze funktioniert? Ich f\u00fcrchte, der Lehrer und vermutlich auch seine Sch\u00fcler werden es eher nicht verstehen. Vielleicht wollen Sie das noch etwas erl\u00e4utern, eine kleine Skizze ist dabei immer hilfreich.<\/p>\n

14.
\n\u201eDie beiden zuvor durchgef\u00fchrten Praxisversuche\u2026\u201c.
\nInhaltlich stimmt das, aber welche Praxisversuche sind denn genau gemeint? Und in den Referenzen taucht kein Verweis auf die Beschreibung der Praxisversuche auf. Ein Leser hat vermutlich keine Chance, das zu verstehen. Das ist aber der Sinn einer solchen Dokumentation. Eine Dokumentation, wenn sie nicht konsekutiv in einem Schriftenband oder Buch steht, muss f\u00fcr sich alleine lesbar sein.<\/p>\n

15.
\n\u201eF\u00fcr die Simulation des Buttons wurde ein Aufbau von der Seite draeger-it.blog \u00fcbernommen. Dabei wird mittels Jumperkabeln ein Kreislauf zwischen dem 3,3V PIN und einem digitalen PIN mit einem Widerstand zwischen geschaltet (vgl. Draeger 2023).\u201c
\nDas kann man so machen, jedoch ist der Leser nun gezwungen, die Quelle zu lesen, sonst kann er Ihr Projekt nicht nachbauen. Zum Kreislauf: Das ist recht unpr\u00e4zise, wie schaltet man einen Kreislauf? Was l\u00e4uft denn hier im Kreis, die Elektronen? Welche Aufgabe hat denn der Widerstand? Und zwischen welchen Anschl\u00fcssen ist denn der Schalter \u2013 hier Ihr Jumperkabel \u2013 geschaltet?<\/p>\n

16.
\n\u201eAn die Anode jeder LED wird ein Widerstand mit einem Wert von 330 Ohm – 2000 Ohm, die diese mit der Kathode des Steckboards verbindet.\u201c
\nDas ist nicht ganz richtig, ein Breadboard (oder deutsch Steckbrett) hat keine Kathode. Der erste Teil des Satzes hat kein Verb, die Form (Grammatik und Rechtschreibung) wird mit bewertet. Wei\u00df ein Leser, wo die Anode einer LED ist? Eine kleine Erl\u00e4uterung – am besten mit Skizze \u2013 w\u00e4re sicher hilfreich.<\/p>\n

 <\/p>\n

<\/p>\n

Teile diesen Beitrag.<\/div>