From d6736def41f5da2aa7ddc1b2ada49807ffc5e95b Mon Sep 17 00:00:00 2001
From: zwx <zhangwenxu@espressif.com>
Date: Mon, 9 Mar 2026 14:31:27 +0800
Subject: [PATCH] fix(esp_phy): check hw freq hop done before disabling common
 clock

---
 components/esp_phy/include/esp_private/phy.h | 6 ++++++
 components/esp_phy/lib                       | 2 +-
 components/esp_phy/src/phy_common.c          | 6 ++++++
 components/esp_phy/src/phy_init.c            | 1 +
 components/esp_phy/src/phy_init_esp32hxx.c   | 1 +
 5 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/components/esp_phy/include/esp_private/phy.h b/components/esp_phy/include/esp_private/phy.h
index f3133b02213..134813369a1 100644
--- a/components/esp_phy/include/esp_private/phy.h
+++ b/components/esp_phy/include/esp_private/phy.h
@@ -266,6 +266,12 @@ void esp_phy_sleep_data_init(void);
 void esp_phy_sleep_data_deinit(void);
 #endif
 
+/**
+ * @brief Wait for frequency hardware hop to complete
+ *
+ */
+void phy_wait_freq_hw_hop_done(void);
+
 #ifdef __cplusplus
 }
 #endif
diff --git a/components/esp_phy/lib b/components/esp_phy/lib
index ac744ff2c5c..59c1234e929 160000
--- a/components/esp_phy/lib
+++ b/components/esp_phy/lib
@@ -1 +1 @@
-Subproject commit ac744ff2c5c39c63f8cdd503d4074905647fdbb6
+Subproject commit 59c1234e929212aec0fdda75769b759951235536
diff --git a/components/esp_phy/src/phy_common.c b/components/esp_phy/src/phy_common.c
index 02b98188794..ac940bb0921 100644
--- a/components/esp_phy/src/phy_common.c
+++ b/components/esp_phy/src/phy_common.c
@@ -379,3 +379,9 @@ void phy_wakeup_from_modem_state_extra_init(void)
 }
 #endif
 #endif
+
+__attribute__((weak)) void phy_wait_freq_hw_hop_done(void)
+{
+    ESP_LOGD(TAG, "phy_wait_freq_hw_hop_done is not implemented");
+    return;
+}
diff --git a/components/esp_phy/src/phy_init.c b/components/esp_phy/src/phy_init.c
index 8db6cabf917..aa2f4dc3213 100644
--- a/components/esp_phy/src/phy_init.c
+++ b/components/esp_phy/src/phy_init.c
@@ -415,6 +415,7 @@ void esp_phy_disable(esp_phy_modem_t modem)
         // Update WiFi MAC time before disable WiFi/BT common peripheral clock
         phy_update_wifi_mac_time(true, esp_timer_get_time());
 #endif
+        phy_wait_freq_hw_hop_done();
         // Disable WiFi/BT common peripheral clock. Do not disable clock for hardware RNG
         esp_phy_common_clock_disable();
     }
diff --git a/components/esp_phy/src/phy_init_esp32hxx.c b/components/esp_phy/src/phy_init_esp32hxx.c
index 727cb8c8d59..60b5e54175a 100644
--- a/components/esp_phy/src/phy_init_esp32hxx.c
+++ b/components/esp_phy/src/phy_init_esp32hxx.c
@@ -153,6 +153,7 @@ void esp_phy_disable(esp_phy_modem_t modem)
 #endif
         phy_close_rf();
         phy_xpd_tsens();
+        phy_wait_freq_hw_hop_done();
 #if SOC_MODEM_CLOCK_IS_INDEPENDENT
         modem_clock_module_disable(PERIPH_PHY_MODULE);
 #endif