[External Converter]: TS0601 from _TZE204_wc2w9t1s

[engabd11]

Link

https://www.aliexpress.com/item/1005006655059249.html?src=google&albch=search&acnt=479-062-3723&isdl=y&aff_short_key=UneMJZVf&albcp=23163377508&albag=187383838317&slnk=301763830928&trgt=dsa-2501419016287&plac=&crea=780559989106&albad=780559989106&netw=g&device=c&mtctp=&memo1=&albbt=Google_7_search&aff_platform=google&albagn=888888&isSmbActive=false&isSmbAutoCall=false&needSmbHouyi=false&gad_source=1&gad_campaignid=23163377508&gclid=CjwKCAiA8bvIBhBJEiwAu5ayrKNb7yOO1vaeccyaaP1O2MwTLXlVrN-v06RfFiVdXXWCZFz76qPkXhoC3l4QAvD_BwE

Database entry

N/A

Zigbee2MQTT version

2.6.3 (unknown)

External converter

const fz = require('zigbee-herdsman-converters/converters/fromZigbee');
const tz = require('zigbee-herdsman-converters/converters/toZigbee');
const exposes = require('zigbee-herdsman-converters/lib/exposes');
const tuya = require('zigbee-herdsman-converters/lib/tuya');
const ea = exposes.access;

const definition = {
    fingerprint: [{modelID: 'TS0601', manufacturerName: '_TZE204_wc2w9t1s'}],
    model: 'BOT-R9V-ZB',
    vendor: 'Tuya',
    description: 'Wall-mount thermostat',
    whiteLabel: [
        {vendor: 'Beok', model: 'BOT-R9V-ZB'},
        {vendor: 'AVATTO', model: 'ZWT-100-16A'},
    ],
    fromZigbee: [tuya.fz.datapoints],
    toZigbee: [tuya.tz.datapoints],
    configure: tuya.configureMagicPacket,
    onEvent: tuya.onEventSetTime,
    exposes: [
        exposes.climate()
            .withSetpoint('current_heating_setpoint', 5, 60, 0.5, ea.STATE_SET)
            .withLocalTemperature(ea.STATE)
            .withLocalTemperatureCalibration(-9.9, 9.9, 0.1, ea.STATE_SET)
            .withSystemMode(['off', 'heat'], ea.STATE_SET)
            .withRunningState(['idle', 'heat'], ea.STATE),
        exposes.enum('preset', ea.STATE_SET, ['auto', 'manual'])
            .withDescription('Preset mode'),
        exposes.enum('child_lock', ea.STATE_SET, ['LOCK', 'UNLOCK'])
            .withDescription('Child lock'),
        exposes.enum('battery_low', ea.STATE, [true, false])
            .withDescription('Low battery indicator'),
        exposes.numeric('deadzone_temperature', ea.STATE_SET)
            .withUnit('°C')
            .withValueMin(0)
            .withValueMax(5)
            .withValueStep(0.5)
            .withDescription('The delta between local_temperature and current_heating_setpoint to trigger activity'),
    ],
    meta: {
        tuyaDatapoints: [
            [1, 'system_mode', {
                from: (v) => {
                    if (v === true || v === 1) return 'heat';
                    if (v === false || v === 0 || v === 2) return 'off';
                    return 'heat';
                },
                to: (v) => {
                    if (v === 'off') return false;
                    if (v === 'heat') return true;
                    return true;
                },
            }],
            [36, 'running_state', {
                from: (v) => {
                    if (v === true || v === 1) return 'heat';
                    if (v === false || v === 0) return 'idle';
                    return 'idle';
                },
            }],
            [16, 'current_heating_setpoint', tuya.valueConverter.divideBy10],
            [4, 'preset', tuya.valueConverterBasic.lookup({manual: true, auto: false})],
            [24, 'local_temperature', tuya.valueConverter.divideBy10],
            [27, 'local_temperature_calibration', tuya.valueConverter.divideBy10],
            [40, 'child_lock', tuya.valueConverter.lockUnlock],
            [26, 'deadzone_temperature', tuya.valueConverter.raw],
            [14, 'battery_low', tuya.valueConverter.trueFalse],
        ],
    },
};

