updated

AGENTS.md

@@ -30,6 +30,9 @@ Aktueller Stand und offene Pi-Prüfungen stehen am Anfang von `PLAN.md`.
 - Klein anfangen: einen vollständigen Effektablauf zuverlässig umsetzen,
   anschließend zusätzliche Effekte ergänzen.
 - Dokumentation übersichtlich halten; diese Datei unter 400 Zeilen halten.
+- Aufbereitete Doku-Fotos separat als `*_DOKU.png` speichern und als
+  KI-bearbeitet kennzeichnen. Originalfotos erhalten und direkt verlinken;
+  technische Anschlussprüfungen auf Originale und echtes Gerät stützen.
 - Im lokalen Git Code, Planung und bearbeitbare Blender-Szenen versionieren;
   Renderdateien, Referenzclip, `.venv` und `data/` bleiben unversioniert.
 - Gitea-Ziel für dieses Projekt: `https://gitea.fritz.box/marcinator_2/Halloween`;

PLAN.md

@@ -3,6 +3,17 @@
 
 ## Aktueller Stand · 16. Oktober 2026
 
+- Doku-Fotos: drei separate `*_DOKU.png`-Ansichten mit neutralem Hintergrund
+  und Bildunterschriften erstellt und in `VERDRAHTUNG.md` eingebunden;
+  Gestaltung visuell geprüft. Unveränderte Originale bleiben direkt verlinkt.
+  KI-Ansichten dienen der Darstellung, nicht der technischen Anschlussprüfung.
+- README mit anklickbarer Bilderübersicht und direktem Einstieg in die
+  bebilderte Aufbau-/Anschlussanleitung ergänzt. `VERDRAHTUNG.md` Revision 15
+  führt schrittweise zu Anschlusslisten, Erstprüfung und Aufbauprotokoll;
+  elektrischer Entwurf unverändert. Bildpfade und Abschnittsverweise geprüft.
+- README-Vorschau: HTML-Vorschaubilder in einer Tabelle wurden laut Nutzer
+  nur als Links angezeigt. Durch normale Markdown-Bilder untereinander ersetzt;
+  Dateipfade geprüft, Darstellung in der Nutzervorschau noch zu bestätigen.
 - Implementiert: getrennte Grab-/Kameraseiten, Farbpunktwahl, manuelle
   Servoeinrichtung, vier Endpunktkarten sowie numerische Bewegungs- und
   Einrichtgrenzen pro Achse. Bedienung in [SOFTWARE.md](SOFTWARE.md).
@@ -34,7 +45,7 @@
   Endpunkte, Versorgung und Stoppverhalten am Aufbau prüfen und dokumentieren.
 - Breites responsives Layout lokal umgesetzt: Bild/Steuerung nebeneinander,
   Details aufklappbar. UI-Prüfungen siehe Abschnitt vom 16. Oktober unten.
-- Anschlussplan Revision 14; Softwareänderungen erfordern keine neue Verdrahtung.
+- Anschlussplan Revision 15 (Dokumentationsaufbereitung); Softwareänderungen erfordern keine neue Verdrahtung.
 
 Die folgenden datierten Abschnitte dokumentieren auch frühere Zwischenstände.
 Bei abweichenden Grenzen oder Bedienabläufen gilt der aktuelle Stand oben.

README.md

@@ -3,6 +3,30 @@
 Raspberry-Pi-Projekt für eine Halloween-Grabattrappe mit Kamera,
 Weboberfläche und geplantem Effektablauf.
 
+## Aufbau in Bildern
+
+**Raspberry Pi 5 mit vier Steuerleitungen**
+
+![Raspberry Pi 5 mit vier Steuerleitungen](RASPI_VERKABELT_DOKU.png)
+
+**PCA9685 – Servosteuerung**
+
+![PCA9685-Servosteuerung](PCA9685_DOKU.png)
+
+**Servo- und Steueranschlüsse**
+
+![Servo- und Steuerstecker am PCA9685](PCA9685_VERKABELT_DOKU.png)
+
+Hintergrund und Darstellung sind
+KI-bearbeitet; die unveränderten Originale sind in der Anleitung verlinkt.
+
+Die **[bebilderte Aufbau- und Anschlussanleitung für Kamera und Schwenkarm](VERDRAHTUNG.md)**
+enthält Bauteile, Kabelfarben, Pi-Pins, Servoversorgung und die Schritte zur
+Erstprüfung. Sie dokumentiert den aktuellen Anschlussentwurf; offene
+Hardwareprüfungen sind dort gekennzeichnet.
+
+## Software und aktueller Stand
+
 Die erste Softwareversion bietet ein Picamera2-Livebild, einen Demo-Feed,
 gespeicherte Moduswahl, einen simulierten Effektablauf sowie eine lokale
 SQLite-Datenbank für Ereignisse und manuell zugeordnete Profile. Optional

VERDRAHTUNG.md

@@ -1,12 +1,23 @@
-# Verdrahtung von Kamera und Schwenkarm
+# Aufbau- und Anschlussanleitung: Kamera und Schwenkarm
 
