I just bought the radiator thermostat Bosch BTH-RA, which is Zigbee based and is requiring an “install code” for pairing.
As I discovered now, my current Zigbee USB stick (ConBee II) does not support it “yet” (still on Roadmap since 2 years), so i thought of migrating the hardware platform to Home Assistant Yellow.
But does Home Assistant Yellows’ Zigbee module (MGM210P) supports “install code”, or will i just receive the same error as on the ConBee II USB stick?
The chip on the yellow has nothing to do with whether it supports an install code. Everything ZigBee related is handled by the ZigBee integration.
In your case, the default integration on the yellow would probably be ZHA, which seems to allow setting the install code based on this .
Hedda
(Hedda)
March 28, 2024, 9:49am
3
Yes, any newer Silicon Labs EmberZNet and Texas Instruments Z-Stack based Zigbee Coordinator does support it, (and note that not even the new ConBee III adapter support “install code” as of yet)
Personally I recommed buying a USB dongle/stick format Zigbee Coordinator so that you can connect it via a USB extnsion cable for better placement to get it away from any sources of interference, see → Zigbee networks: how to guide for avoiding interference + optimizing using Zigbee Router devices (repeaters/extenders) to get best possible range and coverage
That is not true, there needs to be support for it in the firmware and API for it needs to be documented.
So it is true older Zigbee Coordinator SoC chip as older Zigbee stack running on those do not support “install code” (or “qr code”), and even if they did then they also need to provide API documentation on how to use it via their serial interface. There is a summery explaination of this under “Limitations” in ZHA docs:
https://www.home-assistant.io/integrations/zha#limitations
Support for 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 are missing support in their respective radio libraries for zigpy or manufacturer’s firmware commands/APIs.
FYI, there is more information about Bosch BTH-RA (a.k.a. Smart Thermostat 2) in this other thread → Bosch Thermostat 2
Is it possible to connect the Bosch Thermostat 2 only by using ZigBee? So not using the Bosch Controller to connect to Home Assistent?
2 Likes
Hedda
(Hedda)
March 28, 2024, 9:58am
4
By the way, more on ConBee’s lack of support in these feature request to manufacturer and upstream:
opened 04:40PM - 12 Feb 23 UTC
@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
opened 08:38AM - 12 Feb 23 UTC
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
1 Like
Baahver
(Bart)
April 5, 2024, 2:40pm
5
Maybe I understand you wrong, but the Conbee-II does support install_code.
I have one and have succesfully installed a Bosch Door/Windows II plus sensor by entering the Install_code and source_IEEEE in Home Assistant.
You could find these here:
Development tools
Tab Services
Service: Zigbee Home Automation: Permit
and there enter only the Install_code and Source_IEEEE
Edit: Maybe these are available because I installed ZHA_toolkit via Hacs.