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).
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.
stk::TId	GetId () const override
	Get task Id set by application.
const char *	GetTraceName () const override
	Get task trace name set by application.
virtual size_t	GetStackSpace ()
	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 174 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 177 of file cmsis_os2_stk.cpp.

Constructor & Destructor Documentation

◆ StkThread()

StkThread::StkThread ( )

inlineexplicit

Definition at line 185 of file cmsis_os2_stk.cpp.

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

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

References stk::ACCESS_PRIVILEGED.

◆ GetId()

stk::TId StkThread::GetId ( ) const

inlineoverridevirtual

Get task Id set by application.

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

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

Implements stk::ITask.

Definition at line 225 of file cmsis_os2_stk.cpp.

References stk::hw::PtrToWord().

Here is the call graph for this function:

◆ GetStack()

stk::Word * StkThread::GetStack ( ) const

inlineoverridevirtual

Get pointer to the stack memory.

Implements stk::IStackMemory.

Definition at line 217 of file cmsis_os2_stk.cpp.

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

References m_stack_size.

◆ GetStackSizeBytes()

size_t StkThread::GetStackSizeBytes ( ) const

inlineoverridevirtual

Get size of the memory in bytes.

Implements stk::IStackMemory.

Definition at line 219 of file cmsis_os2_stk.cpp.

References m_stack_size.

Referenced by osThreadGetStackSize().

Here is the caller graph for this function:

◆ GetStackSpace()

virtual size_t stk::IStackMemory::GetStackSpace ( )

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

References GetStack(), GetStackSize(), and STK_STACK_MEMORY_FILLER.

Referenced by osThreadGetStackSpace(), and stk::test::TEST().

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.

Implements stk::ITask.

Definition at line 226 of file cmsis_os2_stk.cpp.

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: SwitchStrategySmoothWeightedRoundRobin, IKernelTask::GetWeight

Implements stk::ITask.

Definition at line 224 of file cmsis_os2_stk.cpp.

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.

Implements stk::ITask.

Definition at line 223 of file cmsis_os2_stk.cpp.

◆ 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.

Implements stk::ITask.

Definition at line 208 of file cmsis_os2_stk.cpp.

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.

Implements stk::ITask.

Definition at line 201 of file cmsis_os2_stk.cpp.

References m_argument, and m_func.

Member Data Documentation

◆ m_argument

void* StkThread::m_argument

Definition at line 230 of file cmsis_os2_stk.cpp.

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

◆ m_cb_owned

bool StkThread::m_cb_owned

Definition at line 240 of file cmsis_os2_stk.cpp.

Referenced by StkThread().

◆ m_func

osThreadFunc_t StkThread::m_func

Definition at line 229 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 236 of file cmsis_os2_stk.cpp.

Referenced by OnExit(), and osThreadJoin().

◆ m_join_state

volatile JoinState StkThread::m_join_state

Definition at line 235 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 231 of file cmsis_os2_stk.cpp.

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

◆ m_stack

stk::Word* StkThread::m_stack

Definition at line 233 of file cmsis_os2_stk.cpp.

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

◆ m_stack_owned

bool StkThread::m_stack_owned

Definition at line 238 of file cmsis_os2_stk.cpp.

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

◆ m_stack_size

size_t StkThread::m_stack_size

Definition at line 234 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 232 of file cmsis_os2_stk.cpp.

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

◆ m_suspended

bool StkThread::m_suspended

Definition at line 239 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 237 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