Pwm on CLing

PUYA TIMER1 — PWM 输出（HAL 库）

Tue, 08 Sep 2026 14:52:21 +0800

TIMER1 — PWM 输出（HAL 库）

固件库: PY32F0xx_Firmware V1.5.0
芯片: PY32F030
源文件: PUYA/PY32F0xx_Firmware_V1.5.0/Projects/PY32F030-STK/Example/TIMER1/TIM1_PWM/Src/main.c

功能简介

定时器（TIMER）是 MCU 最灵活的外设之一，可完成定时、计数、PWM 输出、输入捕获、编码器接口等。本示例聚焦最常用的 PWM（脉冲宽度调制）输出。

PY32F030 的 TIM1 是高级定时器，带 4 路独立比较通道。本例配置：

定时器时钟 8MHz（HSI），预分频 800，自动重装载值 ARR = 50；
4 个通道的比较值 CCRx 分别设为 10/20/30/40，于是占空比为 20% / 40% / 60% / 80%；
用 HAL_TIM_PWM_Start() 启动 4 路 PWM，输出到对应引脚（在 HAL_TIM_MspInit 中映射为 TIM1_CH1~CH4）。

PWM 频率 = 定时器时钟 / (预分频 × (ARR+1)) = 8MHz / (800 × 50) = 200Hz。占空比 = CCR / (ARR+1)。

硬件准备

PY32F030 开发板
示波器 / 逻辑分析仪（测 TIM1_CH1~CH4 引脚），或接 4 颗 LED（串限流电阻）观察亮度
无需额外接线（用板载/引脚直出）

完整代码

#include "main.h"

#define PERIOD_VALUE  (uint32_t)(50 - 1)   /* ARR：计数上限 49 */
#define PULSE1_VALUE  10                    /* CH1 比较值 -> 占空比 10/50 = 20% */
#define PULSE2_VALUE  20                    /* CH2 -> 40% */
#define PULSE3_VALUE  30                    /* CH3 -> 60% */
#define PULSE4_VALUE  40                    /* CH4 -> 80% */

TIM_HandleTypeDef    TimHandle;
TIM_OC_InitTypeDef   sConfig;

int main(void)
{
  HAL_Init();
  APP_SystemClockConfig();              /* 系统时钟：HSI 8MHz */

  /* 定时器时基配置 */
  TimHandle.Instance              = TIM1;
  TimHandle.Init.Period           = 50;            /* 自动重装载值 ARR */
  TimHandle.Init.Prescaler        = 800 - 1;       /* 预分频 799 -> 8MHz/800 = 10kHz */
  TimHandle.Init.ClockDivision    = TIM_CLOCKDIVISION_DIV1;
  TimHandle.Init.CounterMode      = TIM_COUNTERMODE_UP;       /* 向上计数 */
  TimHandle.Init.RepetitionCounter = 1 - 1;                  /* 重复计数 0 */
  TimHandle.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE;
  if (HAL_TIM_PWM_Init(&TimHandle) != HAL_OK) APP_ErrorHandler();

  /* PWM 输出通道参数 */
  sConfig.OCMode      = TIM_OCMODE_PWM1;     /* PWM 模式 1 */
  sConfig.OCPolarity  = TIM_OCPOLARITY_HIGH; /* 有效电平为高 */
  sConfig.OCFastMode  = TIM_OCFAST_DISABLE;
  sConfig.OCNPolarity = TIM_OCNPOLARITY_HIGH;
  sConfig.OCNIdleState = TIM_OCNIDLESTATE_RESET;
  sConfig.OCIdleState  = TIM_OCIDLESTATE_RESET;

  sConfig.Pulse = PULSE1_VALUE; /* CH1 */
  if (HAL_TIM_PWM_ConfigChannel(&TimHandle, &sConfig, TIM_CHANNEL_1) != HAL_OK) APP_ErrorHandler();
  sConfig.Pulse = PULSE2_VALUE; /* CH2 */
  if (HAL_TIM_PWM_ConfigChannel(&TimHandle, &sConfig, TIM_CHANNEL_2) != HAL_OK) APP_ErrorHandler();
  sConfig.Pulse = PULSE3_VALUE; /* CH3 */
  if (HAL_TIM_PWM_ConfigChannel(&TimHandle, &sConfig, TIM_CHANNEL_3) != HAL_OK) APP_ErrorHandler();
  sConfig.Pulse = PULSE4_VALUE; /* CH4 */
  if (HAL_TIM_PWM_ConfigChannel(&TimHandle, &sConfig, TIM_CHANNEL_4) != HAL_OK) APP_ErrorHandler();

  /* 启动 4 路 PWM 输出 */
  HAL_TIM_PWM_Start(&TimHandle, TIM_CHANNEL_1);
  HAL_TIM_PWM_Start(&TimHandle, TIM_CHANNEL_2);
  HAL_TIM_PWM_Start(&TimHandle, TIM_CHANNEL_3);
  HAL_TIM_PWM_Start(&TimHandle, TIM_CHANNEL_4);

  while (1) {}
}

