📄 tcc.c
字号:
/*************************************************************************/
/* */
/* Copyright Mentor Graphics Corporation 2004 */
/* All Rights Reserved. */
/* */
/* THIS WORK CONTAINS TRADE SECRET AND PROPRIETARY INFORMATION WHICH IS */
/* THE PROPERTY OF MENTOR GRAPHICS CORPORATION OR ITS LICENSORS AND IS */
/* SUBJECT TO LICENSE TERMS. */
/* */
/*************************************************************************/
/*************************************************************************/
/* */
/* FILE NAME VERSION */
/* */
/* tcc.c Nucleus PLUS 1.15 */
/* */
/* COMPONENT */
/* */
/* TC - Thread Control */
/* */
/* DESCRIPTION */
/* */
/* This file contains the core routines for the Thread Control */
/* component. */
/* */
/* DATA STRUCTURES */
/* */
/* None */
/* */
/* FUNCTIONS */
/* */
/* TCC_Create_Task Create a task */
/* TCC_Delete_Task Delete a task */
/* TCC_Create_HISR Create HISR */
/* TCC_Delete_HISR Delete HISR */
/* TCC_Reset_Task Reset the specified task */
/* TCC_Terminate_Task Terminate the specified task */
/* TCC_Resume_Task Resume a task */
/* TCC_Resume_Service Resume a task service call */
/* TCC_Suspend_Task Suspend a task */
/* TCC_Suspend_Service Suspend a task service call */
/* TCC_Task_Timeout Task timeout function */
/* TCC_Task_Sleep Task sleep request */
/* TCC_Relinquish Relinquish task execution */
/* TCC_Time_Slice Process task time-slice */
/* TCC_Current_Task_Pointer Retrieve current task pointer*/
/* TCC_Current_HISR_Pointer Retrieve current HISR pointer*/
/* TCC_Task_Shell Task execution shell */
/* TCC_Signal_Shell Signal execution shell */
/* TCC_Dispatch_LISR Dispatch LISR routine */
/* TCC_Register_LISR Register an LISR */
/* */
/* DEPENDENCIES */
/* */
/* cs_extr.h Common Service functions */
/* tc_extr.h Thread Control functions */
/* in_extr.h Initialization/Interrupt */
/* functions */
/* tm_extr.h Timer Control function */
/* er_extr.h Error handling function */
/* hi_extr.h History functions */
/* */
/*************************************************************************/
#define NU_SOURCE_FILE
#include "plus/inc/in_defs.h" /* Initialization defines */
#include "plus/inc/cs_extr.h" /* Common service functions */
#include "plus/inc/tc_extr.h" /* Thread control functions */
#include "plus/inc/in_extr.h" /* Initialization/Interrupt */
/* functions */
#include "plus/inc/tm_extr.h" /* Timer control functions */
#include "plus/inc/er_extr.h" /* Error handling function */
#include "plus/inc/hi_extr.h" /* History functions */
#if ((defined(NU_MODULE_SUPPORT)) && (NU_MODULE_SUPPORT > 0))
#include "module/inc/ms_defs.h" /* MS_Module typedef */
#endif
/* Define external inner-component global data references. */
extern INT INC_Initialize_State;
extern CS_NODE *TCD_Created_Tasks_List;
extern UNSIGNED TCD_Total_Tasks;
extern TC_TCB *TCD_Priority_List[TC_PRIORITIES];
extern UNSIGNED TCD_Priority_Groups;
extern DATA_ELEMENT TCD_Sub_Priority_Groups[TC_MAX_GROUPS];
extern UNSIGNED_CHAR TCD_Lowest_Set_Bit[];
extern INT TCD_Highest_Priority;
extern TC_TCB *TCD_Execute_Task;
extern VOID *TCD_Current_Thread;
extern UNSIGNED_CHAR TCD_Registered_LISRs[NU_MAX_VECTORS+1];
extern VOID (*TCD_LISR_Pointers[NU_MAX_LISRS+1])(INT vector);
extern INT TCD_Interrupt_Count;
extern INT TCD_Stack_Switched;
extern TC_PROTECT TCD_List_Protect;
extern TC_PROTECT TCD_System_Protect;
extern TC_PROTECT TCD_LISR_Protect;
extern CS_NODE *TCD_Created_HISRs_List;
extern UNSIGNED TCD_Total_HISRs;
extern TC_PROTECT TCD_HISR_Protect;
extern INT TCD_Unhandled_Interrupt;
/* Define external inner-component function calls that are not available to
other components. */
VOID TCT_Build_Task_Stack(TC_TCB *task_ptr);
VOID TCT_Build_HISR_Stack(TC_HCB *hisr_ptr);
VOID TCT_Build_Signal_Frame(TC_TCB *task_ptr);
VOID TCT_Protect_Switch(TC_TCB *task);
VOID TCT_Signal_Exit(VOID);
/* Define internal function calls. */
VOID TCC_Signal_Shell(VOID);
#if defined(NU_MODULE_SUPPORT) && (NU_MODULE_SUPPORT > 0)
/* Define service routines "privately" imported from other components */
extern MS_MODULE* msd_current_module;
STATUS MSC_Bind_Module_HISR(MS_MODULE* module, TC_HCB* hisr);
STATUS MSC_Bind_Module_Task(MS_MODULE* module, TC_TCB* task);
#endif /* NU_MODULE_SUPPORT */
/*************************************************************************/
/* */
/* FUNCTION */
/* */
/* TCC_Create_Task */
/* */
/* DESCRIPTION */
/* */
/* This function creates a task and then places it on the list of */
/* created tasks. All the resources necessary to create the task */
/* are supplied to this routine. If specified, the newly created */
/* task is started. Otherwise, it is left in a suspended state. */
/* */
/* CALLED BY */
/* */
/* Application */
/* TCCE_Create_Task Error checking shell */
/* */
/* CALLS */
/* */
/* CSC_Place_On_List Add TCB to linked-list */
/* [HIC_Make_History_Entry] Make entry in history log */
/* TCC_Resume_Task Start the created task */
/* TCT_Build_Task_Stack Build an initial task stack */
/* [TCT_Check_Stack] Stack checking function */
/* TCT_Control_To_System Transfer control to system */
/* TCT_Protect Protect created task list */
/* TCT_Unprotect Release protection of list */
/* TMC_Init_Task_Timer Initialize the task's timer */
/* */
/* INPUTS */
/* */
/* task_ptr Task control block pointer */
/* name Task name */
/* task_entry Entry function of the task */
/* argc Optional task parameter */
/* argv Optional task parameter */
/* stack_address Pointer to start of stack */
/* stack_size Size of task stack in bytes */
/* priority Task priority */
/* time_slice Task time slice */
/* preempt Task preemptability flag */
/* auto_start Automatic task start */
/* */
/* OUTPUTS */
/* */
/* NU_SUCCESS */
/* */
/*************************************************************************/
STATUS TCC_Create_Task(NU_TASK *task_ptr, CHAR *name,
VOID (*task_entry)(UNSIGNED, VOID *), UNSIGNED argc, VOID *argv,
VOID *stack_address, UNSIGNED stack_size,
OPTION priority, UNSIGNED time_slice,
OPTION preempt, OPTION auto_start)
{
R1 TC_TCB *task; /* Task control block ptr */
R2 INT i; /* Working index variable */
STATUS status = NU_SUCCESS;
NU_SUPERV_USER_VARIABLES
/* Switch to supervisor mode */
NU_SUPERVISOR_MODE();
/* Move input task pointer into internal pointer. */
task = (TC_TCB *) task_ptr;
#ifdef NU_ENABLE_STACK_CHECK
/* Call stack checking function to check for an overflow condition. */
TCT_Check_Stack();
#endif
#ifdef NU_ENABLE_HISTORY
/* Make an entry that corresponds to this function in the system history
log. */
HIC_Make_History_Entry(NU_CREATE_TASK_ID, (UNSIGNED) task,
(UNSIGNED) name, (UNSIGNED) task_entry);
#endif
/* First, clear the task ID just in case it is an old Task
Control Block. */
task -> tc_id = 0;
/* Fill in the task name. */
for (i = 0; i < NU_MAX_NAME; i++)
task -> tc_name[i] = name[i];
/* Fill in the basic task information. */
task -> tc_entry = task_entry;
task -> tc_argc = argc;
task -> tc_argv = argv;
task -> tc_status = NU_PURE_SUSPEND;
task -> tc_delayed_suspend = NU_FALSE;
task -> tc_scheduled = 0;
task -> tc_time_slice = time_slice;
task -> tc_cur_time_slice = time_slice;
task -> tc_current_protect = NU_NULL;
task -> tc_suspend_protect = NU_NULL;
task -> tc_cleanup = NU_NULL;
task -> tc_cleanup_info = NU_NULL;
/* Setup task's preemption posture. */
if (preempt == NU_PREEMPT)
task -> tc_preemption = NU_TRUE;
else
task -> tc_preemption = NU_FALSE;
/* Fill in information about the task's stack. */
task -> tc_stack_start = stack_address;
task -> tc_stack_end = 0;
task -> tc_stack_size = stack_size;
task -> tc_stack_minimum = stack_size;
/* Setup priority information for the task. There are two bit maps
associated with each task. The first bit map indicates which group
of 8-priorities it is. The second bit map indicates the actual
priority within the group. */
task -> tc_priority = priority;
task -> tc_priority_head = &(TCD_Priority_List[priority]);
task -> tc_sub_priority = (DATA_ELEMENT) (1 << (priority & 7));
priority = priority >> 3;
task -> tc_priority_group = ((UNSIGNED) 1) << priority;
task -> tc_sub_priority_ptr = &(TCD_Sub_Priority_Groups[priority]);
/* Initialize link pointers. */
task -> tc_created.cs_previous = NU_NULL;
task -> tc_created.cs_next = NU_NULL;
task -> tc_ready_previous = NU_NULL;
task -> tc_ready_next = NU_NULL;
/* Build a stack frame for this task by calling TCT_Build_Task_Stack. */
TCT_Build_Task_Stack(task);
/* Initialize the signal information of the task. */
task -> tc_signals = 0;
task -> tc_enabled_signals = 0;
task -> tc_signal_handler = 0;
task -> tc_signal_active = NU_FALSE;
/* Initialize additional kernel options data */
#if (NU_SUPERV_USER_MODE == 1)
task->tc_su_mode = 0; /* Initially in User mode */
task->tc_module = 0; /* Not initially bound to a module */
#endif
/* Initialize the task timer. */
task -> tc_timer_active = NU_FALSE;
TMC_Init_Task_Timer(&(task -> tc_timer_control), (VOID *) task);
/* Protect the list of created tasks. */
TCT_Protect(&TCD_List_Protect);
/* At this point the task is completely built. The ID can now be
set and it can be linked into the created task list. */
task -> tc_id = TC_TASK_ID;
#if defined(NU_MODULE_SUPPORT) && (NU_MODULE_SUPPORT > 0)
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -