Bosch Thermostat 2

hraschan · November 23, 2022, 2:06am

Is it possible to connect the Bosch Thermostat 2 only by using ZigBee? So not using the Bosch Controller to connect to Home Assistent?

Hedda · November 25, 2022, 8:32am

The answer is yes if it is a standard Zigbee device, such devices are supported directly if you use a new/modern Zigbee Coordinator radio adapter (like example Home Assistant SkyConnect USB dongle) with Home Assistant’s “Zigbee Home Automation” integration (more commonly referred to as the “ZHA” integration), read the introduction → https://www.home-assistant.io/integrations/zha#introduction as well as the section about what devices are supported by default out-of-the-box → https://www.home-assistant.io/integrations/zha#knowing-which-devices-are-supported …or better yet read through the whole ZHA integration documentation

To add new devices to the network that require the combination of src_ieee (IEEE address of the joining ZB3 device) and the device’s unique “install code” (install code of the joining device) that are written on some Zigbee devices (or their accompanying box/sticker) then you need to add the device by calling the permit service on the zha domain and manually typing in the src_ieee and install_code there, see → https://www.home-assistant.io/integrations/zha#service-zhapermit

Note that commissioning Zigbee 3.0 devices via “Install Code” or “QR Code” via the ‘zha.permit’ service has so far only been implemented for ‘ezsp’ (Silicon Labs EmberZNet) or ‘znp’ (Texas Instruments) radio type in ZHA. Other radio types such as example ConBee/RaspBee and ZiGate are missing support for “install code” in their respective radio libraries for zigpy or manufacturer’s firmware commands/APIs (so you need to address that as a feature request to the respective manufacturer’s firmware developers and zigpy radio library developers). See → https://www.home-assistant.io/integrations/zha#limitations

Also take note that if a device does not show all expected attributes as entities (e.i. sensors and configuration options) in Home Assistant’s ZHA integration even after the device is successfully paired/joined and connected for a while for the interviewing process to finish then that device will likley need a custom “ZHA Device Handler” (also known as “ZHA quirk”) that is unique for its device signature and functions/features, so do submit an issue as Device support request with device signature, etc. for tracking to the “ZHA Device Handlers” (also known as “ZHA quirks”) repository on GitHub → https://github.com/zigpy/zha-device-handlers/issues/

Submit a device feature request → https://www.home-assistant.io/integrations/zha#how-to-add-support-for-new-and-unsupported-devices

The reason why some devices require “ZHA Device Handlers” is explained in this ZHA docs section here → https://www.home-assistant.io/integrations/zha#zha-exception-and-deviation-handling (be sure to also read the explanation why most other devices do not here → https://www.home-assistant.io/integrations/zha#how-to-add-support-for-new-and-unsupported-devices)

FlyingUnicorn · January 23, 2023, 6:58am

Hey @hraschan,
Did you figure out how to do it? I didn’t manage to get the Thermostats interviewed by Z2MQTT.

hraschan · January 24, 2023, 4:44pm

The connection was easy with ZHA. Using them in multiple automations now. Just give ZHA a shot. @FlyingUnicorn

Ey3scr34m · January 29, 2023, 11:18am

I have mine working in Z2MQTT. Did you add the install code (qr code) from the battery compartment? Then it should start the interviewing process and add the thermostat without problems.

2023-01-29 12_16_27-Zigbee2MQTT – Home Assistant

FlyingUnicorn · January 29, 2023, 11:32am

Awesome, thanks!! I’ll test it out later today

Fr0ggynator · January 29, 2023, 8:12pm

How did you manage to pair the device? My thermostat keeps searching for networks but isn’t discovered by ZHA.

martgras · February 7, 2023, 9:43pm

To pair it with ZHA I had to use the zha permit service call and supply the IEEE Address and the install code from the back of the cover

https://www.home-assistant.io/integrations/zha/#service-zhapermit

Hedda · February 8, 2023, 1:21pm

By the way, also check out and please vore in this indirectly related feature request asking for QR code scanning support to be added to the ZHA integration and Home Assistant’s companion apps → Zigbee device provisioning by scanning QR Code = QR camera scanner in ZHA's UI config and companion apps to include new Zigbee 3.0 devices to Home Assistant's ZHA integration?

Fr0ggynator · February 10, 2023, 2:26pm

Thanks for that hint. Tried it, unfortunately I receive an unknown error…

Failed to call service zha.permit. Unknown error

My logs show two Errors:
homeassistant.components.websocket_api.http.connection:

Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/components/websocket_api/decorators.py", line 27, in _handle_async_response
    await func(hass, connection, msg)
  File "/usr/src/homeassistant/homeassistant/components/websocket_api/commands.py", line 646, in handle_execute_script
    await script_obj.async_run(msg.get("variables"), context=context)
  File "/usr/src/homeassistant/homeassistant/helpers/script.py", line 1524, in async_run
    await asyncio.shield(run.async_run())
  File "/usr/src/homeassistant/homeassistant/helpers/script.py", line 409, in async_run
    await self._async_step(log_exceptions=False)
  File "/usr/src/homeassistant/homeassistant/helpers/script.py", line 453, in _async_step
    self._handle_exception(
  File "/usr/src/homeassistant/homeassistant/helpers/script.py", line 476, in _handle_exception
    raise exception
  File "/usr/src/homeassistant/homeassistant/helpers/script.py", line 451, in _async_step
    await getattr(self, handler)()
  File "/usr/src/homeassistant/homeassistant/helpers/script.py", line 684, in _async_call_service_step
    await service_task
  File "/usr/src/homeassistant/homeassistant/core.py", line 1787, in async_call
    task.result()
  File "/usr/src/homeassistant/homeassistant/core.py", line 1824, in _execute_service
    await cast(Callable[[ServiceCall], Awaitable[None]], handler.job.target)(
  File "/usr/src/homeassistant/homeassistant/helpers/service.py", line 756, in admin_handler
    await result
  File "/usr/src/homeassistant/homeassistant/components/zha/api.py", line 1231, in permit
    await application_controller.permit_with_key(
  File "/usr/local/lib/python3.10/site-packages/zigpy_deconz/zigbee/application.py", line 109, in permit_with_key
    raise NotImplementedError()
NotImplementedError

and
homeassistant.helpers.script.websocket_api_script:

raceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/helpers/script.py", line 451, in _async_step
    await getattr(self, handler)()
  File "/usr/src/homeassistant/homeassistant/helpers/script.py", line 684, in _async_call_service_step
    await service_task
  File "/usr/src/homeassistant/homeassistant/core.py", line 1787, in async_call
    task.result()
  File "/usr/src/homeassistant/homeassistant/core.py", line 1824, in _execute_service
    await cast(Callable[[ServiceCall], Awaitable[None]], handler.job.target)(
  File "/usr/src/homeassistant/homeassistant/helpers/service.py", line 756, in admin_handler
    await result
  File "/usr/src/homeassistant/homeassistant/components/zha/api.py", line 1231, in permit
    await application_controller.permit_with_key(
  File "/usr/local/lib/python3.10/site-packages/zigpy_deconz/zigbee/application.py", line 109, in permit_with_key
    raise NotImplementedError()
NotImplementedError

Does anyone have experience with that= I’m running Hassio in a container on a Proxmox hypervisor, the Conbee II is passed through to home assistant and working fine.

Thanks a lot!

martgras · February 10, 2023, 3:27pm

I’m using the Sonoff P dongle (TI).
It seems that the code is not implemented for the deconz handler.

github.com

zigpy/zigpy-deconz/blob/80041b9dbf334e0224b95081fcd49bb2da3e8c5d/zigpy_deconz/zigbee/application.py#L108

    
      
              if self._api is not None:
                  self._api.close()
                  self._api = None
          
          
async def disconnect(self):
              self.close()
          
          
    if self._api is not None:
                  self._api.close()
          
          
async def permit_with_key(self, node: t.EUI64, code: bytes, time_s=60):
              raise NotImplementedError()
          
          
async def start_network(self):
              await self.register_endpoints()
              await self.load_network_info(load_devices=False)
          
          
    try:
                  await self._change_network_state(NetworkState.CONNECTED)
              except asyncio.TimeoutError as e:
                  raise FormationFailure() from e

Hedda · February 11, 2023, 7:03pm

If so then should report that as an issue to zigpy-deconz (deconz radio library for zigpy that ZHA depends on for ConBee/RaspBee serial protocol hardware abstraction interface) → https://github.com/zigpy/zigpy-deconz/issues

Hedda · February 12, 2023, 4:44pm

FYI, went ahead and opened issues at respective deconz repositories for Dresden-Elektronik and zigpy:

github.com/dresden-elektronik/deconz-serial-protocol

Does deCONZ serial protocol for ConBee/RaspBee Zigbee Coordinator adapters not support joining/pairing via install code and qr code?

opened 04:40PM - 12 Feb 23 UTC

Hedda

@manup Reposting from https://github.com/zigpy/zigpy-deconz/issues/214 and https…://github.com/Koenkk/zigbee2mqtt/issues/17492 as a public request to you dresden-elektronik's deCONZ (ConBee) developers because the developers of zigpy (used by Home Assistant's ZHA integration + Zigbee plugins for Domoticz and Jeedom) and zigbee-herdsman (Zigbee2MQTT + IoBroker) replied there that this function is not supported in zigpy-deconz or zigbee-herdsman since the function for install code (and qr code) is not a documented in the linked deCONZ serial protocol documentation: https://github.com/dresden-elektronik/deconz-serial-protocol/blob/master/README.md **UPDATE:** The exact same issue also applies to Zigbee2MQTT (Z2M) and IoBroker (which are both based on zigbee-herdsman): https://github.com/Koenkk/zigbee2mqtt/issues/17492 It started with one user of Home Assistant’s ZHA integration with an ConBee Zigbee Coordinator adapter posted that they could not join/pair a Zigbee 3.0 (ZB3) device that required an "install code", and then some other user replied to that post saying "install code" (and "qr code"?) support is not implemented in the zigpy-deconz radio library for zigpy which the ZHA integration depends on. Is that true? https://github.com/zigpy/zigpy-deconz/blob/80041b9dbf334e0224b95081fcd49bb2da3e8c5d/zigpy_deconz/zigbee/application.py#L108 For reference that specific Zigbee 3.0 device that require install code to join was the "Bosch Thermostat 2": https://community.home-assistant.io/t/bosch-thermostat-2/492845/ [ZHA](https://www.home-assistant.io/integrations/zha) (and [zigpy](https://github.com/zigpy/zigpy)) can set an Install Code for Zigbee 3.0 devices if using Silicon Labs EmberZNet or Texas Instruments Z-Stack ZNP: https://www.home-assistant.io/integrations/zha#services https://www.silabs.com/documents/public/application-notes/an1089-using-installation-codes-with-zigbee-devices.pdf https://wiki.st.com/stm32mcu/wiki/Connectivity:Zigbee_Install_Code Just reposting this issue reported in the Home Assistant community forum: https://community.home-assistant.io/t/bosch-thermostat-2/492845/10 https://community.home-assistant.io/t/bosch-thermostat-2/492845/11 The first device in question was the [Bosch Thermostat II 230 V (BTH-RA / BTH-RM230Z)](https://www.zigbee2mqtt.io/devices/BTH-RA.html), however, I understand that some people using deCONZ or Zigbee2MQTT have reported the same issue with a few other Bosch-branded Zigbee devices, like [Bosch Smoke Alarm II (BSD-2)](https://www.zigbee2mqtt.io/devices/BSD-2.html), Bosch Door/window contact II (RBSH-SWD-ZB), and Bosch BWA-1 water sensor, all of which require adding the install code to pair/join. Another device that been mentioned to require install code is the rotary switch Aqara H1 -> https://github.com/Koenkk/zigbee-herdsman/issues/420 PS: I do not have a ConBee/RaspBee Zigbee Coordinator setup myself any longer so can not replicate it to confirm or disconfirm this but think that it would be a good idea if this could be tracked as a feature request because the function is missing the deconz serial protocol documentation and for deconz firmware based Zigbee Coordinator adapters like ConBee/RaspBee but supported by other Zigbee Coordinator adapters like Silicon Labs and Texas Instruments based Zigbee Coordinator adapters via their respective radio library for zigpy.

and

github.com/zigpy/zigpy-deconz

zigpy-deconz (ConBee/RaspBee adapter) and ZHA support for joining/pairing via install code and qr code?

opened 08:38AM - 12 Feb 23 UTC

Hedda

Some users of Home Assistant’s [ZHA integration](https://www.home-assistant.io/i…ntegrations/zha) with ConBee and RaspBee Zigbee Coordinator adapters from dresden elektronik have posted that they could not join/pair their Bosch Smart Home Zigbee devices that required an install code, and then some other users replied to that post saying that install code (and qr code?) support is not implemented in this zigpy-deconz radio library for zigpy which the ZHA integration depends on. Is that true? https://github.com/zigpy/zigpy-deconz/blob/80041b9dbf334e0224b95081fcd49bb2da3e8c5d/zigpy_deconz/zigbee/application.py#L108 Just reporting this issue reported in the Home Assistant community forum: https://community.home-assistant.io/t/bosch-thermostat-2/492845/10 https://community.home-assistant.io/t/bosch-thermostat-2/492845/11 The first device in question was the [Bosch Thermostat II 230 V (BTH-RA / BTH-RM230Z)](https://www.zigbee2mqtt.io/devices/BTH-RA.html), however, I understand that some people using deCONZ or Zigbee2MQTT have reported the same issue with a few other Bosch-branded Zigbee devices, like [Bosch Smoke Alarm II (BSD-2)](https://www.zigbee2mqtt.io/devices/BSD-2.html), Bosch Door/window contact II (RBSH-SWD-ZB), and Bosch BWA-1 water sensor, all of which require adding the install code to pair/join. https://github.com/dresden-elektronik/deconz-rest-plugin/issues/6476 https://github.com/dresden-elektronik/deconz-rest-plugin/issues/6421 https://github.com/dresden-elektronik/deconz-rest-plugin/issues/5190 I do not have a ConBee or RaspBee setup as Zigbee Coordinator myself any longer so can not replicate to confirm or deny but think this should be tracked if a feature is missing since supported by Silicon Labs and Texas Instruments based Zigbee Coordinator adapters via their respective radio library for zigpy. PS: Both [Silicon Labs (bellows)](https://github.com/zigpy/bellows) and [Texas Instruments (zigpy-znp)](https://github.com/zigpy/zigpy-znp) radio libraries for zigpy do support install code (and qr code) or? https://github.com/zigpy/bellows/blob/8549f277027245f5e63ce1341b7e6c5c75381899/bellows/zigbee/application.py#L845-L866 https://github.com/zigpy/zigpy-znp/blob/c4db8d1151b5a999ead73480faea4ea01b7cb7d7/zigpy_znp/zigbee/application.py#L338-L377

Fr0ggynator · February 15, 2023, 10:30am

Thanks a lot @Hedda - but looks like I need to be patient and hope that the functionality will be implemented for ConBee II

Hedda · February 27, 2023, 12:21pm

I am not so optimistic that install-code and qr-code support will be added to ConBee / RaspBee soon, so if you need/want to use this feature today then probably best to buy a new Silicon Labs or Texas Instruments based Zigbee Coordinator adapter instead, see → Zigbee buyer's guide

FYI, ChrisHae from Dresden Elektronik wrote a reply there that ConBee / RaspBee firmware deconz serial interface does not currently support joining/paring via install code (or QT code) but a firmware update that will add it is on their roadmap for ConBee 2 / RaspBee 2, (though not for the original ConBee / RaspBee which firmware is no longer getting updated features), see ChrisHae’s reply here → Does deCONZ serial protocol for ConBee/RaspBee Zigbee Coordinator adapters not support joining/pairing via install code and qr code? · Issue #20 · dresden-elektronik/deconz-serial-protocol · GitHub

One possible workaround could be to migrate your Zigbee network in ZHA to a newer/modern Silicon Labs EmberZNet (EZSP) or a Texas Instruments Z-Stack (ZNP) based Zigbee Coordinator adapter, (like, for example, a “Sonoff ZBDongle-E” or a “Sonoff ZBDongle-P”), as those support joining/pairing via install code and qr code, and then migrate back (or not), see → https://www.home-assistant.io/integrations/zha#to-migrate-to-a-new-zigbee-coordinator-radio-inside-zha

Another related tip specific to the Bosch Thermostat 2 device is that it might be worth alsy try upgrading the OTA firmware on that Bosch Radiator Thermostat II device (via Zigbee2MQTT), as that was at least mentioned in the Zigbee2MQTT community → [New device support]: Bosch Radiator Thermostat II · Issue #14926 · Koenkk/zigbee2mqtt · GitHub

By the way, for manually upgrading firmware in ZHA after a device has already been joined/paired, see ZHA Toolkit → https://github.com/mdeweerd/zha-toolkit#ota_notify

Hedda · March 31, 2023, 7:28pm

FYI, someone submitted a firmware upgrade image file for Bosch BTH-RA (a.k.a. Smart Thermostat 2) to https://github.com/Koenkk/zigbee-OTA/ as per this PR https://github.com/Koenkk/zigbee-OTA/pull/279 → https://github.com/Koenkk/zigbee-OTA/tree/master/images/Bosch

If you are using the ZHA integration then a tip is to use ZHA-Toolkit to download and upgrade that Zigbee OTA firmware image on that specific device once you have successfully paired/joined it to ZHA → https://github.com/mdeweerd/zha-toolkit/blob/main/README.md#ota_notify—downloadtrigger-device-fw-update

damndoline · April 1, 2023, 6:55pm

Hi,

just to make sure there’s currently no way to use the Bosch Thermostat II with ZHA using a Conbee 2, right?

Just trying to confirm before I send the four new thermostats back

Hedda · April 4, 2023, 9:38am

That is correct, at least until developers that the Desden Elektronik company employee adds support for the missing/needed “install code” feature via a firmware update, see → Does deCONZ serial protocol for ConBee/RaspBee Zigbee Coordinator adapters not support joining/pairing via install code and qr code? · Issue #20 · dresden-elektronik/deconz-serial-protocol · GitHub

Until then the best workaround is to instead just buy a brand new Texas Instruments or Silicon Labs based Zigbee Coordinator radio adapter/dongle (that has their newer Zigbee radio chips which support newer more modern firmware) and then simply migrate your Zigbee network to that new adapter/dongle.

If you are currently using the Phoscon/deCONZ or Zigbee2MQTT applications as your Zigbee gateway application then it is unfortunately only possible to do partial Zigbee network migration (and even that not fully seamlessly), but it is possible to do a fully seamless migration if you are already using Home Assistant’s own native ZHA integration as long as you first upgrade to latest ConBee/RaspBee firmware. See → https://www.home-assistant.io/integrations/zha#migrating-to-a-new-zigbee-coordinator-adapter-inside-zha

Otherwise you could try performing a two-step partial migration if using Phoscon/deCONZ or Zigbee2MQTT as then you can first migrate to Home Assistant’s own native ZHA integration, but be warned that will only be a partial migration that require repairing some devices and reconfiguring all automations that use any of them, checkout these migration guides → https://skyconnect.home-assistant.io/zigbee-migration-selection/

As for which dongles you should buy I recommend Home Assistant SkyConnect if both want to sponsor Nabu Casa development and like something that is very easy to maintain as long as using Home Assistant’s own native ZHA integration, otherwise recommend that you check out both ITead’s “Sonoff Zigbee 3.0 USB Dongle Plus” (model “ZBDongle-P” which is best for Zigbee2MQTT) as well as their other variant which is “Sonoff Zigbee 3.0 USB Dongle Plus V2” (model “ZBDongle-E” for ZHA). Note that if you plan on using Zigbee2MQTT (Z2M) then currently only Texas Instruments CC2652 or CC1352 based adapters are recommended.

damndoline · April 11, 2023, 12:07am

Thanks a lot @Hedda!

As I really like the thermostats I bought a Sonoff dongle with CC2652P and also moved from ZHA to Zigbee2MQTT in the process.

Everything working now

pdsccode · October 21, 2023, 9:17am

Just to add to this: I switched to a SkyConnect Dongle, which enabled the use of pairing codes. Pairing works as expected now.

However, there is a slight “problem” when using this thermostat in conjunction with ZHA. The heater modes as well as on/off do not work due to some issues with the ZHA quirk. The fix is already requested with [Device Support Request] Full implementation of BOSCH Radiator Thermostat II (BTH-RA) · Issue #2476 · zigpy/zha-device-handlers (github.com) but for now, only the temperature settings work fine for me. Just keep this in mind.