一、电容按键简介

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

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

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

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

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

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

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

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

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

二、输入捕获

输入捕获模式可以用来测量脉冲宽度或者测量频率。STM32F103 的定时器，除了TIM6、TIM7，其他的定时器都有输入捕获的功能。

2.1 输入捕获的工作原理

①先设置输入捕获为上升沿检测，
②记录发生上升沿时TIMx_CNT(计数器)的值
③配置捕获信号为下降沿捕获，当下降沿到来的时候发生捕获
④记录此时的TIMx_CN(计数器)T的值
⑤前后两次TIMx_CNT(计数器)的值之差就是高电平的脉宽。同时根据TIM的计数频率，我们就能知道高电平脉宽的准确时间。

简单说：
当你设置的捕获开始的时候，cpu会将计数寄存器的值复制到捕获比较寄存器中并开始计数，当再次捕捉到电平变化时，这是计数寄存器中的值减去刚才复制的值就是这段电平的持续时间，你可以设置上升沿捕获、下降沿捕获、或者上升沿下降沿都捕获。

2.2 溢出时间计算

t1时刻检测到高电平，发生中断，在中断里将计数值置0，开始记溢出次数N，

其中每计数0xFFFF次溢出一次，直到t2时刻跳变回低电平，

获取最后一次溢出时到t2时刻的计数值TIM5CH1_CAPTURE_VAL

则 高电平时间 = 溢出次数x65535+TIM5CH1_CAPTURE_VAL us；根据定时器初始化时的频率即可计算出溢出总次数所占用的时间，即为高电平时间。

如果计数器值为 32 bit 那么最大为0xFFFFFFFF

高电平时间：

三、引脚确定

开发板板载一个电容，引脚为 PA1，对应通用定时器 TIM5 的通道 2。充电电容的阻值为 5.1M，电阻的大小决定了电容按键充电的时间。

四、添加通用定时器TIM5输入捕获功能

查看 STM32CubeMX学习笔记（23）——通用定时器接口使用(输入捕获测量脉宽)

五、编程要点

1. 编写定时器输入捕获相关函数
2. 测量电容按键空载的充电时间 T1
3. 测量电容按键有手触摸的充电时间 T2
4. 只需要比较 T2 与 T1 的时间即可检测出按键是否有手指触摸

几个重要函数：
说明：对于不同的平台，区别主要是定时器底层相关以及IO口初始化

5.1 TPAD_Reset(void)

复位 TPAD
设置 IO 口为推挽输出 0，电容放电。等待放电完成之后，设置为浮空输入，从而开始充电。同时把计数器的 CNT 设置为 0。

5.2 TPAD_Get_Val(void)

获取一次捕获值（得到充电时间）
复位 TPAD，等待捕获上升沿，捕获之后，得到定时器的值，计算充电时间。

5.3 TPAD_Get_MaxVal(void)

多次调用 TPAD_Get_Val 函数获取充电时间。获取最大的值。

5.4 TPAD_Init(void)

初始化 TPAD
在系统启动后，初始化输入捕获。先 10 次调用 TPAD_Get_Val() 函数获取 10 次充电时间，然后获取中间 N（N=8或者6）次的平均值，作为在没有电容触摸按键下的时候的充电时间缺省值 tpad_default_val。

5.5 TPAD_Scan(void)

扫描 TPAD
调用 TPAD_Get_MaxVal 函数获取多次充电中最大的充电时间，跟 tpad_default_val 比较，如果大于某个阈值 tpad_default_val+TPAD_GATE_VAL，则认为有触摸动作。

六、添加TPAD相关函数

