Skip to content

Add BEOK TGM50 floor-heating thermostat (#1447) - #1558

Merged
JohanBendz merged 1 commit into
develop-0.4.1from
cursor/beok-tgm50-1447-5cdb
Nov 16, 2026
Merged

JohanBendz merged 1 commit into
develop-0.4.1from
cursor/beok-tgm50-1447-5cdb

Conversation

@JohanBendz

Copy link
Copy Markdown
Owner

Related: #1447
Tracker: #1557

Adds an isolated Homey driver for the BEOK TGM50-ZB-WP wall thermostat from the Homey interview in #1447. It is a mains-powered router, TS0601 / _TZE204_cvub6xbb, endpoint 1 server clusters 0, 4, 5 and 61184 (Tuya EF00), client clusters 25 (OTA) and 10 (Time). There is no Thermostat cluster 0x0201.

wall_thermostat is unchanged. That BHT-002 profile uses datapoint 2 as the manual/program mode and datapoint 16 as the setpoint (#1479, #1501). On this thermostat datapoint 2 is the setpoint, so the fingerprint is not added there.

Identity

Manifested exactly:

  • manufacturer _TZE204_cvub6xbb
  • product TS0601

Left out on purpose. Both appear in external converters and neither has a Homey interview in this repository:

  • _TZE284_cvub6xbb (Zigbee2MQTT and ZHA)
  • _TZE204_mwomyz5n (Zigbee2MQTT only)

Datapoint map

Confirmed from Zigbee2MQTT TGM50-ZB and the ZHA quirk. Temperatures are value ÷ 10 on read and value × 10 on write. A write is sent only after a user change, the Homey value is restored when the radio rejects it, and init does not write.

DP Type Homey Encoding
1 bool on/off true = heat, false = off
2 value target temperature 5–35 °C, step 0.5. 21.5 °C is sent as 215
3 value measured temperature °C × 10, read only
4 enum preset 0 manual, 1 auto, 3 eco. Value 2 is ignored
9 bool child lock existing child_lock capability
15 value maximum temperature setting 15–90 °C, step 0.5
19 value temperature calibration signed, −9.9–9.9 °C, step 0.1. Existing temp_calibration capability
101 enum heating 0 idle, 1 heat. Read-only thermostat_heating
102 bool frost protection setting
105 bool button sound setting. ZHA only
106 enum sensor 0 internal, 1 external, 2 both
107 value hysteresis 0.5–10 °C, step 0.5
110 enum backlight 0 off, 1 always low, 2 always medium, 3 always high

thermostat_preset is not reused. Its values are 0 Automatic, 1 Manual, 3 Holiday, which do not match this enum. The driver uses beok_tgm50_preset.

thermostat_heating.json is the same capability file as AVATTO TRV #1535, so either pull request can merge first. The visible title is Heating. The shared description text still says “the valve is heating” because that is the #1535 wording.

Not exposed

  • DP103 factory reset
  • DP111 relay invert (ZHA; on value 0 / off value 1)

Both are logged if the device reports them. Nothing writes them.

No known datapoint

Floor-probe temperature, window detection, power-loss memory and the weekly schedule are not in the Zigbee2MQTT or ZHA maps. Unmapped reports use the same 60-second limiter as wall_thermostat: the first value and each change are logged, and identical repeats are summarized. Sensor select (DP106) chooses internal, external or both, but that is not a floor-temperature reading.

Time

Zigbee2MQTT uses timeStart: "1970". A Tuya 0x24 request is answered like lcdtemphumidsensor_3: 8 bytes, big-endian UTC seconds then local seconds, with explicit payloadSize. The reply is sent only when the device asks. Init does not query or write.

Pairing text follows Zigbee2MQTT: power on, then hold the ^ key at the bottom right for 5–8 seconds until the Wi-Fi icon flashes.

Unverified

  • No hardware run on this unit. The map is from the public converters plus the Homey interview, not from a captured datapoint log.
  • DP105 button sound is in the ZHA quirk for this identity and is absent from the Zigbee2MQTT exposes.
  • Driver images are the existing wall-thermostat artwork, not a TGM50 photo.
  • _TZE284_cvub6xbb and _TZE204_mwomyz5n may share the map, but they are not paired by this driver.

Hardware checklist for the reporter

  1. Pair from the BEOK TGM50 driver, not Wall Thermostat. Confirm manufacturer _TZE204_cvub6xbb and model TS0601. Note whether the unit is WP or WPB.
  2. Turn the thermostat on and off from Homey and confirm the display follows.
  3. Set 21.5 °C. The thermostat should show 21.5 and Homey should stay on 21.5 after the device reports back.
  4. Compare Homey’s measured temperature with the temperature on the display.
  5. Switch preset among Manual, Auto and Eco, from Homey and from the thermostat.
  6. Call for heat and confirm the Heating indicator is on only while the relay is heating.
  7. Toggle child lock and confirm the keys on the unit lock and unlock.
  8. Adjust calibration, hysteresis, maximum temperature, frost protection, sensor and backlight by a small step. Confirm the thermostat menu shows the same value.
  9. Toggle button sound only if you can hear the beep. If nothing changes, say so; DP105 is unverified.
  10. With an external floor probe connected, set the sensor to External and to Internal and external. Change a weekly schedule, window detection or power-loss memory on the thermostat if those menus exist. Send a Homey diagnostic log. Unmapped lines look like processReporting <dp> <value>. Please include the datapoint number, the value, and what you changed.
  11. Leave the thermostat paired overnight and check that the clock or schedule has not drifted.
  12. Do not expect a factory-reset or relay-invert control. Those datapoints are intentionally not writable.
Open in Web Open in Cursor 

The interviewed _TZE204_cvub6xbb uses datapoint 2 as the setpoint, so it stays out of the BHT-002 wall_thermostat map. Writes wait for the radio and roll back on failure, and Tuya time replies use the 1970 epoch.

Co-authored-by: Johan Bendz <JohanBendz@users.noreply.github.com>
@JohanBendz
JohanBendz merged commit c72ab27 into develop-0.4.1 Nov 16, 2026
1 check passed
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.

2 participants