/*********************************************************************************************************
**				                               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****************************************/