The Hikvision Binary Sensor is a platform that parses the event stream of a Hikvision IP Camera or NVR and presents the camera/nvr events to Home Assistant as binary sensors with either an “off” or “on” state.
The platform will automatically add all sensors to Home Assistant that are configured within the camera/nvr interface to “Notify the surveillance center” as a trigger. If you would like to hide a sensor type you can do so by either unchecking “Notify the surveillance center” in the camera configuration or by using the “ignored” customize option detailed below.
In order for the sensors to work the hikvision user must have the ‘Remote: Notify Surveillance Center/Trigger Alarm Output’ permission which can be enabled from the user management section of the web interface. Also the ‘WEB Authentication’ needs to be set to ‘digest/basic’ in the security/authentication section.
For example, if you configure a camera with the name “Front Porch” that has motion detection and line crossing events enabled to notify the surveillance center the following binary sensors will be added to Home Assistant:
When used with a NVR device the sensors will be appended with the channel number they represent. For example, if you configure an NVR with the name “Home” that supports 2 cameras with motion detection and line crossing events enabled to notify the surveillance center the following binary sensors will be added to Home Assistant:
binary_sensor.home_motion_1 binary_sensor.home_motion_2 binary_sensor.home_line_crossing_1 binary_sensor.home_line_crossing_2
This platform should work with all Hikvision cameras and nvrs, and has been confirmed to work with the following models:
To enable this sensor, the following lines are required in your
binary_sensor: - platform: hikvision host: IP_ADDRESS username: user password: pass
Configuration options for a Hikvision Sensor:
- host (Required): The IP address of the camera you would like to connect to.
- username (Required): The username to authenticate with.
- password (Required): The password to authenticate with.
- name (Optional): The name you’d like to give the camera in Home Assistant, defaults to name defined in the camera.
- port (Optional): The port to connect to the camera on, defaults to 80.
- ssl (Optional): True if you want to connect with https. Be sure to set the port also.
customize (Optional): This attribute contains sensor-specific override values. Only sensor name needs defined:
- ignored (Optional): Ignore this sensor completely. It won’t be shown in the Web Interface and no events are generated for it.
- delay (Optional): Specify the delay to wait after a sensor event ends before notifying Home Assistant. This is useful to catch multiple quick trips in one window without the state toggling on and off. The default delay is 5 seconds.
Supported sensor/event types are:
- Line Crossing
- Field Detection
- Video Loss
- Tamper Detection
- Shelter Alarm
- Disk Full
- Disk Error
- Net Interface Broken
- IP Conflict
- Illegal Access
- Video Mismatch
- Bad Video
- PIR Alarm
- Face Detection
- Scene Change Detection
Example of a configuration in your
configuration.yaml that utilizes the customize options for a camera:
binary_sensor: - platform: hikvision host: 192.168.X.X port: 80 ssl: False username: user password: pass customize: motion: delay: 30 line_crossing: ignored: True
Example of a configuration in your
configuration.yaml that utilizes the customize options for a nvr:
binary_sensor: - platform: hikvision host: 192.168.X.X port: 80 ssl: False username: user password: pass customize: motion_1: delay: 30 field_detection_2: ignored: True