module.exports = definition;

What does/doesn't work with the external definition?

This converter works with BOT-R9V-ZB thermostat, and similar battery operated zigbee thermostats. The battery status still doesn't work properly, you can remove it. However, temp set, deadzone temp, childloock, temp calibration, and running status are all working perfectly.

Notes

BOT-R9V-ZB external converter.

[github-actions]

🙏 Thank you for creating this issue and sharing your external converter!

In case all features work, please submit a pull request on this repository so the device can be supported out-of-the-box with the next release.
For instructions on how to create a pull request see the docs.

If NOT all features work, please follow the How To Support new devices.
Since this is a Tuya also consider How To Support new Tuya devices.

If you need help with the process, feel free to ask here and we'll be happy to assist.

[github-actions]

🙏 Thank you for creating this issue and sharing your external converter!

In case all features work, please submit a pull request on this repository so the device can be supported out-of-the-box with the next release.
For instructions on how to create a pull request see the docs.

If NOT all features work, please follow the How To Support new devices.
Since this is a Tuya also consider How To Support new Tuya devices.

If you need help with the process, feel free to ask here and we'll be happy to assist.

[hvdort]

below the output of an BOT-R9V-ZB in the Tuya API explorer. I'll try to use it to create my external converter. If anybody have experiences with it, please help...

