This topic describes common issues that occur during network provisioning and their solutions.
Network provisioning fails when testing a device with the demo app from the official website after modifying the app's images
This failure commonly occurs because the device certificate was not replaced. This causes an error when the device parses the password.
Hotspot-based network provisioning fails after permissions are denied
Hotspot-based network provisioning requires permissions to enable the hotspot and switch Wi-Fi networks. If these permissions are not granted, network provisioning fails.
The hotspot SSID is not displayed when using the network provisioning SDK
- Ensure that Wi-Fi is enabled on your mobile phone and check whether the issue is reproducible.
- Check the mobile phone logs to determine if the application calls the API to retrieve the SSID.
If the logs show this API call, it indicates that the application has not registered the Bone-related handler class.
The device receives no data packets during one-click network provisioning
Check the following items.
- Check whether Wi-Fi is enabled during one-click network provisioning.
- Check whether the device has entered network provisioning mode.
Hotspot-based network provisioning is stuck on "Connecting" and then fails
Check the following items.
- Check whether the device has entered network provisioning mode.
- Check whether the ProductKey of the selected product matches the ProductKey of the device.
The Tmall Genie app cannot scan the device's network provisioning QR code
You cannot use the Tmall Genie app to directly provision products that are connected to the platform. Instead, use the public app to provision and attach the device, and then grant authorization to Tmall Genie.
The network provisioning plugin does not retrieve Wi-Fi information (blank) when called by a custom app
Check the following items.
- Ensure that GPS is enabled on your mobile phone and that the app has the required location permission.
-
Directly call the native Android API to retrieve the SSID and check whether the call is successful.
If the native API call is successful, call the
AddDeviceBiz.getInstance().getCurrentSsid(context)API to check whether the SSID can be retrieved.
Can the network provisioning plugin interface (status bar color) be modified?
No. The network provisioning plugin does not provide a customizable interface.