ostc4: Common/Drivers/STM32F4xx_HAL_Driver/Src/stm32f4xx_hal

annotate Common/Drivers/STM32F4xx_HAL_Driver/Src/stm32f4xx_hal_flash.c @ 774:6169309d6eb9

more menu items for the compass menu: Delete bearing, and reset to land based bearing. I have also re-enabled the real time bearing display in the menu - makes it easier to set the correct bearing. (mikeller)

author	heinrichsweikamp
date	Wed, 10 May 2023 16:25:39 +0200
parents	c78bcbd5deda
children

rev	line source
128 c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	1 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	2 ******************************************************************************
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	3 * @file stm32f4xx_hal_flash.c
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	4 * @author MCD Application Team
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	5 * @brief FLASH HAL module driver.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	6 * This file provides firmware functions to manage the following
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	7 * functionalities of the internal FLASH memory:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	8 * + Program operations functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	9 * + Memory Control functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	10 * + Peripheral Errors functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	11 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	12 @verbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	13 ==============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	14 ##### FLASH peripheral features #####
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	15 ==============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	16
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	17 [..] The Flash memory interface manages CPU AHB I-Code and D-Code accesses
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	18 to the Flash memory. It implements the erase and program Flash memory operations
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	19 and the read and write protection mechanisms.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	20
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	21 [..] The Flash memory interface accelerates code execution with a system of instruction
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	22 prefetch and cache lines.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	23
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	24 [..] The FLASH main features are:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	25 (+) Flash memory read operations
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	26 (+) Flash memory program/erase operations
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	27 (+) Read / write protections
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	28 (+) Prefetch on I-Code
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	29 (+) 64 cache lines of 128 bits on I-Code
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	30 (+) 8 cache lines of 128 bits on D-Code
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	31
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	32
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	33 ##### How to use this driver #####
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	34 ==============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	35 [..]
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	36 This driver provides functions and macros to configure and program the FLASH
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	37 memory of all STM32F4xx devices.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	38
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	39 (#) FLASH Memory IO Programming functions:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	40 (++) Lock and Unlock the FLASH interface using HAL_FLASH_Unlock() and
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	41 HAL_FLASH_Lock() functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	42 (++) Program functions: byte, half word, word and double word
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	43 (++) There Two modes of programming :
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	44 (+++) Polling mode using HAL_FLASH_Program() function
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	45 (+++) Interrupt mode using HAL_FLASH_Program_IT() function
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	46
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	47 (#) Interrupts and flags management functions :
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	48 (++) Handle FLASH interrupts by calling HAL_FLASH_IRQHandler()
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	49 (++) Wait for last FLASH operation according to its status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	50 (++) Get error flag status by calling HAL_SetErrorCode()
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	51
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	52 [..]
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	53 In addition to these functions, this driver includes a set of macros allowing
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	54 to handle the following operations:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	55 (+) Set the latency
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	56 (+) Enable/Disable the prefetch buffer
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	57 (+) Enable/Disable the Instruction cache and the Data cache
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	58 (+) Reset the Instruction cache and the Data cache
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	59 (+) Enable/Disable the FLASH interrupts
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	60 (+) Monitor the FLASH flags status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	61
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	62 @endverbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	63 ******************************************************************************
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	64 * @attention
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	65 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	66 * <h2><center>© COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	67 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	68 * Redistribution and use in source and binary forms, with or without modification,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	69 * are permitted provided that the following conditions are met:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	70 * 1. Redistributions of source code must retain the above copyright notice,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	71 * this list of conditions and the following disclaimer.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	72 * 2. Redistributions in binary form must reproduce the above copyright notice,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	73 * this list of conditions and the following disclaimer in the documentation
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	74 * and/or other materials provided with the distribution.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	75 * 3. Neither the name of STMicroelectronics nor the names of its contributors
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	76 * may be used to endorse or promote products derived from this software
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	77 * without specific prior written permission.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	78 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	79 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	80 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	81 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	82 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	83 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	84 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	85 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	86 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	87 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	88 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	89 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	90 ******************************************************************************
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	91 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	92
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	93 /* Includes ------------------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	94 #include "stm32f4xx_hal.h"
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	95
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	96 /** @addtogroup STM32F4xx_HAL_Driver
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	97 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	98 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	99
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	100 /** @defgroup FLASH FLASH
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	101 * @brief FLASH HAL module driver
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	102 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	103 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	104
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	105 #ifdef HAL_FLASH_MODULE_ENABLED
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	106
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	107 /* Private typedef -----------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	108 /* Private define ------------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	109 /** @addtogroup FLASH_Private_Constants
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	110 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	111 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	112 #define FLASH_TIMEOUT_VALUE 50000U /* 50 s */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	113 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	114 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	115 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	116 /* Private macro -------------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	117 /* Private variables ---------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	118 /** @addtogroup FLASH_Private_Variables
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	119 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	120 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	121 /* Variable used for Erase sectors under interruption */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	122 FLASH_ProcessTypeDef pFlash;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	123 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	124 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	125 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	126
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	127 /* Private function prototypes -----------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	128 /** @addtogroup FLASH_Private_Functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	129 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	130 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	131 /* Program operations */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	132 static void FLASH_Program_DoubleWord(uint32_t Address, uint64_t Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	133 static void FLASH_Program_Word(uint32_t Address, uint32_t Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	134 static void FLASH_Program_HalfWord(uint32_t Address, uint16_t Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	135 static void FLASH_Program_Byte(uint32_t Address, uint8_t Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	136 static void FLASH_SetErrorCode(void);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	137
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	138 HAL_StatusTypeDef FLASH_WaitForLastOperation(uint32_t Timeout);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	139 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	140 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	141 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	142
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	143 /* Exported functions --------------------------------------------------------*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	144 /** @defgroup FLASH_Exported_Functions FLASH Exported Functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	145 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	146 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	147
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	148 /** @defgroup FLASH_Exported_Functions_Group1 Programming operation functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	149 * @brief Programming operation functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	150 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	151 @verbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	152 ===============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	153 ##### Programming operation functions #####
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	154 ===============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	155 [..]
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	156 This subsection provides a set of functions allowing to manage the FLASH
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	157 program operations.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	158
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	159 @endverbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	160 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	161 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	162
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	163 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	164 * @brief Program byte, halfword, word or double word at a specified address
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	165 * @param TypeProgram Indicate the way to program at a specified address.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	166 * This parameter can be a value of @ref FLASH_Type_Program
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	167 * @param Address specifies the address to be programmed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	168 * @param Data specifies the data to be programmed
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	169 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	170 * @retval HAL_StatusTypeDef HAL Status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	171 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	172 HAL_StatusTypeDef HAL_FLASH_Program(uint32_t TypeProgram, uint32_t Address, uint64_t Data)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	173 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	174 HAL_StatusTypeDef status = HAL_ERROR;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	175
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	176 /* Process Locked */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	177 __HAL_LOCK(&pFlash);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	178
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	179 /* Check the parameters */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	180 assert_param(IS_FLASH_TYPEPROGRAM(TypeProgram));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	181
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	182 /* Wait for last operation to be completed */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	183 status = FLASH_WaitForLastOperation((uint32_t)FLASH_TIMEOUT_VALUE);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	184
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	185 if(status == HAL_OK)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	186 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	187 if(TypeProgram == FLASH_TYPEPROGRAM_BYTE)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	188 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	189 /Program byte (8-bit) at a specified address./
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	190 FLASH_Program_Byte(Address, (uint8_t) Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	191 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	192 else if(TypeProgram == FLASH_TYPEPROGRAM_HALFWORD)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	193 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	194 /Program halfword (16-bit) at a specified address./
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	195 FLASH_Program_HalfWord(Address, (uint16_t) Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	196 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	197 else if(TypeProgram == FLASH_TYPEPROGRAM_WORD)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	198 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	199 /Program word (32-bit) at a specified address./
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	200 FLASH_Program_Word(Address, (uint32_t) Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	201 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	202 else
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	203 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	204 /Program double word (64-bit) at a specified address./
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	205 FLASH_Program_DoubleWord(Address, Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	206 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	207
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	208 /* Wait for last operation to be completed */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	209 status = FLASH_WaitForLastOperation((uint32_t)FLASH_TIMEOUT_VALUE);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	210
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	211 /* If the program operation is completed, disable the PG Bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	212 FLASH->CR &= (~FLASH_CR_PG);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	213 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	214
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	215 /* Process Unlocked */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	216 __HAL_UNLOCK(&pFlash);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	217
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	218 return status;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	219 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	220
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	221 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	222 * @brief Program byte, halfword, word or double word at a specified address with interrupt enabled.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	223 * @param TypeProgram Indicate the way to program at a specified address.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	224 * This parameter can be a value of @ref FLASH_Type_Program
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	225 * @param Address specifies the address to be programmed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	226 * @param Data specifies the data to be programmed
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	227 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	228 * @retval HAL Status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	229 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	230 HAL_StatusTypeDef HAL_FLASH_Program_IT(uint32_t TypeProgram, uint32_t Address, uint64_t Data)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	231 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	232 HAL_StatusTypeDef status = HAL_OK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	233
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	234 /* Process Locked */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	235 __HAL_LOCK(&pFlash);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	236
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	237 /* Check the parameters */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	238 assert_param(IS_FLASH_TYPEPROGRAM(TypeProgram));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	239
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	240 /* Enable End of FLASH Operation interrupt */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	241 __HAL_FLASH_ENABLE_IT(FLASH_IT_EOP);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	242
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	243 /* Enable Error source interrupt */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	244 __HAL_FLASH_ENABLE_IT(FLASH_IT_ERR);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	245
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	246 pFlash.ProcedureOnGoing = FLASH_PROC_PROGRAM;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	247 pFlash.Address = Address;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	248
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	249 if(TypeProgram == FLASH_TYPEPROGRAM_BYTE)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	250 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	251 /Program byte (8-bit) at a specified address./
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	252 FLASH_Program_Byte(Address, (uint8_t) Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	253 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	254 else if(TypeProgram == FLASH_TYPEPROGRAM_HALFWORD)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	255 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	256 /Program halfword (16-bit) at a specified address./
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	257 FLASH_Program_HalfWord(Address, (uint16_t) Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	258 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	259 else if(TypeProgram == FLASH_TYPEPROGRAM_WORD)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	260 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	261 /Program word (32-bit) at a specified address./
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	262 FLASH_Program_Word(Address, (uint32_t) Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	263 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	264 else
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	265 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	266 /Program double word (64-bit) at a specified address./
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	267 FLASH_Program_DoubleWord(Address, Data);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	268 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	269
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	270 return status;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	271 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	272
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	273 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	274 * @brief This function handles FLASH interrupt request.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	275 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	276 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	277 void HAL_FLASH_IRQHandler(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	278 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	279 uint32_t addresstmp = 0U;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	280
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	281 /* Check FLASH operation error flags */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	282 #if defined(FLASH_SR_RDERR)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	283 if(__HAL_FLASH_GET_FLAG((FLASH_FLAG_OPERR \| FLASH_FLAG_WRPERR \| FLASH_FLAG_PGAERR \| \
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	284 FLASH_FLAG_PGPERR \| FLASH_FLAG_PGSERR \| FLASH_FLAG_RDERR)) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	285 #else
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	286 if(__HAL_FLASH_GET_FLAG((FLASH_FLAG_OPERR \| FLASH_FLAG_WRPERR \| FLASH_FLAG_PGAERR \| \
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	287 FLASH_FLAG_PGPERR \| FLASH_FLAG_PGSERR)) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	288 #endif /* FLASH_SR_RDERR */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	289 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	290 if(pFlash.ProcedureOnGoing == FLASH_PROC_SECTERASE)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	291 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	292 /return the faulty sector/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	293 addresstmp = pFlash.Sector;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	294 pFlash.Sector = 0xFFFFFFFFU;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	295 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	296 else if(pFlash.ProcedureOnGoing == FLASH_PROC_MASSERASE)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	297 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	298 /return the faulty bank/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	299 addresstmp = pFlash.Bank;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	300 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	301 else
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	302 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	303 /return the faulty address/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	304 addresstmp = pFlash.Address;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	305 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	306
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	307 /Save the Error code/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	308 FLASH_SetErrorCode();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	309
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	310 /* FLASH error interrupt user callback */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	311 HAL_FLASH_OperationErrorCallback(addresstmp);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	312
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	313 /Stop the procedure ongoing/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	314 pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	315 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	316
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	317 /* Check FLASH End of Operation flag */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	318 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	319 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	320 /* Clear FLASH End of Operation pending bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	321 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	322
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	323 if(pFlash.ProcedureOnGoing == FLASH_PROC_SECTERASE)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	324 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	325 /Nb of sector to erased can be decreased/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	326 pFlash.NbSectorsToErase--;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	327
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	328 /* Check if there are still sectors to erase*/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	329 if(pFlash.NbSectorsToErase != 0U)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	330 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	331 addresstmp = pFlash.Sector;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	332 /Indicate user which sector has been erased/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	333 HAL_FLASH_EndOfOperationCallback(addresstmp);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	334
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	335 /Increment sector number/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	336 pFlash.Sector++;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	337 addresstmp = pFlash.Sector;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	338 FLASH_Erase_Sector(addresstmp, pFlash.VoltageForErase);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	339 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	340 else
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	341 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	342 /No more sectors to Erase, user callback can be called./
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	343 /Reset Sector and stop Erase sectors procedure/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	344 pFlash.Sector = addresstmp = 0xFFFFFFFFU;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	345 pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	346
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	347 /* Flush the caches to be sure of the data consistency */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	348 FLASH_FlushCaches() ;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	349
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	350 /* FLASH EOP interrupt user callback */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	351 HAL_FLASH_EndOfOperationCallback(addresstmp);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	352 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	353 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	354 else
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	355 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	356 if(pFlash.ProcedureOnGoing == FLASH_PROC_MASSERASE)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	357 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	358 /* MassErase ended. Return the selected bank */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	359 /* Flush the caches to be sure of the data consistency */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	360 FLASH_FlushCaches() ;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	361
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	362 /* FLASH EOP interrupt user callback */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	363 HAL_FLASH_EndOfOperationCallback(pFlash.Bank);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	364 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	365 else
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	366 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	367 /Program ended. Return the selected address/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	368 /* FLASH EOP interrupt user callback */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	369 HAL_FLASH_EndOfOperationCallback(pFlash.Address);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	370 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	371 pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	372 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	373 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	374
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	375 if(pFlash.ProcedureOnGoing == FLASH_PROC_NONE)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	376 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	377 /* Operation is completed, disable the PG, SER, SNB and MER Bits */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	378 CLEAR_BIT(FLASH->CR, (FLASH_CR_PG \| FLASH_CR_SER \| FLASH_CR_SNB \| FLASH_MER_BIT));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	379
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	380 /* Disable End of FLASH Operation interrupt */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	381 __HAL_FLASH_DISABLE_IT(FLASH_IT_EOP);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	382
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	383 /* Disable Error source interrupt */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	384 __HAL_FLASH_DISABLE_IT(FLASH_IT_ERR);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	385
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	386 /* Process Unlocked */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	387 __HAL_UNLOCK(&pFlash);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	388 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	389 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	390
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	391 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	392 * @brief FLASH end of operation interrupt callback
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	393 * @param ReturnValue The value saved in this parameter depends on the ongoing procedure
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	394 * Mass Erase: Bank number which has been requested to erase
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	395 * Sectors Erase: Sector which has been erased
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	396 * (if 0xFFFFFFFFU, it means that all the selected sectors have been erased)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	397 * Program: Address which was selected for data program
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	398 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	399 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	400 __weak void HAL_FLASH_EndOfOperationCallback(uint32_t ReturnValue)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	401 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	402 /* Prevent unused argument(s) compilation warning */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	403 UNUSED(ReturnValue);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	404 /* NOTE : This function Should not be modified, when the callback is needed,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	405 the HAL_FLASH_EndOfOperationCallback could be implemented in the user file
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	406 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	407 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	408
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	409 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	410 * @brief FLASH operation error interrupt callback
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	411 * @param ReturnValue The value saved in this parameter depends on the ongoing procedure
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	412 * Mass Erase: Bank number which has been requested to erase
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	413 * Sectors Erase: Sector number which returned an error
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	414 * Program: Address which was selected for data program
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	415 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	416 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	417 __weak void HAL_FLASH_OperationErrorCallback(uint32_t ReturnValue)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	418 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	419 /* Prevent unused argument(s) compilation warning */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	420 UNUSED(ReturnValue);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	421 /* NOTE : This function Should not be modified, when the callback is needed,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	422 the HAL_FLASH_OperationErrorCallback could be implemented in the user file
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	423 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	424 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	425
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	426 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	427 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	428 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	429
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	430 /** @defgroup FLASH_Exported_Functions_Group2 Peripheral Control functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	431 * @brief management functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	432 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	433 @verbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	434 ===============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	435 ##### Peripheral Control functions #####
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	436 ===============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	437 [..]
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	438 This subsection provides a set of functions allowing to control the FLASH
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	439 memory operations.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	440
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	441 @endverbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	442 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	443 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	444
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	445 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	446 * @brief Unlock the FLASH control register access
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	447 * @retval HAL Status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	448 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	449 HAL_StatusTypeDef HAL_FLASH_Unlock(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	450 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	451 HAL_StatusTypeDef status = HAL_OK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	452
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	453 if(READ_BIT(FLASH->CR, FLASH_CR_LOCK) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	454 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	455 /* Authorize the FLASH Registers access */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	456 WRITE_REG(FLASH->KEYR, FLASH_KEY1);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	457 WRITE_REG(FLASH->KEYR, FLASH_KEY2);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	458
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	459 /* Verify Flash is unlocked */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	460 if(READ_BIT(FLASH->CR, FLASH_CR_LOCK) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	461 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	462 status = HAL_ERROR;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	463 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	464 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	465
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	466 return status;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	467 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	468
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	469 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	470 * @brief Locks the FLASH control register access
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	471 * @retval HAL Status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	472 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	473 HAL_StatusTypeDef HAL_FLASH_Lock(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	474 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	475 /* Set the LOCK Bit to lock the FLASH Registers access */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	476 FLASH->CR \|= FLASH_CR_LOCK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	477
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	478 return HAL_OK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	479 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	480
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	481 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	482 * @brief Unlock the FLASH Option Control Registers access.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	483 * @retval HAL Status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	484 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	485 HAL_StatusTypeDef HAL_FLASH_OB_Unlock(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	486 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	487 if((FLASH->OPTCR & FLASH_OPTCR_OPTLOCK) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	488 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	489 /* Authorizes the Option Byte register programming */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	490 FLASH->OPTKEYR = FLASH_OPT_KEY1;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	491 FLASH->OPTKEYR = FLASH_OPT_KEY2;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	492 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	493 else
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	494 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	495 return HAL_ERROR;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	496 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	497
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	498 return HAL_OK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	499 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	500
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	501 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	502 * @brief Lock the FLASH Option Control Registers access.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	503 * @retval HAL Status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	504 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	505 HAL_StatusTypeDef HAL_FLASH_OB_Lock(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	506 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	507 /* Set the OPTLOCK Bit to lock the FLASH Option Byte Registers access */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	508 FLASH->OPTCR \|= FLASH_OPTCR_OPTLOCK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	509
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	510 return HAL_OK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	511 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	512
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	513 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	514 * @brief Launch the option byte loading.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	515 * @retval HAL Status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	516 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	517 HAL_StatusTypeDef HAL_FLASH_OB_Launch(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	518 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	519 /* Set the OPTSTRT bit in OPTCR register */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	520 (__IO uint8_t )OPTCR_BYTE0_ADDRESS \|= FLASH_OPTCR_OPTSTRT;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	521
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	522 /* Wait for last operation to be completed */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	523 return(FLASH_WaitForLastOperation((uint32_t)FLASH_TIMEOUT_VALUE));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	524 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	525
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	526 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	527 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	528 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	529
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	530 /** @defgroup FLASH_Exported_Functions_Group3 Peripheral State and Errors functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	531 * @brief Peripheral Errors functions
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	532 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	533 @verbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	534 ===============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	535 ##### Peripheral Errors functions #####
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	536 ===============================================================================
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	537 [..]
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	538 This subsection permits to get in run-time Errors of the FLASH peripheral.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	539
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	540 @endverbatim
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	541 * @{
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	542 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	543
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	544 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	545 * @brief Get the specific FLASH error flag.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	546 * @retval FLASH_ErrorCode: The returned value can be a combination of:
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	547 * @arg HAL_FLASH_ERROR_RD: FLASH Read Protection error flag (PCROP)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	548 * @arg HAL_FLASH_ERROR_PGS: FLASH Programming Sequence error flag
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	549 * @arg HAL_FLASH_ERROR_PGP: FLASH Programming Parallelism error flag
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	550 * @arg HAL_FLASH_ERROR_PGA: FLASH Programming Alignment error flag
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	551 * @arg HAL_FLASH_ERROR_WRP: FLASH Write protected error flag
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	552 * @arg HAL_FLASH_ERROR_OPERATION: FLASH operation Error flag
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	553 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	554 uint32_t HAL_FLASH_GetError(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	555 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	556 return pFlash.ErrorCode;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	557 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	558
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	559 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	560 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	561 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	562
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	563 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	564 * @brief Wait for a FLASH operation to complete.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	565 * @param Timeout maximum flash operationtimeout
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	566 * @retval HAL Status
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	567 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	568 HAL_StatusTypeDef FLASH_WaitForLastOperation(uint32_t Timeout)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	569 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	570 uint32_t tickstart = 0U;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	571
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	572 /* Clear Error Code */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	573 pFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	574
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	575 /* Wait for the FLASH operation to complete by polling on BUSY flag to be reset.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	576 Even if the FLASH operation fails, the BUSY flag will be reset and an error
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	577 flag will be set */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	578 /* Get tick */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	579 tickstart = HAL_GetTick();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	580
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	581 while(__HAL_FLASH_GET_FLAG(FLASH_FLAG_BSY) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	582 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	583 if(Timeout != HAL_MAX_DELAY)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	584 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	585 if((Timeout == 0U)\|\|((HAL_GetTick() - tickstart ) > Timeout))
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	586 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	587 return HAL_TIMEOUT;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	588 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	589 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	590 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	591
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	592 /* Check FLASH End of Operation flag */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	593 if (__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	594 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	595 /* Clear FLASH End of Operation pending bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	596 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	597 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	598 #if defined(FLASH_SR_RDERR)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	599 if(__HAL_FLASH_GET_FLAG((FLASH_FLAG_OPERR \| FLASH_FLAG_WRPERR \| FLASH_FLAG_PGAERR \| \
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	600 FLASH_FLAG_PGPERR \| FLASH_FLAG_PGSERR \| FLASH_FLAG_RDERR)) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	601 #else
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	602 if(__HAL_FLASH_GET_FLAG((FLASH_FLAG_OPERR \| FLASH_FLAG_WRPERR \| FLASH_FLAG_PGAERR \| \
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	603 FLASH_FLAG_PGPERR \| FLASH_FLAG_PGSERR)) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	604 #endif /* FLASH_SR_RDERR */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	605 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	606 /Save the error code/
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	607 FLASH_SetErrorCode();
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	608 return HAL_ERROR;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	609 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	610
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	611 /* If there is no error flag set */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	612 return HAL_OK;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	613
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	614 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	615
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	616 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	617 * @brief Program a double word (64-bit) at a specified address.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	618 * @note This function must be used when the device voltage range is from
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	619 * 2.7V to 3.6V and Vpp in the range 7V to 9V.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	620 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	621 * @note If an erase and a program operations are requested simultaneously,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	622 * the erase operation is performed before the program one.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	623 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	624 * @param Address specifies the address to be programmed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	625 * @param Data specifies the data to be programmed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	626 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	627 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	628 static void FLASH_Program_DoubleWord(uint32_t Address, uint64_t Data)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	629 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	630 /* Check the parameters */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	631 assert_param(IS_FLASH_ADDRESS(Address));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	632
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	633 /* If the previous operation is completed, proceed to program the new data */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	634 CLEAR_BIT(FLASH->CR, FLASH_CR_PSIZE);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	635 FLASH->CR \|= FLASH_PSIZE_DOUBLE_WORD;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	636 FLASH->CR \|= FLASH_CR_PG;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	637
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	638 /* Program the double-word */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	639 (__IO uint32_t)Address = (uint32_t)Data;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	640 (__IO uint32_t)(Address+4) = (uint32_t)(Data >> 32);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	641 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	642
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	643
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	644 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	645 * @brief Program word (32-bit) at a specified address.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	646 * @note This function must be used when the device voltage range is from
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	647 * 2.7V to 3.6V.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	648 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	649 * @note If an erase and a program operations are requested simultaneously,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	650 * the erase operation is performed before the program one.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	651 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	652 * @param Address specifies the address to be programmed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	653 * @param Data specifies the data to be programmed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	654 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	655 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	656 static void FLASH_Program_Word(uint32_t Address, uint32_t Data)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	657 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	658 /* Check the parameters */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	659 assert_param(IS_FLASH_ADDRESS(Address));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	660
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	661 /* If the previous operation is completed, proceed to program the new data */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	662 CLEAR_BIT(FLASH->CR, FLASH_CR_PSIZE);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	663 FLASH->CR \|= FLASH_PSIZE_WORD;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	664 FLASH->CR \|= FLASH_CR_PG;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	665
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	666 (__IO uint32_t)Address = Data;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	667 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	668
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	669 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	670 * @brief Program a half-word (16-bit) at a specified address.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	671 * @note This function must be used when the device voltage range is from
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	672 * 2.1V to 3.6V.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	673 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	674 * @note If an erase and a program operations are requested simultaneously,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	675 * the erase operation is performed before the program one.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	676 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	677 * @param Address specifies the address to be programmed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	678 * @param Data specifies the data to be programmed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	679 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	680 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	681 static void FLASH_Program_HalfWord(uint32_t Address, uint16_t Data)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	682 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	683 /* Check the parameters */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	684 assert_param(IS_FLASH_ADDRESS(Address));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	685
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	686 /* If the previous operation is completed, proceed to program the new data */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	687 CLEAR_BIT(FLASH->CR, FLASH_CR_PSIZE);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	688 FLASH->CR \|= FLASH_PSIZE_HALF_WORD;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	689 FLASH->CR \|= FLASH_CR_PG;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	690
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	691 (__IO uint16_t)Address = Data;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	692 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	693
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	694 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	695 * @brief Program byte (8-bit) at a specified address.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	696 * @note This function must be used when the device voltage range is from
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	697 * 1.8V to 3.6V.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	698 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	699 * @note If an erase and a program operations are requested simultaneously,
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	700 * the erase operation is performed before the program one.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	701 *
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	702 * @param Address specifies the address to be programmed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	703 * @param Data specifies the data to be programmed.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	704 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	705 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	706 static void FLASH_Program_Byte(uint32_t Address, uint8_t Data)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	707 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	708 /* Check the parameters */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	709 assert_param(IS_FLASH_ADDRESS(Address));
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	710
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	711 /* If the previous operation is completed, proceed to program the new data */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	712 CLEAR_BIT(FLASH->CR, FLASH_CR_PSIZE);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	713 FLASH->CR \|= FLASH_PSIZE_BYTE;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	714 FLASH->CR \|= FLASH_CR_PG;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	715
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	716 (__IO uint8_t)Address = Data;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	717 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	718
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	719 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	720 * @brief Set the specific FLASH error flag.
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	721 * @retval None
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	722 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	723 static void FLASH_SetErrorCode(void)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	724 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	725 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	726 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	727 pFlash.ErrorCode \|= HAL_FLASH_ERROR_WRP;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	728
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	729 /* Clear FLASH write protection error pending bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	730 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_WRPERR);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	731 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	732
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	733 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGAERR) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	734 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	735 pFlash.ErrorCode \|= HAL_FLASH_ERROR_PGA;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	736
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	737 /* Clear FLASH Programming alignment error pending bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	738 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_PGAERR);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	739 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	740
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	741 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGPERR) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	742 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	743 pFlash.ErrorCode \|= HAL_FLASH_ERROR_PGP;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	744
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	745 /* Clear FLASH Programming parallelism error pending bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	746 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_PGPERR);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	747 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	748
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	749 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGSERR) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	750 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	751 pFlash.ErrorCode \|= HAL_FLASH_ERROR_PGS;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	752
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	753 /* Clear FLASH Programming sequence error pending bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	754 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_PGSERR);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	755 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	756 #if defined(FLASH_SR_RDERR)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	757 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_RDERR) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	758 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	759 pFlash.ErrorCode \|= HAL_FLASH_ERROR_RD;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	760
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	761 /* Clear FLASH Proprietary readout protection error pending bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	762 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_RDERR);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	763 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	764 #endif /* FLASH_SR_RDERR */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	765 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_OPERR) != RESET)
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	766 {
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	767 pFlash.ErrorCode \|= HAL_FLASH_ERROR_OPERATION;
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	768
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	769 /* Clear FLASH Operation error pending bit */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	770 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_OPERR);
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	771 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	772 }
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	773
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	774 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	775 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	776 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	777
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	778 #endif /* HAL_FLASH_MODULE_ENABLED */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	779
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	780 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	781 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	782 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	783
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	784 /**
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	785 * @}
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	786 */
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	787
c78bcbd5deda Added current STM32 standandard libraries in version independend folder structure Ideenmodellierer parents: diff changeset	788 /********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/

Mercurial > public > ostc4

annotate Common/Drivers/STM32F4xx_HAL_Driver/Src/stm32f4xx_hal_flash.c @ 774:6169309d6eb9