Inheritance diagram for StkThread:

Collaboration diagram for StkThread:

Public Types
enum class	JoinState : uint8_t { Detached , Joinable , Exited , Joined }

Public Member Functions
	StkThread ()
virtual	~StkThread ()
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).
const stk::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.
stk::EAccessMode	GetAccessMode () const override
	Get hardware access mode of the user task.
void	OnDeadlineMissed (uint32_t) 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.
TId	GetId () const
	Get task Id set by application.
virtual size_t	GetStackSpace () const
	Get available stack space.

Public Attributes
osThreadFunc_t	m_func
void *	m_argument
const char *	m_name
volatile int32_t	m_stk_priority
stk::Word *	m_stack
size_t	m_stack_size
volatile JoinState	m_join_state
stk::sync::ConditionVariable	m_join_cv
stk::sync::EventFlags	m_thread_flags
bool	m_stack_owned
bool	m_suspended
bool	m_cb_owned

Detailed Description

Definition at line 139 of file cmsis_os2_stk.cpp.

Member Enumeration Documentation

◆ JoinState

enum class StkThread::JoinState : uint8_t

strong

Enumerator
Detached
Joinable
Exited
Joined

Definition at line 142 of file cmsis_os2_stk.cpp.

    {
        Detached, // osThreadDetach() was called, or created with osThreadDetached
        Joinable, // created with osThreadJoinable, not yet joined or exited
        Exited,   // Run() has returned; OnExit() has fired; not yet joined
        Joined,   // a joiner has already collected the result; further joins are errors
    };

Constructor & Destructor Documentation

◆ StkThread()

StkThread::StkThread ( )

inlineexplicit

Definition at line 150 of file cmsis_os2_stk.cpp.

        : m_func(nullptr), m_argument(nullptr), m_name(nullptr),
          m_stk_priority(CmsisPrioToStk(osPriorityNormal)),
          m_stack(nullptr), m_stack_size(0), m_join_state(JoinState::Detached),
          m_stack_owned(false), m_suspended(false), m_cb_owned(true)
    {}

References CmsisPrioToStk(), m_argument, m_cb_owned, m_func, m_join_state, m_name, m_stack, m_stack_owned, m_stack_size, m_stk_priority, m_suspended, and osPriorityNormal.

Here is the call graph for this function:

◆ ~StkThread()

virtual StkThread::~StkThread ( )

inlinevirtual

Definition at line 157 of file cmsis_os2_stk.cpp.

    {
        if (m_stack_owned && (m_stack != nullptr))
        {
            delete[] m_stack;
            m_stack = nullptr;
        }
    }

References m_stack, and m_stack_owned.

Member Function Documentation

◆ GetAccessMode()

stk::EAccessMode StkThread::GetAccessMode ( ) const

inlineoverridevirtual

Get hardware access mode of the user task.

Implements stk::ITask.

Definition at line 187 of file cmsis_os2_stk.cpp.

187{ return stk::ACCESS_PRIVILEGED; }

stk::ACCESS_PRIVILEGED

@ ACCESS_PRIVILEGED

Privileged access mode (access to hardware is fully unrestricted).

Definition stk_common.h:34

References stk::ACCESS_PRIVILEGED.

◆ 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 stk::Word * StkThread::GetStack ( ) const

inlineoverridevirtual

Get pointer to the stack memory.

Implements stk::IStackMemory.

Definition at line 182 of file cmsis_os2_stk.cpp.

182{ return m_stack; }

References m_stack.

◆ GetStackSize()

size_t StkThread::GetStackSize ( ) const

inlineoverridevirtual

Get number of elements of the stack memory array.

Implements stk::IStackMemory.

Definition at line 183 of file cmsis_os2_stk.cpp.

183{ return m_stack_size; }

References m_stack_size.

◆ GetStackSizeBytes()

size_t StkThread::GetStackSizeBytes ( ) const

inlineoverridevirtual

Get size of the memory in bytes.

Implements stk::IStackMemory.

Definition at line 184 of file cmsis_os2_stk.cpp.

184{ return m_stack_size * sizeof(stk::Word); }

stk::Word

uintptr_t Word

Native processor word type.

Definition stk_common.h:115

References m_stack_size.

Referenced by osThreadGetStackSize().

Here is the caller graph for this function:

