/*********************************************************************************************************
**		                                  Small RTOS Key Driver
**
**                                  (c) Copyright 2002-2003, chenmingji
**                                           All Rights Reserved
**
**                                                  V1.00.0
**
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: key.C
**創   建   人: 陳明計
**最后修改日期:  2003年3月29日
**描        述: 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.0
** 日　期: 2003年3月2日
** 描　述: 原始版本
**
**------------------------------------------------------------------------------------------------------
** 修改人:
** 版  本:
** 日　期:
** 描　述:
**
**------------------------------------------------------------------------------------------------------
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2003年3月29日
** 描　述: 增加注釋
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
#define IN_KEY_DRIVE

#include "config.h"

uint8 OS_Q_MEM_SEL KeyReadBuf[32];          /*  配置鍵盤緩沖區 */

/*********************************************************************************************************
** 函數名稱: KeyInput
** 功能描述: 為鍵盤輸入服務的任務
** 輸　入: 無
** 輸　出: 無
** 全局變量: KeyReadBuf
** 調用模塊: 一些Small RTOS 服務例程
**
** 作　者: 陳明計
** 日　期: 2003年3月2日
**-------------------------------------------------------------------------------------------------------
** 修改人:
** 日　期:
**-------------------------------------------------------------------------------------------------------
********************************************************************************************************/

        void KeyInput(void)
{
    uint8 i;
    union _KEY_RET_TYE KeyData;

    OSQCreate(KeyReadBuf,32);                       /* 創建讀取鍵盤狀態的消息隊列 */
    while (1)
    {
        OSWait(K_TMO,(OS_TICKS_PER_SEC / 50) + 1);  /* 延時 20ms */
        KeyData.RWByWhole = KeyScan();              /* 獲當前按鍵狀態 */
        if (KeyData.RWByWhole == NO_KEY)
        {
           continue;
        }

        OSWait(K_TMO,(OS_TICKS_PER_SEC / 50) + 1);  /* 去抖(延時 20ms)*/
        if (KeyData.RWByWhole != KeyScan())
        {
            continue;
        }
                                                     /* 處理按鍵閉合事件 */
        if ((OSQSize(KeyReadBuf) - OSQNMsgs(KeyReadBuf)) >= 4)
        {
            OSQIntPost(KeyReadBuf, KeyData.RWByBYTE[0] | KEY_DOWN);
            OSQIntPost(KeyReadBuf, KeyData.RWByBYTE[1]);
            OSQIntPost(KeyReadBuf, KeyData.RWByBYTE[2]);
            OSQPost(KeyReadBuf, KeyData.RWByBYTE[3]);
        }
                                                    /* 第一次連擊延時 */        
        i = KEY_START / (OS_TICKS_PER_SEC / 50);
        do
        {
            OSWait(K_TMO,OS_TICKS_PER_SEC / 50);
            if (KeyData.RWByWhole != KeyScan())
            {
                goto KeyEnd;                        /* 按鍵松開 */
            }
        } while (--i != 0);
                                                    /* 后續連擊延時 */

        while (1)
        {
                                                     /* 處理按鍵連擊事件 */
            if ((OSQSize(KeyReadBuf) - OSQNMsgs(KeyReadBuf)) >= 4)
            {
                OSQIntPost(KeyReadBuf, KeyData.RWByBYTE[0] | KEY_ALWAYS);
                OSQIntPost(KeyReadBuf, KeyData.RWByBYTE[1]);
                OSQIntPost(KeyReadBuf, KeyData.RWByBYTE[2]);
                OSQPost(KeyReadBuf, KeyData.RWByBYTE[3]);
            }

            i = KEY_DELAY / (OS_TICKS_PER_SEC / 50);
            do
            {
                OSWait(K_TMO,OS_TICKS_PER_SEC / 50);
                if (KeyData.RWByWhole != KeyScan())
                {
                    goto KeyEnd;                     /* 按鍵松開 */
                }
            } while (--i != 0);
        }

KeyEnd:
                                                     /* 處理按鍵松開事件 */
        if ((OSQSize(KeyReadBuf) - OSQNMsgs(KeyReadBuf)) >= 4)
        {
            OSQIntPost(KeyReadBuf, KeyData.RWByBYTE[0] | KEY_UP);
            OSQIntPost(KeyReadBuf, KeyData.RWByBYTE[1]);
            OSQIntPost(KeyReadBuf, KeyData.RWByBYTE[2]);
            OSQPost(KeyReadBuf, KeyData.RWByBYTE[3]);
        }
    }
}

/*********************************************************************************************/
/*                                 End of File                                               */
/*********************************************************************************************/