-Stand: 15. Oktober 2026 · Revision 14 · Anschlussentwurf
+Stand: 16. Oktober 2026 · Revision 15 · Anschlussentwurf
 
 Dieser Plan dokumentiert Pi 5, Camera Module 3 NoIR und die beiden
 Kameraservos am vorhandenen PCA9685. Er dient später auch dem Wiederaufbau.
 Die Kanalnamen sind ab jetzt fest geplant; die tatsächlich gesteckten Kabel
 werden erst nach Abgleich mit der Platine als geprüft eingetragen.
 
+## Schrittweise durch den Aufbau
+
+1. [Vorhandene Geräte und Versorgung abgleichen](#geräte-und-feste-kennungen).
+2. [PCA9685 und Anschlüsse auf den Fotos ansehen](#foto-der-vorhandenen-platine).
+3. [Die vier Steuerleitungen zwischen Pi und PCA9685 zuordnen](#pi-mit-dem-pca9685-verbinden).
+4. [Servoanschlüsse und separate Versorgung planen](#servoenergie-und-stecker).
+5. [Kamerakabel und Bewegungsreserve prüfen](#kamerakabel).
+6. [Erstprüfung durchführen](#erstprüfung-und-betrieb) und danach
+   [Bewegungsgrenzen einrichten](#endpunkte-ohne-endschalter-einrichten).
+7. Ergebnisse im [Aufbauprotokoll](#protokoll-für-den-tatsächlichen-aufbau) festhalten.
+
 **Vor dem Anschließen fehlen noch die Ausgangsdaten des vorgesehenen
 Servonetzteils und die Prüfung der Servokabel.** Das PCA9685-Foto liegt jetzt vor. Die Zeichnung zeigt
 elektrische Verbindungen, keine maßstäbliche Anordnung der Steckkontakte.
@@ -32,7 +43,14 @@ Anlaufen beider Servos Spannung und Verhalten kontrollieren.
 
 ## Foto der vorhandenen Platine
 
-![Vorhandenes PCA9685-Modul](PCA9685_FOTO.jpg)
+Die folgenden Doku-Bilder wurden mit KI aufbereitet: neutraler Hintergrund,
+engerer Ausschnitt und Bildunterschriften. Feine Aufdrucke und Details können
+abweichen. Für Anschlussprüfungen gelten die jeweils verlinkten Originalfotos
+und der Abgleich am echten Gerät.
+
+![Vorhandenes PCA9685-Modul – bearbeitete Doku-Ansicht](PCA9685_DOKU.png)
+
+[Unverändertes Originalfoto der Platine](PCA9685_FOTO.jpg)
 
 Foto vom Nutzer, 15. Oktober 2026. Aufdruck: PCA9685, 16 Kanäle,
 12-Bit-PWM. Die Logikanschlüsse sind GND, OE, SCL, SDA, VCC und V+
@@ -43,7 +61,9 @@ ablesbar; vor Versorgung am Board prüfen.
 
 ## Foto der gesteckten Anschlüsse
 
-![PCA9685 mit Servo- und Steuersteckern](PCA9685_VERKABELT_FOTO.jpg)
+![PCA9685 mit Servo- und Steuersteckern – bearbeitete Doku-Ansicht](PCA9685_VERKABELT_DOKU.png)
+
+[Unverändertes Originalfoto der Modulanschlüsse](PCA9685_VERKABELT_FOTO.jpg)
 
 Nutzerfoto vom 15. Oktober 2026, laut Nutzer ohne angeschlossene
 Servoversorgung. Die sichtbare Steckrichtung der beiden Servostecker am
@@ -57,7 +77,9 @@ Funktionsprüfung. Schraubklemmenpolung und Versorgung bleiben zu prüfen.
 
 ## Foto der gesteckten Pi-Pins
 
-![Pi 5 mit den vier Steuerleitungen](RASPI_VERKABELT_FOTO.jpg)
+![Pi 5 mit den vier Steuerleitungen – bearbeitete Doku-Ansicht](RASPI_VERKABELT_DOKU.png)
+
+[Unverändertes Originalfoto der Pi-Anschlüsse](RASPI_VERKABELT_FOTO.jpg)
 
 Nutzerfoto vom 15. Oktober 2026. Soweit auf dem Foto erkennbar: W01 Grün an
 Pin 1, W02 Blau an Pin 3 und W03 (auf dem Foto violett wirkend, im Plan Braun)
@@ -242,6 +264,7 @@ zusätzlich durch das oben abgelegte Nutzerfoto dokumentiert.
 
 | Datum | Revision | Änderung |
 | --- | --- | --- |
+| 16.10.2026 | 15 | Bebilderte Aufbau- und Anschlussanleitung mit Schrittübersicht; drei KI-bearbeitete Doku-Ansichten mit Originalverweisen, Bilderübersicht in der README. Elektrischer Anschlussentwurf unverändert. |
 | 15.10.2026 | 1 | Kameraentwurf angelegt; PAN=CH0, TILT=CH1 geplant; Board, Versorgung und echte Verdrahtung offen |
 | 15.10.2026 | 2 | Echtes Boardfoto abgelegt; Anschlussbeschriftung und gelbe/rote/schwarze Reihen erfasst; Netzteil und praktische Prüfung bleiben offen |
 | 15.10.2026 | 3 | W01 Grün, W02 Blau, W03 Braun, W04 Grau nach Nutzerkabeln in Liste und Zeichnung eingetragen |