基于NXP KL16Z自电容TSI的二维手势识别算法与工程实践

1. 项目概述与核心价值

在嵌入式人机交互领域，电容式触摸技术因其无需物理按键、设计灵活、用户体验好等优点，已成为主流选择。其中，自电容（Self-Capacitance）传感模式以其电路结构简单、对PCB布局要求相对宽松、易于在资源受限的MCU上实现而备受青睐，尤其适合成本敏感型应用。然而，将基础的触摸检测升级为能够识别方向性滑动、连续点击等复杂手势的二维交互系统，对算法设计和工程实现提出了更高要求。这不仅仅是检测“有无触摸”，更是要解读“触摸意图”。

NXP的KL16Z系列MCU，基于Arm Cortex-M0+内核，虽然定位为入门级产品，但其集成的触摸感应接口（TSI）模块为开发者提供了一个极具性价比的硬件平台。官方应用笔记AN13026及其附带的演示项目，正是瞄准了这一痛点：如何在KL16Z这类资源有限的MCU上，不依赖昂贵的外部触摸控制器，仅凭自电容通道和精心设计的算法，实现稳定、可靠的二维手势识别。这个项目对于从事家电控制面板、智能家居交互、便携式设备界面开发的工程师而言，具有很高的参考价值。它完整地展示了一个从原始电容信号采集、坐标计算到最终手势判决的嵌入式系统闭环，其中涉及的“乒乓缓冲区”管理、自适应校准、基于状态机的事件处理等思想，是构建鲁棒性触摸应用的通用方法论。

2. 硬件平台与自电容传感原理

2.1 KL16Z MCU与TSI模块简介

MKL16Z64VFT4是本次演示的核心，它拥有48MHz主频、64KB Flash和8KB RAM。其集成的TSI模块是实现触摸功能的关键。TSI模块通过周期性对电极进行充放电，并测量其达到特定阈值所需的时间或振荡次数，从而间接测量电极对地的电容值。当手指靠近或触摸电极时，会引入额外的对地电容，导致测量值发生变化，TSI模块便能检测到这一“差异”。

自电容模式测量的是单个电极与系统参考地之间的电容。其优点是灵敏度高，电路简单（每个通道通常只需一个采样电极和一个参考电阻/电容）。但缺点是在多通道应用中容易受到相邻通道的串扰影响，且难以实现真正的多点触控。在KL16Z的演示板上，巧妙地将自电容的局限性转化为实现二维定位的优势。

2.2 二维触摸电极阵列设计

为了实现二维定位，演示板采用了10个TSI通道（外加1个屏蔽通道），并将其组织成两组交错排列的滑条（Slider）。具体连接如下表所示：

这种设计的核心思想是：将二维平面定位问题分解为两个独立的一维滑条定位问题。X轴滑条（R0-R4）的5个电极在水平方向排列，用于检测触摸点的X坐标；Y轴滑条（C0-C4）的5个电极在垂直方向排列，用于检测Y坐标。两组电极在物理空间上交错排布，确保手指在触摸面板任意位置时，都能同时影响至少一个X轴电极和一个Y轴电极。

注意：屏蔽电极（Shield）通常连接到PCB的接地层或一个独立的驱动信号，用于减少环境噪声（如电源噪声、显示噪声）对触摸检测的干扰，提升信噪比。在布局时，应确保触摸电极走线被屏蔽层包围。

2.3 自电容信号采集流程

TSI模块的工作由MCU的定时器（如LPTMR）触发，以固定的采样率（本例中为25Hz）循环扫描所有11个通道（10个传感+1个屏蔽）。每次扫描完成后，TSI会产生中断，将每个通道的原始计数值（与电容成正比）存入数组。这个“扫描-中断-存储”的过程是触摸检测的数据源头。

然而，直接使用原始计数值是不可靠的，因为它会随环境温度、湿度、电源电压漂移。因此，算法必须维护一个“基线”（Baseline），即无触摸状态下每个通道的典型值。真正的触摸信号是当前采样值与基线值的“差值”（Delta）。如何动态、稳定地更新这个基线，是触摸算法稳定性的基石。

3. 二维触摸位置检测算法详解

3.1 算法状态机与自适应校准

AN13026的算法核心是一个精心设计的状态机，它管理着从系统启动到稳定检测的全过程。这个状态机包含三个主要状态：预热（Warm up）、校准（Calibration）和检测与计算（Detection and calculation）。