代码分段讲解

1. 频率与占空比计算

PWM 频率 = TIM_CLK / ((PSC+1) × (ARR+1))。
- 本例：8MHz / (800 × 50) = 200Hz。
某通道占空比 = CCRx / (ARR+1)（PWM1 且极性为高时）：
- CH1：10/50 = 20%，CH2：20/50 = 40%，CH3：30/50 = 60%，CH4：40/50 = 80%。

2. PWM 模式 1 / 2

TIM_OCMODE_PWM1：计数 < CCR 时输出有效（高），≥ CCR 时无效（低）。
TIM_OCMODE_PWM2：极性相反。改变模式或 OCPolarity 可反转波形，但占空比数值关系不变。

3. 引脚映射

TIM1_CH1~CH4 具体复用哪个 GPIO 引脚，由 HAL_TIM_MspInit()（py32f0xx_hal_msp.c）里的 HAL_GPIO_Init + Alternate 决定。若你改了引脚，需同步修改 MSP 配置。

4. 高级定时器 TIM1 的特殊性

TIM1 是高级定时器，带互补输出与死区（可用于电机/电源）。本例未用互补通道（N 端），仅用普通 CH1~CH4 输出。

实验现象

TIM1_CH1~CH4 输出 200Hz PWM，占空比分别为 20% / 40% / 60% / 80%；
接 LED 时可见 4 颗亮度依次递增；示波器可见 4 路不同占空比方波。

常见问题

引脚没波形？
- 确认 MSP 里已把 CHx 引脚复用为 TIM1 并按 Alternate 配置；
- 确认已调用 HAL_TIM_PWM_Start() 对应通道。
想改频率？
- 改 Period（ARR）或 Prescaler：频率与两者成反比。例：要 1kHz，可设 PSC=800-1, ARR=10-1（8MHz/800/10=1kHz）。
想做呼吸灯？
- 在主循环或定时器中断里周期性改变 CCRx：__HAL_TIM_SET_COMPARE(&TimHandle, TIM_CHANNEL_x, newVal);。
占空比算不对？
- 注意是 CCRx / (ARR+1)，且受 OCMode 与 OCPolarity 影响有效区间。

小结

PWM = 定时器在 ARR 范围内循环计数，用 CCR 决定高电平占比。
关键三参数：PSC（分频）、ARR（周期）、CCR（占空比）。
HAL_TIM_PWM_Init → HAL_TIM_PWM_ConfigChannel → HAL_TIM_PWM_Start 三步即可输出。

拓展应用

LED 调光 / 呼吸灯（__HAL_TIM_SET_COMPARE 动态调占空比）。
舵机控制（50Hz PWM，0.5~~2.5ms 脉宽对应 0~~180°）。
直流电机调速（配合 MOSFET/驱动芯片）。
蜂鸣器发声（不同频率 PWM 出不同音调）；多路 PWM 做音乐。
高级用法：互补 PWM + 死区驱动半桥（见 TIM1_ComplementarySignals 系列）。

