Videozvonek & Ovládání Branky (DS-KV8113-WME1)

Tento dokument popisuje integraci videozvonku s ovládáním branky (bzučák/elektromagnetický zámek).

Hardware

Parametr	Hodnota
Model	DS-KV8113-WME1(C)
IP	`192.168.60.10` (VLAN 60)
Firmware	V2.2.65 (build 231213)
Typ	`villaDoorStation`
Alarm Outputs	2x (COM1, COM2)
Alarm Inputs	4x

Schéma Zapojení

graph LR
    BTN[🔔 Tlačítko Zvonku] --> DS[DS-KV8113]
    DS -->|COM1 Relé| LOCK[🔓 Bzučák / Elektrozámek Branky]
    DS -->|WiFi/PoE| NET[Síť VLAN 60]
    NET --> SC[Scrypted LXC]
    SC -->|HomeKit bridge| HK[Apple HomeKit]
    SC -->|Scrypted addon| HA[Home Assistant]
    HK --> HP[HomePod mini / Home Hub]
    HP --> IP[📱 iPhone]

Svorky na zvonku (COM1 = Dveře 1)

Elektrikáři zapojí bzučák branky na výstupní relé COM1 zvonku:

NC (Normally Closed) / NO (Normally Open) — závisí na typu zámku.
COM (Common) — společný vodič.

[!IMPORTANT]
Zvonek podporuje 2 výstupy (COM1 + COM2). COM1 je nastaven jako electricLock. COM2 je k dispozici pro druhý zámek/relé.

ISAPI API (Ověřeno ✅)

Zvonek komunikuje přes Hikvision ISAPI (HTTP + Digest Auth).

Přihlášení

User: admin
Pass: (viz Bitwarden / .env)
Auth: Digest

Otevření branky (Door 1) 🔓

curl --digest -u admin:PASSWORD \
  -X PUT http://192.168.60.10/ISAPI/AccessControl/RemoteControl/door/1 \
  -d '<RemoteControlDoor><cmd>open</cmd></RemoteControlDoor>'

Trvalé odemčení (AlwaysOpen)

curl --digest -u admin:PASSWORD \
  -X PUT http://192.168.60.10/ISAPI/AccessControl/RemoteControl/door/1 \
  -d '<RemoteControlDoor><cmd>alwaysOpen</cmd></RemoteControlDoor>'

Obnovení normálního režimu

curl --digest -u admin:PASSWORD \
  -X PUT http://192.168.60.10/ISAPI/AccessControl/RemoteControl/door/1 \
  -d '<RemoteControlDoor><cmd>resume</cmd></RemoteControlDoor>'

Kontrola stavu zvonku (Kdo zvoní?)

curl --digest -u admin:PASSWORD \
  http://192.168.60.10/ISAPI/VideoIntercom/callStatus

Vrací:

idle — nikdo nezvoní.
ring — někdo zmáčkl tlačítko.
onCall — probíhá hovor.

Kontrola IO výstupů

curl --digest -u admin:PASSWORD \
  http://192.168.60.10/ISAPI/System/IO/outputs

Integrace se Scrypted

Scrypted (192.168.20.21:10443) komunikuje se zvonkem přes RTSP (video) a ISAPI (events).

Zjištěný problém (2026-03-17)

Oficiální @scrypted/hikvision plugin (v0.0.166) nefunguje pro event listener na doorbelllu:

Doorbell vrací Content-Type: application/xml na /ISAPI/Event/notification/alertStream místo multipart/mixed; boundary=boundary.
Plugin očekává multipart stream → chyba expected boundary but found <?xml.
Navíc doorbell blokuje event listener i pro ostatní kamery (sdílený listen loop).
Workaround: Doorbell odebrán z oficiálního Hikvision pluginu; 6 kamer funguje bez problémů.

Plán integrace (Cesta 1 — Scrypted plugin)

Upgrade FW doorbelllu na V3.7.0 (z V2.2.65) — vyžadováno pluginem
Nainstalovat @vityevato/hikvision-doorbell plugin ve Scrypted
- Nepoužívá broken alertStream, místo toho monitoruje /ISAPI/VideoIntercom/callStatus
- Podporuje DS-KV8113, ring detekci, two-way audio, Lock accessory
- npm: @vityevato/hikvision-doorbell (v2.0.2)
- Vyžaduje FW ≥ v3.7 a audio kodek G.711ulaw
Výsledek v HomeKit:
- Doorbell ring → notifikace s live preview na iPhone/Watch
- Lock accessory → odemknutí branky z Apple Home
- Two-way audio → interkom přes HomeKit

Alternativní cesta (záloha — HA REST)

Pokud FW upgrade nebo plugin nefunguje:

REST sensor v HA pollující /ISAPI/VideoIntercom/callStatus (ring detekce)
REST command v HA pro gate unlock (ISAPI PUT)
HA actionable notification na všechny iPhony
Nevýhody: žádný live preview v notifikaci, žádné two-way audio

HomeKit & Apple Home Hub

Bez home hubu (Apple TV / HomePod): ring notifikace fungují jen lokálně (iPhone vlastníka musí být doma).
S home hubem: ring notifikace pro všechny členy domácnosti, odkudkoli.
Plán: Počkat na nové HomePody/HomePad s 8GB RAM (Apple Intelligence).

Co Scrypted umí (aktuální stav):