{
  "result": {
    "properties": [
      {
        "code": "switch",
        "custom_name": "",
        "dp_id": 1,
        "time": 1766764996745,
        "type": "bool",
        "value": true
      },
      {
        "code": "mode",
        "custom_name": "",
        "dp_id": 2,
        "time": 1766764976366,
        "type": "enum",
        "value": "auto"
      },
      {
        "code": "frost",
        "custom_name": "",
        "dp_id": 10,
        "time": 1766764976366,
        "type": "bool",
        "value": false
      },
      {
        "code": "temp_set",
        "custom_name": "",
        "dp_id": 16,
        "time": 1766771287344,
        "type": "value",
        "value": 185
      },
      {
        "code": "lower_temp",
        "custom_name": "",
        "dp_id": 18,
        "time": 1766764976366,
        "type": "value",
        "value": 50
      },
      {
        "code": "upper_temp",
        "custom_name": "",
        "dp_id": 19,
        "time": 1766764976366,
        "type": "value",
        "value": 50
      },
      {
        "code": "temp_current",
        "custom_name": "",
        "dp_id": 24,
        "time": 1766771282865,
        "type": "value",
        "value": 144
      },
      {
        "code": "valve_state",
        "custom_name": "",
        "dp_id": 36,
        "time": 1766765031258,
        "type": "enum",
        "value": "open"
      },
      {
        "code": "child_lock",
        "custom_name": "",
        "dp_id": 40,
        "time": 1766764976366,
        "type": "bool",
        "value": false
      },
      {
        "code": "fault",
        "custom_name": "",
        "dp_id": 45,
        "time": 1766764976366,
        "type": "bitmap",
        "value": 0
      },
      {
        "code": "temp_unit_convert",
        "custom_name": "",
        "dp_id": 46,
        "time": 1766764976366,
        "type": "enum",
        "value": "c"
      },
      {
        "code": "week_program_1",
        "custom_name": "",
        "dp_id": 65,
        "time": 1766764979266,
        "type": "raw",
        "value": "AQYAAMgIAACWCx4AlgweAJYRAADcFgAAlg=="
      },
      {
        "code": "week_program_2",
        "custom_name": "",
        "dp_id": 66,
        "time": 1766764980043,
        "type": "raw",
        "value": "AgYAAMgIAACWCx4AlgweAJYRAADcFgAAlg=="
      },
      {
        "code": "week_program_3",
        "custom_name": "",
        "dp_id": 67,
        "time": 1766764981004,
        "type": "raw",
        "value": "AwYAAMgIAACWCx4AlgweAJYRAADcFgAAlg=="
      },
      {
        "code": "week_program_4",
        "custom_name": "",
        "dp_id": 68,
        "time": 1766764982027,
        "type": "raw",
        "value": "BAYAAMgIAACWCx4AlgweAJYRAADcFgAAlg=="
      },
      {
        "code": "week_program_5",
        "custom_name": "",
        "dp_id": 69,
        "time": 1766764987676,
        "type": "raw",
        "value": "BQYAAMgIAACWCx4AlgweAJYRAADcFgAAlg=="
      },
      {
        "code": "week_program_6",
        "custom_name": "",
        "dp_id": 70,
        "time": 1766764988867,
        "type": "raw",
        "value": "BgYAAMgIAACWCx4AlgweAJYRAADcFgAAlg=="
      },
      {
        "code": "week_program_7",
        "custom_name": "",
        "dp_id": 71,
        "time": 1766764989901,
        "type": "raw",
        "value": "BwYAAMgIAACWCx4AlgweAJYRAADcFgAAlg=="
      },
      {
        "code": "support_features",
        "custom_name": "",
        "dp_id": 101,
        "time": 1766764976366,
        "type": "value",
        "value": 0
      },
      {
        "code": "temp_adjust_step",
        "custom_name": "",
        "dp_id": 102,
        "time": 1766764976366,
        "type": "value",
        "value": 1
      },
      {
        "code": "mfg_model",
        "custom_name": "",
        "dp_id": 105,
        "time": 1766764978023,
        "type": "string",
        "value": "V4BZ"
      },
      {
        "code": "light_mode",
        "custom_name": "",
        "dp_id": 106,
        "time": 1766764976366,
        "type": "raw"
      },
      {
        "code": "battery_percent",
        "custom_name": "",
        "dp_id": 107,
        "time": 1766764976366,
        "type": "value",
        "value": 1
      },
      {
        "code": "temp_calib_step",
        "custom_name": "",
        "dp_id": 108,
        "time": 1766764978023,
        "type": "value",
        "value": 1
      },
      {
        "code": "temp_calib",
        "custom_name": "",
        "dp_id": 109,
        "time": 1766764976366,
        "type": "value",
        "value": -99
      },
      {
        "code": "graph_valve_state",
        "custom_name": "",
        "dp_id": 110,
        "time": 1766765031258,
        "type": "bool",
        "value": true
      },
      {
        "code": "soft_version",
        "custom_name": "",
        "dp_id": 111,
        "time": 1766764978023,
        "type": "string",
        "value": "1.0.2"
      },
      {
        "code": "switch_diff",
        "custom_name": "",
        "dp_id": 112,
        "time": 1766764976366,
        "type": "value",
        "value": 0
      },
      {
        "code": "app_features",
        "custom_name": "",
        "dp_id": 114,
        "time": 1766764976366,
        "type": "value",
        "value": -2147483647
      },
      {
        "code": "eco_temp",
        "custom_name": "",
        "dp_id": 116,
        "time": 1766764976366,
        "type": "value",
        "value": 50
      },
      {
        "code": "default_relay_output",
        "custom_name": "",
        "dp_id": 117,
        "time": 1766764976366,
        "type": "bool",
        "value": false
      },
      {
        "code": "reset_factory",
        "custom_name": "",
        "dp_id": 118,
        "time": 1766764976366,
        "type": "bool",
        "value": false
      }
    ]
  },
  "success": true,
  "t": 1766771551705,
  "tid": "a6de8631e28311f091dbb67f4af8076d"
}

And the possible options per datapoint:
set:

