LED state inverted on Korvo 2 board (BSP-699)

[ladvoc]

Board

ESP32-S3-Korvo-2 V3.1

Hardware Description

New dev board with no hardware modifications.

IDE Name

VSCode

Operating System

macOS 15.4

Description

When using the BSP for the ESP32-S3-Korvo-2 board, bsp_led_set does not work as expected; when I call bsp_led_set(BSP_LED_BLUE, true), this causes the LED to turn off instead of on.

Sketch

bsp_i2c_init();
bsp_leds_init();
bsp_led_set(BSP_LED_RED, false);
// Red LED is turned on instead of off

Other Steps to Reproduce

No response

I have checked existing issues, README.md and ESP32 Forum

• I confirm I have checked existing issues, online documentation and Troubleshooting guide.

[github-actions]

Hi @ladvoc! Please be aware that (1) the following suggestions are generated by a bot and haven't been fact-checked by Espressif Systems, (2) burning eFuses and enabling security features are irreversible operations and can damage your ESP32 device. We hope that this message will help you until an Espressif Engineer looks at your issue.

---

Thank you for reporting this issue. Based on the official BSP documentation for the ESP32-S3-Korvo-2, the function bsp_led_set(led_io, on) is intended to turn the specified LED on or off, where passing true should turn the LED on, and false should turn it off:

esp_err_t bsp_led_set (
    const bsp_led_t led_io,
    const bool on
)

• led_io: LED IO
• on: Switch LED on/off

However, you are observing that calling bsp_led_set(BSP_LED_RED, false) turns the LED on, and bsp_led_set(BSP_LED_RED, true) turns it off, indicating the LED logic is inverted on your board.

The knowledge sources do not explicitly mention the expected electrical behavior (active-high or active-low) of the LEDs on the ESP32-S3-Korvo-2 board. This means the documentation does not clarify whether setting the output to "on" drives the LED pin high or low, nor does it specify if the LEDs are wired as active-low (where a logic low turns the LED on) or active-high (where a logic high turns the LED on) API Reference - Functions Documentation.

Given this, your observation suggests that the LEDs on the ESP32-S3-Korvo-2 are likely wired as active-low, so setting the output "on" (true) actually drives the pin low, turning the LED on, and vice versa. This is a common hardware design, but it is not documented in the BSP API references.

Recommendation:

• The behavior you are seeing is consistent with active-low LED wiring, but the documentation does not clarify this.
• If this is not the intended behavior, it may be worth raising this as a documentation improvement request or bug with Espressif, so the BSP documentation can clarify the expected logic level for "on" and "off" states.

Summary:
The BSP API does not document the LED logic level, but your findings are consistent with active-low wiring. If you need to invert the logic in your application, you can do so as a workaround until the documentation is clarified API Reference - Functions Documentation.

[espzav]

@ladvoc Thank you for report this issue. We will fix it soon in PR #610