WebSVN – EDIS_Ignition – Diff – /trunk/Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_flash.c

 /**
   ******************************************************************************
   * @file    stm32f1xx_hal_flash.c
   * @author  MCD Application Team
   * @brief   FLASH HAL module driver.
   *          This file provides firmware functions to manage the following
   *          functionalities of the internal FLASH memory:
   *           + Program operations functions
   *           + Memory Control functions
   *           + Peripheral State functions
   *
   @verbatim
   ==============================================================================
                         ##### FLASH peripheral features #####
   ==============================================================================
   [..] The Flash memory interface manages CPU AHB I-Code and D-Code accesses
        to the Flash memory. It implements the erase and program Flash memory operations
        and the read and write protection mechanisms.
   [..] The Flash memory interface accelerates code execution with a system of instruction
       prefetch.
   [..] The FLASH main features are:
       (+) Flash memory read operations
       (+) Flash memory program/erase operations
       (+) Read / write protections
       (+) Prefetch on I-Code
       (+) Option Bytes programming
                      ##### How to use this driver #####
   ==============================================================================
   [..]
       This driver provides functions and macros to configure and program the FLASH
       memory of all STM32F1xx devices.
       (#) FLASH Memory I/O Programming functions: this group includes all needed
           functions to erase and program the main memory:
         (++) Lock and Unlock the FLASH interface
         (++) Erase function: Erase page, erase all pages
         (++) Program functions: half word, word and doubleword
       (#) FLASH Option Bytes Programming functions: this group includes all needed
           functions to manage the Option Bytes:
         (++) Lock and Unlock the Option Bytes
         (++) Set/Reset the write protection
         (++) Set the Read protection Level
         (++) Program the user Option Bytes
         (++) Launch the Option Bytes loader
         (++) Erase Option Bytes
         (++) Program the data Option Bytes
         (++) Get the Write protection.
         (++) Get the user option bytes.
       (#) Interrupts and flags management functions : this group
           includes all needed functions to:
         (++) Handle FLASH interrupts
         (++) Wait for last FLASH operation according to its status
         (++) Get error flag status
   [..] In addition to these function, this driver includes a set of macros allowing
        to handle the following operations:
       (+) Set/Get the latency
       (+) Enable/Disable the prefetch buffer
       (+) Enable/Disable the half cycle access
       (+) Enable/Disable the FLASH interrupts
       (+) Monitor the FLASH flags status
   @endverbatim
   ******************************************************************************
   * @attention
   *
-  * <h2><center>&copy; Copyright (c) 2016 STMicroelectronics.
+  * Copyright (c) 2016 STMicroelectronics.
-  * All rights reserved.</center></h2>
+  * All rights reserved.
   *
-  * This software component is licensed by ST under BSD 3-Clause license,
+  * This software is licensed under terms that can be found in the LICENSE file in
-  * the "License"; You may not use this file except in compliance with the
+  * the root directory of this software component.
-  * License. You may obtain a copy of the License at:
+  * If no LICENSE file comes with this software, it is provided AS-IS.
-  *                        opensource.org/licenses/BSD-3-Clause
+  ******************************************************************************
-  *
+  */
-  ******************************************************************************
-  */
+/* Includes ------------------------------------------------------------------*/
+#include "stm32f1xx_hal.h"
-/* Includes ------------------------------------------------------------------*/
-#include "stm32f1xx_hal.h"
+/** @addtogroup STM32F1xx_HAL_Driver
+  * @{
-/** @addtogroup STM32F1xx_HAL_Driver
+  */
-  * @{
-  */
+#ifdef HAL_FLASH_MODULE_ENABLED
-#ifdef HAL_FLASH_MODULE_ENABLED
+/** @defgroup FLASH FLASH
+  * @brief FLASH HAL module driver
-/** @defgroup FLASH FLASH
+  * @{
-  * @brief FLASH HAL module driver
+  */
-  * @{
-  */
+/* Private typedef -----------------------------------------------------------*/
+/* Private define ------------------------------------------------------------*/
-/* Private typedef -----------------------------------------------------------*/
+/** @defgroup FLASH_Private_Constants FLASH Private Constants
-/* Private define ------------------------------------------------------------*/
+  * @{
-/** @defgroup FLASH_Private_Constants FLASH Private Constants
+  */
-  * @{
+/**
-  */
+  * @}
-/**
+  */
-  * @}
-  */
+/* Private macro ---------------------------- ---------------------------------*/
+/** @defgroup FLASH_Private_Macros FLASH Private Macros
-/* Private macro ---------------------------- ---------------------------------*/
+  * @{
-/** @defgroup FLASH_Private_Macros FLASH Private Macros
+  */
-  * @{
-  */
+/**
+  * @}
-/**
+  */
-  * @}
-  */
+/* Private variables ---------------------------------------------------------*/
+/** @defgroup FLASH_Private_Variables FLASH Private Variables
-/* Private variables ---------------------------------------------------------*/
+  * @{
-/** @defgroup FLASH_Private_Variables FLASH Private Variables
+  */
-  * @{
+/* Variables used for Erase pages under interruption*/
-  */
+FLASH_ProcessTypeDef pFlash;
-/* Variables used for Erase pages under interruption*/
+/**
-FLASH_ProcessTypeDef pFlash;
+  * @}
-/**
+  */
-  * @}
-  */
+/* Private function prototypes -----------------------------------------------*/
+/** @defgroup FLASH_Private_Functions FLASH Private Functions
-/* Private function prototypes -----------------------------------------------*/
+  * @{
-/** @defgroup FLASH_Private_Functions FLASH Private Functions
+  */
-  * @{
+static  void   FLASH_Program_HalfWord(uint32_t Address, uint16_t Data);
-  */
+static  void   FLASH_SetErrorCode(void);
-static  void   FLASH_Program_HalfWord(uint32_t Address, uint16_t Data);
+extern void    FLASH_PageErase(uint32_t PageAddress);
-static  void   FLASH_SetErrorCode(void);
+/**
-extern void    FLASH_PageErase(uint32_t PageAddress);
+  * @}
-/**
+  */
-  * @}
-  */
+/* Exported functions ---------------------------------------------------------*/
+/** @defgroup FLASH_Exported_Functions FLASH Exported Functions
-/* Exported functions ---------------------------------------------------------*/
+  * @{
-/** @defgroup FLASH_Exported_Functions FLASH Exported Functions
+  */
-  * @{
-  */
+/** @defgroup FLASH_Exported_Functions_Group1 Programming operation functions
+  *  @brief   Programming operation functions
-/** @defgroup FLASH_Exported_Functions_Group1 Programming operation functions
+  *
-  *  @brief   Programming operation functions
+@verbatim
-  *
+@endverbatim
-@verbatim
+  * @{
-@endverbatim
+  */
-  * @{
-  */
+/**
+  * @brief  Program halfword, word or double word at a specified address
-/**
+  * @note   The function HAL_FLASH_Unlock() should be called before to unlock the FLASH interface
-  * @brief  Program halfword, word or double word at a specified address
+  *         The function HAL_FLASH_Lock() should be called after to lock the FLASH interface
-  * @note   The function HAL_FLASH_Unlock() should be called before to unlock the FLASH interface
+  *
-  *         The function HAL_FLASH_Lock() should be called after to lock the FLASH interface
+  * @note   If an erase and a program operations are requested simultaneously,
-  *
+  *         the erase operation is performed before the program one.
-  * @note   If an erase and a program operations are requested simultaneously,
+  *
-  *         the erase operation is performed before the program one.
+  * @note   FLASH should be previously erased before new programmation (only exception to this
-  *
+  *         is when 0x0000 is programmed)
-  * @note   FLASH should be previously erased before new programmation (only exception to this
+  *
-  *         is when 0x0000 is programmed)
+  * @param  TypeProgram:  Indicate the way to program at a specified address.
-  *
+  *                       This parameter can be a value of @ref FLASH_Type_Program
-  * @param  TypeProgram:  Indicate the way to program at a specified address.
+  * @param  Address:      Specifies the address to be programmed.
-  *                       This parameter can be a value of @ref FLASH_Type_Program
+  * @param  Data:         Specifies the data to be programmed
-  * @param  Address:      Specifies the address to be programmed.
+  *
-  * @param  Data:         Specifies the data to be programmed
+  * @retval HAL_StatusTypeDef HAL Status
-  *
+  */
-  * @retval HAL_StatusTypeDef HAL Status
+HAL_StatusTypeDef HAL_FLASH_Program(uint32_t TypeProgram, uint32_t Address, uint64_t Data)
-  */
+{
-HAL_StatusTypeDef HAL_FLASH_Program(uint32_t TypeProgram, uint32_t Address, uint64_t Data)
+  HAL_StatusTypeDef status = HAL_ERROR;
-{
+  uint8_t index = 0;
-  HAL_StatusTypeDef status = HAL_ERROR;
+  uint8_t nbiterations = 0;
-  uint8_t index = 0;
-  uint8_t nbiterations = 0;
+  /* Process Locked */
+  __HAL_LOCK(&pFlash);
-  /* Process Locked */
-  __HAL_LOCK(&pFlash);
+  /* Check the parameters */
+  assert_param(IS_FLASH_TYPEPROGRAM(TypeProgram));
-  /* Check the parameters */
+  assert_param(IS_FLASH_PROGRAM_ADDRESS(Address));
-  assert_param(IS_FLASH_TYPEPROGRAM(TypeProgram));
-  assert_param(IS_FLASH_PROGRAM_ADDRESS(Address));
+#if defined(FLASH_BANK2_END)
+  if(Address <= FLASH_BANK1_END)
-#if defined(FLASH_BANK2_END)
+  {
-  if(Address <= FLASH_BANK1_END)
+#endif /* FLASH_BANK2_END */
-  {
+    /* Wait for last operation to be completed */
-#endif /* FLASH_BANK2_END */
+    status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
-    /* Wait for last operation to be completed */
+#if defined(FLASH_BANK2_END)
-    status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
+  }
-#if defined(FLASH_BANK2_END)
+  else
-  }
+  {
-  else
+    /* Wait for last operation to be completed */
-  {
+    status = FLASH_WaitForLastOperationBank2(FLASH_TIMEOUT_VALUE);
-    /* Wait for last operation to be completed */
+  }
-    status = FLASH_WaitForLastOperationBank2(FLASH_TIMEOUT_VALUE);
+#endif /* FLASH_BANK2_END */
-  }
-#endif /* FLASH_BANK2_END */
+  if(status == HAL_OK)
+  {
-  if(status == HAL_OK)
+    if(TypeProgram == FLASH_TYPEPROGRAM_HALFWORD)
-  {
+    {
-    if(TypeProgram == FLASH_TYPEPROGRAM_HALFWORD)
+      /* Program halfword (16-bit) at a specified address. */
-    {
+      nbiterations = 1U;
-      /* Program halfword (16-bit) at a specified address. */
+    }
-      nbiterations = 1U;
+    else if(TypeProgram == FLASH_TYPEPROGRAM_WORD)
-    }
+    {
-    else if(TypeProgram == FLASH_TYPEPROGRAM_WORD)
+      /* Program word (32-bit = 2*16-bit) at a specified address. */
-    {
+      nbiterations = 2U;
-      /* Program word (32-bit = 2*16-bit) at a specified address. */
+    }
-      nbiterations = 2U;
+    else
-    }
+    {
-    else
+      /* Program double word (64-bit = 4*16-bit) at a specified address. */
-    {
+      nbiterations = 4U;
-      /* Program double word (64-bit = 4*16-bit) at a specified address. */
+    }
-      nbiterations = 4U;
-    }
+    for (index = 0U; index < nbiterations; index++)
+    {
-    for (index = 0U; index < nbiterations; index++)
+      FLASH_Program_HalfWord((Address + (2U*index)), (uint16_t)(Data >> (16U*index)));
-    {
-      FLASH_Program_HalfWord((Address + (2U*index)), (uint16_t)(Data >> (16U*index)));
+#if defined(FLASH_BANK2_END)
+      if(Address <= FLASH_BANK1_END)
-#if defined(FLASH_BANK2_END)
+      {
-      if(Address <= FLASH_BANK1_END)
+#endif /* FLASH_BANK2_END */
-      {
+        /* Wait for last operation to be completed */
-#endif /* FLASH_BANK2_END */
+        status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
-        /* Wait for last operation to be completed */
-        status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
+        /* If the program operation is completed, disable the PG Bit */
+        CLEAR_BIT(FLASH->CR, FLASH_CR_PG);
-        /* If the program operation is completed, disable the PG Bit */
+#if defined(FLASH_BANK2_END)
-        CLEAR_BIT(FLASH->CR, FLASH_CR_PG);
+      }
-#if defined(FLASH_BANK2_END)
+      else
-      }
+      {
-      else
+        /* Wait for last operation to be completed */
-      {
+        status = FLASH_WaitForLastOperationBank2(FLASH_TIMEOUT_VALUE);
-        /* Wait for last operation to be completed */
-        status = FLASH_WaitForLastOperationBank2(FLASH_TIMEOUT_VALUE);
+        /* If the program operation is completed, disable the PG Bit */
+        CLEAR_BIT(FLASH->CR2, FLASH_CR2_PG);
-        /* If the program operation is completed, disable the PG Bit */
+      }
-        CLEAR_BIT(FLASH->CR2, FLASH_CR2_PG);
+#endif /* FLASH_BANK2_END */
-      }
+      /* In case of error, stop programation procedure */
-#endif /* FLASH_BANK2_END */
+      if (status != HAL_OK)
-      /* In case of error, stop programation procedure */
+      {
-      if (status != HAL_OK)
+        break;
-      {
+      }
-        break;
+    }
-      }
+  }
-    }
-  }
+  /* Process Unlocked */
+  __HAL_UNLOCK(&pFlash);
-  /* Process Unlocked */
-  __HAL_UNLOCK(&pFlash);
+  return status;
+}
-  return status;
-}
+/**
+  * @brief  Program halfword, word or double word at a specified address  with interrupt enabled.
-/**
+  * @note   The function HAL_FLASH_Unlock() should be called before to unlock the FLASH interface
-  * @brief  Program halfword, word or double word at a specified address  with interrupt enabled.
+  *         The function HAL_FLASH_Lock() should be called after to lock the FLASH interface
-  * @note   The function HAL_FLASH_Unlock() should be called before to unlock the FLASH interface
+  *
-  *         The function HAL_FLASH_Lock() should be called after to lock the FLASH interface
+  * @note   If an erase and a program operations are requested simultaneously,
-  *
+  *         the erase operation is performed before the program one.
-  * @note   If an erase and a program operations are requested simultaneously,
+  *
-  *         the erase operation is performed before the program one.
+  * @param  TypeProgram: Indicate the way to program at a specified address.
-  *
+  *                      This parameter can be a value of @ref FLASH_Type_Program
-  * @param  TypeProgram: Indicate the way to program at a specified address.
+  * @param  Address:     Specifies the address to be programmed.
-  *                      This parameter can be a value of @ref FLASH_Type_Program
+  * @param  Data:        Specifies the data to be programmed
-  * @param  Address:     Specifies the address to be programmed.
+  *
-  * @param  Data:        Specifies the data to be programmed
+  * @retval HAL_StatusTypeDef HAL Status
-  *
+  */
-  * @retval HAL_StatusTypeDef HAL Status
+HAL_StatusTypeDef HAL_FLASH_Program_IT(uint32_t TypeProgram, uint32_t Address, uint64_t Data)
-  */
+{
-HAL_StatusTypeDef HAL_FLASH_Program_IT(uint32_t TypeProgram, uint32_t Address, uint64_t Data)
+  HAL_StatusTypeDef status = HAL_OK;
-{
-  HAL_StatusTypeDef status = HAL_OK;
+  /* Process Locked */
+  __HAL_LOCK(&pFlash);
-  /* Process Locked */
-  __HAL_LOCK(&pFlash);
+  /* Check the parameters */
+  assert_param(IS_FLASH_TYPEPROGRAM(TypeProgram));
-  /* Check the parameters */
+  assert_param(IS_FLASH_PROGRAM_ADDRESS(Address));
-  assert_param(IS_FLASH_TYPEPROGRAM(TypeProgram));
-  assert_param(IS_FLASH_PROGRAM_ADDRESS(Address));
+#if defined(FLASH_BANK2_END)
+  /* If procedure already ongoing, reject the next one */
-#if defined(FLASH_BANK2_END)
+  if (pFlash.ProcedureOnGoing != FLASH_PROC_NONE)
-  /* If procedure already ongoing, reject the next one */
+  {
-  if (pFlash.ProcedureOnGoing != FLASH_PROC_NONE)
+    return HAL_ERROR;
-  {
+  }
-    return HAL_ERROR;
-  }
+  if(Address <= FLASH_BANK1_END)
+  {
-  if(Address <= FLASH_BANK1_END)
+    /* Enable End of FLASH Operation and Error source interrupts */
-  {
+    __HAL_FLASH_ENABLE_IT(FLASH_IT_EOP_BANK1 | FLASH_IT_ERR_BANK1);
-    /* Enable End of FLASH Operation and Error source interrupts */
-    __HAL_FLASH_ENABLE_IT(FLASH_IT_EOP_BANK1 | FLASH_IT_ERR_BANK1);
+  }else
+  {
-  }else
+    /* Enable End of FLASH Operation and Error source interrupts */
-  {
+    __HAL_FLASH_ENABLE_IT(FLASH_IT_EOP_BANK2 | FLASH_IT_ERR_BANK2);
-    /* Enable End of FLASH Operation and Error source interrupts */
+  }
-    __HAL_FLASH_ENABLE_IT(FLASH_IT_EOP_BANK2 | FLASH_IT_ERR_BANK2);
+#else
-  }
+  /* Enable End of FLASH Operation and Error source interrupts */
-#else
+  __HAL_FLASH_ENABLE_IT(FLASH_IT_EOP | FLASH_IT_ERR);
-  /* Enable End of FLASH Operation and Error source interrupts */
+#endif /* FLASH_BANK2_END */
-  __HAL_FLASH_ENABLE_IT(FLASH_IT_EOP | FLASH_IT_ERR);
-#endif /* FLASH_BANK2_END */
+  pFlash.Address = Address;
+  pFlash.Data = Data;
-  pFlash.Address = Address;
-  pFlash.Data = Data;
+  if(TypeProgram == FLASH_TYPEPROGRAM_HALFWORD)
+  {
-  if(TypeProgram == FLASH_TYPEPROGRAM_HALFWORD)
+    pFlash.ProcedureOnGoing = FLASH_PROC_PROGRAMHALFWORD;
-  {
+    /* Program halfword (16-bit) at a specified address. */
-    pFlash.ProcedureOnGoing = FLASH_PROC_PROGRAMHALFWORD;
+    pFlash.DataRemaining = 1U;
-    /* Program halfword (16-bit) at a specified address. */
+  }
-    pFlash.DataRemaining = 1U;
+  else if(TypeProgram == FLASH_TYPEPROGRAM_WORD)
-  }
+  {
-  else if(TypeProgram == FLASH_TYPEPROGRAM_WORD)
+    pFlash.ProcedureOnGoing = FLASH_PROC_PROGRAMWORD;
-  {
+    /* Program word (32-bit : 2*16-bit) at a specified address. */
-    pFlash.ProcedureOnGoing = FLASH_PROC_PROGRAMWORD;
+    pFlash.DataRemaining = 2U;
-    /* Program word (32-bit : 2*16-bit) at a specified address. */
+  }
-    pFlash.DataRemaining = 2U;
+  else
-  }
+  {
-  else
+    pFlash.ProcedureOnGoing = FLASH_PROC_PROGRAMDOUBLEWORD;
-  {
+    /* Program double word (64-bit : 4*16-bit) at a specified address. */
-    pFlash.ProcedureOnGoing = FLASH_PROC_PROGRAMDOUBLEWORD;
+    pFlash.DataRemaining = 4U;
-    /* Program double word (64-bit : 4*16-bit) at a specified address. */
+  }
-    pFlash.DataRemaining = 4U;
-  }
+  /* Program halfword (16-bit) at a specified address. */
+  FLASH_Program_HalfWord(Address, (uint16_t)Data);
-  /* Program halfword (16-bit) at a specified address. */
-  FLASH_Program_HalfWord(Address, (uint16_t)Data);
+  return status;
+}
-  return status;
-}
+/**
+  * @brief This function handles FLASH interrupt request.
-/**
+  * @retval None
-  * @brief This function handles FLASH interrupt request.
+  */
-  * @retval None
+void HAL_FLASH_IRQHandler(void)
-  */
+{
-void HAL_FLASH_IRQHandler(void)
+  uint32_t addresstmp = 0U;
-{
-  uint32_t addresstmp = 0U;
+  /* Check FLASH operation error flags */
+#if defined(FLASH_BANK2_END)
-  /* Check FLASH operation error flags */
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR_BANK1) || __HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR_BANK1) || \
-#if defined(FLASH_BANK2_END)
+    (__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR_BANK2) || __HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR_BANK2)))
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR_BANK1) || __HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR_BANK1) || \
+#else
-    (__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR_BANK2) || __HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR_BANK2)))
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR) ||__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR))
-#else
+#endif /* FLASH_BANK2_END */
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR) ||__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR))
+  {
-#endif /* FLASH_BANK2_END */
+    /* Return the faulty address */
-  {
+    addresstmp = pFlash.Address;
-    /* Return the faulty address */
+    /* Reset address */
-    addresstmp = pFlash.Address;
+    pFlash.Address = 0xFFFFFFFFU;
-    /* Reset address */
-    pFlash.Address = 0xFFFFFFFFU;
+    /* Save the Error code */
+    FLASH_SetErrorCode();
-    /* Save the Error code */
-    FLASH_SetErrorCode();
+    /* FLASH error interrupt user callback */
+    HAL_FLASH_OperationErrorCallback(addresstmp);
-    /* FLASH error interrupt user callback */
-    HAL_FLASH_OperationErrorCallback(addresstmp);
+    /* Stop the procedure ongoing */
+    pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
-    /* Stop the procedure ongoing */
+  }
-    pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
-  }
+  /* Check FLASH End of Operation flag  */
+#if defined(FLASH_BANK2_END)
-  /* Check FLASH End of Operation flag  */
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP_BANK1))
-#if defined(FLASH_BANK2_END)
+  {
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP_BANK1))
+    /* Clear FLASH End of Operation pending bit */
-  {
+    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP_BANK1);
-    /* Clear FLASH End of Operation pending bit */
+#else
-    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP_BANK1);
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP))
-#else
+  {
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP))
+    /* Clear FLASH End of Operation pending bit */
-  {
+    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
-    /* Clear FLASH End of Operation pending bit */
+#endif /* FLASH_BANK2_END */
-    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
-#endif /* FLASH_BANK2_END */
+    /* Process can continue only if no error detected */
+    if(pFlash.ProcedureOnGoing != FLASH_PROC_NONE)
-    /* Process can continue only if no error detected */
+    {
-    if(pFlash.ProcedureOnGoing != FLASH_PROC_NONE)
+      if(pFlash.ProcedureOnGoing == FLASH_PROC_PAGEERASE)
-    {
+      {
-      if(pFlash.ProcedureOnGoing == FLASH_PROC_PAGEERASE)
+        /* Nb of pages to erased can be decreased */
-      {
+        pFlash.DataRemaining--;
-        /* Nb of pages to erased can be decreased */
-        pFlash.DataRemaining--;
+        /* Check if there are still pages to erase */
+        if(pFlash.DataRemaining != 0U)
-        /* Check if there are still pages to erase */
+        {
-        if(pFlash.DataRemaining != 0U)
+          addresstmp = pFlash.Address;
-        {
+          /*Indicate user which sector has been erased */
-          addresstmp = pFlash.Address;
+          HAL_FLASH_EndOfOperationCallback(addresstmp);
-          /*Indicate user which sector has been erased */
-          HAL_FLASH_EndOfOperationCallback(addresstmp);
+          /*Increment sector number*/
+          addresstmp = pFlash.Address + FLASH_PAGE_SIZE;
-          /*Increment sector number*/
+          pFlash.Address = addresstmp;
-          addresstmp = pFlash.Address + FLASH_PAGE_SIZE;
-          pFlash.Address = addresstmp;
+          /* If the erase operation is completed, disable the PER Bit */
+          CLEAR_BIT(FLASH->CR, FLASH_CR_PER);
-          /* If the erase operation is completed, disable the PER Bit */
-          CLEAR_BIT(FLASH->CR, FLASH_CR_PER);
+          FLASH_PageErase(addresstmp);
+        }
-          FLASH_PageErase(addresstmp);
+        else
-        }
+        {
-        else
+          /* No more pages to Erase, user callback can be called. */
-        {
+          /* Reset Sector and stop Erase pages procedure */
-          /* No more pages to Erase, user callback can be called. */
+          pFlash.Address = addresstmp = 0xFFFFFFFFU;
-          /* Reset Sector and stop Erase pages procedure */
+          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
-          pFlash.Address = addresstmp = 0xFFFFFFFFU;
+          /* FLASH EOP interrupt user callback */
-          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
+          HAL_FLASH_EndOfOperationCallback(addresstmp);
-          /* FLASH EOP interrupt user callback */
+        }
-          HAL_FLASH_EndOfOperationCallback(addresstmp);
+      }
-        }
+      else if(pFlash.ProcedureOnGoing == FLASH_PROC_MASSERASE)
-      }
+      {
-      else if(pFlash.ProcedureOnGoing == FLASH_PROC_MASSERASE)
+        /* Operation is completed, disable the MER Bit */
-      {
+        CLEAR_BIT(FLASH->CR, FLASH_CR_MER);
-        /* Operation is completed, disable the MER Bit */
-        CLEAR_BIT(FLASH->CR, FLASH_CR_MER);
+#if defined(FLASH_BANK2_END)
+        /* Stop Mass Erase procedure if no pending mass erase on other bank */
-#if defined(FLASH_BANK2_END)
+        if (HAL_IS_BIT_CLR(FLASH->CR2, FLASH_CR2_MER))
-        /* Stop Mass Erase procedure if no pending mass erase on other bank */
+        {
-        if (HAL_IS_BIT_CLR(FLASH->CR2, FLASH_CR2_MER))
+#endif /* FLASH_BANK2_END */
-        {
+          /* MassErase ended. Return the selected bank */
-#endif /* FLASH_BANK2_END */
+          /* FLASH EOP interrupt user callback */
-          /* MassErase ended. Return the selected bank */
+          HAL_FLASH_EndOfOperationCallback(0U);
-          /* FLASH EOP interrupt user callback */
-          HAL_FLASH_EndOfOperationCallback(0U);
+          /* Stop Mass Erase procedure*/
+          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
-          /* Stop Mass Erase procedure*/
+        }
-          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
+#if defined(FLASH_BANK2_END)
-        }
+      }
-#if defined(FLASH_BANK2_END)
+#endif /* FLASH_BANK2_END */
-      }
+      else
-#endif /* FLASH_BANK2_END */
+      {
-      else
+        /* Nb of 16-bit data to program can be decreased */
-      {
+        pFlash.DataRemaining--;
-        /* Nb of 16-bit data to program can be decreased */
-        pFlash.DataRemaining--;
+        /* Check if there are still 16-bit data to program */
+        if(pFlash.DataRemaining != 0U)
-        /* Check if there are still 16-bit data to program */
+        {
-        if(pFlash.DataRemaining != 0U)
+          /* Increment address to 16-bit */
-        {
+          pFlash.Address += 2U;
-          /* Increment address to 16-bit */
+          addresstmp = pFlash.Address;
-          pFlash.Address += 2U;
-          addresstmp = pFlash.Address;
+          /* Shift to have next 16-bit data */
+          pFlash.Data = (pFlash.Data >> 16U);
-          /* Shift to have next 16-bit data */
-          pFlash.Data = (pFlash.Data >> 16U);
+          /* Operation is completed, disable the PG Bit */
+          CLEAR_BIT(FLASH->CR, FLASH_CR_PG);
-          /* Operation is completed, disable the PG Bit */
-          CLEAR_BIT(FLASH->CR, FLASH_CR_PG);
+          /*Program halfword (16-bit) at a specified address.*/
+          FLASH_Program_HalfWord(addresstmp, (uint16_t)pFlash.Data);
-          /*Program halfword (16-bit) at a specified address.*/
+        }
-          FLASH_Program_HalfWord(addresstmp, (uint16_t)pFlash.Data);
+        else
-        }
+        {
-        else
+          /* Program ended. Return the selected address */
-        {
+          /* FLASH EOP interrupt user callback */
-          /* Program ended. Return the selected address */
+          if (pFlash.ProcedureOnGoing == FLASH_PROC_PROGRAMHALFWORD)
-          /* FLASH EOP interrupt user callback */
+          {
-          if (pFlash.ProcedureOnGoing == FLASH_PROC_PROGRAMHALFWORD)
+            HAL_FLASH_EndOfOperationCallback(pFlash.Address);
-          {
+          }
-            HAL_FLASH_EndOfOperationCallback(pFlash.Address);
+          else if (pFlash.ProcedureOnGoing == FLASH_PROC_PROGRAMWORD)
-          }
+          {
-          else if (pFlash.ProcedureOnGoing == FLASH_PROC_PROGRAMWORD)
+            HAL_FLASH_EndOfOperationCallback(pFlash.Address - 2U);
-          {
+          }
-            HAL_FLASH_EndOfOperationCallback(pFlash.Address - 2U);
+          else
-          }
+          {
-          else
+            HAL_FLASH_EndOfOperationCallback(pFlash.Address - 6U);
-          {
+          }
-            HAL_FLASH_EndOfOperationCallback(pFlash.Address - 6U);
-          }
+          /* Reset Address and stop Program procedure */
+          pFlash.Address = 0xFFFFFFFFU;
-          /* Reset Address and stop Program procedure */
+          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
-          pFlash.Address = 0xFFFFFFFFU;
+        }
-          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
+      }
-        }
+    }
-      }
+  }
-    }
-  }
+#if defined(FLASH_BANK2_END)
+  /* Check FLASH End of Operation flag  */
-#if defined(FLASH_BANK2_END)
+  if(__HAL_FLASH_GET_FLAG( FLASH_FLAG_EOP_BANK2))
-  /* Check FLASH End of Operation flag  */
+  {
-  if(__HAL_FLASH_GET_FLAG( FLASH_FLAG_EOP_BANK2))
+    /* Clear FLASH End of Operation pending bit */
-  {
+    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP_BANK2);
-    /* Clear FLASH End of Operation pending bit */
-    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP_BANK2);
+    /* Process can continue only if no error detected */
+    if(pFlash.ProcedureOnGoing != FLASH_PROC_NONE)
-    /* Process can continue only if no error detected */
+    {
-    if(pFlash.ProcedureOnGoing != FLASH_PROC_NONE)
+      if(pFlash.ProcedureOnGoing == FLASH_PROC_PAGEERASE)
-    {
+      {
-      if(pFlash.ProcedureOnGoing == FLASH_PROC_PAGEERASE)
+        /* Nb of pages to erased can be decreased */
-      {
+        pFlash.DataRemaining--;
-        /* Nb of pages to erased can be decreased */
-        pFlash.DataRemaining--;
+        /* Check if there are still pages to erase*/
+        if(pFlash.DataRemaining != 0U)
-        /* Check if there are still pages to erase*/
+        {
-        if(pFlash.DataRemaining != 0U)
+          /* Indicate user which page address has been erased*/
-        {
+          HAL_FLASH_EndOfOperationCallback(pFlash.Address);
-          /* Indicate user which page address has been erased*/
-          HAL_FLASH_EndOfOperationCallback(pFlash.Address);
+          /* Increment page address to next page */
+          pFlash.Address += FLASH_PAGE_SIZE;
-          /* Increment page address to next page */
+          addresstmp = pFlash.Address;
-          pFlash.Address += FLASH_PAGE_SIZE;
-          addresstmp = pFlash.Address;
+          /* Operation is completed, disable the PER Bit */
+          CLEAR_BIT(FLASH->CR2, FLASH_CR2_PER);
-          /* Operation is completed, disable the PER Bit */
-          CLEAR_BIT(FLASH->CR2, FLASH_CR2_PER);
+          FLASH_PageErase(addresstmp);
+        }
-          FLASH_PageErase(addresstmp);
+        else
-        }
+        {
-        else
+          /*No more pages to Erase*/
-        {
-          /*No more pages to Erase*/
+          /*Reset Address and stop Erase pages procedure*/
+          pFlash.Address = 0xFFFFFFFFU;
-          /*Reset Address and stop Erase pages procedure*/
+          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
-          pFlash.Address = 0xFFFFFFFFU;
-          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
+          /* FLASH EOP interrupt user callback */
+          HAL_FLASH_EndOfOperationCallback(pFlash.Address);
-          /* FLASH EOP interrupt user callback */
+        }
-          HAL_FLASH_EndOfOperationCallback(pFlash.Address);
+      }
-        }
+      else if(pFlash.ProcedureOnGoing == FLASH_PROC_MASSERASE)
-      }
+      {
-      else if(pFlash.ProcedureOnGoing == FLASH_PROC_MASSERASE)
+        /* Operation is completed, disable the MER Bit */
-      {
+        CLEAR_BIT(FLASH->CR2, FLASH_CR2_MER);
-        /* Operation is completed, disable the MER Bit */
-        CLEAR_BIT(FLASH->CR2, FLASH_CR2_MER);
+        if (HAL_IS_BIT_CLR(FLASH->CR, FLASH_CR_MER))
+        {
-        if (HAL_IS_BIT_CLR(FLASH->CR, FLASH_CR_MER))
+          /* MassErase ended. Return the selected bank*/
-        {
+          /* FLASH EOP interrupt user callback */
-          /* MassErase ended. Return the selected bank*/
+          HAL_FLASH_EndOfOperationCallback(0U);
-          /* FLASH EOP interrupt user callback */
-          HAL_FLASH_EndOfOperationCallback(0U);
+          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
+        }
-          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
+      }
-        }
+      else
-      }
+      {
-      else
+        /* Nb of 16-bit data to program can be decreased */
-      {
+        pFlash.DataRemaining--;
-        /* Nb of 16-bit data to program can be decreased */
-        pFlash.DataRemaining--;
+        /* Check if there are still 16-bit data to program */
+        if(pFlash.DataRemaining != 0U)
-        /* Check if there are still 16-bit data to program */
+        {
-        if(pFlash.DataRemaining != 0U)
+          /* Increment address to 16-bit */
-        {
+          pFlash.Address += 2U;
-          /* Increment address to 16-bit */
+          addresstmp = pFlash.Address;
-          pFlash.Address += 2U;
-          addresstmp = pFlash.Address;
+          /* Shift to have next 16-bit data */
+          pFlash.Data = (pFlash.Data >> 16U);
-          /* Shift to have next 16-bit data */
-          pFlash.Data = (pFlash.Data >> 16U);
+          /* Operation is completed, disable the PG Bit */
+          CLEAR_BIT(FLASH->CR2, FLASH_CR2_PG);
-          /* Operation is completed, disable the PG Bit */
-          CLEAR_BIT(FLASH->CR2, FLASH_CR2_PG);
+          /*Program halfword (16-bit) at a specified address.*/
+          FLASH_Program_HalfWord(addresstmp, (uint16_t)pFlash.Data);
-          /*Program halfword (16-bit) at a specified address.*/
+        }
-          FLASH_Program_HalfWord(addresstmp, (uint16_t)pFlash.Data);
+        else
-        }
+        {
-        else
+          /*Program ended. Return the selected address*/
-        {
+          /* FLASH EOP interrupt user callback */
-          /*Program ended. Return the selected address*/
+          if (pFlash.ProcedureOnGoing == FLASH_PROC_PROGRAMHALFWORD)
-          /* FLASH EOP interrupt user callback */
+          {
-          if (pFlash.ProcedureOnGoing == FLASH_PROC_PROGRAMHALFWORD)
+            HAL_FLASH_EndOfOperationCallback(pFlash.Address);
-          {
+          }
-            HAL_FLASH_EndOfOperationCallback(pFlash.Address);
+          else if (pFlash.ProcedureOnGoing == FLASH_PROC_PROGRAMWORD)
-          }
+          {
-          else if (pFlash.ProcedureOnGoing == FLASH_PROC_PROGRAMWORD)
+            HAL_FLASH_EndOfOperationCallback(pFlash.Address-2U);
-          {
+          }
-            HAL_FLASH_EndOfOperationCallback(pFlash.Address-2U);
+          else
-          }
+          {
-          else
+            HAL_FLASH_EndOfOperationCallback(pFlash.Address-6U);
-          {
+          }
-            HAL_FLASH_EndOfOperationCallback(pFlash.Address-6U);
-          }
+          /* Reset Address and stop Program procedure*/
+          pFlash.Address = 0xFFFFFFFFU;
-          /* Reset Address and stop Program procedure*/
+          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
-          pFlash.Address = 0xFFFFFFFFU;
+        }
-          pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
+      }
-        }
+    }
-      }
+  }
-    }
+#endif
-  }
-#endif
+  if(pFlash.ProcedureOnGoing == FLASH_PROC_NONE)
+  {
-  if(pFlash.ProcedureOnGoing == FLASH_PROC_NONE)
+#if defined(FLASH_BANK2_END)
-  {
+    /* Operation is completed, disable the PG, PER and MER Bits for both bank */
-#if defined(FLASH_BANK2_END)
+    CLEAR_BIT(FLASH->CR, (FLASH_CR_PG | FLASH_CR_PER | FLASH_CR_MER));
-    /* Operation is completed, disable the PG, PER and MER Bits for both bank */
+    CLEAR_BIT(FLASH->CR2, (FLASH_CR2_PG | FLASH_CR2_PER | FLASH_CR2_MER));
-    CLEAR_BIT(FLASH->CR, (FLASH_CR_PG | FLASH_CR_PER | FLASH_CR_MER));
-    CLEAR_BIT(FLASH->CR2, (FLASH_CR2_PG | FLASH_CR2_PER | FLASH_CR2_MER));
+    /* Disable End of FLASH Operation and Error source interrupts for both banks */
+    __HAL_FLASH_DISABLE_IT(FLASH_IT_EOP_BANK1 | FLASH_IT_ERR_BANK1 | FLASH_IT_EOP_BANK2 | FLASH_IT_ERR_BANK2);
-    /* Disable End of FLASH Operation and Error source interrupts for both banks */
+#else
-    __HAL_FLASH_DISABLE_IT(FLASH_IT_EOP_BANK1 | FLASH_IT_ERR_BANK1 | FLASH_IT_EOP_BANK2 | FLASH_IT_ERR_BANK2);
+    /* Operation is completed, disable the PG, PER and MER Bits */
-#else
+    CLEAR_BIT(FLASH->CR, (FLASH_CR_PG | FLASH_CR_PER | FLASH_CR_MER));
-    /* Operation is completed, disable the PG, PER and MER Bits */
-    CLEAR_BIT(FLASH->CR, (FLASH_CR_PG | FLASH_CR_PER | FLASH_CR_MER));
+    /* Disable End of FLASH Operation and Error source interrupts */
+    __HAL_FLASH_DISABLE_IT(FLASH_IT_EOP | FLASH_IT_ERR);
-    /* Disable End of FLASH Operation and Error source interrupts */
+#endif /* FLASH_BANK2_END */
-    __HAL_FLASH_DISABLE_IT(FLASH_IT_EOP | FLASH_IT_ERR);
-#endif /* FLASH_BANK2_END */
+    /* Process Unlocked */
+    __HAL_UNLOCK(&pFlash);
-    /* Process Unlocked */
+  }
-    __HAL_UNLOCK(&pFlash);
+}
-  }
-}
+/**
+  * @brief  FLASH end of operation interrupt callback
-/**
+  * @param  ReturnValue: The value saved in this parameter depends on the ongoing procedure
-  * @brief  FLASH end of operation interrupt callback
+  *                 - Mass Erase: No return value expected
-  * @param  ReturnValue: The value saved in this parameter depends on the ongoing procedure
+  *                 - Pages Erase: Address of the page which has been erased
-  *                 - Mass Erase: No return value expected
+  *                    (if 0xFFFFFFFF, it means that all the selected pages have been erased)
-  *                 - Pages Erase: Address of the page which has been erased
+  *                 - Program: Address which was selected for data program
-  *                    (if 0xFFFFFFFF, it means that all the selected pages have been erased)
+  * @retval none
-  *                 - Program: Address which was selected for data program
+  */
-  * @retval none
+__weak void HAL_FLASH_EndOfOperationCallback(uint32_t ReturnValue)
-  */
+{
-__weak void HAL_FLASH_EndOfOperationCallback(uint32_t ReturnValue)
+  /* Prevent unused argument(s) compilation warning */
-{
+  UNUSED(ReturnValue);
-  /* Prevent unused argument(s) compilation warning */
-  UNUSED(ReturnValue);
+  /* NOTE : This function Should not be modified, when the callback is needed,
+            the HAL_FLASH_EndOfOperationCallback could be implemented in the user file
-  /* NOTE : This function Should not be modified, when the callback is needed,
+   */
-            the HAL_FLASH_EndOfOperationCallback could be implemented in the user file
+}
-   */
-}
+/**
+  * @brief  FLASH operation error interrupt callback
-/**
+  * @param  ReturnValue: The value saved in this parameter depends on the ongoing procedure
-  * @brief  FLASH operation error interrupt callback
+  *                 - Mass Erase: No return value expected
-  * @param  ReturnValue: The value saved in this parameter depends on the ongoing procedure
+  *                 - Pages Erase: Address of the page which returned an error
-  *                 - Mass Erase: No return value expected
+  *                 - Program: Address which was selected for data program
-  *                 - Pages Erase: Address of the page which returned an error
+  * @retval none
-  *                 - Program: Address which was selected for data program
+  */
-  * @retval none
+__weak void HAL_FLASH_OperationErrorCallback(uint32_t ReturnValue)
-  */
+{
-__weak void HAL_FLASH_OperationErrorCallback(uint32_t ReturnValue)
+  /* Prevent unused argument(s) compilation warning */
-{
+  UNUSED(ReturnValue);
-  /* Prevent unused argument(s) compilation warning */
-  UNUSED(ReturnValue);
+  /* NOTE : This function Should not be modified, when the callback is needed,
+            the HAL_FLASH_OperationErrorCallback could be implemented in the user file
-  /* NOTE : This function Should not be modified, when the callback is needed,
+   */
-            the HAL_FLASH_OperationErrorCallback could be implemented in the user file
+}
-   */
-}
+/**
+  * @}
-/**
+  */
-  * @}
-  */
+/** @defgroup FLASH_Exported_Functions_Group2 Peripheral Control functions
+ *  @brief   management functions
-/** @defgroup FLASH_Exported_Functions_Group2 Peripheral Control functions
+ *
- *  @brief   management functions
+@verbatim
- *
+ ===============================================================================
-@verbatim
+                      ##### Peripheral Control functions #####
  ===============================================================================
-                      ##### Peripheral Control functions #####
+    [..]
- ===============================================================================
+    This subsection provides a set of functions allowing to control the FLASH
-    [..]
+    memory operations.
-    This subsection provides a set of functions allowing to control the FLASH
-    memory operations.
+@endverbatim
+  * @{
-@endverbatim
+  */
-  * @{
-  */
+/**
+  * @brief  Unlock the FLASH control register access
-/**
+  * @retval HAL Status
-  * @brief  Unlock the FLASH control register access
+  */
-  * @retval HAL Status
+HAL_StatusTypeDef HAL_FLASH_Unlock(void)
-  */
+{
-HAL_StatusTypeDef HAL_FLASH_Unlock(void)
+  HAL_StatusTypeDef status = HAL_OK;
-{
-  HAL_StatusTypeDef status = HAL_OK;
+  if(READ_BIT(FLASH->CR, FLASH_CR_LOCK) != RESET)
+  {
-  if(READ_BIT(FLASH->CR, FLASH_CR_LOCK) != RESET)
+    /* Authorize the FLASH Registers access */
-  {
+    WRITE_REG(FLASH->KEYR, FLASH_KEY1);
-    /* Authorize the FLASH Registers access */
+    WRITE_REG(FLASH->KEYR, FLASH_KEY2);
-    WRITE_REG(FLASH->KEYR, FLASH_KEY1);
-    WRITE_REG(FLASH->KEYR, FLASH_KEY2);
+    /* Verify Flash is unlocked */
+    if(READ_BIT(FLASH->CR, FLASH_CR_LOCK) != RESET)
-    /* Verify Flash is unlocked */
+    {
-    if(READ_BIT(FLASH->CR, FLASH_CR_LOCK) != RESET)
+      status = HAL_ERROR;
-    {
+    }
-      status = HAL_ERROR;
+  }
-    }
+#if defined(FLASH_BANK2_END)
-  }
+  if(READ_BIT(FLASH->CR2, FLASH_CR2_LOCK) != RESET)
-#if defined(FLASH_BANK2_END)
+  {
-  if(READ_BIT(FLASH->CR2, FLASH_CR2_LOCK) != RESET)
+    /* Authorize the FLASH BANK2 Registers access */
-  {
+    WRITE_REG(FLASH->KEYR2, FLASH_KEY1);
-    /* Authorize the FLASH BANK2 Registers access */
+    WRITE_REG(FLASH->KEYR2, FLASH_KEY2);
-    WRITE_REG(FLASH->KEYR2, FLASH_KEY1);
-    WRITE_REG(FLASH->KEYR2, FLASH_KEY2);
+    /* Verify Flash BANK2 is unlocked */
+    if(READ_BIT(FLASH->CR2, FLASH_CR2_LOCK) != RESET)
-    /* Verify Flash BANK2 is unlocked */
+    {
-    if(READ_BIT(FLASH->CR2, FLASH_CR2_LOCK) != RESET)
+      status = HAL_ERROR;
-    {
+    }
-      status = HAL_ERROR;
+  }
-    }
+#endif /* FLASH_BANK2_END */
-  }
-#endif /* FLASH_BANK2_END */
+  return status;
+}
-  return status;
-}
+/**
+  * @brief  Locks the FLASH control register access
-/**
+  * @retval HAL Status
-  * @brief  Locks the FLASH control register access
+  */
-  * @retval HAL Status
+HAL_StatusTypeDef HAL_FLASH_Lock(void)
-  */
+{
-HAL_StatusTypeDef HAL_FLASH_Lock(void)
+  /* Set the LOCK Bit to lock the FLASH Registers access */
-{
+  SET_BIT(FLASH->CR, FLASH_CR_LOCK);
-  /* Set the LOCK Bit to lock the FLASH Registers access */
-  SET_BIT(FLASH->CR, FLASH_CR_LOCK);
+#if defined(FLASH_BANK2_END)
+  /* Set the LOCK Bit to lock the FLASH BANK2 Registers access */
-#if defined(FLASH_BANK2_END)
+  SET_BIT(FLASH->CR2, FLASH_CR2_LOCK);
-  /* Set the LOCK Bit to lock the FLASH BANK2 Registers access */
-  SET_BIT(FLASH->CR2, FLASH_CR2_LOCK);
+#endif /* FLASH_BANK2_END */
+  return HAL_OK;
-#endif /* FLASH_BANK2_END */
+}
-  return HAL_OK;
-}
+/**
+  * @brief  Unlock the FLASH Option Control Registers access.
-/**
+  * @retval HAL Status
-  * @brief  Unlock the FLASH Option Control Registers access.
+  */
-  * @retval HAL Status
+HAL_StatusTypeDef HAL_FLASH_OB_Unlock(void)
-  */
+{
-HAL_StatusTypeDef HAL_FLASH_OB_Unlock(void)
+  if (HAL_IS_BIT_CLR(FLASH->CR, FLASH_CR_OPTWRE))
-{
+  {
-  if (HAL_IS_BIT_CLR(FLASH->CR, FLASH_CR_OPTWRE))
+    /* Authorizes the Option Byte register programming */
-  {
+    WRITE_REG(FLASH->OPTKEYR, FLASH_OPTKEY1);
-    /* Authorizes the Option Byte register programming */
+    WRITE_REG(FLASH->OPTKEYR, FLASH_OPTKEY2);
-    WRITE_REG(FLASH->OPTKEYR, FLASH_OPTKEY1);
+  }
-    WRITE_REG(FLASH->OPTKEYR, FLASH_OPTKEY2);
+  else
-  }
+  {
-  else
+    return HAL_ERROR;
-  {
+  }
-    return HAL_ERROR;
-  }
+  return HAL_OK;
+}
-  return HAL_OK;
-}
+/**
+  * @brief  Lock the FLASH Option Control Registers access.
-/**
+  * @retval HAL Status
-  * @brief  Lock the FLASH Option Control Registers access.
+  */
-  * @retval HAL Status
+HAL_StatusTypeDef HAL_FLASH_OB_Lock(void)
-  */
+{
-HAL_StatusTypeDef HAL_FLASH_OB_Lock(void)
+  /* Clear the OPTWRE Bit to lock the FLASH Option Byte Registers access */
-{
+  CLEAR_BIT(FLASH->CR, FLASH_CR_OPTWRE);
-  /* Clear the OPTWRE Bit to lock the FLASH Option Byte Registers access */
-  CLEAR_BIT(FLASH->CR, FLASH_CR_OPTWRE);
+  return HAL_OK;
+}
-  return HAL_OK;
-}
+/**
+  * @brief  Launch the option byte loading.
-/**
+  * @note   This function will reset automatically the MCU.
-  * @brief  Launch the option byte loading.
+  * @retval None
-  * @note   This function will reset automatically the MCU.
+  */
-  * @retval None
+void HAL_FLASH_OB_Launch(void)
-  */
+{
-void HAL_FLASH_OB_Launch(void)
+  /* Initiates a system reset request to launch the option byte loading */
-{
+  HAL_NVIC_SystemReset();
-  /* Initiates a system reset request to launch the option byte loading */
+}
-  HAL_NVIC_SystemReset();
-}
+/**
+  * @}
-/**
+  */
-  * @}
-  */
+/** @defgroup FLASH_Exported_Functions_Group3 Peripheral errors functions
+ *  @brief    Peripheral errors functions
-/** @defgroup FLASH_Exported_Functions_Group3 Peripheral errors functions
+ *
- *  @brief    Peripheral errors functions
+@verbatim
- *
+ ===============================================================================
-@verbatim
+                      ##### Peripheral Errors functions #####
  ===============================================================================
-                      ##### Peripheral Errors functions #####
+    [..]
- ===============================================================================
+    This subsection permit to get in run-time errors of  the FLASH peripheral.
-    [..]
-    This subsection permit to get in run-time errors of  the FLASH peripheral.
+@endverbatim
+  * @{
-@endverbatim
+  */
-  * @{
-  */
+/**
+  * @brief  Get the specific FLASH error flag.
-/**
+  * @retval FLASH_ErrorCode The returned value can be:
-  * @brief  Get the specific FLASH error flag.
+  *            @ref FLASH_Error_Codes
-  * @retval FLASH_ErrorCode The returned value can be:
+  */
-  *            @ref FLASH_Error_Codes
+uint32_t HAL_FLASH_GetError(void)
-  */
+{
-uint32_t HAL_FLASH_GetError(void)
+   return pFlash.ErrorCode;
-{
+}
-   return pFlash.ErrorCode;
-}
+/**
+  * @}
-/**
+  */
-  * @}
-  */
+/**
+  * @}
-/**
+  */
-  * @}
-  */
+/** @addtogroup FLASH_Private_Functions
+ * @{
-/** @addtogroup FLASH_Private_Functions
+ */
- * @{
- */
+/**
+  * @brief  Program a half-word (16-bit) at a specified address.
-/**
+  * @param  Address specify the address to be programmed.
-  * @brief  Program a half-word (16-bit) at a specified address.
+  * @param  Data    specify the data to be programmed.
-  * @param  Address specify the address to be programmed.
+  * @retval None
-  * @param  Data    specify the data to be programmed.
+  */
-  * @retval None
+static void FLASH_Program_HalfWord(uint32_t Address, uint16_t Data)
-  */
+{
-static void FLASH_Program_HalfWord(uint32_t Address, uint16_t Data)
+  /* Clean the error context */
-{
+  pFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
-  /* Clean the error context */
-  pFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
+#if defined(FLASH_BANK2_END)
+  if(Address <= FLASH_BANK1_END)
-#if defined(FLASH_BANK2_END)
+  {
-  if(Address <= FLASH_BANK1_END)
+#endif /* FLASH_BANK2_END */
-  {
+    /* Proceed to program the new data */
-#endif /* FLASH_BANK2_END */
+    SET_BIT(FLASH->CR, FLASH_CR_PG);
-    /* Proceed to program the new data */
+#if defined(FLASH_BANK2_END)
-    SET_BIT(FLASH->CR, FLASH_CR_PG);
+  }
-#if defined(FLASH_BANK2_END)
+  else
-  }
+  {
-  else
+    /* Proceed to program the new data */
-  {
+    SET_BIT(FLASH->CR2, FLASH_CR2_PG);
-    /* Proceed to program the new data */
+  }
-    SET_BIT(FLASH->CR2, FLASH_CR2_PG);
+#endif /* FLASH_BANK2_END */
-  }
-#endif /* FLASH_BANK2_END */
+  /* Write data in the address */
+  *(__IO uint16_t*)Address = Data;
-  /* Write data in the address */
+}
-  *(__IO uint16_t*)Address = Data;
-}
+/**
+  * @brief  Wait for a FLASH operation to complete.
-/**
+  * @param  Timeout  maximum flash operation timeout
-  * @brief  Wait for a FLASH operation to complete.
+  * @retval HAL Status
-  * @param  Timeout  maximum flash operation timeout
+  */
-  * @retval HAL Status
+HAL_StatusTypeDef FLASH_WaitForLastOperation(uint32_t Timeout)
-  */
+{
-HAL_StatusTypeDef FLASH_WaitForLastOperation(uint32_t Timeout)
+  /* Wait for the FLASH operation to complete by polling on BUSY flag to be reset.
-{
+     Even if the FLASH operation fails, the BUSY flag will be reset and an error
-  /* Wait for the FLASH operation to complete by polling on BUSY flag to be reset.
+     flag will be set */
-     Even if the FLASH operation fails, the BUSY flag will be reset and an error
-     flag will be set */
+  uint32_t tickstart = HAL_GetTick();
-  uint32_t tickstart = HAL_GetTick();
+  while(__HAL_FLASH_GET_FLAG(FLASH_FLAG_BSY))
+  {
-  while(__HAL_FLASH_GET_FLAG(FLASH_FLAG_BSY))
+    if (Timeout != HAL_MAX_DELAY)
-  {
+    {
-    if (Timeout != HAL_MAX_DELAY)
+      if((Timeout == 0U) || ((HAL_GetTick()-tickstart) > Timeout))
-    {
+      {
-      if((Timeout == 0U) || ((HAL_GetTick()-tickstart) > Timeout))
+        return HAL_TIMEOUT;
-      {
+      }
-        return HAL_TIMEOUT;
+    }
-      }
+  }
-    }
-  }
+  /* Check FLASH End of Operation flag  */
+  if (__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP))
-  /* Check FLASH End of Operation flag  */
+  {
-  if (__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP))
+    /* Clear FLASH End of Operation pending bit */
-  {
+    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
-    /* Clear FLASH End of Operation pending bit */
+  }
-    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
-  }
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR)  ||
+     __HAL_FLASH_GET_FLAG(FLASH_FLAG_OPTVERR) ||
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR)  ||
+     __HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR))
-     __HAL_FLASH_GET_FLAG(FLASH_FLAG_OPTVERR) ||
+  {
-     __HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR))
+    /*Save the error code*/
-  {
+    FLASH_SetErrorCode();
-    /*Save the error code*/
+    return HAL_ERROR;
-    FLASH_SetErrorCode();
+  }
-    return HAL_ERROR;
-  }
+  /* There is no error flag set */
+  return HAL_OK;
-  /* There is no error flag set */
+}
-  return HAL_OK;
-}
+#if defined(FLASH_BANK2_END)
+/**
-#if defined(FLASH_BANK2_END)
+  * @brief  Wait for a FLASH BANK2 operation to complete.
-/**
+  * @param  Timeout maximum flash operation timeout
-  * @brief  Wait for a FLASH BANK2 operation to complete.
+  * @retval HAL_StatusTypeDef HAL Status
-  * @param  Timeout maximum flash operation timeout
+  */
-  * @retval HAL_StatusTypeDef HAL Status
+HAL_StatusTypeDef FLASH_WaitForLastOperationBank2(uint32_t Timeout)
-  */
+{
-HAL_StatusTypeDef FLASH_WaitForLastOperationBank2(uint32_t Timeout)
+  /* Wait for the FLASH BANK2 operation to complete by polling on BUSY flag to be reset.
-{
+     Even if the FLASH BANK2 operation fails, the BUSY flag will be reset and an error
-  /* Wait for the FLASH BANK2 operation to complete by polling on BUSY flag to be reset.
+     flag will be set */
-     Even if the FLASH BANK2 operation fails, the BUSY flag will be reset and an error
-     flag will be set */
+  uint32_t tickstart = HAL_GetTick();
-  uint32_t tickstart = HAL_GetTick();
+  while(__HAL_FLASH_GET_FLAG(FLASH_FLAG_BSY_BANK2))
+  {
-  while(__HAL_FLASH_GET_FLAG(FLASH_FLAG_BSY_BANK2))
+    if (Timeout != HAL_MAX_DELAY)
-  {
+    {
-    if (Timeout != HAL_MAX_DELAY)
+      if((Timeout == 0U) || ((HAL_GetTick()-tickstart) > Timeout))
-    {
+      {
-      if((Timeout == 0U) || ((HAL_GetTick()-tickstart) > Timeout))
+        return HAL_TIMEOUT;
-      {
+      }
-        return HAL_TIMEOUT;
+    }
-      }
+  }
-    }
-  }
+  /* Check FLASH End of Operation flag  */
+  if (__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP_BANK2))
-  /* Check FLASH End of Operation flag  */
+  {
-  if (__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP_BANK2))
+    /* Clear FLASH End of Operation pending bit */
-  {
+    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP_BANK2);
-    /* Clear FLASH End of Operation pending bit */
+  }
-    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP_BANK2);
-  }
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR_BANK2) || __HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR_BANK2))
+  {
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR_BANK2) || __HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR_BANK2))
+    /*Save the error code*/
-  {
+    FLASH_SetErrorCode();
-    /*Save the error code*/
+    return HAL_ERROR;
-    FLASH_SetErrorCode();
+  }
-    return HAL_ERROR;
-  }
+  /* If there is an error flag set */
+  return HAL_OK;
-  /* If there is an error flag set */
-  return HAL_OK;
+}
+#endif /* FLASH_BANK2_END */
-}
-#endif /* FLASH_BANK2_END */
+/**
+  * @brief  Set the specific FLASH error flag.
-/**
+  * @retval None
-  * @brief  Set the specific FLASH error flag.
+  */
-  * @retval None
+static void FLASH_SetErrorCode(void)
-  */
+{
-static void FLASH_SetErrorCode(void)
+  uint32_t flags = 0U;
-{
-  uint32_t flags = 0U;
+#if defined(FLASH_BANK2_END)
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR) || __HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR_BANK2))
-#if defined(FLASH_BANK2_END)
+#else
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR) || __HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR_BANK2))
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR))
-#else
+#endif /* FLASH_BANK2_END */
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR))
+  {
-#endif /* FLASH_BANK2_END */
+    pFlash.ErrorCode |= HAL_FLASH_ERROR_WRP;
-  {
+#if defined(FLASH_BANK2_END)
-    pFlash.ErrorCode |= HAL_FLASH_ERROR_WRP;
+    flags |= FLASH_FLAG_WRPERR | FLASH_FLAG_WRPERR_BANK2;
-#if defined(FLASH_BANK2_END)
+#else
-    flags |= FLASH_FLAG_WRPERR | FLASH_FLAG_WRPERR_BANK2;
+    flags |= FLASH_FLAG_WRPERR;
-#else
+#endif /* FLASH_BANK2_END */
-    flags |= FLASH_FLAG_WRPERR;
+  }
-#endif /* FLASH_BANK2_END */
+#if defined(FLASH_BANK2_END)
-  }
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR) || __HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR_BANK2))
-#if defined(FLASH_BANK2_END)
+#else
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR) || __HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR_BANK2))
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR))
-#else
+#endif /* FLASH_BANK2_END */
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGERR))
+  {
-#endif /* FLASH_BANK2_END */
+    pFlash.ErrorCode |= HAL_FLASH_ERROR_PROG;
-  {
+#if defined(FLASH_BANK2_END)
-    pFlash.ErrorCode |= HAL_FLASH_ERROR_PROG;
+    flags |= FLASH_FLAG_PGERR | FLASH_FLAG_PGERR_BANK2;
-#if defined(FLASH_BANK2_END)
+#else
-    flags |= FLASH_FLAG_PGERR | FLASH_FLAG_PGERR_BANK2;
+    flags |= FLASH_FLAG_PGERR;
-#else
+#endif /* FLASH_BANK2_END */
-    flags |= FLASH_FLAG_PGERR;
+  }
-#endif /* FLASH_BANK2_END */
+  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_OPTVERR))
-  }
+  {
-  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_OPTVERR))
+    pFlash.ErrorCode |= HAL_FLASH_ERROR_OPTV;
-  {
+  __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_OPTVERR);
-    pFlash.ErrorCode |= HAL_FLASH_ERROR_OPTV;
+  }
-  __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_OPTVERR);
-  }
+  /* Clear FLASH error pending bits */
+  __HAL_FLASH_CLEAR_FLAG(flags);
-  /* Clear FLASH error pending bits */
+}
-  __HAL_FLASH_CLEAR_FLAG(flags);
+/**
-}
+  * @}
-/**
+  */
-  * @}
-  */
+/**
+  * @}
-/**
+  */
-  * @}
-  */
+#endif /* HAL_FLASH_MODULE_ENABLED */
-#endif /* HAL_FLASH_MODULE_ENABLED */
+/**
+  * @}
-/**
+  */
-  * @}
-  */
-/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/

Subversion Repositories EDIS_Ignition

(root)/trunk/Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_flash.c – Rev 2 → 18