CHIP ESP32 OTA Provider Example

A prototype application that demonstrates OTA provider capabilities.

Supported Devices

• This example supports ESP32 and ESP32C3. For details please check here.

Copy the OTA image

• Copy the binary file which you are going to send to the OTA Requestor to ./spiffs_image path and make sure the OTA_IMAGE_NAME is the same as the name of the image file you placed in ./spiffs_image.

idf.py menuconfig

• Edit the OTA_IMAGE_NAME through Demo->OTA image file name.

Building the Example Application

• If you are building for the first time please check Building the Example Application guide.
• Otherwise, idf.py build works!

Flashing the Example Application

idf.py -p <OTAProviderSerialPort> flash

Commissioning over BLE using chip-tool

• Please build the standalone chip-tool as described here
• Commissioning the OTA Provider

./out/debug/chip-tool pairing ble-wifi 12345 <ssid> <passphrase> 20202021 3841

Access control list requirements

Commissioner or Administrator should install necessary ACL entries at commissioning time or later to enable processing of QueryImage commands from OTA Requestors on their fabric, otherwise that OTA Provider will not be usable by OTA Requestors.

Since the ACL attribute contains a list of entries, we cannot append a single entry to it. So, read the ACL entries and append an entry which grants operate privileges to all nodes for the OTA Provider cluster (0x0029) on every endpoint.

• Read the ACL attribute

./out/debug/chip-tool accesscontrol read acl 12345 0

• Write the ACL attribute

out/chip-tool accesscontrol write acl '[{"fabricIndex": 1, "privilege": 5, "authMode": 2, "subjects": [112233], "targets": null}, {"fabricIndex": 1, "privilege": 3, "authMode": 2, "subjects": null, "targets": [{"cluster": 41, "endpoint": null, "deviceType": null}]}]' 12345 0

First entry created as part of commissioning which grants administer privilege to the node ID 112233 (default controller node ID) for all clusters on every endpoint. Seconds entry is the new entry being added which grants operate privileges to all nodes for the OTA Provider cluster (0x0029) on every endpoint

Set delayed action time (Optional)

• Set delayed action time in the Query Image Response and Apply Update Response, default is zero.

> matter OTAProvider delay <delay seconds>

Once OTA provider is commissioned then head over to OTA Requestor Example.