1. 预热阶段：系统启动后，算法会先采集一定数量（例如N个）的样本并直接存入缓冲区。这个阶段的目的仅仅是填充缓冲区，为后续计算做准备，不进行任何判断。

2. 校准阶段：预热完成后，算法进入校准状态。它会持续采集样本，并计算这些样本的统计特性（如均值、方差）。当连续多个样本的波动（噪声）小于一个预设的稳定阈值时，认为环境已经稳定。此时，算法将当前缓冲区中样本的平均值确立为各通道的初始基线。这个“等待稳定”的过程就是自适应校准，它避免了手动设置固定阈值的麻烦，使系统能适应不同的上电环境。

3. 检测与计算阶段：这是算法的常态工作状态。对于每一组新采集的样本，算法执行以下步骤：

   • 计算差值：用当前采样值减去对应通道的基线值，得到差值。
   • 噪声检测：计算所有通道差值的总体波动。如果波动超过一个“噪声阈值”，说明有严重干扰（可能是电源毛刺或强电磁干扰），算法会认为当前数据不可信，自动跳回校准阶段重新建立基线。这是一个非常重要的自恢复机制。
   • 触摸判断：对于X轴和Y轴滑条，分别判断其所属通道的差值。如果某个轴上有通道的差值超过了“触摸阈值”（一个全局灵敏度参数），则认为该轴被触摸。
   • 位置计算：对于被触摸的轴，采用加权质心法计算触摸位置。以一维滑条为例，假设有5个电极，位置索引为0, 1, 2, 3, 4。当手指触摸时，会同时影响相邻的几个电极，其差值大小反映了触摸的“重心”。位置计算公式通常为：位置 = (差值0*0 + 差值1*1 + 差值2*2 + 差值3*3 + 差值4*4) / (差值0+差值1+差值2+差值3+差值4)计算结果是一个浮点数，代表了在滑条长度方向上的相对位置（例如，范围0.0~4.0）。这个值比单纯判断哪个电极差值最大要精确得多，实现了“亚电极”级的分辨率。
   • 基线更新：在无触摸时，算法会缓慢地更新基线值（例如，将当前采样值以很小的权重融入历史基线），以跟踪环境的缓慢漂移，这被称为“基线漂移补偿”。

3.2 “乒乓缓冲区”与并行任务处理

为了保证25Hz的稳定采样率不被数据处理过程打断，项目采用了经典的“乒乓缓冲区”（Ping-Pong Buffer）机制。其工作原理如下图所示：

时间轴 |---- 采样周期 N ----|---- 采样周期 N+1 ----|---- 采样周期 N+2 ----| | | | | | 硬件TSI中断 | 硬件TSI中断 | 硬件TSI中断 | | 填充缓冲区A | 填充缓冲区B | 填充缓冲区A | | | | | | 主循环处理 | 主循环处理 | 主循环处理 | | 处理缓冲区B的数据 | 处理缓冲区A的数据 | 处理缓冲区B的数据 |

• 缓冲区A和B：在内存中定义两个相同的数组，用于存储一次完整扫描所有通道的原始数据。
• 采样任务（中断服务程序）：当LPTMR定时器触发一次扫描时，TSI模块依次转换各个通道，每次转换完成产生中断。在中断服务程序（TSI_IRQHandler）中，将当前通道的转换值存入当前正在被填充的缓冲区（例如缓冲区A），并指向下一个通道。当所有通道扫描完毕，设置一个“数据就绪”标志，并切换到另一个缓冲区（例如缓冲区B）准备下一次填充。
• 处理任务（主循环）：主程序不断轮询“数据就绪”标志。一旦发现标志被置位，就知道有一个缓冲区（例如缓冲区A）已经填满了新鲜数据。主程序随后复制该缓冲区的数据到工作区，然后调用touch_2d_calc_position等函数进行处理。而此时，TSI中断可能正在向另一个缓冲区（缓冲区B）填充下一组数据。

这种设计实现了采样与处理的硬件级并行。由于处理时间通常远短于一次完整的多通道扫描时间，因此采样周期非常稳定，不会因为数据处理而丢失或延迟任何一次采样，这对于手势识别中连续轨迹的捕捉至关重要。

3.3 “全覆盖”（All Cover）手势检测

