34. TIM—电容按键检测

本章参考资料：《STM32F4xx参考手册》、《STM32F4xx规格书》、库帮助文档《stm32f4xx_dsp_stdperiph_lib_um.chm》。

前面章节我们讲解了基本定时器和高级控制定时器功能，这一章我们将介绍定时器输入捕获一个应用实例，帮助我们更加深入理解定时器。

34.1. 电容按键原理

电容器(简称为电容)就是可以容纳电荷的器件，两个金属块中间隔一层绝缘体就可以构成一个最简单的电容。如图 片状电容器 (俯视图)， 有两个金属片，之间有一个绝缘介质，这样就构成了一个电容。这样一个电容在电路板上非常容易实现，一般设计四周的铜片与电路板地信号连通， 这样一种结构就是电容按键的模型。当电路板形状固定之后，该电容的容量也是相对稳定的。

电路板制作时都会在表面上覆盖一层绝缘层，用于防腐蚀和绝缘，所以实际电路板设计时情况如图 无手指触摸情况 。 电路板最上层是绝缘材料，下面一层是导电铜箔，我们根据电路走线情况设计决定铜箔的形状，再下面一层一般是FR-4板材。 金属感应片与地信号之间有绝缘材料隔着，整个可以等效为一个电容Cx。一般在设计时候，把金属感应片设计成方便手指触摸大小。

在电路板未上电时，可以认为电容Cx是没有电荷的，在上电时，在电阻作用下，电容Cx就会有一个充电过程，直到电容充满，即Vc电压值为3.3V， 这个充电过程的时间长短受到电阻R阻值和电容Cx容值的直接影响。但是在我们选择合适电阻R并焊接固定到电路板上后，这个充电时间就基本上不会变了， 因为此时电阻R已经是固定的，电容Cx在无外界明显干扰情况下基本上也是保持不变的。

现在，我们来看看当我们用手指触摸时会是怎样一个情况？如图 有手指触摸情况 ，当我们用手指触摸时，金属感应片除了与地信号形成一个等效电容Cx外，还会与手指形成一个Cs等效电容。

此时整个电容按键可以容纳的电荷数量就比没有手指触摸时要多了，可以看成是Cx和Cs叠加的效果。在相同的电阻R情况下，因为电容容值增大了， 导致需要更长的充电时间。也就是这个充电时间变长使得我们区分有无手指触摸，也就是电容按键是否被按下。

现在最主要的任务就是测量充电时间。充电过程可以看出是一个信号从低电平变成高电平的过程，现在就是要求出这个变化过程的时间， 这样的一个命题与上一章讲解高级控制定时器的输入捕获功能非常吻合。我们可以利用定时器输入捕获功能计算充电时间，即设置TIMx_CH为定时器输入捕获模式通道。 这样先测量得到无触摸时的充电时间作为比较基准，然后再定时循环测量充电时间与无触摸时的充电时间作比较，如果超过一定的阈值就认为是有手指触摸。

图 Vc电压与充电时间关系 为Vc跟随时间变化情况，可以看出在无触摸情况下，电压变化较快；而在有触摸时，总的电容量增大了，电压变化缓慢一些。

为测量充电时间，我们需要设置定时器输入捕获功能为上升沿触发，图 34‑4中V_H就是被触发上升沿的电压值， 也是STM32认为是高电平的最低电压值，大约为1.8V。t1和t2可以通过定时器捕获/比较寄存器获取得到。

不过，在测量充电时间之前，我们必须想办法制作这个充电过程。之前的分析是在电路板上电时会有充电过程，现在我们要求在程序运行中循环检测按键， 所以必须可以控制充电过程的生成。我们可以控制TIMx_CH引脚作为普通的GPIO使用，使其输出一小段时间的低电平，为电容Cx放电，即Vc为0V。 当我们重新配置TIMx_CH为输入捕获时电容Cx在电阻R的作用下就可以产生充电过程。

34.2. 电容按键检测实验

电容按键不需要任何外部机械部件，使用方便，成本低，很容易制成与周围环境相密封的键盘， 以起到防潮防湿的作用。电容按键优势突出使得越来越多电子产品使用它代替传统的机械按键。

本实验实现电容按键状态检测方法，提供一个编程实例。

34.2.1. 硬件设计

开发板板载一个电容按键，原理图设计参考图 电容按键电路设计_ 。

V1

---

V2

---

