Nakavision C1 integrálása Home Assistant rendszerbe: Teljes útmutató

Nakavision C1 integrálása Home Assistant rendszerbe: Teljes útmutató

A Nakavision C1 duplalencsés kültéri okoskamera önállóan, az iCSee mobilalkalmazással is kiváló védelmet nyújt, de a nyílt forráskódú Home Assistant (HA) okosotthon-központtal összekapcsolva válik igazán sokoldalú biztonsági rendszerré.

Miért érdemes integrálni? (A legfőbb előnyök)

• Két lencse egy felületen (Dual-Vision): A felső, fix nagylátószögű lencse és az alsó, forgatható (PTZ) lencse képét egyszerre, egymás mellett látod a Home Assistant dashboardon.
• 100% helyi adatfolyam (Local First): Az ONVIF- és RTSP-protokollok révén a képtovábbítás a helyi hálózaton (LAN) belül marad. Nem terheli az internetkapcsolatot, nincs felhőfüggőség, és a kamerát akár külön IoT VLAN-ba is zárhatod.
• Komplex automatizációk: A kamera eseményei (mozgásérzékelés, emberalak-felismerés) összekapcsolhatók más okoseszközökkel (pl. kapunyitásra a PTZ-lencse a bejáróra fordul, mozgásra felkapcsolnak a kerti lámpák, riasztáskor pillanatképes push-értesítés érkezik a telefonodra a Home Assistant Companion alkalmazáson keresztül).
• NVR- és AI-bővíthetőség: Közvetlenül beköthető helyi rögzítőkbe (Frigate NVR, Agent DVR, Scrypted), lehetővé téve a hardveres gyorsítású helyi objektumfelismerést.
• Díjmentes működés: Nem szükséges havi felhő-előfizetés az élőkép eléréséhez és az automatikus rögzítésekhez.

Előfeltételek és szükséges fájlok

A bekötéshez mindössze néhány hálózati adatra és – a választott módszertől függően – egy minimális konfigurációs fájlra van szükség:

• Statikus (fix) IP-cím: A router DHCP-beállításainál rögzítsd a kamera IP-címét (pl. 192.168.1.120).
• A kamera belépési adatai: Az iCSee alkalmazásban beállított eszközjelszó (alapértelmezett felhasználónév: admin).
• Hálózati portok:
  • RTSP-videófolyam: 554
  • ONVIF-szolgáltatás: 8899 (vagy típusváltozattól függően 80)
  • DVRIP-vezérlés: 34567
• Konfigurációs fájlok:
  • go2rtc.yaml a Home Assistant konfigurációs mappájában (a configuration.yaml mellett) a két lencse alacsony késleltetésű WebRTC-streameléséhez. Ezt a HACS-ból telepíthető közösségi WebRTC Camera integráció által futtatott go2rtc olvassa be (a Home Assistant beépített go2rtc-je saját streameket nem fogad – lásd a 3. lépést).
  • Opcionálisan egy Generic Camera entitás – ehhez nem kell configuration.yaml-bejegyzés: az integrációt grafikus felületen állíthatod be (Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása → Generic Camera), streamforrásként a kamera RTSP-címét megadva.

A telepítés menete lépésről lépésre

1. lépés: A kamera előkészítése az iCSee alkalmazásban

1. Végezd el a kezdeti Wi-Fi- vagy vezetékes (LAN) beállítást az iCSee alkalmazásban.
2. Állíts be egy erős eszközjelszót (ez lesz az RTSP/ONVIF-jelszó is).
3. A kódolási beállításoknál állítsd a videófolyamot H.264 formátumra: a böngészők és a Home Assistant WebRTC-motorja a H.264-et natívan, többletterhelés és késleltetés nélkül játsszák le, a H.265-öt viszont csak egyes böngészők tudják lejátszani.

2. lépés: A kamera csatlakoztatása a Home Assistanthoz

Két fő megoldás közül választhatsz:

A) módszer: Hivatalos ONVIF-integráció (egyszerű, grafikus felületen beállítható)

1. Nyisd meg a Home Assistantban: Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása.
2. Keresd meg az ONVIF-integrációt.
3. Add meg az adatokat:
   Név: Nakavision C1
   Host: a kamera IP-címe (pl. 192.168.1.120)
   Port: 8899 (ha a Home Assistant nem találja a kamerát, próbáld meg a 80-as porttal)
   Felhasználónév: admin
   Jelszó: az 1. lépésben beállított eszközjelszó
4. A Home Assistant automatikusan létrehozza a kameraentitást, a mozgásérzékelő bináris szenzorokat és a PTZ-vezérlést.

B) módszer: iCSee PTZ-integráció (HACS – haladó vezérléshez)

Ha a reflektort, az éjjellátó üzemmódokat és a részletesebb PTZ-funkciókat is közvetlenül a Home Assistantból szeretnéd vezérelni, telepítsd a HACS-ból a közösségi iCSee PTZ-integrációt:

