Ready for meeting with Martin

basejumpa · Jun 25, 2024 · a42f131 · a42f131
1 parent 155a530
commit a42f131
Show file tree

Hide file tree

Showing 8 changed files with 102 additions and 23 deletions.
diff --git a/docs/00-preliminary-meeting/index.rst b/docs/00-preliminary-meeting/index.rst
@@ -15,7 +15,9 @@ Was die Schüler in den Jahren 2016 und 2018 gemacht haben, könnt Ihr auf der `
 <https://basejumpa.wordpress.com/2016/07/06/spassmitelektronik2016/>`__ sehen (ganz am Ende der
 Seite).
 
-.. rubric:: Fußnoten
+Um an den Projekttagen gleich durchstarten zu können, schauen wir uns die :ref:`sec-preparation` an.
+
+.. rubric:: Anmerkungen
 
 .. [#] Das tue ich auch sowohl während meiner Arbeitszeit bei `Vitronic
     <https://www.vitronic.com/en-us/corporate-home>`__ als auch in meiner `Freizeit

diff --git a/docs/01-preparation/index.rst b/docs/01-preparation/index.rst
@@ -1,3 +1,5 @@
+.. _sec-preparation:
+
 Vorbereitungen
 ##############
 
@@ -12,10 +14,10 @@ Folgendes braucht jedes Team, um mitarbeiten zu können.
 
 Bringt mit (jedes Team nur 1x):
 
-- Einen Laptop mit Windows 7, 10 oder 11.
+- Einen Laptop mit Windows 7, 10 oder 11 [#]_.
 - Ein passendes Netzteil.
 - Eine Maus
-- Der Computer benötigt mindestens einen "normalen" USB-Anschluss (USB-A).
+- Rechte, auf dem Computer Software und Treiber zu installieren [#]_.
 
 Weiterhin sollte jedes Team mitbringen:
 
@@ -32,11 +34,21 @@ Weiterhin sollte jedes Team mitbringen:
 
 .. figure:: _figures/laptop_accessories.png
 
-    Utensilien für den Laptop
+    Netzteil und Maus für den Laptop
 
 .. figure:: _figures/powerbank.png
 
-    Powerbank
+    Powerbank. Die brauchen wir für den Arduino.
+
+
+.. rubric:: Anmerkungen
+
+.. [#] Der Computer benötigt mindestens einen "normalen" USB-Anschluss (USB-A). Falls Ihr nur einen
+    ganz modernen Computer mit außschließlich USB-C-Anschlüssen habt, dann bringt bitte einen
+    Adapter mit.
+
+.. [#] Man nennt das auch "Administrator-Rechte". Wenn Ihr nicht wisst, ob Ihr die habt, dann schaut
+    hilft auch Kapitel :ref:`sec-admin-rights` weiter.
 
 
 Was Ihr bereitgestellt bekommt
@@ -61,22 +73,31 @@ Unboxing
 
     Geöffnete Box
 
+Die Box enthält:
+
+- Ein kleiner Computer vom Typ "Arduino" ("Mikrocontroller")
+- Ein Steckbrett
+- Kabel zum Verbinden des Arduino mit dem Laptop
+
 .. figure:: _figures/arduino-and-breadboard.png
 
-    Arduino mit Steckbrett
+    Arduino auf Steckbrett und Kabel
+
+- Kabel zum Verbinden des Arduino mit den anderen Bauteilen und den Bauteilen untereinander.
 
 .. figure:: _figures/arduino-and-breadboard-and-cables.png
 
     Arduino mit Steckbrett und Kabel zum Verbinden mit dem Laptop.
 
+Die Box enthält zusätzlich:
 
-.. figure:: _figures/box-content-auxiliary-parts.png
+- Taster ("Buttons") mit farbigen Kappen
+- LEDs in verschiedenen Farben
+- Widerstände passend zu den LEDs
 
-    Caption
-
-.. figure:: _figures/leds-and-buttons.png
+.. figure:: _figures/box-content-auxiliary-parts.png
 
-    Caption
+    Die weiteren Teile in der Box
 
 
 ... für die Projektphase

diff --git a/docs/02-training-phase/03-infos-an-computer.rst b/docs/02-training-phase/03-infos-an-computer.rst
@@ -1,6 +1,8 @@
 3. Übung: Text und Zahlen an Computer übermitteln
 #################################################
 
+.. figure:: _figures/03-infos-an-computer.png
+
 Über die USB-Schnittstelle können Computer und Arduino auch mit einander reden. Wir tun dies hier nur in eine Richtung: Der Arduino soll dem Computer ein paar Infos rüber schicken.
 
 Für diese Übung ist es egal, ob und welche Schaltung auf dem Steckbrett ist, da wir keinerlei Pins des Arduinos verwenden.
@@ -52,5 +54,3 @@ Der erste Bereich hat drei Teile, die voneinander mit Semikolons getrennt sind.
 - Der dritte Teil wird nach (nicht vor!) jeder Schleife ausgeführt.
 
 Wenn wir den seriellen Monitor uns anschauen sehen wir nun, anstelle der Hallos, Zahlen die von 0 bis 99 gehen und dann wieder bei 0 anfangen. Wenn wir den seriellen Monitor schließen und dafür den seriellen Plotter aufmachen, sehen wir die Zahlen als Graph aufgetragen. Dabei ist die y-Achse die Zahl(en), die x-Achse ist die Zeit. Diese Form nennt man übrigens „Sägezahn“.
-
-.. figure:: _figures/03-infos-an-computer.png
diff --git a/docs/02-training-phase/06-servo-ansteuern.rst b/docs/02-training-phase/06-servo-ansteuern.rst
@@ -3,17 +3,20 @@
 
 Wir steuern jetzt einen Servo an. Solche Servos werden in ferngesteuerten Modellen verwendet, für die Lenkung zum Beispiel.
 
-Den Servotyp, den wir verwenden kann Positionen zwischen 0° und 180° annehmen. Er sieht etwas anders aus als auf der folgenden Darstellung und die Farben der drei Kabel sind anders. Zwei der Kabel (braun und rot) dienen der Spannungsversorgung und das dritte, orange Kabel ist die Steuerleitung. Über die Steuerleitung bekommt über Spannungspulse der Servo mitgeteilt, welchen Winkel er anfahren soll.
+Den Servotyp, den wir verwenden kann Positionen zwischen 0° und 180° annehmen. Er sieht etwas anders
+aus als auf der folgenden Darstellung und die Farben der drei Kabel sind anders. Zwei der Kabel
+(braun und rot) dienen der Spannungsversorgung und das dritte, orange Kabel ist die Steuerleitung.
+Über die Steuerleitung bekommt über Spannungspulse der Servo mitgeteilt, welchen Winkel er anfahren
+soll.
+
+.. figure:: _figures/06-servo-ansteuern.png
 
 Wir müssen die Kabel wie folgt mit dem Arduino (über das Steckbrett) verbinden. Dazu nehmen wir als Zwischenkabel unsere normalen Steckbrett-Kabel:
 
 - Rotes Kabel an 5V
 - Braunes Kabel an GND
 - Oranges Kabel an D5
 
-.. figure:: _figures/06-servo-ansteuern.png
-
-
 Folgendes Programm passt zu der Schaltung und bewegt jede Sekunde den Servo auf eine der Positionen
 0°, 90° und 180°.
 

diff --git a/docs/02-training-phase/10-auf-schalter-reagieren-egal-wo-program.rst b/docs/02-training-phase/10-auf-schalter-reagieren-egal-wo-program.rst
@@ -1,9 +1,7 @@
 10. Übung: Auf Schalter reagieren, egal wo das Programm ist
 ###########################################################
 
-Todo: Beschreibung
-
-Siehe https://www.arduino.cc/en/Reference/AttachInterrupt
+.. todo:: Füge Beschreibung hinzu. Siehe [#]_.
 
 .. code-block:: cpp
 
@@ -25,3 +23,7 @@ Siehe https://www.arduino.cc/en/Reference/AttachInterrupt
     void schalte() {
         licht = !licht;
     }
+
+.. rubric:: Anmkerungen
+
+.. [#] Siehe https://www.arduino.cc/en/Reference/AttachInterrupt
diff --git a/docs/02-training-phase/99-fehlende-uebungen.rst b/docs/02-training-phase/99-fehlende-uebungen.rst
@@ -0,0 +1,13 @@
+Fehlende Übungen
+################
+
+Die Übungen zu den Fähigkeiten
+
+- Sirene ansteuern
+- Abststand einlesen
+- Motor ansteuern
+- Daten+Signale in Richtung Benutzer -> PC -> Arduino
+
+fehlen noch.
+
+.. todo:: Füge die noch fehlenden Übungen hinzu
diff --git a/docs/02-training-phase/index.rst b/docs/02-training-phase/index.rst
@@ -10,7 +10,7 @@ Am Ende des Trainings habt Ihr einen Baukasten von Fähigkeiten, die Ihr für Eu
 
 .. figure:: _figures/skills.png
 
-    Baukasten der Fähigkeiten
+    Baukasten der Fähigkeiten [#]_
 
 .. toctree::
     :maxdepth: 1
@@ -25,3 +25,8 @@ Am Ende des Trainings habt Ihr einen Baukasten von Fähigkeiten, die Ihr für Eu
     08-lichtsensor-steuert-led
     09-toggle-schalter-mit-bibliothek
     10-auf-schalter-reagieren-egal-wo-program
+    99-fehlende-uebungen.rst
+
+.. rubric:: Anmerkungen
+
+.. [#] Die mit :kbd:`VIN` gekennzeichneten Fähigkeiten benötigen eine stärkere Stromquelle, als die der Arduino selbst darstellt. Dazu benötigen wir die Erweiterung auf dem Steckbrett und die Powerbank.
diff --git a/docs/99-appendix/index.rst b/docs/99-appendix/index.rst
@@ -5,5 +5,38 @@ Anhang
 Hilfestellungen
 ***************
 
-Prüfen, ob ich Administratorenrechte habe
-=========================================
+.. _sec-admin-rights:
+
+Administrator-Rechte
+====================
+
+Administrator-Rechte sind notwendig, um Software und Treiber zu installieren, Systemeinstellungen zu
+ändern und vieles mehr. Um zu prüfen, ob Sie über Administrator-Rechte verfügen, gehe wie folgt vor:
+
+Die Beschreibung passt auf Windows 10. Bei anderen Windows-Versionen kann die Beschreibung abweichen.
+
+Prüfen, ob Du Administratorenrechte hast
+----------------------------------------
+
+1. Klicke auf das Windows-Symbol in der Taskleiste.
+2. Klicke auf das Benutzer-Symbol.
+3. Klicke auf Deinen Benutzernamen.
+4. Prüfe, ob unter Deinem Benutzernamen "Administrator" steht.
+5. Wenn unter Deinem Benutzernamen "Administrator" steht, hast Du Administratorenrechte.
+
+
+Administrator-Rechte erhalten
+-----------------------------
+
+Wenn Du keine Administratorenrechte hast, kannst Du diese von einem Benutzer mit
+Administratorenrechten erhalten. Gehe dazu wie folgt vor:
+
+1. Klicke auf das Windows-Symbol in der Taskleiste.
+2. Klicke auf das Benutzer-Symbol.
+3. Klicke auf "Abmelden".
+4. Melde Dich mit einem Benutzerkonto an, der über Administratorenrechte verfügt.
+5. Klicke auf das Windows-Symbol in der Taskleiste.
+6. Klicke auf das Benutzer-Symbol.
+7. Klicke auf "Abmelden".
+8. Melde Dich mit Deinem Benutzerkonto an.
+9. Du hast jetzt Administratorenrechte.