Auto-sync: 2026-11-20
This commit is contained in:
@@ -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.
|
||||
Reference in New Issue
Block a user