✅ Video stream (RTSP → HomeKit Secure Video)
✅ Scrypted NVR (nahrávání, smart detection, timeline)
✅ Doorbell press (ring detekce přes @vityevato/hikvision-doorbell plugin s emulovaným SIP)
✅ HomeKit notifikace (HomePod mini jako Home Hub → ring notifikace pro celou domácnost)
✅ HomeKit Doorbell — spárován jako standalone accessory (ne přes bridge), notifikace na iPhone i Apple Watch
✅ Lock/Unlock — Door Lock 1 spárován v HomeKit jako samostatný accessory (companion k doorbelllu)
❌ Event listener (broken v oficiálním @scrypted/hikvision pluginu — viz výše, nepoužívá se)

Advanced Notifier plugin

Plugin @apocaliss92/scrypted-advanced-notifier — propojení Scrypted → HA:

Exponuje kamery a detekční stavy do HA přes MQTT nebo WebSocket s autodiscovery
Webhooky s ring eventy a dalšími událostmi
Notifikační pravidla (detekce, audio, nahrávání)
Sekvence akcí včetně lock/entry controls
Generování MP4/GIF pro notifikace
Dokumentace: https://advanced-notifier-docs.zentik.app/docs/advanced-notifier

Integrace se Home Assistant

Scrypted addon v HA (koush/ha_scrypted) — prohlížeč kamer (sidebar), nevytváří HA entity.
Advanced Notifier — plánovaný hlavní kanál pro ring eventy, kamerové entity a webhooky do HA.
HA automatizace doorbell_ring — při ring eventu: TTS zvonění na 7 reprácích (~20s) + actionable notifikace na iPhony s možností otevření branky.
HA automatizace doorbell_open_gate_action — reaguje na tap "Otevřít branku" v notifikaci → script.doorbell_open_gate.
Ring detekce do HA běží přes nativní HA rest sensor pollující ISAPI endpoint /VideoIntercom/callStatus (každou 1 s, digest auth — viz rest.yaml):
- sensor.doorbell_call_status — stav idle / ring / onCall.
- binary_sensor.doorbell_ring — callStatus == 'ring', device_class sound. Trigger pro automatizaci zvonění.
- Pozn. (2026-06-14): Tyto entity byly půl dne unavailable — ne kvůli digestu (httpx 0.28.1 digest na core-2026.6.3 ověřeně funguje), ale protože GitOps „Apply Synced Changes" po update-restartu spustil reload_all, který se zasekl na nemocném modbus atrea a nedoreloadoval rest+template doménu. Detaily v docs/decision_log.md.
rest_command.doorbell_open_gate a script.doorbell_open_gate — aktivní pro otevření branky přes ISAPI (digest přes httpx — funkční).

FW Upgrade Plán

Kamery (DS-2CD2746G2-IZS)

Kamera	IP	FW	Stav
Cam 1	192.168.60.11	V5.7.23	✅ Aktualizováno 2026-03-18
Cam 2	192.168.60.12	V5.7.23	✅ Aktualizováno 2026-03-18
Cam 3	192.168.60.13	V5.7.23	✅ Aktualizováno 2026-03-18
Cam 4	192.168.60.14	V5.7.23	✅ Aktualizováno 2026-03-18
Cam 5	192.168.60.15	V5.7.23	✅ Aktualizováno 2026-03-18
Cam 6	192.168.60.16	V5.7.23	✅ Aktualizováno 2026-03-18

Doorbell (DS-KV8113-WME1(C))

Zařízení	IP	Aktuální FW	Cílový FW	Poznámka
Doorbell	192.168.60.10	V3.7.0	V3.7.0	✅ Upgradováno, `@vityevato/hikvision-doorbell` plugin funguje

Postup upgradu

Stáhnout FW soubory (uloženy v tmp/firmware/)
Upgrade kamer hromadně přes ISAPI skript (nebo web UI po jedné)
Po upgradu kamer ověřit event listener v Scrypted (listen loop bez chyb)
Upgrade doorbelllu přes web UI (http://192.168.60.10)
Nainstalovat @vityevato/hikvision-doorbell plugin ve Scrypted
Ověřit ring detekci a gate unlock v HomeKit

Checklist pro elektrikáře (9.2.2026) ✅

[ ] Zapojit bzučák branky na COM1 výstup zvonku (NC/NO + COM).
[ ] Ověřit, že stisknutí zvonku fyzicky rozsvítí LED / zazvoní v domě.
[ ] Otestovat vzdálené odemčení: spustit curl příkaz "Otevření branky".
[ ] Ověřit, že callStatus se změní z idle na ring při stisku tlačítka.
[ ] Ověřit, že po open příkazu se relé sepne a branka otevře.

Testovací Příkazy (Kopíruj & Vlož)

Tyto příkazy spustíte z terminálu Macu (nahraďte PASSWORD):

# 1. Ověření dostupnosti zvonku
curl -s --digest -u admin:PASSWORD http://192.168.60.10/ISAPI/System/deviceInfo | grep model

# 2. Stav zvonění (spustit když někdo zvoní)
curl -s --digest -u admin:PASSWORD http://192.168.60.10/ISAPI/VideoIntercom/callStatus

# 3. OTEVŘÍT BRANKU (Door 1)
curl -s --digest -u admin:PASSWORD \
  -X PUT http://192.168.60.10/ISAPI/AccessControl/RemoteControl/door/1 \
  -d '<RemoteControlDoor><cmd>open</cmd></RemoteControlDoor>'

# 4. Stav IO (ověřit konfiguraci relé)
curl -s --digest -u admin:PASSWORD http://192.168.60.10/ISAPI/System/IO/outputs