1. A HACS-ban nyisd meg a jobb felső sarokban lévő ⋮ menüt, és válaszd a Custom repositories (egyéni tárolók) pontot. Add hozzá a https://github.com/dbuezas/icsee-ptz címet Integration típussal, majd keress rá az icsee kifejezésre, és töltsd le.
2. A letöltés után indítsd újra a Home Assistantot.
3. A Beállítások → Eszközök és szolgáltatások menüben add hozzá a kamerát a 34567-es porttal és az eszközjelszóval. Így kapcsolóként megkapod a fehér fényű reflektor és az infravörös (IR) szűrő vezérlését is.

3. lépés: Mindkét lencse megjelenítése (go2rtc-konfiguráció)

Mivel a Nakavision C1 két különálló szenzorral rendelkezik, a fix és a forgatható lencse képe külön-külön RTSP-csatornán érhető el. A go2rtc streamkiszolgáló ezekből egy másodpercnél kisebb késleltetésű WebRTC-képfolyamot készít. A Home Assistantba a 2024.11-es verzió óta be van építve a go2rtc, de ebbe a beépített példányba nem vehetsz fel saját streameket, ezért használd a közösségi WebRTC Camera integrációt, amely saját go2rtc-t futtat: töltsd le a HACS-ból, indítsd újra a Home Assistantot, majd add hozzá a Beállítások → Eszközök és szolgáltatások → Integráció hozzáadása menüben.
Ezután nyisd meg (vagy hozd létre) a go2rtc.yaml fájlt a Home Assistant konfigurációs mappájában (a configuration.yaml mellett), add meg a két csatornát, majd indítsd újra még egyszer a Home Assistantot:

streams:
  # Felső fix lencse (fő videófolyam - HD)
  nakavision_c1_fix:
    - rtsp://admin:JELSZO@192.168.1.120:554/user=admin&password=JELSZO&channel=1&stream=0.sdp

  # Alsó, forgatható (PTZ) lencse (fő videófolyam - HD)
  nakavision_c1_ptz:
    - rtsp://admin:JELSZO@192.168.1.120:554/user=admin&password=JELSZO&channel=2&stream=0.sdp

  # Kisebb felbontású videófolyamok (substream) mobilnethez vagy NVR-es detektáláshoz:
  nakavision_c1_fix_sub:
    - rtsp://admin:JELSZO@192.168.1.120:554/user=admin&password=JELSZO&channel=1&stream=1.sdp

Tipp: Ha a kamerád egyszerűsített URL-szintaxisú firmware-rel fut, ez a formátum is működik:
rtsp://admin:JELSZO@192.168.1.120:554/live/ch0 (1. lencse) és rtsp://admin:JELSZO@192.168.1.120:554/live/ch1 (2. lencse).

4. lépés: Dashboard- és automatizációs példa

Helyezd egymás mellé a két lencse képét a dashboardon (pl. egy Grid kártyában), vagy használd a WebRTC Camera kártyát PTZ-vezérlőgombokkal. A példákban szereplő entitásazonosítókat cseréld le azokra, amelyeket a Home Assistant a saját kamerádhoz hozott létre (Beállítások → Eszközök és szolgáltatások → Entitások):

type: grid
columns: 2
square: false
cards:
  - type: picture-glance
    title: Fix nagylátószögű
    camera_image: camera.nakavision_c1_fix
    entities: []
  - type: picture-glance
    title: Forgatható (PTZ)
    camera_image: camera.nakavision_c1_ptz
    entities:
      - binary_sensor.nakavision_c1_cell_motion_detection

Példa riasztási automatizációra (YAML):

alias: "Kerti mozgás - lámpák felkapcsolása"
triggers:
  - trigger: state
    entity_id: binary_sensor.nakavision_c1_cell_motion_detection
    to: "on"
conditions:
  - condition: state
    entity_id: sun.sun
    state: below_horizon
actions:
  - action: light.turn_on
    target:
      entity_id: light.kerti_vilagitas
  # Ezt cseréld le a telefonod értesítési műveletére (Home Assistant Companion alkalmazás):
  - action: notify.mobile_app_telefonom
    data:
      message: "A Nakavision C1 kamera mozgást észlelt!"
      data:
        # Androidon pillanatkép; iPhone-on ehelyett ezt használd: entity_id: camera.nakavision_c1_fix
        image: /api/camera_proxy/camera.nakavision_c1_fix

Hibaelhárítási tippek

1. Szürke kép vagy lassú betöltés: Állítsd a kamerát az iCSee alkalmazásban standard H.264-es kódolásra a H.265AI (intelligens tömörítés) helyett. A böngészők a H.264-et natívan, hardveresen és késleltetés nélkül dekódolják.
2. Az ONVIF-integráció nem látja a második lencsét: Az egychipes, duplalencsés rendszereknél a kamera ONVIF-szolgáltatása gyakran csak az első médiaprofilt (1. lencse) teszi elérhetővé. A 2. lencsét a fent bemutatott go2rtc.yaml fájlban, a channel=2 paraméterű RTSP-címmel adhatod hozzá, majd a WebRTC Camera kártyával jelenítheted meg (url: nakavision_c1_ptz), vagy ezzel az RTSP-címmel Generic Camera entitásként is felveheted.
3. Elakadó PTZ-parancsok: Ellenőrizd, hogy a router nem blokkolja-e a 34567-es helyi port forgalmát a Home Assistant és a kamera között.