stm32g4xx_hal_flash_ramfunc.c

转到此文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_hal_flash_ramfunc.c
  * @author  MCD Application Team
  * @brief   FLASH RAMFUNC 驱动程序。
  *          此文件提供应从内部 SRAM 执行的 Flash 固件函数
  *            + 运行模式下的 FLASH 掉电功能
  *            + FLASH DBANK 用户选项字节
  *
  *
  @verbatim
  ==============================================================================
                   ##### Flash RAM 函数 #####
  ==============================================================================

    *** ARM 编译器 ***
    --------------------
    [..] RAM 函数使用工具链选项定义。
         在 RAM 中执行的函数应位于单独的源模块中。使用 'Options for File' 对话框，您可以简单地将模块的 'Code / Const' 区域更改为物理 RAM 中的内存空间。
         可用的内存区域在 'Options for Target' 对话框的 'Target' 选项卡中声明。

    *** ICCARM 编译器 ***
    -----------------------
    [..] RAM 函数使用特定的工具链关键字 "__ramfunc" 定义。

    *** GNU 编译器 ***
    --------------------
    [..] RAM 函数使用特定的工具链属性 "__attribute__((section(".RamFunc")))" 定义。

  @endverbatim
  ******************************************************************************
  * @attention
  *
  * 版权所有 (c) 2019 意法半导体。
  * 保留所有权利。
  *
  * 本软件的许可条款可在本软件组件根目录的 LICENSE 文件中找到。
  * 如果本软件不附带 LICENSE 文件，则按原样提供。
  ******************************************************************************
  */

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

/** @addtogroup STM32G4xx_HAL_Driver
  * @{
  */

/** @defgroup FLASH_RAMFUNC FLASH_RAMFUNC
  * @brief 从 RAM 执行的 FLASH 函数
  * @{
  */

#ifdef HAL_FLASH_MODULE_ENABLED

/* 私有类型定义 -----------------------------------------------------------*/
/* 私有定义 ------------------------------------------------------------*/
/* 私有宏 -------------------------------------------------------------*/
/* 私有变量 ---------------------------------------------------------*/
/* 私有函数原型 -----------------------------------------------*/
/* 导出函数 -------------------------------------------------------*/

/** @defgroup FLASH_RAMFUNC_Exported_Functions FLASH_RAMFUNC 导出函数
  * @{
  */

/** @defgroup FLASH_RAMFUNC_Exported_Functions_Group1 外设特性函数
 *  @brief   数据传输函数
 *
@verbatim
 ===============================================================================
                      ##### ramfunc 函数 #####
 ===============================================================================
    [..]
    本小节提供一组应从 RAM 执行的函数。

@endverbatim
  * @{
  */

/**
  * @brief  启用运行模式下的掉电功能
  * @note   此函数应从 SRAM 内存中调用和执行。
  * @retval None
  */
__RAM_FUNC HAL_StatusTypeDef HAL_FLASHEx_EnableRunPowerDown(void)
{
  /* 启用运行模式下的掉电功能*/
  __HAL_FLASH_POWER_DOWN_ENABLE();

  return HAL_OK;

}

/**
  * @brief  禁用运行模式下的掉电功能
  * @note   此函数应从 SRAM 内存中调用和执行。
  * @retval None
  */
__RAM_FUNC HAL_StatusTypeDef HAL_FLASHEx_DisableRunPowerDown(void)
{
  /* 禁用运行模式下的掉电功能*/
  __HAL_FLASH_POWER_DOWN_DISABLE();

  return HAL_OK;
}

#if defined (FLASH_OPTR_DBANK)
/**
  * @brief  编程 FLASH DBANK 用户选项字节。
  *
  * @note   要配置用户选项字节，必须通过调用 HAL_FLASH_OB_Unlock() 函数清除选项锁定位 OPTLOCK。
  * @note   要修改 DBANK 选项字节，不应定义 PCROP 区域。
  *         要停用 PCROP，用户应执行 RDP 更改。
  *
  * @param  DBankConfig FLASH DBANK 用户选项字节值。
  *         此参数可以是以下值之一：
  *            @arg OB_DBANK_128_BITS: 具有 128 位数据的单库
  *            @arg OB_DBANK_64_BITS: 具有 64 位数据的双库
  *
  * @retval HAL_Status
  */
__RAM_FUNC HAL_StatusTypeDef HAL_FLASHEx_OB_DBankConfig(uint32_t DBankConfig)
{
  uint32_t count, reg;
  HAL_StatusTypeDef status = HAL_ERROR;

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

  /* 检查 PCROP 是否已禁用 */
  reg = FLASH->PCROP1SR;
  if (reg > FLASH->PCROP1ER)
  {
    reg = FLASH->PCROP2SR;
    if (reg > FLASH->PCROP2ER)
    {
      /* 禁用 Flash 预取 */
      __HAL_FLASH_PREFETCH_BUFFER_DISABLE();

      if (READ_BIT(FLASH->ACR, FLASH_ACR_ICEN) != 0U)
      {
        /* 禁用 Flash 指令缓存 */
        __HAL_FLASH_INSTRUCTION_CACHE_DISABLE();

        /* 刷新 Flash 指令缓存 */
        __HAL_FLASH_INSTRUCTION_CACHE_RESET();
      }

      if (READ_BIT(FLASH->ACR, FLASH_ACR_DCEN) != 0U)
      {
        /* 禁用 Flash 数据缓存 */
        __HAL_FLASH_DATA_CACHE_DISABLE();

        /* 刷新 Flash 数据缓存 */
        __HAL_FLASH_DATA_CACHE_RESET();
      }

      /* 如有必要，禁用第一个库的 WRP 区域 A */
      reg = FLASH->WRP1AR;
      if (((reg & FLASH_WRP1AR_WRP1A_STRT) >> FLASH_WRP1AR_WRP1A_STRT_Pos) <=
          ((reg & FLASH_WRP1AR_WRP1A_END) >> FLASH_WRP1AR_WRP1A_END_Pos))
      {
        MODIFY_REG(FLASH->WRP1AR, (FLASH_WRP1AR_WRP1A_STRT | FLASH_WRP1AR_WRP1A_END), FLASH_WRP1AR_WRP1A_STRT);
      }

      /* 如有必要，禁用第一个库的 WRP 区域 B */
      reg = FLASH->WRP1BR;
      if (((reg & FLASH_WRP1BR_WRP1B_STRT) >> FLASH_WRP1BR_WRP1B_STRT_Pos) <=
          ((reg & FLASH_WRP1BR_WRP1B_END) >> FLASH_WRP1BR_WRP1B_END_Pos))
      {
        MODIFY_REG(FLASH->WRP1BR, (FLASH_WRP1BR_WRP1B_STRT | FLASH_WRP1BR_WRP1B_END), FLASH_WRP1BR_WRP1B_STRT);
      }

      /* 如有必要，禁用第二个库的 WRP 区域 A */
      reg = FLASH->WRP2AR;
      if (((reg & FLASH_WRP2AR_WRP2A_STRT) >> FLASH_WRP2AR_WRP2A_STRT_Pos) <=
          ((reg & FLASH_WRP2AR_WRP2A_END) >> FLASH_WRP2AR_WRP2A_END_Pos))
      {
        MODIFY_REG(FLASH->WRP2AR, (FLASH_WRP2AR_WRP2A_STRT | FLASH_WRP2AR_WRP2A_END), FLASH_WRP2AR_WRP2A_STRT);
      }

      /*