TTP224触摸传感器 | 立创开发板技术文档中心

该模块是一个基于触摸检测IC(TTP223B)的电容式点动型触摸开关模块。常态下，模块输出低电平，模式为低功耗模式；当用手指触摸相应位置时，模块会输出高电平，模式切换为快速模式;当持续12秒没有触摸时，模式又切换为低功耗模式。可以将模块安装在非金属材料如塑料、玻璃的表面。也可以将薄薄的纸片（非金属）覆盖在模块的表面，直到触摸的位置正确，即可做成隐藏在墙壁、桌面等地方的按键。该模块可以让你免除常规按压型键的烦恼。

一、模块来源

采购链接：

TTP224 4路电容式触摸开关数字触摸传感器模块

资料下载链接：

https://pan.baidu.com/s/1lBksfqx_dT4uIyABkHVm3Q

资料提取码：hj2n

二、规格参数

工作电压：2.4-5.5V

工作电流：2.5uA~9uA

模块尺寸：35x29 mm

最快响应时间：100Ms

控制方式：GOIO

管脚数量：6 Pin（2.54mm间距排针）

以上信息见厂家资料文件

三、移植过程

我们的目标是将例程移植至开发板上【实现4路按键的触摸功能】。首先要获取资料，查看数据手册应如何实现读取数据，再移植至我们的工程。

1、查看资料

主要就是使用4个GPIO监控模块的OUT1~4的输出情况，那个OUT输出则说明那个对应模块的区域被触摸。

2、引脚选择

模块	开发板
OUT1	PA04
OUT2	PA05
OUT3	PA06
OUT4	PA07
GND	GND
VCC	3V3

3、代码编写

新建两个文件 bsp_touchkey.c 和 bsp_touchkey.h，并且将头文件路径添加到编译器中。

新建文件以及添加头文件路径到编译器，在 DHT11章节 已经讲过了，可以移步进行查看。

DHT11章节跳转 : （点击跳转🚀）

在文件 bsp_touchkey.c 和 bsp_touchkey.h 中，编写如下代码。

bsp_touchkey.hbsp_touchkey.c

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 文档网站：wiki.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 */

#ifndef BSP_CODE_BSP_TOUCHKEY_H_
#define BSP_CODE_BSP_TOUCHKEY_H_

#include "gd32vw55x.h"

/* TTP224触摸按键引脚定义 */
#define TTP224_GPIO_RCU_ENABLE() \
    rcu_periph_clock_enable(RCU_GPIOA);

#define TTP224_KEY_IN1_GPIO_PORT    GPIOA
#define TTP224_KEY_IN1_GPIO_PIN     GPIO_PIN_4
#define TTP224_KEY_IN1_READ()       gpio_input_bit_get(TTP224_KEY_IN1_GPIO_PORT, TTP224_KEY_IN1_GPIO_PIN)

#define TTP224_KEY_IN2_GPIO_PORT    GPIOA
#define TTP224_KEY_IN2_GPIO_PIN     GPIO_PIN_5
#define TTP224_KEY_IN2_READ()       gpio_input_bit_get(TTP224_KEY_IN2_GPIO_PORT, TTP224_KEY_IN2_GPIO_PIN)

#define TTP224_KEY_IN3_GPIO_PORT    GPIOA
#define TTP224_KEY_IN3_GPIO_PIN     GPIO_PIN_6
#define TTP224_KEY_IN3_READ()       gpio_input_bit_get(TTP224_KEY_IN3_GPIO_PORT, TTP224_KEY_IN3_GPIO_PIN)

#define TTP224_KEY_IN4_GPIO_PORT    GPIOA
#define TTP224_KEY_IN4_GPIO_PIN     GPIO_PIN_7
#define TTP224_KEY_IN4_READ()       gpio_input_bit_get(TTP224_KEY_IN4_GPIO_PORT, TTP224_KEY_IN4_GPIO_PIN)

void TTP224_GPIO_Init(void);//初始化TTP224触摸按键GPIO
char Key_IN1_Scan(void);//触摸按键1的输入状态
char Key_IN2_Scan(void);//触摸按键2的输入状态
char Key_IN3_Scan(void);//触摸按键3的输入状态
char Key_IN4_Scan(void);//触摸按键4的输入状态

#endif /* BSP_CODE_BSP_TOUCHKEY_H_ */

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 文档网站：wiki.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 */

#include "bsp_touchkey.h"


/******************************************************************
 * 函 数 名 称：TTP224_GPIO_Init
 * 函 数 说 明：初始化TTP224触摸按键GPIO
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void TTP224_GPIO_Init(void)
{
    /* 使能GPIO时钟 */
    TTP224_GPIO_RCU_ENABLE();

    /* 配置触摸按键引脚为输入模式 */
    gpio_mode_set(TTP224_KEY_IN1_GPIO_PORT, GPIO_MODE_INPUT, GPIO_PUPD_NONE, TTP224_KEY_IN1_GPIO_PIN);
    gpio_mode_set(TTP224_KEY_IN2_GPIO_PORT, GPIO_MODE_INPUT, GPIO_PUPD_NONE, TTP224_KEY_IN2_GPIO_PIN);
    gpio_mode_set(TTP224_KEY_IN3_GPIO_PORT, GPIO_MODE_INPUT, GPIO_PUPD_NONE, TTP224_KEY_IN3_GPIO_PIN);
    gpio_mode_set(TTP224_KEY_IN4_GPIO_PORT, GPIO_MODE_INPUT, GPIO_PUPD_NONE, TTP224_KEY_IN4_GPIO_PIN);
}


