Inheritance diagram for TaskWrapper:

Collaboration diagram for TaskWrapper:

Public Member Functions
	TaskWrapper ()
	~TaskWrapper ()=default
	Destructor.
EAccessMode	GetAccessMode () const override
	Get hardware access mode of the user task.
void	OnDeadlineMissed (uint32_t duration) override
	Called by the scheduler if deadline of the task is missed when Kernel is operating in Hard Real-Time mode (see stk::KERNEL_HRT).
int32_t	GetWeight () const override
	Get static base weight of the task.
const char *	GetTraceName () const override
	Get task trace name set by application.
const Word *	GetStack () const override
	Get pointer to the stack memory.
size_t	GetStackSize () const override
	Get number of elements of the stack memory array.
size_t	GetStackSizeBytes () const override
	Get size of the memory in bytes.
void	Initialize (stk_task_entry_t const func, void user_data, stk_word_t stack, size_t stack_size, EAccessMode mode)
void	SetWeight (Weight weight)
void	SetName (const char *tname)
TId	GetId () const
	Get task Id set by application.
virtual size_t	GetStackSpace () const
	Get available stack space.

Private Member Functions
	TaskWrapper (const TaskWrapper &)=delete
TaskWrapper &	operator= (const TaskWrapper &)=delete
void	Run () override
	Entry point of the user task.
void	OnExit () override
	Called by the kernel before removal from the scheduling (see stk::KERNEL_DYNAMIC).

Private Attributes
stk_task_entry_t	m_func
void *	m_user_data
stk_word_t *	m_stack
size_t	m_stack_size
EAccessMode	m_mode
Weight	m_weight
const char *	m_tname

Detailed Description

Definition at line 74 of file stk_c.cpp.

Constructor & Destructor Documentation

◆ TaskWrapper() [1/2]

TaskWrapper::TaskWrapper ( )

inlineexplicit

Definition at line 77 of file stk_c.cpp.

                           : m_func(nullptr), m_user_data(nullptr), m_stack(nullptr), 
        m_stack_size(0U), m_mode(ACCESS_USER), m_weight(DEFAULT_WEIGHT), m_tname(nullptr)
    {}

References stk::ACCESS_USER, stk::DEFAULT_WEIGHT, m_func, m_mode, m_stack, m_stack_size, m_tname, m_user_data, and m_weight.

Referenced by operator=().

Here is the caller graph for this function:

◆ ~TaskWrapper()

TaskWrapper::~TaskWrapper ( )

default

Destructor.

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

References STK_VIRT_DTOR.

◆ TaskWrapper() [2/2]

TaskWrapper::TaskWrapper ( const TaskWrapper & )

privatedelete

Member Function Documentation

◆ GetAccessMode()

EAccessMode TaskWrapper::GetAccessMode ( ) const

inlineoverridevirtual

Get hardware access mode of the user task.

Implements stk::ITask.

Definition at line 87 of file stk_c.cpp.

87{ return m_mode; }

References m_mode.

◆ GetId()

TId stk::ITask::GetId ( ) const

inlineinherited

Get task Id set by application.

Implementation of ITask::GetId, see ITask. Placed here as it depends on GetTidFromUserTask.

Returns: Application-defined task identifier. Return 0 if unused.

Note: Used for debugging and tracing only. The kernel does not interpret this value.

Definition at line 234 of file stk_helper.h.

{
    return GetTidFromUserTask(this);
}

References stk::GetTidFromUserTask().

Referenced by stk::Kernel< TMode, TSize, TStrategy, TPlatform >::KernelTask::Bind(), and stk_task_get_id().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetStack()

const Word * TaskWrapper::GetStack ( ) const

inlineoverridevirtual

Get pointer to the stack memory.

Implements stk::IStackMemory.

Definition at line 93 of file stk_c.cpp.

93{ return m_stack; }

References m_stack.

◆ GetStackSize()

size_t TaskWrapper::GetStackSize ( ) const

inlineoverridevirtual

Get number of elements of the stack memory array.

Implements stk::IStackMemory.

Definition at line 94 of file stk_c.cpp.

94{ return m_stack_size; }

References m_stack_size.

◆ GetStackSizeBytes()

size_t TaskWrapper::GetStackSizeBytes ( ) const

inlineoverridevirtual

Get size of the memory in bytes.

Implements stk::IStackMemory.

Definition at line 95 of file stk_c.cpp.

95{ return m_stack_size * sizeof(stk_word_t); }

stk_word_t

uintptr_t stk_word_t

CPU register type.

Definition stk_c.h:94

References m_stack_size.

◆ 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;
    }

References stk::ArrayView< T >::GetSize(), GetStack(), GetStackSize(), and STK_STACK_MEMORY_FILLER.

Referenced by FrtosTask::GetStackHighWaterMark(), and osThreadGetStackSpace().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetTraceName()

const char * TaskWrapper::GetTraceName ( ) const

inlineoverridevirtual

Get task trace name set by application.

Returns: Null-terminated name string, or NULL if unused.

Note: Used for debugging and tracing only (e.g. SEGGER SystemView). Kernel does not interpret this value.

Reimplemented from stk::ITask.

Definition at line 90 of file stk_c.cpp.

90{ return m_tname; }

References m_tname.

Referenced by stk_task_get_name().

Here is the caller graph for this function:

◆ GetWeight()

int32_t TaskWrapper::GetWeight ( ) const

inlineoverridevirtual

Get static base weight of the task.

Returns: Static weight value of the task (must be non-zero, positive 24-bit number).

See also: SwitchStrategyFixedPriority, SwitchStrategySmoothWeightedRoundRobin, IKernelTask::GetWeight, IKernelService::InheritWeight, IKernelService::RestoreWeight

Reimplemented from stk::ITask.

