1.

从零开始：认识S32K144的FTM输入捕获

大家好，我是老李，在汽车电子和工控领域摸爬滚打了十几年，跟NXP的芯片打交道是家常便饭。

今天咱们不聊那些虚的，就手把手地带你搞定S32K144里一个非常实用但又容易让人迷糊的功能——FTM模块的输入捕获。

你可能会问，输入捕获是啥？简单来说，它就像你手里的一块高精度秒表。

当外部引脚上有一个脉冲信号过来，比如一个上升沿或者下降沿，这个“秒表”就会立刻“咔哒”一下，把当前的精确时间值记录下来。

这个功能在现实世界里太有用了：你想测量一个旋转编码器的转速、一个超声波传感器的回波时间、或者一个PWM遥控信号的脉冲宽度，全都离不开它。

S32K144内部的FTM（FlexTimer

Module）模块，就是干这个活的专家。

很多新手朋友一看到SDK里那些复杂的结构体和函数就头大，感觉无从下手。

别担心，我刚开始用的时候也踩过不少坑，比如时钟没配对导致测量值飘得离谱，或者中断处理不好直接把系统搞卡死了。

这篇文章，我就用最“白话”的方式，结合我实际项目里的代码，带你走一遍完整的配置流程。

咱们的目标是：看完就能动手，调通就能用上。

我会假设你已经有一个基本的S32K144开发环境，比如S32

Design

Studio，并且已经创建了一个基于SDK的工程。

如果还没准备好，先去NXP官网把最新的S32K1xx

SDK包下载下来，安装好，这些前置步骤咱们就不赘述了。

好了，废话不多说，咱们直接进入实战环节。

2.

工程配置：用可视化工具打好地基

在S32K144的SDK开发中，最幸福的一点就是它有强大的引脚配置和时钟配置工具（Pin

Settings

Configuration）。

这一步咱们千万别硬刚代码，先把图形化工具用好，能省下至少80%的排查时间。

2.1

引脚配置：给信号找个“家门”

首先，你得决定用哪个引脚来接收待测量的脉冲信号。

S32K144的很多引脚都是复用的，既可以做普通的GPIO，也可以作为FTM的输入通道。

我个人的习惯是优先选择带有“FTM0_CHx”或“FTM1_CHx”标识的引脚，兼容性最好。

打开你的工程，找到Pin

Settings工具。

这里你会看到一个芯片的引脚图。

假设我们想用FTM0模块的通道7（CH7）来做输入捕获，那么我们就需要找到一个支持FTM0_CH7功能的引脚，比如PTD7。

在工具里，你点击这个引脚，在右侧的“Mux”选项里，把它从默认的GPIO（或者别的功能）改成FTM0_CH7。

这个操作的本质，就是在配置芯片内部的信号路由开关，把外部引脚物理连接到了FTM0模块的第7个通道上。

这里有个小坑我提醒一下：一定要顺带看一眼这个引脚的电气属性。

比如，如果你的输入信号是3.3V的，那没问题。

但如果信号来自一个5V的系统，你直接接上去就可能烧坏引脚。

这时候你可能需要在硬件上加一个电平转换电路，或者在软件配置里，虽然S32K144大部分引脚是5V容忍的，但确认一下数据手册总没错。

配置好后，工具会自动在代码里生成一个PinSettings的配置结构体，我们后续直接调用初始化函数就行，非常方便。

2.2

时钟配置：让“秒表”走得准

引脚是门，时钟就是心跳。

输入捕获的精度完全取决于FTM模块的时钟源跑得多快。

如果时钟配错了，你测出来的脉冲宽度数字可能也对，但换算成实际时间就差了十万八千里。

打开Clock

Configuration工具。

FTM模块的时钟通常来自系统总线时钟（比如BUS_CLK）或一个固定的时钟源（FXOSC）。

我们需要找到FTM0的外设时钟设置。

一般来说，为了获得较高的时间分辨率，我们会把系统主频分频后供给FTM。

比如，系统核心跑在80MHz，我们可以通过分频器给FTM一个40MHz或者20MHz的时钟。

在时钟树里找到FTM0的时钟源选项，把它设置成你想要的频率。

这里的关键是计算最终FTM计数器的计数频率。

例如，如果你给FTM的时钟是40MHz，那么计数器每增加1，就代表了25纳秒（1/40MHz）的时间。

这个值是你后续把捕获的计数值换算成微秒、毫秒的基石，务必记清楚。

图形化配置工具会帮你计算好分频系数，并生成相应的初始化代码，避免了手动计算容易出错的问题。

3.

代码实战：一步步构建输入捕获引擎

基础打牢了，现在开始写核心代码。

SDK提供了FTM_DRV（驱动程序）这一层，封装得比较好，我们不需要直接去操作寄存器，但理解它背后的流程至关重要。

3.1

初始化结构体：告诉FTM你想怎么干活

SDK驱动通常要求我们先填充几个配置结构体。

第一个是ftm_config_t，它定义了FTM模块的一些全局行为。