“全覆盖”手势是指用户用手掌或大面积物体覆盖整个触摸区域。此时，几乎所有的电极都会产生很大的差值信号。算法在touch_2d_calc_position函数中对此进行了特殊处理。

其判断逻辑不是基于计算出的坐标，而是基于所有通道差值的总和。在自电容模式下，每个被触摸的通道其差值会独立增加。当大面积触摸发生时，多个通道的差值会同时显著上升，导致差值总和远超单点触摸时的水平。因此，算法设定一个较高的“全覆盖阈值”。在计算坐标之前，先检查差值总和是否超过此阈值。如果超过，则直接返回一个特定的“全覆盖”事件码（如代码中的3），而不再进行X/Y坐标计算。这是一种高效的特殊事件判断，优先于常规的坐标计算流程。

4. 二维手势识别算法实现

位置检测算法持续输出触摸点的(X, Y)坐标（或“无触摸”状态）。手势识别算法则在此基础上，分析连续坐标序列中蕴含的模式。

4.1 手势识别状态机（事件传输机）

手势识别的核心是一个比触摸检测更复杂的状态机，官方文档中称之为“事件传输机”（Event Transmit Machine）。它追踪以下关键状态变量：

• touch_2d_gesture_event_pre: 上一次识别出的事件。
• touch_2d_gesture_no_touch_interval_counter: 在“无触摸间隔”状态下，记录这是第几个间隔周期，用于识别连续点击。
• touch_2d_gesture_no_touch_interval_on_hold_counter: 在“无触摸间隔”状态下，用于超时计数的计数器。

其状态迁移规则是手势识别的逻辑骨架：

1. 初始状态：无触摸保持 (No Touch Keep)。
2. 单击检测：当从无触摸保持状态检测到有触摸时，触发首次点击 (1st Click)事件。状态迁移到有触摸 (On Touch)。
3. 移动检测：在有触摸状态下，持续比较当前坐标与上一次坐标。计算ΔX和ΔY。如果ΔX和ΔY的绝对值都小于一个“移动阈值”，则判定为无移动 (No Move)。否则，取绝对值较大的那个轴，根据其正负判断方向，触发上/下/左/右移动事件。
4. 抬手与连续点击检测：在有触摸状态下，如果检测到无触摸，状态不会立刻回到无触摸保持，而是进入一个临时的无触摸间隔 (No Touch Interval)状态。同时，启动一个超时计数器（no_touch_interval_on_hold_counter）。在这个间隔期内（例如200ms），如果再次检测到有触摸，则根据no_touch_interval_counter的值触发第2次点击、第3次点击等事件，从而实现双击、三击的识别。识别后状态回到有触摸。
5. 间隔超时：如果在无触摸间隔状态下，超时计数器达到设定值（如对应200ms），仍未检测到新的触摸，则认为连续点击序列结束。状态迁移回无触摸保持，并将连续点击计数器清零。

这个状态机清晰地定义了各种手势（单击、移动、连续点击）之间的合法转换路径，是代码实现的直接依据。

4.2 移动方向判决的数学原理

移动方向的判断是二维手势识别的关键一步。算法输入是连续两帧的坐标：(X_prev, Y_prev) 和 (X_curr, Y_curr)。

1. 计算差值：delta_X = X_curr - X_prevdelta_Y = Y_curr - Y_prev这两个值代表了从上一帧到当前帧在X和Y方向上的位移。

2. 主要方向判决：直接比较delta_X和delta_Y会受坐标轴缩放比例影响。更鲁棒的做法是比较它们的绝对值abs(delta_X)和abs(delta_Y)。

   • 如果abs(delta_X) > abs(delta_Y)，则认为水平移动是主导方向。
     • 若delta_X > 0，则为向右移动。
     • 若delta_X < 0，则为向左移动。
   • 如果abs(delta_Y) > abs(delta_X)，则认为垂直移动是主导方向。
     • 若delta_Y > 0，则为向下移动（注意：在屏幕坐标系中，Y轴通常向下为正）。
     • 若delta_Y < 0，则为向上移动。
   • 如果abs(delta_X)和abs(delta_Y)都小于一个很小的“移动阈值”，则判定为无移动。这个阈值用于过滤掉因传感器噪声引起的坐标微小抖动。

