/*********************************************************************************************************
**				                               Small RTOS(51)
**                                   The Real-Time Kernel(For Keil c51)
**
**                                  (c) Copyright 2002-2003, chenmingji
**                                           All Rights Reserved
**
**                                                  V1.12.0
**
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: OS_sem.h
**創(chuàng)   建   人: 陳明計(jì)
**最后修改日期:  2002年12月2日
** 描　述: Small RTOS(51)信號(hào)量頭文件，定義一些宏和聲明一些函數(shù)
**
**--------------歷史版本信息----------------------------------------------------------------------------
** 創(chuàng)建人: 陳明計(jì)
** 版  本: V1.10
** 日　期: 2002年6月20日
** 描　述: 原始版本
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計(jì)
** 版  本: V1.11.0
** 日　期: 2002年12月2日
** 描　述: 增加注釋
**
**------------------------------------------------------------------------------------------------------
** 修改人: 陳明計(jì)
** 版  本: V1.12.0
** 日　期: 2002年12月30日
** 描　述: 沒有變化
**
**--------------當(dāng)前版本修訂-----------------------------------------------------------------------------
** 修改人:
** 日　期:
** 描　述:
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/


#ifndef NOT_OK
#define NOT_OK      255                                 /* 參數(shù)錯(cuò)誤                                     */
#endif

#define OS_SEM_NOT_OK 4                                 /* 無信號(hào)                                       */
#define OS_SEM_TMO    2                                 /* 超時(shí)到                                       */
#define OS_SEM_OK     1                                 /* 操作成功                                     */

#ifndef IN_OS_SEM
extern uint8 OSSemCreate(uint8 Index,uint8 Data);
/*********************************************************************************************************
** 函數(shù)名稱: OSSemCreate
** 功能描述: 初始化消息隊(duì)列
** 輸　入: Index:信號(hào)量索引
**         data:信號(hào)量初始值
** 輸　出: NOT_OK:沒有這個(gè)信號(hào)量
**         OS_SEM_OK:成功
** 全局變量: 無
** 調(diào)用模塊: 無
********************************************************************************************************/
extern uint8 OSSemPend(uint8 Index, uint8 Tick);
/*********************************************************************************************************
** 函數(shù)名稱: OSSemPend
** 功能描述: 等待一個(gè)信號(hào)量
** 輸　入: Index:信號(hào)量索引
**         Tick:等待時(shí)間
** 輸　出: NOT_OK:參數(shù)錯(cuò)誤
**         OS_SEM_OK:得到信號(hào)量
**         OS_SEM_TMO:超時(shí)到
**         OS_SEM_NOT_OK:沒有得到信號(hào)量
** 全局變量: 無
** 調(diào)用模塊: OSRunningTaskID,OSClearSignal,OSSched,OS_ENTER_CRITICAL,OS_EXIT_CRITICAL
********************************************************************************************************/
extern uint8 OSSemAccept(uint8 Index);
/*********************************************************************************************************
** 函數(shù)名稱: OSSemAccept
** 功能描述: 無等待請求信號(hào)量
** 輸　入: Index:信號(hào)量索引
** 輸　出: NOT_OK:參數(shù)錯(cuò)誤
**         OS_SEM_OK:得到信號(hào)量
**         OS_SEM_TMO:超時(shí)到
**         OS_SEM_NOT_OK:沒有得到信號(hào)量
** 全局變量: 無
** 調(diào)用模塊: OSClearSignal,OSSched,OS_ENTER_CRITICAL,OS_EXIT_CRITICAL
********************************************************************************************************/
extern uint8 OSSemIntPost(uint8 Index);
/*********************************************************************************************************
** 函數(shù)名稱: OSSemIntPost
** 功能描述: 中斷中發(fā)送一個(gè)信號(hào)量
** 輸　入: Index:信號(hào)量索引
** 輸　出: NOT_OK:參數(shù)錯(cuò)誤
**         OS_SEM_OK:發(fā)送成功
** 全局變量: 無
** 調(diào)用模塊: OSIntSendSignal,OS_ENTER_CRITICAL,OS_EXIT_CRITICAL
********************************************************************************************************/
extern uint8 OSSemPost(uint8 Index);
/*********************************************************************************************************
** 函數(shù)名稱: OSSemPost
** 功能描述: 發(fā)送一個(gè)信號(hào)量
** 輸　入: Index:信號(hào)量索引
** 輸　出: NOT_OK:參數(shù)錯(cuò)誤
**         OS_SEM_OK:發(fā)送成功
** 全局變量: 無
** 調(diào)用模塊: OSSemIntPost,OSSched
********************************************************************************************************/
extern uint8 OSSemQuery(uint8 Index);
/*********************************************************************************************************
** 函數(shù)名稱: OSSemQuery
** 功能描述: 查詢信號(hào)量
** 輸　入: Index:信號(hào)量索引
** 輸　出: 信號(hào)量的值
** 全局變量: 無
** 調(diào)用模塊: OS_ENTER_CRITICAL,OS_EXIT_CRITICAL
********************************************************************************************************/


#endif