stm32g4xx_ll_utils.h

跳转到此文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_ll_utils.h
  * @author  MCD Application Team
  * @brief   UTILS LL 模块的头文件。
  ******************************************************************************
  * @attention
  *
  * 版权所有 (c) 2019 STMicroelectronics。
  * 保留所有权利。
  *
  * 本软件根据 LICENSE 文件中规定的条款进行许可，
  * 该文件位于本软件组件的根目录中。
  * 如果与本软件一起没有提供 LICENSE 文件，则按“原样”提供。
  *
  ******************************************************************************
  @verbatim
  ==============================================================================
                     ##### 如何使用此驱动程序 #####
  ==============================================================================
    [..]
    LL UTILS 驱动程序包含一组通用 API，可供用户使用：
    （+）设备电子签名
    （+）定时功能
    （+）PLL 配置功能

  @endverbatim
  */

/* 防止重复包含的定义 -------------------------------------*/
#ifndef STM32G4xx_LL_UTILS_H
#define STM32G4xx_LL_UTILS_H

#ifdef __cplusplus
extern "C" {
#endif

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

/** @addtogroup STM32G4xx_LL_Driver
  * @{
  */

/** @defgroup UTILS_LL UTILS
  * @{
  */

/* 私有类型 -------------------------------------------------------------*/
/* 私有变量 ---------------------------------------------------------*/

/* 私有常量 ---------------------------------------------------------*/
/** @defgroup UTILS_LL_Private_Constants UTILS 私有常量
  * @{
  */

/* LL_mDelay 中可使用的最大延迟 */
#define LL_MAX_DELAY                  0xFFFFFFFFU

/**
 * @brief 唯一设备 ID 寄存器基地址
 */
#define UID_BASE_ADDRESS              UID_BASE

/**
 * @brief Flash 大小数据寄存器基地址
 */
#define FLASHSIZE_BASE_ADDRESS        FLASHSIZE_BASE

/**
 * @brief 封装数据寄存器基地址
 */
#define PACKAGE_BASE_ADDRESS          PACKAGE_BASE

/**
  * @}
  */

/* 私有宏 ------------------------------------------------------------*/
/** @defgroup UTILS_LL_Private_Macros UTILS 私有宏
  * @{
  */
/**
  * @}
  */
/* 导出的类型 ------------------------------------------------------------*/
/** @defgroup UTILS_LL_ES_INIT UTILS 导出的结构体
  * @{
  */
/**
  * @brief  UTILS PLL 结构体定义
  */
typedef struct
{
  uint32_t PLLM;   /*!< PLL VCO 输入时钟的分频因子。
                        该参数可以是 @ref RCC_LL_EC_PLLM_DIV 的值

                        之后可使用独立函数
                        @ref LL_RCC_PLL_ConfigDomain_SYS() 进行修改。 */

  uint32_t PLLN;   /*!< PLL VCO 输出时钟的倍频因子。
                        该参数必须是一个介于 Min_Data = 8 和 Max_Data = 86 之间的数字

                        之后可使用独立函数
                        @ref LL_RCC_PLL_ConfigDomain_SYS() 进行修改。 */

  uint32_t PLLR;   /*!< 主系统时钟的分频。
                        该参数可以是 @ref RCC_LL_EC_PLLR_DIV 的值

                        之后可使用独立函数
                        @ref LL_RCC_PLL_ConfigDomain_SYS() 进行修改。 */
} LL_UTILS_PLLInitTypeDef;

/**
  * @brief  UTILS 系统、AHB 和 APB 总线时钟配置结构体定义
  */
typedef struct
{
  uint32_t AHBCLKDivider;         /*!< AHB 时钟 (HCLK) 分频器。该时钟由系统时钟 (SYSCLK) 派生而来。
                                       该参数可以是 @ref RCC_LL_EC_SYSCLK_DIV 的值

                                       之后可使用独立函数
                                       @ref LL_RCC_SetAHBPrescaler() 进行修改。 */

  uint32_t APB1CLKDivider;        /*!< APB1 时钟 (PCLK1) 分频器。该时钟由 AHB 时钟 (HCLK) 派生而来。
                                       该参数可以是 @ref RCC_LL_EC_APB1_DIV 的值

                                       之后可使用独立函数
                                       @ref LL_RCC_SetAPB1Prescaler() 进行修改。 */

  uint32_t APB2CLKDivider;        /*!< APB2 时钟 (PCLK2) 分频器。该时钟由 AHB 时钟 (HCLK) 派生而来。
                                       该参数可以是 @ref RCC_LL_EC_APB2_DIV 的值

                                       之后可使用独立函数
                                       @ref LL_RCC_SetAPB2Prescaler() 进行修改。 */

} LL_UTILS_ClkInitTypeDef;

/**
  * @}
  */

/* 导出的常量 --------------------------------------------------------*/
/** @defgroup UTILS_LL_Exported_Constants UTILS 导出的常量
  * @{
  */

/** @defgroup UTILS_EC_HSE_BYPASS HSE 旁路激活
  * @{
  */
#define LL_UTILS_HSEBYPASS_OFF        0x00000000U       /*!< HSE 旁路未启用                */
#define LL_UTILS_HSEBYPASS_ON         0x00000001U       /*!< HSE 旁路已启用                    */
/**
  * @}
  */

/** @defgroup UTILS_EC_PACKAGETYPE 封装类型
  * @{
  */
#define LL_UTILS_PACKAGETYPE_LQFP64             0x00000000U /*!< LQFP64 封装类型                      */
#define LL_UTILS_PACKAGETYPE_WLCSP64            0x00000001U /*!< WLCSP64 封装类型                     */
#if defined (STM32G411xB) || defined (STM32G411xC) || defined (STM32G431xx) || defined (STM32G414xx) || defined (STM32G441xx) || \
    defined (STM32G471xx) || defined (STM32G473xx) || defined (STM32G483xx) || defined (STM32G474xx) || defined (STM32G484xx)
#define LL_UTILS_PACKAGETYPE_LQFP100_LQFP80     0x00000002U /*!< LQFP100 \ LQFP80 封装类型             */
#define LL_UTILS_PACKAGETYPE_LQFP100 LL_UTILS_PACKAGETYPE_LQFP100_LQFP80  /*!< 向后兼容  */
#else
#define LL_UTILS_PACKAGETYPE_LQFP100            0x00000002U /*!< LQFP100 封装类型                      */
#endif /* STM32G411xB || STM32G411xC || STM32G431xx || STM32G414xx || STM32G441xx || STM32G471xx || STM32G473xx || STM32G483xx || STM32G474xx || STM32G484xx */
#define LL_UTILS_PACKAGETYPE_WLCSP81            0x00000005U /*!< WLCSP81 封装类型                      */
#define LL_UTILS_PACKAGETYPE_LQFP128_UFBGA121   0x00000007U /*!< LQFP128 \ UFBGA121 封装类型           */
#define LL_UTILS_PACKAGETYPE_LQFP128 LL_UTILS_PACKAGETYPE_LQFP128_UFBGA121 /*!< 向后兼容 */
#define LL_UTILS_PACKAGETYPE_UFQFPN32           0x00000008U /*!< UFQFPN32 封装类型                     */
#define LL_UTILS_PACKAGETYPE_LQFP32             0x00000009U /*!< LQFP32 封装类型                       */
#define LL_UTILS_PACKAGETYPE_UFQFPN48           0x0000000AU /*!< UFQFPN48 封装类型                     */
#define LL_UTILS_PACKAGETYPE_LQFP48             0x0000000BU /*!< LQFP48 封装类型                       */
#define LL_UTILS_PACKAGETYPE_WLCSP49            0x0000000CU /*!< WLCSP49 封装类型                      */
#define LL_UTILS_PACKAGETYPE_UFBGA64            0x0000000DU /*!< UFBGA64 封装类型                      */
#define LL_UTILS_PACKAGETYPE_TFBGA100           0x0000000EU /*!< TFBGA100 封装类型                     */
#define LL_UTILS_PACKAGETYPE_UFBGA100 LL_UTILS_PACKAGETYPE_TFBGA100  /*!< 向后兼容       */
#define LL_UTILS_PACKAGETYPE_LQFP48_EBIKE       0x00000010U /*!< LQFP48 EBIKE 封装类型                 */
#if defined (STM32G491xx) || defined (STM32G4A1xx)
#define LL_UTILS_PACKAGETYPE_LQFP80             0x00000011U /*!< LQFP80 封装类型                       */
#endif <