diff --git a/AGENTS.md b/AGENTS.md index d4bc40d..72410ea 100644 --- a/AGENTS.md +++ b/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`; diff --git a/PCA9685_DOKU.png b/PCA9685_DOKU.png new file mode 100644 index 0000000..b314fcd Binary files /dev/null and b/PCA9685_DOKU.png differ diff --git a/PCA9685_VERKABELT_DOKU.png b/PCA9685_VERKABELT_DOKU.png new file mode 100644 index 0000000..bfdeda8 Binary files /dev/null and b/PCA9685_VERKABELT_DOKU.png differ diff --git a/PLAN.md b/PLAN.md index de2259f..fadef23 100644 --- a/PLAN.md +++ b/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. diff --git a/RASPI_VERKABELT_DOKU.png b/RASPI_VERKABELT_DOKU.png new file mode 100644 index 0000000..dfbd533 Binary files /dev/null and b/RASPI_VERKABELT_DOKU.png differ diff --git a/README.md b/README.md index 4a58ef8..9e5a9d6 100644 --- a/README.md +++ b/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 diff --git a/VERDRAHTUNG.md b/VERDRAHTUNG.md index 8d9bb36..7ea1c89 100644 --- a/VERDRAHTUNG.md +++ b/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 |