nRF51 SDK - S130 SoftDevice
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
Memory Manager

The Memory Manager for nRF51 manages static buffers of fixed sizes in RAM. These buffers can be requested for usage, and freed when the application no longer needs them.

Overview

The Memory Manager allocates memory of different sizes. The application that requests the memory does not need to have knowledge of how the memory allocation is handled internally.

The Memory Manager defines three pools of buffer sizes, small, medium, and large. The size of each buffer in the pool and the number of available buffers can be configured based on the application needs. The default configurations are:

Parameter Default value
MEMORY_MANAGER_SMALL_BLOCK_SIZE 128
MEMORY_MANAGER_SMALL_BLOCK_COUNT 4
MEMORY_MANAGER_MEDIUM_BLOCK_SIZE 512
MEMORY_MANAGER_MEDIUM_BLOCK_COUNT 3
MEMORY_MANAGER_LARGE_BLOCK_COUNT 2056
MEMORY_MANAGER_LARGE_BLOCK_SIZE 1

You can disable any of the pools by setting the buffer count for that pool category to zero. For example, if your application does not need large buffers, define MEMORY_MANAGER_LARGE_BLOCK_COUNT to 0.

The application does not need to be aware of which pool was used to allocate the requested memory. The requested memory can be of any size; the application does not need to request a buffer that is equal to the size of one of the pool block sizes. For example, if the Memory Manager uses the default configuration specified above and the application requests a memory buffer of size 480, the Memory Manager determines which pool is most suitable for this size of memory. In this example, the medium block is best suited. However, if no buffers in the medium buffer pool are available, the Memory Manager will attempt to provide the buffer from the next block pool. Therefore, in this example, the application would be assigned a buffer from the large buffer pool.

See the flow chart below for the buffer allocation algorithm that is used. The function that is used to allocate a buffer is called nrf51_sdk_mem_alloc

memory_manager_allocation_algorithm.png
Figure 1. Memory Manager Allocation Algorithm.

Configuration parameters

The following configuration parameters should be defined in sdk_config.h.

MEM_MANAGER_DISABLE_LOGS

Disables debug tracing in the module. To enable tracing, this flag must be set to 0 and ENABLE_DEBUG_LOG_SUPPORT must be set to 1.

Description Value
Enable debug trace 0
Disable debug trace 1
Dependencies ENABLE_DEBUG_LOG_SUPPORT

MEM_MANAGER_DISABLE_API_PARAM_CHECK

Disables API parameter checks in the module. Set this define to 1 to disable checks on API parameters in the module. API parameter checks are added to ensure that the correct parameters are passed to the module. These checks are useful during development phase, but they might be redundant when the application is finalized. Disabling these checks might improve performance.

Description Value
Enable API parameters check 0
Disable API parameters check 1
Dependencies None

MEMORY_MANAGER_SMALL_BLOCK_COUNT

Maximum number of memory blocks identified as small blocks.

Restriction Value
Minimum value 0
Maximum value 255
Dependencies None

MEMORY_MANAGER_MEDIUM_BLOCK_COUNT

Maximum number of memory blocks identified as medium blocks.

Restriction Value
Minimum value 0
Maximum value 255
Dependencies None

MEMORY_MANAGER_LARGE_BLOCK_COUNT

Maximum number of memory blocks identified as large blocks.

Restriction Value
Minimum value 0
Maximum value 255
Dependencies None

MEMORY_MANAGER_SMALL_BLOCK_SIZE

The size of each memory block identified as small block. The size should be a multiple of the word size.

Restriction Value
Minimum value 32
Maximum value MEMORY_MANAGER_MEDIUM_BLOCK_SIZE - 1
Dependencies MEMORY_MANAGER_MEDIUM_BLOCK_SIZE

MEMORY_MANAGER_MEDIUM_BLOCK_SIZE

Size of each memory block identified as medium block. The size should be a multiple of the word size.

Restriction Value
Minimum value MEMORY_MANAGER_SMALL_BLOCK_SIZE + 1
Maximum value MEMORY_MANAGER_LARGE_BLOCK_SIZE - 1
Dependencies MEMORY_MANAGER_LARGE_BLOCK_SIZE, MEMORY_MANAGER_SMALL_BLOCK_SIZE

MEMORY_MANAGER_LARGE_BLOCK_SIZE

The size of each memory block identified as large block. The size should be a multiple of the word size.

Restriction Value
Minimum value MEMORY_MANAGER_MEDIUM_BLOCK_SIZE + 1
Maximum value Any value based on availability of RAM.
Dependencies MEMORY_MANAGER_LARGE_BLOCK_SIZE