stm32g4xx_hal_flash.c

转到此文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_hal_flash.c
  * @author  MCD Application Team
  * @brief   FLASH HAL 模块驱动程序。
  *          此文件提供固件函数，用于管理内部 FLASH 存储器的以下功能：
  *           + 编程操作函数
  *           + 存储控制函数
  *           + 外设错误函数
  *
  @verbatim
  ==============================================================================
                        ##### FLASH 外设特性 #####
  ==============================================================================

  [..] Flash 存储器接口管理 CPU AHB I-Code 和 D-Code 对 Flash 存储器的访问。
       它实现了擦除和编程 Flash 存储器操作以及读写保护机制。

  [..] Flash 存储器接口通过指令预取和缓存行系统加速代码执行。

  [..] FLASH 主要特性：
      (+) Flash 存储器读操作
      (+) Flash 存储器编程/擦除操作
      (+) 读/写保护
      (+) 选项字节编程
      (+) I-Code 预取
      (+) I-Code 上的 32 个缓存行，每行 4*64 或 2*128 位
      (+) D-Code 上的 8 个缓存行，每行 4*64 或 2*128 位
      (+) 错误码纠正 (ECC)：flash 中的数据为 72 位字
          （每个双字增加 8 位）


                        ##### 如何使用此驱动程序 #####
  ==============================================================================
    [..]
      此驱动程序提供函数和宏，用于配置和编程所有 STM32G4xx 器件的 FLASH 存储器。

      (#) Flash 存储器 IO 编程函数：
           (++) 使用 HAL_FLASH_Unlock() 和 HAL_FLASH_Lock() 函数锁定和解锁 FLASH 接口
           (++) 编程函数：双字和快速编程（整行编程）
           (++) 有两种编程模式：
            (+++) 使用 HAL_FLASH_Program() 函数的轮询模式
            (+++) 使用 HAL_FLASH_Program_IT() 函数的中断模式

      (#) 中断和标志管理函数：
           (++) 通过调用 HAL_FLASH_IRQHandler() 处理 FLASH 中断
           (++) 当 flash 操作完成时调用回调函数：
                一切正常时调用 HAL_FLASH_EndOfOperationCallback()，否则调用
                HAL_FLASH_OperationErrorCallback()
           (++) 通过调用 HAL_GetError() 获取错误标志状态

      (#) 选项字节管理函数：
           (++) 使用 HAL_FLASH_OB_Unlock() 和 HAL_FLASH_OB_Lock() 函数锁定和解锁选项字节
           (++) 使用 HAL_FLASH_Launch() 函数启动选项字节的重新加载。
                在这种情况下，会生成复位

    [..]
      除了这些函数之外，此驱动程序还包括一组宏，允许处理以下操作：
       (+) 设置延迟
       (+) 启用/禁用预取缓冲区
       (+) 启用/禁用指令缓存和数据缓存
       (+) 重置指令缓存和数据缓存
       (+) 在低功耗运行和睡眠模式下启用/禁用 Flash 掉电
       (+) 启用/禁用 Flash 中断
       (+) 监控 Flash 标志状态

  @endverbatim
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2019 STMicroelectronics.
  * 保留所有权利。
  *
  * 本软件根据可在本软件组件根目录中的 LICENSE 文件中找到的条款进行许可。
  * 如果此软件未附带 LICENSE 文件，则按原样提供。
  ******************************************************************************
  */

/* Includes ------------------------------------------------------------------*/
#include "stm32g4xx_hal.h"

/** @addtogroup STM32G4xx_HAL_Driver
  * @{
  */

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

#ifdef HAL_FLASH_MODULE_ENABLED

/* Private typedef -----------------------------------------------------------*/
/* Private defines -----------------------------------------------------------*/
/** @defgroup FLASH_Private_Constants FLASH 私有常量
  * @{
  */
#define FLASH_NB_DOUBLE_WORDS_IN_ROW  32
/**
  * @}
  */

/* Private macros ------------------------------------------------------------*/
/* Private variables ---------------------------------------------------------*/
/** @defgroup FLASH_Private_Variables FLASH 私有变量
  * @{
  */

/**
  * @brief  用于中断下编程/擦除扇区的变量
  */
FLASH_ProcessTypeDef pFlash  = {.Lock = HAL_UNLOCKED,
                                .ErrorCode = HAL_FLASH_ERROR_NONE,
                                .ProcedureOnGoing = FLASH_PROC_NONE,
                                .Address = 0U,
                                .Bank = FLASH_BANK_1,
                                .Page = 0U,
                                .NbPagesToErase = 0U,
                                .CacheToReactivate = FLASH_CACHE_DISABLED};
/**
  * @}
  */

/* Private function prototypes -----------------------------------------------*/
/** @defgroup FLASH_Private_Functions FLASH 私有函数
  * @{
  */
static void          FLASH_Program_DoubleWord(uint32_t Address, uint64_t Data);
static void          FLASH_Program_Fast(uint32_t Address, uint32_t DataAddress);
/**
  * @}
  */

/* Exported functions --------------------------------------------------------*/
/** @defgroup FLASH_Exported_Functions FLASH 导出函数
  * @{
  */

/** @defgroup FLASH_Exported_Functions_Group1 编程操作函数
  *  @brief   编程操作函数
  *
@verbatim
 ===============================================================================
                  ##### 编程操作函数 #####
 ===============================================================================
    [..]
    此子部分提供一组函数，用于管理 FLASH 编程操作。

@endverbatim
  * @{
  */

/**
  * @brief  在指定地址编程双字或快速编程一行。
  * @param  TypeProgram 指示在指定地址编程的方式。
  *         此参数可以是 @ref FLASH_Type_Program 的值。
  * @param  Address 指定要编程的地址。
  * @param  Data 指定要编程的数据。
  *         此参数是双字编程的数据，以及存储行快速编程数据的地址。
  *
  * @retval HAL_Status
  */
HAL_StatusTypeDef HAL_FLASH_Program(uint32_t TypeProgram, uint32_t Address, uint64_t Data)
{
  HAL_StatusTypeDef status;
  uint32_t prog_bit = 0;

  /* 检查参数 */
  assert_param(IS_FLASH_TYPEPROGRAM(TypeProgram));

  /* 进程已锁定 */
  __HAL_LOCK(&pFlash);

  /* 等待上一个操作完成 */
  status =