Skip to content

Conversation

@Jaylouisw
Copy link

@Jaylouisw Jaylouisw commented Dec 14, 2025

Summary

Add quirk support for the EARU TV02 Zigbee Thermostatic Radiator Valve.

Device Information

  • Manufacturer strings: _TZE284_pcdmj88b, _TZE204_pcdmj88b
  • Model: TS0601
  • Product: EARU TV02 TRV (Tuya Smart ZigBee Radiator Actuator)

DP Mappings

Verified from Zigbee2MQTT TS0601_thermostat_4 definition:

DP Function Notes
2 system_mode Auto=0, Heat=1, Off=2
3 running_state Heat=0, Idle=1
4 occupied_heating_setpoint Value × 10
5 local_temperature Value × 10
6 battery Percentage
7 child_lock Boolean
36 frost_protection Boolean
37 boost_heating Boolean
39 scale_protection Boolean
47 local_temperature_calibration Range -6 to +6

Testing

This quirk has been tested on actual hardware (2× EARU TV02 TRVs) and confirmed working with all entities exposed correctly:

  • Climate entity with heating setpoint control ✅
  • System mode switching (Auto/Heat/Off) ✅
  • Running state reporting ✅
  • Battery percentage sensor ✅
  • Child lock switch ✅
  • Frost protection switch ✅
  • Boost heating switch ✅
  • Scale protection switch ✅
  • Temperature calibration number ✅

Related Issues

Closes #4501

Checklist

  • Code follows the existing quirk patterns in tuya_trv.py
  • Uses TuyaQuirkBuilder with proper DP mappings
  • Tested on actual hardware
  • DP mappings verified against Zigbee2MQTT reference

Add quirk for EARU TV02 Zigbee Thermostatic Radiator Valve.

Manufacturer strings: _TZE284_pcdmj88b, _TZE204_pcdmj88b
Model: TS0601

DP Mappings (verified from Zigbee2MQTT TS0601_thermostat_4):
- DP 2: system_mode (Auto=0, Heat=1, Off=2)
- DP 3: running_state (Heat=0, Idle=1)
- DP 4: current_heating_setpoint
- DP 5: local_temperature
- DP 6: battery percentage
- DP 7: child_lock
- DP 36: frost_protection
- DP 37: boost_heating
- DP 39: scale_protection
- DP 47: local_temperature_calibration

Closes zigpy#4501
@codecov
Copy link

codecov bot commented Dec 14, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.28%. Comparing base (35d1fc1) to head (9229873).

Additional details and impacted files
@@           Coverage Diff           @@
##              dev    #4573   +/-   ##
=======================================
  Coverage   92.28%   92.28%           
=======================================
  Files         371      371           
  Lines       12158    12159    +1     
=======================================
+ Hits        11220    11221    +1     
  Misses        938      938           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds support for the EARU TV02 Zigbee Thermostatic Radiator Valve (TRV) by implementing a quirk for manufacturer IDs _TZE284_pcdmj88b and _TZE204_pcdmj88b with model TS0601.

  • Implements a new TuyaQuirkBuilder configuration with 10 DP mappings verified against Zigbee2MQTT
  • Adds climate control functionality with system modes (Auto/Heat/Off), temperature setpoint, and running state
  • Includes various switch entities for child lock, frost protection, boost heating, and scale protection, plus battery monitoring and temperature calibration

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Device Support Request] Tuya TRV TS0601 by _TZE284_pcdmj88b

1 participant