开发板中标示“电容按键”的地方就是电容按键实体，实际上就是一块铜皮，然后在电路板子上通过一根导线连接至定时器通道引脚， 并带一个3.3V的上拉电阻，电阻的大小和电容按键的大小决定了充电的时间长度。默认上电情况下电容按键会被3.3V通过电阻R45充满电。 实验还用到调试串口和蜂鸣器功能，用来打印输入捕获信息和指示按键状态，这两个模块电路可参考之前相关章节。

34.2.2. 软件设计

这里只讲解核心的部分代码，有些变量的设置，头文件的包含等并没有涉及到，完整的代码请参考本章配套的工程。 我们创建了两个文件：bsp_touchpad.c和bsp_touchpad.h文件用来存放电容按键检测相关函数和宏定义。

34.2.2.1. 编程要点

(1) 编写定时器输入捕获相关函数

(2) 测量电容按键空载的充电时间T1

(3) 测量电容按键有手触摸的充电时间T2

(4) 只需要比较T2与T1的时间即可检测出按键是否有手指触摸

34.2.2.2. 软件分析

电容按键宏定义

代码清单:电容按键-1 宏定义

/******************** TPAD 引脚配置参数定义 **************************/
#define TPAD_TIMx                   TIM2
#define TPAD_TIM_CLK                RCC_APB1Periph_TIM2

#define TPAD_TIM_Channel_X          TIM_Channel_1
#define TPAD_TIM_IT_CCx             TIM_IT_CC1
#define TPAD_TIM_GetCaptureX        TIM_GetCapture1
#define TPAD_TIM_PERIOD             0XFFFF
#define TPAD_TIM_PSC                (21-1)

//定时器最大计数值
#define TPAD_ARR_MAX_VAL  0XFFFF

// TIM 输入捕获通道GPIO相关宏定义
#define TPAD_TIM_GPIO_CLK           RCC_AHB1Periph_GPIOA
#define TPAD_TIM_CH_PORT            GPIOA
#define TPAD_TIM_CH_PIN             GPIO_Pin_5
#define TPAD_TIM_AF                 GPIO_AF_TIM2
#define TPAD_TIM_SOURCE             GPIO_PinSource5

// 电容按键被按下的时候门限值，需要根据不同的硬件实际测试，
// 减小这个门限值可以提高响应速度
#define            TPAD_GATE_VAL              30

// 电容按键空载的时候的最大和最小的充电时间，不同的硬件不一样，
// F407霸天虎稳定在32
#define            TPAD_DEFAULT_VAL_MIN       30
#define            TPAD_DEFAULT_VAL_MAX       35

#define            TPAD_ON                     1
#define            TPAD_OFF                    0

有关宏的具体含义配套注释阅读即可。定时器计数器的时钟分频因子，我们通过宏TPAD_TIM_PSC默认配置为20，则计数器的计数时间为(20+1)/84M = 1us， 自动重装载寄存器ARR的值通过TPAD_TIM_Period默认配置为0XFFFF，即65535。所以，计数器在不发生溢出的情况下，能计数的最长时间为65.535ms。 而一般电容按键的充电时间都是us级别，所以定时器的这个配置足以。在F407-霸天虎中，电容按键的空载充电时间为32us，当有手指轻微触摸电容按键的时候， 充电时间会上升为65us以上，如果手指的触摸面积更大的话，充电时间也就相应的会变的更长。在编写代码的时候，我们只需要比较这两个充电时间即可知道是否触摸按键被按下。

电容按键GPIO配置

代码清单:电容按键-2 电容按键GPIO配置

static void TPAD_TIM_GPIO_Config(void)
{
    GPIO_InitTypeDef  GPIO_InitStructure;

    // 使能通道引脚时钟
    RCC_AHB1PeriphClockCmd(TPAD_TIM_GPIO_CLK, ENABLE);
    // 指定引脚复用
    GPIO_PinAFConfig(TPAD_TIM_CH_PORT,TPAD_TIM_SOURCE,TPAD_TIM_AF);

    // 端口配置
    GPIO_InitStructure.GPIO_Pin = TPAD_TIM_CH_PIN;
    // 复用功能
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;
    GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;
    //不带上下拉
    GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL;
    GPIO_Init(TPAD_TIM_CH_PORT, &GPIO_InitStructure);
}

TPAD_TIM_GPIO_Config()函数初始化了定时器用到的相关的GPIO，当使用不同的GPIO的时候，只需要修改头文件里面的宏定义即可，而不需要修改这个函数。

电容按键定时器模式配置

代码清单:电容按键-3 电容按键定时器模式配置

