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	P403
OUT2	P407
OUT3	P408
OUT4	P409
GND	GND
VCC	3V3

3、图形化配置

打开图形化界面：

设置 Pin:

Ctrl + S 保存！
点击右上角 Generate Project Content 生成代码。

4、代码编写

新建两个文件 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 "hal_data.h"
#include <stdio.h>

#ifndef delay_ms
#define delay_ms(x)   R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MILLISECONDS)
#endif
#ifndef delay_1ms
#define delay_1ms(x)  R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MILLISECONDS)
#endif
#ifndef delay_us
#define delay_us(x)   R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MICROSECONDS)
#endif
#ifndef delay_1us
#define delay_1us(x)  R_BSP_SoftwareDelay(x, BSP_DELAY_UNITS_MICROSECONDS)
#endif

#ifndef u8
#define u8  uint8_t
#endif
#ifndef u16
#define u16 uint16_t
#endif
#ifndef u32
#define u32 uint32_t
#endif

/* TTP224触摸按键引脚定义 */
#define TTP224_KEY_IN1_GPIO_PIN     BSP_IO_PORT_04_PIN_03
#define TTP224_KEY_IN2_GPIO_PIN     BSP_IO_PORT_04_PIN_07
#define TTP224_KEY_IN3_GPIO_PIN     BSP_IO_PORT_04_PIN_08
#define TTP224_KEY_IN4_GPIO_PIN     BSP_IO_PORT_04_PIN_09

/* GPIO状态读取 */
static inline bsp_io_level_t TTP224_KEY_IN1_READ() {
    bsp_io_level_t p_pin_value;
    fsp_err_t err = R_IOPORT_PinRead(&g_ioport_ctrl, TTP224_KEY_IN1_GPIO_PIN, &p_pin_value);
    if(err != FSP_SUCCESS)
    {
        printf("GPIO Input Read Failed!!\r\n");
    }
    return p_pin_value;
}
static inline bsp_io_level_t TTP224_KEY_IN2_READ() {
    bsp_io_level_t p_pin_value;
    fsp_err_t err = R_IOPORT_PinRead(&g_ioport_ctrl, TTP224_KEY_IN2_GPIO_PIN, &p_pin_value);
    if(err != FSP_SUCCESS)
    {
        printf("GPIO Input Read Failed!!\r\n");
    }
    return p_pin_value;
}
static inline bsp_io_level_t TTP224_KEY_IN3_READ() {
    bsp_io_level_t p_pin_value;
    fsp_err_t err = R_IOPORT_PinRead(&g_ioport_ctrl, TTP224_KEY_IN3_GPIO_PIN, &p_pin_value);
    if(err != FSP_SUCCESS)
    {
        printf("GPIO Input Read Failed!!\r\n");
    }
    return p_pin_value;
}
static inline bsp_io_level_t TTP224_KEY_IN4_READ() {
    bsp_io_level_t p_pin_value;
    fsp_err_t err = R_IOPORT_PinRead(&g_ioport_ctrl, TTP224_KEY_IN4_GPIO_PIN, &p_pin_value);
    if(err != FSP_SUCCESS)
    {
        printf("GPIO Input Read Failed!!\r\n");
    }
    return p_pin_value;
}

/* 函数声明 */
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"


/******************************************************************
 * 函 数 名 称：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\Applay\app.c 中输入代码如下:

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

#include "app.h"
#include "stdio.h"

#include "bsp_uart.h"
#include "bsp_touchkey.h"
/******************************************************************
 * 函 数 名 称：led_blink
 * 函 数 说 明：该函数用于控制LED灯的闪烁效果
 *             运行时，LED灯每隔500毫秒闪烁一次
 *             完整运行此函数需要1s时间
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
static void led_blink(void)
{
    /* Set the pin to low */
    R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_02, BSP_IO_LEVEL_LOW);

    /* Delay for 500 milliseconds */
    R_BSP_SoftwareDelay(500, BSP_DELAY_UNITS_MILLISECONDS);

    /* Set the pin to high */
    R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_02, BSP_IO_LEVEL_HIGH);

    /* Delay for another 500 milliseconds */
    R_BSP_SoftwareDelay(500, BSP_DELAY_UNITS_MILLISECONDS);
}


/******************************************************************
 * 函 数 名 称：Run
 * 函 数 说 明：该函数是用户自定义的入口函数，等效于 main_app() 函数。
 *             在此函数中可以编写用户的应用逻辑代码。
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void Run(void)
{
    /* 初始化调试串口 */
    /* | RX:P100 | TX:P101 | */
    UART0_Debug_Init();

    printf("\r\n= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =\r\n");
    printf("\r\n=== Welcome to use the DQX-R7FA6E2BB3CNE development board ====\r\n");
    printf("\r\n======================= www.lckfb.com =========================\r\n");
    printf("\r\n======================= wiki.lckfb.com ========================\r\n");
    printf("\r\n======================= [Debug Uart0] =========================\r\n");
    printf("\r\n=================== | RX:P100 | TX:P101 | =====================\r\n");
    printf("\r\n= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =\r\n");

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

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

        delay_1ms(100);
    }
}

编译烧录。

【代码下载】

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

入门教程资料

常见模块移植手册

显示类

传感器类

控制类

一、模块来源

二、规格参数

三、移植过程

1、查看资料

2、引脚选择

3、图形化配置

4、代码编写

四、移植验证

​

一、模块来源 ​

二、规格参数 ​

三、移植过程 ​

1、查看资料 ​

2、引脚选择 ​

3、图形化配置 ​

4、代码编写 ​

四、移植验证 ​

一、模块来源

二、规格参数

三、移植过程

1、查看资料

2、引脚选择

3、图形化配置

4、代码编写

四、移植验证