PUYA TIMER1 — PWM 输出（LL 库）

Tue, 08 Sep 2026 14:52:21 +0800

TIMER1 — PWM 输出（LL 库）

HAL vs LL：PUYA 固件库提供 HAL 和 LL 两套 API。

HAL 库：封装度高，可移植性强，适合快速开发

LL 库：接近寄存器操作，代码精简效率高，适合性能敏感场景本文使用 LL 库版本。

固件库: PY32F0xx_Firmware V1.5.0
芯片: PY32F030（PY32F002A / F003 同库可参考）
源文件: PUYA/PY32F0xx_Firmware_V1.5.0/Projects/PY32F030-STK/Example_LL/TIM/TIM1_PWM_Init/Src/main.c

功能简介

本示例用高级定时器 TIM1 在 PA8 / PA9 / PA10 上输出 3 路 PWM（PWM2 模式），比较值分别设为 250 / 500 / 750，对应占空比 25% / 50% / 75%。接上 LED 即可看到三档亮度，接示波器能看到三路相位相同的 PWM 波。

与 HAL 版（用 HAL_TIM_PWM_Start() 一行启动）相比，LL 版的“启动”被拆成几个显式步骤：配置 GPIO 复用 → 配置输出比较通道 LL_TIM_OC_Init() → 配时基 LL_TIM_Init() → LL_TIM_EnableAllOutputs()（高级定时器特有）→ LL_TIM_EnableCounter()。你会对“PWM 到底怎么出来的”理解得更透。

硬件准备

PY32F030 开发板
可选：3 颗 LED（分别接 PA8 / PA9 / PA10，串 1kΩ 电阻到 GND），或示波器/逻辑分析仪 3 通道
注意：TIM1 是高级定时器，输出前要额外使能主输出（MOE 位）

完整代码

#include "main.h"
#include "py32f030xx_ll_Start_Kit.h"

static void APP_SystemClockConfig(void);
static void APP_ConfigTIM1Base(void);
static void APP_ConfigPWMChannel(void);

int main(void)
{
  APP_SystemClockConfig();                       /* 系统时钟配到 24MHz（本例需要） */

  LL_APB1_GRP2_EnableClock(LL_APB1_GRP2_PERIPH_TIM1);  /* 开 TIM1 时钟 */
  LL_IOP_GRP1_EnableClock(LL_IOP_GRP1_PERIPH_GPIOA);   /* 开 GPIOA 时钟 */

  APP_ConfigPWMChannel();    /* 先配 GPIO 复用 + 输出比较参数 */
  APP_ConfigTIM1Base();      /* 再配时基并使能计数器 */

  while (1) {}
}

/**
  * @brief  配置 PWM 引脚复用 + 3 路输出比较
  */
static void APP_ConfigPWMChannel(void)
{
  LL_GPIO_InitTypeDef  TIM1CH1MapInit = {0};
  LL_TIM_OC_InitTypeDef TIM_OC_Initstruct = {0};

  /* PA8/PA9/PA10 复用为 TIM1_CH1/CH2/CH3，AF2 */
  TIM1CH1MapInit.Pin        = LL_GPIO_PIN_8 | LL_GPIO_PIN_9 | LL_GPIO_PIN_10;
  TIM1CH1MapInit.Mode       = LL_GPIO_MODE_ALTERNATE;
  TIM1CH1MapInit.Alternate  = LL_GPIO_AF_2;
  TIM1CH1MapInit.Speed      = LL_GPIO_SPEED_FREQ_HIGH;
  TIM1CH1MapInit.OutputType = LL_GPIO_OUTPUT_PUSHPULL;
  TIM1CH1MapInit.Pull       = LL_GPIO_PULL_NO;
  LL_GPIO_Init(GPIOA, &TIM1CH1MapInit);

  /* 三路都用 PWM2 模式、输出使能、高有效 */
  TIM_OC_Initstruct.OCMode      = LL_TIM_OCMODE_PWM2;
  TIM_OC_Initstruct.OCState     = LL_TIM_OCSTATE_ENABLE;
  TIM_OC_Initstruct.OCPolarity  = LL_TIM_OCPOLARITY_HIGH;
  TIM_OC_Initstruct.OCIdleState = LL_TIM_OCIDLESTATE_LOW;

  TIM_OC_Initstruct.CompareValue = 250;        /* CH1 比较值 250 → 占空比 25% */
  LL_TIM_OC_Init(TIM1, LL_TIM_CHANNEL_CH1, &TIM_OC_Initstruct);

  TIM_OC_Initstruct.CompareValue = 500;        /* CH2 比较值 500 → 占空比 50% */
  LL_TIM_OC_Init(TIM1, LL_TIM_CHANNEL_CH2, &TIM_OC_Initstruct);

  TIM_OC_Initstruct.CompareValue = 750;        /* CH3 比较值 750 → 占空比 75% */
  LL_TIM_OC_Init(TIM1, LL_TIM_CHANNEL_CH3, &TIM_OC_Initstruct);
}

