os_cpu_c.c

~{WwU_J9SC5D~}ucos~{T4Bk#,1`RkA4=S5wJT>y?IRT#,4x~}uart~{2bJT~}

/*
*********************************************************************************************************
*                                               uC/OS-II
*                                         The Real-Time Kernel
*
*                        (c) Copyright 1992-1998, Jean J. Labrosse, Plantation, FL
*                                          All Rights Reserved
*                        (c) Copyright ARM Limited 1999.  All rights reserved.
*
*                                          ARM Specific code
*
*
* File : OS_CPU_C.C
*********************************************************************************************************
*/
#define  OS_CPU_GLOBALS
#include "../source/includes.h"


/*
*********************************************************************************************************
*                                        INITIALIZE A TASK'S STACK
*
* Description: This function is called by either OSTaskCreate() or OSTaskCreateExt() to initialize the
*              stack frame of the task being created.  This function is highly processor specific.
*
* Arguments  : task          is a pointer to the task code
*
*              pdata         is a pointer to a user supplied data area that will be passed to the task
*                            when the task first executes.
*
*              ptos          is a pointer to the top of stack.  It is assumed that 'ptos' points to
*                            a 'free' entry on the task stack.  If OS_STK_GROWTH is set to 1 then 
*                            'ptos' will contain the HIGHEST valid address of the stack.  Similarly, if
*                            OS_STK_GROWTH is set to 0, the 'ptos' will contains the LOWEST valid address
*                            of the stack.
*
*              opt           specifies options that can be used to alter the behavior of OSTaskStkit().
*                            (see uCOS_II.H for OS_TASK_OPT_???).
*
* Returns    : Always returns the location of the new top-of-stack' once the processor registers have
*              been placed on the stack in the proper order.
*********************************************************************************************************
*/
#if OS_TASK_DEL_EN == 1
/* Called should a task ever try returning */
static void SelfDestruct(void)
{
	OSTaskDel(OS_PRIO_SELF);   
}
#endif


#if OS_STK_GROWTH == 1
/* Full descending stack */
#define STACKTHIS(stk, item) *--stk = (OS_STK) item
#else
/* Empty ascending stack */
#define STACKTHIS(stk, item) *stk++ = (OS_STK) item
#endif


OS_STK *OSTaskStkInit(void (*task)(void *pd), void *pdata, OS_STK *ptos, INT16U opt)
{
	OS_STK *stk;

	opt    = opt;                           /* 'opt' is not used, prevent warning                      */
	stk    = (OS_STK *)ptos;                /* Load stack pointer                                      */

	/* Stuff a starting context frame onto the stack */
#if OS_TASK_DEL_EN ==1
	STACKTHIS(stk, SelfDestruct);           /* r14=addr of SelfDestruct routine in case of return      */
#else
	STACKTHIS(stk, 0);                      /* r14=Reset machine in case of return                     */
#endif
	STACKTHIS(stk, ptos);                   /* r13=stack ptr                                           */
	STACKTHIS(stk, 0);                      /* r12=ip                                                  */
	STACKTHIS(stk, 0);                      /* r11=fp                                                  */
	STACKTHIS(stk, ptos);                   /* r10=sl                                                  */
	STACKTHIS(stk, 0);                      /* r9=sb                                                   */
	STACKTHIS(stk, 0);                      /* r8                                                      */
	STACKTHIS(stk, 0);                      /* r7                                                      */
	STACKTHIS(stk, 0);                      /* r6                                                      */
	STACKTHIS(stk, 0);                      /* r5                                                      */
	STACKTHIS(stk, 0);                      /* r4                                                      */
	STACKTHIS(stk, 0);                      /* r3                                                      */
	STACKTHIS(stk, 0);                      /* r2                                                      */
	STACKTHIS(stk, 0);                      /* r1                                                      */
	STACKTHIS(stk, pdata);                  /* r0                                                      */
	STACKTHIS(stk, task);                   /* pc                                                      */
	STACKTHIS(stk, 0x1f);                   /* spsr=SYS_MODE, interrupts enabled, flags flattened      */

	return ((OS_STK *)stk);
}


/*$PAGE*/
#if OS_CPU_HOOKS_EN
/*
*********************************************************************************************************
*                                          TASK CREATION HOOK
*
* Description: This function is called when a task is created.
*
* Arguments  : ptcb   is a pointer to the task control block of the task being created.
*
* Note(s)    : 1) Interrupts are disabled during this call.
*********************************************************************************************************
*/
void OSTaskCreateHook(OS_TCB *ptcb)
{
}


/*
*********************************************************************************************************
*                                           TASK DELETION HOOK
*
* Description: This function is called when a task is deleted.
*
* Arguments  : ptcb   is a pointer to the task control block of the task being deleted.
*
* Note(s)    : 1) Interrupts are disabled during this call.
*********************************************************************************************************
*/
void OSTaskDelHook(OS_TCB *ptcb)
{
}


/*
*********************************************************************************************************
*                                           TASK SWITCH HOOK
*
* Description: This function is called when a task switch is performed.  This allows you to perform other
*              operations during a context switch.
*
* Arguments  : none
*
* Note(s)    : 1) Interrupts are disabled during this call.
*              2) It is assumed that the global pointer 'OSTCBHighRdy' points to the TCB of the task that
*                 will be 'switched in' (i.e. the highest priority task) and, 'OSTCBCur' points to the 
*                 task being switched out (i.e. the preempted task).
*********************************************************************************************************
*/
void OSTaskSwHook (void)
{
	/*
	static char i=0;
	put_byte(i++);
	*/
}


/*
*********************************************************************************************************
*                                       OS INITIALIZATION HOOK
*                                            (BEGINNING)
*
* Description: This function is called by OSInit() at the beginning of OSInit().
*
* Arguments  : none
*
* Note(s)    : 1) Interrupts are disabled during this call.
*********************************************************************************************************
*/
#if OS_VERSION > 203
void OSInitHookBegin (void)
{
}
#endif

void OSTaskIdleHook()
{
}

void OSTCBInitHook(OS_TCB *ptcb)
{
}


/*
*********************************************************************************************************
*                                       OS INITIALIZATION HOOK
*                                               (END)
*                                        INITIALIZE FP SUPPORT
*
* Description: This function is called to initialize the memory partition needed to support context
*              switching the Floating-Point registers.  This function is called by OSInit() at the end of 
*              OSInit().
*
* Arguments  : none
*
* Returns    : none
*
* Note(s)    : 1) Tasks that are to use FP support MUST be created with OSTaskCreateExt().
*              2) For the 80486 processor, 108 bytes are required to save the FPU context.  I decided to
*                 allocate 128 bytes (i.e. 32 * INT32U) for future expansion.  Also, I used INT32U to 
*                 ensure that storage is located on a 32-bit boundary.
*              3) I decided to 'change' the 'Options' attribute for the statistic task in case you
*                 use OSTaskStatHook() and need to perform floating-point operations in this function.
*                 This only applies if OSTaskStat() was created with OSTaskCreateExt().
*********************************************************************************************************
*/
#if OS_VERSION > 203
void OSInitHookEnd (void)
{
}
#endif


/*
*********************************************************************************************************
*                                           STATISTIC TASK HOOK
*
* Description: This function is called every second by uC/OS-II's statistics task.  This allows your 
*              application to add functionality to the statistics task.
*
* Arguments  : none
*********************************************************************************************************
*/
void OSTaskStatHook (void)
{
}


/*
*********************************************************************************************************
*                                               TICK HOOK
*
* Description: This function is called every tick.
*
* Arguments  : none
*
* Note(s)    : 1) Interrupts may or may not be ENABLED during this call.
*********************************************************************************************************
*/
void OSTimeTickHook (void)
{
}
#endif