From 47f041790d11b4214877e62966031b79e40aa736 Mon Sep 17 00:00:00 2001
From: xusiyu <xusiyu@espressif.com>
Date: Sat, 13 Dec 2025 01:26:43 +0800
Subject: [PATCH] [message] add platform deinit hook and MessagePool dtor
 (#12202)

Add a MessagePool destructor that calls the new
`otPlatMessagePoolDeinit` hook so platform-managed buffer pools get
torn down.
---
 include/openthread/instance.h             | 2 +-
 include/openthread/platform/messagepool.h | 9 +++++++++
 src/core/common/message.cpp               | 4 ++++
 src/core/common/message.hpp               | 7 +++++++
 4 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/include/openthread/instance.h b/include/openthread/instance.h
index c58f5f8b4..4ad0ac418 100644
--- a/include/openthread/instance.h
+++ b/include/openthread/instance.h
@@ -52,7 +52,7 @@ extern "C" {
  *
  * @note This number versions both OpenThread platform and user APIs.
  */
-#define OPENTHREAD_API_VERSION (559)
+#define OPENTHREAD_API_VERSION (560)
 
 /**
  * @addtogroup api-instance
diff --git a/include/openthread/platform/messagepool.h b/include/openthread/platform/messagepool.h
index bd0484e19..ffc868ba4 100644
--- a/include/openthread/platform/messagepool.h
+++ b/include/openthread/platform/messagepool.h
@@ -106,6 +106,15 @@ void otPlatMessagePoolFree(otInstance *aInstance, otMessageBuffer *aBuffer);
  */
 uint16_t otPlatMessagePoolNumFreeBuffers(otInstance *aInstance);
 
+/**
+ * Deinitialize the platform implemented message pool.
+ *
+ * Is used when `OPENTHREAD_CONFIG_PLATFORM_MESSAGE_MANAGEMENT` is enabled.
+ *
+ * @param[in] aInstance  A pointer to the OpenThread instance.
+ */
+void otPlatMessagePoolDeinit(otInstance *aInstance);
+
 #ifdef __cplusplus
 } // extern "C"
 #endif
diff --git a/src/core/common/message.cpp b/src/core/common/message.cpp
index b65aca7af..6f4986ef0 100644
--- a/src/core/common/message.cpp
+++ b/src/core/common/message.cpp
@@ -58,6 +58,10 @@ MessagePool::MessagePool(Instance &aInstance)
 #endif
 }
 
+#if OPENTHREAD_CONFIG_PLATFORM_MESSAGE_MANAGEMENT
+MessagePool::~MessagePool(void) { otPlatMessagePoolDeinit(&GetInstance()); }
+#endif
+
 Message *MessagePool::Allocate(Message::Type aType, uint16_t aReserveHeader, const Message::Settings &aSettings)
 {
     Error    error = kErrorNone;
diff --git a/src/core/common/message.hpp b/src/core/common/message.hpp
index 8a3259282..837b8fbbe 100644
--- a/src/core/common/message.hpp
+++ b/src/core/common/message.hpp
@@ -1849,6 +1849,13 @@ public:
      */
     explicit MessagePool(Instance &aInstance);
 
+#if OPENTHREAD_CONFIG_PLATFORM_MESSAGE_MANAGEMENT
+    /**
+     * Tears down the object and releases platform managed resources.
+     */
+    ~MessagePool(void);
+#endif
+
     /**
      * Allocates a new message with specified settings.
      *