从编译到运行：PWM Demo完整教程

TL_BINGYU

本帖将引导您完成PWM Demo的代码解析、编译配置与运行验证的完整流程。PWM模块支持连续模式、计数模式、红外模式、红外FIFO模式、红外DMA FIFO模式以及中心对齐模式，本示例以 TL323X 平台进行演示。 ## 一、PWM Demo 工程结构 PWM Demo 位于 demo/vendor/PWM_DEMO/ 目录，包含以下源文件：  ## 二、模式选择与配置 ### 1. 模式宏定义 模式选择通过 pwm_app_config.h 中的 SET_PWM_MODE 宏控制： 路径 ： ``` #define PWM_CONTINUE        1   // 连续模式 #define PWM_COUNT           2   // 计数模式 #define PWM_IR              3   // 红外模式 #define PWM_IR_FIFO         4   // 红外FIFO模式 #define PWM_IR_DMA          5   // 红外DMA FIFO模式 #define PWM_CENTER_ALIGNED  6   // 中心对齐模式（B91不支持） #define SET_PWM_MODE   PWM_CONTINUE   // 修改此宏切换模式 #define PWM_CONTINUE        1   // 连续模式 #define PWM_COUNT           2   // 计数模式 #define PWM_IR              3   // 红外模式 #define PWM_IR_FIFO         4   // 红外FIFO模式 #define PWM_IR_DMA          5   // 红外DMA FIFO模式 #define PWM_CENTER_ALIGNED  6   // 中心对齐模式（B91不支持） #define SET_PWM_MODE   PWM_CONTINUE   // 修改此宏切换模式 ``` ### 2. PWM时钟配置 ``` #if defined(MCU_CORE_TL751X) #define PWM_PCLK_SPEED 66000000 #elif defined(MCU_CORE_TL721X) #define PWM_PCLK_SPEED 60000000 #else #define PWM_PCLK_SPEED 24000000 #endif #if defined(MCU_CORE_TL751X) #define PWM_PCLK_SPEED 66000000 #elif defined(MCU_CORE_TL721X) #define PWM_PCLK_SPEED 60000000 #else #define PWM_PCLK_SPEED 24000000 #endif ``` 时钟分频计算公式： pwm_clk_div = (pclk_frequency / pwm_frequency) - 1 ## 三、各模式代码解析 ### 3.1 Continuous Mode（连续模式） 特点 ：持续输出固定占空比的PWM波形，可随时更新占空比（下一帧生效），stop后立即停止。 ``` void user_init(void) {     // 1. LED初始化     gpio_function_en(LED1);     gpio_output_en(LED1);     gpio_input_dis(LED1);     gpio_function_en(LED2);     gpio_output_en(LED2);     gpio_input_dis(LED2);     // 2. PWM引脚配置     pwm_set_pin(PWM_PIN, PWM_FUNC);     // 3. 中断配置（每帧完成中断）     pwm_set_irq_mask(FLD_PWM0_FRAME_DONE_IRQ);     pwm_clr_irq_status(FLD_PWM0_FRAME_DONE_IRQ);     core_interrupt_enable();     plic_interrupt_enable(IRQ_PWM);     // 4. 设置连续模式     pwm_set_pwm0_mode(PWM_NORMAL_MODE);     // 5. 时钟分频（PCLK 24MHz → PWM 24MHz）     pwm_set_clk((unsigned char)(sys_clk.pclk * 1000 * 1000 / PWM_PCLK_SPEED - 1));     // 6. 设置占空比（高电平50us，周期100us → 50%占空比）     pwm_set_tcmp(PWM_ID, 50 * CLOCK_PWM_CLOCK_1US);     pwm_set_tmax(PWM_ID, 100 * CLOCK_PWM_CLOCK_1US);     // 7. 启动PWM     pwm_start(FLD_PWM0_EN); } // 中断处理：每个signal frame完成触发 _attribute_ram_code_sec_ void pwm_irq_handler(void) {     if (pwm_get_irq_status(FLD_PWM0_FRAME_DONE_IRQ)) {         pwm_clr_irq_status(FLD_PWM0_FRAME_DONE_IRQ);         gpio_toggle(LED2);  // 每帧翻转LED2     } } PLIC_ISR_REGISTER(pwm_irq_handler, IRQ_PWM) void user_init(void) { // 1. LED初始化 gpio_function_en(LED1); gpio_output_en(LED1); gpio_input_dis(LED1); gpio_function_en(LED2); gpio_output_en(LED2); gpio_input_dis(LED2); // 2. PWM引脚配置 pwm_set_pin(PWM_PIN, PWM_FUNC); // 3. 中断配置（每帧完成中断） pwm_set_irq_mask(FLD_PWM0_FRAME_DONE_IRQ); pwm_clr_irq_status(FLD_PWM0_FRAME_DONE_IRQ); core_interrupt_enable(); plic_interrupt_enable(IRQ_PWM); // 4. 设置连续模式 pwm_set_pwm0_mode(PWM_NORMAL_MODE); // 5. 时钟分频（PCLK 24MHz → PWM 24MHz） pwm_set_clk((unsigned char)(sys_clk.pclk * 1000 * 1000 / PWM_PCLK_SPEED - 1)); // 6. 设置占空比（高电平50us，周期100us → 50%占空比） pwm_set_tcmp(PWM_ID, 50 * CLOCK_PWM_CLOCK_1US); pwm_set_tmax(PWM_ID, 100 * CLOCK_PWM_CLOCK_1US); // 7. 启动PWM pwm_start(FLD_PWM0_EN); } // 中断处理：每个signal frame完成触发 attribute_ram_code_sec void pwm_irq_handler(void) { if (pwm_get_irq_status(FLD_PWM0_FRAME_DONE_IRQ)) { pwm_clr_irq_status(FLD_PWM0_FRAME_DONE_IRQ); gpio_toggle(LED2);  // 每帧翻转LED2 } } PLIC_ISR_REGISTER(pwm_irq_handler, IRQ_PWM) ``` 预期波形 ：周期100us、占空比50%的连续方波，LED2每帧翻转一次。 ### 3.2 Counting Mode（计数模式） 特点 ：发送指定数量的脉冲后自动停止，发送过程中修改占空比不生效。 该模式支持两种中断触发方式，通过 SET_COUNT_INIT_MODE 宏选择： ``` void user_init(void) {     // ... 引脚与LED初始化 ...     pwm_set_pwm0_mode(PWM_COUNT_MODE);           // 设置计数模式     pwm_set_pwm0_pulse_num(PWM_PULSE_NUM);       // 设置脉冲个数     pwm_set_clk((unsigned char)(sys_clk.pclk * 1000 * 1000 / PWM_PCLK_SPEED - 1));     pwm_set_tcmp(PWM_ID, 50 * CLOCK_PWM_CLOCK_1US);     pwm_set_tmax(PWM_ID, 100 * CLOCK_PWM_CLOCK_1US);     // 中断配置（以 COUNT_PNUM_INIT 为例）     pwm_set_irq_mask(FLD_PWM0_PNUM_IRQ);         // 脉冲组完成中断     pwm_clr_irq_status(FLD_PWM0_PNUM_IRQ);     core_interrupt_enable();     plic_interrupt_enable(IRQ_PWM);     pwm_start(FLD_PWM0_EN); } void user_init(void) { // ... 引脚与LED初始化 ... pwm_set_pwm0_mode(PWM_COUNT_MODE);           // 设置计数模式 pwm_set_pwm0_pulse_num(PWM_PULSE_NUM);       // 设置脉冲个数 pwm_set_clk((unsigned char)(sys_clk.pclk * 1000 * 1000 / PWM_PCLK_SPEED - 1)); pwm_set_tcmp(PWM_ID, 50 * CLOCK_PWM_CLOCK_1US); pwm_set_tmax(PWM_ID, 100 * CLOCK_PWM_CLOCK_1US); // 中断配置（以 COUNT_PNUM_INIT 为例） pwm_set_irq_mask(FLD_PWM0_PNUM_IRQ);         // 脉冲组完成中断 pwm_clr_irq_status(FLD_PWM0_PNUM_IRQ); core_interrupt_enable(); plic_interrupt_enable(IRQ_PWM); pwm_start(FLD_PWM0_EN); } ``` 预期波形 ：输出32个脉冲后停止，LED2翻转一次。 ### 3.3 IR Mode（红外模式） 特点 ：连续发送脉冲组（pulse groups），每组包含指定数量脉冲，可动态修改占空比（下一组生效）。 预期波形 ：连续输出6组脉冲（每组4个载波），最后一组发完后停止。 ### 3.4 IR FIFO Mode（红外FIFO模式） 特点 ：通过FIFO配置发送参数，每个cfg data包含脉冲数、shadow选择和载波使能，无需MCU持续干预。 cfg data参数说明 ： 参数 说明 pulse_num 脉冲个数 use_shadow 1=使用shadow寄存器的占空比，0=使用默认寄存器 carrier_en 1=输出载波，0=输出低电平 注意 ：IR FIFO模式不需要 pwm_start ，只要FIFO有数据就会自动发送。FIFO深度为8 bytes。 ### 3.5 IR DMA FIFO Mode（红外DMA FIFO模式） 特点 ：通过DMA将配置数据搬运到FIFO，支持链式DMA实现无MCU干预的连续发送。 链式DMA模式 （Ping-Pong连续发送）： 注意 ：DMA源地址必须4字节对齐。链式DMA模式可实现两组数据无缝切换，波形上无时延。 ### 3.6 Center Aligned（中心对齐模式） 特点 ：前后两个周期的波形在中心点对齐，支持相位偏移。仅B92及以上芯片支持，B91不支持。 ## 四、编译工程 1. 在 Telink IoT Studio 左侧 Project Explorer 中选中目标工程（如 TL323X） 2. 点击工具栏 Build 按钮旁的下拉箭头，选择 PWM_Demo 配置 3. 4.     观察控制台输出，编译成功后 bin 文件位于 project/tlsr_riscv/tl323x/PWM_Demo/ 目录下 ## 五、通过 BDT 烧录固件 1. 硬件连接 ：PC → 烧录器（USB）→ 目标板（3V3/GND/SWM ↔ SWS） 2. 打开 BDT，选择芯片型号（如 TL323x） 3. 下载模式选择 EVK 4. File → Open/Reopen，选择编译生成的 .bin 文件 5. 点击 SWS 确认连接，Activate → Unlock → Download 6. 烧录完成后 Reset 运行 ## 六、验证运行结果 ### Continuous Mode 预期结果 用逻辑分析仪抓取 PWM 引脚波形：  ### Counting Mode 预期结果 - 输出32个脉冲后自动停止 - LED2在脉冲组完成时翻转一次 ### IR Mode 预期结果 - 连续输出6组脉冲，每组4个载波 - LED2每组完成时翻转 - 最后一组发完后自动停止（通过中断切换到count模式） ### IR FIFO Mode 预期结果 - 交替输出5脉冲（shadow占空比）和6脉冲（默认占空比）的载波组 - FIFO数据不足时触发中断，中断中补充cfg data ### IR DMA FIFO Mode 预期结果 - 普通DMA模式：输出3组cfg data后触发中断，中断中重新触发DMA - 链式DMA模式：两组数据循环切换，波形无时延 ### Center Aligned 预期结果 - PWM1和PWM2在中心点对齐 - 两个通道极性反转后输出 ## 七、注意事项 1. PWM0支持全部5种模式 ，其他通道仅支持continuous mode 2. 32K时钟源 仅支持continuous mode和counting mode，不支持分频，且中断会提前一个时钟周期 3. DMA地址对齐 ：使用DMA时源地址必须4字节对齐，否则程序异常 4. IR FIFO深度 为8 bytes，写满前需等待 5. 6. <i class="pstatus"> 本帖最后由 TL_BINGYU 于 2026-9-4 11:50 编辑 </i><br /> <br />