深入解析NXP Kinetis TSIv4电容触摸驱动：从原理到实战配置

1. 项目概述：从零开始理解Kinetis TSIv4触摸感应驱动

在嵌入式人机交互设计中，电容式触摸感应技术因其无需物理按键、高可靠性、防水防尘等优势，已经成为许多消费电子、工业控制和家电产品的首选方案。我接触过不少触摸感应方案，从早期的专用触摸芯片到如今集成在MCU内部的触摸感应模块（TSI），技术演进让设计变得更加灵活和低成本。NXP Kinetis系列微控制器集成的TSI模块，特别是第四代版本（TSIv4），在灵敏度、抗干扰和功耗控制上都有显著提升，但要把这套硬件用起来、用得好，离不开一个设计精良的软件驱动。

Kinetis SDK v2.0中提供的TSIv4驱动库，就是这样一个将复杂硬件操作封装成清晰API的桥梁。它把电极扫描、噪声抑制、阈值比较、中断处理这些底层细节都打包好了，开发者只需要调用TSI_Init、TSI_Configure、TSI_Calibrate等函数，就能快速搭建起一个稳定的触摸检测系统。不过，官方API手册往往只告诉你“有什么”和“怎么用”，很少深入解释“为什么这么用”以及“用的时候要注意什么”。我在实际项目中踩过不少坑，比如电极走线不当引入的噪声、环境温湿度变化导致的基线漂移、低功耗模式下灵敏度下降等问题，这些经验教训在标准文档里是找不到的。

这篇文章，我就结合自己多年在Kinetis平台上的开发经验，带你彻底吃透TSIv4驱动。我会从电容感应的基本原理讲起，拆解TSI模块的工作机制，然后一步步分析SDK中每个关键API的设计意图、参数配置的底层逻辑，最后分享一套经过实战检验的配置流程和调试技巧。无论你是刚接触触摸感应的新手，还是想优化现有方案的老手，相信都能从中获得实用的参考。

2. 电容式触摸感应核心原理与TSI模块工作机制

要玩转TSI驱动，不能只停留在API调用的层面，必须理解其背后的物理原理和硬件机制。电容式触摸感应的核心，是检测由人体手指接近或接触所引起的电极对地电容的微小变化。这个变化量通常只有几个皮法（pF），在复杂的电磁环境中，如何稳定、准确地捕捉到这个信号，就是TSI模块要解决的核心问题。

2.1 电荷转移与RC振荡：电容值如何被“数”出来

TSI模块本质上是一个精密的电容-数字转换器。它采用了一种基于弛张振荡器的测量原理。每个触摸电极与MCU的一个TSI通道引脚相连，该引脚内部连接着一个可编程电流源、一个电压比较器以及一个计数器。其工作周期可以简化为两个阶段：充电阶段和放电（或测量）阶段。

在充电阶段，内部电流源以设定的电荷电流（由EXTCHRG参数控制）向电极电容充电，使其电压上升到某个参考阈值。在放电/测量阶段，电极通过一个已知的电阻放电，同时一个由参考时钟驱动的计数器开始计数。电极电容越大，充放电所需的时间就越长，计数器累加的数值也就越高。因此，最终的计数值（通过TSI_GetCounter读取）直接反映了电极电容的大小。当手指靠近时，电极对地电容增加，导致充放电时间变长，计数值相应上升。通过监测这个计数值相对于静态基线值（无触摸时的值）的变化，就能判断触摸事件是否发生。

关键理解：TSI_GetCounter返回的数值不是一个直接的电容值，而是一个与电容和充放电电流相关的时间积分量。这就是为什么调整extchrg（电极充电电流）和refchrg（参考充电电流）会直接影响计数范围和灵敏度。电流越大，充放电越快，计数值越小，系统响应速度越快，但分辨率和抗噪声能力可能会下降。

2.2 TSIv4模块的架构与关键寄存器剖析

