Files
memory/entities/snapmaker-u1.md
T
2026-11-20 22:00:22 +00:00

5.8 KiB
Raw Blame History

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

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.
  • 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.