Linux PWM深度开发指南:从用户空间到设备树的完整实践
1. PWM技术基础与Linux实现机制
脉冲宽度调制(PWM)是现代嵌入式系统中广泛使用的关键技术,它通过调节数字信号的占空比来模拟不同电平的模拟信号。在Linux系统中,PWM子系统提供了标准化的接口来管理各种PWM控制器。
PWM核心参数解析:
- period:完整周期时长(纳秒),决定PWM频率
- duty_cycle:有效电平持续时间(纳秒),必须小于period
- polarity:信号极性(normal/inversed),决定有效电平是高还是低
- enable:控制PWM输出使能状态
Linux内核通过sysfs和字符设备两种方式向用户空间暴露PWM控制接口。对于嵌入式开发者而言,理解这两种接口的适用场景至关重要:
# 典型sysfs PWM路径结构
/sys/class/pwm/
└── pwmchipX/ # PWM控制器设备
├── export # 导出PWM通道
├── unexport # 取消导出
├── npwm # 通道数量
└── pwmY/ # 具体PWM通道
├── period # 周期设置
├── duty_cycle # 占空比设置
├── polarity # 极性设置
└── enable # 使能控制
2. 用户空间PWM操作实战
2.1 sysfs接口直接操作
通过shell命令可以直接操作PWM设备,这是最快速的验证方式:
# 导出PWM通道0
echo 0 > /sys/class/pwm/pwmchip0/export
# 配置周期为1ms(1kHz频率)
echo 1000000 > /sys/class/pwm/pwmchip0/pwm0/period
# 设置50%占空比
echo 500000 > /sys/class/pwm/pwmchip0/pwm0/duty_cycle
# 反转极性(可选)
echo inversed > /sys/class/pwm/pwmchip0/pwm0/polarity
# 使能输出
echo 1 > /sys/class/pwm/pwmchip0/pwm0/enable
关键注意事项:
- 修改period或duty_cycle时需先禁用PWM
- 某些控制器可能不支持运行时极性修改
- 资源冲突时会出现"Device or resource busy"错误
2.2 C语言应用程序开发
对于产品级应用,推荐使用程序化控制方式。以下是一个完整的PWM控制程序示例:
#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <unistd.h>
#include <string.h>
#include <errno.h>
#define PWM_PATH "/sys/class/pwm/pwmchip%d/pwm%d"
#define SYSFS_MAX 64
int pwm_export(int chip, int channel) {
char path[50];
snprintf(path, sizeof(path), "/sys/class/pwm/pwmchip%d/export", chip);
int fd = open(path, O_WRONLY);
if (fd < 0) {
perror("Failed to open export");
return -1;
}
char buf[10];
snprintf(buf, sizeof(buf), "%d", channel);
if (write(fd, buf, strlen(buf)) < 0) {
perror("Failed to export PWM");
close(fd);
return -1;
}
close(fd);
return 0;
}
int pwm_config(int chip, int channel, int period, int duty) {
char path[SYSFS_MAX];
int fd, ret;
// 设置周期
snprintf(path, sizeof(path), PWM_PATH"/period", chip, channel);
fd = open(path, O_WRONLY);
if (fd < 0) return -1;
char period_str[20];
snprintf(period_str, sizeof(period_str), "%d", period);
ret = write(fd, period_str, strlen(period_str));
close(fd);
if (ret < 0) return -1;
// 设置占空比
snprintf(path, sizeof(path), PWM_PATH"/duty_cycle", chip, channel);
fd = open(path, O_WRONLY);
if (fd < 0) return -1;
char duty_str[20];
snprintf(duty_str, sizeof(duty_str), "%d", duty);
ret = write(fd, duty_str, strlen(duty_str));
close(fd);
return ret < 0 ? -1 : 0;
}
int main(int argc, char **argv) {
if (argc != 5) {
printf("Usage: %s <chip> <channel> <period_ns> <duty_ns>\n", argv[0]);
return -1;
}
int chip = atoi(argv[1]);
int channel = atoi(argv[2]);
int period = atoi(argv[3]);
int duty = atoi(argv[4]);
if (pwm_export(chip, channel) < 0) {
fprintf(stderr, "PWM export failed\n");
return -1;
}
if (pwm_config(chip, channel, period, duty) < 0) {
fprintf(stderr, "PWM config failed\n");
return -1;
}
printf("PWM%d-%d configured: period=%dns, duty=%dns\n",
chip, channel, period, duty);
return 0;
}
3. 设备树配置与资源管理
3.1 基础PWM设备树节点
以I.MX6U为例,典型的PWM控制器设备树配置如下:
pwm1: pwm@02080000 {
compatible = "fsl,imx6ul-pwm", "fsl,imx27-pwm";
reg = <0x02080000 0x4000>;
interrupts = <GIC_SPI 83 IRQ_TYPE_LEVEL_HIGH>;
clocks = <&clks IMX6UL_CLK_PWM1>,
<&clks IMX6UL_CLK_PWM1>;
clock-names = "ipg", "per";
#pwm-cells = <2>;
status = "disabled";
};
3.2 解决资源冲突实战
当PWM通道被其他设备占用时(如LCD背光),需要通过设备树调整资源分配。以下是释放PWM1的两种方法:
方法一:永久性修改设备树
&lcdif {
status = "disabled";
};
&backlight {
status = "disabled";
};
方法二:U-Boot临时修改(无需重新编译)
# 在U-Boot命令行中执行
setenv fdt_disable_lcd 'fdt addr ${fdt_addr}; fdt set /backlight status disabled; fdt set /soc/aips-bus@02100000/lcdif@021c8000 status disabled'
setenv bootcmd 'run fdt_disable_lcd; run mmcboot'
saveenv
boot
3.3 多PWM通道协同配置
对于需要多个PWM通道协同工作的场景(如电机H桥控制),设备树配置示例:
pwm_motor: pwm-motor {
compatible = "pwm-motor";
pwms = <&pwm1 0 50000 0>, // 通道0,50kHz
<&pwm2 0 50000 0>; // 通道1,50kHz
pwm-names = "pwm-a", "pwm-b";
dead-time = <1000>; // 死区时间1us
};
4. 内核驱动开发进阶
4.1 PWM子系统API详解
Linux内核提供了丰富的PWM控制API:
#include <linux/pwm.h>
// 获取PWM设备
struct pwm_device *pwm_get(struct device *dev, const char *con_id);
void pwm_put(struct pwm_device *pwm);
// 配置PWM参数
int pwm_config(struct pwm_device *pwm, int duty_ns, int period_ns);
int pwm_set_polarity(struct pwm_device *pwm, enum pwm_polarity polarity);
// 启用/禁用PWM
int pwm_enable(struct pwm_device *pwm);
void pwm_disable(struct pwm_device *pwm);
4.2 完整驱动示例:PWM蜂鸣器
#include <linux/module.h>
#include <linux/platform_device.h>
#include <linux/pwm.h>
struct pwm_beeper {
struct pwm_device *pwm;
unsigned int period;
};
static int pwm_beeper_probe(struct platform_device *pdev)
{
struct pwm_beeper *beeper;
struct device *dev = &pdev->dev;
beeper = devm_kzalloc(dev, sizeof(*beeper), GFP_KERNEL);
if (!beeper)
return -ENOMEM;
beeper->pwm = devm_pwm_get(dev, NULL);
if (IS_ERR(beeper->pwm)) {
dev_err(dev, "Failed to get PWM\n");
return PTR_ERR(beeper->pwm);
}
beeper->period = 500000; // 500us period (2kHz)
pwm_config(beeper->pwm, beeper->period/2, beeper->period);
pwm_enable(beeper->pwm);
platform_set_drvdata(pdev, beeper);
return 0;
}
static int pwm_beeper_remove(struct platform_device *pdev)
{
struct pwm_beeper *beeper = platform_get_drvdata(pdev);
pwm_disable(beeper->pwm);
return 0;
}
static const struct of_device_id pwm_beeper_match[] = {
{ .compatible = "pwm-beeper" },
{ }
};
MODULE_DEVICE_TABLE(of, pwm_beeper_match);
static struct platform_driver pwm_beeper_driver = {
.driver = {
.name = "pwm-beeper",
.of_match_table = pwm_beeper_match,
},
.probe = pwm_beeper_probe,
.remove = pwm_beeper_remove,
};
module_platform_driver(pwm_beeper_driver);
5. 调试与性能优化
5.1 示波器验证技巧
使用示波器验证PWM输出时,重点关注以下参数:
- 波形频率:1/period
- 占空比:duty_cycle/period
- 上升/下降时间:反映驱动能力
- 抖动:周期稳定性
常见问题排查表:
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无输出 | 未导出或未使能 | 检查export和enable状态 |
| 频率偏差 | 时钟源配置错误 | 检查设备树时钟配置 |
| 占空比异常 | 极性设置错误 | 检查polarity设置 |
| 波形畸变 | 负载不匹配 | 增加缓冲电路 |
5.2 性能优化策略
-
降低软件开销:
- 使用硬件PWM控制器替代软件模拟
- 避免频繁修改PWM参数
-
提高精度:
// 高精度配置(64位参数) int pwm_config_extend(struct pwm_device *pwm, u64 duty_ns, u64 period_ns); -
实时性保障:
- 为PWM线程设置实时优先级
struct sched_param param = { .sched_priority = 90 }; sched_setscheduler(current, SCHED_FIFO, ¶m);
6. 典型应用场景实现
6.1 LED亮度控制
#!/usr/bin/env python3
import time
PWM_CHIP = 0
PWM_CHAN = 0
PERIOD = 1000000 # 1ms period
def set_brightness(percent):
duty = int(PERIOD * percent / 100)
with open(f'/sys/class/pwm/pwmchip{PWM_CHIP}/export', 'w') as f:
f.write(str(PWM_CHAN))
with open(f'/sys/class/pwm/pwmchip{PWM_CHIP}/pwm{PWM_CHAN}/period', 'w') as f:
f.write(str(PERIOD))
with open(f'/sys/class/pwm/pwmchip{PWM_CHIP}/pwm{PWM_CHAN}/duty_cycle', 'w') as f:
f.write(str(duty))
with open(f'/sys/class/pwm/pwmchip{PWM_CHIP}/pwm{PWM_CHAN}/enable', 'w') as f:
f.write('1')
# 呼吸灯效果
while True:
for i in range(0, 101, 5):
set_brightness(i)
time.sleep(0.05)
for i in range(100, -1, -5):
set_brightness(i)
time.sleep(0.05)
6.2 电机速度控制
对于电机控制,需要添加死区时间配置(以设备树为例):
pwm_motor: motor-controller {
compatible = "motor-control";
pwms = <&pwm4 0 50000 PWM_POLARITY_INVERTED>;
pwm-names = "motor-pwm";
dead-time = <100>; // 100ns dead time
enable-gpios = <&gpio1 12 GPIO_ACTIVE_HIGH>;
};
对应的驱动实现关键部分:
static int motor_control(struct pwm_device *pwm, int speed_percent)
{
int period = 50000; // 20kHz
int dead_time = 100;
int duty = (period - dead_time) * speed_percent / 100;
// 确保死区时间
if (duty < 0) duty = 0;
if (duty > (period - dead_time)) duty = period - dead_time;
return pwm_config(pwm, duty, period);
}
7. 高级主题:PWM捕获与测量
某些PWM控制器支持输入捕获功能,可用于测量外部PWM信号:
struct pwm_capture {
u32 period;
u32 duty_cycle;
u32 polarity;
};
int pwm_capture(struct pwm_device *pwm, struct pwm_capture *result)
{
int ret;
ret = pwm_get_state(pwm, &result->state);
if (ret)
return ret;
// 需要硬件支持捕获功能
if (!pwm->chip->ops->capture)
return -ENOTSUPP;
return pwm->chip->ops->capture(pwm->chip, pwm, result);
}
设备树中需要配置为捕获模式:
pwm_input: pwm-input {
compatible = "pwm-input";
pwms = <&pwm5 0 0 PWM_POLARITY_INVERTED>;
pwm-names = "capture";
pwm-capture;
};



被折叠的 条评论
为什么被折叠?



