PWM#
PWM (Pulse Width Modulation) 驱动 | 案例:
src/application/samples/peripheral/pwm/pwm_demo.c
学习目标#
掌握 PWM 高、低电平时间与周期、占空比之间的关系
理解
pwm_config_t中高低电平时间、偏移、周期数和重复模式的作用能够在 WS53 上启动 PWM、注册 PWM 完成中断回调并动态调整占空比
基本概念#
PWM 做什么#
PWM 通过周期性切换高低电平,并调整高电平在一个周期中的占比来控制平均输出功率。常见用途包括 LED 调光、电机调速、蜂鸣器和舵机控制。
flowchart LR
subgraph A["占空比 50%"]
H1[高电平 50%] --> L1[低电平 50%]
end
subgraph B["占空比 25%"]
H2[高电平 25%] --> L2[低电平 75%]
end
A~~~B
占空比 |
平均电压(VCC=3.3V) |
LED 效果 |
|---|---|---|
100% |
3.3V |
最亮 |
50% |
1.65V |
半亮 |
25% |
0.825V |
较暗 |
0% |
0V |
熄灭 |
周期、频率和占空比#
周期由
high_time + low_time决定。PWM 频率等于 PWM 时钟除以一个周期的总计数值。
占空比等于
high_time / (high_time + low_time)。
单次与重复模式#
模式 |
|
行为 |
适用场景 |
|---|---|---|---|
非重复模式 |
|
按配置输出指定周期后停止 |
精确脉冲、一次性控制 |
重复模式 |
|
持续输出,并可在运行中更新配置 |
LED 调光、电机调速 |
cycles 和 repeat 是两个独立字段:cycles 表示硬件周期计数,范围为 0~32767;repeat 是是否连续输出的布尔标志。案例中的 0xFF 赋给 cycles,不是“无限循环”的标志。
涉及 API#
API |
用途 |
头文件 |
|---|---|---|
|
将目标引脚复用为 PWM 功能 |
|
|
初始化 PWM 模块 |
|
|
打开并配置 PWM 通道 |
|
|
注册 PWM 完成中断回调 |
|
|
启动单个 PWM 通道 |
|
|
配置并启动 PWM 通道组 |
|
|
运行中更新 PWM 配置 |
|
|
关闭 PWM 通道 |
|
|
去初始化 PWM |
|
案例说明#
案例简介#
案例先以非重复模式输出高、低电平各 100 个时钟计数的波形,启动 500ms 后关闭;随后进入重复模式,高电平初始为 20、低电平初始为 0,并注册 PWM 完成中断回调。使用 V151 驱动时,案例逐步增加低电平时间、减少高电平时间,以演示动态占空比变化。
功能规格#
规格项 |
说明 |
|---|---|
PWM 通道 |
|
PWM 引脚 |
|
非重复模式 |
|
重复模式 |
|
配置更新间隔 |
500ms |
回调 |
PWM 完成中断触发时累计 |
案例流程#
flowchart TD
A["<div style='width: 220px;'>配置 PWM 引脚复用</div>"] --> B["<div style='width: 220px;'>uapi_pwm_init</div>"]
B --> C["<div style='width: 220px;'>打开非重复模式</div>"]
C --> D["<div style='width: 220px;'>启动通道或通道组</div>"]
D --> E["<div style='width: 220px;'>延时 500ms 后关闭</div>"]
E --> F["<div style='width: 220px;'>打开重复模式并注册回调</div>"]
F --> G["<div style='width: 220px;'>启动 PWM</div>"]
G --> H{是否为V151 驱动?}
H -->|是| I["<div style='width: 220px;'>每 500ms 更新高低电平时间</div>"]
H -->|否| J["<div style='width: 220px;'>保持输出 500ms</div>"]
I --> K["<div style='width: 220px;'>停止并关闭</div>"]
J --> K
案例操作指导#
第一步:配置案例#
启用 ENABLE_PERIPHERAL_SAMPLE 和 SAMPLE_SUPPORT_PWM,根据开发板原理图确认 PWM_CHANNEL、PWM_PIN 和 PWM_PIN_MODE。使用 V151 驱动时还需确认 PWM_GROUP_ID。
第二步:编译和烧录#
fbb build ws53_liteos_app
fbb flash ws53_liteos_app
第三步:验证#
使用示波器或逻辑分析仪测量 PWM 引脚。应先看到占空比约为 50% 的非重复模式波形,随后看到重复模式波形;V151 驱动下占空比会按 500ms 间隔逐步变化,串口同时打印 PWM 完成中断累计计数和当前占空比。
关键配置#
配置项 |
默认值 |
说明 |
|---|---|---|
|
0 |
PWM 通道编号 |
|
0 |
V151 驱动使用的通道组编号 |
|
47 |
PWM 输出引脚 |
|
1 |
引脚复用模式 |
|
500 |
两次配置更新之间的延时 |
|
20 |
重复模式初始高电平时间 |
|
0 |
重复模式初始低电平时间 |
PWM 实际频率取决于底层 PWM 时钟。连接 LED、电机或舵机前,应同时确认输出频率、电平和外部驱动能力,不能直接用 IO 引脚驱动大电流负载。
代码详解#
1. PWM 完成中断回调#
回调由 PWM 完成中断触发,触发节奏受 cycles 配置和底层驱动行为影响,不应理解为每个高低电平波形周期都进入一次回调。
static uint32_t g_pwm_cyc_done_cnt = 0;
static errcode_t pwm_sample_callback(uint8_t channel)
{
unused(channel);
g_pwm_cyc_done_cnt++;
return ERRCODE_SUCC;
}
2. 非重复模式#
pwm_config_t cfg_no_repeat = {
100, /* low_time */
100, /* high_time */
0, /* offset */
0xFF, /* cycles */
false /* 非重复模式 */
};
uapi_pin_set_mode(CONFIG_PWM_PIN, CONFIG_PWM_PIN_MODE);
uapi_pwm_init();
uapi_pwm_open(CONFIG_PWM_CHANNEL, &cfg_no_repeat);
uapi_pwm_register_interrupt(CONFIG_PWM_CHANNEL, pwm_sample_callback);
#ifdef CONFIG_PWM_USING_V151
uint8_t channel_id = CONFIG_PWM_CHANNEL;
uapi_pwm_set_group(CONFIG_PWM_GROUP_ID, &channel_id, 1);
uapi_pwm_start_group(CONFIG_PWM_GROUP_ID);
#else
uapi_pwm_start(CONFIG_PWM_CHANNEL);
#endif
uapi_tcxo_delay_ms(TEST_TCXO_DELAY_500MS);
uapi_pwm_close(CONFIG_PWM_CHANNEL);
uapi_pwm_deinit();
3. 重复模式与动态更新#
pwm_config_t cfg_repeat = {
PWM_LOW_TIME_CYC,
PWM_HIGH_TIME_CYC,
0,
0xFF,
true
};
uapi_pwm_init();
uapi_pwm_open(CONFIG_PWM_CHANNEL, &cfg_repeat);
uapi_pwm_register_interrupt(CONFIG_PWM_CHANNEL, pwm_sample_callback);
#ifdef CONFIG_PWM_USING_V151
uint8_t channel_id = CONFIG_PWM_CHANNEL;
uapi_pwm_set_group(CONFIG_PWM_GROUP_ID, &channel_id, 1);
uapi_pwm_start_group(CONFIG_PWM_GROUP_ID);
while (cfg_repeat.low_time <= PWM_HIGH_TIME_CYC) {
uapi_pwm_update_cfg(CONFIG_PWM_CHANNEL, &cfg_repeat);
uapi_tcxo_delay_ms(TEST_TCXO_DELAY_500MS);
cfg_repeat.low_time++;
cfg_repeat.high_time--;
}
uapi_pwm_stop_group(CONFIG_PWM_GROUP_ID);
#else
uapi_pwm_start(CONFIG_PWM_CHANNEL);
#endif