/**
  * @brief  配置 TIM1 时基并使能
  */
static void APP_ConfigTIM1Base(void)
{
  LL_TIM_InitTypeDef TIM1CountInit = {0};

  TIM1CountInit.ClockDivision     = LL_TIM_CLOCKDIVISION_DIV1;  /* 不分频 */
  TIM1CountInit.CounterMode       = LL_TIM_COUNTERMODE_UP;      /* 向上计数 */
  TIM1CountInit.Prescaler         = 2400 - 1;                   /* 预分频 2400 */
  TIM1CountInit.Autoreload        = 1000 - 1;                   /* 自动重装载 1000 */
  TIM1CountInit.RepetitionCounter = 0;
  LL_TIM_Init(TIM1, &TIM1CountInit);

  LL_TIM_EnableAllOutputs(TIM1);   /* 高级定时器：使能主输出 MOE */
  LL_TIM_EnableCounter(TIM1);      /* 启动计数器 */
}

/**
  * @brief  系统时钟配置到 24MHz
  */
static void APP_SystemClockConfig(void)
{
  LL_RCC_HSI_Enable();
  LL_RCC_HSI_SetCalibFreq(LL_RCC_HSICALIBRATION_24MHz);
  while (LL_RCC_HSI_IsReady() != 1) {}
  LL_RCC_SetAHBPrescaler(LL_RCC_SYSCLK_DIV_1);
  LL_RCC_SetSysClkSource(LL_RCC_SYS_CLKSOURCE_HSISYS);
  while (LL_RCC_GetSysClkSource() != LL_RCC_SYS_CLKSOURCE_STATUS_HSISYS) {}
  LL_RCC_SetAPB1Prescaler(LL_RCC_APB1_DIV_1);
  LL_Init1msTick(24000000);
  LL_SetSystemCoreClock(24000000);
}

void APP_ErrorHandler(void)
{
  while (1) {}
}

代码分段讲解

1. 时基与 PWM 频率

定时器时钟 = 系统时钟 24MHz。
Prescaler = 2400-1 → 计数时钟 = 24MHz / 2400 = 10kHz。
Autoreload = 1000-1 → 一个 PWM 周期 = 1000 个计数 = 100ms，即 PWM 频率 10Hz。
占空比 = CompareValue / (Autoreload+1)：250→25%、500→50%、750→75%（PWM2 模式下高/低电平关系与 PWM1 相反，但占空比数值算法相同）。

2. GPIO 复用

PA8/9/10 要设为 LL_GPIO_MODE_ALTERNATE 并指定 Alternate = LL_GPIO_AF_2 才能把引脚内部连到 TIM1。这一步和 USART 的 AF 配置思路完全一致。

3. 输出比较：LL 的“逐通道 Init”

HAL 里 HAL_TIM_PWM_ConfigChannel() 一次配一个通道；LL 里把“通道参数”封装成 LL_TIM_OC_InitTypeDef，逐个通道 LL_TIM_OC_Init()。三路只有 CompareValue 不同，其余（PWM2、使能、极性）共用一套。

