From 1410f1676edc495a778b72df6ac3aa5638be47f9 Mon Sep 17 00:00:00 2001
From: ElVit <vitalij.salnikov@t-online.de>
Date: Mon, 23 Mar 2026 19:49:00 +0100
Subject: [PATCH] Add comment to explain why chunking log messages

---
 components/panasonic_heatpump/helpers.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/panasonic_heatpump/helpers.cpp b/components/panasonic_heatpump/helpers.cpp
index a2fdaf8..5546ea0 100644
--- a/components/panasonic_heatpump/helpers.cpp
+++ b/components/panasonic_heatpump/helpers.cpp
@@ -33,6 +33,8 @@ void PanasonicHelpers::log_uart_hex(UartLogDirection direction, const uint8_t* d
 
   logStr += byte_array_to_hex_string(data, length, separator);
 
+  // Log in chunks to avoid ESP_LOG buffer overflow (https://developers.esphome.io/architecture/logging/).
+  // The default log buffer is 512 bytes but UART messages can be larger (203 * 3 = 609 characters + log header).
   for (size_t i = 0; i < logStr.length(); i += UART_LOG_CHUNK_SIZE) {
     ESP_LOGI(TAG, "%s %s", msgDir.c_str(), logStr.substr(i, UART_LOG_CHUNK_SIZE).c_str());
     delay(10);