ftm_config_t
=
时钟预分频，假设总线时钟80MHz，分频后为20MHz
.bdmMode
};

重点看prescaler，这就是我们刚才在时钟工具里设置的分频的软件体现。

kFTM_Prescale_Divide_4表示对输入时钟进行4分频。

接下来是输入捕获专用的配置结构体ftm_input_capture_param_t：

ftm_input_capture_param_t
flexTimer_ic0_InputCaptureConfig
=
kFTM_RisingAndFallingEdgeCapture,
.enableOneshot
};

这个结构体是灵魂。

captureMode决定了你在信号的哪个边沿“掐表”。

kFTM_RisingEdgeCapture只抓上升沿，kFTM_FallingEdgeCapture只抓下降沿，像我这里设置的kFTM_RisingAndFallingEdgeCapture则是上升沿和下降沿都抓，这对于测量脉冲的高电平宽度或周期特别有用。

enableFilter强烈建议在可能有噪声的实际环境中开启，它能用几个时钟周期来过滤掉毛刺，避免误触发。

3.2

驱动初始化与中断挂钩

配置好结构体，就可以调用驱动初始化函数了。

这里有两步：

//
初始化FTM模块基础配置
FTM_DRV_Init(INST_FLEXTIMER_IC0,
FTM_DRV_InitInputCapture(INST_FLEXTIMER_IC0,
&flexTimer_ic0_InputCaptureConfig);

INST_FLEXTIMER_IC0是一个实例宏，对应FTM0模块，它是在SDK头文件里定义好的。

ftm1StateStruct是一个ftm_state_t类型的变量，驱动内部用它来记录模块状态，我们只需要声明它即可。

初始化完成后，FTM模块就已经在硬件上准备就绪了。

但是，捕获事件发生时，我们需要被通知到，这就需要中断。

SDK采用了回调函数机制。

我们在上面的配置里已经指定了callback

=

FTM0_Ch7_Capture_ISR。

现在我们需要实现这个函数，并且确保中断向量表被正确关联。

通常，SDK的启动代码已经处理了向量表，我们只需要确保中断优先级设置合理，不要阻塞其他关键任务。

//
设置FTM0通道7的中断优先级（根据你的RTOS或裸机系统调整）
INT_SYS_SetPriority(FTM0_Ch6_Ch7_IRQn,
3);

这样，当PTD7引脚上出现我们设定的边沿事件时，硬件就会跳转到FTM0_Ch7_Capture_ISR函数执行。

4.

核心逻辑：中断服务程序与周期计算

这是整个输入捕获最精彩也最容易出错的部分。

中断函数里的代码要快进快出，只做最必要的操作。

4.1

中断回调函数的实现

我们来看一个实战中测量信号周期的完整例子。

目标是测量一个方波信号的周期，所以我们选择双沿捕获。

volatile
uint16_t
FTM0_Ch7_Capture_ISR(ic_event_t
event,
FTM_DRV_GetInputCaptureMeasurement(INST_FLEXTIMER_IC0,
7U);
计算相邻两次捕获的差值（即时间间隔）
注意处理计数器溢出！
s_captureBuffer[s_bufferIndex];
注意：s_bufferIndex已经切换，这里取到的是上一次的值
uint16_t
如果是双沿捕获，这个diff代表的是半个周期（比如上升沿到下降沿）。
如果需要整个周期，需要连续两次上升沿（或下降沿）的差值。
这里我们简单地将两次边沿间隔视为周期（假设占空比50%，或我们只关心上升沿）。
g_capturePeriod
清除中断标志位（非常重要！通常SDK驱动在调用回调前已清除，但最好确认）
FTM_DRV_ClearStatusFlags(INST_FLEXTIMER_IC0,
kFTM_Chnl7Flag);
}

我来解释一下关键点。

FTM_DRV_GetInputCaptureMeasurement这个函数是SDK提供的，它直接读取对应通道的捕获寄存器值。

这个值就是边沿发生时，FTM16位计数器的瞬间值。

溢出处理是重中之重！FTM计数器从0累加到65535后会归零。

如果一次捕获发生在溢出前，另一次在溢出后，直接用新值减旧值会得到一个非常大的负数（实际上会变成无符号数的一个巨大正值），导致计算错误。

所以代码里用了if

(newer

older)来判断，并采用公式(65535

older)

1来补偿溢出的部分。

这个“+1”是因为从65535到0的跳变也算一个计数。

4.2

在主循环中获取并使用结果

中断函数计算出了周期计数值g_capturePeriod，我们在主循环或其它任务中就可以使用它了。

记得将g_capturePeriod声明为volatile，因为它在中断中被修改。

void
main(void)
}

通过这个简单的公式，我们就把原始的计数值转换成了有物理意义的时间单位。

你可以根据实际FTM时钟频率调整乘数因子。

5.

避坑指南与高级技巧

按照上面的步骤，基本功能应该能跑起来了。

但想在实际项目中稳定应用，还得听听我踩过的那些坑。

5.1

常见问题排查

问题一：完全捕获不到中断。

首先，用万用表或示波器确认信号确实到达了芯片引脚。

