10#if defined(USE_ESP32) && defined(USE_NETWORK)
12#if defined(CONFIG_LWIP_TCPIP_CORE_LOCKING) && defined(USE_ESPHOME_TASK_LOG_BUFFER)
14#define USE_LOGGER_DEFER_UNDER_LWIP_LOCK
22#if defined(USE_ESP32) || defined(USE_HOST) || defined(USE_LIBRETINY) || defined(USE_ZEPHYR)
39#if defined(USE_ESP32) || defined(USE_LIBRETINY)
41 TaskHandle_t current_task = xTaskGetCurrentTaskHandle();
42 const bool is_main_task = (current_task == this->
main_task_);
44 k_tid_t current_task = k_current_get();
45 const bool is_main_task = (current_task == this->
main_task_);
47 const bool is_main_task = pthread_equal(pthread_self(), this->
main_thread_);
53#ifdef USE_LOGGER_DEFER_UNDER_LWIP_LOCK
57 if (sys_thread_tcpip(LWIP_CORE_LOCK_QUERY_HOLDER) && sys_thread_tcpip(LWIP_CORE_IS_TCPIP_INITIALIZED))
77#if defined(USE_ESP32) || defined(USE_LIBRETINY)
79#elif defined(USE_ZEPHYR)
80 char thread_name_buf[MAX_POINTER_REPRESENTATION];
83 char thread_name_buf[THREAD_NAME_BUF_SIZE];
92 const char *thread_name) {
101 bool message_sent =
false;
102#ifdef USE_ESPHOME_TASK_LOG_BUFFER
124 static const size_t MAX_CONSOLE_LOG_MSG_SIZE = 512;
127 static const size_t MAX_CONSOLE_LOG_MSG_SIZE = 144;
129 char console_buffer[MAX_CONSOLE_LOG_MSG_SIZE];
130 LogBuffer buf{console_buffer, MAX_CONSOLE_LOG_MSG_SIZE};
164#if defined(USE_LOGGER_RUNTIME_TAG_LEVELS) || defined(USE_LOGGER_BOOT_LOG_PER_TAG_LEVELS)
166static inline uint8_t tag_level(
const std::map<const char *, uint8_t, CStrCompare> &levels,
const char *tag,
170 auto it = levels.find(
FlashTag{tag});
171 return it != levels.end() ? it->second : fallback;
178#ifdef USE_LOGGER_RUNTIME_TAG_LEVELS
185#ifdef USE_LOGGER_BOOT_LOG_BUFFER
187#ifdef USE_LOGGER_BOOT_LOG_PER_TAG_LEVELS
188 return tag_level(this->
boot_log_levels_, tag, ESPHOME_LOGGER_BOOT_LOG_LEVEL);
190 return ESPHOME_LOGGER_BOOT_LOG_LEVEL;
196#if defined(USE_ESP32) || defined(USE_LIBRETINY)
197 this->
main_task_ = xTaskGetCurrentTaskHandle();
198#elif defined(USE_ZEPHYR)
200#elif defined(USE_HOST)
205#if defined(USE_ESPHOME_TASK_LOG_BUFFER) || (defined(USE_ZEPHYR) && defined(USE_LOGGER_UART_SELECTION_USB_CDC))
208#if defined(USE_ZEPHYR) && defined(USE_LOGGER_UART_SELECTION_USB_CDC)
215#ifdef USE_ESPHOME_TASK_LOG_BUFFER
223 uint16_t text_length;
225 const char *thread_name =
message->thread_name[0] !=
'\0' ?
message->thread_name :
nullptr;
228 message->text_data(), text_length, buf);
234#if !(defined(USE_ZEPHYR) && defined(USE_LOGGER_UART_SELECTION_USB_CDC))
244#ifdef USE_LOGGER_BOOT_LOG_BUFFER
253static constexpr uint16_t BOOT_LOG_MAX_TEXT =
258 if (level > ESPHOME_LOGGER_BOOT_LOG_MAX_LEVEL || level == ESPHOME_LOG_LEVEL_NONE ||
262 const char *text = buf.
data;
271 if (
len > BOOT_LOG_MAX_TEXT)
272 len = BOOT_LOG_MAX_TEXT;
273 if (this->
boot_log_pos_ +
sizeof(BootLogRecord) +
len > ESPHOME_LOGGER_BOOT_LOG_BUFFER_SIZE) {
277 const BootLogRecord record{
len, level,
millis(), tag};
279 memcpy(p, &record,
sizeof(record));
280 memcpy(p +
sizeof(record), text,
len);
281 this->boot_log_pos_ +=
sizeof(record) +
len;
292 ESPHOME_LOG_FORMAT(
"Replaying boot logs (%u bytes used, %u lines dropped)"), this->
boot_log_pos_,
297 BootLogRecord record;
300 pos +=
sizeof(record) + record.len;
301 if (record.level > this->level_for(record.tag))
306 buf.write_body(text, record.len);
314#ifdef USE_LOGGER_RUNTIME_TAG_LEVELS
317#ifdef USE_LOGGER_BOOT_LOG_PER_TAG_LEVELS
322PROGMEM_STRING_TABLE(LogLevelStrings,
"NONE",
"ERROR",
"WARN",
"INFO",
"CONFIG",
"DEBUG",
"VERBOSE",
"VERY_VERBOSE");
324static const LogString *get_log_level_str(uint8_t level) {
325 return LogLevelStrings::get_log_str(level, LogLevelStrings::LAST_INDEX);
332 " Initial Level: %s",
333 LOG_STR_ARG(get_log_level_str(ESPHOME_LOG_LEVEL)),
337 " Log Baud Rate: %" PRIu32
"\n"
338 " Hardware UART: %s",
341#ifdef USE_ESPHOME_TASK_LOG_BUFFER
343 ESP_LOGCONFIG(TAG,
" Task Log Buffer Slots: %u",
static_cast<unsigned int>(this->
log_buffer_.
size()));
345 ESP_LOGCONFIG(TAG,
" Task Log Buffer Size: %u bytes",
static_cast<unsigned int>(this->
log_buffer_.
size()));
348#ifdef USE_LOGGER_BOOT_LOG_BUFFER
349 ESP_LOGCONFIG(TAG,
" Boot Log Buffer Size: %u bytes", ESPHOME_LOGGER_BOOT_LOG_BUFFER_SIZE);
352#ifdef USE_LOGGER_RUNTIME_TAG_LEVELS
354 ESP_LOGCONFIG(TAG,
" Level for '%s': %s", it.first, LOG_STR_ARG(get_log_level_str(it.second)));
357#ifdef USE_LOGGER_BOOT_LOG_PER_TAG_LEVELS
359 ESP_LOGCONFIG(TAG,
" Boot Level for '%s': %s", it.first, LOG_STR_ARG(get_log_level_str(it.second)));
364#ifdef USE_BOOTLOADER_ADAFRUIT
374#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERY_VERBOSE
375 ESP_LOGW(TAG,
"VERY_VERBOSE logging is active — significant performance impact, short-term debugging only\n"
376 " May cause connection instability. Set log level to DEBUG or lower for long-term use.");
377#elif ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
378 ESP_LOGI(TAG,
"VERBOSE logging is active — performance impact, short-term debugging only\n"
379 " Set log level to DEBUG or lower for long-term use.");
384 if (level > ESPHOME_LOG_LEVEL) {
385 level = ESPHOME_LOG_LEVEL;
386 ESP_LOGW(TAG,
"Cannot set log level higher than pre-compiled %s",
387 LOG_STR_ARG(get_log_level_str(ESPHOME_LOG_LEVEL)));
390#ifdef USE_LOGGER_LEVEL_LISTENERS
392 listener->on_log_level_change(level);
void enable_loop_soon_any_context()
Thread and ISR-safe version of enable_loop() that can be called from any context.
Logger component for all ESPHome logging.
void HOT notify_listeners_(uint8_t level, const char *tag, const LogBuffer &buf)
char boot_log_buffer_[ESPHOME_LOGGER_BOOT_LOG_BUFFER_SIZE]
const char *HOT get_thread_name_()
void dump_config() override
bool HOT is_non_main_task_recursive_() const
NonMainTaskRecursionGuard make_non_main_task_guard_()
const LogString * get_uart_selection_()
uint8_t level_for(const char *tag)
void log_vprintf_(uint8_t level, const char *tag, int line, const char *format, va_list args)
void HOT log_message_to_buffer_and_send_(bool &recursion_guard, uint8_t level, const char *tag, int line, FormatType format, va_list args, const char *thread_name)
void replay_boot_logs()
Send the lines captured during boot to the listeners and stop capturing; safe to call repeatedly.
char tx_buffer_[ESPHOME_LOGGER_TX_BUFFER_SIZE+1]
void HOT format_buffered_message_and_notify_(uint8_t level, const char *tag, uint16_t line, const char *thread_name, const char *text, uint16_t text_length, LogBuffer &buf)
std::map< const char *, uint8_t, CStrCompare > log_levels_
std::vector< LoggerLevelListener * > level_listeners_
void disable_loop_when_buffer_empty_()
void HOT format_log_to_buffer_with_terminator_(uint8_t level, const char *tag, int line, const char *format, va_list args, LogBuffer &buf, const char *thread_name)
void HOT write_log_buffer_to_console_(LogBuffer &buf)
uint8_t boot_level_for_(const char *tag)
void set_log_level(uint8_t level)
Set the default log level for this logger.
void boot_log_capture_(uint8_t level, const char *tag, const LogBuffer &buf)
Copy a formatted line at or above the boot log level (outer ANSI codes stripped) into the boot log bu...
bool global_recursion_guard_
bool & main_loop_recursion_guard_()
void set_boot_log_level(const char *tag, uint8_t log_level)
Set the boot log level of the specified tag.
void HOT write_to_console_(LogBuffer &buf)
void log_vprintf_non_main_thread_(uint8_t level, const char *tag, int line, const char *format, va_list args, const char *thread_name)
logger::TaskLogBuffer log_buffer_
uint16_t boot_log_dropped_
bool main_task_recursion_guard_
std::map< const char *, uint8_t, CStrCompare > boot_log_levels_
Logger(uint32_t baud_rate)
void release_message_main_loop()
bool borrow_message_main_loop(LogMessage *&message, uint16_t &text_length)
bool send_message_thread_safe(uint8_t level, const char *tag, uint16_t line, const char *thread_name, const char *format, va_list args)
static constexpr size_t size()
bool HOT has_messages() const
const LogString * message
PROGMEM_STRING_TABLE(LogLevelStrings, "NONE", "ERROR", "WARN", "INFO", "CONFIG", "DEBUG", "VERBOSE", "VERY_VERBOSE")
ESPHOME_LOG_TAG(TAG, "logger")
void HOT esp_log_printf_(int level, const char *tag, int line, const char *format,...)
uint32_t IRAM_ATTR HOT millis()
void write_replay_header(uint8_t level, uint32_t ms)
static constexpr uint16_t ANSI_COLOR_LEN
static constexpr uint16_t ANSI_RESET_LEN
static constexpr uint16_t REPLAY_HEADER_MAX_SIZE