From 9742880bf71f664e3e5665a31feb1e18e00cf2fe Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@home-assistant.io>
Date: Mon, 9 Feb 2026 04:31:16 -0600
Subject: [PATCH] Add comment explaining available() <= 0 check

---
 esphome/components/dfplayer/dfplayer.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/esphome/components/dfplayer/dfplayer.cpp b/esphome/components/dfplayer/dfplayer.cpp
index 60fe26e136..6ef9be3865 100644
--- a/esphome/components/dfplayer/dfplayer.cpp
+++ b/esphome/components/dfplayer/dfplayer.cpp
@@ -133,6 +133,8 @@ void DFPlayer::send_cmd_(uint8_t cmd, uint16_t argument) {
 
 void DFPlayer::loop() {
   // Read message
+  // All current UART available() implementations return >= 0,
+  // use <= 0 to future-proof against any that may return negative on error.
   int avail = this->available();
   if (avail <= 0)
     return;