Danfoss Eco (eTRV) for Home Assistant

Home Assistant custom integration for Danfoss Eco Bluetooth Thermostatic Radiator Valves (eTRV). Local-only, talks directly to the TRV over BLE. This integration aims to transform your TRVs from a programmable device into a connected one.

Features

Exposes connected TRV's as home-assistant thermostats. Devices can be paired directly from the integration ui. The integration polls valves every hour to get updates on ambient temperatures and manual temperature set point changes.

Features :

• Heat and Off (frost protection) modes
• Pin (untested)
• Child lock
• Vacation preset (untested)
• Battery level reporting
• Ambient temperature reporting

Not supported :

• On-device schedules

Requirements

• Home Assistant 2024.1.0+
• A working Bluetooth adapter known to Home Assistant (ESPHome BT proxy works too).
• The TRV's 4-digit PIN (default 0000).

Install

HACS (recommended)

1. HACS → Integrations → ⋮ → Custom repositories → add https://github.com/Clap404/danfoss_eco_ha as type Integration.
2. Install Danfoss Eco (eTRV), restart Home Assistant.

Manual

Copy custom_components/danfoss_eco/ into your HA config/custom_components/ directory, restart.

Pairing a device

1. Settings → Devices & Services → Add Integration → Danfoss Eco. Discovered TRVs appear automatically; otherwise pick from the list.
2. Enter the 4-digit PIN (0000 if never changed).
3. When prompted, short-press the button on the TRV — its LED goes solid. The integration reads the device's secret key during that window.
4. If pairing times out, press the button again and retry. The window is only a few seconds.

Notes

• Scan interval is set to one hour because these TRV were not originally made for frequent communication. Increasing poll rate may drain the battery faster. Using the default, you should at least a year of battery life.

Credits

This project has been largely AI generated. As such, I consider it a derivative work : protocol decoding, crypto handling, and characteristic mapping were lifted and ported from:

• AdamStrojek/libetrv (Apache 2.0)
• keton/etrv2mqtt (MIT)
• dmitry-cherkas/esphome-danfoss-eco (MIT)

Huge thanks to the original authors for reverse engineering and publishing their projects many years ago.

License

MIT — see LICENSE. Compatible with upstream MIT licensing of the projects above.