Hikvision Next
The Home Assistant integration for Hikvision NVRs and IP cameras. Receives and switches detection of alarm events.
Features
- Camera entities for main and sub streams
- Real-time Acusense events notifications through binary sensors and HA events (hikvision_next_event)
- Switches for Acusense events detection
- Switches for NVR Outputs
- Holiday mode switch (allows to switch continuous recording with appropriate NVR setup)
- Tracking Alarm Server settings for diagnostic purposes
- Basic and digest authentication support
Supported events
- Motion
- Video Tampering
- Video Loss
- Scene Change
- Intrusion (Field Detection)
- Line Crossing
- Region Entrance
- Region Exiting
- NVR Input Triggers
NOTE Events must be set to alert the surveillance center in Linkage Action for HA to be notified. An attribute on the event switch shows if this is set.
Preview
The scope supported features depends on device model, setup and firmware version.
Installation
With HACS
- This integration you will find in the default HACS store. Search for
Hikvision NVR / IP Camera
onHACS / Integrations
page and pressDownload
button - on
Settings / Devices & Services
page press+ Add Integration
- Search for
Hikvision NVR / IP Camera
and add your Hikvision device using config dialog, repeat the last 2 steps for more devices
Manual
- copy
custom_components/hikvision_next
folder intoconifg/custom_components
- restart Home Assistant
- on
Settings / Devices & Services
page press+ Add Integration
- search for
Hikvision NVR / IP Camera
and add your Hikvision device using config dialog, repeat the last 2 steps for more devices
Hikvision device setup checklist
- Network settings
- enabled ISAPI access
- User Management - create user with permissions:
- Remote: Parameters Settings
- Remote: Log Search / Interrogate Working Status
- Remote: Live View
- Events
- Notify Surveillance Center
- Regions if needed
- Arming Schedule
- Storage Schedule Settings - set continuous recording in Holiday mode for desired cameras
- Alarm Server - IP address of Home Assistant instance for event notifications. Can be set manually or by this integration if checked
Set alarm server
checkbox in the configuration dialog. It will be reverted tohttp://0.0.0.0:80/
on integration unload.
Reporting issues
There are a lot of Hikvision devices with different firmawers in the world. In most cases logs are crucial to solve your problem, so please attach them to the report. Keep in mind that logs include MAC addresses, serial numbers and local IP addresses of your devices. Consider using pastebin.com or similar services for sharing logs.
You can also download a diagnostic output to provide essential information about your device. This redacts all sensitive data and can be provided in the github issue.
Setup log level to debug
in configuration.yaml
logger:
logs:
custom_components.hikvision_next: debug
Restart Home Assistant
Download logs from Settings / System / Logs
Tested models
NVR
- Annke N46PCK
- DS-7108NI-Q1/8P
- DS-7608NI-I2
- DS-7608NI-I2/8P
- DS-7608NXI-I2/8P/S
- DS-7608NXI-K1/8P
- DS-7616NI-E2/16P
- DS-7616NI-I2/16P
- DS-7616NXI-I2/16P/S
- DS-7716NI-I4/16P
- ERI-K104-P4
DVR
- iDS-7204HUHI-M1/P
- iDS-7204HUHI-M1/FA/A
IP Camera
- DS-2CD2047G2-LU/SL
- DS-2CD2087G2-LU
- DS-2CD2155FWD-I
- DS-2CD2346G2-IU
- DS-2CD2386G2-IU
- DS-2CD2387G2-LU
- DS-2CD2425FWD-IW
- DS-2CD2546G2-IS
- DS-2CD2747G2-LZS
- DS-2CD2785G1-IZS
- DS-2CD2H46G2-IZS (C)
- DS-2CD2T87G2-L
- DS-2CD2T87G2P-LSU/SL
- DS-2DE4425IW-DE (PTZ)