static void TPAD_TIM_Mode_Config(void)
{
    TIM_TimeBaseInitTypeDef  TIM_TimeBaseStructure;
    TIM_ICInitTypeDef  TIM_ICInitStructure;

    // 使能TIM时钟,TIMx_CLK = 2 * PCLK1 = 84M
    RCC_APB1PeriphClockCmd(TPAD_TIM_CLK,ENABLE);
    /*--------------------时基结构体初始化----------------------*/
    // 自动重装载寄存器的值，累计TIM_Period+1个频率后产生一个更新或者中断
    TIM_TimeBaseStructure.TIM_Period = TPAD_TIM_PERIOD;
    // 驱动CNT计数器的时钟 = TIMx_CLK/(psc+1)
    TIM_TimeBaseStructure.TIM_Prescaler = TPAD_TIM_PSC;
    // 时钟分频因子 ，配置死区时间时需要用到，这里不需要
    TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1;
    // 计数器计数模式
    TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up;
    // 初始化定时器
    TIM_TimeBaseInit(TPAD_TIMx, &TIM_TimeBaseStructure);
    /*--------------------输入捕获结构体初始化-------------------*/
    // 配置输入捕获的通道，需要根据具体的GPIO来配置
    TIM_ICInitStructure.TIM_Channel = TPAD_TIM_Channel_X;
    // 输入捕获信号的极性配置
    TIM_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Rising;
    // 输入通道和捕获通道的映射关系，有直连和非直连两种
    TIM_ICInitStructure.TIM_ICSelection = TIM_ICSelection_DirectTI;
    //配置输入分频,不分频
    TIM_ICInitStructure.TIM_ICPrescaler = TIM_ICPSC_DIV1;
    //配置输入滤波器 不滤波
    TIM_ICInitStructure.TIM_ICFilter = 0x00;
    // 定时器输入捕获初始化
    TIM_ICInit(TPAD_TIMx, &TIM_ICInitStructure);

    // 使能计数器
    TIM_Cmd ( TPAD_TIMx, ENABLE );
}

TPAD_TIM_Mode_Config()函数中初始化了两个结构体，有关这两个结构体成员的具体含义可参考“定时器初始化结构体详解”小节， 剩下的程序参考注释阅读即可。有个地方要注意的是捕获信号的极性配置，需要配置为上升沿。因为电容按键在放电之后再充电的时候是一个电平又低到高的过程。

电容按键复位

代码清单:电容按键-4 电容按键复位

/**
* @brief  复位电容按键，放电，重新充电
* @param  无
* @retval 无
* 说明：
* 开发板上电之后，电容按键默认已经充满了电，要想测得电容按键的充电时间
* 就必须先把电容按键的电放掉，方法为让接电容按键的IO输出低电平即可
* 放电完毕之后，再把连接电容按键的IO配置为输入，然后通过输入捕获的方法
* 测量电容按键的充电时间，这个充电时间是没有手指触摸的情况下的充电时间
* 而且这个空载的充电时间非常稳定，因为电路板的硬件已经确定了
*
* 当有手指触摸的情况下，充电时间会变长，我们只需要对比这两个时间就可以
* 知道电容按键是否有手指触摸
*/
static void TPAD_Reset(void)
{
    GPIO_InitTypeDef  GPIO_InitStructure;

    // 使能通道引脚时钟
    RCC_AHB1PeriphClockCmd(TPAD_TIM_GPIO_CLK, ENABLE);

    //配置引脚为普通推挽输出
    GPIO_InitStructure.GPIO_Pin = TPAD_TIM_CH_PIN;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;
    GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;
    GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_DOWN;
    GPIO_Init(TPAD_TIM_CH_PORT, &GPIO_InitStructure);

    // 连接TPAD的IO配置为输出，然后输出低电平，延时一会，确保电容按键放电完毕
    GPIO_ResetBits ( TPAD_TIM_CH_PORT, TPAD_TIM_CH_PIN );
    // 放电是很快的，一般是us级别
    //Delay_ms(5);
    SysTick_Delay_Ms(5);

    // 连接TPAD的IO配置为输入，用于输入捕获
    GPIO_InitStructure.GPIO_Pin = TPAD_TIM_CH_PIN;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;
    GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;
    GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL;
    GPIO_Init(TPAD_TIM_CH_PORT,&GPIO_InitStructure);
}

