tree: 3abaee61de496ae44fa451e8fb1192ea8845be9e [path history] [tgz]
  1. data_model/
  2. main/
  3. third_party/
  4. .gitignore
  5. CMakeLists.txt
  6. partitions.csv
  7. partitions_encrypted.csv
  8. README.md
  9. sdkconfig.defaults
  10. sdkconfig.defaults.esp32c2
  11. sdkconfig.defaults.esp32c6
  12. sdkconfig.defaults.esp32c6_thread
  13. sdkconfig.defaults.esp32h2
  14. sdkconfig.defaults.esp32p4
  15. sdkconfig.ext_plat.defaults
  16. sdkconfig.optimize.defaults
  17. sdkconfig.wifi_thread.defaults
  18. sdkconfig_m5stack.defaults
  19. sdkconfig_rpc.defaults
examples/lighting-app/esp32/README.md

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.