PWM
在本章中,我们将学习如何在 Luckfox Aura 上配置 PWM,并通过 Shell、Python 和 C 程序控制 PWM 输出。
1. PWM 子系统
PWM(Pulse Width Modulation,脉冲宽度调制)通过周期性改变高、低电平的持续时间控制平均输出效果。Linux 通过 /sys/class/pwm/ 提供用户空间接口。
PWM 的主要参数包括:
- 周期
period:一个完整 PWM 周期,单位为 ns。 - 占空比
duty_cycle:高电平在周期中持续的时间,单位为 ns。 - 极性
polarity:normal或inversed。 - 使能
enable:1启用,0停止。
频率与周期的关系为:
frequency = 1,000,000,000 / period
2. PWM 控制(Shell)
2.1 PWM 引脚
本章使用物理引脚 11:
| 物理引脚 | 复用功能 | GPIO | 设备树节点 |
|---|---|---|---|
| 11 | PWM3_CH2_M1 | GPIO5_C2 | pwm3_8ch_2 |

2.2 设备树配置
-
板级设备树路径:
<Luckfox Aura SDK>/sysdrv/source/kernel/arch/arm64/boot/dts/rockchip/rv1126b-luckfox-aura.dtsi -
开启物理引脚 11 对应的 PWM3 通道 2:
&pwm3_8ch_2 {pinctrl-names = "active";pinctrl-0 = <&pwm3m1_ch2_pins>;status = "okay";}; -
编译内核:
sudo ./build.sh kernel
2.3 查看PWM 设备
root@aura:~# ls -l /sys/class/pwm
total 0
lrwxrwxrwx 1 root root 0 Apr 13 19:38 pwmchip0 -> ../../devices/platform/20e50000.pwm/pwm/pwmchip0
lrwxrwxrwx 1 root root 0 Apr 13 19:38 pwmchip1 -> ../../devices/platform/21020000.pwm/pwm/pwmchip1
2.4 导出 PWM 通道
echo 0 > /sys/class/pwm/pwmchip1/export
ls /sys/class/pwm/pwmchip1/pwm0/
导出成功后,可以看到以下属性:
capture duty_cycle enable period polarity power uevent
period:PWM 周期,单位为 ns。duty_cycle:高电平持续时间,单位为 ns,不能大于period。polarity:输出极性,可设置为normal或inversed。enable:写入 1 开启输出,写入 0 停止输出。
2.5 输出 50Hz、1.5ms 正脉宽
首次导出通道后,若 enable、period 和 duty_cycle 均为0,应先设置有效周期,再设置其他属性,避免因 period=0 返回 Invalid argument:
cd /sys/class/pwm/pwmchip1/pwm0
echo 0 > enable
echo 0 > duty_cycle
echo 20000000 > period
echo normal > polarity
echo 1500000 > duty_cycle
echo 1 > enable
其中周期为 20,000,000 ns(20ms),对应 50Hz;normal 极性下,高电平时间为 1,500,000 ns(1.5ms),对应 7.5% 占空比,用于 SG90 中位控制。
echo 0 > /sys/class/pwm/pwmchip1/pwm0/enable
echo 0 > /sys/class/pwm/pwmchip1/unexport
3. 控制 PWM (Python 程序)
-
示例程序:使用
pwmchip1输出 50 Hz PWM,使 SG90 平滑、周期性地左右往返摆动。#!/usr/bin/env python3import mathimport timefrom periphery import PWMPWM_CHIP = 1PWM_CHANNEL = 0PWM_PERIOD_MS = 20.0PWM_CENTER_MS = 1.5PWM_RANGE_MS = 0.4STEPS = 200pwm = PWM(PWM_CHIP, PWM_CHANNEL)try:pwm.frequency = 50pwm.polarity = "normal"pwm.duty_cycle = PWM_CENTER_MS / PWM_PERIOD_MSpwm.enable()while True:for step in range(STEPS):phase = 2.0 * math.pi * step / STEPSpulse_ms = PWM_CENTER_MS + PWM_RANGE_MS * math.sin(phase)pwm.duty_cycle = pulse_ms / PWM_PERIOD_MStime.sleep(0.02)except KeyboardInterrupt:passfinally:pwm.duty_cycle = PWM_CENTER_MS / PWM_PERIOD_MStime.sleep(0.3)pwm.disable()pwm.close() -
打开 PWM 设备:
pwm = PWM(PWM_CHIP, PWM_CHANNEL)该代码打开指定 PWM 控制器和通道。
-
配置并输出 PWM:
pwm.frequency = 50pwm.polarity = "normal"pwm.duty_cycle = PWM_CENTER_MS / PWM_PERIOD_MSpwm.enable()设置输出频率为 50 Hz,初始脉宽为 1.5 ms,然后使能 PWM 输出。程序使用正弦曲线缓慢改变脉宽。
-
调整占空比:按照正弦曲线在 1.1~1.9 ms 之间连续修改脉宽,使舵机平滑往返摆动。
pwm.duty_cycle = pulse_ms / PWM_PERIOD_MS -
运行程序:
python3 PWM.py运行结果:

4. 控制 PWM(C 程序)
-
完整代码:通过 PWM sysfs 输出 50 Hz 控制信号,使舵机按正弦曲线平滑、周期性地左右往返摆动。
#include <errno.h>#include <math.h>#include <signal.h>#include <stdio.h>#include <sys/stat.h>#include <unistd.h>#define PWM_PATH "/sys/class/pwm/pwmchip1"#define PI 3.14159265358979323846#define STEPS 200#define CENTER_NS 1500000#define RANGE_NS 400000static volatile sig_atomic_t running = 1;static void handle_sigint(int signum){(void)signum;running = 0;}static int write_value(const char *path, const char *value){FILE *file = fopen(path, "w");if (!file) {perror(path);return -1;}fprintf(file, "%s", value);fclose(file);return 0;}int main(void){char duty_text[32];int owned = 0;struct stat st;signal(SIGINT, handle_sigint);if (stat(PWM_PATH "/pwm0", &st) == 0) {fprintf(stderr, "pwm0 already exported, reusing\n");} else if (write_value(PWM_PATH "/export", "0") < 0) {fprintf(stderr, "export pwm0 failed\n");return 1;} else {owned = 1;}usleep(100000);if (write_value(PWM_PATH "/pwm0/enable", "0") < 0 ||write_value(PWM_PATH "/pwm0/duty_cycle", "0") < 0 ||write_value(PWM_PATH "/pwm0/period", "20000000") < 0 ||write_value(PWM_PATH "/pwm0/polarity", "normal") < 0 ||write_value(PWM_PATH "/pwm0/duty_cycle", "1500000") < 0 ||write_value(PWM_PATH "/pwm0/enable", "1") < 0) {fprintf(stderr, "pwm0 configuration failed\n");goto cleanup;}while (running) {for (int step = 0; step < STEPS && running; ++step) {double phase = 2.0 * PI * step / STEPS;unsigned int pulse_ns =(unsigned int)(CENTER_NS + RANGE_NS * sin(phase));snprintf(duty_text, sizeof(duty_text), "%u", pulse_ns);if (write_value(PWM_PATH "/pwm0/duty_cycle", duty_text) < 0)running = 0;usleep(20000);}}cleanup:write_value(PWM_PATH "/pwm0/duty_cycle", "1500000");usleep(300000);write_value(PWM_PATH "/pwm0/enable", "0");if (owned) write_value(PWM_PATH "/unexport", "0");return 0;} -
导出 PWM 通道:
if (stat(PWM_PATH "/pwm0", &st) == 0) {fprintf(stderr, "pwm0 already exported, reusing\n");} else if (write_value(PWM_PATH "/export", "0") < 0) {fprintf(stderr, "export pwm0 failed\n");return 1;} else {owned = 1;}usleep(100000);先检查
pwm0目录是否已存在。若已存在(其他程序已导出),打印提示并复用,不标记所有权;否则导出通道 0 并标记owned = 1。等待 100 毫秒后进行配置。 -
设置周期和占空比:
write_value(PWM_PATH "/pwm0/duty_cycle", "0");write_value(PWM_PATH "/pwm0/period", "20000000");write_value(PWM_PATH "/pwm0/duty_cycle", "1500000");将 PWM 设置为 50 Hz,并以 1.5 ms 脉宽作为舵机中间位置。
-
控制 PWM 输出:
while (running) {for (int step = 0; step < STEPS && running; ++step) {double phase = 2.0 * PI * step / STEPS;unsigned int pulse_ns =(unsigned int)(CENTER_NS + RANGE_NS * sin(phase));snprintf(duty_text, sizeof(duty_text), "%u", pulse_ns);write_value(PWM_PATH "/pwm0/duty_cycle", duty_text);usleep(20000);}}程序按照正弦曲线在 1.1~1.9 ms 之间连续改变脉宽,使舵机平滑往返摆动。200 个步进、每步 20 ms,因此一个完整往返周期约为 4 秒。按
Ctrl+C后,信号处理函数结束循环,程序将舵机返回中间位置并关闭输出。 -
取消导出 PWM 通道:
if (owned) write_value(PWM_PATH "/unexport", "0");仅在本程序成功导出通道时才取消导出,避免影响其他程序使用的 PWM 通道。
-
交叉编译:
export PATH=<Luckfox_Aura_SDK>/tools/linux/toolchain/aarch64-rockchip1240-linux-gnu/bin:$PATHaarch64-rockchip1240-linux-gnu-gcc PWM.c -o PWM -lm