stm32g4xx_hal_tim_ex.c

转到此文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_hal_tim_ex.c
  * @author  MCD Application Team
  * @brief   TIM HAL模块驱动程序。
  *          此文件提供固件函数，用于管理定时器扩展外设的以下功能：
  *           + 时间霍尔传感器接口初始化
  *           + 时间霍尔传感器接口启动
  *           + 时间互补信号断开和死区时间配置
  *           + 时间主从同步配置
  *           + 时间输出比较/PWM通道配置（用于通道5和6）
  *           + 时间OCRef清除配置
  *           + 定时器重映射功能配置
  *           + 定时器编码器索引配置
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2019 STMicroelectronics.
  * 保留所有权利。
  *
  * 本软件根据可在本软件组件根目录中的LICENSE文件中找到的条款进行许可。
  * 如果本软件未附带LICENSE文件，则按原样提供。
  *
  ******************************************************************************
  @verbatim
  ==============================================================================
                      ##### 定时器扩展功能 #####
  ==============================================================================
  [..]
    定时器扩展功能包括：
    (#) 用于以下功能的可编程死区时间互补输出：
        (++) 输出比较
        (++) PWM生成（边沿和中心对齐模式）
        (++) 单脉冲模式输出
    (#) 用于使用外部信号控制定时器并互连多个定时器的同步电路。
    (#) 断开输入，将定时器输出信号置于复位状态或已知状态。
    (#) 支持用于定位目的的增量（正交）编码器和霍尔传感器电路。
    (#) 在脉冲比较的情况下，配置脉冲长度和延迟。
    (#) 编码器索引配置。

            ##### 如何使用此驱动程序 #####
  ==============================================================================
    [..]
     (#) 通过实现以下函数来初始化TIM底层资源，具体取决于所选功能：
           (++) 霍尔传感器输出：HAL_TIMEx_HallSensor_MspInit()

     (#) 初始化TIM底层资源：
        (##) 使用 __HAL_RCC_TIMx_CLK_ENABLE(); 使能TIM接口时钟。
        (##) TIM引脚配置
            (+++) 使用以下函数使能TIM GPIO的时钟：
              __HAL_RCC_GPIOx_CLK_ENABLE();
            (+++) 使用HAL_GPIO_Init()将这些TIM引脚配置为复用功能模式；

     (#) 如果需要，可以配置外部时钟（默认时钟是来自APBx的内部时钟），
         使用以下函数：HAL_TIM_ConfigClockSource，时钟配置应在任何启动函数之前完成。

     (#) 使用此驱动程序的初始化函数之一将TIM配置为所需的工作模式：
          (++) HAL_TIMEx_HallSensor_Init() 和 HAL_TIMEx_ConfigCommutEvent()：用于使用
               定时器霍尔传感器接口和换向事件，以及相应的中断和DMA请求（如果需要）
               （注意，一个定时器用于与霍尔传感器接口，另一个定时器用于使用换向事件）。
     (#) 在脉冲比较的情况下：
           (++) HAL_TIMEx_OC_ConfigPulseOnCompare()：配置脉冲宽度和预分频器


     (#) 使用启动函数之一激活TIM外设：
           (++) 互补输出比较：HAL_TIMEx_OCN_Start(), HAL_TIMEx_OCN_Start_DMA(),
                HAL_TIMEx_OCN_Start_IT()
           (++) 互补PWM生成：HAL_TIMEx_PWMN_Start(), HAL_TIMEx_PWMN_Start_DMA(),
                HAL_TIMEx_PWMN_Start_IT()
           (++) 互补单脉冲模式输出：HAL_TIMEx_OnePulseN_Start(), HAL_TIMEx_OnePulseN_Start_IT()
           (++) 霍尔传感器输出：HAL_TIMEx_HallSensor_Start(), HAL_TIMEx_HallSensor_Start_DMA(),
                HAL_TIMEx_HallSensor_Start_IT().

  @endverbatim
  ******************************************************************************
  */

/* 包含文件 ------------------------------------------------------------------*/
#include "stm32g4xx_hal.h"

/** @addtogroup STM32G4xx_HAL_Driver
  * @{
  */

/** @defgroup TIMEx TIMEx
  * @brief TIM扩展HAL模块驱动程序
  * @{
  */

#ifdef HAL_TIM_MODULE_ENABLED

/* 私有类型定义 -----------------------------------------------------------*/
/* 私有定义 ------------------------------------------------------------*/
/* 私有常量 ---------------------------------------------------------*/
/** @defgroup TIMEx_Private_Constants TIM扩展私有常量
  * @{
  */
/* 断开输入重新启动的超时时间 */
#define TIM_BREAKINPUT_REARM_TIMEOUT    5UL /* 5毫秒 */
/**
  * @}
  */
/* 私有常量结束 --------------------------------------------------*/

/* 私有宏 ------------------------------------------------------------*/
/* 私有变量 ---------------------------------------------------------*/
/* 私有函数原型 -----------------------------------------------*/
static void TIM_DMADelayPulseNCplt(DMA_HandleTypeDef *hdma);
static void TIM_DMAErrorCCxN(DMA_HandleTypeDef *hdma);
static void TIM_CCxNChannelCmd(TIM_TypeDef *TIMx, uint32_t Channel, uint32_t ChannelNState);

/* 导出函数 --------------------------------------------------------*/
/** @defgroup TIMEx_Exported_Functions TIM扩展导出函数
  * @{
  */

/** @defgroup TIMEx_Exported_Functions_Group1 扩展定时器霍尔传感器函数
  * @brief    定时器霍尔传感器函数
  *
@verbatim
  ==============================================================================
                      ##### 定时器霍尔传感器函数 #####
  ==============================================================================
  [..]
    本节提供允许以下操作的函数：
    (+) 初始化并配置TIM霍尔传感器。
    (+) 反初始化TIM霍尔传感器。
    (+) 启动霍尔传感器接口。
    (+) 停止霍尔传感器接口。
    (+) 启动霍尔传感器接口并使能中断。
    (+) 停止霍尔传感器接口并禁用中断。
    (+) 启动霍尔传感器接口并使能DMA传输。
    (+) 停止霍尔传感器接口并禁用DMA传输。

@endverbatim
  * @{
  */
/**
  * @brief  初始化TIM霍尔传感器接口并初始化关联的句柄。
  * @note   当定时器实例在霍尔传感器接口模式下初始化时，
  *         定时器通道1和通道2被保留，不能用于其他目的。
  * @param  htim TIM霍尔传感器接口句柄
  * @param  sConfig TIM霍尔传感器配置结构
  * @retval HAL状态
  */
HAL_StatusTypeDef HAL_TIMEx_HallSensor_Init(TIM_HandleTypeDef *htim, const TIM_HallSensor_InitTypeDef *sConfig)
{
  TIM_OC_InitTypeDef OC_Config;

  /* 检查TIM句柄分配 */
  if (htim == NULL)
  {
    return HAL_ERROR;
  }

  /* 检查参数 */
  assert_param(IS_TIM_HALL_SENSOR_INTERFACE_INSTANCE(htim->Instance));
  assert_param(IS_TIM_COUNTER_MODE(htim->Init.CounterMode));
  assert_param(IS_TIM_CLOCKDIVISION_DIV(htim->