# 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 ``; 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.