Home Assistant Dahua Integration

The Dahua Home Assistant integration allows you to integrate your Dahua cameras, doorbells, NVRs, DVRs in Home Assistant. It's also confirmed to work with some Lorex cameras and Amcrest devices.

Supports motion events, alarm events (and others), enabling/disabling motion detection, switches for infrared, illuminator (white light), security lights (red/blue flashers), sirens, doorbell button press events, and more.

Also exposes several services to enable/disable motion detection or set the text overlay on the video.

NOTE: Using the switch to turn on/off the infrared light will disable the "auto" mode. Use the service to enable auto mode again (or the camera UI).

Why not use the Amcrest integration already provided by Home Assistant? The Amcrest integration is missing features that this integration provides and I want an integration that is branded as Dahua. Amcrest are rebranded Dahua cams. With this integration living outside of HA, it can be developed faster and released more often. HA has release schedules and rigerous review processes which I'm not ready for while developing this integration. Once this integration is mature I'd like to move it into HA directly.

Installation

If you want live-streaming, make sure to add the following to your config.yaml:

ffmpeg:

See ffmpeg and stream.

HACS install

To install with HACS:

Click on HACS in the Home Assistant menu
Click on Integrations
Click the EXPLORE & ADD REPOSITORIES button
Search for Dahua
Click the INSTALL THIS REPOSITORY IN HACS button
Restart Home Assistant
Configure the camera by going to Configurations -> Integrations -> ADD INTERATIONS button, search for Dahua and configure the camera.

Manual install

To manually install:

# Download a copy of this repository
$ wget https://github.com/rroller/dahua/archive/dahua-main.zip

# Unzip the archive
$ unzip dahua-main.zip

# Move the dahua directory into your custom_components directory in your Home Assistant install
$ mv dahua-main/custom_components/dahua <home-assistant-install-directory>/config/custom_components/

:warning: After executing one of the above installation methods, restart Home Assistant. Also clear your browser cache before proceeding to the next step, as the integration may not be visible otherwise.

Setup

Now the integration is added to HACS and available in the normal HA integration installation, so...
In the HA left menu, click Configuration
Click Integrations
Click ADD INTEGRATION
Type Dahua and select it
Enter the details:
1. Username: Your camera's username
2. Password: Your camera's password
3. Address: Your camera's address, typically just the IP address
4. Port: Your camera's HTTP port. Default is 80
5. RTSP Port: Your camera's RTSP port, default is 554. Used to live stream your camera in HA
6. Events: The integration will keep a connection open to the camera to capture motion events, alarm events, etc. You can select which events you want to monitor and report in HA. If no events are selected then the connection will no be created. If you want a specific event that's not listed here open an issue and I'll add it.

NOTE: All streams will be added, even if not enabled in the camera. Just remove the ones you don't want.

Dahua Setup

Known supported cameras

This integration should word with most Dahua cameras and doorbells. It has been tested with very old and very new Dahua cameras.

Doorbells will have a binary sensor that captures the doorbell pressed event.

Please let me know if you've tested with additional cameras

These devices are confirmed as working:

Dahua cameras

Other brand cameras

* partial support

Doorbell cameras

Known Issues

IPC-D2B20-ZS doesn't work. Needs a wrapper, 7, 8

Events

Events are streamed from the device and fired on the Home Assistant event bus.

Here's example event data:

{
    "event_type": "dahua_event_received",
    "data": {
        "name": "Cam13",
        "Code": "VideoMotion",
        "action": "Start",
        "index": "0",
        "data": {
            "Id": [
                0
            ],
            "RegionName": [
                "Region1"
            ],
            "SmartMotionEnable": false
        },
        "DeviceName": "Cam13"
    },
    "origin": "LOCAL",
    "time_fired": "2021-06-30T04:00:28.605290+00:00",
    "context": {
        "id": "199542fe3f404f2a0a81031ee495bdd1",
        "parent_id": null,
        "user_id": null
    }
}

And here's how you configure and event trigger in an automation:

platform: event
event_type: dahua_event_received
event_data:
  name: Cam13
  Code: VideoMotion
  action: Start

And that's it! You can enable debug logging (See at the end of this readme) to print out events to the Home Assisant log as they fire. That can help you understand the events. Or you can HA and open Developer Tools -> Events -> and under "Listen to events" enter dahua_event_received and then click "Start Listening" and wait for events to fire (you might need to walk in front of your cam to make motion events fire, or press a button, etc)

Example Code Events

| Code | Description | | ----- | ----------- | | BackKeyLight | Unit Events, See Below States | | VideoMotion | motion detection event | | VideoLoss | video loss detection event | | VideoBlind | video blind detection event | | AlarmLocal | alarm detection event | | CrossLineDetection | tripwire event | | CrossRegionDetection | intrusion event | | LeftDetection | abandoned object detection | | TakenAwayDetection | missing object detection | | VideoAbnormalDetection | scene change event | | FaceDetection | face detect event | | AudioMutation | intensity change | | AudioAnomaly | input abnormal | | VideoUnFocus | defocus detect event | | WanderDetection | loitering detection event | | RioterDetection | People Gathering event | | ParkingDetection | parking detection event | | MoveDetection | fast moving event | | MDResult | motion detection data reporting event. The motion detect window contains 18 rows and 22 columns. The event info contains motion detect data with mask of every row | | HeatImagingTemper | temperature alarm event |

BackKeyLight States

| State | Description | | ----- | ----------- | | 0 | OK, No Call/Ring | | 1, 2 | Call/Ring | | 4 | Voice message | | 5 | Call answered from VTH | | 6 | Call not answered | | 7 | VTH calling VTO | | 8 | Unlock | | 9 | Unlock failed | | 11 | Device rebooted |

Services and Entities

Note for ease of use, the integration tries to determine if your device supports certain services, entities and will conditionally add them. But that's sometimes a little hard so it'll just add the entity even if your devices doesn't support. I'd rather opt into extra entities than to create a complicated flow to determine what's supported and what isn't. You can simply disable the entities you don't want. An example of this is the "door open state" for doorbells. Not all doorbells support this.

Services

Service | Parameters | Description :------------ | :------------ | :------------- camera.enable_motion_detection | | Enables motion detection camera.disable_motion_detection | | Disabled motion detection dahua.set_infrared_mode | target: camera.cam13_main mode: Auto, On, Off brightness: 0 - 100 inclusive| Sets the infrared mode. Useful to set the mode back to Auto dahua.goto_preset_position | target: camera.cam13_main position: 1 - 10 inclusive| Go to a preset position dahua.set_video_profile_mode | target: camera.cam13_main mode: Day, Night| Sets the video profile mode to day or night dahua.set_focus_zoom | target: camera.cam13_main focus: The focus level, e.g.: 0.81 0 -

Dahua

Install / Use

README

Home Assistant Dahua Integration

Installation

HACS install

Manual install

Setup

Known supported cameras

Dahua cameras

Dahua cameras

Other brand cameras

Doorbell cameras

Known Issues

Events

Example Code Events

BackKeyLight States

Services and Entities

Services