Frequently Asked Questions and Troubleshooting for Matter over Wi-Fi#
1. Bluetooth connection fails when trying to commission the system through the chip-tool:#
Command leading to error:
$ out/standalone/chip-tool pairing ble-wifi 1122 mySSID myPassword 20202021 3840
mySSID is your AP's SSID and
mypassword is your AP's password.
[1659464425.856025][34818:34823] CHIP:DL: HandlePlatformSpecificBLEEvent 16386 [1659464425.856035][34818:34823] CHIP:IN: Clearing BLE pending packets. [1659464425.856055][34818:34823] CHIP:IN: BleConnection Error: ../../examples/chip-tool/third_party/connectedhomeip/src/platform/Linux/bluez/Helper.cpp:1775: CHIP Error 0x000000AC: Internal error
This error indicates that the Bluetooth connection between your system and laptop is failing. Follow the given procedure and then retry the chip-tool commissioning command.
Stop Bluetooth service:
$ systemctl stop bluetooth.service
Wait 20 seconds
Restart Bluetooth service:
$ sudo service bluetooth restart
Unblock Bluetooth service:
$ rfkill unblock all
Enable Bluetooth service:
$ sudo systemctl enable bluetooth
Issue the pairing command:
$ out/standalone/chip-tool pairing ble-wifi 1122 mySSID mypassword 20202021 3840
mySSIDis your AP's SSID and
mypasswordis your AP's password.
2. Unsupported certificate format Error:#
When trying to commission the system, if an
Unsupported certificate formaterror (example below) is encountered, follow the procedure stated below.
[1659631352.672826][5076:5076] CHIP:TOO: Run command failure: ../../examples/chip-tool/third_party/connectedhomeip/src/controller/CHIPDeviceController.cpp:1275: CHIP Error 0x00000050: Unsupported certificate format
Delete the existing certificates on your laptop with the following command run from the
$ /bin/rm /tmp/chip_*
Issue the commissioning command
3. WLAN connection fails from RS9116 during commissioning when channel 13 is selected on the AP:#
The required channel becomes available for connection when the WLAN connection region is configured during compilation to one that supports the channel, such as for Japan for channel 13.
In order to use the desired channel, before building, make sure the WLAN connection region is configured correctly by reviewing/modifying the following lines in /examples/platform/efr32/rs911x/rsi_wlan_config.h:
//Make sure this is set to RSI_ENABLE #define RSI_SET_REGION_SUPPORT RSI_ENABLE // Note that the channels available for WLAN connection depend on the region selected // Make sure this is set to 1 to configure from RSI_REGION_CODE value below // 0: region configurations taken from beacon // 1: region configurations taken from user #define RSI_SET_REGION_FROM_USER_OR_BEACON 1 // 0 : Default Region domain // 1 : US // 2 : EUROPE // 3 : JAPAN #define RSI_REGION_CODE 3
4 . Incorrect firmware version#
You will get appropriate firmware in the above mentioned path.
How to check the current using firmware version?
You can find the currently using firmware version in the DUT log.
How to check whether you are using correct firmware vesrsion or not?
Compare last 5 digits of fimware version mention in the above path with the currently using firmware version.
5 . Apple Homepod associated failures#
If there is an Apple Homepod on the network paired with a Thread device, and a commissioning failure is seen with error
Either remove the Apple Homepod from the network, or unpair it from all Thread devices, before re-trying the commissioning.
6 . Commissioning failure at step 18#
Verify router configuration specifically related to IPV6 SLAAC, Internet Group Management Protocol (IGMP) snooping.
Delete all the files of chip-tool /tmp folder. (
rm -rf /tmp/chip_*)
After checking the router configuration, factory-reset your access point.
7. Commissioning failure at step 16#
Verify the access point settings, SSID, PSK, secirity type, REGION, CHANNEL.
8 . Inconsistent logs#
Verify external power is supplied to rs911x
9 . To enable different security options on AP/Router#
Get the router address by entering
route -nor ifconfig of ipconfig.
Enter the router address in the browser and enter the appropriate username and password.
Select the appropriate band.
In security, select type (WPA / WPA2 / WPA3).
10. CHIP Logs are not available on MG12 + WF200 due to image size constraints:#
This prevents debugging the code on the MG12 + WF200 device combination.
In order to work around this constraint, disable either the LCD or the use of QR codes, depending on your debugging needs. Disabling one of these will sufficiently reduce the image size to allow CHIP Logging to be enabled.
If you disabled QR Codes, you may use the
chip-tool for commissioning the device.
If you disabled the LCD and need to debug with QR Codes, the URL to display the QR Code will be printed in the device logs.
Disable LCD and enable CHIP Logging:
./scripts/examples/gn_efr32_example.sh examples/lock-app/efr32 out/wf200_lock_app BRD4161A is_debug=false disable_lcd=true --wifi wf200 |& tee out/wf200_lock_app.log
Disable QR Code and enable CHIP Logging:
./scripts/examples/gn_efr32_example.sh examples/lock-app/efr32 out/wf200_lock_app BRD4161A is_debug=false show_qr_code=false --wifi wf200 |& tee out/wf200_lock.log