PUYA — TIMER1 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 — TIM1 互补信号

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

TIMER1 — TIM1 互补信号

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

功能简介

本示例演示互补输出和死区控制。用于驱动半桥/全桥电路，上下管交替导通，死区时间防止上下管同时导通（直通）。

完整代码

#include "main.h"
#define  PERIOD_VALUE       (uint32_t)(800 - 1)               /* Period Value  */
#define  PULSE1_VALUE       (uint32_t)(PERIOD_VALUE/2)        /* Capture Compare 1 Value  */
#define  PULSE2_VALUE       (uint32_t)(PERIOD_VALUE*37.5/100) /* Capture Compare 2 Value  */
#define  PULSE3_VALUE       (uint32_t)(PERIOD_VALUE/4)        /* Capture Compare 3 Value  */

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_6Step

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

TIMER1 — TIM1_6Step

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

功能简介

本示例演示定时器 6 步换相功能。这是无刷直流电机（BLDC）驱动的核心技术，通过 6 个功率管按顺序导通实现电机旋转。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_AutoReloadPreload

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

TIMER1 — TIM1_AutoReloadPreload

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

功能简介

本示例演示定时器的基本用法。定时器是 MCU 最灵活的外设之一，可以实现定时、PWM、输入捕获、编码器等多种功能。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_ComplementarySignals_break

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

TIMER1 — TIM1_ComplementarySignals_break

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

功能简介

本示例演示互补输出和死区控制。用于驱动半桥/全桥电路，上下管交替导通，死区时间防止上下管同时导通（直通）。

完整代码

1
2

#include "main.h"
#define  PULSE1_VALUE       (uint32_t)(400)/* Capture Compare 1 Value  */

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_ComplementarySignals_break_it

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

TIMER1 — TIM1_ComplementarySignals_break_it

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

功能简介

本示例演示互补输出和死区控制。用于驱动半桥/全桥电路，上下管交替导通，死区时间防止上下管同时导通（直通）。

完整代码

1
2

#include "main.h"
#define  PULSE1_VALUE       (uint32_t)(400)/* Capture Compare 1 Value  */

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_ComplementarySignals_DeadTime

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

TIMER1 — TIM1_ComplementarySignals_DeadTime

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

功能简介

本示例演示互补输出和死区控制。用于驱动半桥/全桥电路，上下管交替导通，死区时间防止上下管同时导通（直通）。

完整代码

1
2

#include "main.h"
#define  PULSE1_VALUE       (uint32_t)(400)/* Capture Compare 1 Value  */

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_DmaBurst_twice

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

TIMER1 — TIM1_DmaBurst_twice

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

功能简介

本示例演示定时器 DMA 触发。定时器事件自动触发 DMA 传输，无需 CPU 干预，适合波形生成等高速场景。

完整代码

1
2

#include "main.h"
#include "py32f0xx_hal_flash.h"

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_EncoderTI2AndTI1

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

TIMER1 — TIM1_EncoderTI2AndTI1

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

功能简介

本示例演示定时器编码器接口模式。定时器硬件自动解码正交编码器信号，无需 CPU 介入，适合电机转速和位置检测。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_ExternalClockMode1

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

TIMER1 — TIM1_ExternalClockMode1

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

功能简介

本示例演示输出比较模式。定时器计数到设定值时自动翻转/置高/置低引脚，可以生成精确的方波信号。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_ExternalClockMode1_TI1F

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

TIMER1 — TIM1_ExternalClockMode1_TI1F

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

功能简介

本示例演示输出比较模式。定时器计数到设定值时自动翻转/置高/置低引脚，可以生成精确的方波信号。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_ExternalClockMode2

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

TIMER1 — TIM1_ExternalClockMode2

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

功能简介

本示例演示输出比较模式。定时器计数到设定值时自动翻转/置高/置低引脚，可以生成精确的方波信号。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_InputCapture_TI1FP1

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

TIMER1 — TIM1_InputCapture_TI1FP1

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

功能简介

本示例演示定时器输入捕获功能。当外部信号边沿到来时，定时器自动记录当前计数值，可以精确测量信号的脉宽和频率。

完整代码

1
2

#include "main.h"
#include "py32f0xx_hal_flash.h"

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_InputCapture_XORCh1Ch2Ch3

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

TIMER1 — TIM1_InputCapture_XORCh1Ch2Ch3

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

功能简介

本示例演示定时器输入捕获功能。当外部信号边沿到来时，定时器自动记录当前计数值，可以精确测量信号的脉宽和频率。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_OCToggle

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

TIMER1 — TIM1_OCToggle

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

功能简介

本示例演示输出比较模式。定时器计数到设定值时自动翻转/置高/置低引脚，可以生成精确的方波信号。

完整代码

#include "main.h"
#define  PERIOD_VALUE       (uint32_t)(50 - 1)
#define  PULSE1_VALUE       10-1
#define  PULSE2_VALUE       20-1
#define  PULSE3_VALUE       30-1
#define  PULSE4_VALUE       40-1

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_OnePulseOutput

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

TIMER1 — TIM1_OnePulseOutput

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

功能简介

本示例演示定时器的基本用法。定时器是 MCU 最灵活的外设之一，可以实现定时、PWM、输入捕获、编码器等多种功能。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_SynchronizationEnable

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

TIMER1 — TIM1_SynchronizationEnable

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

功能简介

本示例演示定时器的基本用法。定时器是 MCU 最灵活的外设之一，可以实现定时、PWM、输入捕获、编码器等多种功能。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_TIM3_Cascade

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

TIMER1 — TIM1_TIM3_Cascade

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

功能简介

本示例演示定时器的基本用法。定时器是 MCU 最灵活的外设之一，可以实现定时、PWM、输入捕获、编码器等多种功能。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_Update_DMA

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

TIMER1 — TIM1_Update_DMA

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

功能简介

本示例演示定时器 DMA 触发。定时器事件自动触发 DMA 传输，无需 CPU 干预，适合波形生成等高速场景。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA TIMER1 — TIM1_Update_IT

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

TIMER1 — TIM1_Update_IT

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

功能简介

本示例演示定时器的基本用法。定时器是 MCU 最灵活的外设之一，可以实现定时、PWM、输入捕获、编码器等多种功能。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。