Bosch BTH-RA
Model | BTH-RA |
Vendor | Bosch |
Description | Radiator thermostat II |
Exposes | climate (local_temperature, occupied_heating_setpoint, local_temperature_calibration, system_mode, pi_heating_demand, running_state), boost, window_detection, display_orientation, remote_temperature, display_ontime, display_brightness, displayed_temperature, lock (state), battery, setpoint_change_source, valve_adapt_status, valve_adapt_process, linkquality |
Picture |
Notes
Pairing
To pair this device you have to install the device via its installation code. The installation code can be obtained by scanning the QR-code on the inside of the battery cover with your smartphone. Then get the device into pairing mode. In zigbee2mqtt navigate to "Settings" --> "Tools" and click on "Add install code". Paste the code you got from the QR-code and confirm by clicking "OK" which will get zigbee2mqtt into pairing mode automatically. Wait for your device to be joined.
Factory resetting
To factory reset the device remove one of the batteries. While pressing and holding the device's main button on the front, insert the battery back. As soon as the device's LED is starting to blink orange while showing "RES", release the main button and press and hold it again until the device's LED is lighting up green. The device will then restart into the calibration process and look for a Zigbee network to join. In case something went wrong, the device's LED will start to blink red. The process has then to be start all over again.
OTA updates
This device supports OTA updates, for more information see OTA updates.
Options
How to use device type specific configuration
thermostat_unit
: Controls the temperature unit of the thermostat (default celsius). The value must be one ofcelsius
,fahrenheit
Exposes
Climate
This climate device supports the following features: local_temperature
, occupied_heating_setpoint
, local_temperature_calibration
, system_mode
, pi_heating_demand
, running_state
.
occupied_heating_setpoint
: Temperature setpoint. To control publish a message to topiczigbee2mqtt/FRIENDLY_NAME/set
with payload{"occupied_heating_setpoint": VALUE}
whereVALUE
is the °C between5
and30
. To read send a message tozigbee2mqtt/FRIENDLY_NAME/get
with payload{"occupied_heating_setpoint": ""}
.pi_heating_demand
: Position of the valve (= demanded heat) where 0% is fully closed and 100% is fully open. To control publish a message to topiczigbee2mqtt/FRIENDLY_NAME/set
with payload{"pi_heating_demand": VALUE}
whereVALUE
is the % between0
and100
. To read send a message tozigbee2mqtt/FRIENDLY_NAME/get
with payload{"pi_heating_demand": ""}
.local_temperature
: Temperature used by the heating algorithm. This is the temperature measured on the device (by default) or the remote temperature (if set within the last 30 minutes). (in °C). Reading (/get
) this attribute is not possible.system_mode
: Mode of this device. To control publish a message to topiczigbee2mqtt/FRIENDLY_NAME/set
with payload{"system_mode": VALUE}
whereVALUE
is one of:off
,heat
,auto
. To read send a message tozigbee2mqtt/FRIENDLY_NAME/get
with payload{"system_mode": ""}
.running_state
: The current running state. Possible values are:idle
,heat
. Reading (/get
) this attribute is not possible.local_temperature_calibration
: Offset to add/subtract to the local temperature. To control publish a message to topiczigbee2mqtt/FRIENDLY_NAME/set
with payload{"local_temperature_calibration": VALUE}.
The minimal value is-5
and the maximum value is5
with a step size of0.1
.
Boost (binary)
Activate boost heating. Value can be found in the published state on the boost
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"boost": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"boost": NEW_VALUE}
. If value equals ON
boost is ON, if OFF
OFF.
Window detection (binary)
Window open. Value can be found in the published state on the window_detection
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"window_detection": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"window_detection": NEW_VALUE}
. If value equals ON
window detection is ON, if OFF
OFF.
Display orientation (enum)
Display orientation. Value can be found in the published state on the display_orientation
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"display_orientation": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"display_orientation": NEW_VALUE}
. The possible values are: normal
, flipped
.
Remote temperature (numeric)
Input for remote temperature sensor. This must be set at least every 30 minutes to prevent fallback to internal temperature reading!. Value can be found in the published state on the remote_temperature
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"remote_temperature": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"remote_temperature": NEW_VALUE}
. The minimal value is 0
and the maximum value is 35
. The unit of this value is °C
.
Display ontime (numeric)
Specifies the display on-time. Value can be found in the published state on the display_ontime
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"display_ontime": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"display_ontime": NEW_VALUE}
. The minimal value is 5
and the maximum value is 30
.
Display brightness (numeric)
Specifies the brightness level of the display. Value can be found in the published state on the display_brightness
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"display_brightness": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"display_brightness": NEW_VALUE}
. The minimal value is 0
and the maximum value is 10
.
Displayed temperature (enum)
Temperature displayed on the thermostat. Value can be found in the published state on the displayed_temperature
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"displayed_temperature": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"displayed_temperature": NEW_VALUE}
. The possible values are: target
, measured
.
Child lock (lock)
The current state of this lock is in the published state under the child_lock
property (value is LOCK
or UNLOCK
). To control this lock publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"child_lock": "LOCK"}
or {"child_lock": "UNLOCK"}
. To read the current state of this lock publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"child_lock": ""}
.
Battery (numeric)
Remaining battery in %, can take up to 24 hours before reported. Value can be found in the published state on the battery
property. It's not possible to read (/get
) or write (/set
) this value. The minimal value is 0
and the maximum value is 100
. The unit of this value is %
.
Setpoint change source (enum)
States where the current setpoint originated. Value can be found in the published state on the setpoint_change_source
property. It's not possible to read (/get
) or write (/set
) this value. The possible values are: manual
, schedule
, external
.
Adaptation status (enum)
Specifies the current status of the valve adaptation. Value can be found in the published state on the valve_adapt_status
property. It's not possible to read (/get
) or write (/set
) this value. The possible values are: none
, ready_to_calibrate
, calibration_in_progress
, error
, success
.
Trigger adaptation process (binary)
Trigger the valve adaptation process. Only possible when adaptation status is "ready_to_calibrate" or "error".. Value can be found in the published state on the valve_adapt_process
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"valve_adapt_process": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"valve_adapt_process": NEW_VALUE}
. If value equals true
trigger adaptation process is ON, if false
OFF.
Linkquality (numeric)
Link quality (signal strength). Value can be found in the published state on the linkquality
property. It's not possible to read (/get
) or write (/set
) this value. The minimal value is 0
and the maximum value is 255
. The unit of this value is lqi
.