中微爱芯触摸软件调试指南

中微爱芯为AiP8F3XXX系列芯片提供一个可以供客户观察和调试触摸参数的软件，以降低用户触控按键部分的开发难度。用户仅仅需要经过以下几个步骤，便可实现触控按键的功能，通过CS静态和动态实验。

步骤说明：

1、 将开发板与iLink-V3仿真器硬件连接；

2、 安装PC端触摸调试软件iView-TK并加载触摸调试库文件；

3、 使能iLink供电并点击iView-TK软件中的“打开设备”和“继续接收”；

4、 观察界面中的触摸“滤波值”、“基线值”、“差值”和“噪声值”；

5、 将参数写入对应的触摸库配置文件中；

6、 触摸调试完成。

1. 触摸调试软件使用步骤

1.1 硬件连接

电脑USB→iLink-V3仿真器VDD/SCK/SDA/GND) →芯片(VDD/OC_CLK/OC_SDA/GND)。

触摸demo板PCB

 iLink-V3 背面

iLink-V3 侧面 

连线具体示意。

注意：仿真器必须是iLink-V2及其以上版本。

触摸调试通信引脚为OC_CLK、OC_SDA 两个引脚。故触摸软件调试时，这两个引脚上的触摸功能采用标准库是无法调试的，需要额外修改通信端口才可调试，具体操作参考1.6中OC_CLK、OC_SDA端口触摸调试。

1.2 安装PC端软件

双击“iView-TK.exe”软件，打开软件界面。

1.3 触摸调试库文件加载

在“触摸调试库文件”中获取触摸调试库文件“IcoreTKDebug.c”和“IcoreTKDebug.h”

在当前的项目工程中，添加“IcoreTKDebug.c”和“IcoreTKDebug.h”

在main.c文件中，添加头文件"IcoreTKDebug.h"。

格式为：#include "IcoreTKDebug.h"。

在main函数中添加调试函数TK_FrameSender，并将TK_DEBUG_ENABLE设置为1，使能触摸数据调试。

 

使能需要调试的触摸通道，并设置触摸初始参数。将需要测试的触摸通道设置1，同时将所有按键的初始阈值TKx_FINGER_THRESHOLD和噪声值C_SetNoiseThreshold设置为 60和20，其他采用默认值。

 

 

点击“build”和“load”将设置好的调试程序下载到芯片中。

1.4 触摸测试步骤

第一步：保持芯片与仿真器（VDD/SCK/SDA/GND 四根线都不能断开）的连接。

第二步：使能ilink供电，勾选Reset and Run。

 

第三步：

①点击iView-TK软件中的“打开设备”和“继续接收”，左侧“线段显示”显示当前打开的触摸按键个数，右侧“曲线显示”则会有相应按键的触摸数据波形输出。

②手指触摸相应的触摸按键面板，可观察界面中的触摸“滤波值”、“基线值”和“差值”的变化。（具体数值含义，查看1.5界面功能简介）。

③数据保存：用户点击“停止接收”和“导出数据”则可以将检测的数据以csv形式保存。

第四步：待用户触摸调试完成后，即可将上述调试过程中所用到的调试库文件和调试函数移除掉，这样可确保用户实际程序正常运行。

1.5 界面功能简介

曲线显示

数据显示

（1）区域1：设备型号。显示当前的设备状态

（2）区域2：线段显示。显示需要被测试的按键个数，用户通过勾选操作，对相应的按键进行开启/关闭显示。默认全部打开，当按键数特别多时，通过关闭某些按键显示，可将界面简洁化。

（3）区域3：显示方式。分为2种：曲线显示和数据显示。选择曲线显示，则界面显示数据曲线，可观察触摸数据前后变化曲线；选择数据显示，则界面不停刷新最新触摸数据，用户根据该触摸数据进行参数计算。

（4）区域4：坐标设置。一般默认勾选自动设置。

（5）区域5：曲线界面。显示所有按键的触摸数据曲线，可观察按键状态变化情况。 

基线值：当前外部环境值。

滤波值：所有按键检测到的真实值。

差值：人手触摸前后差值。

噪声值：人手没有触摸情况下的当前环境噪声。

1.6 OC_CLK、OC_SDA端口触摸功能调试方法

（1）根据项目需求，在IcoreTKDebug.C文件按中，用户将程序中的Port_I2CSCL、Port_I2CSDA配置为预留通信端口（如P40、P41）。

（2）将Port_I2CSDA_SETIN配置为Port_I2CSDA输入，同时开启该端口上拉电阻。

（3）将Port_I2CSDA_SETOUT配置为Port_I2CSDA输出。

（4）将Port_I2CSCL、Port_I2CSDA端口分别连接到仿真器SCK和SDA端口。

