1 files changed, 34 insertions, 4 deletions
diff --git a/os/kernel/src/chmempools.c b/os/kernel/src/chmempools.c
index 6d1f7e866..8ef5cc403 100644
--- a/os/kernel/src/chmempools.c
+++ b/os/kernel/src/chmempools.c
@@ -61,7 +61,33 @@ void chPoolInit(MemoryPool *mp, size_t size, memgetfunc_t provider) {
 }
 
 /**
+ * @brief   Loads a memory pool with an array of static objects.
+ * @pre     The memory pool must be already been initialized.
+ * @pre     The array elements must be of the right size for the specified
+ *          memory pool.
+ * @post    The memory pool contains the elements of the input array.
+ *
+ * @param[in] mp        pointer to a @p MemoryPool structure
+ * @param[in] p         pointer to the array first element
+ * @param[in] n         number of elements in the array
+ *
+ * @api
+ */
+void chPoolLoadArray(MemoryPool *mp, void *p, size_t n) {
+
+  chDbgCheck((mp != NULL) && MEM_IS_ALIGNED(p) && (n != 0),
+             "chPoolLoadArray");
+
+  while (n) {
+    chPoolAdd(mp, p);
+    p = (void *)(((uint8_t *)p) + mp->mp_object_size);
+    n--;
+  }
+}
+
+/**
  * @brief   Allocates an object from a memory pool.
+ * @pre     The memory pool must be already been initialized.
  *
  * @param[in] mp        pointer to a @p MemoryPool structure
  * @return              The pointer to the allocated object.
@@ -84,6 +110,7 @@ void *chPoolAllocI(MemoryPool *mp) {
 
 /**
  * @brief   Allocates an object from a memory pool.
+ * @pre     The memory pool must be already been initialized.
  *
  * @param[in] mp        pointer to a @p MemoryPool structure
  * @return              The pointer to the allocated object.
@@ -101,14 +128,15 @@ void *chPoolAlloc(MemoryPool *mp) {
 }
 
 /**
- * @brief   Releases (or adds) an object into (to) a memory pool.
+ * @brief   Releases an object into a memory pool.
+ * @pre     The memory pool must be already been initialized.
  * @pre     The freed object must be of the right size for the specified
  *          memory pool.
  * @pre     The freed object must be memory aligned to the size of
  *          @p stkalign_t type.
  *
  * @param[in] mp        pointer to a @p MemoryPool structure
- * @param[in] objp      the pointer to the object to be released or added
+ * @param[in] objp      the pointer to the object to be released
  *
  * @iclass
  */
@@ -124,14 +152,15 @@ void chPoolFreeI(MemoryPool *mp, void *objp) {
 }
 
 /**
- * @brief   Releases (or adds) an object into (to) a memory pool.
+ * @brief   Releases an object into a memory pool.
+ * @pre     The memory pool must be already been initialized.
  * @pre     The freed object must be of the right size for the specified
  *          memory pool.
  * @pre     The freed object must be memory aligned to the size of
  *          @p stkalign_t type.
  *
  * @param[in] mp        pointer to a @p MemoryPool structure
- * @param[in] objp      the pointer to the object to be released or added
+ * @param[in] objp      the pointer to the object to be released
  *
  * @api
  */
@@ -141,6 +170,7 @@ void chPoolFree(MemoryPool *mp, void *objp) {
   chPoolFreeI(mp, objp);
   chSysUnlock();
 }
+
 #endif /* CH_USE_MEMPOOLS */
 
 /** @} */