/******************************************************************
 * 函 数 名 称：Key_IN1_Scan
 * 函 数 说 明：返回触摸键1引脚电平状态
 * 函 数 形 参：无
 * 函 数 返 回：0=未检测到有触摸  1=检测到触摸
 * 作       者：LC
 * 备       注：无
******************************************************************/
char Key_IN1_Scan(void)
{
    return TTP224_KEY_IN1_READ();
}
/******************************************************************
 * 函 数 名 称：Key_IN2_Scan
 * 函 数 说 明：返回触摸键2引脚电平状态
 * 函 数 形 参：无
 * 函 数 返 回：0=未检测到有触摸  1=检测到触摸
 * 作       者：LC
 * 备       注：无
******************************************************************/
char Key_IN2_Scan(void)
{
    return TTP224_KEY_IN2_READ();
}
/******************************************************************
 * 函 数 名 称：Key_IN3_Scan
 * 函 数 说 明：返回触摸键3引脚电平状态
 * 函 数 形 参：无
 * 函 数 返 回：0=未检测到有触摸  1=检测到触摸
 * 作       者：LC
 * 备       注：无
******************************************************************/

char Key_IN3_Scan(void)
{
    return TTP224_KEY_IN3_READ();
}
/******************************************************************
 * 函 数 名 称：Key_IN4_Scan
 * 函 数 说 明：返回触摸键4引脚电平状态
 * 函 数 形 参：无
 * 函 数 返 回：0=未检测到有触摸  1=检测到触摸
 * 作       者：LC
 * 备       注：无
******************************************************************/
char Key_IN4_Scan(void)
{
    return TTP224_KEY_IN4_READ();
}

四、移植验证

在 src\main.c 中输入代码如下:

#include "gd32vw55x.h"
#include "systick.h"
#include <stdio.h>
#include "main.h"
#include "gd32vw553h_eval.h"

#include "bsp_touchkey.h"

/*!
    \brief      toggle the led every 500ms
    \param[in]  none
    \param[out] none
    \retval     none
*/
void led_spark(void)
{
    static __IO uint32_t timingdelaylocal = 0U;

    if(timingdelaylocal) {

        if(timingdelaylocal < 500U) {
            gd_eval_led_on(LED1);
        } else {
            gd_eval_led_off(LED1);
        }

        timingdelaylocal--;
    } else {
        timingdelaylocal = 1000U;
    }
}

/*!
    \brief      main function
    \param[in]  none
    \param[out] none
    \retval     none
*/
int main(void)
{
#ifdef __FIRMWARE_VERSION_DEFINE
    uint32_t fw_ver = 0;
#endif /* __FIRMWARE_VERSION_DEFINE */

    /* configure systick */
    systick_config();
    eclic_priority_group_set(ECLIC_PRIGROUP_LEVEL3_PRIO1);
    /* initilize the LEDs, USART and key */
    gd_eval_led_init(LED1);
    gd_eval_com_init(EVAL_COM0);
    gd_eval_key_init(KEY_TAMPER_WAKEUP, KEY_MODE_GPIO);

#ifdef __FIRMWARE_VERSION_DEFINE
    fw_ver = gd32vw55x_firmware_version_get();
    printf("\r\n= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =\r\n\n");
    printf("\r\n=== Welcome to use the LC-GD32VW553-HMQ6 development board ====\r\n\n");
    printf("\r\n======================= www.lckfb.com =========================\r\n\n");
    printf("\r\n======================= wiki.lckfb.com ========================\r\n\n");
    printf("\r\n= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =\r\n");
    /* print firmware version */
    printf("\r\nGD32VW55X series firmware version: V%d.%d.%d", (uint8_t)(fw_ver >> 24), (uint8_t)(fw_ver >> 16), (uint8_t)(fw_ver >> 8));
#endif /* __FIRMWARE_VERSION_DEFINE */

    /* print out the clock frequency of system, AHB, APB1 and APB2 */
    printf("\r\nCK_SYS is %d\r\n", rcu_clock_freq_get(CK_SYS));
    printf("\r\nCK_AHB is %d\r\n", rcu_clock_freq_get(CK_AHB));
    printf("\r\nCK_APB1 is %d\r\n", rcu_clock_freq_get(CK_APB1));
    printf("\r\nCK_APB2 is %d\r\n", rcu_clock_freq_get(CK_APB2));

    TTP224_GPIO_Init();

    printf("\r\nTTP224 touch key example start!\r\n");

    while(1)
    {
        if(Key_IN1_Scan() == SET){
            printf("[1]-Touch!\r\n");
            while( Key_IN1_Scan() == SET );
        }
        if(Key_IN2_Scan() == SET){
            printf("[2]-Touch!\r\n");
            while( Key_IN2_Scan() == SET );
        }
        if(Key_IN3_Scan() == SET){
            printf("[3]-Touch!\r\n");
            while( Key_IN3_Scan() == SET );
        }
        if(Key_IN4_Scan() == SET){
            printf("[4]-Touch!\r\n");
            while( Key_IN4_Scan() == SET );
        }

        delay_1ms(100);
    }
}

上电效果：

【代码下载】

跳转到 下载中心 去下载模块移植代码：【点击跳转🚀】

常见模块移植手册

显示类

传感器类

控制类

一、模块来源

二、规格参数

三、移植过程

1、查看资料

2、引脚选择

3、代码编写

四、移植验证

​

一、模块来源 ​

二、规格参数 ​

三、移植过程 ​

1、查看资料 ​

2、引脚选择 ​

3、代码编写 ​

四、移植验证 ​

一、模块来源

二、规格参数

三、移植过程

1、查看资料

2、引脚选择

3、代码编写

四、移植验证