（5）重新按照1.4 触摸测试步骤 进行触摸数据调试。

默认通信引脚P10和P11

修改后通信引脚P40和P41

1.7 参数计算-AiP8F32XX系列

1.7.1 iView-TK软件显示通道与芯片触摸通道对应关系

芯片使能TK3，TK6，TK8共3个触摸通道，则iView-TK调试软件中按键1对应TK3，按键2对应TK6，按键3对应TK8，以此类推。

1.7.2 阈值计算

（1）初次调试，默认所有按键阀值(TKx_FINGER_THRESHOLD)为60。  

（2）实际调试，外部供电，手指触摸某一按键，触摸调试界面显示该按键触摸<差值>为X(下图），一般直接采用X（V1.5及以上库采用X，V1.0-V1.4库采用0.7*X）为该按键的触摸阈值，即TKx_FINGER_THRESHOLD。（软件库中已自动配置比例系数用于适应不同人的手指大小）。

V1.5及其以上库：

例如：手指触摸TK2按键，触摸调试界面显示该按键触摸差值为120，则TK2阈值

TK2_FINGER_THRESHOLD = 120。

V1.0-1.4库：

例如：手指触摸TK2按键，触摸调试界面显示该按键触摸差值为120，则TK2阈值TK2_FINGER_THRESHOLD = 120*0.7= 84。

（3）用户只需要设置实际使用的触摸通道阈值，其余没用到的可以是默认值60。

（4）所有实际使用的按键阈值必须不低于100。

 

1.7.3 噪声值计算

初次调试，默认噪声值（C_SetNoiseThreshold）为20。   

实际调试，无任何触摸情况下，观察触摸调试界面中噪声值变化，界面中显示最大噪声值为Y，则一般采用(Y+16)为C_SetNoiseThreshold的值。例如：触摸调试界面显示噪声值最大为15，则C_SetNoiseThreshold值=16+15 = 31。

噪声值必须小于阈值，建议小于1/2阈值，有利于触摸稳定性。

1.8 参数计算-AiP8F35XX系列

1.8.1 iView-TK软件显示通道与芯片触摸通道对应关系

芯片使能TK3，TK6，TK8共3个触摸通道，则iView-TK调试软件中按键1对应TK3，按键2对应TK6，按键3对应TK8，以此类推。

1.8.2 阈值计算

（1）初次调试，默认所有按键阀值(TKx_FINGER_THRESHOLD)为50。  

（2）实际调试，外部供电，手指触摸某一按键，触摸调试界面显示该按键触摸<差值>为X(下图），一般直接采用X为该按键的触摸阈值，即TKx_FINGER_THRESHOLD。(软件库中已自动配置比例系数用于适应不同人的手指大小)。

例如：手指触摸TK2按键，触摸调试界面显示该按键触摸差值为120，则TK2阈值TK2_FINGER_THRESHOLD = 120。

（3）用户只需要设置实际使用的触摸通道阈值，其余没用到的可以是默认值50。

1.8.3 噪声值计算

初次调试，默认噪声值（C_NOISE_VAL）为30。  

实际调试，无任何触摸情况下，观察触摸调试界面中噪声值变化，界面中显示最大噪声值为Y(下图)。

情况1：如果（Y*2）小于20，则C_NOISE_VAL设置为20。

情况2：如果（Y*2）大于等于20，则C_NOISE_VAL设置为（Y*2）。

例如：触摸调试界面中所有按键的<噪声值>最大值为2，则C_NOISE_VAL值=20。

2. 常见问题

提示“通道初始化失败，请检查MCU是否正常工作”

① 请检查所选用的IC型号与软件界面中的芯片是否一致。

② 仿真器必须是iLink-V2及其以上版本，iLink-V1.0版本不支持触摸调试。

③ 请检查iLink-V3工具中的VCC/SCK/SDA/GND是否与芯片的引脚是否连接正确。

④ 请检查是否外部上电。

⑤ 请检查SCK和SDA是否有其他异常操作。

⑥ 重新插拔USB。

⑦ 触摸通信引脚不能在中断中配置为输入口。

如需了解更多产品资讯，请联系我司授权代理商或销售工程师。

关于中微爱芯

无锡中微爱芯电子有限公司成立于2004年，是一家以集成电路设计、测试、方案开发、销售和服务为主的高新技术企业，是工信部认定的集成电路设计企业，是国家鼓励的重点集成电路设计企业。产品已形成MCU、LCD显示、LED显示、通用逻辑、信号链、马达&栅驱动、功率器件、电源、音响、遥控器、通信、配套等多个系列几千款产品，覆盖消费电子、网通产品、工业设备、新能源、汽车电子等多个领域。