⚠️ BREAKING CHANGES
Upgrading from 3.0.0 requires no entity or service migration.
Warning
Upgrading from 2.x or earlier? The 3.0.0 breaking changes apply. The dahua.set_text_overlay and dahua.get_overlay_text services default to group: 1. Add group: 0 explicitly to any script or automation that relies on the old default.
Indoor monitors that explicitly report no local camera lose their Infrared light and Infrared Mode select. Update dashboards and automations that reference them. If you are also skipping 2.0, check the earlier illuminator, indoor-monitor identity, and recorder alarm and relay changes before upgrading. 3.0.0 upgrade notes
Dahua 3.1.0 requires Home Assistant 2026.8.0 or newer.
New controls and events
- Profile Schedule times. Edit the Day and Night start times on supported channels with a single enabled daily interval. Changes preserve the other endpoint, neighboring channels, and fields the integration does not own. #1196, #1210
- Channel Title and Custom Title. Edit titles wherever the device reports the matching fields. The Custom Title text entity replaces the entire group 1 overlay with one line. Use
dahua.set_text_overlayfor multiline overlays. #1214 - Face recognition. Channels subscribed to FaceRecognition or All get a Last recognized face sensor and a
dahua_face_recognitionevent for matches and unmatched faces. Names and match details can appear in Home Assistant history, the logbook, and raw debug logs. Downloads of event diagnostics redact names and IDs in the person and passerby records. #1224 - Stream audio metadata. Camera entities show the codec and sample rate when the encoder reports them, which helps diagnose two-way audio. #1223
Camera and recorder fixes
- More reliable profile controls. Profile Management, Schedule, and active-profile consumers can read unambiguous wrapped
VideoInModerows. Video Color Style follows the active Day, Night, or General profile, and the Day/Night select reads from the table that accepts its writes. #1208, #1219, #1206, #1201 - Lighting discovery. The Illumination Mode selector can appear when the scene and white-light table counts differ. Late Lighting_V2 discovery keeps the route for the affected channel. #1205, #1209
- Snapshot authentication. Stills and the setup probe ask for a Digest challenge before signing, while preserving the count when a device repeats the same nonce. Cancelled snapshot requests log whether they had acquired a request slot. The reported recorder fix still awaits hardware confirmation. #1229, #1200, #1197
- Recovery from malformed CGI replies. Supported config writes and event subscriptions can recover over RPC2. Config writes verify readback and stop further fallback writes if the device drops settings. A verified Timestamp Overlay change can include the linked preview setting on firmware that sets both together. #1191, #1215, #1221
- Polling and capability recovery. Refused reads retain the last known direct-camera IVS rules and monitor call settings. Encoder audio and monitor call controls can appear after a setup probe that received no answer. #1207, #1213, #1217
Repairs and diagnostics
- Manually adding another entry at the same address and port raises a Repairs warning. The warning clears when the duplicate is resolved. #1212
- Before suggesting the motion poller, the integration gives the device a bounded trial with an all-events subscription. #1222
- Diagnostics distinguish an unattempted coaxial capability probe from a refusal, show siren refusal details, and indicate when a device's RPC2 config writes have been blocked. An explicit siren refusal persists across restarts while the firmware matches. Reload the entry to retry. #1211, #1216, #1225, #1228
Known limitation
In Schedule mode, the device can report the configured banks without identifying the currently active one. Profile-specific Style, lighting, and exposure controls can then use the Day bank while Night is active. Use the camera's interface for those adjustments if the active bank is uncertain.