From cdd8c1e26129896c20e72d00dbe467970f4433dc Mon Sep 17 00:00:00 2001
From: Xu Si Yu <xusiyu@espressif.com>
Date: Thu, 28 Aug 2025 15:54:41 +0800
Subject: [PATCH] feat(coex): add 802.15.4 status for coex

---
 components/esp_coex/include/esp_coex_i154.h   | 37 +++++++++++++++++++
 .../include/private/esp_coexist_internal.h    |  2 +
 components/esp_coex/src/coexist.c             |  6 ++-
 3 files changed, 44 insertions(+), 1 deletion(-)

diff --git a/components/esp_coex/include/esp_coex_i154.h b/components/esp_coex/include/esp_coex_i154.h
index d601205ebe7..f817e901400 100644
--- a/components/esp_coex/include/esp_coex_i154.h
+++ b/components/esp_coex/include/esp_coex_i154.h
@@ -6,6 +6,9 @@
 #ifndef __COEXIST_I154_H__
 #define __COEXIST_I154_H__
 
+/**
+ * @brief 802.15.4 coex event
+ */
 typedef enum {
     IEEE802154_HIGH = 1,
     IEEE802154_MIDDLE,
@@ -14,16 +17,50 @@ typedef enum {
     IEEE802154_EVENT_MAX,
 } ieee802154_coex_event_t;
 
+/**
+ * @brief 802.15.4 coexistence configurations
+ */
 typedef struct {
     ieee802154_coex_event_t idle;
     ieee802154_coex_event_t txrx;
     ieee802154_coex_event_t txrx_at;
 } esp_ieee802154_coex_config_t;
 
+/**
+ * @brief Set 802.15.4 tx/rx pti
+ * @param 802.15.4 coexistence event
+ */
 void esp_coex_ieee802154_txrx_pti_set(ieee802154_coex_event_t event);
+
+/**
+ * @brief Set 802.15.4 ack pti
+ * @param 802.15.4 coexistence event
+ */
 void esp_coex_ieee802154_ack_pti_set(ieee802154_coex_event_t event);
+
+/**
+ * @brief Indicate that a coexistence break occurred in 802.15.4
+ */
 void esp_coex_ieee802154_coex_break_notify(void);
+
+/**
+ * @brief Enter the TX stage for 802.15.4 external coexistence handling
+ */
 void esp_coex_ieee802154_extcoex_tx_stage(void);
+
+/**
+ * @brief Enter the RX stage for 802.15.4 external coexistence handling
+ */
 void esp_coex_ieee802154_extcoex_rx_stage(void);
 
+/**
+ * @brief Enable the 802.15.4 status for coexistence
+ */
+void esp_coex_ieee802154_status_enable(void);
+
+/**
+ * @brief Disable the 802.15.4 status for coexistence
+ */
+void esp_coex_ieee802154_status_disable(void);
+
 #endif
diff --git a/components/esp_coex/include/private/esp_coexist_internal.h b/components/esp_coex/include/private/esp_coexist_internal.h
index 6e3799487f0..026f1f9fe0a 100644
--- a/components/esp_coex/include/private/esp_coexist_internal.h
+++ b/components/esp_coex/include/private/esp_coexist_internal.h
@@ -32,6 +32,8 @@ typedef enum {
     COEX_SCHM_ST_TYPE_WIFI = 0,
     COEX_SCHM_ST_TYPE_BLE,
     COEX_SCHM_ST_TYPE_BT,
+    COEX_SCHM_ST_TYPE_EXTERNAL_COEX,
+    COEX_SCHM_ST_TYPE_I154,
 } coex_schm_st_type_t;
 
 #define COEX_STATUS_GET_WIFI_BITMAP     (1 << COEX_SCHM_ST_TYPE_WIFI)
diff --git a/components/esp_coex/src/coexist.c b/components/esp_coex/src/coexist.c
index da83b47a944..d2b5a3127e3 100644
--- a/components/esp_coex/src/coexist.c
+++ b/components/esp_coex/src/coexist.c
@@ -19,6 +19,10 @@
 
 #include "esp_private/periph_ctrl.h"
 
+#if CONFIG_ESP_COEX_SW_COEXIST_ENABLE && CONFIG_SOC_IEEE802154_SUPPORTED
+#include "esp_coex_i154.h"
+#endif
+
 #if SOC_EXTERNAL_COEX_ADVANCE
 #define EXTERNAL_COEX_SIGNAL_I0_IDX           EXTERN_ACTIVE_I_IDX
 #define EXTERNAL_COEX_SIGNAL_I1_IDX           EXTERN_PRIORITY_I_IDX
@@ -286,7 +290,7 @@ esp_err_t esp_coex_wifi_i154_enable(void)
     // TODO: Add a scheme for wifi and 154 coex.
     // Remove this function if FCC-50 closes.
     coex_enable();
-    coex_schm_status_bit_set(1, 1);
+    esp_coex_ieee802154_status_enable();
     return ESP_OK;
 }
 #endif