1. 把定时器代码先放进仿真里跑:这套代码开发工具链省下的不只是十几分钟
上次看一个定时器实验,代码在板子上跑出来的波形和手算的对不上,查了一下午,最后发现是杜邦线接触不良。定时器是 STM32 里最常用、也最容易出问题的外设,直接上真机,每次改个参数都要重新编译、烧录、接线、拿示波器点测,一轮十几分钟起步。后来我把第一版代码放进仿真里跑:Proteus 提供虚拟示波器,STM32CubeMX 生成初始化代码,Keil MDK 负责编译出 hex,三者串成「配置—编程—仿真—调参」的闭环。这篇写给手头没有开发板的人,也写给不想为验证一个 PWM 占空比反复烧录的人。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具链的分工:CubeMX 管寄存器、Keil 管编译、Proteus 管波形
三个工具单独用都不难,难的是串起来之后出了问题不知道找谁。定时器仿真这条链路上,最常见的僵局是:Keil 编译零错误,Proteus 里就是没波形,于是开始怀疑代码、怀疑芯片型号、怀疑 Proteus 破解版有问题。实际上大多数时候只是某一步的输出去到了另一个工具没读到的地方。把每个工具的输入输出边界先划清楚,后面的排查会省很多事。
2.1 三个工具各管一段,别让职责串位
STM32CubeMX 负责的是“寄存器长什么样”。你在图形界面里选的时钟源、预分频、自动重装值、通道模式、NVIC 中断,最后都会变成一份初始化代码。它的输出是工程文件和 MX_TIMx_Init() 这类函数,不是可执行程序。Keil MDK 负责的是“把代码变成 hex”,它不关心你的定时器参数算得对不对。Proteus 负责的是“把 hex 跑起来并且让你看见波形”,它不改代码,也不帮你检查参数。
| 工具 | 输入 | 输出 | 出问题先看这里 |
|---|---|---|---|
| STM32CubeMX | 芯片型号、时钟树、定时器参数 | 初始化代码、工程文件 | 引脚复用、时钟源、NVIC |
| Keil MDK | CubeMX 生成的工程 | 可执行文件、hex | 编译告警、hex 是否更新 |
| Proteus | hex、外围电路 | 波形、引脚电平 | MCU 属性、时钟频率、接线 |
职责串位最典型的两种写法:一是在 CubeMX 生成的 USER CODE 区间之外手改初始化代码,下一次重新生成直接被覆盖;二是在 Proteus 里反复改 MCU 属性,试图“调”出一个正确的波形,但真正的参数在 CubeMX 里。我的习惯是,CubeMX 只负责生成,Keil 里只写 USER CODE 区间内的业务逻辑,Proteus 只做观测和验证,三个地方各改各的,不越界。
还有一点容易被忽略:CubeMX 重新生成代码时,会保留 USER CODE BEGIN 和 USER CODE END 之间的内容,区间外的修改一律丢失。所以中断回调、启动函数这些自己写的逻辑,要么放在指定区间,要么单独建文件。我一般把回调写在 main.c 的 USER CODE 段里,把参数计算写成宏放在文件头,重新生成之后只需要检查一遍宏有没有被覆盖。
2.2 工程骨架:从 CubeMX 生成到 Keil 第一次编译通过
这一步的目标不是写出功能,而是先拿到一个能编译、能出 hex 的最小工程。定时器的三种模式可以后面再逐个加,第一版只配一个时基中断就够。
- 新建工程,选你手上或课程指定的 STM32 型号。型号必须和后面 Proteus 里的 MCU 模型对得上,这一步选错,后面加载 hex 会直接失败。
- 配时钟树。内部时钟还是外部晶振,按实际板子和仿真模型来。配完之后记下定时器所在总线的时钟频率,后面算 PSC 和 ARR 要用到这个值。
- 配定时器。
Clock Source选Internal Clock;需要 PWM 就选PWM Generation CHx,需要捕获就选Input Capture direct mode;NVIC 标签页里把更新中断或捕获中断勾上。 Project Manager里Toolchain/IDE选MDK-ARM,需要的话勾选外设初始化代码按.c/.h成对生成。- 点
Generate Code,用 Keil 打开生成的工程。 Options for Target→Output里勾上Create HEX File,编译一次,确认 0 error。
编译通过之后,启动代码按模式区分,三个启动函数不能混用:
c复制/* CubeMX 生成的初始化入口,调用顺序保持默认即可 */
MX_GPIO_Init();
MX_TIM_Init(); /* 定时器编号按实际选择替换,别照抄函数名 */
/* 三种模式对应三个不同的启动函数 */
HAL_TIM_Base_Start_IT(&htim); /* 时基 + 更新中断 */
HAL_TIM_PWM_Start(&htim, TIM_CHANNEL_1); /* PWM 输出,必须指定通道 */
HAL_TIM_IC_Start_IT(&htim, TIM_CHANNEL_2); /* 输入捕获,中断方式 */
HAL_TIM_Base_Start_IT 只启动时基和更新中断,不会启动任何输出通道;PWM 必须用 HAL_TIM_PWM_Start 并且把通道号传进去;输入捕获用 HAL_TIM_IC_Start_IT 才会进捕获回调。这三个函数写错的典型后果是“中断进了但引脚没波形”或者“波形有了但捕获回调不进”,后面排查章节还会碰到。
中断回调里只做最小动作,我一般只翻转一个 GPIO:
c复制void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
if (htim->Instance == TIMx) { /* 换成实际使用的定时器实例 */
HAL_GPIO_TogglePin(GPIOx, GPIO_PIN_x);
}
}
Instance 判断不能省。多个定时器共用同一个回调函数,不判断的话两个定时器的中断会互相触发对方的逻辑。回调里也不要放 HAL_Delay 之类的阻塞操作,仿真里看不出来,上板就是中断被拖死。
2.3 Proteus 侧的最小电路:MCU 模型、电源与虚拟示波器
Proteus 这边要做的事情只有三件:放一个和 hex 匹配的 MCU 模型、给它一个正确的时钟频率、把要看的两根线接到虚拟示波器上。
MCU 模型从元件库里按型号搜,选错型号的表现是加载 hex 时直接报错,或者加载成功但引脚行为完全不对。电源和地按模型要求接,有些模型的电源脚是隐藏的,但复位脚要处理,否则仿真一开始就停在复位状态。双击 MCU 打开属性,Program File 指向 Keil 输出目录下的 hex,Clock Frequency 填一个和 CubeMX 配置相符的值。
虚拟示波器在 Instruments 里,四个通道。通道 A 接 PWM 输出脚,通道 B 接中断里翻转的那个 GPIO,通道 C、D 留给输入捕获或者备用信号。接线的时候注意避开复用脚,Proteus 不会因为你接错脚而报错,只会给你一条平直的线。
提示:Proteus 里的
Clock Frequency是仿真模型跑多快,CubeMX 里的定时器时钟决定 PSC/ARR 算出来的实际频率。两个值对不上,波形一定是错的,而且不会有任何报错。
3. 三种定时器模式的参数怎么落:中断翻转、PWM 输出、输入捕获
三种模式共用一套时基,时基算错,后面全错。我习惯先把时基单独调通,看到中断翻转脚的频率和手算一致,再往上加 PWM 和捕获。这样出问题时能确定是新加的模式有问题,而不是时基从一开始就偏了。
3.1 时基单元:预分频与自动重装值先把节拍算准
定时器的计数时钟和更新频率是两级分频的关系:
- 计数时钟
f_CNT = f_TIM / (PSC + 1) - 更新频率
f_UPD = f_CNT / (ARR + 1) = f_TIM / ((PSC + 1) * (ARR + 1)) - 更新周期
T_UPD = 1 / f_UPD
f_TIM 是定时器挂载总线上的时钟,CubeMX 时钟树里能看到。PSC 和 ARR 在多数通用定时器上是 16 位,算出来的乘积别溢出。实际操作顺序我一般反过来:先定想要的更新周期 T,再选一个让 f_CNT 落在合理范围的 PSC,最后反算 ARR。
| 参数 | 作用 | 调大后的效果 | 注意 |
|---|---|---|---|
| PSC | 对定时器时钟做第一级分频 | 计数变慢,更新周期变长 | 16 位上限,和 ARR 的乘积别溢出 |
| ARR | 计数到该值产生更新事件 | 更新周期变长,PWM 频率变低 | PWM 模式下它决定周期 |
| CCR | 比较值 | PWM 占空比变化 | 不能超过 ARR + 1 |
算完之后不要急着信自己,先在纸上写一遍理论值,等仿真跑起来拿示波器量,对不上就回头查 f_TIM 是不是取错了总线。这一步看起来笨,但能省掉后面“波形差一倍”的反复折腾。
3.2 PWM 输出:ARR 定周期、CCR 定占空比
PWM 模式 1、向上计数、高电平有效的前提下,占空比约等于 CCR / (ARR + 1)。CCR 等于 0 时输出常低,CCR 大于等于 ARR + 1 时输出常高,中间值才是正常的方波。PWM 模式和极性配反,波形频率是对的,占空比正好是补数,这是很常见的翻车点。
运行中改占空比不要直接写寄存器,用 HAL 提供的宏:
c复制/* 运行中修改比较值,参数是通道和新的 CCR */
__HAL_TIM_SET_COMPARE(&htim, TIM_CHANNEL_1, ccr_value);
ccr_value 的取值范围是 0 到 ARR + 1。如果 CubeMX 里把 OCPreload 使能了,新的 CCR 会在下一个更新事件生效,不会在当前周期中间切出一个毛刺;没使能的话,改 CCR 可能立刻改变输出,波形上能看到一个不完整的半周期。仿真里这个毛刺很明显,示波器时间基准调小就能看到。
还有一点:PWM 输出脚在 CubeMX 里要确认复用功能对得上,配成普通 GPIO 的话,HAL_TIM_PWM_Start 照样返回成功,但引脚不会输出任何东西。这种“函数没报错、波形没有”的情况,先回去看引脚复用。
3.3 输入捕获:信号源、捕获边沿与分频
输入捕获要配三样东西:捕获边沿(上升沿、下降沿、双边沿)、捕获分频(不分频、每 2 个事件、每 4 个事件)、以及对应的通道。测周期时,两次同向边沿之间的计数值乘以计数周期,就是信号周期。
c复制void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim)
{
if (htim->Instance == TIMx && htim->Channel == HAL_TIM_ACTIVE_CHANNEL_2) {
uint32_t cap = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_2);
/* cap 是计数值不是时间,乘上计数周期才是时长 */
}
}
HAL_TIM_ReadCapturedValue 返回的是捕获寄存器里的原始计数值,单位是计数时钟的拍数,不是微秒。要换算成时间,得乘 1 / f_CNT。另外,当信号周期大于 ARR 对应的计数周期时,计数值会溢出,单次捕获读到的值不是完整周期,需要记录溢出次数再做拼接。仿真里信号源频率不高的话一般碰不到,但上板测低频信号就会遇到。
验证捕获最省事的做法是自环:把 PWM 输出脚直接接到捕获输入脚,一路信号同时验证输出和输入两条路径。捕获值乘计数周期,应该等于 PWM 周期的理论值;对不上,不是捕获边沿配错,就是引脚没接对。
4. 在 Proteus 里把 hex 跑成波形:加载、时钟属性与示波器触发
代码编译通过只是前提,波形能不能看见,取决于 Proteus 这边的几个属性有没有配对。这一章的操作顺序建议固定下来,每次都按同一个顺序走,出问题的时候容易定位到是哪一步。
4.1 加载 hex 与 MCU 属性里的时钟、晶振设置
双击 MCU 打开属性面板,三件事按顺序确认:
Program File指向 Keil 输出目录下的 hex。路径里尽量不要有中文和空格,Proteus 对这两样东西的容忍度不高,加载失败时给的提示也不明确。Clock Frequency填一个和 CubeMX 配置相符的值。这个值决定仿真模型跑多快,填错的话定时器所有时间参数都会整体偏移。- 复位脚和电源脚按模型要求处理。有的模型会自动上电,有的需要手动拉高复位。
改完属性之后,先点停止再点运行。Proteus 在仿真运行中改 Program File 不会自动重新加载,很多人改了 hex 看不到变化,就是卡在这里。
4.2 虚拟示波器的通道分配与时间基准
虚拟示波器接好线之后,先调时间基准再看波形。时间基准太粗,高频 PWM 会挤成一条竖线;太细,低频信号只看到一个边沿。我的习惯是先用 1ms/div 左右的档位粗扫,确认有没有波形,再往小调,直到一个周期占满两到三个格子。
触发方式先用 Auto,波形稳定之后再切 Normal,触发边沿选上升沿,触发电平设在高低电平中间。幅度档位从 5V/div 开始,看到完整的高低电平再调。
通道分配上,A 通道给 PWM,B 通道给中断翻转脚,两个信号的时间关系一眼能看出来。如果两个通道接的是同一个定时器的不同通道,注意它们的更新事件是同步的,波形边沿应该对齐;对不齐就说明某一路的预装载或者启动顺序有问题。
4.3 一轮「改 CCR—重编译—重仿真」的闭环操作
参数调优是反复改、反复看的过程,把每一步固定下来,比记住某个具体数值有用。
| 步骤 | 操作 | 检查点 |
|---|---|---|
| 1 | 在 Keil 里改 __HAL_TIM_SET_COMPARE 的 CCR 值 |
改的是 CCR,不是 ARR |
| 2 | Rebuild |
0 error,hex 文件时间戳更新 |
| 3 | Proteus 里停止仿真 | 必须先停止 |
| 4 | 重新运行或重新加载 hex | 波形占空比发生变化 |
| 5 | 量高电平时间和周期 | 和手算的占空比对一遍 |
第 3 步最容易漏。仿真运行中重新编译,Proteus 用的还是旧 hex,波形当然不变。我一般会看一眼 hex 的文件修改时间,确认是刚刚生成的,再回 Proteus 点运行。
5. 仿真翻车的五类现场:编译过了、波形不出、占空比反了怎么排查
仿真环境的好处是可控,坏处是它不报错。代码有问题、属性配错、接线接错,Proteus 一律给你一条平直的线或者一个看着正常但就是不对的波形。下面五类现场是我在这条链路上反复遇到的,按现象、原因、解决三段记下来,下次碰到可以直接对号。
5.1 编译零错误,Proteus 里一点反应都没有
现象:Keil 编译通过,hex 也生成了,Proteus 点运行,目标引脚一直是低电平,示波器上没有任何跳变。
原因:三种可能按概率排——Program File 没选或者选的是上一次的旧 hex;MCU 型号和 CubeMX 里选的型号不一致;Clock Frequency 填错,比如留了默认值。这三种都不会让 Proteus 报错。
解决:先看 MCU 属性里的 Program File 路径和文件时间戳,再看型号,最后核对 Clock Frequency。把这三项做成固定检查顺序,每次改完代码都过一遍,比凭感觉猜快得多。
5.2 频率对得上,占空比却是反的
现象:示波器量出来的周期和手算一致,高电平时间却是 CCR 对应时间的补数,CCR 越大高电平反而越短。
原因:PWM 模式 1 和模式 2 选反了,或者通道极性设成了 Low。这两种配置都不影响频率,只影响有效电平的方向。
解决:回 CubeMX 看 PWM Generation CHx 的 Mode 和 Pulse,Pulse 就是 CCR 初值;模式 1 向上计数时 CCR 以下为有效电平。改完重新生成代码,别忘了 Keil 里重新编译。
5.3 中断只进一次,之后引脚就不动了
现象:上电后翻转脚动了一下就停住,示波器上只有一个边沿。
原因:CubeMX 的 NVIC 标签页里定时器更新中断没勾选,或者勾了但优先级配置被后面的初始化覆盖;另一种是回调里放了阻塞操作,第一次中断进去就出不来。
解决:先检查 NVIC 配置,再检查回调函数体。回调里只做翻转和置标志,业务逻辑放主循环。仿真里阻塞操作的影响不明显,上板之后就是中断被拖死,这个坑在仿真阶段就要避开。
5.4 输入捕获读到的值一直是 0
现象:捕获回调确实进了,但 HAL_TIM_ReadCapturedValue 返回 0,或者读出来的值一直不变。
原因:捕获边沿和信号源不匹配,信号是上升沿却配了下降沿;捕获通道和引脚复用没对上;自环时 PWM 输出脚和捕获输入脚不是同一根线。
解决:先用示波器确认信号源上真的有波形,再核对引脚复用表,最后把捕获边沿改成双边沿试一次。三步走完还读不到,就看捕获分频是不是配成了每 4 个事件,导致回调频率远低于信号频率。
5.5 仿真波形很漂亮,上板就翻车
现象:Proteus 里占空比、频率都准,烧到板子上偏差明显,甚至引脚完全没有输出。
原因:Proteus 是理想模型,不模拟驱动能力、上升沿、探头负载;CubeMX 里的时钟源配置(内部时钟还是外部晶振)在仿真里体现不出来,上板才会暴露。仿真验证的是逻辑和参数计算,不是电气特性。
解决:仿真只用来确认参数算对了、模式配对了、波形逻辑正确;时钟源、驱动能力、实际负载必须上板确认。把仿真当成第一道筛子,不当成最终结论。
6. 把仿真波形留成证据:一套可复用的对比方法和检查习惯
参数调通不等于下次还能调通。我后来养成了一个习惯:每次改定时器参数,先在纸上或者注释里写一张对照表,把理论值、仿真值、实测值三列并排放着,差在哪一列一目了然。
| 项目 | 理论值 | 仿真值 | 实测值 |
|---|---|---|---|
| 更新频率 | f_TIM / ((PSC+1)*(ARR+1)) |
示波器量周期反算 | 逻辑分析仪或示波器 |
| PWM 占空比 | CCR / (ARR+1) |
高电平时间 / 周期 | 同左 |
| 捕获周期 | cap * (1 / f_CNT) |
捕获回调打印值 | 信号源实际周期 |
这张表最大的用处不是记录,而是逼着自己在打开仿真之前先算一遍。算不出来,说明参数还没想清楚,这时候看波形只是碰运气。算出来了再对照,偏差出现在哪一列,问题就锁定在哪一段:理论值和仿真值对不上,查 CubeMX 和 Proteus 的属性;仿真值和实测值对不上,查时钟源和电气特性。
再分享一个自环技巧:把 PWM 输出脚直接接到同一个定时器的捕获输入脚,一轮仿真同时验证输出和输入两条路径。捕获值乘计数周期应该等于 PWM 周期,占空比应该等于 CCR 的比例。两条路径只要有一条配错,这个等式就不成立。这比分别验证两个模式省一半时间,也更容易发现引脚复用这种隐蔽问题。
从那以后我每次动定时器参数,都强制自己先算理论值、再开仿真、最后才上板,三步缺一步都不往下走。希望帮到你。
