key.h

基于80C51单片机源码公开的Small RTOS 1.12.1版

/*********************************************************************************************************
**				                               Small RTOS(51)
**                                   The Real-Time Kernel(For Keil c51)
**
**                                  (c) Copyright 2002-2002, chenmingji
**                                           All Rights Reserved
**
**                                                  V1.12.1
**
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: led.h
**创   建   人: 陈明计
**最后修改日期: 2002年12月4日
**描       述: Small RTOS键盘驱动程序
**描        述: Small RTOS键盘驱动程序，支持254个按键和最多可以支持三个按键同时按下
**             使用说明：
**             1、在Small RTOS 中添加一个任务KeyInput，优先级要比较高
**             2、配置：常量KEY_READ_BUF_LEGTH配置缓冲区大小,KEY_START
**                配置第一次重复按键延时，KEY_DELAY配置重复按键延时
**               （均在CONFIG.H中定义）
**             3、用户程序中定义一个函数KeyScan()，其返回一个uint32数，
**                实质是 union _KEY_RET_TYE（在key.h中定义），之中
**                RWByBYTE[0] = 按键个数，RWByBYTE[1] = 第1个按键
**                RWByBYTE[2] = 第2个按键，RWByBYTE[2] = 第3个按键
**                KeyScan()与系统相关。它无需去抖处理
**             4、调用宏GetKey得到按键消息
**              
**--------------历史版本信息----------------------------------------------------------------------------
** 创建人: 陈明计
** 版  本: V1.00
** 日　期: 2002年12月4日
** 描　述: 原始版本
**
**------------------------------------------------------------------------------------------------------
** 修改人: 
** 版  本: 
** 日　期: 
** 描　述: 
**
**------------------------------------------------------------------------------------------------------
**--------------当前版本修订------------------------------------------------------------------------------
** 修改人: 陈明计
** 日　期: 2003年3月29日
** 描　述: 增加注释
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
                                                /*  按键状态     */
#define NO_KEY      -1                          /*  没有键闭合   */
#define KEY_DOWN    0x10                        /*  有键刚刚闭合 */
#define KEY_ALWAYS  0x20                        /*  有键连击     */
#define KEY_UP      0x30                        /*  有键刚刚松开 */

union _KEY_RET_TYE
{
    uint32 RWByWhole;
    uint8 RWByBYTE[4];
};

#ifdef IN_KEY_DRIVE
extern uint32 KeyScan(void);
#else
extern uint8 OS_Q_MEM_SEL KeyReadBuf[32];
#endif


/*********************************************************************************************************
** 函数名称: GetKey
** 功能描述: 宏，等待键盘消息
** 输　入: uint8 a[4]
** 输　出: a[0] % 16：按键个数
**        a[0] / 16：按键类型：KEY_DOWN 有键按下、KEY_DOWN 按键松开
**                   KEY_ALWAYS 键盘持续按着 
** 全局变量: 
** 调用模块:
**
** 作　者: 陈明计
** 日　期: 2003年3月2日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/
#define GetKey(a)                     \
        OSQPend(a,KeyReadBuf,0);      \
        OSQPend(a + 1,KeyReadBuf,0);  \
        OSQPend(a + 2,KeyReadBuf,0);  \
        OSQPend(a + 3,KeyReadBuf,0)

/*********************************************************************************************************
** 函数名称: GetKeyNMsgs
** 功能描述: 宏，取得按键消息数目
** 输　入: uint8 a[4]
** 输　出: a[0] % 16：按键个数
**        a[0] / 16：按键类型：KEY_DOWN 有键按下、KEY_DOWN 按键松开
**                   KEY_ALWAYS 键盘持续按着 
** 全局变量: 
** 调用模块:
**
** 作　者: 陈明计
** 日　期: 2003年3月2日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/
#define GetKeyNMsgs()  (OSQNMsgs(KeyReadBuf) / 4)

//#define KEY_READ_BUF_LEGTH    32              /*  缓冲区大小                                          */
//#define KEY_START (OS_TICKS_PER_SEC / 4)      /*  第一次重复按键延时，以时钟节拍为单位                */
//#define KEY_DELAY (OS_TICKS_PER_SEC / 4)      /*  重复按键延时,即配置发码的速度，以时钟节拍为单位     */

/**********************end****************************************/