CH592/CH582 触摸按键应用开发实例讲解

一. 触摸原理介绍

触摸按键电容产生原理一般应用中,可用手指与触摸板的电容模型简化代替人体与触摸板的电容模型,如图所示。

沁恒微电子的电容触摸按键检测方案主要有以下两种：

（1）电流源充电方案。低功耗蓝牙系列、通用系列 MCU 使用该方式。相同的充电时间，通过单片机内部 AD 采集触摸通道的电压值，与未按下时的值作差，再根据定义的阈值识别按键按下与抬起。沁恒微电子在电流源充电方案的基础上提供**驱动屏蔽和密集模式两种增强功能。增强功能进一步提高了触摸按键的稳定性，使触摸按键具有防水特性。**低功耗蓝牙系列 CH58x/C WCH 触摸应用指南 3 H59x 芯片支持驱动屏蔽技术，青稞 RISC-V 通用系列、Cortex-M 通用系列、低功耗蓝牙系列支持密集模式。

（2）松弛振荡方案。单片机内部采集固定时间段的脉冲个数，与未按下时的个数作差，然后根据定于的阈值识别按键的按下与抬起，如 CH554 系列。

更多更详细的硬件设计内容，大家可以参考官方提供的相关文档：WCH触摸应用指南

二、代码修改

我们的项目需要用到BLE功能，所以我们用的样例程序是官方提供的Touch_Key_with_ble

与触摸按键相关的代码文件主要有：

 libCH59xTOUCH.a

 wchtouch.h

 Touch.c

 Touch.h

 TouchKey_CFG.h

 app_tmos.c

 app_tmos.h

 peripheral_main.c

其中 libCH59xTOUCH.a 和 wchtouch.h为 WCH 提供的触摸库文件；Touch.c 和 Tou ch.h 为触摸库相关的操作，包括库初始化、触摸通道初始化、触发按键获取等；Touch Key_CFG.h 为触摸库配置参数文件。

app_tmos.c、app_tmos.h、 peripheral_main.c 为应用层文件。其中 app_tmos.c、app_tmo s.h 与 BLE 配合工作，使用 tmos 进行管理、获取按键。

官方提供的样例程序可以直接使用，不过样例程序提供了12个触摸按键，但我们实际应用中通常不需要这么多触摸按键，接下来，我们来讲解如何修改。

1、TouchKey_CFG.h的修改：

（我们的项目使用了PA5、PA8两个触摸键）

cpp 复制代码

typedef enum _TKY_QUEUE_ID
{
TKY_QUEUE_0 = 0,
TKY_QUEUE_1,
TKY_QUEUE_END
} TKY_QUEUE_ID;


#define TKY_MAX_QUEUE_NUM     			            TKY_QUEUE_END


#define TKY_CHS_INIT \
                GEN_TKY_CH_INIT(TKY_QUEUE_0,1,3,3,0,3284,66,52),\
                GEN_TKY_CH_INIT(TKY_QUEUE_1,2,3,3,0,3600,67,54)

2、Touch.h的修改

cpp 复制代码

typedef enum
{
    KID_K0 = 0,
    KID_K1
}KEY_ID_E;


typedef enum
{
    KEY_NONE = 0,           //0 表示按键事件 */

    KEY_0_DOWN,             // 1键按下 
    KEY_0_UP,               // 1键弹起 
    KEY_0_LONG,             // 1键长按 

    KEY_1_DOWN,             // 2键按下 
    KEY_1_UP,               // 2键弹起 
    KEY_1_LONG            // 2键长按 

}KEY_ENUM;


/* 按键FIFO用到变量 */
#define KEY_FIFO_SIZE   (TKY_MAX_QUEUE_NUM * 8)          //可根据使用环境和硬件需要进行修改*/

Touch.h在我们的项目中，其实可以不用修改。

3、Touch.c 的修改

cpp 复制代码

static const uint32_t TKY_Pin[TKY_MAX_QUEUE_NUM][2] = {
  {0x00, 0x00000020},//PA5,AIN1
  {0x00, 0x00000100}//PA8,AIN12
};

pIsKeyDownFunc KeyDownFunc[12] =
{
        IsKeyDown1,
        IsKeyDown2
};


#if 0
static uint8_t IsKeyDown3(void)
{
    if (keyData & 0x0004)   return 1;
    else                    return 0;
}

static uint8_t IsKeyDown4(void)
{
    if (keyData & 0x0008)   return 1;
    else                    return 0;
}

static uint8_t IsKeyDown5(void)
{
    if (keyData & 0x0010)   return 1;
    else                    return 0;
}

static uint8_t IsKeyDown6(void)
{
    if (keyData & 0x0020)   return 1;
    else                    return 0;
}

static uint8_t IsKeyDown7(void)
{
    if (keyData & 0x0040)   return 1;
    else                    return 0;
}

static uint8_t IsKeyDown8(void)
{
    if (keyData & 0x0080)   return 1;
    else                    return 0;
}

static uint8_t IsKeyDown9(void)
{
    if (keyData & 0x0100)   return 1;
    else                    return 0;
}

static uint8_t IsKeyDown10(void)
{
    if (keyData & 0x0200)   return 1;
    else                    return 0;
}

static uint8_t IsKeyDown11(void)
{
    if (keyData & 0x0400)   return 1;
    else                    return 0;
}

static uint8_t IsKeyDown12(void)
{
    if (keyData & 0x0800)   return 1;
    else                    return 0;
}
#endif

4、app_tmos.c的修改

cpp 复制代码

void tky_on_TMOS_dataProcess(void)
{
    uint8_t key_val = 0;
    key_val = touch_GetKey();
    if (key_val != 0x00)
    {    //有触摸按键，增加相应的处理程序
        if (bleConnectState )
        {
            peripheralChar2Notify( &key_val, 1 );//将键值上报给上位机蓝牙
        }
    }
}

这个函数是读取触摸按键的键值，并判断是否有触摸按键，如果有，增加相应的处理程序，这部分程序与我们项目有关，不方便提供，大家可以自行增加相应的功能，比如简单控制LED。

完整工程请参考：CH592Ftouchkeywithble&RF资源-CSDN文库

写这篇文章，更多的意义是记录自己对官方提供的样例程序的理解及修改的一些体会，毕竟我们的项目几乎只是在样例程序上略作修改，并增加了一些自己需要的功能，如此而已。如果能对大家有那怕一点点帮助，纯属意外之喜。