Controller

This example creates a Matter Controller using the ESP Matter data model.

See the docs for more information about building and flashing the firmware.

1. Additional Environment Setup

No additional setup is required.

2. Controller Example

See the docs for more information about pairing and controling an end-device using this example

3. Controller in Rainmaker Fabric

Matter Controller in Rainmaker Fabric is avaliable in Rainmaker Matter Examples

4. OpenThread Border Router (OTBR) feature

4.1 Hardware Platform

See the docs for more information about the hardware platform.

4.2 Build

The sdkconfig file sdkconfig.defaults.otbr is provided to enable the OTBR feature on the controller. Build and flash the controller example with the sdkconfig file 'sdkconfig.defaults.otbr'

idf.py -D SDKCONFIG_DEFAULTS="sdkconfig.defaults.otbr" set-target esp32s3 build
idf.py -p <PORT> erase-flash flash monitor

Notes: The Thread Border Router DevKit Board uses USB port.

4.3 Pair and Control

Connect the controller to Wi-Fi network with the device console

matter esp wifi connect {ssid} {password}

Initializing a new Thread network dataset and commit it as the active one

matter esp ot_cli dataset init new
matter esp ot_cli dataset commit active

Getting the operational dataset TLV-encoded string. The <dataset_tlvs> will be printed.

matter esp ot_cli dataset active -x

Starting the Thread network

matter esp ot_cli ifconfig up
matter esp ot_cli thread start

Pairing the Thread end-device

matter esp controller pairing ble-thread 1234 <dataset_tlvs> 20202021 3840

Control the Thread end-device on the device console (On/Off cluster Toggle command)

matter esp controller invoke-cmd 1234 1 6 2

A1 Appendix FAQs

A1.1 Pairing Command Failed

I cannot finish the commissioning on the controller example:

For onnetwork pairing, please make sure that the end-device and the controller are on the same IP-network.
The controller uses the hard-code test PAA certification so the PAI and DAC on the end-device should be generated by the test cert and the test key
If you are still facing issues, reproduce the issue on the default example for the device and then raise an issue. Make sure to share these:
- The complete device logs for both the devices taken over UART.
- The esp-matter and esp-idf branch you are using.

A1.2 Command Send Failed

I cannot send commands to the light from the controller:

Make sure the pairing command was a success.
Currently the cluster commands and write-attribute commands are only supported for on-off, level-control, and color-control clusters.
The CASESession will be lost on end-device after reboot. But the controller will still send commands on the previous CASESession. The controller will release previous CASESession after the last command is timeout. So the second command will re-establish a new CASESession in this situation.
If you are still facing issues, reproduce the issue on the default example for the device and then raise an issue. Make sure to share these:
- The complete device logs for both the devices taken over UART.
- The esp-matter and esp-idf branch you are using.

3.9 KiB Raw Permalink Blame History