Kinetis的TSIv4模块比前几代更为复杂和强大，其寄存器配置主要集中在TSI_GENCS（通用控制和状态）、TSI_DATA（数据）、TSI_TSHD（阈值）等寄存器中。SDK驱动库通过tsi_config_t结构体封装了这些寄存器的关键字段，让我们无需直接操作底层寄存器。

• 扫描控制：nscn（扫描次数）参数决定了每个电极在一次测量中进行多少次连续的充放电循环。增加扫描次数可以对计数值进行硬件平均，有效抑制随机噪声，提高信噪比，但代价是单次测量时间变长。例如，在噪声较大的环境中，将nscn设置为kTSI_ConsecutiveScansNumber_16time或更高，可以显著稳定读数。
• 噪声抑制机制：这是TSIv4的亮点。mode（模拟模式）参数提供了多种选择：
  • kTSI_AnalogModeSel_Capacitive：标准电容传感模式。
  • kTSI_AnalogModeSel_AutoNoise：自动噪声检测模式，模块能自动识别并抑制特定频段的噪声。
  • kTSI_AnalogModeSel_NoiseNoFreqLim/kTSI_AnalogModeSel_NoiseFreqLim：主动噪声检测模式，结合filter（滤波器位数）和resistor（串联电阻）参数，可以构建硬件滤波器。filterbits决定了需要多少个连续的噪声峰值才能触发一次计数递增，这相当于一个数字滤波器，能滤除毛刺。
• 功耗与性能平衡：prescaler（电极振荡器预分频器）和dvolt（振荡器电压轨）直接影响模块的功耗和灵敏度。较高的预分频（如kTSI_ElecOscPrescaler_128div）和较低的电压轨可以大幅降低运行功耗，适用于电池供电设备，但可能会牺牲一些响应速度。在低功耗模式下（通过TSI_EnableLowPower使能），模块可以配合MCU的STOP模式工作，仅以极低的功耗周期性地扫描电极，实现触摸唤醒。

2.3 驱动层抽象：SDK如何封装硬件复杂性

SDK的TSIv4驱动采用了典型的分层设计。最底层是硬件抽象层（HAL），直接操作TSI_Type类型的寄存器指针。中间层是驱动功能层，提供了我们使用的所有TSI_开头的API。这些API主要分为三类：

1. 初始化与配置类：如TSI_Init,TSI_GetNormalModeDefaultConfig，负责模块的初始状态设定。
2. 控制与状态类：如TSI_EnableModule,TSI_StartSoftwareTrigger,TSI_GetStatusFlags，控制扫描流程和获取状态。
3. 数据处理类：如TSI_GetCounter,TSI_Calibrate，获取原始数据并进行前期处理。

驱动库通过大量的static inline函数将简单的寄存器操作内联，减少了函数调用开销，这对于需要快速响应的触摸检测尤为重要。同时，它通过tsi_config_t结构体提供了一套完整的配置方案，开发者无需关心GENCS寄存器中某个比特位的具体位置，只需给结构体成员赋值即可。

3. 关键API深度解析与实战配置指南

官方手册列出了所有函数，但并没有告诉你哪些是核心，参数该如何选取。下面我结合代码，重点剖析几个最常用、也最容易用错的API，并给出具体的配置建议。

3.1 初始化与配置：TSI_Init与TSI_GetDefaultConfig

一切始于初始化。TSI_GetNormalModeDefaultConfig函数会填充一个默认的配置结构体。强烈建议以这个默认配置为起点进行修改，而不是自己从零构建一个结构体。我们来看看默认值及其含义：

