esp-idf/examples/provisioning
Angus Gratton 438d513a95 Merge branch 'master' into feature/esp32s2beta_merge 2019-09-16 16:18:48 +10:00
..
ble_prov Merge branch 'master' into feature/esp32s2beta_merge 2019-09-16 16:18:48 +10:00
console_prov Merge branch 'master' into feature/esp32s2beta_merge 2019-09-16 16:18:48 +10:00
custom_config Merge branch 'master' into feature/esp32s2beta_merge 2019-09-16 16:18:48 +10:00
manager ci: limit example test to ESP32s 2019-09-04 10:53:25 +10:00
softap_prov Merge branch 'master' into feature/esp32s2beta_merge 2019-09-16 16:18:48 +10:00
README.md

README.md

Provisioning Application Examples

These consist of the following examples :

  • softap_prov Provisioning involves Wi-Fi station configuration via an HTTP server running on the device, which is initially configured to be in SoftAP mode. After provisioning, device runs in Wi-Fi station mode only and connects to the AP whose credentials were provided during provisioning.

  • ble_prov Provisioning involves Wi-Fi station configuration via BLE service endpoints running on the device initially. After provisioning, BLE is turned off and device runs in Wi-Fi station mode, connecting to the AP whose credentials were provided during provisioning.

  • console_prov Provisioning involves Wi-Fi station configuration via UART console. This is intended for debugging protocomm and provisioning related features.

  • custom_config Similar to softap_prov examples, but allows for configuration of custom (device-local) information during provisioning. This is intended as an example for implementing custom provisioning schemes.

Provisioning applications are available for various platforms:

  • For Android, a provisioning application along with source code is available on GitHub : esp-idf-provisioning-android
  • For iOS, a provisioning application along with source code is available on GitHub : esp-idf-provisioning-ios
  • For all other platforms a python based command line tool is provided under "$IDF_PATH/tools/esp_prov"

Refer to the README.md files in each example directory for more information.