Definition at line 89 of file stk_c.cpp.

89{ return m_weight; }

References m_weight.

◆ Initialize()

void TaskWrapper::Initialize	(	stk_task_entry_t const	func,
		void *	user_data,
		stk_word_t *	stack,
		size_t	stack_size,
		EAccessMode	mode )

inline

Definition at line 97 of file stk_c.cpp.

    {
        m_func       = func;
        m_user_data  = user_data;
        m_stack      = stack;
        m_stack_size = stack_size;
        m_mode       = mode;
        m_weight     = DEFAULT_WEIGHT;
    }

References stk::DEFAULT_WEIGHT, m_func, m_mode, m_stack, m_stack_size, m_user_data, and m_weight.

Referenced by AllocateTask().

Here is the caller graph for this function:

◆ OnDeadlineMissed()

void TaskWrapper::OnDeadlineMissed ( uint32_t duration )

inlineoverridevirtual

Called by the scheduler if deadline of the task is missed when Kernel is operating in Hard Real-Time mode (see stk::KERNEL_HRT).

Parameters

[in] duration Elapsed active time in ticks at the point the deadline was detected. Always greater than the task's configured deadline (ticks).

Note: Optional handler. Use it for fault logging.; After this call returns, IPlatform::ProcessHardFault() is invoked and the system enters a safe state. This function should not attempt to recover scheduling.

Reimplemented from stk::ITask.

Definition at line 88 of file stk_c.cpp.

88{ (void)duration; }

◆ OnExit()

void TaskWrapper::OnExit ( )

overrideprivatevirtual

Called by the kernel before removal from the scheduling (see stk::KERNEL_DYNAMIC).

Note: The task's stack is no longer in use but the ITask object itself is still valid.; The default no-op implementation is sufficient for detached tasks. Override to implement join semantics (signal a waiting joiner).; Called in kernel/tick context - keep it short. ISR-safe primitives only (e.g. stk::sync::Semaphore::Signal(), stk::sync::EventFlags::Set()).; KERNEL_DYNAMIC only. Never called in KERNEL_STATIC mode.

Reimplemented from stk::ITask.

Definition at line 147 of file stk_c.cpp.

{
    FreeTask(CastCppTaskInterfaceToC(this)); 
}

References CastCppTaskInterfaceToC(), and FreeTask().

Here is the call graph for this function:

◆ operator=()

TaskWrapper & TaskWrapper::operator= ( const TaskWrapper & )

privatedelete

References TaskWrapper().

Here is the call graph for this function:

◆ Run()

void TaskWrapper::Run ( )

inlineoverrideprivatevirtual

Entry point of the user task.

Note: Called by the Kernel when the task is scheduled for execution. Implement this method with the task's main logic.

Warning: If Kernel is configured as KERNEL_STATIC, the body must contain an infinite loop.
void Run( override)

{

while (true)

{

// task logic here

}

}

TaskWrapper::Run
void Run() override
Entry point of the user task.
Definition stk_c.cpp:114

Implements stk::ITask.

Definition at line 114 of file stk_c.cpp.

114{ m_func(m_user_data); }

References m_func, and m_user_data.

◆ SetName()

void TaskWrapper::SetName ( const char * tname )

inline

Definition at line 109 of file stk_c.cpp.

109{ m_tname = tname; }

References m_tname.

Referenced by stk_task_set_name().

Here is the caller graph for this function:

◆ SetWeight()

void TaskWrapper::SetWeight ( Weight weight )

inline

Definition at line 108 of file stk_c.cpp.

108{ m_weight = weight; }

References m_weight.

Referenced by stk_task_set_weight().

Here is the caller graph for this function:

Member Data Documentation

◆ m_func

stk_task_entry_t TaskWrapper::m_func

private

Definition at line 117 of file stk_c.cpp.

Referenced by Initialize(), Run(), and TaskWrapper().

◆ m_mode

EAccessMode TaskWrapper::m_mode

private

Definition at line 121 of file stk_c.cpp.

Referenced by GetAccessMode(), Initialize(), and TaskWrapper().

◆ m_stack

stk_word_t* TaskWrapper::m_stack

private

Definition at line 119 of file stk_c.cpp.

Referenced by GetStack(), Initialize(), and TaskWrapper().

◆ m_stack_size

size_t TaskWrapper::m_stack_size

private

Definition at line 120 of file stk_c.cpp.

Referenced by GetStackSize(), GetStackSizeBytes(), Initialize(), and TaskWrapper().

◆ m_tname

const char* TaskWrapper::m_tname

private

Definition at line 123 of file stk_c.cpp.

Referenced by GetTraceName(), SetName(), and TaskWrapper().

◆ m_user_data

void* TaskWrapper::m_user_data

private

Definition at line 118 of file stk_c.cpp.

Referenced by Initialize(), Run(), and TaskWrapper().

◆ m_weight

Weight TaskWrapper::m_weight

private

Definition at line 122 of file stk_c.cpp.

Referenced by GetWeight(), Initialize(), SetWeight(), and TaskWrapper().

The documentation for this class was generated from the following file:

stk_c.cpp

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ TaskWrapper() [1/2]

◆ ~TaskWrapper()

◆ TaskWrapper() [2/2]

Member Function Documentation

◆ GetAccessMode()

◆ GetId()

◆ GetStack()

◆ GetStackSize()

◆ GetStackSizeBytes()

◆ GetStackSpace()

◆ GetTraceName()

◆ GetWeight()

◆ Initialize()

◆ OnDeadlineMissed()

◆ OnExit()

◆ operator=()

◆ Run()

◆ SetName()

◆ SetWeight()

Member Data Documentation

◆ m_func

◆ m_mode

◆ m_stack

◆ m_stack_size

◆ m_tname

◆ m_user_data

◆ m_weight