userConfig->prescaler = kTSI_ElecOscPrescaler_2div; // 电极振荡器2分频 userConfig->extchrg = kTSI_ExtOscChargeCurrent_4uA; // 电极充电电流4uA userConfig->refchrg = kTSI_RefOscChargeCurrent_4uA; // 参考充电电流4uA userConfig->nscn = kTSI_ConsecutiveScansNumber_10time; // 扫描10次 userConfig->mode = kTSI_AnalogModeSel_Capacitive; // 电容传感模式 userConfig->dvolt = kTSI_OscVolRailsOption_0; // 电压轨选项0 userConfig->resistor = kTSI_SeriesResistance_32k; // 32k串联电阻 userConfig->filter = kTSI_FilterBits_1; // 1个滤波器位 userConfig->thresh = 0U; // 高阈值 userConfig->thresl = 0U; // 低阈值

这个默认配置是一个比较保守的、兼顾性能和功耗的起点。但在实际项目中，几乎都需要调整：

• extchrg和refchrg：这是灵敏度调节的关键。增大电流（如设为kTSI_ExtOscChargeCurrent_16uA）可以降低计数值，提高响应速度，但可能使系统更容易饱和（计数值达到最大值65535）。通常建议在电极电容较大（如使用厚面板或长走线）时增大电流，在电极电容较小或需要高分辨率时减小电流。一个实用的技巧：先用默认电流测试，观察无触摸时的基线计数值，理想情况下基线值应在满量程的20%~80%之间。如果基线值太低（如<1000），可适当减小电流；如果太高（如>50000），应增大电流。
• nscn：这是抗噪声能力与响应速度的权衡。扫描次数越多，单次测量时间T_scan = nscn * (充电时间 + 放电时间)越长。在典型的16uA电流、中等电容下，单次扫描可能需几十微秒。10次扫描意味着一次完整测量需要几百微秒。对于需要快速触摸响应的应用（如滑动），可以降低到4-5次；对于静态按键且在噪声环境中的应用，可以增加到16-32次。
• mode和filter：在强噪声环境（如电机旁、开关电源附近）中，仅靠增加nscn可能不够。此时应将mode设置为kTSI_AnalogModeSel_AutoNoise或噪声检测模式，并调整filter。filter设置为kTSI_FilterBits_3时，需要8个连续的噪声峰值才会计数一次，可以极好地抑制突发性窄脉冲噪声。

初始化配置完成后，调用TSI_Init(TSI0, &userConfig)，驱动就会将这些参数写入硬件寄存器。这里有一个极易忽略的细节：TSI_Init函数并不会使能模块（TSIEN位），需要后续手动调用TSI_EnableModule(TSI0, true)。这种设计给了开发者更灵活的控制时机。

3.2 校准与基线管理：TSI_Calibrate的精髓

校准是触摸感应稳定工作的基石。TSI_Calibrate函数的作用是获取当前环境下所有使能电极的静态计数值（即基线），并将其存储在提供的缓冲区中。很多新手会误以为校准只需要在上电时做一次，其实不然。

tsi_calibration_data_t calData; TSI_Calibrate(TSI0, &calData);

执行这段代码后，calData.calibratedData[channel]中就保存了对应通道的基线值。正确的用法是：

1. 上电后，系统稳定时（延时几百毫秒后）进行首次校准，以消除上电瞬态和硬件稳定的影响。
2. 将校准值保存下来，作为判断触摸的参考基准。触摸判断的逻辑通常是：当前计数值 - 基线值 > 触发阈值。
3. 实现动态基线跟踪。环境温湿度变化、器件老化都会导致基线缓慢漂移。一个健壮的系统不应该使用固定的初始基线。我的做法是，在确认无触摸的状态下（例如，连续多次检测均无触摸，且持续一段时间），缓慢地更新基线值，例如：新基线 = 旧基线 * 0.99 + 当前值 * 0.01。这种一阶低通滤波可以跟踪缓慢漂移，又不会被瞬时噪声或误触摸干扰。

严重警告：切勿在循环中频繁调用TSI_Calibrate！这个函数会执行一次完整的扫描来获取数据，如果频繁调用，会严重干扰正常的触摸检测流程，并可能引入不可预知的状态错误。校准应是一个偶尔发生的、受控的事件。