◆ 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 318 of file stk_common.h.

    {
        ArrayView<const Word> stack(GetStack(), GetStackSize());
      
        // count leading Words equal to STK_STACK_MEMORY_FILLER (watermark)
        size_t space = 0U;
        for ( ; (space < stack.GetSize()) && (stack[space] == STK_STACK_MEMORY_FILLER); ++space)
        {}
 
        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 * StkThread::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 190 of file cmsis_os2_stk.cpp.

190{ return m_name; }

References m_name.

◆ GetWeight()

int32_t StkThread::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 189 of file cmsis_os2_stk.cpp.

189{ return m_stk_priority; }

References m_stk_priority.

◆ OnDeadlineMissed()

void StkThread::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 188 of file cmsis_os2_stk.cpp.

188{}

◆ OnExit()

void StkThread::OnExit ( )

inlineoverridevirtual

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 173 of file cmsis_os2_stk.cpp.

    {
        m_join_state = JoinState::Exited;
 
        // wake any osThreadJoin() caller
        m_join_cv.NotifyAll();
    }

References Exited, m_join_cv, and m_join_state.

◆ Run()

void StkThread::Run ( )

inlineoverridevirtual

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

}

}

StkThread::Run
void Run() override
Entry point of the user task.
Definition cmsis_os2_stk.cpp:166

Implements stk::ITask.

Definition at line 166 of file cmsis_os2_stk.cpp.

    {
        m_func(m_argument);
 
        // KERNEL_DYNAMIC: returning from Run() removes the task automatically.
    }

References m_argument, and m_func.

Member Data Documentation

◆ m_argument

void* StkThread::m_argument

Definition at line 194 of file cmsis_os2_stk.cpp.

Referenced by osThreadNew(), Run(), and StkThread().

◆ m_cb_owned

bool StkThread::m_cb_owned

Definition at line 204 of file cmsis_os2_stk.cpp.

Referenced by StkThread().

◆ m_func

osThreadFunc_t StkThread::m_func

Definition at line 193 of file cmsis_os2_stk.cpp.

Referenced by osThreadNew(), Run(), and StkThread().

◆ m_join_cv

stk::sync::ConditionVariable StkThread::m_join_cv

Definition at line 200 of file cmsis_os2_stk.cpp.

Referenced by OnExit(), and osThreadJoin().

◆ m_join_state

volatile JoinState StkThread::m_join_state

Definition at line 199 of file cmsis_os2_stk.cpp.

Referenced by OnExit(), osThreadDetach(), osThreadJoin(), osThreadNew(), osThreadTerminate(), and StkThread().

◆ m_name

const char* StkThread::m_name

Definition at line 195 of file cmsis_os2_stk.cpp.

Referenced by GetTraceName(), osThreadNew(), and StkThread().

◆ m_stack

stk::Word* StkThread::m_stack

Definition at line 197 of file cmsis_os2_stk.cpp.

Referenced by GetStack(), osThreadNew(), StkThread(), and ~StkThread().

◆ m_stack_owned

bool StkThread::m_stack_owned

Definition at line 202 of file cmsis_os2_stk.cpp.

Referenced by osThreadNew(), StkThread(), and ~StkThread().

◆ m_stack_size

size_t StkThread::m_stack_size

Definition at line 198 of file cmsis_os2_stk.cpp.

Referenced by GetStackSize(), GetStackSizeBytes(), osThreadNew(), and StkThread().

◆ m_stk_priority

volatile int32_t StkThread::m_stk_priority

Definition at line 196 of file cmsis_os2_stk.cpp.

Referenced by GetWeight(), osThreadGetPriority(), osThreadNew(), osThreadSetPriority(), and StkThread().

◆ m_suspended

bool StkThread::m_suspended

Definition at line 203 of file cmsis_os2_stk.cpp.

Referenced by osThreadGetState(), osThreadResume(), osThreadSuspend(), and StkThread().

◆ m_thread_flags

stk::sync::EventFlags StkThread::m_thread_flags

Definition at line 201 of file cmsis_os2_stk.cpp.

Referenced by osThreadFlagsClear(), osThreadFlagsSet(), and osThreadFlagsWait().

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

cmsis_os2_stk.cpp

Public Types

Public Member Functions

Public Attributes

Detailed Description

Member Enumeration Documentation

◆ JoinState

Constructor & Destructor Documentation

◆ StkThread()

◆ ~StkThread()

Member Function Documentation

◆ GetAccessMode()

◆ GetId()

◆ GetStack()

◆ GetStackSize()

◆ GetStackSizeBytes()

◆ GetStackSpace()

◆ GetTraceName()

◆ GetWeight()

◆ OnDeadlineMissed()

◆ OnExit()

◆ Run()

Member Data Documentation

◆ m_argument

◆ m_cb_owned

◆ m_func

◆ m_join_cv

◆ m_join_state

◆ m_name

◆ m_stack

◆ m_stack_owned

◆ m_stack_size

◆ m_stk_priority

◆ m_suspended

◆ m_thread_flags