From 356e6a3c97791d4f8f657ad31d471d9a91847be9 Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Sat, 3 Jan 2026 00:42:06 -1000 Subject: [PATCH] document roam fail path --- esphome/components/wifi/wifi_component.cpp | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/esphome/components/wifi/wifi_component.cpp b/esphome/components/wifi/wifi_component.cpp index 6de7c408f4..9853d26fd3 100644 --- a/esphome/components/wifi/wifi_component.cpp +++ b/esphome/components/wifi/wifi_component.cpp @@ -184,14 +184,15 @@ static const char *const TAG = "wifi"; /// │ │SUCCESS│ │FAILED │ │ │ /// │ └───┬───┘ └───┬───┘ │ │ /// │ ↓ ↓ │ │ -/// │ Keep counter retry_connect() │ │ -/// │ (no reset) (keep counter) │ │ +/// │ Keep counter retry_connect() → normal reconnect flow │ │ +/// │ (no reset) (keeps counter, handles retries) │ │ /// │ │ │ │ │ /// │ └──────────────┴────────────────────────────────────────┘ │ /// │ │ /// │ After 3 checks: attempts >= 3, stop checking │ /// │ Non-roaming disconnect: clear_roaming_state_() resets counter │ /// │ Roaming success: counter preserved (prevents ping-pong) │ +/// │ Roaming fail: normal flow handles reconnection, counter preserved │ /// └──────────────────────────────────────────────────────────────────────┘ static const LogString *retry_phase_to_log_string(WiFiRetryPhase phase) {