stm32g4xx_hal_cortex.h

转到此文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_hal_cortex.h
  * @author  MCD 应用团队
  * @brief   CORTEX HAL 模块的头文件。
  ******************************************************************************
  * @attention
  *
  * 版权所有 (c) 2019 STMicroelectronics。
  * 保留所有权利。
  *
  * 本软件根据可在 LICENSE 文件中找到的条款进行许可
  * 位于本软件组件的根目录中。
  * 如果本软件未附带 LICENSE 文件，则按“原样”提供。
  *
  ******************************************************************************
  */
/* 定义以防止递归包含 -------------------------------------*/
#ifndef __STM32G4xx_HAL_CORTEX_H
#define __STM32G4xx_HAL_CORTEX_H

#ifdef __cplusplus
 extern "C" {
#endif

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

/** @addtogroup STM32G4xx_HAL_Driver
  * @{
  */

/** @defgroup CORTEX CORTEX
  * @brief CORTEX HAL 模块驱动程序
  * @{
  */

/* 导出类型 ------------------------------------------------------------*/
/** @defgroup CORTEX_Exported_Types CORTEX 导出类型
  * @{
  */

#if (__MPU_PRESENT == 1)
/** @defgroup CORTEX_MPU_Region_Initialization_Structure_definition MPU 区域初始化结构定义
  * @brief  MPU 区域初始化结构
  * @{
  */
typedef struct
{
  uint8_t                Enable;                /*!< 指定区域的状态。
                                                     此参数可以是 @ref CORTEX_MPU_Region_Enable 的值                 */
  uint8_t                Number;                /*!< 指定要保护的区域编号。
                                                     此参数可以是 @ref CORTEX_MPU_Region_Number 的值                 */
  uint32_t               BaseAddress;           /*!< 指定要保护区域的基地址。                           */
  uint8_t                Size;                  /*!< 指定要保护区域的大小。
                                                     此参数可以是 @ref CORTEX_MPU_Region_Size 的值                   */
  uint8_t                SubRegionDisable;      /*!< 指定要禁用的子区域保护的数量。
                                                     此参数必须是介于 Min_Data = 0x00 和 Max_Data = 0xFF 之间的数字    */
  uint8_t                TypeExtField;          /*!< 指定 TEX 字段级别。
                                                     此参数可以是 @ref CORTEX_MPU_TEX_Levels 的值                    */
  uint8_t                AccessPermission;      /*!< 指定区域访问权限类型。
                                                     此参数可以是 @ref CORTEX_MPU_Region_Permission_Attributes 的值  */
  uint8_t                DisableExec;           /*!< 指定指令访问状态。
                                                     此参数可以是 @ref CORTEX_MPU_Instruction_Access 的值            */
  uint8_t                IsShareable;           /*!< 指定受保护区域的可共享性状态。
                                                     此参数可以是 @ref CORTEX_MPU_Access_Shareable 的值              */
  uint8_t                IsCacheable;           /*!< 指定受保护区域的可缓存性状态。
                                                     此参数可以是 @ref CORTEX_MPU_Access_Cacheable 的值              */
  uint8_t                IsBufferable;          /*!< 指定受保护区域的可缓冲性状态。
                                                     此参数可以是 @ref CORTEX_MPU_Access_Bufferable 的值             */
}MPU_Region_InitTypeDef;
/**
  * @}
  */
#endif /* __MPU_PRESENT */

/**
  * @}
  */

/* 导出常量 --------------------------------------------------------*/

/** @defgroup CORTEX_Exported_Constants CORTEX 导出常量
  * @{
  */

/** @defgroup CORTEX_Preemption_Priority_Group CORTEX 抢占优先级组
  * @{
  */
#define NVIC_PRIORITYGROUP_0         0x00000007U /*!< 0 位用于抢占优先级，
                                                      4 位用于子优先级 */
#define NVIC_PRIORITYGROUP_1         0x00000006U /*!< 1 位用于抢占优先级，
                                                      3 位用于子优先级 */
#define NVIC_PRIORITYGROUP_2         0x00000005U /*!< 2 位用于抢占优先级，
                                                      2 位用于子优先级 */
#define NVIC_PRIORITYGROUP_3         0x00000004U /*!< 3 位用于抢占优先级，
                                                      1 位用于子优先级 */
#define NVIC_PRIORITYGROUP_4         0x00000003U /*!< 4 位用于抢占优先级，
                                                      0 位用于子优先级 */
/**
  * @}
  */

/** @defgroup CORTEX_SysTick_clock_source CORTEX SysTick 时钟源
  * @{
  */
#define SYSTICK_CLKSOURCE_HCLK_DIV8       0x00000000U
#define SYSTICK_CLKSOURCE_HCLK            0x00000004U

/**
  * @}
  */

#if (__MPU_PRESENT == 1)
/** @defgroup CORTEX_MPU_HFNMI_PRIVDEF_Control CORTEX MPU HFNMI 和特权访问控制
  * @{
  */
#define  MPU_HFNMI_PRIVDEF_NONE           0x00000000U
#define  MPU_HARDFAULT_NMI                (MPU_CTRL_HFNMIENA_Msk)
#define  MPU_PRIVILEGED_DEFAULT           (MPU_CTRL_PRIVDEFENA_Msk)
#define  MPU_HFNMI_PRIVDEF                (MPU_CTRL_HFNMIENA_Msk | MPU_CTRL_PRIVDEFENA_Msk)
/**
  * @}
  */

/** @defgroup CORTEX_MPU_Region_Enable CORTEX MPU 区域使能
  * @{
  */
#define  MPU_REGION_ENABLE           ((uint8_t)0x01)
#define  MPU_REGION_DISABLE          ((uint8_t)0x00)
/**
  * @}
  */

/** @defgroup CORTEX_MPU_Instruction_Access CORTEX MPU 指令访问
  * @{
  */
#define  MPU_INSTRUCTION_ACCESS_ENABLE      ((uint8_t)0x00)
#define  MPU_INSTRUCTION_ACCESS_DISABLE     ((uint8_t)0x01)
/**
  * @}
  */

/** @defgroup CORTEX_MPU_Access_Shareable CORTEX MPU 访问可共享
  * @{
  */
#define  MPU_ACCESS_SHAREABLE        ((uint8_t)0x01)
#define  MPU_ACCESS_NOT_SHAREABLE    ((uint8_t)0x00)
/**
  * @}
  */

/** @defgroup CORTEX_MPU_Access_Cacheable CORTEX MPU 访问可缓存
  * @{
  */
#define  MPU_ACCESS_CACHEABLE        ((uint8_t)0x01)
#define  MPU_ACCESS_NOT_CACHEABLE    ((uint8_t)0x00)
/**
  * @}
  */

/** @defgroup CORTEX_MPU_Access_Bufferable CORTEX MPU 访问可缓冲
  * @{
  */
#define  MPU_ACCESS_BUFFERABLE       ((uint8_t)0x01)
#define  MPU_ACCESS_NOT_BUFFERABLE   ((uint8_t)0x00)
/**
  * @}
  */

/** @defgroup CORTEX_MPU_TEX_Levels CORTEX MPU TEX 级别
  * @{
  */
#define  MPU_TEX_LEVEL0              ((uint8_t)0x00)
#define  MPU_TEX_LEVEL1              ((uint8_t)0x01)