当前位置： 首页 > web >正文

CH59x CH58x 触摸按键应用开发实例讲解（二）

web 2025/9/1 20:47:30

前段时间，我们根据当时在做的一个项目，写了篇《CH592/CH582 触摸按键应用开发实例讲解》的博文，在那篇博文中我们简单介绍了触摸按键的原理，所以这里我们就讲触摸按键的原理，而侧重讲解触摸按键的实现，官方提供的触摸库的添加及应用。

想要了解触摸按键的原理的朋友可以自行搜索相关资料，也可以参考我们之前的博文：

CH592/CH582 触摸按键应用开发实例讲解-CSDN博客

一、在现有工程中添加触摸库

本博文以CH584M为例讲解，我们在官方提供的CH585例程中找到以下目录文件并复制到我们现有的工程目录中。

在工程中设置include目录并添加触摸库。

、

按上图所示添加相应的文件目录并修改设置好工程，那我们就完成了在现有的工程中添加触摸功能的软件框架。

二、初步理解例程中触摸功能的实现

从上图中我们可以看出，使用官方提供的触摸库还是比较简单的，我们需要做的只是简单几个步骤：

1、初始化触摸库的基本参数：

/********************************************************************** @fn      touch_on_TMOS_init** @brief   触摸初始化函数（基于TMOS）** @return  none*/
void touch_on_TMOS_init(void)
{TouchKey_TaskID = TMOS_ProcessEventRegister(Touch_Key_ProcessEvent);TKY_PeripheralInit();       /* 初始外设，例如背光和蜂鸣器等 */touch_Init(&touch_cfg);				/* 初始化触摸库  */wakeUpCount = 50; // 唤醒后持续时间，单位TRIGGER_TIME(100ms)wakeupflag = 1;   // 置成唤醒状态triggerTime = TRIGGER_TIME;TKY_SetSleepStatusValue(~tkyQueueAll);
#if TKY_SLEEP_ENtky_DealData_start();
#elsetky_DealData_stop();
#endif#if PRINT_ENtmos_set_event(TouchKey_TaskID, DEBUG_PRINT_EVENT);
#endiftmos_set_event(TouchKey_TaskID, WAKEUP_DATA_DEAL_EVT);tmos_set_event(TouchKey_TaskID, TKY_KEEPALIVE_EVENT);//    TMR0_TimerInit(FREQ_SYS/1000);               //定时周期为1ms
//    TMR0_ITCfg(ENABLE, TMR0_3_IT_CYC_END);
//    PFIC_EnableIRQ( TMR0_IRQn );dg_log("Touch Key init Finish!\n");
}

/********************************************************************************************************* @fn      touch_Init* * @brief   初始化按键. 该函数被 TKY_Init() 调用。** @return  none*/
void touch_Init(touch_cfg_t *p)
{touch_InitHard();             /* 初始化Touch硬件和库基本参数 */touch_InitVar(p);           /* 初始化按键变量 */
}/********************************************************************************************************* @fn      touch_InitHard* @brief   初始化触摸按键* @param   无* @return  无*/
static void touch_InitHard (void)
{touch_Regcfg();touch_Baseinit();touch_Channelinit();
}/********************************************************************************************************* @fn      touch_Baseinit* @brief   触摸基础库初始化* @param   无* @return  无*/
static void touch_Baseinit(void)
{uint8_t sta=0xff;TKY_BaseInitTypeDef TKY_BaseInitStructure = {0};for(uint8_t i = 0; i < TKY_MAX_QUEUE_NUM; i++)  //初始化tkyQueueAll变量{tkyQueueAll |= 1<<i;}dg_log("tQ : %04x\n",tkyQueueAll);//----------触摸按键基础设置初始化--------TKY_BaseInitStructure.filterMode = TKY_FILTER_MODE;TKY_BaseInitStructure.shieldEn = TKY_SHIELD_EN;TKY_BaseInitStructure.singlePressMod = TKY_SINGLE_PRESS_MODE;TKY_BaseInitStructure.filterGrade = TKY_FILTER_GRADE;TKY_BaseInitStructure.maxQueueNum = TKY_MAX_QUEUE_NUM;TKY_BaseInitStructure.baseRefreshOnPress = TKY_BASE_REFRESH_ON_PRESS;//---基线更新速度，baseRefreshSampleNum和filterGrade，与基线更新速度成反比，基线更新速度还与代码结构相关，可通过函数GetCurQueueBaseLine来观察---TKY_BaseInitStructure.baseRefreshSampleNum = TKY_BASE_REFRESH_SAMPLE_NUM;TKY_BaseInitStructure.baseUpRefreshDouble = TKY_BASE_UP_REFRESH_DOUBLE;TKY_BaseInitStructure.baseDownRefreshSlow = TKY_BASE_DOWN_REFRESH_SLOW;TKY_BaseInitStructure.tkyBufP = TKY_MEMBUF;sta = TKY_BaseInit( TKY_BaseInitStructure );dg_log("TKY_BaseInit:%02X\r\n",sta);
}

