Chapter 2. API Reference
By default, this setting limits which log statements are compiled into the program. For example, selecting
“Warning”would mean that changing log level to “Debug”at runtime will not be possible. To allow
increasing log level above the default at runtime, see the next option.
Available options:
• No output (LOG_DEFAULT_LEVEL_NONE)
• Error (LOG_DEFAULT_LEVEL_ERROR)
• Warning (LOG_DEFAULT_LEVEL_WARN)
• Info (LOG_DEFAULT_LEVEL_INFO)
• Debug (LOG_DEFAULT_LEVEL_DEBUG)
• Verbose (LOG_DEFAULT_LEVEL_VERBOSE)
CONFIG_LOG_MAXIMUM_LEVEL
Maximum log verbosity
Found in: Component config > Log output
This config option sets the highest log verbosity that it’s possible to select at runtime by calling
esp_log_level_set(). This level may be higher than the default verbosity level which is set when the
app starts up.
This can be used enable debugging output only at a critical point, for a particular tag, or to minimize
startup time but then enable more logs once the firmware has loaded.
Note that increasing the maximum available log level will increase the firmware binary size.
This option only applies to logging from the app, the bootloader log level is fixed at compile time to the
separate “Bootloader log verbosity”setting.
Available options:
• Same as default (LOG_MAXIMUM_EQUALS_DEFAULT)
• Error (LOG_MAXIMUM_LEVEL_ERROR)
• Warning (LOG_MAXIMUM_LEVEL_WARN)
• Info (LOG_MAXIMUM_LEVEL_INFO)
• Debug (LOG_MAXIMUM_LEVEL_DEBUG)
• Verbose (LOG_MAXIMUM_LEVEL_VERBOSE)
CONFIG_LOG_COLORS
Use ANSI terminal colors in log output
Found in: Component config > Log output
Enable ANSI terminal color codes in bootloader output.
In order to view these, your terminal program must support ANSI color codes.
Default value:
• Yes (enabled)
CONFIG_LOG_TIMESTAMP_SOURCE
Log Timestamps
Found in: Component config > Log output
Choose what sort of timestamp is displayed in the log output:
• Milliseconds since boot is calulated from the RTOS tick count multiplied by the tick period. This
time will reset after a software reboot. e.g. (90000)
• System time is taken from POSIX time functions which use the ESP32’s RTC and FRC1 timers
to maintain an accurate time. The system time is initialized to 0 on startup, it can be set with an
SNTP sync, or with POSIX time functions. This time will not reset after a software reboot. e.g.
(00:01:30.000)
Espressif Systems 1157
Submit Document Feedback
Release v4.4