ESP32-2424S012N/C: GPIO mapping for onboard buttons and how to read battery level (%) ?

[xtieume]

Hi,

I am using the ESP32-2424S012N/C (ESP32-C3, 1.28” round display) board.

This board includes:
• A BOOT / RESET button
• A second onboard user switch
• A battery connector (BAT+ / BAT-) with charging and power management circuit

Button status (what I confirmed)
• The BOOT button works on GPIO9
• Configuring GPIO9 in code correctly detects the BOOT button

However, I cannot find clear documentation for:
• The second onboard switch
• How to read battery voltage / battery percentage

Questions – Buttons
1. Which GPIO is the second onboard switch connected to?
2. Is this switch active LOW or active HIGH?
3. Does it have an external pull-up or pull-down resistor, or should internal pull-ups be enabled?
4. Is it safe to use this switch as a normal GPIO input during runtime (no boot/strapping impact)?

Questions – Battery
1. Is the battery voltage (BAT+) connected to any ESP32 ADC pin on this board?
2. If yes:
• Which GPIO / ADC channel should be used?
• What is the resistor divider ratio?
3. If not:
• Is battery level not measurable in software on this board without hardware modification?
4. Is there any recommended method or reference code to calculate battery percentage (%) for this board?

Goal

I want to:
• Correctly read both onboard buttons
• Display battery level (%) in my application (Arduino / ESP-IDF)

Any clarification, schematic reference, or official documentation would be greatly appreciated.

Thanks!

[fbiego]

Hello,
For hardware-related questions, please note that I did not design the board itself. For accurate details, you should refer to the board’s datasheet or documentation.
Regarding the firmware, the project currently does not include a function to read the battery level. If you need this feature, you will need to implement it based on your specific requirements.