openHAB

# DahuaDoor Binding

This binding integrates Dahua VTO Villastation door controllers with openHAB, enabling doorbell notifications, camera snapshots, and remote door control.

# Supported Things

Thing Type Thing ID Description
VTO2202 vto2202 Dahua VTO2202 outdoor station with single button
VTO3211 vto3211 Dahua VTO3211 outdoor station with dual buttons

# Discovery

Dahua door stations are automatically discovered on the local network using the DHIP UDP multicast discovery protocol. The discovered thing is pre-configured with the device's IP address as hostname. username and password must be set manually after accepting the thing in the inbox.

Note: Auto-discovery relies on UDP multicast (239.255.255.251:37810) and therefore only works when openHAB and the Dahua devices are on the same subnet. Devices in a different subnet or VLAN will not be found automatically and must be added manually.

# Thing Configuration

# VTO2202/VTO3211 Device

Single-button outdoor station.

Parameter Type Required Default Description
hostname text Yes Hostname or IP address of the device (e.g., 192.168.1.100)
username text Yes Username to access the device
password text Yes Password to access the device
snapshotPath text Yes Linux path where image files are stored (e.g., /var/lib/openhab/door-images)
useHttps boolean No false Use HTTPS (port 443) for snapshot and door-open requests. Enable if the device has HTTPS turned on in its network settings. When disabled, plain HTTP (port 80) is used.

Note: Windows paths are not currently supported.

Note on HTTPS: To use HTTPS for snapshot retrieval and door-open commands, set useHttps=true and enable HTTPS on the device. Dahua devices typically use a self-signed certificate, which must be imported into the Java truststore of the machine running openHAB. If you have exported the device certificate as ca.crt, import it with:

keytool -importcert -alias dahua-door -file ca.crt \
    -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit

# Channels

# VTO2202 Channels (Single Button)

Channel ID Type Read/Write Description
bell-button Trigger Read Triggers when doorbell button is pressed (event: PRESSED)
door-image Image Read Camera snapshot taken when doorbell is pressed
open-door-1 Switch Write Command to open door relay 1
open-door-2 Switch Write Command to open door relay 2

# VTO3211 Channels (Dual Button)

Channel ID Type Read/Write Description
bell-button-1 Trigger Read Triggers when button 1 is pressed (event: PRESSED)
bell-button-2 Trigger Read Triggers when button 2 is pressed (event: PRESSED)
door-image-1 Image Read Camera snapshot when button 1 is pressed
door-image-2 Image Read Camera snapshot when button 2 is pressed
open-door-1 Switch Write Command to open door relay 1
open-door-2 Switch Write Command to open door relay 2

# Full Example

# VTO2202 Example (Single Button)

# Thing Configuration

When discovered automatically, the thing ID is based on the device serial number when available (e.g., abc1234xyz56789), and otherwise falls back to the device MAC address and then the hostname. For manual configuration, any unique ID can be used.

Thing dahuadoor:vto2202:frontdoor "Front Door Station" @ "Entrance" [
    hostname="192.168.1.100",
    username="admin",
    password="password123",
    snapshotPath="/var/lib/openhab/door-images",
    useHttps=false
]

# Item Configuration

Switch OpenFrontDoor "Open Front Door" <door> { channel="dahuadoor:vto2202:frontdoor:open-door-1" }
Image FrontDoorImage "Front Door Camera" <camera> { channel="dahuadoor:vto2202:frontdoor:door-image" }

# Rule Configuration

Send smartphone notification with camera image when doorbell is pressed (requires openHAB Cloud Connector):

rule "Doorbell Notification"
when
    Channel "dahuadoor:vto2202:frontdoor:bell-button" triggered PRESSED
then
    sendBroadcastNotification("Visitor at the door", "door", 
        "entrance", "Entrance", "door-notifications", null, 
        "item:FrontDoorImage", 
        "Open Door=command:OpenFrontDoor:ON", null)
end

# VTO3211 Example (Dual Button)

# Thing Configuration

Thing dahuadoor:vto3211:entrance "Entrance Station" @ "Entrance" [
    hostname="192.168.1.101",
    username="admin",
    password="password123",
    snapshotPath="/var/lib/openhab/door-images",
    useHttps=false
]

# Item Configuration

Switch OpenApartment1 "Open Apartment 1" <door> { channel="dahuadoor:vto3211:entrance:open-door-1" }
Switch OpenApartment2 "Open Apartment 2" <door> { channel="dahuadoor:vto3211:entrance:open-door-2" }
Image Apartment1Image "Apartment 1 Camera" <camera> { channel="dahuadoor:vto3211:entrance:door-image-1" }
Image Apartment2Image "Apartment 2 Camera" <camera> { channel="dahuadoor:vto3211:entrance:door-image-2" }

# Rule Configuration

Send notifications for both buttons:

rule "Apartment 1 Doorbell"
when
    Channel "dahuadoor:vto3211:entrance:bell-button-1" triggered PRESSED
then
    sendBroadcastNotification("Visitor at Apartment 1", "door", 
        "entrance", "Entrance", "door-notifications", null, 
        "item:Apartment1Image", 
        "Open Door=command:OpenApartment1:ON", null)
end

rule "Apartment 2 Doorbell"
when
    Channel "dahuadoor:vto3211:entrance:bell-button-2" triggered PRESSED
then
    sendBroadcastNotification("Visitor at Apartment 2", "door", 
        "entrance", "Entrance", "door-notifications", null, 
        "item:Apartment2Image", 
        "Open Door=command:OpenApartment2:ON", null)
end
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)

← Daikin →