feat(phy): add check for required clock bits during phy enable

components/esp_phy/esp32/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0x8FCF

components/esp_phy/esp32c2/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0xE0788FCF

components/esp_phy/esp32c3/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0x788FCF

components/esp_phy/esp32c5/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0x3BE7FF

components/esp_phy/esp32c6/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0x7E7FF

components/esp_phy/esp32c61/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0x3BE7FF

components/esp_phy/esp32h2/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0x7f000

components/esp_phy/esp32h21/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0x0 //TODO

components/esp_phy/esp32h4/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0x0 //TODO

components/esp_phy/esp32s2/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0x7887CF

components/esp_phy/esp32s3/include/phy_init_deps.h

@@ -0,0 +1,9 @@
+/*
+ * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS  0x788FCF

components/esp_phy/src/phy_init.c

@@ -49,6 +49,12 @@
 #include "esp_private/sleep_modem.h"
 #endif
 #include "hal/efuse_hal.h"
+#include "phy_init_deps.h"
+
+#ifndef PHY_INIT_MODEM_CLOCK_REQUIRED_BITS
+#warning "PHY_INIT_MODEM_CLOCK_REQUIRED_BITS not defined; using default value 0"
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS 0
+#endif
 
 #if CONFIG_IDF_TARGET_ESP32
 extern wifi_mac_time_update_cb_t s_wifi_mac_time_update_cb;
@@ -302,6 +308,7 @@ void esp_phy_enable(esp_phy_modem_t modem)
 #endif
         esp_phy_common_clock_enable();
         phy_module_enable();
+        assert(phy_module_has_clock_bits(PHY_INIT_MODEM_CLOCK_REQUIRED_BITS));
         if (s_is_phy_calibrated == false) {
             esp_phy_load_cal_and_init();
             s_is_phy_calibrated = true;

components/esp_phy/src/phy_init_esp32hxx.c

@@ -14,6 +14,12 @@
 #if SOC_MODEM_CLOCK_IS_INDEPENDENT
 #include "esp_private/esp_modem_clock.h"
 #endif
+#include "phy_init_deps.h"
+
+#ifndef PHY_INIT_MODEM_CLOCK_REQUIRED_BITS
+#warning "PHY_INIT_MODEM_CLOCK_REQUIRED_BITS not defined; using default value 0"
+#define PHY_INIT_MODEM_CLOCK_REQUIRED_BITS 0
+#endif
 
 #define PHY_ENABLE_VERSION_PRINT 1
 
@@ -108,6 +114,7 @@ void esp_phy_enable(esp_phy_modem_t modem)
         modem_clock_module_enable(PERIPH_PHY_MODULE);
 #endif
         phy_module_enable();
+        assert(phy_module_has_clock_bits(PHY_INIT_MODEM_CLOCK_REQUIRED_BITS));
         if (!s_phy_is_enabled) {
             register_chipv7_phy(NULL, NULL, PHY_RF_CAL_FULL);
             phy_version_print();