4. 高级定时器特有的“主输出使能”

LL_TIM_EnableAllOutputs(TIM1) 设置的是 TIM1 的 BDTR.MOE 位。这是高级定时器（TIM1/TIM16/17）独有的：不使能主输出，PWM 引脚不会有波形。通用定时器（TIM3 等）则不需要这步——这是初学者最容易踩的坑。

5. 启动

最后 LL_TIM_EnableCounter(TIM1) 启动计数器，PWM 立即从引脚输出。LL 没有 HAL_TIM_PWM_Start() 这种“一键启动”，而是“配好 → 使能输出 → 使能计数”三步走。

实验现象

PA8 / PA9 / PA10 输出频率约 10Hz 的 PWM，占空比分别约 25% / 50% / 75%。
接 LED：三颗亮度明显不同（25% 最暗，75% 最亮）。
示波器三路波形相位相同，仅高电平宽度不同。

常见问题

引脚没波形？
- 八成是漏了 LL_TIM_EnableAllOutputs()（高级定时器必须使能主输出）。
- 确认 GPIO 复用 Alternate = LL_GPIO_AF_2 且引脚确实是 PA8/9/10。
频率不对 / 占空比反了？
- 频率由 Prescaler × (Autoreload+1) 与定时器时钟共同决定，先确认系统时钟是 24MHz。
- PWM1 与 PWM2 模式高/低电平相反，想要“比较值越大越亮”可改用 LL_TIM_OCMODE_PWM1。
想动态调占空比？
- 运行中调用 LL_TIM_OC_SetCompareCHx(TIM1, 新值) 即可实时改占空比，无需重新 Init。

小结

LL 配置 PWM 四步：开时钟 → 配 GPIO 复用 → 配 OC 通道参数 → 配时基并使能（高级定时器别忘了主输出）。
相比 HAL 的 HAL_TIM_PWM_Start()，LL 把“使能主输出”“使能计数器”都摊开给你，理解更深、控制更细。
调占空比用 LL_TIM_OC_SetCompareCHx()，调频率改 Prescaler / Autoreload。

拓展应用

在定时器更新中断里逐步改变 CompareValue，做“呼吸灯”。
多路 PWM 组合驱动 RGB LED 调色。
用 PWM 触发 ADC（LL_TIM_SetTriggerOutput）实现同步采样。
改用 TIM3（通用定时器）重复本例，体会“无需主输出使能”的差异。

AT32 TIM — PWM 输出（LED 呼吸灯 + 电机调速的基础）

Tue, 08 Sep 2026 15:11:00 +0800

TIM — PWM 输出

难度: ⭐⭐（需要了解定时器基本概念）
固件库: AT32F403A_407_Firmware_Library V2.2.2
源文件: project/at_start_f403a/examples/tmr/pwm_output_tmr3/src/main.c

这个实验是干嘛的？

PWM（Pulse Width Modulation，脉冲宽度调制）是一种用数字信号模拟模拟信号的技术。

简单说：MCU 只能输出 0V 或 3.3V，不能输出 1.5V。但如果你快速地在 0V 和 3.3V 之间切换，改变高电平的占比，就能模拟出不同的"平均电压"：

1
2
3

占空比 10%:  ┃▄┃▄▄▄▄▄▄▄▄▄  → 平均电压 ≈ 0.33V → LED 很暗
占空比 50%:  ┃▄▄▄▄▄┃▄▄▄▄▄  → 平均电压 ≈ 1.65V → LED 中等亮度
占空比 90%:  ┃▄▄▄▄▄▄▄▄▄┃▄  → 平均电压 ≈ 2.97V → LED 很亮

本实验用 TMR3 的 4 个通道输出 4 路不同占空比的 PWM：

通道 1：50% 占空比
通道 2：37.5%
通道 3：25%
通道 4：12.5%

硬件准备

AT32F403A 开发板
示波器（看波形）或 LED（看亮度变化）

