STM32 HAL库 HAL_TIM_OC_Stop函数详细解释

最新推荐文章于 2025-07-27 17:48:01 发布

bu_shuo

最新推荐文章于 2025-07-27 17:48:01 发布

阅读量404

点赞数 5

CC 4.0 BY-SA版权

文章标签： stm32 STM32CubeMX HAL PWM TIM

本文链接：https://blog.youkuaiyun.com/qq_50930131/article/details/149608575

STM32 HAL库 HAL_TIM_OC_Stop函数详细解释

关键词: STM32; HAL; PWM; HAL_TIM_OC_Stop

OC (Output Compare)输出比较: 输出比较可以通过比较CNT计数器与CCR(捕获/比较寄存器)值的关系, 来对输出电平进行置0、置1或翻转的操作, 用于输出一定频率和占空比的PWM波形.

HAL_TIM_OC_Stop函数原型

/**
  * @brief  Stops the TIM Output Compare signal generation.
  * @brief  停止TIM输出比较信号生成.

  * @param  htim TIM Output Compare handle
  * @param  htim TIM输出比较句柄

  * @param  Channel TIM Channel to be disabled
  * @param  Channel 要禁用的TIM通道
  *          This parameter can be one of the following values:
  *          可选值:
  *            @arg TIM_CHANNEL_1: TIM Channel 1 selected   TIM通道1
  *            @arg TIM_CHANNEL_2: TIM Channel 2 selected   TIM通道2
  *            @arg TIM_CHANNEL_3: TIM Channel 3 selected   TIM通道3
  *            @arg TIM_CHANNEL_4: TIM Channel 4 selected   TIM通道4
  * @retval HAL status  HAL 状态
  */

/* 停止TIM输出比较信号(Output Compare, OC)生成 */
HAL_StatusTypeDef HAL_TIM_OC_Stop(TIM_HandleTypeDef *htim, uint32_t Channel)
{
  /* Check the parameters 参数检验, 检查TIM实例和通道是否有效, 防止非法操作 */
  assert_param(IS_TIM_CCX_INSTANCE(htim->Instance, Channel));

  /* Disable the Output compare channel 禁用输出比较通道 */
  /* 调用底层寄存器操作, 关闭指定通道的比较输出 (PWM输出) 这里通道输出就会关闭 */
  TIM_CCxChannelCmd(htim->Instance, Channel, TIM_CCx_DISABLE);
  /* 若定时器支持刹车功能, 则禁用主输出 (MOE = Main Output Enable) 确保无意外信号输出 */
  /* TIM1和TIM8支持定时器刹车功能 */
  if (IS_TIM_BREAK_INSTANCE(htim->Instance) != RESET)
  {
    /* Disable the Main Output */
    /* MOE位状态: 
     * 1    SET:    允许OC/OCN信号输出到引脚(正常产生PWM、OC波形)
     * 0    RESET:  强制OC/OCN引脚进入安全状态(高阻或空闲电平, 取决于OSSI/OSSR位)
     * 即: MOE = 1 才有波形; MOE = 0输出立即关断.
     * 高级定时器才具备MOE, 即带BDTR寄存器的TIM, STM32F4: TIM1、TIM8
     * 常用于电机控制、逆变器、全桥/半桥驱动等需要死区时间+故障刹车的场合
     * 当检测到刹车输入(BKIN)或软件相想紧急停机时, 软件/硬件会拉低MOE, 瞬间关闭所有输出, 防止炸管.
     * 一键切断高级定时器所有PWM/OC输出的宏, 相当于给功率器件拉闸断电.
     */
    __HAL_TIM_MOE_DISABLE(htim);
  }

  /* Disable the Peripheral 关闭定时器计数器, CNT停止累加, CEN位清零, 降低功耗 */
  /* 确定所有通道都无输出后才关闭定时器TIM1 */
  __HAL_TIM_DISABLE(htim);

  /* Set the TIM channel state 把该通道状态置为REDAY, 供下次Start使用 */
  /* 更新通道状态为就绪 Reday, 以便后续重新配置或启动 */
  TIM_CHANNEL_STATE_SET(htim, Channel, HAL_TIM_CHANNEL_STATE_READY);

  /* Return function status 返回状态 */
  return HAL_OK;
}

