softtimer.h

Small RTOSv1.12.x 下dp-51例子, 包括完整的原程序和说明

/*********************************************************************************************************
**				                               Small RTOS(51)
**                                   The Real-Time Kernel(For Keil c51)
**
**                                  (c) Copyright 2002-2003, chenmingji
**                                           All Rights Reserved
**
**                                                  V1.12.1
**
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: SoftTimer.H
**创   建   人: 陈明计
**最后修改日期: 2003年2月16日
**描　     述:  软定时器头文件
**
**--------------历史版本信息----------------------------------------------------------------------------
**------------------------------------------------------------------------------------------------------
** 修改人: 陈明计
** 版  本: V1.12.1
** 日　期: 2003年2月16日
** 描　述: 原始版本
**
**------------------------------------------------------------------------------------------------------
** 修改人:
** 版  本:
** 日　期:
** 描　述:
**
**--------------当前版本修订------------------------------------------------------------------------------
** 修改人: 陈明计
** 日　期: 2003年3月30日
** 描　述: 增加注释
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/

//以下为软定时器的配置宏
//#define EN_SOFT_TIMER_CHK       0           /* 禁止(0)或允许(1)校验软定时器                           */
//#define SOFT_TIMER_MEM_SEL      xdata       /* 软定时器存储空间选择，keil c51有用，必须为idata、xdata   */
                                              /* 不是keil c51时它必须为空格                               */
//#define MAX_SOFT_TIMER          4           /* 软定时器数目                                           */

//#define SOFT_TIMER_TASK_ID      4           /* 软定时器管理任务ID                                           */

#ifndef NOT_OK
#define NOT_OK              0               /* 函数调用失败 */
#endif

#define SOFT_TIMER_OK       1               /* 函数调用成功 */

extern void SoftTimer(void);
/*********************************************************************************************************
** 函数名称: SoftTimer
** 功能描述: 软定时器管理任务
** 输　入: 无
** 输　出: 无
** 全局变量: SoftTimerCnt,SoftTimerData,SoftTimerThisDelay
** 调用模块: OSWait(),OS_ENTER_CRITICAL(),OS_EXIT_CRITICAL()
**
** 作　者: 陈明计
** 日　期: 2003年2月16日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
extern void InitSoftTimer(void);
/*********************************************************************************************************
** 函数名称: InitSoftTimer
** 功能描述: 初始化软定时器模块
** 输　入: 无
** 输　出: 无
** 全局变量: SoftTimerData
** 调用模块: OS_ENTER_CRITICAL(),OS_EXIT_CRITICAL()
**
** 作　者: 陈明计
** 日　期: 2003年2月16日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
extern void SoftTimerSum(void);
/*********************************************************************************************************
** 函数名称: SoftTimerSum
** 功能描述: 每次系统节拍处理时调用的函数，一个辅助定时器
** 输　入: 无
** 输　出: 无
** 全局变量: SoftTimerCnt
** 调用模块: OSIntSendSignal()
**
** 作　者: 陈明计
** 日　期: 2003年2月16日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
extern uint8 SoftTimerStop(uint8 Index);
/*********************************************************************************************************
** 函数名称: SoftTimerStop
** 功能描述: 停止一个正在运行的软定时器
** 输　入: Index：软定时器的索引
** 输　出: NOT_OK：软定时器不存在
**        SOFT_TIMER_OK：操作成功
** 全局变量: SoftTimerData
** 调用模块: OS_ENTER_CRITICAL(),OS_EXIT_CRITICAL()
**
** 作　者: 陈明计
** 日　期: 2003年2月16日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
extern uint8 SoftTimerRun(uint8 Index,uint16 Delay,void (const * Fuction)(void));
/*********************************************************************************************************
** 函数名称: SoftTimerRun
** 功能描述: 运行一个软定时器
** 输　入: Index：软定时器的索引
**        Delay：延时时间
**        Fuction：定时器溢出执行的函数
** 输　出: NOT_OK：参数错误
**        SOFT_TIMER_OK：操作正确
** 全局变量: SoftTimerData
** 调用模块: OS_ENTER_CRITICAL(),OS_EXIT_CRITICAL()
**
** 作　者: 陈明计
** 日　期: 2003年2月16日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/

                /* 将函数SoftTimerSum()挂接到函数OSTimeTick()的代码*/
#ifdef IN_OS_CORE
#define OSTimeTick    _OSTimeTick
#else
extern void _OSTimeTick(void);
#define OSTimeTick    SoftTimerSum(),_OSTimeTick
#endif

#define SOFT_TIMER_TIMER_OUT        0x01      /* 定时器溢出标志，软定时器处理任务使用   */
#define SOFT_TIMER_TIMER_RUN        0x02      /* 定时器运行标志                         */
/**********************end****************************************/