3.3 扫描触发与数据获取：中断与轮询模式选择

TSI支持两种扫描触发方式：软件触发和硬件触发。TSI_EnableHardwareTriggerScan函数用于切换。对于大多数自主控制的触摸应用，软件触发更为简单直接。

轮询模式是最基础的用法，流程清晰：

TSI_StartSoftwareTrigger(TSI0); // 启动一次扫描 while(!(TSI_GetStatusFlags(TSI0) & kTSI_EndOfScanFlag)); // 等待扫描完成 uint16_t count = TSI_GetCounter(TSI0); // 读取计数值 TSI_ClearStatusFlags(TSI0, kTSI_EndOfScanFlag); // 清除标志位 // ... 处理count值，判断触摸

这种方式简单，但CPU需要忙等待，效率低。

中断模式是更高效的选择，尤其适合低功耗或需要同时处理其他任务的系统：

// 初始化时使能中断 TSI_EnableInterrupts(TSI0, kTSI_EndOfScanInterruptEnable); NVIC_EnableIRQ(TSI0_IRQn); // 在中断服务函数中 void TSI0_IRQHandler(void) { if (TSI_GetStatusFlags(TSI0) & kTSI_EndOfScanFlag) { uint16_t touchData = TSI_GetCounter(TSI0); TSI_ClearStatusFlags(TSI0, kTSI_EndOfScanFlag); // 将数据放入队列或设置标志，在主循环中处理 g_tsiDataReady = true; g_tsiLatestCount = touchData; } } // 主循环中，启动一次扫描后即可去做其他事情 TSI_StartSoftwareTrigger(TSI0); while(1) { if(g_tsiDataReady) { processTouchData(g_tsiLatestCount); g_tsiDataReady = false; // 如果需要连续检测，可以在这里再次启动扫描 TSI_StartSoftwareTrigger(TSI0); } // ... 其他任务 }

中断模式将CPU从等待中解放出来。关键点：在中断服务程序（ISR）中，处理应尽可能快，只做最简单的数据读取和标志设置，复杂的算法（如滤波、阈值判断、手势识别）应放到主循环中。

3.4 多通道扫描与通道切换策略

一个TSI模块通常支持多个通道（例如16个）。TSI_SetMeasuredChannelNumber函数用于切换当前测量的通道。实现多按键或滑条的关键在于分时复用。

一个典型的轮询扫描所有通道的流程如下：

#define TOUCH_CHANNEL_NUM 4 uint8_t channels[TOUCH_CHANNEL_NUM] = {0, 1, 2, 3}; // 使能的通道号 uint16_t baseline[TOUCH_CHANNEL_NUM]; // 各通道基线 uint16_t currentData[TOUCH_CHANNEL_NUM]; // 当前数据 bool touchState[TOUCH_CHANNEL_NUM]; // 触摸状态 void scanAllChannels(void) { for (int i = 0; i < TOUCH_CHANNEL_NUM; i++) { TSI_SetMeasuredChannelNumber(TSI0, channels[i]); // 切换到通道i TSI_StartSoftwareTrigger(TSI0); while(!(TSI_GetStatusFlags(TSI0) & kTSI_EndOfScanFlag)); currentData[i] = TSI_GetCounter(TSI0); TSI_ClearStatusFlags(TSI0, kTSI_EndOfScanFlag); // 简单的阈值判断 if ((currentData[i] - baseline[i]) > TOUCH_THRESHOLD) { touchState[i] = true; } else { touchState[i] = false; } } }

这里有一个重要的时序问题：通道切换后，需要给硬件一点稳定时间才能开始新的扫描，尤其是在通道间寄生电容差异较大时。我建议在TSI_SetMeasuredChannelNumber后，至少插入几个空指令（__NOP()）或一个短暂的延时（1-2us），再进行TSI_StartSoftwareTrigger。

