From 35ec6bc5b70f28fd9a22d81f2f7b6ab14544fea2 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 | 7 +++++++
 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 +
 4 files changed, 15 insertions(+)

diff --git a/components/esp_phy/include/esp_private/phy.h b/components/esp_phy/include/esp_private/phy.h
index 29581b643d0..82e36787860 100644
--- a/components/esp_phy/include/esp_private/phy.h
+++ b/components/esp_phy/include/esp_private/phy.h
@@ -203,6 +203,13 @@ void phy_wakeup_from_modem_state_extra_init(void);
 void esp_phy_modem_rf_flag_update(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/src/phy_common.c b/components/esp_phy/src/phy_common.c
index 58e960c6f8d..e395274684b 100644
--- a/components/esp_phy/src/phy_common.c
+++ b/components/esp_phy/src/phy_common.c
@@ -150,3 +150,9 @@ void phy_wakeup_from_modem_state_extra_init(void)
     temperature_sensor_ll_enable(true);
 }
 #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 ca2b9db813e..5ea80227eec 100644
--- a/components/esp_phy/src/phy_init.c
+++ b/components/esp_phy/src/phy_init.c
@@ -409,6 +409,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