mirror of https://github.com/espressif/esp-idf.git synced 2024-10-05 20:47:46 -04:00

History

Mahavir Jain 5fffe4bba5 Merge branch 'fix/fix_protocomm_security2_backward_compatibility' into 'master' wifi_prov: Update behaviour for wifi_prov_mgr_start_provisioning to avoid... See merge request espressif/esp-idf!20003		2022-10-02 23:08:01 +08:00
..
wifi_prov_mgr	Merge branch 'fix/fix_protocomm_security2_backward_compatibility' into 'master'	2022-10-02 23:08:01 +08:00
.build-test-rules.yml	feat: use standalone project idf-build-apps for find/build apps utils	2022-07-14 08:26:31 +08:00
README.md	provisioning: Remove legacy examples section from README	2022-01-28 09:58:43 +05:30

README.md

Provisioning Application Examples

This primarily consists of a single unified example wifi_prov_mgr

wifi_prov_mgr Abstracts out most of the complexity of Wi-Fi provisioning and allows easy switching between the SoftAP (using HTTP) and BLE transports. It also demonstrates how applications can register and use additional custom data endpoints.

Provisioning applications are available for various platforms:

Android:
- BLE Provisioning app on Play Store.
- SoftAP Provisioning app on Play Store.
- Source code on GitHub: esp-idf-provisioning-android.
iOS:
- BLE Provisioning app on app store
- SoftAP Provisioning app on app Store
- Source code on GitHub: esp-idf-provisioning-ios
For all other platforms a python based command line tool is provided under "$IDF_PATH/tools/esp_prov"

The Android and iOS provisioning applications allow the user to configure the device manually or by scanning a QR code. QR codes can be generated by any online QR code generator. QR code payload is encoded with a JSON string containing the device name, proof-of-possession key (if used) and transport type (BLE or softAP), for example:

{"ver":"v1","name":"PROV_000318","pop":"a1000318","transport":"softap"}

The more details about QR code format, you can refer to QR Code Scan.