rtems: Add rtems_cache_coherent_allocate()

Add rtems_cache_coherent_free() and rtems_cache_coherent_add_area().

3 files changed, 184 insertions, 0 deletions

diff --git a/cpukit/libcsupport/Makefile.am b/cpukit/libcsupport/Makefile.am
index 95c85c4ede..dfa8736ee0 100644
--- a/cpukit/libcsupport/Makefile.am
+++ b/cpukit/libcsupport/Makefile.am
@@ -109,6 +109,7 @@ MALLOC_C_FILES = src/malloc_initialize.c src/calloc.c src/malloc.c \
     src/rtems_heap_extend.c \
     src/rtems_heap_greedy.c
 MALLOC_C_FILES += src/cachealignedalloc.c
+MALLOC_C_FILES += src/cachecoherentalloc.c
 
 PASSWORD_GROUP_C_FILES = src/pwdgrp.c
 PASSWORD_GROUP_C_FILES += src/getgrent.c
diff --git a/cpukit/libcsupport/src/cachecoherentalloc.c b/cpukit/libcsupport/src/cachecoherentalloc.c
new file mode 100644
index 0000000000..bf8167de88
--- /dev/null
+++ b/cpukit/libcsupport/src/cachecoherentalloc.c
@@ -0,0 +1,122 @@
+/**
+ * @file
+ *
+ * @ingroup ClassicCache
+ */
+
+/*
+ * Copyright (c) 2014 embedded brains GmbH.  All rights reserved.
+ *
+ *  embedded brains GmbH
+ *  Dornierstr. 4
+ *  82178 Puchheim
+ *  Germany
+ *  <rtems@embedded-brains.de>
+ *
+ * The license and distribution terms for this file may be
+ * found in the file LICENSE in this distribution or at
+ * http://www.rtems.org/license/LICENSE.
+ */
+
+#if HAVE_CONFIG_H
+  #include "config.h"
+#endif
+
+#include <rtems.h>
+#include <rtems/malloc.h>
+#include <rtems/score/apimutex.h>
+#include <rtems/score/heapimpl.h>
+#include <rtems/score/sysstate.h>
+
+static Heap_Control cache_coherent_heap_instance;
+
+static Heap_Control *cache_coherent_heap;
+
+void *rtems_cache_coherent_allocate(
+  size_t size,
+  uintptr_t alignment,
+  uintptr_t boundary
+)
+{
+  void *ptr;
+  Heap_Control *heap;
+
+  _RTEMS_Lock_allocator();
+
+  heap = cache_coherent_heap;
+  if ( heap == NULL ) {
+    heap = RTEMS_Malloc_Heap;
+  }
+
+  ptr = _Heap_Allocate_aligned_with_boundary(
+    heap,
+    size,
+    alignment,
+    boundary
+  );
+
+  _RTEMS_Unlock_allocator();
+
+  return ptr;
+}
+
+void rtems_cache_coherent_free( void *ptr )
+{
+  Heap_Control *heap;
+
+  _RTEMS_Lock_allocator();
+
+  heap = cache_coherent_heap;
+  if ( heap != NULL ) {
+    if ( _Heap_Free( heap, ptr ) ) {
+      heap = NULL;
+    } else {
+      heap = RTEMS_Malloc_Heap;
+    }
+  } else {
+    heap = RTEMS_Malloc_Heap;
+  }
+
+  if ( heap != NULL ) {
+    _Heap_Free( heap, ptr );
+  }
+
+  _RTEMS_Unlock_allocator();
+}
+
+static void add_area(
+  void *area_begin,
+  uintptr_t area_size
+)
+{
+  Heap_Control *heap = cache_coherent_heap;
+
+  if ( heap == NULL ) {
+    bool ok;
+
+    heap = &cache_coherent_heap_instance;
+
+    ok = _Heap_Initialize( heap, area_begin, area_size, 0 );
+    if ( ok ) {
+      cache_coherent_heap = heap;
+    }
+  } else {
+    _Heap_Extend( heap, area_begin, area_size, 0 );
+  }
+}
+
+void rtems_cache_coherent_add_area(
+  void *area_begin,
+  uintptr_t area_size
+)
+{
+  if ( _System_state_Is_up( _System_state_Get()) ) {
+    _RTEMS_Lock_allocator();
+
+    add_area( area_begin, area_size );
+
+    _RTEMS_Unlock_allocator();
+  } else {
+    add_area( area_begin, area_size );
+  }
+}
diff --git a/cpukit/rtems/include/rtems/rtems/cache.h b/cpukit/rtems/include/rtems/rtems/cache.h
index ce399c65fe..a7dcaa60fd 100644
--- a/cpukit/rtems/include/rtems/rtems/cache.h
+++ b/cpukit/rtems/include/rtems/rtems/cache.h
@@ -191,6 +191,67 @@ void rtems_cache_disable_instruction( void );
  */
 void *rtems_cache_aligned_malloc ( size_t nbytes );
 
+/**
+ * @brief Allocates a memory area of size @a size bytes from cache coherent
+ * memory.
+ *
+ * A size value of zero will return a unique address which may be freed with
+ * rtems_cache_coherent_free().
+ *
+ * The memory allocated by this function can be released with a call to
+ * rtems_cache_coherent_free().
+ *
+ * By default the C program heap allocator is used.  In case special memory
+ * areas must be used, then the BSP or the application must add cache coherent
+ * memory areas for the allocator via rtems_cache_coherent_add_area().
+ *
+ * This function must be called from driver initialization or task context
+ * only.
+ *
+ * @param[in] alignment If the alignment parameter is not equal to zero, the
+ *   allocated memory area will begin at an address aligned by this value.
+ * @param[in] boundary If the boundary parameter is not equal to zero, the
+ *   allocated memory area will comply with a boundary constraint.  The
+ *   boundary value specifies the set of addresses which are aligned by the
+ *   boundary value.  The interior of the allocated memory area will not
+ *   contain an element of this set.  The begin or end address of the area may
+ *   be a member of the set.
+ *
+ * @retval NULL If no memory is available or the parameters are inconsistent.
+ * @retval other A pointer to the begin of the allocated memory area.
+ */
+void *rtems_cache_coherent_allocate(
+  size_t size,
+  uintptr_t alignment,
+  uintptr_t boundary
+);
+
+/**
+ * @brief Frees memory allocated by rtems_cache_coherent_allocate().
+ *
+ * This function must be called from driver initialization or task context
+ * only.
+ *
+ * @param[in] ptr A pointer returned by rtems_cache_coherent_allocate().
+ */
+void rtems_cache_coherent_free( void *ptr );
+
+/**
+ * @brief Adds a cache coherent memory area to the cache coherent allocator.
+ *
+ * This function must be called from BSP initialization, driver initialization
+ * or task context only.
+ *
+ * @param[in] area_begin The area begin address.
+ * @param[in] area_size The area size in bytes.
+ *
+ * @see rtems_cache_coherent_allocate().
+ */
+void rtems_cache_coherent_add_area(
+  void *area_begin,
+  uintptr_t area_size
+);
+
 #if defined( RTEMS_SMP )
 
 /**