keyfilt.h

键盘Key滤波功能源代码

/****************************************************************************
* 文件名：KEYFILT.H           (头文件)

* 功能：用户每毫秒调用KF_PerMs实现键盘信号的滤波。

        可调用KF_KeyOutput,得到滤波后的键盘值的表头地址。
        
        可调用KF_SetFilterTime，指向滤波常数存放表头。
         
* 说明：用户需提供外部函数KF_KeyInput，从外部得到键盘状态值。
****************************************************************************/
#ifndef  KEYFILT_H
#define  KEYFILT_H

#ifndef  MAX_KEY_NUMS
#define  MAX_KEY_NUMS   9                    //监测的最大键盘数
#endif

#ifndef  DEFAULT_FILT_TIME
#define  DEFAULT_FILT_TIME     10           //缺省滤波时间，单位ms
#endif

#ifndef uint8
typedef unsigned char  uint8;               //无符号8位整型变量
#endif

#ifndef uint16
typedef unsigned short uint16;              //无符号16位整型变量
#endif

/*******************************************************************************
  函数名:   KF_PerMs
  描  述:   由用户每毫秒调用，对键盘进行滤波处理
  调  用:   KF_KeyInput   ：外部函数，得到键盘的状态值
            KF_KeyFilt    ：对键盘状态值进行滤波处理
  被调用:
  输  入:
  输  出:
  返回值:   无
  说  明：  用户在调用该函数前需调用函数SetFilterTime传入键盘滤波常数，否则滤波
            以缺生设置DEFAULT_FILT_TIME进行
******************************************************************************/
void KF_PerMs(void);

/*******************************************************************************
  函数名:   KF_KeyOutput()
  描  述:   用户调用得到滤波后键盘的状态值
  调  用:
  被调用:
  输  入:
  输  出:
  返回值:   s_byKeyFiltered   : 存放滤波后键盘值的表头地址
******************************************************************************/
uint8 * KF_KeyOutput(void);

/*******************************************************************************
  函数名:   KF_KeyInput()
  描  述:   用户调用输入键盘状态值
  调  用:
  被调用:   pbyKeyState   ：存放键盘状态表头地址
            wKeyNums    ：输入的键盘数
  输  入:   
  输  出:
  返回值:   
******************************************************************************/
void KF_KeyInput(uint8 *pbyKeyState, uint16 wKeyNums);

/*******************************************************************************
  函数名:   KF_SetFilterTime
  描  述:   由用户调用传入滤波常数值
  调  用:
  被调用:
  输  入:   pabyFilter   : 存放滤波常数表头地址；该指针在用户进行键盘滤波处理时
                           不得变更，需为一个全局变量或静态变量
  输  出:   s_pabyFilterTime   : 指向用户存放滤波常数表头
  返回值:   无
******************************************************************************/
void KF_SetFilterTime(const uint8 *pabyFilter);

#endif