PWM 输出引脚（TMR3 的 4 个通道）：

通道	引脚	占空比
CH1	PA6	50%
CH2	PA7	37.5%
CH3	PB0	25%
CH4	PB1	12.5%

如果接 LED：PA6 的 LED 最亮，PB1 的 LED 最暗。

PWM 核心概念

关键参数

参数	含义	本例数值
ARR（重装载值）	定时器计数到多少归零	665
PSC（预分频器）	时钟分频系数	系统时钟/24MHz - 1
CCR（比较值）	计数到多少时翻转输出	通道不同值不同
占空比	CCR / (ARR+1)	50%, 37.5%, 25%, 12.5%
PWM 频率	时钟 / (PSC+1) / (ARR+1)	24MHz / 1 / 666 ≈ 36KHz

PWM 工作原理

计数器: 0 → 1 → 2 → ... → CCR → ... → ARR → 0 → 1 → ...
输出:   高电平 ──────────┐                ┌────────── 高电平
                         └── 低电平 ──────┘
                         ↑ CCR 时刻翻转

计数器从 0 向上计数到 ARR，然后归零重新开始
计数 < CCR 时，输出高电平
计数 ≥ CCR 时，输出低电平
CCR 越大，高电平时间越长，占空比越大

完整代码

#include "at32f403a_407_board.h"
#include "at32f403a_407_clock.h"

/* 4 个通道的比较值（决定占空比） */
uint16_t ccr1_val = 333;   // 333/666 = 50%
uint16_t ccr2_val = 249;   // 249/666 = 37.4%
uint16_t ccr3_val = 166;   // 166/666 = 25%
uint16_t ccr4_val = 83;    // 83/666  = 12.5%

uint16_t prescaler_value = 0;

/* GPIO 配置：把定时器通道映射到引脚 */
void gpio_configuration(void)
{
  gpio_init_type gpio_init_struct;
  gpio_default_para_init(&gpio_init_struct);

  /* PA6(CH1) + PA7(CH2) */
  gpio_init_struct.gpio_pins = GPIO_PINS_6 | GPIO_PINS_7;
  gpio_init_struct.gpio_out_type = GPIO_OUTPUT_PUSH_PULL;
  gpio_init_struct.gpio_pull = GPIO_PULL_NONE;
  gpio_init_struct.gpio_mode = GPIO_MODE_MUX;        // 复用模式！
  gpio_init_struct.gpio_drive_strength = GPIO_DRIVE_STRENGTH_STRONGER;
  gpio_init(GPIOA, &gpio_init_struct);

  /* PB0(CH3) + PB1(CH4) */
  gpio_init_struct.gpio_pins = GPIO_PINS_0 | GPIO_PINS_1;
  gpio_init(GPIOB, &gpio_init_struct);
}

/* 时钟使能 */
void crm_configuration(void)
{
  crm_periph_clock_enable(CRM_TMR3_PERIPH_CLOCK, TRUE);
  crm_periph_clock_enable(CRM_GPIOA_PERIPH_CLOCK, TRUE);
  crm_periph_clock_enable(CRM_GPIOB_PERIPH_CLOCK, TRUE);
}