开发板上电之后，电容按键默认已经充满了电，要想测得电容按键的充电时间 就必须先把电容按键的电放掉，方法为让接电容按键的IO输出低电平即可， 这个放电的时间一般都是us级别，我们可以稍微延时以下即可。放电完毕之后，再把连接电容按键的IO配置为输入，然后通过输入捕获的方法测量电容按键的充电时间， 这个充电时间T1是没有手指触摸的情况下的充电时间，而且这个空载的充电时间非常稳定，因为电路板的硬件已经确定了。当有手指触摸的情况下， 相当于电容变大，充电时间T2会变长，我们只需要对比这两个时间就可以 知道电容按键是否有手指触摸。

电容按键初始化

代码清单:电容按键-5 电容按键初始化

/**
* @brief  初始化触摸按键，获得空载的时候触摸按键的充电时间
* @param  无
* @retval 0：成功，1：失败
* @note   空载值一般很稳定，由硬件电路决定，该函数只需要调用一次即可
*         而且这个空载的充电时间每个硬件都不一样，最好实际测试下
*/
uint8_t TPAD_Init(void)
{
    uint16_t temp;

    // 电容按键用到的输入捕获的IO和捕获模式参数初始化
    TPAD_TIM_Init();

    temp = TPAD_Get_Val();

    // 调试的时候可以把捕获的值打印出来，看看默认的充电时间是多少
    printf("电容按键默认充电时间为: %d us\n",temp);

    // 电容按键空载的充电时间非常稳定，不同的硬件充电时间不一样
    // 需要实际测试所得，F407-霸天虎上的电容按键空载充电时间稳定在32us
    // 如果你觉得单次测量不准确，你可以多次测量然后取个平均值
    if ( (TPAD_DEFAULT_VAL_MIN<temp) && (temp<TPAD_DEFAULT_VAL_MAX) ) {
        tpad_default_val = temp;
        return 0;  // 成功
    } else {
        return 1; // 失败
    }
}

TPAD_Init() 函数用来获取电容按键空载的充电时间，当获取到之后，把值存在tpad_default_val这个全局变量当中。这个空载的充电时间不同的硬件是不一样的， 需要实际测试，在调试的过程中，可把捕获到的值打印出来看看。F407-霸天虎开发板上这个值稳定在32us。

在TPAD_Init() 函数中，我们是通过调用TPAD_Get_Val()函数来获取电容按键的充电时间的。当电容按键从0开始充电到STM32能够识别的高电平时， 定时器则发生捕获，此时计数器的值会被锁存到输入捕获寄存器，我们只需要读取输入捕获寄存器的值，就可以算出这个充电的时间。通过TPAD_Get_Val()这个函数， 我们可以测出电容按键的空载充电时间T1和有手触摸的情况下的充电时间T2。

获取定时器输入捕获值

代码清单:电容按键-6获取定时器输入捕获值

/**
* @brief  获取定时器捕获值
* @param  无
* @retval 定时器捕获值。如果超时,则直接返回定时器的计数值。
*/
uint16_t TPAD_Get_Val(void)
{
    // 每次捕获的时候，必须先复位放电
    TPAD_Reset();

    // 当电容按键复位放电之后，计数器清0开始计数
    TIM_SetCounter(TPAD_TIMx,0);

    // 清除相关的标志位
    TIM_ClearITPendingBit(TPAD_TIMx, TPAD_TIM_IT_CCx|TIM_IT_Update);

    // 等待捕获上升沿，当电容按键充电到1.8V左右的时候，就会被认为是上升沿
    while (TIM_GetFlagStatus ( TPAD_TIMx, TPAD_TIM_IT_CCx ) == RESET) {
        // 如果超时了,直接返回CNT的值
        // 一般充电时间都是在ms级别以内，很少会超过定时器的最大计数值
        if (TIM_GetCounter(TPAD_TIMx)>TPAD_ARR_MAX_VAL-500) {
            return TIM_GetCounter(TPAD_TIMx);
        }

    }
    // 获取捕获比较寄存器的值
    return TPAD_TIM_GetCaptureX(TPAD_TIMx );
}

获取最大输入捕获值

代码清单:电容按键-7 获取最大捕获值

/**
* @brief  读取若干次定时器捕获值，并返回最大值。
* @param  num ：读取次数
* @retval 读取到的最大定时器捕获值
*/
uint16_t TPAD_Get_MaxVal( uint8_t num )
{
    uint16_t temp=0, res=0;

    while (num--) {
        temp = TPAD_Get_Val();
        if ( temp > res )
            res = temp;
    }
    return res;
}