HAL_TIM_PWM_Stop函数原型

/**
  * @brief  Stops the PWM signal generation.
  * @param  htim TIM PWM handle
  * @param  Channel TIM Channels to be disabled
  *          This parameter can be one of the following values:
  *            @arg TIM_CHANNEL_1: TIM Channel 1 selected
  *            @arg TIM_CHANNEL_2: TIM Channel 2 selected
  *            @arg TIM_CHANNEL_3: TIM Channel 3 selected
  *            @arg TIM_CHANNEL_4: TIM Channel 4 selected
  * @retval HAL status
  */
HAL_StatusTypeDef HAL_TIM_PWM_Stop(TIM_HandleTypeDef *htim, uint32_t Channel)
{
  /* Check the parameters */
  assert_param(IS_TIM_CCX_INSTANCE(htim->Instance, Channel));

  /* Disable the Capture compare channel */
  TIM_CCxChannelCmd(htim->Instance, Channel, TIM_CCx_DISABLE);

  if (IS_TIM_BREAK_INSTANCE(htim->Instance) != RESET)
  {
    /* Disable the Main Output */
    __HAL_TIM_MOE_DISABLE(htim);
  }

  /* Disable the Peripheral */
  __HAL_TIM_DISABLE(htim);

  /* Set the TIM channel state */
  TIM_CHANNEL_STATE_SET(htim, Channel, HAL_TIM_CHANNEL_STATE_READY);

  /* Return function status */
  return HAL_OK;
}

__HAL_TIM_DISABLE(htim)宏定义解读

/**
  * @brief  Disable the TIM peripheral.
  * @brief  STM32 HAL库中用于安全禁用定时器(TIM)外设的核心操作.
  * @param  __HANDLE__ TIM handle
  * @retval None
  */

/* 禁用TIM1外设的计数器(停止计数), 但仅在满足条件时执行, 避免意外关闭正在使用的定时器通道 */
/* 检查所有通道(主输出CCxE和互补输出CCxNE)是否均已禁用, 确认无输出需求后停止计数器 */
/* 在C语言和宏定义中, 反斜杠\ 是行继续符, 用于将宏定义或长代码分割成多行, 以提高可读性. */
/* \后不能有空格, 反斜杠必须是行末最后一个字符(换行符前无空格) */
/* 缩进不影响功能 \后的换行符会被忽略, 缩进仅为代码美观 */
/* 注释需在\之前 */
#define __HAL_TIM_DISABLE(__HANDLE__) \
  /* do {} while(0) 宏定义安全封装, 确保宏展开后无论调用位置如何, 都能正确形成单条语句块 */
  /* 避免语法冲突, 防止与if/else 等控制流语句结合时产生歧义 */
  do { \
    /* 检查主输出通道是否禁用, TIM_CCER_CCxE_MASK  掩码覆盖所有通道的使能位 CC1E、CC2E、CC3E、CC4E */
    /* 条件成立, 表示所有主输出通道 (如PWM、OC)已关闭 (CCxE = 0) */
    /* 寄存器 TIMx_CCER 位域 CCxE 主输出通道使能 (如PWM、OC) */
    if (((__HANDLE__)->Instance->CCER & TIM_CCER_CCxE_MASK) == 0UL) \
    { \
      /* 检查互补输出通道是否禁用, TIM_CCER_CCxNE_MASK 掩码覆盖互补通道使能位 CC1NE、CC2NE、CC3NE */
      /* 条件成立, 表示所有互补输出(如高级定时器的死区控制) 已关闭 (CCxNE = 0) */
      /* 寄存器 TIMx_CCER 位域 CCxNE 互补输出通道使能 (高级定时器) */
      if(((__HANDLE__)->Instance->CCER & TIM_CCER_CCxNE_MASK) == 0UL) \
      { \
        /* 禁用计数器, TIM_CR1_CEN 为计数器使能位 (Counter Enable) 清零该位, 停止TIM的计数器和时钟 */
        /* 寄存器TIMx_CR1 位域 CEN 计数器使能(1 = 运行, 0 = 停止) */
        (__HANDLE__)->Instance->CR1 &= ~(TIM_CR1_CEN); \
      } \
    } \
  } while(0)