int main(void)
{
  system_clock_config();

  /* 第一步：使能时钟 */
  crm_configuration();

  /* 第二步：配置 GPIO（复用模式） */
  gpio_configuration();

  /* 第三步：计算预分频值 */
  // 例：系统时钟 240MHz，要得到 24MHz 定时器时钟
  // prescaler_value = 240MHz / 24MHz - 1 = 9
  prescaler_value = (uint16_t)(system_core_clock / 24000000) - 1;

  /* 第四步：定时器基本配置 */
  // ARR = 665，PSC = 9
  // PWM 频率 = 24MHz / (9+1) / (665+1) ≈ 3.6KHz
  tmr_base_init(TMR3, 665, prescaler_value);
  tmr_cnt_dir_set(TMR3, TMR_COUNT_UP);              // 向上计数
  tmr_clock_source_div_set(TMR3, TMR_CLOCK_DIV1);   // 不分频

  /* 第五步：配置 4 个通道为 PWM 模式 */
  tmr_output_config_type tmr_oc_init_structure;
  tmr_output_default_para_init(&tmr_oc_init_structure);

  tmr_oc_init_structure.oc_mode = TMR_OUTPUT_CONTROL_PWM_MODE_A;  // PWM 模式 A
  tmr_oc_init_structure.oc_idle_state = FALSE;
  tmr_oc_init_structure.oc_polarity = TMR_OUTPUT_ACTIVE_HIGH;     // 高电平有效
  tmr_oc_init_structure.oc_output_state = TRUE;                    // 使能输出

  /* 配置通道 1，CCR = 333，占空比 = 333/666 ≈ 50% */
  tmr_output_channel_config(TMR3, TMR_SELECT_CHANNEL_1, &tmr_oc_init_structure);
  tmr_channel_value_set(TMR3, TMR_SELECT_CHANNEL_1, ccr1_val);
  tmr_output_channel_buffer_enable(TMR3, TMR_SELECT_CHANNEL_1, TRUE);

  /* 配置通道 2，CCR = 249，占空比 ≈ 37.4% */
  tmr_output_channel_config(TMR3, TMR_SELECT_CHANNEL_2, &tmr_oc_init_structure);
  tmr_channel_value_set(TMR3, TMR_SELECT_CHANNEL_2, ccr2_val);
  tmr_output_channel_buffer_enable(TMR3, TMR_SELECT_CHANNEL_2, TRUE);

  /* 配置通道 3，CCR = 166，占空比 ≈ 25% */
  tmr_output_channel_config(TMR3, TMR_SELECT_CHANNEL_3, &tmr_oc_init_structure);
  tmr_channel_value_set(TMR3, TMR_SELECT_CHANNEL_3, ccr3_val);
  tmr_output_channel_buffer_enable(TMR3, TMR_SELECT_CHANNEL_3, TRUE);

  /* 配置通道 4，CCR = 83，占空比 ≈ 12.5% */
  tmr_output_channel_config(TMR3, TMR_SELECT_CHANNEL_4, &tmr_oc_init_structure);
  tmr_channel_value_set(TMR3, TMR_SELECT_CHANNEL_4, ccr4_val);
  tmr_output_channel_buffer_enable(TMR3, TMR_SELECT_CHANNEL_4, TRUE);

  /* 使能 ARR 预装载 */
  tmr_period_buffer_enable(TMR3, TRUE);

  /* 第六步：启动定时器 */
  tmr_counter_enable(TMR3, TRUE);

  /* PWM 输出已启动，主循环可以做其他事 */
  while(1)
  {
    // 如果要动态改变占空比，在这里调用：
    // tmr_channel_value_set(TMR3, TMR_SELECT_CHANNEL_1, new_ccr_val);
  }
}

代码分段讲解

1. GPIO 复用模式

`1`	`gpio_init_struct.gpio_mode = GPIO_MODE_MUX; // 复用模式`

关键点：PWM 输出的引脚必须配置为复用模式（MUX），不是普通输出模式（OUTPUT）。

为什么？因为引脚的控制权要交给定时器硬件，而不是 CPU。定时器自动翻转引脚电平，CPU 不用管。

2. 预分频器

`1`	`prescaler_value = (uint16_t)(system_core_clock / 24000000) - 1;`

定时器的时钟源是系统时钟（比如 240MHz），太快了。预分频器把它降频：

PSC = 9 → 定时器时钟 = 240MHz / 10 = 24MHz
定时器每 41.67ns 计数一次

3. ARR 和 CCR

1
2

tmr_base_init(TMR3, 665, prescaler_value);  // ARR = 665
tmr_channel_value_set(TMR3, TMR_SELECT_CHANNEL_1, 333);  // CCR = 333

ARR = 665：计数器从 0 计到 665 就归零，一个周期 = 666 个计数
CCR = 333：计数到 333 时输出翻转
占空比 = 333 / 666 ≈ 50%

