mirror of https://github.com/espressif/esp-idf.git synced 2024-10-05 20:47:46 -04:00

History

laokaiyao c731b099ee remove(c5beta3): remove c5 beta3 doxy files		2024-06-17 12:02:15 +08:00
..
main	feat(blink): add sdkconfig defaults for each target	2024-02-07 10:32:22 +08:00
CMakeLists.txt	led_strip: use component manager in the example	2022-08-12 10:48:21 +08:00
pytest_blink.py	feat(blink): add sdkconfig defaults for each target	2024-02-07 10:32:22 +08:00
README.md	remove(c5beta3): remove c5 beta3 doxy files	2024-06-17 12:02:15 +08:00
sdkconfig.defaults	feat(blink): add sdkconfig defaults for each target	2024-02-07 10:32:22 +08:00
sdkconfig.defaults.esp32	feat(blink): add sdkconfig defaults for each target	2024-02-07 10:32:22 +08:00
sdkconfig.defaults.esp32c3	feat(blink): add sdkconfig defaults for each target	2024-02-07 10:32:22 +08:00
sdkconfig.defaults.esp32c5	feat(blink): add sdkconfig defaults for each target	2024-02-07 10:32:22 +08:00
sdkconfig.defaults.esp32c6	feat(blink): add sdkconfig defaults for each target	2024-02-07 10:32:22 +08:00
sdkconfig.defaults.esp32h2	fix(blink): fix sdkconfig defaults name	2024-06-05 10:03:45 +07:00
sdkconfig.defaults.esp32s2	feat(blink): add sdkconfig defaults for each target	2024-02-07 10:32:22 +08:00
sdkconfig.defaults.esp32s3	feat(blink): add sdkconfig defaults for each target	2024-02-07 10:32:22 +08:00

README.md

Supported Targets	ESP32	ESP32-C2	ESP32-C3	ESP32-C5	ESP32-C6	ESP32-H2	ESP32-P4	ESP32-S2	ESP32-S3

Blink Example

(See the README.md file in the upper level 'examples' directory for more information about examples.)

This example demonstrates how to blink a LED by using the GPIO driver or using the led_strip library if the LED is addressable e.g. WS2812. The led_strip library is installed via component manager.

How to Use Example

Before project configuration and build, be sure to set the correct chip target using idf.py set-target <chip_name>.

Hardware Required

A development board with normal LED or addressable LED on-board (e.g., ESP32-S3-DevKitC, ESP32-C6-DevKitC etc.)
A USB cable for Power supply and programming

See Development Boards for more information about it.

Configure the Project

Open the project configuration menu (idf.py menuconfig).

In the Example Configuration menu:

Select the LED type in the Blink LED type option.
- Use GPIO for regular LED
- Use LED strip for addressable LED
If the LED type is LED strip, select the backend peripheral
- RMT is only available for ESP targets with RMT peripheral supported
- SPI is available for all ESP targets
Set the GPIO number used for the signal in the Blink GPIO number option.
Set the blinking period in the Blink period in ms option.

Build and Flash

Run idf.py -p PORT flash monitor to build, flash and monitor the project.

(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

As you run the example, you will see the LED blinking, according to the previously defined period. For the addressable LED, you can also change the LED color by setting the led_strip_set_pixel(led_strip, 0, 16, 16, 16); (LED Strip, Pixel Number, Red, Green, Blue) with values from 0 to 255 in the source file.

I (315) example: Example configured to blink addressable LED!
I (325) example: Turning the LED OFF!
I (1325) example: Turning the LED ON!
I (2325) example: Turning the LED OFF!
I (3325) example: Turning the LED ON!
I (4325) example: Turning the LED OFF!
I (5325) example: Turning the LED ON!
I (6325) example: Turning the LED OFF!
I (7325) example: Turning the LED ON!
I (8325) example: Turning the LED OFF!

Note: The color order could be different according to the LED model.

The pixel number indicates the pixel position in the LED strip. For a single LED, use 0.

Troubleshooting

If the LED isn't blinking, check the GPIO or the LED type selection in the Example Configuration menu.

For any technical queries, please open an issue on GitHub. We will get back to you soon.