单片机脉宽调制输出模板的本质不是一段可以直接复制粘贴的代码,而是一套把定时器配置、占空比更新、频率约束和应用层解耦的固定结构。真正决定PWM输出是否稳定的,是定时器计数模式、比较寄存器写入时机以及占空比边界的处理方式,而不是模板里某一行看似万能的初始化代码。围绕嵌入式与硬件物联网场景,下面从原理到模板结构,再到常见踩坑点,把脉宽调制输出的可复用写法讲清楚。
脉宽调制输出在任何一颗单片机上,最终都由周期、占空比和分辨率三个参数决定。周期决定输出频率,占空比决定高电平占整个周期的比例,分辨率决定占空比可以调节到多细的粒度。
这三个参数互相牵制,模板必须把它们显式暴露成配置项,而不是在函数内部写死。把频率和分辨率作为输入,反算PSC和ARR,是脉宽调制输出模板最该固化的第一步。
一个能在项目中反复使用的脉宽调制输出模板,至少要把硬件寄存器操作、通道管理、占空比换算和应用接口分成四层。
这一层只负责时钟源、计数模式、预分频和自动重装载值,不涉及任何具体通道。计数模式优先选择边沿对齐模式,它在占空比更新时行为最直观;中央对齐模式适合电机驱动等需要对称波形的场合,但占空比计算要额外处理。
把通道号、对应引脚、输出极性、空闲电平集中在一张表里。引脚复用功能在很多单片机上需要额外配置,漏配会导致PWM信号根本不出现在物理引脚上,这是新手最常见的现象之一。
对外暴露百分比或千分比,对内换算成CCR值。换算函数需要做边界钳位,防止传入大于100的值导致比较寄存器溢出后输出常高或常低。
提供启动、停止、设置占空比、设置频率四个接口即可。启动和停止在部分单片机上体现为输出使能位,在另一些单片机上体现为主输出使能(MOE)位,模板要把这个差异封装在内部。
占空比更新时机直接决定输出波形是否会出现毛刺,边沿对齐模式下通常有两种写法。
| 更新方式 | 写入时机 | 波形表现 | 适用场景 |
|---|---|---|---|
| 直接写入CCR | 任意时刻 | 当前周期可能被截断,产生窄脉冲 | 对波形纯度要求不高的LED调光 |
| 更新事件触发写入 | 等待UEV或使用影子寄存器 | 新占空比在下一周期整体生效 | 电机驱动、音频、电源控制 |
多数现代单片机都提供预装载寄存器配合更新事件,把CCR写入影子寄存器,等计数器溢出时统一生效。需要无毛刺输出的场合,应当选择第二种方式,模板里应默认开启预装载。
下面以常见的通用定时器结构为例,给出初始化骨架。不同厂商寄存器名会有差异,但配置顺序和参数计算逻辑是一致的。
// 目标频率与分辨率经过反算得到 PSC 与 ARR
void pwm_init(uint32_t timer_clock, uint32_t freq_hz, uint16_t resolution, uint8_t channel)
{
uint32_t arr = resolution - 1; // 分辨率决定 ARR
uint32_t psc = timer_clock / (freq_hz * resolution) - 1; // 反算预分频
timer_set_prescaler(psc);
timer_set_autoreload(arr);
timer_set_counter_mode(EDGE_ALIGNED);
pwm_channel_config(channel, POLARITY_HIGH);
pwm_enable_preload(channel); // 影子寄存器,避免毛刺
pwm_set_compare(channel, 0); // 初始占空比为 0
timer_enable_update_event();
timer_start();
pwm_output_enable(); // 部分平台即 MOE 位
}
这段骨架里,预分频的反算公式限定了freq_hz × resolution不能超过定时器时钟,否则psc会下溢成极大值,输出频率异常。模板应在初始化前做一次参数合法性检查并返回错误码。
占空比接口最容易在边界上出问题。当占空比设置为100%时,CCR应等于ARR+1而不是ARR,否则输出会缺失最后一个计数脉冲;当占空比设置为0%时,CCR应为0。不同硬件对CCR=ARR+1的支持程度不同,模板需要按平台决定是用CCR+强制输出,还是用极性翻转实现全高。
脉宽调制输出调试失败的原因,往往不在算法本身,而在初始化顺序和外设耦合上。
定时器外设时钟、GPIO时钟、复用功能时钟属于不同总线,顺序上应先开时钟再配置寄存器,否则寄存器写入被忽略且不报错。
多数16位定时器的ARR上限是65535,如果期望分辨率达到65536以上,就必须换用32位定时器或降低分辨率。模板应把这一约束写成断言或返回错误。
同一定时器的所有通道共享ARR,因此频率相同,只有占空比可独立。需要不同频率时,必须分配到不同定时器,这是模板设计阶段就要区分的约束。
最终可复用的脉宽调制输出模板,应把一个通道的全部信息收敛到一个结构体里,包括定时器实例、通道号、频率、分辨率、极性、初始占空比。上层应用只操作这个结构体,不直接碰寄存器,这样在更换单片机型号时只需重写底层的寄存器适配层,应用代码几乎不动。这也是嵌入式与硬件物联网项目中,把脉宽调制输出从一次性驱动升级为可维护模块的关键一步。
评论
加载中...