License#

Copyright 2018 Silicon Laboratories Inc. www.silabs.com

SPDX-License-Identifier: Zlib

The licensor of this software is Silicon Laboratories Inc.

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.

  2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.

  3. This notice may not be removed or altered from any source distribution.

/***************************************************************************/
#define EMBER_NULL_BUFFER    0x0000u

void emberMarkApplicationBuffersHandler(void);

EmberBuffer emberAllocateBuffer(uint16_t dataSizeInBytes);

void emberMarkBuffer(EmberBuffer *buffer);

uint8_t *emberGetBufferPointer(EmberBuffer buffer);

uint16_t emberGetBufferLength(EmberBuffer buffer);

uint16_t emberGetAvailableBufferMemory(void);

Handlers#

The Application Framework implements all handlers, directly calling their associated callbacks. By default, Connect projects declare such callbacks as stubs in flex-callbacks-stubs.c. Hence, to use an enabled Connect feature, applications should replace the stub with their own implementation of the associated callback (typically in flex-callbacks.c). See UG235.04 for more info.

void

This handler is invoked by the memory buffers system garbage collector and allows the application to properly mark the application-defined EmberBuffer variables with emberMarkBuffer().

APIs#

emberAllocateBuffer(uint16_t dataSizeInBytes)

Dynamically allocates memory.

void
emberMarkBuffer(EmberBuffer *buffer)

Prevent the garbage collector from reclaiming the memory associated with the passed EmberBuffer. The application should call this API within the emberMarkApplicationBuffersHandler() stack handler for each EmberBuffer object.

uint8_t *
emberGetBufferPointer(EmberBuffer buffer)

Return a pointer to the memory segment corresponding to the passed EmberBuffer buffer. Notice that the garbage collector can move memory segments to defragment the available memory. As result, the application should always use this API to obtain an updated pointer prior to accessing the memory.

uint16_t
emberGetBufferLength(EmberBuffer buffer)

Return the length in bytes of the passed EmberBuffer buffer.

uint16_t

Return the available memory at the buffer manager in bytes.

Macros#

#define

A special EmberBuffer ID indicating that no memory is currently allocated.

Handlers Documentation#

emberMarkApplicationBuffersHandler#

void emberMarkApplicationBuffersHandler (void )

This handler is invoked by the memory buffers system garbage collector and allows the application to properly mark the application-defined EmberBuffer variables with emberMarkBuffer().

Parameters
N/A

Warnings


Definition at line 72 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/memory-buffer.h

APIs Documentation#

emberAllocateBuffer#

EmberBuffer emberAllocateBuffer (uint16_t dataSizeInBytes)

Dynamically allocates memory.

Parameters
[in]dataSizeInBytes

The size in bytes of the memory to be allocated.

Returns

  • An EmberBuffer value of EMBER_NULL_BUFFER if the memory management system could not allocate the requested memory, or any other EmberBuffer value indicating that the requested memory was successfully allocated. The allocated memory can easily be freed by assigning an EmberBuffer variable to EMBER_NULL_BUFFER. The memory will be freed by the garbage collector during the next emberTick() call.


Definition at line 92 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/memory-buffer.h

emberMarkBuffer#

void emberMarkBuffer (EmberBuffer * buffer)

Prevent the garbage collector from reclaiming the memory associated with the passed EmberBuffer. The application should call this API within the emberMarkApplicationBuffersHandler() stack handler for each EmberBuffer object.

Parameters
[in]buffer

A pointer to the EmberBuffer buffer to be marked.


Definition at line 101 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/memory-buffer.h

emberGetBufferPointer#

uint8_t * emberGetBufferPointer (EmberBuffer buffer)

Return a pointer to the memory segment corresponding to the passed EmberBuffer buffer. Notice that the garbage collector can move memory segments to defragment the available memory. As result, the application should always use this API to obtain an updated pointer prior to accessing the memory.

Parameters
[in]buffer

A pointer to the EmberBuffer buffer for which the corresponding memory pointer should be returned.

Returns


Definition at line 116 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/memory-buffer.h

emberGetBufferLength#

uint16_t emberGetBufferLength (EmberBuffer buffer)

Return the length in bytes of the passed EmberBuffer buffer.

Parameters
[in]buffer

A pointer to the EmberBuffer buffer for which the corresponding length in bytes should be returned.

Returns

  • The length in bytes of a memory segment corresponding to the passed EmberBuffer buffer.


Definition at line 127 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/memory-buffer.h

emberGetAvailableBufferMemory#

uint16_t emberGetAvailableBufferMemory (void )

Return the available memory at the buffer manager in bytes.

Parameters
N/A

Returns

  • The number of available bytes.


Definition at line 134 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/memory-buffer.h

Macro Definition Documentation#

EMBER_NULL_BUFFER#

#define EMBER_NULL_BUFFER
Value:
0x0000u

A special EmberBuffer ID indicating that no memory is currently allocated.


Definition at line 50 of file /mnt/raid/workspaces/ws.r4wf6JzLX/overlay/gsdk/protocol/flex/stack/include/memory-buffer.h