/****************************************Copyright (c)**************************************************
**                               廣州周立功單片機發展有限公司
**                                     研    究    所
**                                        產品一部 
**
**                                 http://www.zlgmcu.com
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: os_cpu_c.c
**創   建   人: 陳明計
**最后修改日期: 2004年8月27日
**描        述: μCOS-II在lpc210x上的移植代碼C語言部分，包括任務堆棧初始化代碼和鉤子函數等
**              用ads1.2編譯，必須使用ARM方式編譯
**
**--------------歷史版本信息----------------------------------------------------------------------------
** 創建人: 陳明計
** 版  本: 1.0
** 日　期: 2003年6月5日
** 描　述: 原始版本
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: 1.1
** 日　期: 2003年6月13日
** 描　述: 增加函數IsrEnIRQ，使函數OSTaskStkInit代碼更簡潔
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: 1.2
** 日　期: 2003年6月19日
** 描　述: 增加軟中斷服務函數
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: 1.3
** 日　期: 2003年7月8日
** 描　述: 去除不必要的函數IsrEnIRQ
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: 1.4
** 日　期: 2004年8月27日
** 描　述: 提高SWI異常服務的效率
**
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 
** 日　期: 
** 描　述: 
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
#define  OS_CPU_GLOBALS
#include "config.h"

#if OS_SELF_EN == 0 
int const _OSFunctionAddr[1] = {0};
int const _UsrFunctionAddr[1] = {0};
#endif

/*********************************************************************************************************
** 函數名稱: OSTaskStkInit
** 功能描述: 任務堆棧初始化代碼，本函數調用失敗會使系統崩潰
** 輸　入: task  : 任務開始執行的地址
**         pdata ：傳遞給任務的參數
**         ptos  ：任務的堆棧開始位置
**         opt   ：附加參數，當前版本對于本函數無用，具體意義參見OSTaskCreateExt()的opt參數
** 輸　出: 棧頂指針位置
** 全局變量:
** 調用模塊: 
**
** 作　者: 陳明計
** 日　期: 2003年6月5日
**-------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2003年6月13日
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/

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

    opt    = opt;                           /* 'opt'  沒有使用。作用是避免編譯器警告    */
    stk    = ptos;                          /* 獲取堆棧指針                                       */

                                            /* 建立任務環境，ADS1.2使用滿遞減堆棧       */
    *stk = (OS_STK) task;                   /*  pc  */
    *--stk = (OS_STK) task;                 /*  lr  */

    *--stk = 0;                             /*  r12  */
    *--stk = 0;                             /*  r11  */
    *--stk = 0;                             /*  r10  */
    *--stk = 0;                             /*  r9   */
    *--stk = 0;                             /*  r8   */
    *--stk = 0;                             /*  r7   */
    *--stk = 0;                             /*  r6   */
    *--stk = 0;                             /*  r5   */
    *--stk = 0;                             /*  r4   */
    *--stk = 0;                             /*  r3   */
    *--stk = 0;                             /*  r2   */
    *--stk = 0;                             /*  r1   */
    *--stk = (unsigned int) pdata;          /*  r0,第一個參數使用R0傳遞   */
    *--stk = (USER_USING_MODE|0x00);	    /*  spsr，允許 IRQ, FIQ 中斷   */
    *--stk = 0;                             /*  關中斷計數器OsEnterSum;    */

    return (stk);
}

/*********************************************************************************************************
** 函數名稱: OSStartHighRdy
** 功能描述: uC/OS-II啟動時使用OSStartHighRdy運行第一個任務,
**           實質是產生swi 1指令
** 輸　入:   無
** 輸　出 :  無
** 全局變量: 無
** 調用模塊: 無
** 
** 作　者: 陳明計
** 日　期: 2003年6月5日
**-------------------------------------------------------------------------------------------------------
** 修　改: 
** 日　期: 
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/

        void OSStartHighRdy(void)
{
    _OSStartHighRdy();
}

/*********************************************************************************************************
** 函數名稱: _TaskIsARM
** 功能描述: 任務代碼是ARM代碼
**
** 輸　入:   無
** 輸　出 :  無
** 全局變量: 無
** 調用模塊: 無
** 
** 作　者: 陳明計
** 日　期: 2004年8月27日
**-------------------------------------------------------------------------------------------------------
** 修　改: 
** 日　期: 
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/
        void _TaskIsARM(INT8U prio)
{
    OS_TCB   *ptcb;

    if (prio <= OS_LOWEST_PRIO)
    {
        ptcb = OSTCBPrioTbl[prio];
        if (ptcb != NULL)
        {
            ptcb -> OSTCBStkPtr[1] &= ~(1 << 5);
        }
    }
}
/*********************************************************************************************************
** 函數名稱: _TaskIsARM
** 功能描述: 任務是THUMB代碼
**
** 輸　入:   無
** 輸　出 :  無
** 全局變量: 無
** 調用模塊: 無
** 
** 作　者: 陳明計
** 日　期: 2004年8月27日
**-------------------------------------------------------------------------------------------------------
** 修　改: 
** 日　期: 
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/
        void _TaskIsTHUMB(INT8U prio)
{
    OS_TCB   *ptcb;

    if (prio <= OS_LOWEST_PRIO)
    {
        ptcb = OSTCBPrioTbl[prio];
        if (ptcb != NULL)
        {
            ptcb -> OSTCBStkPtr[1] |= (1 << 5);
        }
    }
}
/* 以下為一些鉤子函數，全部為空函數。具體說明請看相關資料 */

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

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


/*
*********************************************************************************************************
*                                          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)
{
    ptcb = ptcb;                       /* Prevent compiler warning                                     */
}


/*
*********************************************************************************************************
*                                           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)
{
    ptcb = ptcb;                       /* Prevent compiler warning                                     */
}

/*
*********************************************************************************************************
*                                           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)
{
}

/*
*********************************************************************************************************
*                                           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)
{
}

/*
*********************************************************************************************************
*                                           OSTCBInit() HOOK
*
* Description: This function is called by OSTCBInit() after setting up most of the TCB.
*
* Arguments  : ptcb    is a pointer to the TCB of the task being created.
*
* Note(s)    : 1) Interrupts may or may not be ENABLED during this call.
*********************************************************************************************************
*/
#if OS_VERSION > 203
void OSTCBInitHook (OS_TCB *ptcb)
{
    ptcb = ptcb;                                           /* Prevent Compiler warning                 */
}
#endif


/*
*********************************************************************************************************
*                                               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)
{
}


/*
*********************************************************************************************************
*                                             IDLE TASK HOOK
*
* Description: This function is called by the idle task.  This hook has been added to allow you to do  
*              such things as STOP the CPU to conserve power.
*
* Arguments  : none
*
* Note(s)    : 1) Interrupts are enabled during this call.
*********************************************************************************************************
*/
#if OS_VERSION >= 251
void OSTaskIdleHook (void)
{
}
#endif
#endif
/*********************************************************************************************************
**                            End Of File
********************************************************************************************************/