1. 项目概述从零开始在A40i开发板上点亮你的第一路PWM最近在做一个工业控制的小项目用到了飞凌的OKA40i-C开发板其中有一个关键功能需要通过PWM脉冲宽度调制信号来控制一个风扇的转速。虽然A40i芯片手册里写着支持8路PWM但默认的BSP板级支持包镜像可能并没有把所有通道都配置好。就像你买了个八通道的音响但出厂只给你接好了两个喇叭想用其他的你得自己动手把线接上。这篇文章我就以添加和测试PWM4这一路为例把整个从设备树DTS修改、内核配置到用户空间测试的完整流程走一遍。这个过程本质上是在告诉Linux内核“嘿芯片上这个叫PWM4的硬件模块我现在要用了它的引脚是PB20相关时钟和寄存器配置是这样的请把它管理起来。” 无论你是想驱动电机、调光灯亮度还是生成特定的控制波形这个打通硬件到应用层的基础步骤都是类似的。虽然我基于的是飞凌A40i平台和Linux 3.10内核但思路和方法对于其他ARM平台如全志、瑞芯微、NXP等的Linux开发均有很高的参考价值你只需要根据自己平台的芯片手册和内核代码结构进行“因地制宜”的修改。2. 核心思路解析为什么修改设备树是第一步在开始动手前我们得先搞清楚Linux内核是如何管理像PWM这样的片上外设的。这关系到整个操作的“为什么”理解了它以后遇到I2C、SPI、UART等其他外设你也能触类旁通。2.1 设备树Device Tree的角色硬件的“说明书”想象一下你主板上插了各种各样的卡网卡、声卡、显卡在传统的PC架构中系统启动时会进行“枚举”去问每个PCI插槽“你是谁你有什么能力” 这就是所谓的“即插即用”。但在嵌入式世界尤其是ARM SoC系统级芯片里PWM、GPIO、I2C这些外设都是焊死在芯片内部的它们的地址、中断号都是固定的。内核需要一份固定的“清单”来知道它们的存在和具体信息。这份清单就是设备树Device Tree。它以一个.dts或.dtsi文件的形式存在用一种结构化的语言描述了整个硬件平台CPU是什么内存多大有哪些外设每个外设的寄存器物理地址是多少用了哪个中断线对应哪个引脚等等。内核在启动时会读取这个由Bootloader传递过来的设备树二进制文件.dtb然后根据这份“说明书”来逐个初始化和驱动这些硬件。所以我们要启用PWM4首要任务就是在这份“说明书”里添加上关于PWM4的详细描述告诉内核“这里有一个PWM控制器它的家寄存器基地址在0x01c23400它控制着PB20这个引脚。”2.2 PWM驱动框架内核提供的标准“插座”Linux内核为各类硬件提供了统一的驱动框架PWM也不例外。内核中的PWM子系统drivers/pwm/定义了一套标准的接口。芯片厂商如全志需要根据这套接口实现自己芯片的PWM控制器驱动比如pwm-sunxi.c。我们的设备树描述最终会被这个驱动读取。驱动根据描述去配置具体的硬件寄存器并将这个PWM通道抽象成一个设备文件暴露在/sys/class/pwm/目录下。用户空间程序比如我们的测试脚本通过读写这些文件如period,duty_cycle,enable就能间接控制硬件而无需关心底层寄存器是如何操作的。这大大简化了应用开发。因此我们的核心工作流非常清晰修改设备树告诉内核驱动“硬件长这样”驱动根据设备树信息初始化硬件并创建标准接口我们通过标准接口来控制硬件。3. 实操详解为A40i添加PWM4通道现在我们进入实战环节。请确保你有一个基于飞凌OKA40i-C开发板的Linux内核源码编译环境。以下路径均以飞凌提供的标准BSP源码为例。3.1 第一步修改设备树源文件DTS设备树描述通常分层次。芯片级的通用定义在一个.dtsiinclude文件中板级的具体配置在.dts文件中。对于A40i内核标识为sun8iw11p1我们首先需要修改芯片级的定义文件。定位文件找到内核源码中的设备树文件。通常路径是arch/arm/boot/dts/sun8iw11p1.dtsi这个文件描述了A40i这颗芯片内部所有可能的外设资源。添加PWM控制器节点我们需要在文件中找到pwm相关的节点。通常PWM控制器会被定义为一个pwm节点其内部包含多个子节点如pwm0,pwm1...。我们需要在pwm节点内添加对pwm4的引用并单独定义pwm4这个子节点。找到类似以下结构的地方可能已有pwm0到pwm3的定义pwm: pwm01c23400 { compatible allwinner,sunxi-pwm; reg 0x0 0x01c23400 0x0 0x154; pwm-number 1; pwm-base 0x4; pwms pwm4; // 关键将pwm4添加到pwms列表中 };注意pwm-number和pwm-base这里表示这个PWM控制器实例管理着从pwm-base4开始的pwm-number1个PWM通道即只管理pwm4。如果你要同时启用多个通道需要相应修改。定义pwm4子节点紧接着在文件合适的位置通常在pwm节点附近或末尾添加pwm4子节点的详细定义pwm4: pwm401c23400 { compatible allwinner,sunxi-pwm4; pinctrl-names active, sleep; reg_base 0x01c23400; // 以下是一系列寄存器偏移量和位域定义直接决定了硬件行为 reg_peci_offset 0x00; reg_peci_shift 0x04; reg_peci_width 0x01; // ... (此处省略大量类似的reg_*配置详见你手头的BSP或芯片手册) reg_active_offset 0xe4; reg_active_shift 0x00; reg_active_width 0x10; };重要提示上面这一大串reg_*配置是驱动用来定位和操作PWM4特定寄存器的“地图”。它们的值必须严格对应A40i用户手册中PWM控制器的寄存器描述。不同内核版本、不同BSP供应商提供的定义可能略有不同。最可靠的做法是参考你所用BSP中已有PWM通道如pwm0的定义进行仿写。切勿随意填写踩坑记录我曾经直接复制了网络上一份H3芯片的PWM配置到A40i上导致生成的PWM频率完全不对。原因是不同系列芯片的PWM控制器寄存器布局可能有差异。务必以官方BSP或芯片手册为准。3.2 第二步配置板级引脚复用Sys_config.fex 或 Pinctrl设备树描述了硬件模块本身但PWM信号要从哪个物理引脚输出呢这就需要配置引脚复用功能。在飞凌的BSP中这部分配置通常在sys_config.fex文件中对于较新的内核可能直接使用设备树中的pinctrl节点。定位文件在BSP根目录或特定板级目录下找到sys_config.fex。释放引脚并配置PWM释放引脚PB20这个引脚可能默认被其他功能占用比如可能是TWI2I2C的某个引脚。我们需要先禁用它。[twi2] twi2_used 0 ; 将twi2设置为未使用释放其占用的引脚配置PWM4在文件中添加或修改[pwm4]段。[pwm4] pwm_used 1 ; 1表示启用pwm4 pwm_positive port:PB2040 ; 输出引脚为PB20功能复用号为4驱动强度等参数为0默认配置休眠状态可选但建议为了在系统休眠时正确设置引脚状态防止漏电通常需要配置suspend段。[pwm4_suspend] pwm_positive port:PB2070 ; 休眠时将PB20设置为输入模式功能7通常代表输入并禁用上拉这里的4和7是A40i芯片手册中定义的PB20引脚功能复用编号MUX值。4代表PWM功能7通常代表通用输入GPIO Input。具体编号请查阅芯片的PIO章节。3.3 第三步编译与烧写完成以上修改后就需要重新编译内核和设备树并更新到开发板。编译内核和设备树# 在BSP根目录下通常有编译脚本 ./build.sh kernel # 或者手动执行 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- -j8编译成功后新的设备树二进制文件sun8iw11p1-oka40i-c.dtb或类似名称会生成在arch/arm/boot/dts/目录下。更新系统将新编译的内核镜像zImage和设备树文件.dtb烧写到开发板。方法取决于你的启动方式SD卡、eMMC、网络TFTP等。飞凌通常提供PhoenixCard烧写SD卡或LiveSuit烧写eMMC工具。将新文件替换掉SD卡或eMMC对应分区中的旧文件即可。验证修改开发板重启后进入系统检查PWM设备是否成功创建。ls /sys/class/pwm/你应该能看到一个名为pwmchip4的目录。如果没看到请检查内核启动日志dmesg | grep pwm查看是否有错误信息。确认设备树和sys_config.fex修改是否正确特别是寄存器地址和引脚复用号。确认编译和烧写过程无误。4. 用户空间测试让PWM输出方波硬件和驱动层配置好后我们就可以在用户空间轻松控制了。Linux PWM子系统通过sysfs接口暴露控制参数路径通常是/sys/class/pwm/pwmchipN/pwmM/其中N是PWM控制器编号对应我们设备树中的pwm-baseM是该控制器下的通道索引通常从0开始。4.1 基础测试生成1kHz占空比50%的方波导出PWM通道首先需要“导出”通道以创建控制接口。echo 0 /sys/class/pwm/pwmchip4/export这会在pwmchip4目录下创建一个pwm0子目录。这里的0表示使用该PWM控制器的第0个通道对应我们添加的pwm4。设置周期和占空比周期和占空比都以**纳秒ns**为单位。周期period一个完整PWM波的时长决定了频率。频率 1 / 周期。例如1ms的周期对应1kHz频率。占空比duty_cycle在一个周期内高电平持续的时间。占空比 duty_cycle / period。让我们生成一个1kHz周期1,000,000 ns占空比50%的方波echo 1000000 /sys/class/pwm/pwmchip4/pwm0/period # 设置周期为1,000,000 ns (1kHz) echo 500000 /sys/class/pwm/pwmchip4/pwm0/duty_cycle # 设置高电平时间为500,000 ns (占空比50%)使能输出echo 1 /sys/class/pwm/pwmchip4/pwm0/enable此时用示波器或逻辑分析仪连接开发板的PB20引脚和GND应该能测量到一个标准的1kHz方波。关闭输出echo 0 /sys/class/pwm/pwmchip4/pwm0/enable4.2 进阶测试生成2.4kHz的方波我们来计算一下频率为2.4kHz则周期 T 1 / 2400 Hz ≈ 416,667 ns。如果我们想要一个50%占空比的方波那么高电平时间就是 416,667 / 2 ≈ 208,333 ns。但注意duty_cycle必须小于等于period。操作步骤如下echo 0 /sys/class/pwm/pwmchip4/pwm0/enable # 先关闭输出 echo 208333 /sys/class/pwm/pwmchip4/pwm0/duty_cycle # 设置高电平时间 echo 416667 /sys/class/pwm/pwmchip4/pwm0/period # 设置周期 echo 1 /sys/class/pwm/pwmchip4/pwm0/enable # 重新使能输出再次测量应该能得到一个2.4kHz的方波。实操心得修改period或duty_cycle时最好先disablePWM输出。虽然有些驱动支持运行时修改但先禁用再修改能确保波形切换的稳定避免产生毛刺或错误的脉冲。这是一个良好的编程习惯。4.3 精度与限制探讨你可能会发现设置period416667后实际测得的频率可能不是精确的2.4kHz可能是2.399kHz或2.401kHz。这是因为PWM输出的最终频率受到时钟源精度和分频器分辨率的限制。时钟源A40i的PWM控制器通常使用APB总线时钟例如24MHz或外部晶振作为时钟源。驱动中通过reg_clk_src_offset等参数配置。分频器reg_prescal_offset对应的预分频寄存器可以将时钟源分频。reg_clk_div_m_offset可能对应另一个分频系数。周期计数器reg_entire_width定义了周期计数器的位宽这里是16位这意味着周期值period在驱动内部会被转换成一个基于分频后时钟的计数值。这个转换过程可能存在四舍五入。因此你通过sysfs设置的纳秒值驱动会将其转换为最接近的硬件可实现的计数值。公式大致为计数值 (period_ns * 时钟频率_Hz) / (分频系数 * 10^9)。所以最终输出频率是离散的而非连续可调。在要求极高精度的场合如音频可能需要选择更高精度的时钟源或使用芯片的专用PWM定时器。5. 常见问题与深度排查指南在实际操作中你几乎一定会遇到问题。下面是我踩过的一些坑和对应的排查思路。5.1 问题速查表问题现象可能原因排查步骤/sys/class/pwm/下没有pwmchip41. 设备树未编译进内核或修改未生效。2. 设备树节点语法错误。3. PWM驱动未编译或加载。1. 检查内核.config确保CONFIG_PWM_SUNXIy。2. 运行dmesg | grep -i pwm查看内核启动日志。3. 使用lsmod确认pwm_sunxi模块是否加载如果不是内置驱动。4. 用dtc工具反编译烧录的.dtb文件确认修改已存在。能看见pwmchip4但export失败1. 该PWM通道已被其他驱动占用如引脚复用冲突。2. 设备树中寄存器配置错误驱动初始化失败。1. 再次确认sys_config.fex中相关引脚如TWI2已被释放。2. 查看dmesg寻找PWM驱动初始化时的错误信息。3. 使用cat /sys/kernel/debug/pinctrl/pio/pinmux-pins查看PB20引脚当前复用状态。export成功但设置period/duty_cycle时报错如Invalid argument1. 写入的值超出硬件支持范围。2. 单位错误驱动期望纳秒但你可能错误计算。1. 计算理论值最小周期 (分频系数) / 时钟频率。例如时钟24MHz最小分频1则最小周期约41.67ns24MHz。你设置的值不能小于这个值。2. 检查计算过程确保单位是纳秒。设置无误但引脚无输出1. PWM未使能enable0。2. 示波器探头接触不良或接地不对。3. 引脚配置错误实际输出到了其他引脚。4. 硬件问题如该引脚损坏。1. 确认已执行echo 1 enable。2. 用echo 1 /sys/class/gpio/export等方式先将PB20配置为GPIO输出高/低电平测试引脚和测量工具是否正常。3. 仔细核对设备树和sys_config.fex中的引脚名PB20是否完全正确大小写敏感。输出频率与设置值偏差较大1. 时钟源配置错误。2. 设备树中reg_*寄存器分频参数计算有误。1. 这是最棘手的问题。需要深入分析驱动代码drivers/pwm/pwm-sunxi.c看它如何根据period_ns计算寄存器值。可以尝试在驱动中添加打印输出实际计算出的分频系数和计数值。5.2 高级调试技巧使用内核调试信息当问题比较复杂时打开内核的动态调试信息非常有用。启用PWM驱动调试日志# 在开发板终端上需要内核支持动态调试 echo file pwm-sunxi.c p /sys/kernel/debug/dynamic_debug/control然后重新进行export和配置操作使用dmesg -w实时查看详细的驱动内部执行流程包括寄存器读写值、计算过程等。直接读取寄存器状态仅限高级用户如果怀疑驱动配置不对可以绕过驱动直接使用devmem工具如果busybox已编译此命令读取PWM控制器寄存器与芯片手册对比。# 读取PWM4控制寄存器示例地址需查手册确认 devmem 0x01c23440 32这能帮你确认硬件是否真的被配置成了PWM模式以及分频器、计数器等是否按预期工作。5.3 从Sysfs到实际应用编写一个简单的控制脚本测试通过后最终我们要集成到应用程序中。这里提供一个简单的Bash脚本示例它可以平滑地改变LED亮度假设LED通过PB20引脚控制#!/bin/bash PWM_PATH/sys/class/pwm/pwmchip4/pwm0 # 初始化PWM频率设为1kHz echo 0 /sys/class/pwm/pwmchip4/export 2/dev/null echo 1000000 $PWM_PATH/period # 呼吸灯效果 while true; do for duty in $(seq 0 10000 1000000); do echo $duty $PWM_PATH/duty_cycle usleep 10000 # 10ms done for duty in $(seq 1000000 -10000 0); do echo $duty $PWM_PATH/duty_cycle usleep 10000 done done在C/C程序中你只需要使用标准的文件操作APIopen,write,close来读写/sys/class/pwm/下的那些文件即可非常简单。6. 总结与扩展思考走完这一遍你应该已经成功在A40i开发板上激活并控制了PWM4。整个过程的核心可以概括为通过设备树向内核“申报”硬件资源通过Sysfs接口从用户空间进行控制。这是一个标准的Linux驱动应用模式。对于更复杂的项目你可能会考虑多路PWM同步如果需要多路完全同步的PWM例如驱动全彩LED需要查看芯片手册某些PWM控制器可能有主从模式或同步触发功能。更高精度需求如果24MHz时钟源的分辨率不够可以尝试寻找其他时钟源如PLL并在设备树中正确配置reg_clk_src_offset等参数。使用PWM框架的API在内核驱动中其他模块如背光驱动pwm-backlight可以直接调用PWM子系统提供的API这比Sysfs更高效。如果你的应用是内核模块这是更专业的方式。设备树覆盖Device Tree Overlay对于产品化开发频繁修改核心设备树并重新编译整个内核镜像是不方便的。可以研究使用动态设备树覆盖DTBO技术在系统启动后动态加载针对PWM的配置片段。最后一点个人体会嵌入式Linux开发尤其是外设驱动三分靠代码七分靠手册Datasheet。A40i的用户手册特别是PIO和PWM章节和内核源码中的驱动代码drivers/pwm/pwm-sunxi.c是你最好的老师。遇到问题时静下心来对照手册和代码分析往往比在网上漫无目的地搜索更有效率。希望这篇基于实际项目的笔记能帮你少走些弯路。
A40i开发板PWM4配置实战：从设备树修改到用户空间控制
发布时间：2026/5/20 12:09:39
1. 项目概述从零开始在A40i开发板上点亮你的第一路PWM最近在做一个工业控制的小项目用到了飞凌的OKA40i-C开发板其中有一个关键功能需要通过PWM脉冲宽度调制信号来控制一个风扇的转速。虽然A40i芯片手册里写着支持8路PWM但默认的BSP板级支持包镜像可能并没有把所有通道都配置好。就像你买了个八通道的音响但出厂只给你接好了两个喇叭想用其他的你得自己动手把线接上。这篇文章我就以添加和测试PWM4这一路为例把整个从设备树DTS修改、内核配置到用户空间测试的完整流程走一遍。这个过程本质上是在告诉Linux内核“嘿芯片上这个叫PWM4的硬件模块我现在要用了它的引脚是PB20相关时钟和寄存器配置是这样的请把它管理起来。” 无论你是想驱动电机、调光灯亮度还是生成特定的控制波形这个打通硬件到应用层的基础步骤都是类似的。虽然我基于的是飞凌A40i平台和Linux 3.10内核但思路和方法对于其他ARM平台如全志、瑞芯微、NXP等的Linux开发均有很高的参考价值你只需要根据自己平台的芯片手册和内核代码结构进行“因地制宜”的修改。2. 核心思路解析为什么修改设备树是第一步在开始动手前我们得先搞清楚Linux内核是如何管理像PWM这样的片上外设的。这关系到整个操作的“为什么”理解了它以后遇到I2C、SPI、UART等其他外设你也能触类旁通。2.1 设备树Device Tree的角色硬件的“说明书”想象一下你主板上插了各种各样的卡网卡、声卡、显卡在传统的PC架构中系统启动时会进行“枚举”去问每个PCI插槽“你是谁你有什么能力” 这就是所谓的“即插即用”。但在嵌入式世界尤其是ARM SoC系统级芯片里PWM、GPIO、I2C这些外设都是焊死在芯片内部的它们的地址、中断号都是固定的。内核需要一份固定的“清单”来知道它们的存在和具体信息。这份清单就是设备树Device Tree。它以一个.dts或.dtsi文件的形式存在用一种结构化的语言描述了整个硬件平台CPU是什么内存多大有哪些外设每个外设的寄存器物理地址是多少用了哪个中断线对应哪个引脚等等。内核在启动时会读取这个由Bootloader传递过来的设备树二进制文件.dtb然后根据这份“说明书”来逐个初始化和驱动这些硬件。所以我们要启用PWM4首要任务就是在这份“说明书”里添加上关于PWM4的详细描述告诉内核“这里有一个PWM控制器它的家寄存器基地址在0x01c23400它控制着PB20这个引脚。”2.2 PWM驱动框架内核提供的标准“插座”Linux内核为各类硬件提供了统一的驱动框架PWM也不例外。内核中的PWM子系统drivers/pwm/定义了一套标准的接口。芯片厂商如全志需要根据这套接口实现自己芯片的PWM控制器驱动比如pwm-sunxi.c。我们的设备树描述最终会被这个驱动读取。驱动根据描述去配置具体的硬件寄存器并将这个PWM通道抽象成一个设备文件暴露在/sys/class/pwm/目录下。用户空间程序比如我们的测试脚本通过读写这些文件如period,duty_cycle,enable就能间接控制硬件而无需关心底层寄存器是如何操作的。这大大简化了应用开发。因此我们的核心工作流非常清晰修改设备树告诉内核驱动“硬件长这样”驱动根据设备树信息初始化硬件并创建标准接口我们通过标准接口来控制硬件。3. 实操详解为A40i添加PWM4通道现在我们进入实战环节。请确保你有一个基于飞凌OKA40i-C开发板的Linux内核源码编译环境。以下路径均以飞凌提供的标准BSP源码为例。3.1 第一步修改设备树源文件DTS设备树描述通常分层次。芯片级的通用定义在一个.dtsiinclude文件中板级的具体配置在.dts文件中。对于A40i内核标识为sun8iw11p1我们首先需要修改芯片级的定义文件。定位文件找到内核源码中的设备树文件。通常路径是arch/arm/boot/dts/sun8iw11p1.dtsi这个文件描述了A40i这颗芯片内部所有可能的外设资源。添加PWM控制器节点我们需要在文件中找到pwm相关的节点。通常PWM控制器会被定义为一个pwm节点其内部包含多个子节点如pwm0,pwm1...。我们需要在pwm节点内添加对pwm4的引用并单独定义pwm4这个子节点。找到类似以下结构的地方可能已有pwm0到pwm3的定义pwm: pwm01c23400 { compatible allwinner,sunxi-pwm; reg 0x0 0x01c23400 0x0 0x154; pwm-number 1; pwm-base 0x4; pwms pwm4; // 关键将pwm4添加到pwms列表中 };注意pwm-number和pwm-base这里表示这个PWM控制器实例管理着从pwm-base4开始的pwm-number1个PWM通道即只管理pwm4。如果你要同时启用多个通道需要相应修改。定义pwm4子节点紧接着在文件合适的位置通常在pwm节点附近或末尾添加pwm4子节点的详细定义pwm4: pwm401c23400 { compatible allwinner,sunxi-pwm4; pinctrl-names active, sleep; reg_base 0x01c23400; // 以下是一系列寄存器偏移量和位域定义直接决定了硬件行为 reg_peci_offset 0x00; reg_peci_shift 0x04; reg_peci_width 0x01; // ... (此处省略大量类似的reg_*配置详见你手头的BSP或芯片手册) reg_active_offset 0xe4; reg_active_shift 0x00; reg_active_width 0x10; };重要提示上面这一大串reg_*配置是驱动用来定位和操作PWM4特定寄存器的“地图”。它们的值必须严格对应A40i用户手册中PWM控制器的寄存器描述。不同内核版本、不同BSP供应商提供的定义可能略有不同。最可靠的做法是参考你所用BSP中已有PWM通道如pwm0的定义进行仿写。切勿随意填写踩坑记录我曾经直接复制了网络上一份H3芯片的PWM配置到A40i上导致生成的PWM频率完全不对。原因是不同系列芯片的PWM控制器寄存器布局可能有差异。务必以官方BSP或芯片手册为准。3.2 第二步配置板级引脚复用Sys_config.fex 或 Pinctrl设备树描述了硬件模块本身但PWM信号要从哪个物理引脚输出呢这就需要配置引脚复用功能。在飞凌的BSP中这部分配置通常在sys_config.fex文件中对于较新的内核可能直接使用设备树中的pinctrl节点。定位文件在BSP根目录或特定板级目录下找到sys_config.fex。释放引脚并配置PWM释放引脚PB20这个引脚可能默认被其他功能占用比如可能是TWI2I2C的某个引脚。我们需要先禁用它。[twi2] twi2_used 0 ; 将twi2设置为未使用释放其占用的引脚配置PWM4在文件中添加或修改[pwm4]段。[pwm4] pwm_used 1 ; 1表示启用pwm4 pwm_positive port:PB2040 ; 输出引脚为PB20功能复用号为4驱动强度等参数为0默认配置休眠状态可选但建议为了在系统休眠时正确设置引脚状态防止漏电通常需要配置suspend段。[pwm4_suspend] pwm_positive port:PB2070 ; 休眠时将PB20设置为输入模式功能7通常代表输入并禁用上拉这里的4和7是A40i芯片手册中定义的PB20引脚功能复用编号MUX值。4代表PWM功能7通常代表通用输入GPIO Input。具体编号请查阅芯片的PIO章节。3.3 第三步编译与烧写完成以上修改后就需要重新编译内核和设备树并更新到开发板。编译内核和设备树# 在BSP根目录下通常有编译脚本 ./build.sh kernel # 或者手动执行 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- -j8编译成功后新的设备树二进制文件sun8iw11p1-oka40i-c.dtb或类似名称会生成在arch/arm/boot/dts/目录下。更新系统将新编译的内核镜像zImage和设备树文件.dtb烧写到开发板。方法取决于你的启动方式SD卡、eMMC、网络TFTP等。飞凌通常提供PhoenixCard烧写SD卡或LiveSuit烧写eMMC工具。将新文件替换掉SD卡或eMMC对应分区中的旧文件即可。验证修改开发板重启后进入系统检查PWM设备是否成功创建。ls /sys/class/pwm/你应该能看到一个名为pwmchip4的目录。如果没看到请检查内核启动日志dmesg | grep pwm查看是否有错误信息。确认设备树和sys_config.fex修改是否正确特别是寄存器地址和引脚复用号。确认编译和烧写过程无误。4. 用户空间测试让PWM输出方波硬件和驱动层配置好后我们就可以在用户空间轻松控制了。Linux PWM子系统通过sysfs接口暴露控制参数路径通常是/sys/class/pwm/pwmchipN/pwmM/其中N是PWM控制器编号对应我们设备树中的pwm-baseM是该控制器下的通道索引通常从0开始。4.1 基础测试生成1kHz占空比50%的方波导出PWM通道首先需要“导出”通道以创建控制接口。echo 0 /sys/class/pwm/pwmchip4/export这会在pwmchip4目录下创建一个pwm0子目录。这里的0表示使用该PWM控制器的第0个通道对应我们添加的pwm4。设置周期和占空比周期和占空比都以**纳秒ns**为单位。周期period一个完整PWM波的时长决定了频率。频率 1 / 周期。例如1ms的周期对应1kHz频率。占空比duty_cycle在一个周期内高电平持续的时间。占空比 duty_cycle / period。让我们生成一个1kHz周期1,000,000 ns占空比50%的方波echo 1000000 /sys/class/pwm/pwmchip4/pwm0/period # 设置周期为1,000,000 ns (1kHz) echo 500000 /sys/class/pwm/pwmchip4/pwm0/duty_cycle # 设置高电平时间为500,000 ns (占空比50%)使能输出echo 1 /sys/class/pwm/pwmchip4/pwm0/enable此时用示波器或逻辑分析仪连接开发板的PB20引脚和GND应该能测量到一个标准的1kHz方波。关闭输出echo 0 /sys/class/pwm/pwmchip4/pwm0/enable4.2 进阶测试生成2.4kHz的方波我们来计算一下频率为2.4kHz则周期 T 1 / 2400 Hz ≈ 416,667 ns。如果我们想要一个50%占空比的方波那么高电平时间就是 416,667 / 2 ≈ 208,333 ns。但注意duty_cycle必须小于等于period。操作步骤如下echo 0 /sys/class/pwm/pwmchip4/pwm0/enable # 先关闭输出 echo 208333 /sys/class/pwm/pwmchip4/pwm0/duty_cycle # 设置高电平时间 echo 416667 /sys/class/pwm/pwmchip4/pwm0/period # 设置周期 echo 1 /sys/class/pwm/pwmchip4/pwm0/enable # 重新使能输出再次测量应该能得到一个2.4kHz的方波。实操心得修改period或duty_cycle时最好先disablePWM输出。虽然有些驱动支持运行时修改但先禁用再修改能确保波形切换的稳定避免产生毛刺或错误的脉冲。这是一个良好的编程习惯。4.3 精度与限制探讨你可能会发现设置period416667后实际测得的频率可能不是精确的2.4kHz可能是2.399kHz或2.401kHz。这是因为PWM输出的最终频率受到时钟源精度和分频器分辨率的限制。时钟源A40i的PWM控制器通常使用APB总线时钟例如24MHz或外部晶振作为时钟源。驱动中通过reg_clk_src_offset等参数配置。分频器reg_prescal_offset对应的预分频寄存器可以将时钟源分频。reg_clk_div_m_offset可能对应另一个分频系数。周期计数器reg_entire_width定义了周期计数器的位宽这里是16位这意味着周期值period在驱动内部会被转换成一个基于分频后时钟的计数值。这个转换过程可能存在四舍五入。因此你通过sysfs设置的纳秒值驱动会将其转换为最接近的硬件可实现的计数值。公式大致为计数值 (period_ns * 时钟频率_Hz) / (分频系数 * 10^9)。所以最终输出频率是离散的而非连续可调。在要求极高精度的场合如音频可能需要选择更高精度的时钟源或使用芯片的专用PWM定时器。5. 常见问题与深度排查指南在实际操作中你几乎一定会遇到问题。下面是我踩过的一些坑和对应的排查思路。5.1 问题速查表问题现象可能原因排查步骤/sys/class/pwm/下没有pwmchip41. 设备树未编译进内核或修改未生效。2. 设备树节点语法错误。3. PWM驱动未编译或加载。1. 检查内核.config确保CONFIG_PWM_SUNXIy。2. 运行dmesg | grep -i pwm查看内核启动日志。3. 使用lsmod确认pwm_sunxi模块是否加载如果不是内置驱动。4. 用dtc工具反编译烧录的.dtb文件确认修改已存在。能看见pwmchip4但export失败1. 该PWM通道已被其他驱动占用如引脚复用冲突。2. 设备树中寄存器配置错误驱动初始化失败。1. 再次确认sys_config.fex中相关引脚如TWI2已被释放。2. 查看dmesg寻找PWM驱动初始化时的错误信息。3. 使用cat /sys/kernel/debug/pinctrl/pio/pinmux-pins查看PB20引脚当前复用状态。export成功但设置period/duty_cycle时报错如Invalid argument1. 写入的值超出硬件支持范围。2. 单位错误驱动期望纳秒但你可能错误计算。1. 计算理论值最小周期 (分频系数) / 时钟频率。例如时钟24MHz最小分频1则最小周期约41.67ns24MHz。你设置的值不能小于这个值。2. 检查计算过程确保单位是纳秒。设置无误但引脚无输出1. PWM未使能enable0。2. 示波器探头接触不良或接地不对。3. 引脚配置错误实际输出到了其他引脚。4. 硬件问题如该引脚损坏。1. 确认已执行echo 1 enable。2. 用echo 1 /sys/class/gpio/export等方式先将PB20配置为GPIO输出高/低电平测试引脚和测量工具是否正常。3. 仔细核对设备树和sys_config.fex中的引脚名PB20是否完全正确大小写敏感。输出频率与设置值偏差较大1. 时钟源配置错误。2. 设备树中reg_*寄存器分频参数计算有误。1. 这是最棘手的问题。需要深入分析驱动代码drivers/pwm/pwm-sunxi.c看它如何根据period_ns计算寄存器值。可以尝试在驱动中添加打印输出实际计算出的分频系数和计数值。5.2 高级调试技巧使用内核调试信息当问题比较复杂时打开内核的动态调试信息非常有用。启用PWM驱动调试日志# 在开发板终端上需要内核支持动态调试 echo file pwm-sunxi.c p /sys/kernel/debug/dynamic_debug/control然后重新进行export和配置操作使用dmesg -w实时查看详细的驱动内部执行流程包括寄存器读写值、计算过程等。直接读取寄存器状态仅限高级用户如果怀疑驱动配置不对可以绕过驱动直接使用devmem工具如果busybox已编译此命令读取PWM控制器寄存器与芯片手册对比。# 读取PWM4控制寄存器示例地址需查手册确认 devmem 0x01c23440 32这能帮你确认硬件是否真的被配置成了PWM模式以及分频器、计数器等是否按预期工作。5.3 从Sysfs到实际应用编写一个简单的控制脚本测试通过后最终我们要集成到应用程序中。这里提供一个简单的Bash脚本示例它可以平滑地改变LED亮度假设LED通过PB20引脚控制#!/bin/bash PWM_PATH/sys/class/pwm/pwmchip4/pwm0 # 初始化PWM频率设为1kHz echo 0 /sys/class/pwm/pwmchip4/export 2/dev/null echo 1000000 $PWM_PATH/period # 呼吸灯效果 while true; do for duty in $(seq 0 10000 1000000); do echo $duty $PWM_PATH/duty_cycle usleep 10000 # 10ms done for duty in $(seq 1000000 -10000 0); do echo $duty $PWM_PATH/duty_cycle usleep 10000 done done在C/C程序中你只需要使用标准的文件操作APIopen,write,close来读写/sys/class/pwm/下的那些文件即可非常简单。6. 总结与扩展思考走完这一遍你应该已经成功在A40i开发板上激活并控制了PWM4。整个过程的核心可以概括为通过设备树向内核“申报”硬件资源通过Sysfs接口从用户空间进行控制。这是一个标准的Linux驱动应用模式。对于更复杂的项目你可能会考虑多路PWM同步如果需要多路完全同步的PWM例如驱动全彩LED需要查看芯片手册某些PWM控制器可能有主从模式或同步触发功能。更高精度需求如果24MHz时钟源的分辨率不够可以尝试寻找其他时钟源如PLL并在设备树中正确配置reg_clk_src_offset等参数。使用PWM框架的API在内核驱动中其他模块如背光驱动pwm-backlight可以直接调用PWM子系统提供的API这比Sysfs更高效。如果你的应用是内核模块这是更专业的方式。设备树覆盖Device Tree Overlay对于产品化开发频繁修改核心设备树并重新编译整个内核镜像是不方便的。可以研究使用动态设备树覆盖DTBO技术在系统启动后动态加载针对PWM的配置片段。最后一点个人体会嵌入式Linux开发尤其是外设驱动三分靠代码七分靠手册Datasheet。A40i的用户手册特别是PIO和PWM章节和内核源码中的驱动代码drivers/pwm/pwm-sunxi.c是你最好的老师。遇到问题时静下心来对照手册和代码分析往往比在网上漫无目的地搜索更有效率。希望这篇基于实际项目的笔记能帮你少走些弯路。
