Skip to content

CORE_DEBUG_LEVEL

Flag to control ESP32 core debug output verbosity.

Controls the verbosity level of ESP-IDF core debug messages printed to serial.

Options

  • CORE_DEBUG_LEVEL=0: No debug output (default, recommended)
  • CORE_DEBUG_LEVEL=1: Error messages
  • CORE_DEBUG_LEVEL=2: Warning messages
  • CORE_DEBUG_LEVEL=3: Info messages
  • CORE_DEBUG_LEVEL=4: Debug messages
  • CORE_DEBUG_LEVEL=5: Verbose debug messages

Usage

Add to platformio.override.ini to change the level without modifying tracked files:

[env:esp32dev-v2]
build_flags =
    -D CORE_DEBUG_LEVEL=3

Use CORE_DEBUG_LEVEL=0 for production builds to reduce serial noise. Enable higher levels only when debugging ESP-IDF-level issues.