IPC@CHIP® RTOS-LNX – API Documentation

Header image

Main page


Data Fields
sTASK_INFO Struct Reference

RTX task information report. More...

Detailed Description

This data structure is used by the RTX_Task_Info() API to report detailed information concerning a specific task.

typedef struct tTASK_INFO
{
unsigned int tiTaskState ;
char tiName[5] ;
unsigned char tiTaskPriority ;
unsigned char tiProgIdx ;
unsigned char tiTaskMonStatus ;
QWORD tiDutyTime ;
QWORD tiElapsedTime ;
QWORD tiRunTime ;
QWORD tiExistTime ;
unsigned int tiStackUsed ;
unsigned int tiStackSize ;


The tiStackUsed member is valid only if the measureStack input parameter to the RTX_Task_Info() API was set.

The tiDutyTime and tiElapsedTime member values are valid only if the RTX_MON_READY bit is set in tiTaskMonStatus. These values are up to date if both RTX_MON_READY and RTX_MON_RUNNING flags are set. (At the first invocation of RTX_Task_Info() only the RTX_MON_RUNNING will be set.)

The reported tiElapsedTime is the amount of time since a previous call to RTX_Task_Info() was made for the respective task. And tiDutyTime is the amount of CPU time this task has used since that previous call. In this way the period over which a task's duty cycle is measured can be controlled by the time between calls to RTX_Task_Info().

Note: Task overall duty cycle loading can be calculated as:

     tiRunTime / tiExistTime

Compatibility:
This data structure is not defined in the SC1x, SC2x and SC1x3 C-libraries. The tiDutyTime and tiElapsedTime members have been extended to QWORD instead of the DWORD used in the SC2x3 C-libraries. For the SC2x3, the tiDutyTime and tiElapsedTime members were only valid when RTX_Start_Task_Monitor() was called previously. This function is no longer needed and not implemented in the @CHIP-RTOS-LNX.
Since
V0.80
Changes:
V1.05 - tiDutyTime/tiElapsedTime values are now implemented.

Data Fields

unsigned int tiTaskState
 
RTX_ID tiTaskID
 
char tiName [5]
 
unsigned char tiTaskPriority
 
unsigned char tiProgIdx
 
unsigned char tiTaskMonStatus
 
QWORD tiDutyTime
 
QWORD tiElapsedTime
 
QWORD tiRunTime
 
QWORD tiExistTime
 
unsigned int tiStackUsed
 
unsigned int tiStackSize
 





Top of page | Main page

Copyright © 2017 Beck IPC GmbH
Generated on Tue Dec 12 2017 09:23:37 by Doxygen 1.8.13