该函数接收一个参数，用来指定获取电容按键捕获值的循环次数，函数的返回值则为num次发生捕获中最大的捕获值。当我们用手指触摸电容按键的时候， 常常会有干扰或者是误触发，所以我们一般选取最大的值为有效值。

电容按键状态扫描

代码清单:电容按键-8 电容按键状态扫描

/**
* @brief  按键扫描函数
* @param  无
* @retval 1：按键有效，0：按键无效
*/
uint8_t TPAD_Scan(void)
{
    // keyen：按键检测使能标志
    // 0：可以开始检测
    // >0：还不能开始检测，表示按键一直被按下
    // 注意：keytn 这个变量由 static修饰，相当于一个全局变量，但是因为是在函数内部定义，
    // 所以是相当于这个函数的全局变量，每次修改之前保留的是上一次的值
    static uint8_t keyen=0;

    uint8_t res=0,sample=3;
    uint16_t scan_val;

    // 根据sample值采样多次，并取最大值，小的一般是干扰或者是误触摸
    scan_val = TPAD_Get_MaxVal(sample);

    // 当扫描的值大于空载值加上默认的门限值之后，表示按键按下
    // 这个TPAD_GATE_VAL根据硬件决定，需要实际测试
    if (scan_val > (tpad_default_val+TPAD_GATE_VAL)) {
        // 再次检测，类似于机械按键的去抖
        scan_val = TPAD_Get_MaxVal(sample);
        if ( ( keyen ==0)&&(scan_val > (tpad_default_val+TPAD_GATE_VAL)))
            res = 1;  // 有效的按键

        // 如果按键一直被按下，keyen的值会一直在keyen的初始值和keyen-1之间循环，永远不会等于0
        keyen = 2;
    }

    // 当按键没有被按下或者keyen>0时，会执行keyen--
    if ( keyen > 0)
        keyen--;

    return res;
}

按键扫描函数不断的检测充电时间，当大于tpad_default_val+TPAD_GATE_VAL时，表示按键被按下，其中TPAD_GATE_VAL是一个宏，具体多大需要实际测试。 具体的我们可以通过调用TPAD_Get_Val()函数来测试按键有手触摸的情况下的充电值，然后再减去tpad_default_val的值就可以得到TPAD_GATE_VAL， 当减小这个门限值的时候可以提高按键的灵敏度。

在按键扫描函数中，我们引入了一个按键检测标志keyen，其由关键字static修饰，相当于一个全局变量，每次修改这个变量的时候其保留的都是上一次的值。 引入一个按键检测标志是为了消除按键是否一直按下的情况，如果按键一直被按下keyen的值会一直在keyen的初始值和keyen-1之间循环，永远不会等于0， 则永远都不会被认为按键按下，需要等待释放。有关函数更加详细的说明看程序的注释即可。

主函数

代码清单:电容按键-9 主函数

#include "stm32f4xx.h"
#include "./Bsp/beep/bsp_beep.h"
#include "./Bsp/usart/bsp_debug_usart.h"
#include "./Bsp/systick/bsp_SysTick.h"
#include "./Bsp/TouchPad/bsp_touchpad.h"

/**
* @brief  主函数
* @param  无
* @retval 无
*/
int main(void)
{
    uint16_t temp;
    /* 初始化蜂鸣器 */
    BEEP_GPIO_Config();

    /* 初始化调试串口 */
    Debug_USART_Config();
    printf ( "\r\n野火STM32 输入捕获电容按键检测实验\r\n" );
    printf ( "\r\n触摸电容按键，蜂鸣器则会响\r\n" );


    /* 初始化系统滴答定时器 */
    //SysTick_Init();

//  /* 这段注释的代码用于获取电容的充电时间（空载跟手按下的都可以测） */
//  TPAD_TIM_Init();
//  while(1)
//  {
//    temp = TPAD_Get_Val();
//    printf("电容按键默认充电时间为: %d us\n",temp);
//    SysTick_Delay_Ms(500);
//  }

    // 初始化电容按键
    while ( TPAD_Init() );

    while (1) {
        if ( TPAD_Scan() == TPAD_ON ) {
            BEEP_ON;
            //Delay_ms(25);
            SysTick_Delay_Ms(25);
            BEEP_OFF;
        }
    }

}

主函数初始化了蜂鸣器和串口，然后等待电容按键初始化成功，如果不成功则会一直等待。初始化成功之后，在一个while无限循环中不断的扫描按键，当按键按下之后蜂鸣器响25ms，然后关掉

34.2.3. 下载验证

把编译好的程序烧写到开发板，手按电容按键，蜂鸣器则会响。