2、初始化触摸通道：

#define GEN_TKY_CH_INIT(qNum,chNum,chTime,disChTime,slpmode,chBaseline,trs,trs2) \{\.queueNum=qNum,.channelNum=chNum,.chargeTime=chTime,.disChargeTime=disChTime,\.sleepStatus=slpmode,\.baseLine = chBaseline,\.threshold=trs,\.threshold2=trs2\}#define TKY_CHS_INIT \GEN_TKY_CH_INIT(TKY_QUEUE_0,0,0,3,0,3382,   85,  65),\GEN_TKY_CH_INIT(TKY_QUEUE_1,5,0,3,0,3382,   88,  68),\GEN_TKY_CH_INIT(TKY_QUEUE_2,9,0,3,0,3382,  94,  74),\GEN_TKY_CH_INIT(TKY_QUEUE_3,4,0,3,0,3382,   68,  48),\GEN_TKY_CH_INIT(TKY_QUEUE_4,6,0,3,0,3382,   83,  63),\GEN_TKY_CH_INIT(TKY_QUEUE_5,10,0,3,0,3382,   90,  70),\GEN_TKY_CH_INIT(TKY_QUEUE_6,3,0,3,0,3382,   67,  47),\GEN_TKY_CH_INIT(TKY_QUEUE_7,7,0,3,0,3382,   88,  68),\GEN_TKY_CH_INIT(TKY_QUEUE_8,1,0,3,0,3382,   74,  64),\GEN_TKY_CH_INIT(TKY_QUEUE_9,2,0,3,0,3382,   68,  48),\GEN_TKY_CH_INIT(TKY_QUEUE_10,8,0,3,0,3382, 84,  64),\GEN_TKY_CH_INIT(TKY_QUEUE_11,11,0,3,0,3382, 64,  44)static const TKY_ChannelInitTypeDef my_tky_ch_init[TKY_QUEUE_END] = {TKY_CHS_INIT};static const uint32_t TKY_Pin[ TKY_QUEUE_END ] = {GPIO_Pin_4, GPIO_Pin_15, GPIO_Pin_0, GPIO_Pin_14,GPIO_Pin_3, GPIO_Pin_6, GPIO_Pin_13,GPIO_Pin_2, GPIO_Pin_5, GPIO_Pin_12,GPIO_Pin_1, GPIO_Pin_7,
};/********************************************************************************************************* @fn      touch_InitHard* @brief   初始化触摸按键* @param   无* @return  无*/
static void touch_InitHard (void)
{touch_Regcfg();touch_Baseinit();touch_Channelinit();
}/********************************************************************************************************* @fn      touch_Channelinit* @brief   触摸通道初始化* @param   无* @return  无*/
static void touch_Channelinit(void)
{uint8_t error_flag = 0;uint16_t chx_mean = 0,chx_mean_last = 0;for(uint8_t i = 0; i < TKY_MAX_QUEUE_NUM; i++){TKY_CHInit(my_tky_ch_init[i]);}for(uint8_t i = 0; i < TKY_MAX_QUEUE_NUM; i++){chx_mean = TKY_GetCurChannelMean(my_tky_ch_init[i].channelNum, my_tky_ch_init[i].chargeTime,my_tky_ch_init[i].disChargeTime, 1000);if(chx_mean < 3000 || chx_mean > 3800){error_flag = 1;}else{TKY_SetCurQueueBaseLine(i, chx_mean);}}//充放电基线值异常，重新校准基线值if(error_flag != 0){dg_log("\n\nCharging parameters error, preparing for recalibration ...\n\n");uint16_t charge_time;for (uint8_t i = 0; i < TKY_MAX_QUEUE_NUM; i++){ charge_time = 0,chx_mean = 0;while (1){chx_mean = TKY_GetCurChannelMean(my_tky_ch_init[i].channelNum, charge_time,3, 1000);//              dg_log("testing .... chg : %d, baseline : %d\n",charge_time,chx_mean);//打印基线值if ((charge_time == 0) && ((chx_mean > 3800))) {//低于最小充电参数dg_log("Error, %u KEY%u Too small Cap,Please check the hardware !\r\n",chx_mean,i);break;}else {if ((chx_mean > 3000) &&(chx_mean < 3800)) {//充电参数正常TKY_SetCurQueueBaseLine(i, chx_mean);TKY_SetCurQueueChargeTime(i,charge_time,3);dg_log("channel:%u, chargetime:%u,BaseLine:%u\r\n",i, charge_time, chx_mean);break;}else if(chx_mean >= 3800){TKY_SetCurQueueBaseLine (i, chx_mean_last);TKY_SetCurQueueChargeTime(i,charge_time-1,3);dg_log("Warning,channel:%u Too large Current, chargetime:%u,BaseLine:%u\r\n",i, charge_time, chx_mean);break;}charge_time++;chx_mean_last = chx_mean;if (charge_time > 0x1f) {    //超出最大充电参数dg_log("Error, Chargetime Max,KEY%u Too large Cap,Please check the hardware !\r\n",i);break;}}}}}TKY_SaveAndStop();
}void touch_GPIOModeCfg (GPIOModeTypeDef mode, uint32_t channel)
{switch(mode){case GPIO_ModeIN_Floating:R32_PA_PD_DRV &= ~TKY_Pin[ channel ];R32_PA_PU &= ~TKY_Pin[ channel ];R32_PA_DIR &= ~TKY_Pin[ channel ];break;case GPIO_ModeOut_PP_5mA://推挽接地放电放电R32_PA_PU &= ~TKY_Pin[ channel ];R32_PA_PD_DRV &= ~TKY_Pin[ channel ];R32_PA_DIR |= TKY_Pin[ channel ];R32_PA_CLR |= TKY_Pin[ channel ];break;default:break;}
}

3、扫描按键并根据按键执行相应的动作


/********************************************************************** @fn      Touch_Key_ProcessEvent** @brief   触摸按键处理函数** @return  none*/
tmosEvents Touch_Key_ProcessEvent(tmosTaskID task_id, tmosEvents events)
{uint16_t res;if (events & WAKEUP_DATA_DEAL_EVT){touch_Scan();tky_on_TMOS_dataProcess();
#if TKY_SLEEP_ENif (wakeupflag)
#endiftmos_start_task (TouchKey_TaskID, WAKEUP_DATA_DEAL_EVT, WAKEUP_TIME);return (events ^ WAKEUP_DATA_DEAL_EVT);}if (events & DEALDATA_EVT){PeriodicDealData();
#if TKY_SLEEP_ENif (!advState || wakeupflag)
#endiftmos_start_task(TouchKey_TaskID, DEALDATA_EVT, triggerTime);return (events ^ DEALDATA_EVT);}#if PRINT_ENif (events & DEBUG_PRINT_EVENT){touch_InfoDebug();tmos_start_task(TouchKey_TaskID, DEBUG_PRINT_EVENT,SLEEP_TRIGGER_TIME);return (events ^ DEBUG_PRINT_EVENT);}
#endifif(events & TKY_KEEPALIVE_EVENT){return events;}return 0;
}/********************************************************************************************************* @fn      touch_Scan* @brief   扫描所有按键。非阻塞，被systick中断周期性的调用* @param   无* @return  无*/
void touch_Scan(void)
{uint8_t i;TKY_LoadAndRun();           //---载入休眠前保存的部分设置---keyData = TKY_PollForFilter();TKY_SaveAndStop();          //---对相关寄存器进行保存---
#if TKY_SLEEP_ENif (keyData){wakeUpCount = WAKEUPTIME; //---唤醒时间---}
#endiftouch_DetectKey(p_touch_cfg->touch_button_cfg);//    WheelData = touch_DetectWheelSlider(p_touch_cfg->touch_wheel_cfg);//    SilderData = touch_DetecLineSlider(p_touch_cfg->touch_slider_cfg);
}char displaystring[16];
uint8_t keyidx = 0;
/********************************************************************** @fn      tky_on_TMOS_dataProcess** @brief   触摸数据处理函数（基于TMOS），蓝牙连接成功后将获取到键值以通知的形式上报给上位机蓝牙** @return  none*/
__HIGH_CODE
void tky_on_TMOS_dataProcess(void)
{uint8_t key_val = 0x00;key_val = touch_GetKey();if (key_val != 0x00){switch (key_val){case KEY_NONE   :   break;case KEY_0_DOWN :   TKY_KeyBacklightOut(0,!getBacklightState(0));  displaystring[keyidx++]='0'; break;case KEY_0_LONG :   TKY_KeyBacklightOut(0,!getBacklightState(0));  PRINT("KEY_1_LONG !\n");break;case KEY_0_UP   :   TKY_KeyBacklightOut(0,DISABLE); PRINT("KEY_1_UP   !\n");break;case KEY_1_DOWN :   TKY_KeyBacklightOut(1,!getBacklightState(1));  displaystring[keyidx++]='1';break;case KEY_1_LONG :   TKY_KeyBacklightOut(1,!getBacklightState(1));  PRINT("KEY_2_LONG !\n");break;case KEY_1_UP   :   TKY_KeyBacklightOut(1,DISABLE); PRINT("KEY_2_UP   !\n");break;case KEY_2_DOWN :   TKY_KeyBacklightOut(2,!getBacklightState(2));  displaystring[keyidx++]='2';break;case KEY_2_LONG :   TKY_KeyBacklightOut(2,!getBacklightState(2));  PRINT("KEY_3_LONG !\n");break;case KEY_2_UP   :   TKY_KeyBacklightOut(2,DISABLE); PRINT("KEY_3_UP   !\n");break;case KEY_3_DOWN :   TKY_KeyBacklightOut(3,!getBacklightState(3));  displaystring[keyidx++]='3';break;case KEY_3_LONG :   TKY_KeyBacklightOut(3,!getBacklightState(3));  PRINT("KEY_4_LONG !\n");break;case KEY_3_UP   :   TKY_KeyBacklightOut(3,DISABLE); PRINT("KEY_4_UP   !\n");break;case KEY_4_DOWN :   TKY_KeyBacklightOut(4,!getBacklightState(4));  displaystring[keyidx++]='4';break;case KEY_4_LONG :   TKY_KeyBacklightOut(4,!getBacklightState(4));  PRINT("KEY_5_LONG !\n");break;case KEY_4_UP   :   TKY_KeyBacklightOut(4,DISABLE); PRINT("KEY_5_UP   !\n");break;case KEY_5_DOWN :   TKY_KeyBacklightOut(5,!getBacklightState(5));  displaystring[keyidx++]='5';break;case KEY_5_LONG :   TKY_KeyBacklightOut(5,!getBacklightState(5));  PRINT("KEY_6_LONG !\n");break;case KEY_5_UP   :   TKY_KeyBacklightOut(5,DISABLE); PRINT("KEY_6_UP   !\n");break;case KEY_6_DOWN :   TKY_KeyBacklightOut(6,!getBacklightState(6));  displaystring[keyidx++]='6';break;case KEY_6_LONG :   TKY_KeyBacklightOut(6,!getBacklightState(6));  PRINT("KEY_7_LONG !\n");break;case KEY_6_UP   :   TKY_KeyBacklightOut(6,DISABLE); PRINT("KEY_7_UP   !\n");break;case KEY_7_DOWN :   TKY_KeyBacklightOut(7,!getBacklightState(7));  displaystring[keyidx++]='7';break;case KEY_7_LONG :   TKY_KeyBacklightOut(7,!getBacklightState(7));  PRINT("KEY_8_LONG !\n");break;case KEY_7_UP   :   TKY_KeyBacklightOut(7,DISABLE); PRINT("KEY_8_UP   !\n");break;case KEY_8_DOWN :   TKY_KeyBacklightOut(8,!getBacklightState(8));  displaystring[keyidx++]='8';break;case KEY_8_LONG :   TKY_KeyBacklightOut(8,!getBacklightState(8));  PRINT("KEY_6_LONG !\n");break;case KEY_8_UP   :   TKY_KeyBacklightOut(8,DISABLE); PRINT("KEY_6_UP   !\n");break;case KEY_9_DOWN :   TKY_KeyBacklightOut(9,!getBacklightState(9));  displaystring[keyidx++]='9';break;case KEY_9_LONG :   TKY_KeyBacklightOut(9,!getBacklightState(9));  PRINT("KEY_7_LONG !\n");break;case KEY_9_UP   :   TKY_KeyBacklightOut(9,DISABLE); PRINT("KEY_7_UP   !\n");break;case KEY_10_DOWN :   TKY_KeyBacklightOut(10,!getBacklightState(10));  displaystring[keyidx++]='#';break;case KEY_10_LONG :   TKY_KeyBacklightOut(10,!getBacklightState(10));  PRINT("KEY_8_LONG !\n");break;case KEY_10_UP   :   TKY_KeyBacklightOut(10,DISABLE); PRINT("KEY_8_UP   !\n");break;case KEY_11_DOWN :   TKY_KeyBacklightOut(11,!getBacklightState(11));  displaystring[keyidx++]='*';break;case KEY_11_LONG :   TKY_KeyBacklightOut(11,!getBacklightState(11));  PRINT("KEY_8_LONG !\n");break;case KEY_11_UP   :   TKY_KeyBacklightOut(11,DISABLE); PRINT("KEY_8_UP   !\n");break;default : break;}if(keyidx >= 16)keyidx = 0;}
}void TKY_KeyBacklightOut (uint8_t key, FunctionalState s)
{// PRINT("%d,%d",key,s);if (DISABLE == s){BacklightArray[ key ].BacklightStates = 0;MBI5020_Display(0);}else{BacklightArray[ key ].BacklightStates = 1;MBI5020_Display(Key_Led_Array[key]);sc5080_soundplay(SOUND_DI);}
}uint8_t getBacklightState(uint8_t key)
{return BacklightArray[ key ].BacklightStates;
}void TKY_KeyBacklightOut (uint8_t key, FunctionalState s)
{// PRINT("%d,%d",key,s);if (DISABLE == s){BacklightArray[ key ].BacklightStates = 0;MBI5020_Display(0);}else{BacklightArray[ key ].BacklightStates = 1;MBI5020_Display(Key_Led_Array[key]);sc5080_soundplay(SOUND_DI);}
}uint8_t getBacklightState(uint8_t key)
{return BacklightArray[ key ].BacklightStates;
}

以上代码并不是在一个文件中，只是为了方便，放在一起，大家可以根据函数名在官方例程中搜索获取更多信息。

官方例程基本上拿过来就能使用，不需要作太多的修改，所以对例程中的代码我们不会作过多的讲解，事实上只要把触摸按键的几个数据结构弄清楚了，代码基本上也就明明白白了。

比如以下几个数据结构：


touch_button_cfg_t p_selfkey = 
{.num_elements = TOUCH_KEY_ELEMENTS,.p_elem_index = touch_key_ch,.p_stbtn = s_tBtn
};touch_cfg_t touch_cfg = 
{.touch_button_cfg = &p_selfkey,.touch_slider_cfg = NULL,.touch_wheel_cfg = NULL
};typedef struct
{uint8_t maxQueueNum;				    //--测试队列数量--uint8_t singlePressMod;                	//--单按键模式---uint8_t shieldEn;                   	//--屏蔽使能---uint8_t filterMode;				        //--滤波器模式--uint8_t filterGrade;				    //--滤波器等级--uint8_t peakQueueNum;                	//--按键最大偏移队列---uint8_t peakQueueOffset;             	//--按键最大偏移队列的偏移值---uint8_t baseRefreshOnPress;			    //--基线在按键按下时是否进行--uint8_t baseUpRefreshDouble;        	//--基线向上刷新倍速参数---uint8_t baseDownRefreshSlow;       		//--基线向下更新降速参数---uint8_t rfu[2];uint32_t baseRefreshSampleNum;     		//--基线刷新采样次数--uint32_t *tkyBufP;					 	//--测试通道数据缓冲区指针--
}TKY_BaseInitTypeDef;typedef struct
{uint8_t queueNum;                 		//--该通道在测试队列的序号--uint8_t channelNum;               		//--该通道对应的ADC通道标号--uint16_t chargeTime;		            //--该通道充电时间--uint16_t disChargeTime;            		//--该通道放电时间--uint16_t baseLine;  	   	        	//--基线--uint16_t threshold;		            	//--阈值--uint16_t threshold2;              		//--阈值2--uint8_t sleepStatus;		          	//--休眠--
}TKY_ChannelInitTypeDef;

三、触摸通道的修改

官方例程中提供了8个触摸通道，我们实际应用中往往需要修改这部分内容来满足我们的项目需要。

比如我们的项目需要12个触摸按键，而且触摸通道的顺序也可能与例程中不一样。

根据项目实际需要的触摸按键数量修改就可以。

这里需要根据实际需要的触摸按键数量修改数量并调整触摸序列与通道的对应关系。

TKY_Pin需要根据TKY_CHS_INIT中的通道的顺序调整。比如TKY_CHS_INIT中第一个的通道为ADC 0通道，对应的引脚为PA4，其余以此类推。

这段代码就是扫描后获取按键，并根据按键执行相应的动作，这里只是简单的点亮对应的LED指示灯。

对比前后两个项目，两篇博文，需要说明的是，CH584/CH585与CH582及CH592系列在引脚的功能方面有所区别，比如CH584/CH585的ADC通道全部为PA引脚上，而CH582及CH592系列的ADC通道分布在PA及PB引脚上，所以在触摸按键的数据结构及代码中涉及到这点的地方要注意区别。

四、完整代码请参考：

CH584/CH585触摸按键Touchkey功能12触摸按键功能演示程序资源-CSDN下载

http://www.xdnf.cn/news/19444.html

相关文章：

  • 【Zephyr炸裂知识系列】11_手撸内存泄露监测算法
  • Pomian语言处理器研发笔记（二）：使用组合模式定义表示程序结构的语法树
  • Tiptrans转运 | 免费5国转运地址
  • Web网络开发 -- jQuery框架
  • REST-assured 接口测试编写指南
  • 【Canvas与戳记】蓝底黄面十六角Premium Quality戳记
  • 开发环境全面配置指南：语言环境与数据库工具
  • 基于单片机音乐喷泉/音乐流水灯/音乐播放器设计
  • 规律作息 + 养成好的习惯 + 考研倒计时 111 天 + 线面积分入门 1 下半部分
  • 【LeetCode - 每日1题】鲜花游戏
  • 2025年- H101-Lc209--1979.找出数组的最大公约数(gcd最大公约数)--Java版
  • 【物联网】MQTT（Message Queuing Telemetry Transport）是什么？
  • 深入解析 dex2oat：vdex、cdex、dex 格式转换全流程实战
  • RK3576开发板串口配置及使用
  • 使用 SVM（支持向量机）进行图像分类：从读取图像到训练与分类的完整流程
  • 深入解析Nginx常见模块2
  • 【SoC】【W800】基于W800的PWM实现
  • python pyqt5开发DoIP上位机【源码】
  • 合集：搭建wiki知识库
  • C++广度优先搜索
  • React Native基本用法
  • 从支付工具到收益资产：稳定币在 Berachain 上的二次进化
  • 四、GC 垃圾回收（二）
  • 小模型 vs 大模型：企业 AI 落地的成本、性能与场景适配选择
  • 广东省省考备考（第九十天8.30）——判断推理（第十节课）
  • 企业为什么需要部署数据防泄露系统？
  • 第三十一天：数列求和取模
  • C++讲解---如何设计一个类
  • 【lua】模块基础及应用
  • LED灯带离线语音控制方案WTK6900P