/******************** TPAD 引脚配置参数定义 **************************/
#define TOUCHPAD_TIMx                        TIM5
#define TOUCHPAD_TIM_RCC_CLK_ENABLE()        __HAL_RCC_TIM5_CLK_ENABLE()
#define TOUCHPAD_TIM_RCC_CLK_DISABLE()       __HAL_RCC_TIM5_CLK_DISABLE()#define TOUCHPAD_GPIO_RCC_CLK_ENABLE()       __HAL_RCC_GPIOA_CLK_ENABLE()
#define TOUCHPAD_GPIO_PIN                    GPIO_PIN_1
#define TOUCHPAD_GPIO                        GPIOA
#define TOUCHPAD_TIM_CHANNEL                 TIM_CHANNEL_2
#define TOUCHPAD_TIM_FLAG_CCR                TIM_FLAG_CC2//定时器最大计数值
#define TPAD_ARR_MAX_VAL    0XFFFF
//保存没按下时定时器计数值
__IO uint16_t tpad_default_val = 0;/****************************************** 为电容按键放电* 清除定时器标志及计数******************************************/
static void TPAD_Reset(void)
{/* 定义IO硬件初始化结构体变量 */GPIO_InitTypeDef GPIO_InitStruct;/* 使能电容按键引脚对应IO端口时钟 */  TOUCHPAD_GPIO_RCC_CLK_ENABLE();/* 设置引脚输出为低电平 */HAL_GPIO_WritePin(TOUCHPAD_GPIO, TOUCHPAD_GPIO_PIN, GPIO_PIN_RESET);  //PA.2输出0,放电 /* 设定电容按键对应引脚IO编号 */GPIO_InitStruct.Pin = TOUCHPAD_GPIO_PIN;/* 设定电容按键对应引脚IO为输出模式 */GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;/* 设定电容按键对应引脚IO操作速度 */GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;/* 初始化电容按键对应引脚IO */HAL_GPIO_Init(TOUCHPAD_GPIO, &GPIO_InitStruct);       HAL_Delay(5);__HAL_TIM_SET_COUNTER(&htim5,0); // 清零定时器计数  __HAL_TIM_CLEAR_FLAG(&htim5, TIM_FLAG_UPDATE|TIM_FLAG_CC2);//清除中断标志GPIO_InitStruct.Mode = GPIO_MODE_INPUT;GPIO_InitStruct.Pull = GPIO_NOPULL;HAL_GPIO_Init(TOUCHPAD_GPIO, &GPIO_InitStruct);HAL_TIM_IC_Start(&htim5,TOUCHPAD_TIM_CHANNEL);
}/****************************************************** 得到定时器捕获值* 如果超时,则直接返回定时器的计数值.******************************************************/
static uint16_t TPAD_Get_Val(void)
{       TPAD_Reset();while(__HAL_TIM_GET_FLAG(&htim5,TOUCHPAD_TIM_FLAG_CCR)==RESET){    uint16_t count;count=__HAL_TIM_GET_COUNTER(&htim5);if(count>(TPAD_ARR_MAX_VAL-500))return count;//超时了,直接返回CNT的值}; return HAL_TIM_ReadCapturedValue(&htim5,TOUCHPAD_TIM_CHANNEL);
}/****************************************************** 读取n次,取最大值* n：连续获取的次数* 返回值：n次读数里面读到的最大读数值* *****************************************************/
static uint16_t TPAD_Get_MaxVal(uint8_t n)
{uint16_t temp=0;uint16_t res=0;while(n--){temp=TPAD_Get_Val();//得到一次值if(temp>res)res=temp;};return res;
}   /********************************************************
*
* 初始化触摸按键
* 获得空载的时候触摸按键的取值.
* 返回值:0,初始化成功;1,初始化失败
*
*********************************************************/
uint8_t TPAD_Init(void)
{uint16_t buf[10];uint32_t temp=0;uint8_t j,i;/* 以1MHz的频率计数  */MX_TIM5_Init();HAL_TIM_IC_Start(&htim5,TOUCHPAD_TIM_CHANNEL);/* 连续读取10次 */for(i=0;i<10;i++){               buf[i]=TPAD_Get_Val();HAL_Delay(10);      }/* 排序 */for(i=0;i<9;i++){for(j=i+1;j<10;j++){/* 升序排列 */if(buf[i]>buf[j]){temp=buf[i];buf[i]=buf[j];buf[j]=temp;}}}temp=0;/* 取中间的6个数据进行平均 */for(i=2;i<8;i++)temp+=buf[i];tpad_default_val=temp/6;printf("tpad_default_val:%d\r\n",tpad_default_val); /* 初始化遇到超过TPAD_ARR_MAX_VAL/2的数值,不正常! */if(tpad_default_val>TPAD_ARR_MAX_VAL/2)return 1;return 0;
}/*******************************************************************************
*
* 扫描触摸按键
* mode:0,不支持连续触发(按下一次必须松开才能按下一次);1,支持连续触发(可以一直按下)
* 返回值:0,没有按下;1,有按下;
*
*******************************************************************************/
//阈值：捕获时间必须大于(tpad_default_val + TPAD_GATE_VAL),才认为是有效触摸.
#define TPAD_GATE_VAL   100 uint8_t TPAD_Scan(uint8_t mode)
{//0,可以开始检测;>0,还不能开始检测   static uint8_t keyen=0;//扫描结果uint8_t res=0;//默认采样次数为3次uint8_t sample=3;  //捕获值   uint16_t rval;if(mode){//支持连按的时候，设置采样次数为6次sample=6; //支持连按  keyen=0;     } /* 获取当前捕获值(返回 sample 次扫描的最大值) */rval=TPAD_Get_MaxVal(sample);  /* printf打印函数调试使用，用来确定阈值TPAD_GATE_VAL，在应用工程中应注释掉 */
//  printf("scan_rval=%d\n",rval);//大于tpad_default_val+TPAD_GATE_VAL,且小于10倍tpad_default_val,则有效if(rval>(tpad_default_val+TPAD_GATE_VAL)&&rval<(10*tpad_default_val)){            //keyen==0,有效         if(keyen==0){res=1;       }          keyen=3;               //至少要再过3次之后才能按键有效   }if(keyen){keyen--;     }       return res;
}

七、修改main函数

/*** @brief  The application entry point.* @retval int*/
int main(void)
{/* USER CODE BEGIN 1 *//* USER CODE END 1 *//* MCU Configuration--------------------------------------------------------*//* Reset of all peripherals, Initializes the Flash interface and the Systick. */HAL_Init();/* USER CODE BEGIN Init *//* USER CODE END Init *//* Configure the system clock */SystemClock_Config();/* USER CODE BEGIN SysInit *//* USER CODE END SysInit *//* Initialize all configured peripherals */MX_USART1_UART_Init();TPAD_Init();/* USER CODE BEGIN 2 */printf("This is TPAD test...\n");/* USER CODE END 2 *//* Infinite loop *//* USER CODE BEGIN WHILE */while (1){if(TPAD_Scan(0)){printf("key down\r\n"); }/* USER CODE END WHILE *//* USER CODE BEGIN 3 */}/* USER CODE END 3 */
}

八、查看打印

串口打印功能查看 STM32CubeMX学习笔记（6）——USART串口使用

按下电容键，串口会打印信息，可根据 printf("scan_rval=%d\n",rval); 打印的 scan_rval 调整 TPAD_GATE_VAL 的大小，来调整按键灵敏度

九、注意事项

用户代码要加在 USER CODE BEGIN N 和 USER CODE END N 之间，否则下次使用 STM32CubeMX 重新生成代码后，会被删除。

• 由 Leung 写于 2021 年 3 月 29 日

• 参考：STM32的电容触摸按键实验
　　　　【常用模块】电容触摸按键模块（原理讲解、STM32实例操作）

STM32CubeMX学习笔记（24）——通用定时器接口使用（电容按键检测）相关推荐

STM32基于固件库学习笔记(4)(通用定时器)TIM3定时1S中断
STM32F103ZE系列定时器资源有 TIME1 和 TIME8 等高级定时器,也有 TIME2~TIME5 等通用定时器,还有 TIME6 和TIME7 等基本定时器. 通用定时器:是一个通过可 ...
STM32学习笔记：通用定时器输出PWM
脉冲宽度调制,简称PWM(Pulse Width Modulation)是利用微处理器的数字输出对模拟电路进行控制的一种非常有效的控制技术,常用于控制Led灯的亮度.电机转速等. STM32 的定时 ...
STM32学习笔记：通用定时器基本设定
STM32 包含11个定时器,其中TIM2~TIM5为通用定时器. 通用定时器挂载在低速外设总线APB1上,其时钟来源于输入为APB1的一个倍频器,只要APB1的时钟分频数不为1,TIMx的时钟频率就 ...
STM32CubeMX学习笔记（38）——FSMC接口使用（TFT-LCD屏显示）
一.TFT-LCD简介 TFT-LCD(Thin Film Transistor-Liquid Crystal Display) 即薄膜晶体管液晶显示器.TFT-LCD 与无源 TN-LCD. STN ...
STM32CubeMX学习笔记（9）——I2C接口使用(读写EEPROM AT24C02)
一.I2C简介 I2C(Inter-Integrated Circuit ,内部集成电路) 总线是一种由飞利浦 Philip 公司开发的串行总线.是两条串行的总线,它由一根数据线(SDA)和一根时钟 ...
STM32CubeMX学习笔记（22）——CRC接口使用
一.CRC简介 CRC(Cyclic Redundancy Check),即循环冗余校验,是一种根据网络数据包或计算机文件等数据产生简短固定位数校验码的一种信道编码技术,主要用来检测或校验数据传输或者 ...
STM32CubeMX学习笔记（28）——FreeRTOS实时操作系统使用（任务管理）
一.FreeRTOS简介 FreeRTOS 是一个可裁剪.可剥夺型的多任务内核,而且没有任务数限制.FreeRTOS 提供了实时操作系统所需的所有功能,包括资源管理.同步.任务通信等. FreeRTO ...
STM32CubeMX学习笔记（15）——电源管理(PWR)低功耗睡眠模式
一.低功耗模式简介系统提供了多个低功耗模式,可在 CPU 不需要运行时(例如等待外部事件时)节省功耗.由用户根据应用选择具体的低功耗模式,以在低功耗.短启动时间和可用唤醒源之间寻求最佳平衡. 睡眠模 ...
STM32CubeMX学习笔记（25）——FatFs文件系统使用（操作SPI Flash）
一.FatFs简介 FatFs 是面向小型嵌入式系统的一种通用的 FAT 文件系统.它完全是由 ANSI C 语言编写并且完全独立于底层的 I/O 介质.因此它可以很容易地不加修改地移植到其他的处理器 ...

STM32CubeMX学习笔记（24）——通用定时器接口使用（电容按键检测）