Skip to content

Conversation

@AlexisPolegato
Copy link

Summary

Add support for the NodOn TRV-4-1-00 Thermostatic Radiator Valve to the zigbee-thermostat driver.

Device Information

  • Manufacturer: NodOn
  • Model: TRV-4-1-00
  • Type: Thermostatic Radiator Valve (TRV)
  • Protocol: Zigbee
  • Device Type: 0x0301 (Thermostat)

Key Features

  • Battery-optimized reporting intervals:
    • Temperature: 5s-1h intervals, 0.5°C change threshold
    • Setpoint: 1s-24h intervals, 0.5°C change threshold
    • Mode: 1s-24h intervals, any change
    • Battery: 5min-24h intervals, 1% change threshold
  • Setpoint range validation (8-28°C) with automatic clamping
  • Standard Zigbee thermostat cluster support (heating only)
  • Proper cluster binding for bidirectional communication
  • Reads device capabilities (ControlSequenceOfOperation, min/max setpoint limits)

Implementation Details

  1. Added fingerprint entry in fingerprints.yml
  2. Created device profile thermostat-nodon.yml with proper setpoint range
  3. Implemented sub-driver in src/nodon/init.lua with:
    • Fingerprint matching function
    • Custom setpoint validation handler
    • Battery-optimized reporting configuration
    • Cluster binding setup
  4. Registered sub-driver in main init.lua

Testing

This driver has been tested with the NodOn TRV-4-1-00 device and verified to:

  • Properly discover and pair the device
  • Support bidirectional communication (device changes update in app)
  • Enforce setpoint range limits
  • Optimize battery life with appropriate reporting intervals

Add support for the NodOn TRV-4-1-00 Thermostatic Radiator Valve to the zigbee-thermostat driver.

Key features:
- Battery-optimized reporting intervals (temperature: 5s-1h, setpoint/mode: 1s-24h, battery: 5min-24h)
- Setpoint range validation (8-28°C) with clamping
- Standard Zigbee thermostat cluster support (heating only)
- Proper cluster binding for bidirectional communication
@AlexisPolegato AlexisPolegato force-pushed the add-nodon-trv-thermostat branch from ffe2d76 to 3fbfe68 Compare December 15, 2025 22:36
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.

1 participant