Skip to content

Commit

Permalink
provisioning: Update README.md to explain QR code format
Browse files Browse the repository at this point in the history
Add examples of how to create a QR code that will be recognised by the iOS or Android app

Signed-off-by: yuanjm <[email protected]>

Merges #6629
  • Loading branch information
mjcross authored and ESP-YJM committed Mar 19, 2021
1 parent 9a2d251 commit c2ba180
Showing 1 changed file with 12 additions and 0 deletions.
12 changes: 12 additions & 0 deletions examples/provisioning/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,18 @@ Provisioning applications are available for various platforms:
- Source code on GitHub: [esp-idf-provisioning-ios](https://github.com/espressif/esp-idf-provisioning-ios)
* For all other platforms a python based command line tool is provided under "$IDF_PATH/tools/esp_prov"

The Andriod and iOS provisioning applications allow the user to select the device manually or by scanning a QR code. Suitable QR codes can be generated by encoding a text string containing the device name, prooof-of-posession key (if used) and transport type (BLE or softAP), for example:

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

or

```
{"ver":"v1","name":"PROV_EB15D5","pop":"abcd1234","transport":"ble"}
```

## Legacy Examples

The legacy examples require own implementation of provisioning functions and handlers. The Wi-Fi provisioning component abstracts out most of this complexity and provides a simpler interface and so, that is recommended for use. However, if you want to use lower level provisioning and protocomm APIs, you can check the these examples under legacy/ folder:
Expand Down

0 comments on commit c2ba180

Please sign in to comment.