Adapts an externally-owned stack memory array to the IStackMemory interface. More...

#include <stk_helper.h>

Inheritance diagram for stk::StackMemoryWrapper< _StackSize >:

Collaboration diagram for stk::StackMemoryWrapper< _StackSize >:

Public Types
typedef StackMemoryDef< _StackSize >::Type	MemoryType
	The concrete array type that this wrapper accepts, equivalent to StackMemoryDef<_StackSize>::Type.

Public Member Functions
	StackMemoryWrapper (MemoryType *stack)
	Construct a wrapper around an existing stack memory array.
	~StackMemoryWrapper ()=default
	Destructor.
const Word *	GetStack () const override
	Get pointer to the first element of the wrapped stack array.
size_t	GetStackSize () const override
	Get number of elements in the wrapped stack array.
size_t	GetStackSizeBytes () const override
	Get size of the wrapped stack array in bytes.
virtual size_t	GetStackSpace () const
	Get available stack space.

Private Attributes
MemoryType *	m_stack
	Pointer to the externally-owned stack memory array.

Detailed Description

template<size_t _StackSize>
class stk::StackMemoryWrapper< _StackSize >

Adapts an externally-owned stack memory array to the IStackMemory interface.

Note: Wrapper (Adapter) design pattern. Use when the stack memory is declared separately from the task object (e.g. in a linker section or shared buffer) and needs to be passed to the kernel via the IStackMemory interface.

Template Parameters

_StackSize Stack size in elements of Word. Must be >= STACK_SIZE_MIN.

Definition at line 136 of file stk_helper.h.

Member Typedef Documentation

◆ MemoryType

template<size_t _StackSize>

typedef StackMemoryDef<_StackSize>::Type stk::StackMemoryWrapper< _StackSize >::MemoryType

The concrete array type that this wrapper accepts, equivalent to StackMemoryDef<_StackSize>::Type.

Definition at line 142 of file stk_helper.h.

Constructor & Destructor Documentation

◆ StackMemoryWrapper()

template<size_t _StackSize>

stk::StackMemoryWrapper< _StackSize >::StackMemoryWrapper ( MemoryType * stack )

inlineexplicit

Construct a wrapper around an existing stack memory array.

Parameters

[in] stack Pointer to the externally-owned memory array. Must remain valid for the lifetime of this wrapper and of any kernel task using it.

Note: _StackSize must be >= STACK_SIZE_MIN; enforced by a compile-time assertion.

Definition at line 149 of file stk_helper.h.

                                                   : m_stack(stack)
    {
        STK_STATIC_ASSERT(_StackSize >= STACK_SIZE_MIN);
    }

◆ ~StackMemoryWrapper()

template<size_t _StackSize>

stk::StackMemoryWrapper< _StackSize >::~StackMemoryWrapper ( )

default

Destructor.

Note: MISRA deviation: [STK-DEV-005] Rule 10-3-2.

Member Function Documentation

◆ GetStack()

template<size_t _StackSize>

const Word * stk::StackMemoryWrapper< _StackSize >::GetStack ( ) const

inlineoverridevirtual

Get pointer to the first element of the wrapped stack array.

Implements stk::IStackMemory.

Definition at line 161 of file stk_helper.h.

161{ return (*m_stack); }

◆ GetStackSize()

template<size_t _StackSize>

size_t stk::StackMemoryWrapper< _StackSize >::GetStackSize ( ) const

inlineoverridevirtual

Get number of elements in the wrapped stack array.

Implements stk::IStackMemory.

Definition at line 165 of file stk_helper.h.

165{ return _StackSize; }

◆ GetStackSizeBytes()

template<size_t _StackSize>

size_t stk::StackMemoryWrapper< _StackSize >::GetStackSizeBytes ( ) const

inlineoverridevirtual

Get size of the wrapped stack array in bytes.

Implements stk::IStackMemory.

Definition at line 169 of file stk_helper.h.

169{ return (_StackSize * sizeof(Word)); }

◆ GetStackSpace()

virtual size_t stk::IStackMemory::GetStackSpace ( ) const

inlinevirtualinherited

Get available stack space.

Returns: Number of elements of the stack memory array remaining on the stack (computed via the watermark pattern). Returns 0 if the stack has been fully used or the watermark STK_STACK_MEMORY_FILLER was overwritten.

Warning: Stack type: Bottom to Top (index[0]).

Definition at line 319 of file stk_common.h.

    {
        const ArrayView<const Word> stack(GetStack(), GetStackSize());
        const size_t total_size = stack.GetSize();
        size_t space = 0U;
 
        for (size_t i = 0U; i < total_size; ++i)
        {
            if (stack[i] == STK_STACK_MEMORY_FILLER)
            {
                space = i + 1U;
            }
            else
            {
                break; // terminate loop as soon as watermark ends
            }
        }
 
        return space;
    }