对于滑条或滚轮（Slider/Wheel）应用，需要将多个电极排列成线性或圆形，通过检测相邻电极信号强度的比例来计算触摸位置。这需要更高的扫描速率和更精密的算法，通常需要用到所有API的配合，并可能需要在中断中快速完成多个通道的扫描和数据处理。

4. 从零构建一个健壮的触摸按键系统：实战步骤

理解了单个API后，我们将其串联起来，构建一个完整的、抗干扰的触摸按键系统。假设我们需要实现4个触摸按键。

4.1 硬件设计与PCB布局要点

在写代码之前，硬件设计决定了性能上限：

• 电极形状与大小：通常使用直径10-15mm的实心圆或正方形覆铜。面积越大，电容变化量越大，信噪比越高。
• 走线：电极到MCU引脚的走线应尽量短、等长（对于多按键），并用地线包围或采用夹层走线（在两层板中，走在底层，顶层用接地铜箔屏蔽）以减少噪声耦合。绝对避免与高频、大电流信号线平行走线。
• 覆盖介质：面板材质（玻璃、亚克力）和厚度直接影响灵敏度。厚度增加，灵敏度下降。通常需要根据面板厚度（如3-5mm）来调整驱动参数（如增大extchrg电流）。
• 接地与屏蔽：在电极周围布置良好的接地网格，可以有效屏蔽空间噪声。如果条件允许，在电极背面（非触摸面）增加一个接地的屏蔽层，可以显著提高抗干扰能力。

4.2 软件初始化与校准流程

以下是系统初始化阶段的完整代码框架，包含了错误处理和稳健性设计：

// 定义触摸通道和全局变量 #define TOUCH_CHANNEL_COUNT 4 #define TOUCH_THRESHOLD 150 // 触发阈值，需根据实测调整 #define BASELINE_ALPHA 0.01f // 基线跟踪滤波系数 typedef struct { uint16_t baseline; uint16_t current; uint16_t filtered; // 滤波后数据 bool isTouched; uint32_t stableCount; // 用于判断稳定无触摸状态 } touch_channel_t; touch_channel_t g_touchChannels[TOUCH_CHANNEL_COUNT]; const uint8_t g_touchChannelList[TOUCH_CHANNEL_COUNT] = {5, 6, 7, 8}; // 实际使用的TSI通道号 status_t TSI_Init_MyApplication(void) { tsi_config_t tsiConfig; tsi_calibration_data_t calData; // 1. 获取默认配置并针对性修改 TSI_GetNormalModeDefaultConfig(&tsiConfig); tsiConfig.extchrg = kTSI_ExtOscChargeCurrent_8uA; // 根据PCB实测调整 tsiConfig.refchrg = kTSI_RefOscChargeCurrent_8uA; tsiConfig.nscn = kTSI_ConsecutiveScansNumber_16time; // 提高抗噪性 tsiConfig.mode = kTSI_AnalogModeSel_Capacitive; // 常规应用电容模式即可 tsiConfig.filter = kTSI_FilterBits_2; // 中等滤波强度 // 2. 初始化TSI硬件 TSI_Init(TSI0, &tsiConfig); // 3. 使能模块 TSI_EnableModule(TSI0, true); // 4. 上电后等待系统稳定（特别是外部振荡器） SDK_DelayAtLeastUs(100000, CLOCK_GetFreq(kCLOCK_CoreSysClk)); // 延时100ms // 5. 执行初始校准 for (int i = 0; i < TOUCH_CHANNEL_COUNT; i++) { TSI_SetMeasuredChannelNumber(TSI0, g_touchChannelList[i]); SDK_DelayAtLeastUs(10, CLOCK_GetFreq(kCLOCK_CoreSysClk)); // 通道切换后短暂稳定 TSI_Calibrate(TSI0, &calData); g_touchChannels[i].baseline = calData.calibratedData[g_touchChannelList[i]]; g_touchChannels[i].filtered = g_touchChannels[i].baseline; g_touchChannels[i].isTouched = false; g_touchChannels[i].stableCount = 0; PRINTF("Channel %d baseline: %d\r\n", g_touchChannelList[i], g_touchChannels[i].baseline); } // 6. 配置并使能中断（如果使用中断模式） TSI_EnableInterrupts(TSI0, kTSI_EndOfScanInterruptEnable); NVIC_SetPriority(TSI0_IRQn, 3); // 设置合适的中断优先级 NVIC_EnableIRQ(TSI0_IRQn); return kStatus_Success; }

