/*********************************************************************************************************
**				                               Small RTOS(51)
**                                   The Real-Time Kernel(For Keil c51)
**
**                                  (c) Copyright 2002-2003, chenmingji
**                                           All Rights Reserved
**
**                                                  V1.20.0
**
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: OS.h
**創   建   人: 陳明計
**最后修改日期:  2003年8月17日
**描　     述: Small RTOS(51) C語言頭文件,定義一些宏和聲明一些函數和變量
**
**--------------歷史版本信息----------------------------------------------------------------------------
** 創建人: 陳明計
** 版  本: V0.50~V1.00
** 日　期: 2002年2月22日~2002年6月20日
** 描　述: 基本完成Small RTOS核
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: V1.10~V1.21
** 日　期: 2002年9月1日~2003年1月23日
** 描　述: 完善Small RTOS
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: V1.20.0
** 日　期: 2003年8月17日
** 描　述: 增加支持任務動態建立和刪除，函數功能向一般的RTOS靠齊
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 
** 日　期:
** 描　述:
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/

#define  OS_VERSION    120                              /* 系統版本號                                   */

#define  OSVersion()     OS_VERSION                     /* 返回系統版本                                 */
#define  OSRunningTaskID() OSTaskID                     /* 返回當前任務ID                               */ 

#define K_SIG      1                                    /* 等待信號                                     */
#define K_TMO      2                                    /* 等待超時                                     */

#define NOT_OK     255                                  /* 參數錯誤                                     */
#define TMO_EVENT  8                                    /* 超時到                                       */
#define SIG_EVENT  4                                    /* 有信號                                       */

 
#ifndef IN_OS_CORE

/* 兼容V1.21.1版本的宏 */
#define OSSendSignal(a)     OSTaskResume((a))
#define OSIntSendSignal(a)  OSTaskResume((a))
#define OSClearSignal(a)    OS_TaskSuspend((a))
#define OSTaskCreate(a, b, c) _OSTaskCreate((c),(a),(b))


extern uint8 data OSWaitTick[];
extern uint8 code OSMapTbl[];
extern uint8 data Os_Enter_Sum;
extern uint8 data OSTaskID;
extern uint8 data OSNextTaskID;
extern uint8 data OSIntNesting;


extern void OSInit(void) small;
/*********************************************************************************************************
** 函數名稱: OSInit
** 功能描述: 系統變量初始化
** 輸　入: 無
** 輸　出: 無
** 全局變量: 
** 調用模塊: OSCPUInit
********************************************************************************************************/

extern void OSStart(void);
/*********************************************************************************************************
** 函數名稱: OSStart
** 功能描述: 啟動多任務環境
** 輸　入: 無
** 輸　出 : 無
** 全局變量: 無
** 調用模塊: OSFindNextRunningTask,OSStartHighRdy
********************************************************************************************************/

extern uint8 _OSTaskCreate(uint8 TaskID, void (code * task)(void), void xdata *ptos) small;
/*********************************************************************************************************
** 函數名稱: _OSTaskCreate
** 功能描述: 創建任務
** 輸　入: TaskID:任務ID
**         task  :任務地址
**         ptos  :任務堆棧，在51中為重入棧
** 輸　出: 無
** 全局變量: 
** 調用模塊: 無
********************************************************************************************************/

extern uint8 OSTaskDel(uint8 TaskID) small;
/*********************************************************************************************************
** 函數名稱: OSTaskDel
** 功能描述: 創建任務
** 輸　入: TaskID:任務ID
** 輸　出: 無
** 全局變量: 
** 調用模塊: 無
********************************************************************************************************/
       
extern void OSTaskResume(uint8 TaskID) small;
/*********************************************************************************************************
** 函數名稱: OSTaskResume
** 功能描述: 中恢復任務
** 輸　入: TaskID : 任務ID
** 輸　出: 無
** 全局變量: 無
** 調用模塊: OSSched
********************************************************************************************************/