实操心得：这个“移动阈值”需要根据实际应用的采样率、面板尺寸和期望的灵敏度来仔细调整。阈值太小，容易将手指轻微抖动误判为移动；阈值太大，则慢速滑动可能无法被识别。一个实用的调试方法是，在代码中输出原始的delta_X和delta_Y，观察手指静止和缓慢移动时的数值范围，从而确定一个合理的阈值。

4.3 关键参数定制与优化

算法中的几个关键参数直接影响手势识别的性能和用户体验，可以根据具体应用进行定制：

1. 连续点击间隔超时时间：这个时间定义了两次触摸之间被视为“连续点击”的最大间隔。在示例中，它由LPTMR中断周期（40ms）和no_touch_interval_on_hold_counter需要达到的计数（4）共同决定，即 40ms * (4+1) = 200ms。缩短这个时间（如改为150ms）会使连续点击的判定更“急促”，要求用户更快地完成双击；加长这个时间（如改为300ms）则会更宽松。调整时需考虑目标用户群体的操作习惯。

2. 支持更多次连续点击：示例代码默认只识别到三击。但状态机逻辑本身支持N次点击。要识别第N次点击，只需在touch_2d_gesture_process函数的相应判断分支中，增加对no_touch_interval_counter == (N-1)的条件判断，并返回对应的事件枚举值即可。例如，要识别八击，就添加else if (touch_2d_gesture_no_touch_interval_counter == 7u)分支。

3. 触摸阈值与灵敏度：这是touch_2d_calc_position函数中使用的一个全局阈值，用于判断一个通道是否被有效触摸。它直接决定了触摸的灵敏度。提高阈值会使触摸更“迟钝”，需要更大的按压力度或更近的接触才能触发，但抗噪声能力更强；降低阈值则更“灵敏”，但也更容易误触发。这个参数通常需要通过实验，在灵敏度和抗干扰性之间取得平衡。

5. 系统集成与软件架构解析

5.1 主程序流程与任务调度

一个完整的触摸手势识别应用，其软件架构需要妥善处理硬件初始化、周期性采样、数据处理和手势判决等多个任务。基于示例代码，一个典型的主程序流程如下：

