在STM32 HAL库中，设置定时器重装值（ARR, Auto-reload Register）主要通过以下方式实现：

1. 初始化时设置重装值

在定时器初始化结构体 TIM_HandleTypeDef 中直接配置 Init.Period 并调用初始化函数：

TIM_HandleTypeDef htimX; // 定时器句柄

void TIM_Init() {
  htimX.Instance = TIMx;           // 如 TIM2
  htimX.Init.Prescaler = 7199;     // 预分频值
  htimX.Init.Period = 9999;        // 重装值 ARR（决定计数周期）
  htimX.Init.CounterMode = TIM_COUNTERMODE_UP;
  HAL_TIM_Base_Init(&htimX);       // 初始化定时器
}

• Period 即重装值 ARR，设置范围为 0x0000 至 0xFFFF（16位定时器）或更大（高级定时器）。

2. 运行时动态修改重装值

使用宏 __HAL_TIM_SET_AUTORELOAD() 直接修改 ARR：

// 在中断或主循环中修改重装值
__HAL_TIM_SET_AUTORELOAD(&htimX, 4999);  // 新重装值 = 4999

3. 安全更新重装值（带缓冲）

若要避免异步更新导致的时序问题（使用影子寄存器）：

// 启用ARR缓冲（预装载）
SET_BIT(htimX.Instance->CR1, TIM_CR1_ARPE);

// 设置新重装值（更新到影子寄存器）
__HAL_TIM_SET_AUTORELOAD(&htimX, 2999);

// 触发更新事件，使新值生效
__HAL_TIM_GENERATE_SW_EVENT(&htimX, TIM_EGR_UG);

关键点总结

• 初始化时：通过 TIM_HandleTypeDef.Init.Period 设置。
• 运行时修改：用宏 __HAL_TIM_SET_AUTORELOAD()。
• 安全更新：启用 TIM_CR1_ARPE（缓冲）并触发更新事件（TIM_EGR_UG）。
• 计算公式：定时器周期 = (ARR + 1) * (PSC + 1) / TIM_CLK。

注意：直接写 htimX.Instance->ARR = value 也可行，但推荐使用HAL宏确保可移植性。