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

69 lines
5.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.