switch	Boolean	
"{true,false}"
mode	Enum	
{
  "range": [
    "auto",
    "manual",
    "eco"
  ]
}
frost	Boolean	
"{true,false}"
temp_set	Integer	
{
  "unit": "℃",
  "min": 50,
  "max": 2500,
  "scale": 1,
  "step": 5
}
lower_temp	Integer	
{
  "unit": "℃",
  "min": 50,
  "max": 2500,
  "scale": 1,
  "step": 10
}
upper_temp	Integer	
{
  "unit": "℃",
  "min": 50,
  "max": 2500,
  "scale": 1,
  "step": 10
}
child_lock	Boolean	
"{true,false}"
temp_unit_convert	Enum	
{
  "range": [
    "c",
    "f"
  ]
}

and read status:

switch	Boolean	
"{true,false}"
mode	Enum	
{
  "range": [
    "auto",
    "manual",
    "eco"
  ]
}
frost	Boolean	
"{true,false}"
temp_set	Integer	
{
  "unit": "℃",
  "min": 50,
  "max": 2500,
  "scale": 1,
  "step": 5
}
lower_temp	Integer	
{
  "unit": "℃",
  "min": 50,
  "max": 2500,
  "scale": 1,
  "step": 10
}
upper_temp	Integer	
{
  "unit": "℃",
  "min": 50,
  "max": 2500,
  "scale": 1,
  "step": 10
}
temp_current	Integer	
{
  "unit": "℃",
  "min": -300,
  "max": 1000,
  "scale": 1,
  "step": 1
}
valve_state	Enum	
{
  "range": [
    "close",
    "open"
  ]
}
child_lock	Boolean	
"{true,false}"
fault	Bitmap	
{
  "label": [
    "e1",
    "e2",
    "e3",
    "e4"
  ]
}
temp_unit_convert	Enum	
{
  "range": [
    "c",
    "f"
  ]
}

[hvdort]

corrected external converter including link to right picture:

const fz = require('zigbee-herdsman-converters/converters/fromZigbee');
const tz = require('zigbee-herdsman-converters/converters/toZigbee');
const exposes = require('zigbee-herdsman-converters/lib/exposes');
const tuya = require('zigbee-herdsman-converters/lib/tuya');
const ea = exposes.access;
const e = exposes.presets;

