2022-07-28 09:47:44 +00:00
| Supported Targets | ESP32-S2 | ESP32-S3 |
| ----------------- | -------- | -------- |
2021-01-18 05:27:57 +00:00
# Touch button example
2022-07-28 06:52:53 +00:00
(See the README.md file in the upper level 'examples' directory for more information about examples.)
2021-01-18 05:27:57 +00:00
This example demonstrates how to use the Touch Element library of capacitive touch sensor and set up touch button.
## How to use example
2022-07-28 06:52:53 +00:00
### Hardware Required
* A development board with ESP32-S2 or ESP32-S3 chip
* A touch extension board like [esp32-s2-touch-devkit-1 ](https://docs.espressif.com/projects/espressif-esp-dev-kits/en/latest/esp32s2/esp32-s2-touch-devkit-1/user_guide.html )
2021-01-18 05:27:57 +00:00
### Configure the project
2022-07-28 06:52:53 +00:00
* Set the target of the build by following command, where TARGET can be `esp32s2` or `esp32s3` .
```
idf.py set-target TARGET
```
* Run `idf.py menuconfig` to select a dispatch method for the example.
2021-01-18 05:27:57 +00:00
### Build and Flash
2022-07-28 06:52:53 +00:00
Build the project and flash it to the board, then run monitor tool to view serial output:
2021-01-18 05:27:57 +00:00
```
idf.py -p PORT flash monitor
```
(Replace PORT with the name of the serial port to use.)
(To exit the serial monitor, type ``Ctrl-]``.)
See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.
## Example Output
```
I (331) Touch Button Example: Touch element library installed
I (331) Touch Button Example: Touch button installed
I (341) Touch Button Example: Touch buttons created
I (341) Touch Button Example: Touch element library start
I (1481) Touch Button Example: Button[1] Press
I (1701) Touch Button Example: Button[1] Release
I (2731) Touch Button Example: Button[2] Press
I (2921) Touch Button Example: Button[2] Release
I (3581) Touch Button Example: Button[5] Press
I (3781) Touch Button Example: Button[5] Release
I (3931) Touch Button Example: Button[4] Press
I (4121) Touch Button Example: Button[4] Release
I (4271) Touch Button Example: Button[3] Press
I (4491) Touch Button Example: Button[3] Release
I (4671) Touch Button Example: Button[6] Press
I (4891) Touch Button Example: Button[6] Release
I (5091) Touch Button Example: Button[7] Press
I (5311) Touch Button Example: Button[7] Release
I (5491) Touch Button Example: Button[8] Press
I (5741) Touch Button Example: Button[8] Release
I (5991) Touch Button Example: Button[9] Press
I (7991) Touch Button Example: Button[9] LongPress
I (9991) Touch Button Example: Button[9] LongPress
I (11991) Touch Button Example: Button[9] LongPress
I (12881) Touch Button Example: Button[9] Release
```
2022-07-28 06:52:53 +00:00
## Troubleshooting
For any technical queries, please open an [issue ](https://github.com/espressif/esp-idf/issues ) on GitHub. We will get back to you soon.