Matter ESP32 Lighting Example#

This example demonstrates the Matter Lighting application on ESP platforms.

Please setup ESP-IDF and CHIP Environment and refer building and commissioning guides to get started.

Building example for Target ESP32-C6#

ESP32-C6 supports both Wi-Fi and Thread transport protocols.

  • To build for Matter Over Wi-Fi

    idf.py set-target esp32c6 build
    
  • To build for Matter Over Thread, use custom configuration file

    idf.py -DSDKCONFIG_DEFAULTS="sdkconfig.defaults;sdkconfig.defaults.esp32c6_thread" set-target esp32c6 build
    

Enabling ESP-Insights:#

  • Before building the app, enable the option: ESP_INSIGHTS_ENABLED through menuconfig.

  • Create a file named insights_auth_key.txt in the main directory of the example.

  • Follow the steps present here to set up an insights_account and the auth key created while setting it up will be used in the example.

  • Download the auth key and copy Auth Key to the example

cp /path/to/auth/key.txt path/to/connectedhomeip/examples/lighting-app/esp32/main/insights_auth_key.txt

Cluster Control#

  • After successful commissioning, use the OnOff cluster command to control the OnOff attribute. This allows you to toggle a parameter implemented by the device to be On or Off.

    $ ./out/debug/chip-tool onoff on <NODE ID> 1
    
  • On ESP32C3-DevKitM or ESP32S3-DevKitM board, there is an on-board RGB-LED. Use ColorControl cluster command to control the color attributes:

    $ ./out/debug/chip-tool colorcontrol move-to-hue-and-saturation 240 100 0 0 0 <NODE ID> 1
    

Matter OTA#

For Matter OTA please take a look at Matter OTA guide.