Homelab Miels

This is an old revision of the document!

26.008 Opzetten beveiligingscamera incl. integraties

Aangemaakt: 2026-07-19
Context / Aanleiding:
- Imou Bullet 3 5MP-camera (~€40) opgehangen, gericht op de achtertuin.
- Doel: opname bij beweging, realtime HA-notificatie bij mens-detectie 's nachts/als niemand thuis is, en lampsturing bij mens-detectie met uitzonderingen voor bewust buiten zitten.
- Camera was al gekoppeld aan Surveillance Station via ONVIF vóór start van dit besluit.
Status:
wip
- Praktijktest van de lamp-automations en definitieve opslaglimiet nog te bevestigen

Services	Devices	Netwerk	Tags
	Imou Bullet 3 5MP		camera, homeassistant, surveillance-station

Gekozen optie:
- Surveillance Station (via ONVIF) voor opname bij beweging — dekt scenario 1.
- Twee HA-integraties naast elkaar op dezelfde camera: imou_life (HACS) voor lamp/switch-besturing, ONVIF (core) voor generieke motion-events — dekt scenario 3.
- Scenario 2 (realtime mens-notificatie) is bewust niet gebouwd. De camera dient primair als afschrikking + bewijsmateriaal via NAS-opnames; een melding voegt weinig toe (opname staat toch al vast, hooguit bruikbaar om buren te bellen).
Motivatie:
- Criteria: self-hosted, budgetcamera, betrouwbaarheid boven extra features.
- Overwogen alternatieven voor scenario 2:
  - Officiële core Imou-integratie — te beperkt, geen motion/human-sensoren.
  - imou_life polling / handmatige refresh / webhook-push — alle drie kapot door dezelfde structurele bug (zie Known Issues).
  - Eigen REST-integratie bouwen (buiten om imou_life) — technisch haalbaar maar te zwaar qua onderhoud (eigen tokenbeheer, signature-berekening).
  - Andere/aanvullende camera (Reolink/Tapo) — apart programma van eisen opgesteld, niet meteen uitgevoerd.
- Argumenten: extra bouw-/onderhoudsinspanning voor scenario 2 weegt niet op tegen de beperkte meerwaarde t.o.v. wat er al werkt (opname + afschrikking).

Technisch:
- Twee losse HA-integraties naast elkaar, functioneel gescheiden: imou_life voor switches/lamp/nightvision, ONVIF voor generieke motion.
- Surveillance Station-opnameresolutie moest gecorrigeerd worden (stond op 720p i.p.v. de native 2880×1620-stream) — zie Known Issues.
- Archiefopslag: gedeelde NAS-brede limiet van 200 GB, 30 dagen retentie.
Operationeel:
- imou_life is community-onderhouden met bekende, niet-opgeloste bugs voor dit cameramodel — geen garantie op toekomstige fix.
- Geen actieve monitoring; fouten alleen zichtbaar bij handmatig HA-logs checken.
Risico’s / aandachtspunten:
- Geen realtime alarmering bij een daadwerkelijke indringer — geaccepteerd risico, expliciet heroverwogen als de situatie verandert.
- Toekomstige updates van imou_life of Imou's API kunnen dit besluit beïnvloeden (positief of negatief).

imou_life “Human detection”-switch: kan niet op afstand aan/uit worden gezet voor dit cameramodel (HTTP 500 / API-foutcode 40999) — bekend, gemeld, “wontfix” (GitHub user2684/imou_life issue #139).
imou_life alarm-status ophalen (polling, handmatige “Refresh alarm”-knop, en webhook-push): crasht op `InvalidResponse: time, type, msgType or deviceId not found` — zelfde onderliggende bug, ook gemeld en “wontfix” (issue #107). Treft alle drie de manieren om `binary_sensor.motionalarm` bij te werken.
Push-notificaties/callback-URL: registreert niet bij Imou's cloud voor dit model — apparaat mist de vereiste “Enable Push Notifications”-schakelaar (zelfde bekende beperking als issue #107).
Imou Open Platform app-aanmaak: vereist een “App Type” (bv. “PC Client”) om te kunnen opslaan — ondanks dat dit veld geen rood sterretje/verplicht-label toont in de UI.
Surveillance Station stream-profielen: bij ONVIF-toevoeging kunnen alle kwaliteitsniveaus (Hoog/Gebalanceerd/Laag) per ongeluk aan dezelfde onderliggende camera-stream gekoppeld staan — controleer dit expliciet onder Apparaat → Video na het toevoegen van een camera.

Ervaring:
- Nog in te vullen na praktijkgebruik (lamp-automations nog niet getest in het veld).
Wanneer herbeoordelen:
- Na een week echte Surveillance Station-opslagcijfers.
- Bij aanschaf van een tweede/vervangende camera (zie programma van eisen, apart besproken).
- Als de behoefte aan realtime notificatie terugkeert (bijvoorbeeld na een daadwerkelijk incident).
Aanleiding voor herziening:
- imou_life brengt een fix uit voor dit cameramodel.
- Een nieuwe camera met werkend mens-detectie-signaal in HA wordt aangeschaft.