Nuki Smart Lock Pro Gen 5 fails Matter commissioning with Home Assistant Connect ZBT-2
Hello everyone,
I’m looking for some technical advice regarding Matter commissioning of a Nuki Smart Lock Pro Gen 5.
Hardware
Nuki Smart Lock Pro Gen 5
Firmware 5.7.11
Home Assistant running in a VM on Unraid
Home Assistant Connect ZBT-2
Existing Zigbee coordinator used only for Zigbee
ZBT-2 dedicated to Thread
Home Assistant configuration
OpenThread Border Router running
Thread network created and set as Preferred Network
Thread integration reports one active Border Router
Matter Server running correctly
Matter integration online
Home Assistant has a fixed LAN IP
Problem
Matter commissioning always fails with:
“Something went wrong. Connect to your network and try again.”
The failure occurs at the same point every time.
What has already been tested
Factory reset of the lock.
Lock configured again from scratch.
Firmware confirmed as 5.7.11.
Bluetooth communication works.
QR code and manual Matter setup code both tested.
Home Assistant Matter commissioning tested.
Google Home Matter commissioning tested.
Two different Android phones tested.
OpenThread Border Router confirmed active.
Matter Server confirmed operational.
Thread network confirmed active.
The result is always identical.
Conversation with Nuki Support
Nuki Support informed me that the Home Assistant Connect ZBT-2 is currently not listed as a supported Matter Hub. However, it was not entirely clear whether this means:
it is technically incompatible, or
it has simply not been officially tested by Nuki.
Since the ZBT-2 is the official successor to the Home Assistant Connect ZBT-1 and functions correctly as an OpenThread Border Router, I would like to know whether anyone has successfully commissioned a Nuki Smart Lock Pro Gen 5 using a ZBT-2.
Has anyone managed to get this combination working, or is there a known compatibility issue between the current Nuki firmware and the Home Assistant Connect ZBT-2?
Any technical insights would be greatly appreciated.
I also was struggling with commissioning my devices using a mobile phone (maybe some combination of having an IoT only network etc etc.
The one thing that reliably works is just NOT USING any mobile phone. Just commission the devices from within HA.
The Steps:
Make sure you have Bluetooth on your HA (can be extended with esphome bluetooth proxies.)
Make sure you are using the latest matter app on HA (matter.js based, should currently be standard with version 9.0.0 and above)
In the matter app, go to config and select “show not used optional configs” (not sure on the exact wording, i am using different language)
Enable “Enable BLE proxy”
This will restart the matter server
(Now i don’t know if the following is supposed to happen automatically but in case the credentials were not automatically populated, follow these here)
Go to your Thread settings in home assistant settings (Settings → Thread)
Click on the “i” in the circle on the top right.
There are some values there, it should include “Active dataset TLVs:” , copy that value
Now go to the matter server interface (either select “show in sidebar” or click on “open user interface” in the matter app info page)
In there, click on the gear icon on the top right
Scroll down to “Network Credentials”
Enter the “Active dataset TLVs” value copied previously into the “Thread network set”
(end of the possibly optional steps, but should not hurt if you do them anyways)
Still in the Matter Server UI, click on the “Nodes” tab (if not there already) and click on “Commission Node”
Select “Commission new Thread device” (if this is greyed out, make sure you followed the optional steps above and maybe restarted the matter server)
Enter the code (shown below the QR code), NOT the values from the QR code itself…
Wait a while, this should now add the device without anything needing to go to the internet or google or anything
Thank you very much for taking the time to write such a detailed explanation.
Your approach is quite different from what I have been trying so far, especially the part about using Bluetooth directly from Home Assistant instead of relying on the mobile phone for commissioning.
My Home Assistant installation currently does not have Bluetooth available. Based on your explanation, I now realize that this may be an essential requirement for commissioning a Thread device directly from the Matter Server.
I have therefore decided to purchase a supported Bluetooth USB adapter for my Home Assistant VM. Once it arrives, I will follow your instructions step by step:
Enable the Matter BLE Proxy.
Verify the Thread dataset in the Matter Server.
Commission the device directly from the Matter Server UI.
Use the manual setup code instead of scanning the QR code.
I will report back with the results once I have tested everything.
Thank you again for sharing your experience. It has given me a new direction to investigate.
Typically the BLE Proxy functionality utilizes ESPHome ,those you can distribute across your home and those will connect via WiFi. I currently have one BT stick in my HA and multiple ESPs across the home to extend coverage (also for temperature sensors sending data via BLE) .
If you only have a bluetooth/BLE adapter I am not 100% sure that the BLE Proxy option will work (but try that first), maybe you will have to also specify the “Bluetooth Adapter ID” , just enter “0” there…
