esp-idf/examples/bluetooth/esp_ble_mesh/remote_provisioning/README.md

2.7 KiB

Supported Targets ESP32 ESP32-C3 ESP32-C5 ESP32-C6 ESP32-H2 ESP32-S3

Remote Provisioning

(See the README.md file in the upper level 'examples' directory for more information about examples.)

The example is primarily used to demonstrate the new Remote Provisioning feature added in Mesh Protocol v1.1.

How to use example

Please refer to this tutorial for detailed instructions on how to run it.

Hardware Required

You need prepare at least three ESP series development boards. We recommend using the ESP32-C3-DevKitM-1 or ESP32-C6-DevKitC-1. Alternatively, you can use other development boards, but ensure that each board has at least one LED and one button for operation.

Configure the project

idf.py menuconfig

Build and Flash

Build the project and flash it to the board, then run monitor tool to view serial output:

idf.py -p PORT flash monitor

(Replace PORT with the name of the serial port to use.)

(To exit the serial monitor, type Ctrl-].)

See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.

Example Output

When a device that runs the rpr_server joins the network, the device that runs the rpr_client will have the following log output:

The Remote Provisioning Server have been provisioned, You could click button to start remote provisioning

After seeing this output log, you can press the button on the device running rpr_client to initiate the Remote Provisioning process.

After successfully joining the network through Remote Provisioning, the device running rpr_client will have the following log output:

Remote Prov Client Prov Complete
Net Idx: `net index`
Node addr: `node address`
Node element num: `element num`
Node UUID: `UUID`

(The content wrapped with will vary depending on the device you are actually using.)

Afterwards, you can press the button on the device running rpr_client to toggle the LED settings of other devices in the network.

Troubleshooting

See common troubleshooting for Directed Forwarding examples from ESP-BLE-MESH FAQ.

(For any technical queries, please open an issue on GitHub. We will get back to you as soon as possible.)