This example creates a Generic Switch device using the ESP Matter data model. This example demonstrates the use of few optional data model elements like :

Taglist Feature of Descriptor Cluster : used to disambiguate sibling endpoints where two or more sibling endpoints have an overlap in the supported device types with each such endpoint having a unique TagList.

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

1. Additional Environment Setup

1.1 Building the firmware

There are two types of switches in the example which can be configured through menuconfig:

idf.py menuconfig -> Demo -> Generic Switch Type
To use latching switch, enable GENERIC_SWITCH_TYPE_LATCHING.
To use a momentary switch, enable GENERIC_SWITCH_TYPE_MOMENTARY.
By default momentary switch i.e GENERIC_SWITCH_TYPE_MOMENTARY is enabled.

1.2 Enabling insights (Optional)

Follow the steps mentioned here

2.Commissioning and Control

Commission the device with discriminator: 3840and passcode: 20202021

chip-tool pairing ble-wifi 0x7283 [ssid] [password] 20202021 3840

To read the taglist of the Descriptor cluster execute the command given below.

chip-tool descriptor read tag-list 0x7283 1

3. Post Commissioning Setup

This should be followed by: Commission the generic switch device

Turn on chip-tool interactive mode. ./chip-tool interactive start
By default momentary switch is enabled so subscribe to long-press event via chip-tool. switch subscribe-event long-press <min-interval> <max-interval> <destination-id> <endpoint-id>
Double press the boot button on device so that client will receive event after max-interval.

3.1 Latching switch

Following are latching switch events mapped with boot button on device.

Double Press -----------> switch-latched

3.2 Momentary switch

Following are momentary switch events mapped with boot button on device.

Button Press Down -----------> initial-pressed
Button Press Up ( Release ) -----------> short-release
Button Long Press ( 5 sec ) -----------> long-pressed
Button Press Up ( Long Release ) -----------> long-release
Button Press Repeat -----------> multipress-ongoing
Button Press Repeat Done -----------> multipress-completed

3. Device Performance

3.1 Memory usage

The following is the Memory and Flash Usage.

Bootup == Device just finished booting up. Device is not commissionined or connected to wifi yet.
After Commissioning == Device is conneted to wifi and is also commissioned and is rebooted.
device used: esp32c3_devkit_m
tested on: 4881109 (2022-12-15)

	Bootup	After Commissioning
Free Internal Memory	94KB	110KB

Flash Usage: Firmware binary size: 1.24MB

This should give you a good idea about the amount of free memory that is available for you to run your application's code.

README.md

Generic Switch