TIM_CCxChannelCmd函数解读

核心功能: 控制TIM定时器的捕获/比较通道输出使能位CCxE, 直接决定通道引脚是否输出信号


/**
  * @brief  Enables or disables the TIM Capture Compare Channel x.
  * @param  TIMx to select the TIM peripheral
  * @param  Channel specifies the TIM Channel
  *          This parameter can be one of the following values:
  *            @arg TIM_CHANNEL_1: TIM Channel 1
  *            @arg TIM_CHANNEL_2: TIM Channel 2
  *            @arg TIM_CHANNEL_3: TIM Channel 3
  *            @arg TIM_CHANNEL_4: TIM Channel 4
  * @param  ChannelState specifies the TIM Channel CCxE bit new state.
  *          This parameter can be: TIM_CCx_ENABLE or TIM_CCx_DISABLE.
  * @retval None
  */


/* TIMx             定时器外设指针 */
/* Channel          通道编号 */
/* ChannelState     使能/禁用状态 */
void TIM_CCxChannelCmd(TIM_TypeDef *TIMx, uint32_t Channel, uint32_t ChannelState)
{
  uint32_t tmp;

  /* Check the parameters 参数验证 */
  /* 验证定时器是否支持比较输出 */
  assert_param(IS_TIM_CC1_INSTANCE(TIMx));
  /* 验证通道号是否合法 */
  assert_param(IS_TIM_CHANNELS(Channel));

  /* 计算位掩码, TIM_CCER_CC1E 为通道1使能位掩码 */
  /* Channel & 0x1FU 将通道号转换为位移量 (确保不超过31位, 防御性编程 )*/
  /* Channel = 1 → tmp = 0x0001 */
  /* Channel = 2 → tmp = 0x0002 */
  /* Channel = 3 → tmp = 0x0004 */
  tmp = TIM_CCER_CC1E << (Channel & 0x1FU); /* 0x1FU = 31 bits max shift */

  /* Reset the CCxE Bit 禁用通道 */
  /* 清零对应通道的CCxE位 (无论当前状态如何, 先确保关闭) */
  TIMx->CCER &= ~tmp;

  /* Set or reset the CCxE Bit 设置新状态 */
  /* 根据ChannelState决定是否重新使用通道 */
  TIMx->CCER |= (uint32_t)(ChannelState << (Channel & 0x1FU)); /* 0x1FU = 31 bits max shift */

  /* CCxE = 1 引脚输出PWM/OC信号 启动PWM、单脉冲输出 */
  /* CCxE = 0 引脚变为高阻态或静态电平 紧急关闭电机驱动 */

}

__HAL_TIM_MOE_DISABLE宏定义

安全禁用高级定时器(TIM1、TIM8)主输出(Main Output Enable, MOE)的关键操作
禁用高级定时器的主输出信号(包括所有PWM和互补输出)
仅在所有主通道(CCxE)和互补通道(CCxNE)均已禁用时, 才清除MOE位, 避免意外切断正在使用的输出


/**
  * @brief  Disable the TIM main Output.
  * @param  __HANDLE__ TIM handle
  * @retval None
  * @note The Main Output Enable of a timer instance is disabled only if all the CCx and CCxN channels have been
  *       disabled
  */
#define __HAL_TIM_MOE_DISABLE(__HANDLE__) \
  do { \
    /* 检查主通道是否已禁用 条件成立表示所有主使出通道关闭 无PWM或OC信号输出 */
    if (((__HANDLE__)->Instance->CCER & TIM_CCER_CCxE_MASK) == 0UL) \
    { \
      /* 检查互补通道是否已禁用 所有互补输出通道已关闭 */
      if(((__HANDLE__)->Instance->CCER & TIM_CCER_CCxNE_MASK) == 0UL) \
      { \
        /* 清零TIMx_BDTR寄存器位的MOE位, 彻底关闭输出级  */
        (__HANDLE__)->Instance->BDTR &= ~(TIM_BDTR_MOE); \
      } \
    } \
  } while(0)