Matter Binding

Add-ons Bindings
,
156

I FINALLY figured out how to commission a dimmer (Inovelli White Series) with the ESP32 OpenThread border router, without use of any other thread router! Here are the steps.

  • Build and configure the ESP Thread BR according to instructions, ensure the OTBR has IPv6 connectivity (you can ping it from the LAN, but the ping command on the OTBR doesn’t work, don’t worry about that)
  • On the OTBR, issue the command dataset active -x to obtain the operational dataset as a long hex string.
  • Build or download chip-tool
  • Obtain the pairing code (11-digit) or QR code from the device. Use a tool like SetupPayload to decode it and extract the pin code (8-digit) and discriminator values
  • Enter pairing mode on the device, for this dimmer it’s done by pressing the config button 3 times.
  • Commission the device onto the thread network with BLE using chip-tool pairing ble-thread <node-id> hex:<dataset> <pin> <discriminator>. The node ID is arbitrary. For example:
chip-tool pairing ble-thread 100 hex:0e08000... 20202021 3840
  • This failed for me in the Attestation step, saying it couldn’t find the attestation certification. Turns out this has to be downloaded from the DCL registry. I did this by grabbing the X.509 certificate from the chip-tool log, looking at the issuer which was HOPERF Matter PAA 01, and searching for “HOPERF” in the registry. Then download the PAA certificate, stick it in credentials/production/paa-root-certs/ in the connectedhomeip repo, and append --paa-trust-store-path credentials/production/paa-root-certs to the above chip-tool invocation.
  • Assuming pairing succeeds, the device is now commissioned to chip-tool’s fabric. We need to allow commissioning to openHAB:
chip-tool pairing open-commissioning-window <NODEID> 1 300 1000 <DISCR>

substituting your node ID and discriminator. This command prints out a manual setup code and QR code, different from the original one printed on the device.

  • Now go to openHAB, view the controller Thing, and choose the “Pair a Matter device” action as usual (described in the binding’s README), using the pairing code from the command above.

That’s it, the device should now be commissioned to openHAB and show up in the Inbox. Great Success!!

Thread / Matter - Lost in Setup