int main(void) { // 1. 硬件初始化 BOARD_InitBootClocks(); // 初始化系统时钟 BOARD_InitBootPins(); // 初始化引脚，包括TSI通道 TSI_Init(); // 初始化TSI模块，配置扫描频率、电极电流等 LPTMR_Init(); // 初始化低功耗定时器，用于触发周期性扫描 // ... 其他外设初始化 (如UART用于调试输出) // 2. 触摸算法初始化 touch_2d_init(); // 初始化算法状态机、清空缓冲区、重置基线等 // 3. 启动周期性采样 LPTMR_StartTimer(); // 启动定时器，开始产生40ms中断，触发TSI扫描 while (1) { // 4. 主循环轮询处理 if (g_touch_scan_done_flag) { // “乒乓缓冲区”数据就绪标志 uint32_t raw_values[TOUCH_CHANNEL_COUNT]; // 从就绪的缓冲区复制数据到本地，避免中断中数据被覆盖 copy_touch_data(raw_values); // 5. 核心处理流程 touch_error_t pos_err; int32_t x_pos = 0, y_pos = 0; // 5.1 计算触摸位置（或判断为全覆盖） pos_err = touch_2d_calc_position(raw_values, &x_pos, &y_pos); touch_2d_gesture_event_t gesture_event; bool is_touch_valid = (pos_err == TOUCH_ERR_NONE); // 位置计算成功代表有有效触摸 // 5.2 手势识别处理 gesture_event = touch_2d_gesture_process(x_pos, y_pos, is_touch_valid); // 6. 应用层响应 switch (gesture_event) { case eTouch_2d_gesture_event_on_touch_just: // 处理单击事件，例如点亮一个LED break; case eTouch_2d_gesture_event_on_touch_just_2nd_click: // 处理双击事件 break; case eTouch_2d_gesture_event_on_touch_move_1: // 处理向上滑动事件，例如翻页 break; // ... 处理其他手势事件 default: // 无事件或事件不处理 break; } g_touch_scan_done_flag = false; // 清除标志，等待下一组数据 } // 此处可执行其他低优先级任务 __WFI(); // 进入低功耗等待模式，等待中断唤醒 } }

5.2 数据结构与关键函数剖析

理解以下几个核心数据结构与函数，是移植和调试代码的关键：

• touch_channel_values[]：全局数组，用于存储从TSI模块读取的各个通道原始计数值。其索引与硬件通道映射表touch_channel_code[]对应。
• touch_2d_calc_position()：算法的核心函数之一。
  • 输入：原始通道数据数组。
  • 内部操作：计算差值、判断全覆盖、更新基线、执行加权质心法计算X/Y坐标。
  • 输出：错误码（指示成功、无触摸、全覆盖或错误）以及计算出的X/Y坐标（如果成功）。
• touch_2d_gesture_process()：手势判决的状态机函数。
  • 输入：当前帧的X/Y坐标、当前触摸是否有效的标志。
  • 内部操作：维护内部状态变量（前一次事件、计数器），根据输入和当前状态进行状态迁移判断。
  • 输出：一个touch_2d_gesture_event_t枚举值，代表识别出的具体手势事件。
• 状态变量：如touch_2d_gesture_event_pre、no_touch_interval_counter等，它们通常被声明为static类型，以在函数调用间保持其值，实现状态记忆。

6. 开发调试与常见问题排查

6.1 硬件布局与PCB设计要点

自电容触摸的性能严重依赖于PCB设计。以下是一些必须遵守的准则：

• 电极形状与大小：通常使用菱形、圆形或正方形。电极面积越大，灵敏度越高，但相邻通道串扰也可能增加。示例中的矩形电极是权衡后的选择。
• 电极间距：相邻电极间需保持一定距离（通常大于0.5mm），以减少互电容耦合。但为了二维定位的连续性，两组电极需要交错排列，间距需精心设计。
• 走线：连接电极与MCU引脚的走线应尽可能短、等长，并用地线包围（Guard Trace）或采用夹层走线，以减少对噪声的拾取。避免走线平行穿过数字信号线或电源线下方。
• 覆盖层：触摸面板通常有一层绝缘覆盖层（如玻璃、亚克力）。覆盖层越厚，灵敏度越低。需要根据覆盖层厚度和材质（介电常数）来调整触摸阈值。
• 接地与屏蔽：确保PCB有完整、良好的接地平面。屏蔽电极应连接到干净的地或一个与传感信号同相位的驱动信号（驱动屏蔽）。

6.2 软件调试方法与技巧

1. 原始数据输出：在开发初期，通过UART或SWD接口，将每个通道的原始计数值、计算出的差值、基线值、坐标(X,Y)实时打印出来。这是理解系统行为的“显微镜”。观察手指触摸、离开、滑动时这些值的变化规律。
2. 阈值调整：准备一个测试程序，允许通过串口命令动态调整“触摸阈值”、“移动阈值”和“全覆盖阈值”。然后让测试人员在实际面板上操作，实时观察识别效果并调整参数，找到最优组合。
3. 状态机跟踪：在touch_2d_gesture_process函数中，添加调试代码，输出每次调用时的输入、内部状态变量和输出事件。这有助于理清复杂手势（如快速双击接滑动）的状态迁移是否正确。
4. 基线稳定性观察：长时间运行系统，观察在无触摸状态下，各通道的基线值是否平稳。如果基线持续漂移，可能需要调整基线更新算法的滤波系数（如使用一阶低通滤波：新基线 = α * 旧基线 + (1-α) * 新采样值，其中α接近1，如0.99）。

6.3 常见问题与解决方案速查表

6.4 从演示板到实际产品的移植考量

将演示代码移植到自己的产品设计中，需要考虑以下几点：

• 电极数量与布局：你的面板尺寸和形状可能不同，需要重新设计电极阵列。核心原则仍是两组交错滑条。电极数量可以增减，但需同步修改代码中的通道数量定义和坐标映射逻辑。
• MCU资源：KL16Z的8KB RAM和64KB Flash对于这个算法绰绰有余。如果换用更小资源的MCU，需要注意缓冲区大小和栈空间。
• 实时性要求：25Hz的采样率对于一般手势识别足够。但如果需要更流畅的轨迹跟踪（如快速书写），可能需要提高采样率到50Hz或更高，同时要评估MCU处理能力是否跟得上。
• 功耗优化：对于电池供电设备，可以动态调整采样率。无触摸时采用极低频率（如5Hz）进行巡检，一旦检测到触摸，再切换到全速模式（如25Hz）进行精确跟踪和手势识别。