从零解析RK3588 PWM驱动：Linux子系统框架与实战调试
1. RK3588 PWM硬件架构解析
RK3588作为Rockchip旗舰级处理器，其PWM控制器设计堪称嵌入式开发的瑞士军刀。我最近在调试Firefly ITX-3588J开发板时，发现这块芯片的PWM模块藏着不少宝藏特性。先说硬件配置：四组独立PWM控制器，每组支持4个通道，总共能输出16路PWM信号。这个规模足够同时控制多个散热风扇、LCD背光、电机等外设。
每路PWM的寄存器基地址都很有规律：
- PWM0: 0xfd8b0000
- PWM1: 0xfebd0000
- PWM2: 0xfebe0000
- PWM3: 0xfebf0000
实测发现每个控制器占用64KB地址空间（0x1000），这个细节在编写设备树时特别重要。记得有次调试时地址计算错误，导致PWM输出异常，后来用devmem2工具直接读取寄存器才定位到问题。
硬件支持三种工作模式让我印象深刻：
- 捕获模式：可以测量输入PWM信号的高/低电平持续时间，数据会实时更新到PWMx_PERIOD_HPC和PWMx_DUTY_LPC寄存器。我在做转速检测时就靠这个模式获取风扇的FG信号。
- 连续模式：最常用的标准PWM输出，支持左对齐和中心对齐两种波形。调试电机驱动时，中心对齐模式能显著降低电磁噪声。
- 单次触发模式：适合需要精确控制脉冲数量的场景，比如步进电机控制。
2. 官方Demo驱动深度剖析
Firefly提供的pwm-firefly-demo.c是个不错的起点，但坑也不少。这个驱动基于pwm-rockchip.c改造而来，在rk3588-firefly-demo.dtsi里可以看到设备树配置示例。要激活它需要：
- 取消rk3588-firefly-itx-3588j.dts中#include的注释
- 确保内核配置了CONFIG_PWM_FIREFLY_DEMO
我遇到过最典型的问题是用户空间控制接口缺失。虽然驱动加载后能在/sys/devices/platform下看到fd8b0030.pwm节点，但无法直接调整参数。这时候要么改驱动代码，更简单的办法是换用Linux标准PWM子系统。
通过对比官方demo和标准子系统驱动，发现几个关键差异点：
- 标准驱动通过pwmchipX目录暴露完整控制接口
- Demo驱动固定了周期和占空比，需重新编译才能修改
- 标准驱动支持动态调整极性，demo需修改设备树
建议新手先用demo驱动快速验证硬件连接，正式开发还是切换到标准子系统更高效。
3. Linux PWM子系统实战配置
要让RK3588的PWM接入Linux标准子系统，设备树配置是关键。以PWM3为例：
pwm3: pwm@febf0000 { compatible = "rockchip,rk3588-pwm"; reg = <0x0 0xfebf0000 0x0 0x10>; #pwm-cells = <3>; pinctrl-names = "default"; pinctrl-0 = <&pwm3m1_pins>; clocks = <&cru CLK_PWM3>; clock-names = "pwm"; status = "okay"; };加载驱动后，神奇的/sys/class/pwm目录就会出现对应设备。具体操作流程：
# 进入PWM控制目录 cd /sys/class/pwm/pwmchip0 # 导出PWM通道0 echo 0 > export # 配置参数 cd pwm0 echo 1000000 > period # 周期1ms echo 500000 > duty_cycle # 占空比50% echo normal > polarity # 正常极性 echo 1 > enable # 启动输出实测时发现个细节：RK3588的period参数实际对应的是波形周期减1，这点在芯片手册里有说明。如果设置period=10000，实际会产生10001个时钟周期的波形。
4. 调试技巧与常见问题解决
调试PWM就像玩示波器，几个实用技巧分享给大家：
硬件排查三板斧：
- 先用万用表量电压：正常应该在0-VCC间波动
- 示波器看波形：确认频率/占空比是否符合预期
- 检查引脚复用：确保pinctrl配置正确
软件调试命令：
# 查看PWM设备注册情况 dmesg | grep pwm # 检查时钟是否使能 cat /sys/kernel/debug/clk/clk_summary | grep pwm # 直接读取寄存器值 devmem2 0xfebf0000常见问题处理：
- 无输出信号：先检查设备树status是否为"okay"，再看clock是否正常。有次我漏了clock-names配置，折腾了半天。
- 频率偏差大：可能是parent clock设置不当，调整CRU时钟树解决。
- 占空比异常：检查duty_cycle是否超过period值，硬件会限制最大占空比。
有个特别容易踩的坑：RK3588的PWM时钟源默认是24MHz，如果需要更高精度，可以通过CRU模块切换时钟源。我在驱动RGB灯带时，就换用了100MHz时钟源获得更精细的控制。
最后分享个真实案例：调试电机驱动时发现PWM输出不稳定，最终发现是电源噪声导致。解决方法是在设备树添加pwm-supply属性指定独立LDO供电，同时软件上增加dead-time配置。这些经验都是手册上不会写的实战技巧。