跳到主要内容

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设备树节点
11PWM3_CH2_M1GPIO5_C2pwm3_8ch_2

2.2 设备树配置​

  1. 板级设备树路径:

    <Luckfox Aura SDK>/sysdrv/source/kernel/arch/arm64/boot/dts/rockchip/rv1126b-luckfox-aura.dtsi
  2. 开启物理引脚 11 对应的 PWM3 通道 2:

    &pwm3_8ch_2 {
    pinctrl-names = "active";
    pinctrl-0 = <&pwm3m1_ch2_pins>;
    status = "okay";
    };
  3. 编译内核:

    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 程序)​

  1. 示例程序:使用 pwmchip1 输出 50 Hz PWM,使 SG90 平滑、周期性地左右往返摆动。

    #!/usr/bin/env python3

    import math
    import time
    from periphery import PWM

    PWM_CHIP = 1
    PWM_CHANNEL = 0
    PWM_PERIOD_MS = 20.0
    PWM_CENTER_MS = 1.5
    PWM_RANGE_MS = 0.4
    STEPS = 200

    pwm = PWM(PWM_CHIP, PWM_CHANNEL)

    try:
    pwm.frequency = 50
    pwm.polarity = "normal"
    pwm.duty_cycle = PWM_CENTER_MS / PWM_PERIOD_MS
    pwm.enable()

    while True:
    for step in range(STEPS):
    phase = 2.0 * math.pi * step / STEPS
    pulse_ms = PWM_CENTER_MS + PWM_RANGE_MS * math.sin(phase)
    pwm.duty_cycle = pulse_ms / PWM_PERIOD_MS
    time.sleep(0.02)
    except KeyboardInterrupt:
    pass
    finally:
    pwm.duty_cycle = PWM_CENTER_MS / PWM_PERIOD_MS
    time.sleep(0.3)
    pwm.disable()
    pwm.close()
  2. 打开 PWM 设备:

    pwm = PWM(PWM_CHIP, PWM_CHANNEL)

    该代码打开指定 PWM 控制器和通道。

  3. 配置并输出 PWM:

    pwm.frequency = 50
    pwm.polarity = "normal"
    pwm.duty_cycle = PWM_CENTER_MS / PWM_PERIOD_MS
    pwm.enable()

    设置输出频率为 50 Hz,初始脉宽为 1.5 ms,然后使能 PWM 输出。程序使用正弦曲线缓慢改变脉宽。

  4. 调整占空比:按照正弦曲线在 1.1~1.9 ms 之间连续修改脉宽,使舵机平滑往返摆动。

    pwm.duty_cycle = pulse_ms / PWM_PERIOD_MS
  5. 运行程序:

    python3 PWM.py

    运行结果:

4. 控制 PWM(C 程序)​

  1. 完整代码:通过 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 400000

    static 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;
    }
  2. 导出 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 毫秒后进行配置。

  3. 设置周期和占空比:

    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 脉宽作为舵机中间位置。

  4. 控制 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 后,信号处理函数结束循环,程序将舵机返回中间位置并关闭输出。

  5. 取消导出 PWM 通道:

    if (owned) write_value(PWM_PATH "/unexport", "0");

    仅在本程序成功导出通道时才取消导出,避免影响其他程序使用的 PWM 通道。

  6. 交叉编译:

    export PATH=<Luckfox_Aura_SDK>/tools/linux/toolchain/aarch64-rockchip1240-linux-gnu/bin:$PATH
    aarch64-rockchip1240-linux-gnu-gcc PWM.c -o PWM -lm