4.3 主循环中的触摸检测与滤波算法

在主循环或定时中断中，我们需要周期性地扫描所有通道，并应用数字滤波算法以稳定数据：

void TSI_ScanAllChannels_Polling(void) { static uint8_t currentChannelIndex = 0; uint16_t rawCount; // 切换到下一个通道 TSI_SetMeasuredChannelNumber(TSI0, g_touchChannelList[currentChannelIndex]); __NOP(); __NOP(); __NOP(); __NOP(); // 简短稳定延时 // 启动扫描并等待完成 TSI_StartSoftwareTrigger(TSI0); while (!(TSI_GetStatusFlags(TSI0) & kTSI_EndOfScanFlag)) { // 可以在这里加入超时机制，防止硬件卡死 } rawCount = TSI_GetCounter(TSI0); TSI_ClearStatusFlags(TSI0, kTSI_EndOfScanFlag); // 处理当前通道数据 processTouchData(currentChannelIndex, rawCount); // 更新通道索引，准备扫描下一个 currentChannelIndex++; if (currentChannelIndex >= TOUCH_CHANNEL_COUNT) { currentChannelIndex = 0; } } void processTouchData(uint8_t chIndex, uint16_t rawData) { touch_channel_t *pCh = &g_touchChannels[chIndex]; // 1. 一阶低通滤波，平滑原始数据 pCh->filtered = (uint16_t)((1.0f - BASELINE_ALPHA) * pCh->filtered + BASELINE_ALPHA * rawData); pCh->current = pCh->filtered; // 使用滤波后的数据 // 2. 动态基线跟踪（仅在稳定无触摸时） if (!pCh->isTouched) { pCh->stableCount++; if (pCh->stableCount > 1000) { // 连续1000次扫描无触摸，认为环境稳定 // 非常缓慢地更新基线，跟踪长期漂移 pCh->baseline = (uint16_t)(0.999f * pCh->baseline + 0.001f * pCh->current); pCh->stableCount = 1000; // 防止溢出 } } // 3. 触摸判断（带滞回的比较，防止抖动） int16_t delta = (int16_t)(pCh->current - pCh->baseline); if (delta > TOUCH_THRESHOLD) { if (!pCh->isTouched) { pCh->isTouched = true; pCh->stableCount = 0; // 触发触摸按下事件 onTouchDown(chIndex, pCh->current); } } else if (delta < (TOUCH_THRESHOLD * 0.7)) { // 释放阈值设为触发阈值的70%，形成滞回 if (pCh->isTouched) { pCh->isTouched = false; // 触发触摸释放事件 onTouchUp(chIndex); } } // 4. （可选）输出调试信息 #ifdef TOUCH_DEBUG if (chIndex == 0) { // 仅打印通道0的数据，避免输出过多 PRINTF("Ch%d: Raw=%d, Filt=%d, Base=%d, Delta=%d, State=%d\r\n", chIndex, rawData, pCh->current, pCh->baseline, delta, pCh->isTouched); } #endif }

这个处理流程包含了几个关键技巧：

1. 软件滤波：一阶低通滤波能有效抑制高频噪声，BASELINE_ALPHA系数越小，滤波效果越强，但响应越慢。
2. 动态基线：基线不是固定的，会在无触摸时缓慢跟踪环境变化，这是应对温漂和老化的重要手段。
3. 滞回比较：使用不同的按下和释放阈值，可以防止在阈值附近因噪声导致的触摸状态抖动。
4. 分时扫描与状态机：通过currentChannelIndex轮流扫描各通道，结合每个通道独立的状态机，实现了多按键检测。

4.4 低功耗模式下的触摸唤醒实现

对于电池供电设备，功耗至关重要。TSI模块支持在MCU的STOP模式下运行，并以低功耗定时器（LPTMR）或TSI自身的定时扫描来周期性地检测触摸，实现触摸唤醒。

void enterLowPowerTouchWakeupMode(void) { tsi_config_t tsiConfig; // 1. 配置为低功耗模式参数（更高的扫描次数、更低的电流可能更省电） TSI_GetLowPowerModeDefaultConfig(&tsiConfig); // 低功耗模式默认阈值thresh=400，可根据需要调整 tsiConfig.thresh = 300; // 唤醒阈值 tsiConfig.thresl = 0; tsiConfig.nscn = kTSI_ConsecutiveScansNumber_32time; // 更多次数平均噪声 // 重新初始化TSI（或使用TSI_SetLowThreshold/HighThreshold动态修改） TSI_Init(TSI0, &tsiConfig); // 2. 使能低功耗模式功能 TSI_EnableLowPower(TSI0, true); // 3. 使能硬件触发扫描（如果需要由LPTMR周期性触发） // TSI_EnableHardwareTriggerScan(TSI0, true); // 配置LPTMR定时触发TSI扫描... // 4. 使能超出阈值中断（用于唤醒） TSI_EnableInterrupts(TSI0, kTSI_OutOfRangeInterruptEnable | kTSI_GlobalInterruptEnable); // 5. 使能模块并进入STOP模式 TSI_EnableModule(TSI0, true); POWER_EnterStop(); // 进入低功耗STOP模式 // 6. 当有触摸导致计数值超出阈值时，MCU被唤醒，执行此处 // 首先检查是否是TSI唤醒 if (TSI_GetStatusFlags(TSI0) & kTSI_OutOfRangeFlag) { TSI_ClearStatusFlags(TSI0, kTSI_OutOfRangeFlag); // 切换到正常扫描模式，进行精确的触摸检测和通道判别 switchToNormalMode(); processWakeupTouch(); } }

在低功耗模式下，为了省电，扫描间隔可以设置得比较长（如100ms一次）。但要注意，过长的间隔会降低触摸响应的实时性。此外，低功耗模式下的扫描参数（如电流、扫描次数）可能与正常模式不同，需要在灵敏度和功耗间仔细权衡。唤醒后，通常需要重新初始化TSI到正常模式，并进行一次完整的扫描来确定是哪个通道被触摸。

5. 常见问题排查与性能优化经验录

即使按照手册配置，在实际项目中还是会遇到各种奇怪的问题。下面是我总结的一些典型问题及其解决方法。

5.1 灵敏度不足或过高

现象：手指触摸时计数值变化很小（灵敏度不足），或者没触摸时计数值就很大且波动（灵敏度过高，易误触发）。

• 排查步骤：
  1. 检查电极和走线：用万用表测量电极对地电容。一个设计良好的电极，对地电容通常在10-50pF之间。如果远小于10pF，可能是电极面积太小或走线太细；如果远大于100pF，可能是走线过长或有寄生电容。
  2. 调整充电电流：这是最有效的调节手段。灵敏度不足，首先尝试减小extchrg电流（例如从4uA调到2uA或1uA），这会使充放电变慢，同样的电容变化引起的计数值变化更大。灵敏度过高，则增大电流。
  3. 检查参考电流：refchrg电流一般与extchrg设为相同值即可。在某些型号的MCU上，两者的比例会影响内部比较器的精度，可参考具体芯片的参考手册。
  4. 调整扫描次数：增加nscn可以通过平均效应提高信噪比，让微弱的信号变化更明显，但不会改变信号本身的大小。它改善的是稳定性，而非绝对灵敏度。
  5. 检查覆盖面板：面板过厚或材质介电常数过低会大幅衰减电场。可以尝试直接触摸PCB上的电极（注意防静电），如果灵敏度正常，问题就在面板上。

5.2 读数不稳定，波动大

现象：无触摸时，计数值也在一定范围内随机跳动。

• 排查步骤：
  1. 电源噪声：这是最常见的原因。确保MCU的模拟电源（VDDA）和数字电源（VDD）干净，纹波小。在电源引脚就近放置一个10uF电解电容并联一个100nF陶瓷电容。如果问题依旧，可以尝试在代码中短暂关闭其他高功耗外设（如PWM、高速ADC）再进行TSI采样，看波动是否减小。
  2. 开启噪声抑制模式：将mode改为kTSI_AnalogModeSel_AutoNoise。如果硬件支持且噪声有特定特征，此模式效果显著。
  3. 调整滤波器：增大filterbits。例如从kTSI_FilterBits_1改为kTSI_FilterBits_3，这要求更连续的噪声峰值才能计数，对突发噪声抑制效果好。
  4. 增加软件滤波：如4.3节所示，在软件中对连续多次采样值进行平均或低通滤波。这是最后一道防线，效果很好，但会引入延迟。
  5. 检查接地：确保触摸面板的接地良好，MCU的地与设备外壳地（如果适用）可靠连接。浮地系统更容易引入噪声。

5.3 通道间串扰

现象：触摸一个按键时，相邻通道的计数值也会发生明显变化。

• 原因与解决：
  1. PCB布局问题：电极间距太近。一般要求电极间距至少大于电极直径的20%。走线之间也应保持距离，最好用地线隔离。
  2. 软件补偿：如果硬件已无法修改，可以在软件中建立通道间串扰矩阵。例如，触摸通道i时，记录下通道j的变化量crosstalk[i][j]。在实际判断时，将通道j的读数减去crosstalk[i][j] * 通道i的触摸强度，进行软件补偿。这种方法计算量稍大，但能有效改善体验。
  3. 分时扫描延时不足：如3.4节所述，切换通道后立即扫描，前一个通道的电荷可能没有完全泄放，影响本次测量。务必在TSI_SetMeasuredChannelNumber后增加足够的稳定延时（几个微秒）。

5.4 低功耗模式下无法唤醒或误唤醒

现象：设备进入STOP模式后，触摸无法唤醒，或者没有触摸时自己唤醒。

• 排查步骤：
  1. 确认唤醒源：首先在唤醒后检查TSI_GetStatusFlags，确认是否是kTSI_OutOfRangeFlag置位。如果不是，可能是其他中断源（如GPIO、RTC）导致的唤醒。
  2. 检查阈值设置：低功耗模式下的阈值thresh设置非常关键。它应该比正常模式下的触发阈值更“宽松”一些，以确保能可靠唤醒，但又不能太接近基线值导致误唤醒。建议通过实验确定：在STOP模式前，读取并打印各通道的基线值，然后将thresh设置为基线值 + 50~100（具体值需测试）。
  3. 检查低功耗模式配置：确认TSI_EnableLowPower已调用且参数正确。有些MCU在STOP模式下外设时钟会关闭或分频，需要确认TSI的时钟源（如内部慢速时钟）在STOP模式下仍然有效。
  4. STOP模式下的噪声：MCU在STOP模式下，其他数字电路噪声降低，但模拟部分可能对噪声更敏感。可以尝试在进入STOP前，将nscn设得更大，并使用更强的filter设置。

5.5 性能优化速查表

最后，分享一个调试黄金法则：使用调试器或串口实时打印出每个通道的原始计数值、滤波后值、基线值和差值。将手指触摸、离开、长时间按压、快速滑动等各种情况下的数据变化记录下来，绘制成图表。数据不会说谎，它能最直观地告诉你系统究竟在“想”什么，帮助你精准定位问题是硬件布局、参数配置还是软件算法的问题。