4. PWM 模式 A vs B

`1`	`tmr_oc_init_structure.oc_mode = TMR_OUTPUT_CONTROL_PWM_MODE_A;`

PWM 模式 A：计数 < CCR 时输出高电平（最常用）
PWM 模式 B：计数 < CCR 时输出低电平（反相）

实验现象

用示波器观察 4 个引脚：

PA6：50% 占空比的方波
PA7：37.5% 占空比
PB0：25% 占空比
PB1：12.5% 占空比

如果接 LED：PA6 最亮，PB1 最暗。

如何动态改变占空比？

1
2

// 在主循环或中断中调用
tmr_channel_value_set(TMR3, TMR_SELECT_CHANNEL_1, new_ccr);

new_ccr 范围：0 ~ ARR（0 ~ 665）

new_ccr = 0 → 占空比 0% → LED 灭
new_ccr = 333 → 占空比 50% → LED 半亮
new_ccr = 665 → 占空比 100% → LED 全亮

常见问题

Q: 引脚没有 PWM 输出？

GPIO 是否配置为复用模式（MUX）？普通输出模式不行
定时器时钟是否使能？
tmr_counter_enable() 是否调用？

Q: PWM 频率不对？

检查 PSC 和 ARR 的值
PWM 频率 = 定时器时钟 / (PSC+1) / (ARR+1)
确认系统时钟是否正确（system_core_clock）

Q: 想生成 50Hz PWM（控制舵机）？

舵机需要 50Hz（20ms 周期）
假设定时器时钟 24MHz：ARR = 24000000 / 50 / (PSC+1) - 1
PSC = 11 → ARR = 39999 → 50Hz
CCR 范围：1000~~5000 对应 0.5ms~~2.5ms → 0°~180°

小结

概念	说明
PWM	用数字信号模拟模拟信号
ARR	重装载值，决定 PWM 周期
CCR	比较值，决定占空比
占空比	CCR / (ARR+1)，高电平占比
复用模式	GPIO 必须配置为 MUX 模式
预装载	缓冲写入，避免毛刺

学了 PWM 能做什么？

PWM 是嵌入式中最实用的"万能模拟器"：

LED 控制

项目	原理	难度
LED 呼吸灯	CCR 从 0 渐增到 ARR 再渐减	⭐⭐
RGB 调色	3 路 PWM 控制红绿蓝，混合出任意颜色	⭐⭐
背光调节	LCD/键盘背光亮度无级调节	⭐

电机控制

项目	原理	难度
直流电机调速	PWM + MOS 管 → 改变占空比 = 改变转速	⭐⭐
舵机控制	50Hz PWM，脉宽 0.5~2.5ms → 0°~180°	⭐⭐
步进电机驱动	PWM 控制细分驱动器	⭐⭐⭐
无刷电机（BLDC）	6 路互补 PWM + 死区控制	⭐⭐⭐⭐

音频与信号

项目	原理	难度
蜂鸣器播放音乐	不同频率 PWM = 不同音调	⭐⭐
简易信号发生器	改变频率和占空比输出方波	⭐⭐
DAC 替代	PWM + RC 滤波 → 模拟电压输出	⭐⭐⭐
红外遥控发射	38KHz PWM 载波 + 数据调制	⭐⭐⭐

电源与通信

项目	原理	难度
开关电源	PWM 控制 MOS 管 → DC-DC 降压/升压	⭐⭐⭐⭐
充电控制	PWM 控制充电电流（恒流充电）	⭐⭐⭐
可控硅调光	PWM 控制双向可控硅导通角	⭐⭐⭐

核心思路：PWM 的本质是"用时间换精度"。只要控制高电平的时间占比，就能模拟出任意电压、任意频率的信号。LED 亮度、电机转速、声音音调、电源电压……所有需要"连续调节"的场景，PWM 都能搞定。

下一步：学会了 PWM，可以学 DMA，了解如何用 DMA 配合定时器实现更高级的波形生成。