Auto-sync: 2026-11-20

This commit is contained in:
Dominik Schön
2026-11-20 22:00:22 +00:00
parent 7090b022c7
commit 9927bbc02a
10 changed files with 308 additions and 11 deletions
+68
View File
@@ -0,0 +1,68 @@
# Snapmaker U1 (3D-Drucker)
**Modell:** Snapmaker U1 (4-Toolhead, Klipper/Moonraker) · **Netz:** 10.0.40.98 (WLAN, VLAN 40)
**Stand:** 2026-11-20 — Kamera in Home Assistant eingebunden
## Zugänge
- **Web-UI (Fluidd):** `http://10.0.40.98` (nginx)
- **Moonraker-API:** `http://10.0.40.98:7125` — **kein Token nötig**: `[authorization] trusted_clients` enthält `10.0.0.0/8`
- **moonraker.conf:** lesbar über `GET /server/files/config/moonraker.conf` (kein `[webcam]`-Block — Webcam liegt in der Moonraker-DB, `source: database`)
- **Stock-Firmware:** kein SSH. Erweiterte Firmware (paxx12, WebRTC/SSH) existiert, ist aber **nicht** installiert (Firmware-Eingriff nur mit Owner-GO).
## Kamera — Verhalten (wichtig)
- Einziges funktionierendes Bild: **`GET /server/files/camera/monitor.jpg`** (1920×1080 JPEG, ~80 KB, ~3 fps)
- `/webcam/?action=stream` und `?action=snapshot` → **502** (kein mjpegstreamer auf dem Printer; die Moonraker-Webcam `cam` zeigt deshalb auf tote URLs)
- **Die Kamera schläft ein**: ohne aktives Monitoring bleibt `monitor.jpg` eingefroren (mtime steht). Aufwecken nur per Moonraker-WebSocket:
`{"jsonrpc":"2.0","method":"camera.start_monitor","params":{"domain":"lan","interval":0}}` — alle ~5 s wiederholen, sonst fällt sie nach kurzer Zeit zurück.
- Antwort-Notify: `notify_camera_status_change {monitoring: true|false}`
## Bridge auf hermes-agent-01 (10.0.30.230)
- **Datei:** `/home/debian/scripts/snapmaker_u1_cam.py` · **Service:** `snapmaker-u1-cam.service` (systemd, `enabled`, `Restart=always`)
- **Zweck:** hält die WS-Keepalive-Verbindung (5 s) und liest `monitor.jpg` mit 3 fps, solange ein Client schaut (sonst 1 Frame / 5 s); re-served als MJPEG + Snapshot.
- **Endpoints** (Port 8099, unauthentifiziert, nur VLAN 30/40):
- `GET /stream.mjpg` — multipart MJPEG, ~2–3 fps
- `GET /snapshot.jpg` — JPEG on demand (`X-Frame-Age`-Header)
- `GET /health` — JSON: `ok`, `frame_age_s`, `frames_received`, `stream_clients`, `ws_connected`, `last_error`
- Logs: `journalctl -u snapmaker-u1-cam.service -f`
## Home Assistant
- **Integration:** MJPEG IP Camera (Core), Entry-Titel „Snapmaker U1"
`mjpeg_url=http://10.0.30.230:8099/stream.mjpg`, `still_image_url=http://10.0.30.230:8099/snapshot.jpg`
- **Entity:** `camera.snapmaker_u1` (State `idle` = normal für MJPEG; Live-View über `camera_proxy_stream`)
- **Dashboard:** View **3D-Drucker** (`/dashboard-haus/drucker`) in `dashboard_haus` — Live-Kamera, Fortschritt/Düse/Bett-Gauges, ETA/Datei/Speed/Filament, Pause/Weiter/Abbruch/Licht. Backup: `lovelace.dashboard_haus.hermesbak-20261120`
- **iOS Live Activity:** Automation `snapmaker_u1_live_activity` — Tag `snapmaker_u1_print`, 5-%-Schritte, Tap öffnet `/dashboard-haus/drucker`, `progress_bar_direction: increasing`, `relevance_score: 1.0` beim Drucken; Completion bleibt, Abbruch cleart.
- **Watchdog:** Hermes-Cron `c97b168a5230` (`check_snapmaker_cam_health.sh`, `*/10 * * * *`, no_agent) — still bei gesund; Alarm nach 15 min (Push an `mobile_app_iphone_dominik`), aber **kein Alarm, wenn der Drucker aus ist** (TCP :7125 unerreichbar ≠ Bridge-Fehler). State: `~/.local/state/snapmaker-cam/watchdog.state`
- **Deaktiviert** (Registry `disabled_by: user`, jederzeit in der UI reaktivierbar):
- `camera.snapmaker_u1_cam` — Moonraker-Webcam `cam` (502, tote mjpegstreamer-URLs)
- `camera.snapmaker_u1_webcam` — Ghost der alten hardcoded Webcam (`restored`, unavailable)
- `camera.snapmaker_u1_thumbnail` bleibt (GCode-Vorschau der Moonraker-Integration)
## Verifikation
```bash
curl -s http://10.0.30.230:8099/health # ok:true, frame_age_s < 5
curl -s -o /tmp/a.jpg http://10.0.30.230:8099/snapshot.jpg && file /tmp/a.jpg
# HA-Sicht:
curl -s -H "Authorization: Bearer $HA_TOKEN" \
http://10.0.30.10:8123/api/camera_proxy/camera.snapmaker_u1 -o /tmp/ha.jpg
```
## Pitfalls
- **HA-Camera-Proxy cached Stills** (~10 s) — zwei `camera_proxy`-Aufrufe kurz hintereinander liefern dasselbe Bild, obwohl die Bridge live ist. Live-Nachweis über `/health` + direkte Relay-Snapshots.
- `monitor.jpg`-mtime ist der einzige Staleness-Indikator (Datei wird bei aktivem Monitor fortlaufend neu geschrieben); nach einem Bridge-Restart kann sie kurz 5–10 s alt sein → `STALE_AFTER=10 s`.
- Der Printer hängt im WLAN (wlan0) — 3 fps × 80 KB ≈ 2 Mbit/s nur während jemand schaut; Idle-Poll ist 1 Frame/5 s.
- Kein Torrent/Cloud-Zugriff nötig; Kamera bleibt im LAN.
## Related
- Wiki: [[systems/homeassistant]]
- Solution Doc: `~/docs/solutions/integrations/2026-11-20-snapmaker-u1-kamera-homeassistant.md`
- Skill: `smart-home-automation` → `references/snapmaker-u1-camera.md`
## Drucker-UI (Fluidd) — Kamera
Die Fluidd-Oberfläche auf `http://10.0.40.98/` hat ein eigenes Cameras-Panel. Es liest dieMoonraker-Webcam aus der **Datenbank** (`source: database`), nicht aus `moonraker.conf`.
- **Eintrag `cam` (aktuell):** `service: mjpegstreamer-adaptive`, `stream_url: http://10.0.30.230:8099/stream.mjpg`,
`snapshot_url: http://10.0.30.230:8099/snapshot.jpg`, `aspect_ratio: 16:9`, `target_fps: 5`, `target_fps_idle: 2`
- **Gesetzt via** `POST http://10.0.40.98:7125/server/webcams/item` (vollständiges Objekt, `uid`/`source` weglassen). Backup des Originals: `~/.hermes/cache/scratch/u1_webcam_backup.json`; Original-URLs `/webcam/?action=stream|snapshot` (502, weil kein mjpegstreamer läuft).
- **Wichtig — CORS:** Fluidd setzt `crossorigin` am `<img>`; die Bridge muss `Access-Control-Allow-Origin: *` senden (seit 20.11. umgesetzt, inkl. OPTIONS 204).
- **Kein Fehler trotz „cam (error)":** Fluidd stoppt die Wiedergabe bei `document.hidden` und leert `src`; das leere `src` lädt die Seiten-URL → `error`. Sobald der Tab sichtbar ist, Status `connected`, `naturalWidth 1920`.
- **Last:** Fluidd pollt `snapshot.jpg` mit `target_fps` (5/s) — die Bridge liefert ~3 fps; `target_fps_idle: 2` wenn das Fenster den Fokus verliert.