/*********************************************************************************************************
**				                               Small RTOS(51)
**                                   The Real-Time Kernel(For Keil c51)
**
**                                  (c) Copyright 2002-2003, chenmingji
**                                           All Rights Reserved
**
**                                                  V1.12.0
**
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: OS.h
**創   建   人: 陳明計
**最后修改日期:  2002年12月2日
**描　     述: Small RTOS(51) C語言頭文件,定義一些宏和聲明一些函數和變量
**
**--------------歷史版本信息----------------------------------------------------------------------------
** 創建人: 陳明計
** 版  本: V0.50
** 日　期: 2002年2月22日
** 描　述: 原始版本
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: V0.51
** 日　期: 2002年3月10日
** 描　述: 更改宏OS_VERSION定義
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: V0.52
** 日　期: 2002年5月9日
** 描　述: 更改宏OS_VERSION定義
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: V0.60
** 日　期: 2002年5月10日
** 描　述: 更改宏OS_VERSION定義
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: V1.00
** 日　期: 2002年6月20日
** 描　述: 更改宏OS_VERSION定義
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: V1.10
** 日　期: 2002年9月1日
** 描　述: 更改宏OS_VERSION定義，并根據當前版本進行一些必要改變
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: V1.11.0
** 日　期: 2002年12月2日
** 描　述: 更改宏OS_VERSION定義，增加注釋
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 版  本: V1.12.0
** 日　期: 2003年1月23日
** 描　述: 更改宏OS_VERSION定義
**
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 
** 日　期:
** 描　述:
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/

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

#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

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

extern uint8 OSWait (uint8 typ, uint8 ticks);
/*********************************************************************************************************
** 函數名稱: OSWait
** 功能描述: 系統等待函數,任務調用此函數可以等待一定時間或信號
** 輸　入: typ: 等待事件類型,目前可以取以下值,或是其中任意個值的按位或
**             K_SIG: 等待信號
**             K_TMO: 等待超時
**        ticks : 等待超時時的系統嘀嗒數
** 輸　出 : NOT_OK : 參數錯誤
**         TMO_EVENT : 超時到
**         SIG_EVENT : 有信號
** 全局變量: OSWaitTick
** 調用模塊: OSClearSignal
********************************************************************************************************/
extern void OSSendSignal (uint8 TaskId);
/*********************************************************************************************************
** 函數名稱: OSSendSignal
** 功能描述: 任務中給指定任務發送信號,既使指定任務就緒
** 輸　入: TaskId : 任務ID
** 輸　出: 無
** 全局變量: 無
** 調用模塊: OSSched,OSIntSendSignal
********************************************************************************************************/
extern void OSClearSignal (uint8 TaskId);
/*********************************************************************************************************
** 函數名稱: OSClearSignal
** 功能描述: 清除指定任務信號,既使指定任務休眠
** 輸　入: TaskId : 任務ID
** 輸　出: 無
** 全局變量: OSTaskRuning
** 調用模塊: 無
********************************************************************************************************/
extern void OSIntSendSignal (uint8 TaskId);
/*********************************************************************************************************
** 函數名稱: OSIntSendSignal
** 功能描述: 中斷中給指定任務發送信號,既使指定任務就緒
** 輸　入: TaskId : 任務ID
** 輸　出: 無
** 全局變量: OSTaskRuning
** 調用模塊: 無
********************************************************************************************************/
extern void OSIntExit (void);
/*********************************************************************************************************
** 函數名稱: OSIntExit
** 功能描述: 中斷退出處理函數,在此進行中斷后的任務切換
** 輸　入: 無
** 輸　出: 無
** 全局變量: OSIntNesting,OSNextTaskID
** 調用模塊: OSIntCtxSw
********************************************************************************************************/
extern void OSSched (void);
/*********************************************************************************************************
** 函數名稱: OSSched
** 功能描述: 非中斷的任務切換函數
** 輸　入: 無
** 輸　出: 無
** 全局變量: OSIntNesting,OSNextTaskID
** 調用模塊: OS_TASK_SW
********************************************************************************************************/

extern uint8 OSWaitTick[];
extern uint8 const OSMapTbl[];
extern uint8 data Os_Enter_Sum;

#endif