const definition = {
    fingerprint: [{modelID: 'TS0601', manufacturerName: '_TZE204_wc2w9t1s'}],
    model: 'BOT-R9V-ZB',
    vendor: 'Tuya',
    description: 'Wall-mount thermostat',
    icon: 'https://nl.beok-controls.com/uploads/34945/page/battery-powered-wifi-boiler-thermostat-bot6e13e.jpg',
    whiteLabel: [
        {vendor: 'Beok', model: 'BOT-R9V-ZB'},
        {vendor: 'AVATTO', model: 'ZWT-100-16A'},
    ],
    fromZigbee: [tuya.fz.datapoints],
    toZigbee: [tuya.tz.datapoints],
    configure: tuya.configureMagicPacket,
    onEvent: tuya.onEventSetTime,
    exposes: [
        e.climate()
            .withSetpoint('current_heating_setpoint', 5, 60, 0.5, ea.STATE_SET)
            .withLocalTemperature(ea.STATE)
            .withLocalTemperatureCalibration(-9.9, 9.9, 0.1, ea.STATE_SET)
            .withSystemMode(['off', 'heat'], ea.STATE_SET)
            .withRunningState(['idle', 'heat'], ea.STATE),
        e.enum('preset', ea.STATE_SET, ['manual', 'auto', 'eco'])
            .withDescription('Preset mode: manual, auto or eco'),
        e.child_lock(),
        e.battery(),
        e.enum('valve_state', ea.STATE, ['open', 'close'])
            .withDescription('Valve state (open/close)'),
        e.binary('frost', ea.STATE_SET, 'ON', 'OFF')
            .withDescription('Frost protection mode'),
        e.numeric('deadzone_temperature', ea.STATE_SET)
            .withUnit('°C')
            .withValueMin(0)
            .withValueMax(5)
            .withValueStep(0.5)
            .withDescription('Temperature deadzone (hysteresis)'),
        e.numeric('min_temperature_limit', ea.STATE_SET)
            .withUnit('°C')
            .withValueMin(5)
            .withValueMax(30)
            .withValueStep(0.5)
            .withDescription('Minimum temperature limit'),
        e.numeric('max_temperature_limit', ea.STATE_SET)
            .withUnit('°C')
            .withValueMin(15)
            .withValueMax(60)
            .withValueStep(0.5)
            .withDescription('Maximum temperature limit'),
        e.numeric('eco_temperature', ea.STATE_SET)
            .withUnit('°C')
            .withValueMin(5)
            .withValueMax(30)
            .withValueStep(0.5)
            .withDescription('Eco mode temperature'),
        ...tuya.exposes.scheduleAllDays(ea.STATE_SET, 'HH:MM/C HH:MM/C HH:MM/C HH:MM/C'),
    ],
    meta: {
        tuyaDatapoints: [
            // DP 1: System on/off switch
            [1, 'system_mode', tuya.valueConverterBasic.lookup({heat: true, off: false})],
            
            // DP 2: Mode (manual/auto/eco) - enum type
            [2, 'preset', tuya.valueConverterBasic.lookup({
                auto: tuya.enum(0),
                manual: tuya.enum(1),
                eco: tuya.enum(2),
            })],
            
            // DP 10: Frost protection
            [10, 'frost', tuya.valueConverter.onOff],
            
            // DP 16: Target temperature setpoint (temp_set)
            [16, 'current_heating_setpoint', tuya.valueConverter.divideBy10],
            
            // DP 18: Minimum temperature limit (lower_temp)
            [18, 'min_temperature_limit', tuya.valueConverter.divideBy10],
            
            // DP 19: Maximum temperature limit (upper_temp)
            [19, 'max_temperature_limit', tuya.valueConverter.divideBy10],
            
            // DP 24: Current room temperature (temp_current)
            [24, 'local_temperature', tuya.valueConverter.divideBy10],
            
            // DP 36: Valve state (open/close) and Running state
            [36, null, {
                from: (v) => {
                    return {
                        valve_state: v === 'open' || v === true || v === 1 ? 'open' : 'close',
                        running_state: v === 'open' || v === true || v === 1 ? 'heat' : 'idle',
                    };
                },
            }],
            
            // DP 40: Child lock
            [40, 'child_lock', tuya.valueConverter.lockUnlock],
            
            // DP 65-71: Week schedules (Monday to Sunday) with format HH:MM/C (4 transitions per day)
            [65, 'schedule_monday', tuya.valueConverter.thermostatScheduleDayMultiDPWithDayNumber(4)],
            [66, 'schedule_tuesday', tuya.valueConverter.thermostatScheduleDayMultiDPWithDayNumber(4)],
            [67, 'schedule_wednesday', tuya.valueConverter.thermostatScheduleDayMultiDPWithDayNumber(4)],
            [68, 'schedule_thursday', tuya.valueConverter.thermostatScheduleDayMultiDPWithDayNumber(4)],
            [69, 'schedule_friday', tuya.valueConverter.thermostatScheduleDayMultiDPWithDayNumber(4)],
            [70, 'schedule_saturday', tuya.valueConverter.thermostatScheduleDayMultiDPWithDayNumber(4)],
            [71, 'schedule_sunday', tuya.valueConverter.thermostatScheduleDayMultiDPWithDayNumber(4)],
            
            // DP 107: Battery percentage
            [107, 'battery', tuya.valueConverter.raw],
            
            // DP 109: Temperature calibration (temp_calib)
            [109, 'local_temperature_calibration', tuya.valueConverter.divideBy10],
            
            // DP 112: Temperature deadzone/hysteresis (switch_diff)
            [112, 'deadzone_temperature', tuya.valueConverter.divideBy10],
            
            // DP 116: Eco mode temperature
            [116, 'eco_temperature', tuya.valueConverter.divideBy10],
        ],
    },
};

module.exports = definition;