然后，检查三件事：1.

引脚复用功能是否真的配成了FTM0_CH7？2.

中断优先级设置是否过低，被其他中断屏蔽了？3.

在main函数里是否调用了EnableIRQ(FTM0_Ch6_Ch7_IRQn)来全局使能这个中断？有时候SDK初始化函数不会自动打开中断总开关。

问题二：测量值跳动很大，不准确。

这通常是噪声引起的。

首先，确保硬件信号本身是干净的。

其次，充分利用配置结构体里的enableFilter和filterValue。

滤波器的工作原理是，只有当输入信号稳定保持若干个时钟周期后，边沿才被确认。

filterValue越大，抗干扰能力越强，但对非常窄的脉冲可能就无法捕获了。

需要根据信号特性做权衡。

我一般会从kFTM_Filter_Clk_4开始尝试。

问题三：计算出的周期或脉宽总是差一个固定倍数。

这几乎可以肯定是时钟分频没算对。

回头仔细检查Clock

Configuration工具里FTM的时钟源路径，以及代码中ftm_config_t的prescaler分频系数。

确保你计算时间所用的频率，和FTM计数器实际递增的频率是一致的。

一个很好的验证方法是：产生一个已知精确频率的信号（比如用另一个FTM通道生成1KHz的PWM），然后用输入捕获去测，看结果对不对。

5.2

提升测量精度与范围

对于低频信号，16位计数器（最大值65535）可能绰绰有余。

但对于高频信号，或者想测量很宽的脉冲，计数器可能会很快溢出。

这里有几种策略：

1. 降低FTM时钟频率：通过增大预分频prescaler，让计数器跑得慢一点，这样它计满65535所需的时间就更长，可以测量更宽的脉冲。

   但代价是时间分辨率下降，测出来的数值“颗粒感”变粗。

2. 使用硬件溢出中断：FTM模块本身有计数器溢出中断。

   我们可以开启这个中断，在中断函数里对一个32位或64位的软件计数器进行累加。

   这样，实际的计时值就等于软件计数器

   65536

   当前捕获值。

   这相当于把计数器扩展到了32位甚至更高，既能测很宽的时间，又能保持较高的分辨率。

   这是专业级应用常用的方法，配置上会复杂一些。

3. 测量高频信号的周期：如果想测一个频率很高的信号，其周期可能很短，对应的计数值很小，相对误差就会变大。

   这时，我们可以转而测量多个周期的时间。

   例如，配置为只在上升沿捕获，然后连续捕获100个上升沿，用第100次和第1次的捕获值之差除以99，就得到了平均周期，这样可以大大提高测量精度。

6.

项目集成：从实验到产品

当你把输入捕获功能调试稳定后，就要考虑如何把它优雅地集成到更大的项目中，尤其是可能运行RTOS的系统中。

6.1

模块化封装

我强烈建议你将所有FTM输入捕获相关的代码封装成一个独立的C文件（如ftm_ic.c）和头文件（ftm_ic.h）。

头文件里提供清晰的初始化接口、启动/停止捕获接口、以及获取最新测量结果的接口。

例如：

//
ftm_ic.h
FTM_IC_GetLatestMeasurement(ic_measurement_t
*p_result);

这样，上层应用（比如一个电机速度检测任务）只需要调用FTM_IC_GetLatestMeasurement，而完全不用关心中断、溢出处理这些底层细节。

代码的复用性和可维护性会大大提升。

6.2

在RTOS环境下的注意事项

如果你的系统使用了FreeRTOS、μC/OS等实时操作系统，中断服务程序（ISR）与任务间的通信需要小心处理。

我们的捕获中断应该依然保持简短，但可以将计算好的结果通过一个队列（Queue）、信号量（Semaphore）或者直接设置任务通知（Task

Notification）的方式，发送给一个专门的数据处理任务。

例如，在FreeRTOS中，可以在中断里使用xQueueSendFromISR将ic_measurement_t结构体发送到队列。

数据处理任务在另一端xQueueReceive，进行更复杂的滤波、校准或显示操作。

绝对要避免在中断中进行浮点运算、大量打印或申请内存等耗时操作。

最后，关于电源管理，如果设备有低功耗需求，记得在进入低功耗模式前，禁用FTM模块的时钟或整个外设，并在唤醒后重新初始化。

否则，FTM在睡眠时产生的无意义中断可能会阻止芯片深度休眠。

折腾S32K144的FTM输入捕获，就像在调试一个精密的机械表，每一个齿轮（配置）都要咬合到位。

我印象最深的一次是帮朋友调试一个转速传感器，死活测不准，最后发现是PCB布局时信号线走得太靠近电机电源线，引入了巨大干扰。

硬件是软件的基础，这句话永远不过时。

希望这篇从工具配置到代码实现，再到问题排查的全程指南，能帮你少走些弯路，顺利把这个强大的功能用起来。

下次有机会，咱们再聊聊FTM另一个好玩的功能——正交解码（Quadrature

Decoder），用来读光电编码器，那又是另一番天地了。