From c017bfc35bcc063d833a900ebda2dd88e20c12f3 Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@home-assistant.io>
Date: Tue, 10 Mar 2026 13:34:03 -1000
Subject: [PATCH] Add comment explaining ESP_LOGE over ESP_LOGCONFIG

---
 esphome/components/rp2040/crash_handler.cpp | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/esphome/components/rp2040/crash_handler.cpp b/esphome/components/rp2040/crash_handler.cpp
index 9c07151eb90..54548765764 100644
--- a/esphome/components/rp2040/crash_handler.cpp
+++ b/esphome/components/rp2040/crash_handler.cpp
@@ -69,6 +69,11 @@ void crash_handler_read_and_clear() {
   }
 }
 
+// Intentionally uses separate ESP_LOGE calls per line instead of combining into
+// one multi-line log message. This ensures each address appears as its own line
+// on the serial console (miniterm), making it possible to see partial output if
+// the device crashes again during boot, and allowing the CLI's process_stacktrace
+// to match and decode each address individually.
 void crash_handler_log() {
   if (!s_crash_data.valid)
     return;