extern void OS_TaskSuspend(uint8 TaskID)    small;
/*********************************************************************************************************
** 函數名稱: OS_TaskSuspend
** 功能描述: 使指定任務休眠，但不進行任務切換
** 輸　入: TaskID : 任務ID
** 輸　出: 無
** 全局變量: OSWaitTick
** 調用模塊: 無
**
** 作　者: 陳明計
** 日　期: 2002年6月20日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/

extern void OSTaskSuspend(uint8 TaskID)    small;
/*********************************************************************************************************
** 函數名稱: OSTaskSuspend
** 功能描述: 使指定任務休眠
** 輸　入: TaskID : 任務ID
** 輸　出: 無
** 全局變量: 五
** 調用模塊: OS_TaskSuspend
**
** 作　者: 陳明計
** 日　期: 2002年6月20日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/

extern void OSTimeDly(uint8 ticks)     small;
/*********************************************************************************************************
** 函數名稱: OSTimeDly
** 功能描述: 系統等待函數,任務調用此函數可以等待一定時間
** 輸　入:  ticks : 等待超時時的系統嘀嗒數
** 輸　出 : 無
**
** 全局變量: OSWaitTick
** 調用模塊: OSIntTaskResume,OSSched
********************************************************************************************************/

extern void OSTimeDlyResume(uint8 TaskID)    small;
/*********************************************************************************************************
** 函數名稱: OSTimeDlyResume
** 功能描述: 讓處在延時期的任務結束延時
** 輸　入:  TaskID : 任務ID
** 輸　出 : 無
** 全局變量: OSWaitTick
** 調用模塊: OSTaskResume
********************************************************************************************************/

extern void  OSTimeTick (void)  small;
/*********************************************************************************************************
** 函數名稱: OSTimeTick
** 功能描述: 系統時鐘處理函數,處理各個任務的延時
** 輸　入: 無
** 輸　出: 無
** 全局變量: OSWaitTick
** 調用模塊: OSIntSendSignal
********************************************************************************************************/

extern uint8 OSWait (uint8 typ, uint8 ticks)    small;
/*********************************************************************************************************
** 函數名稱: OSWait
** 功能描述: 系統等待函數,任務調用此函數可以等待一定時間或信號
** 輸　入: typ: 等待事件類型,目前可以取以下值,或是其中任意個值的按位或
**             K_SIG: 等待信號
**             K_TMO: 等待超時
**        ticks : 等待超時時的系統嘀嗒數
** 輸　出 : NOT_OK : 參數錯誤
**         TMO_EVENT : 超時到
**         SIG_EVENT : 有信號
** 全局變量: OSWaitTick
** 調用模塊: OSTaskSuspend,OSTimeDly,OS_ENTER_CRITICAL,OS_EXIT_CRITICAL
********************************************************************************************************/

extern uint8 OSIntExit (void)    small;
/*********************************************************************************************************
** 函數名稱: OSIntExit
** 功能描述: 中斷退出處理函數,在此進行中斷后的任務切換
** 輸　入: 無
** 輸　出: 0:無需任務切換
**         1:需要任務切換
** 全局變量: OSIntNesting,OSNextTaskID
** 調用模塊: OSIntCtxSw
********************************************************************************************************/

extern void OSSched (void)  small;
/*********************************************************************************************************
** 函數名稱: OSSched
** 功能描述: 非中斷的任務切換函數
** 輸　入: 無
** 輸　出: 無
** 全局變量: OSIntNesting,OSNextTaskID
** 調用模塊: OS_TASK_SW
********************************************************************************************************/

extern void OSFindNextRunningTask(void) small;
/*********************************************************************************************************
** 函數名稱: OSFindNextRunningTask
** 功能描述: 查找下一個優先級最高的就緒任務
** 輸　入: 無
** 輸　出: OSNextTaskID:存儲查找結果
** 全局變量: OSTaskRuning,OSTaskCreated
** 調用模塊: 無
**
** 作　者: 陳明計
** 日　期: 2002年6月20日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/
#endif

/*********************************************************************************************************
**                            End Of File
********************************************************************************************************/