Subversion Repositories EngineBay2

Rev

Rev 2 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 2 Rev 28
Line 1... Line 1...
1
/**
1
/**
2
  ******************************************************************************
2
  ******************************************************************************
3
  * @file    stm32l1xx_hal_flash.h
3
  * @file    stm32l1xx_hal_flash.h
4
  * @author  MCD Application Team
4
  * @author  MCD Application Team
5
  * @version V1.2.0
-
 
6
  * @date    01-July-2016
-
 
7
  * @brief   Header file of Flash HAL module.
5
  * @brief   Header file of Flash HAL module.
8
  ******************************************************************************
6
  ******************************************************************************
9
  * @attention
7
  * @attention
10
  *
8
  *
11
  * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
9
  * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
-
 
10
  * All rights reserved.</center></h2>
12
  *
11
  *
13
  * Redistribution and use in source and binary forms, with or without modification,
12
  * This software component is licensed by ST under BSD 3-Clause license,
14
  * are permitted provided that the following conditions are met:
13
  * the "License"; You may not use this file except in compliance with the
15
  *   1. Redistributions of source code must retain the above copyright notice,
-
 
16
  *      this list of conditions and the following disclaimer.
-
 
17
  *   2. Redistributions in binary form must reproduce the above copyright notice,
-
 
18
  *      this list of conditions and the following disclaimer in the documentation
-
 
19
  *      and/or other materials provided with the distribution.
14
  * License. You may obtain a copy of the License at:
20
  *   3. Neither the name of STMicroelectronics nor the names of its contributors
-
 
21
  *      may be used to endorse or promote products derived from this software
15
  *                        opensource.org/licenses/BSD-3-Clause
22
  *      without specific prior written permission.
-
 
23
  *
16
  *
24
  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-
 
25
  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-
 
26
  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-
 
27
  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-
 
28
  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-
 
29
  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-
 
30
  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-
 
31
  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-
 
32
  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-
 
33
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
 
34
  *
-
 
35
  ******************************************************************************  
17
  ******************************************************************************
36
  */
18
  */
37
 
19
 
38
/* Define to prevent recursive inclusion -------------------------------------*/
20
/* Define to prevent recursive inclusion -------------------------------------*/
39
#ifndef __STM32L1xx_HAL_FLASH_H
21
#ifndef __STM32L1xx_HAL_FLASH_H
40
#define __STM32L1xx_HAL_FLASH_H
22
#define __STM32L1xx_HAL_FLASH_H
Line 55... Line 37...
55
  */
37
  */
56
 
38
 
57
/** @addtogroup FLASH_Private_Constants
39
/** @addtogroup FLASH_Private_Constants
58
  * @{
40
  * @{
59
  */
41
  */
60
#define FLASH_TIMEOUT_VALUE   ((uint32_t)50000U) /* 50 s */
42
#define FLASH_TIMEOUT_VALUE      (50000U) /* 50 s */
61
/**
43
/**
62
  * @}
44
  * @}
63
  */
45
  */
64
 
46
 
65
/** @addtogroup FLASH_Private_Macros
47
/** @addtogroup FLASH_Private_Macros
66
  * @{
48
  * @{
67
  */
49
  */
68
 
50
 
69
#define IS_FLASH_TYPEPROGRAM(_VALUE_)   (((_VALUE_) == FLASH_TYPEPROGRAM_WORD))
51
#define IS_FLASH_TYPEPROGRAM(_VALUE_)   ((_VALUE_) == FLASH_TYPEPROGRAM_WORD)
70
 
52
 
71
#define IS_FLASH_LATENCY(__LATENCY__) (((__LATENCY__) == FLASH_LATENCY_0) || \
53
#define IS_FLASH_LATENCY(__LATENCY__) (((__LATENCY__) == FLASH_LATENCY_0) || \
72
                                       ((__LATENCY__) == FLASH_LATENCY_1))
54
                                       ((__LATENCY__) == FLASH_LATENCY_1))
73
 
55
 
74
/**
56
/**
Line 83... Line 65...
83
/**
65
/**
84
  * @brief  FLASH Procedure structure definition
66
  * @brief  FLASH Procedure structure definition
85
  */
67
  */
86
typedef enum
68
typedef enum
87
{
69
{
88
  FLASH_PROC_NONE              = 0,
70
  FLASH_PROC_NONE              = 0U,
89
  FLASH_PROC_PAGEERASE         = 1,
71
  FLASH_PROC_PAGEERASE         = 1U,
90
  FLASH_PROC_PROGRAM           = 2,
72
  FLASH_PROC_PROGRAM           = 2U,
91
} FLASH_ProcedureTypeDef;
73
} FLASH_ProcedureTypeDef;
92
 
74
 
93
/**
75
/**
94
  * @brief  FLASH handle Structure definition  
76
  * @brief  FLASH handle Structure definition  
95
  */
77
  */
Line 137... Line 119...
137
 
119
 
138
/** @defgroup FLASH_Page_Size FLASH size information
120
/** @defgroup FLASH_Page_Size FLASH size information
139
  * @{
121
  * @{
140
  */
122
  */
141
 
123
 
142
#define FLASH_SIZE                (uint32_t)(*((uint16_t *)FLASHSIZE_BASE) * 1024U)
124
#define FLASH_SIZE                (uint32_t)((*((uint32_t *)FLASHSIZE_BASE)&0xFFFFU) * 1024U)
143
#define FLASH_PAGE_SIZE           ((uint32_t)256U)  /*!< FLASH Page Size in bytes */
125
#define FLASH_PAGE_SIZE           (256U)  /*!< FLASH Page Size in bytes */
144
 
126
 
145
/**
127
/**
146
  * @}
128
  * @}
147
  */
129
  */
148
 
130
 
149
/** @defgroup FLASH_Type_Program FLASH Type Program
131
/** @defgroup FLASH_Type_Program FLASH Type Program
150
  * @{
132
  * @{
151
  */
133
  */
152
#define FLASH_TYPEPROGRAM_WORD       ((uint32_t)0x02U)  /*!<Program a word (32-bit) at a specified address.*/
134
#define FLASH_TYPEPROGRAM_WORD       (0x02U)  /*!<Program a word (32-bit) at a specified address.*/
153
 
135
 
154
/**
136
/**
155
  * @}
137
  * @}
156
  */
138
  */
157
 
139
 
158
/** @defgroup FLASH_Latency FLASH Latency
140
/** @defgroup FLASH_Latency FLASH Latency
159
  * @{
141
  * @{
160
  */
142
  */
161
#define FLASH_LATENCY_0            ((uint32_t)0x00000000U)    /*!< FLASH Zero Latency cycle */
143
#define FLASH_LATENCY_0            (0x00000000U)    /*!< FLASH Zero Latency cycle */
162
#define FLASH_LATENCY_1            FLASH_ACR_LATENCY         /*!< FLASH One Latency cycle */
144
#define FLASH_LATENCY_1            FLASH_ACR_LATENCY         /*!< FLASH One Latency cycle */
163
 
145
 
164
/**
146
/**
165
  * @}
147
  * @}
166
  */
148
  */
167
 
149
 
168
/** @defgroup FLASH_Interrupts FLASH Interrupts
150
/** @defgroup FLASH_Interrupts FLASH Interrupts
169
  * @{
151
  * @{
170
  */
152
  */
171
   
153
 
172
#define FLASH_IT_EOP               FLASH_PECR_EOPIE  /*!< End of programming interrupt source */
154
#define FLASH_IT_EOP               FLASH_PECR_EOPIE  /*!< End of programming interrupt source */
173
#define FLASH_IT_ERR               FLASH_PECR_ERRIE  /*!< Error interrupt source */
155
#define FLASH_IT_ERR               FLASH_PECR_ERRIE  /*!< Error interrupt source */
174
/**
156
/**
175
  * @}
157
  * @}
176
  */
158
  */
Line 202... Line 184...
202
 
184
 
203
/** @defgroup FLASH_Keys FLASH Keys
185
/** @defgroup FLASH_Keys FLASH Keys
204
  * @{
186
  * @{
205
  */
187
  */
206
 
188
 
207
#define FLASH_PDKEY1               ((uint32_t)0x04152637U) /*!< Flash power down key1 */
189
#define FLASH_PDKEY1               (0x04152637U) /*!< Flash power down key1 */
208
#define FLASH_PDKEY2               ((uint32_t)0xFAFBFCFDU) /*!< Flash power down key2: used with FLASH_PDKEY1 
190
#define FLASH_PDKEY2               (0xFAFBFCFDU) /*!< Flash power down key2: used with FLASH_PDKEY1 
209
                                                              to unlock the RUN_PD bit in FLASH_ACR */
191
                                                              to unlock the RUN_PD bit in FLASH_ACR */
210
 
192
 
211
#define FLASH_PEKEY1               ((uint32_t)0x89ABCDEFU) /*!< Flash program erase key1 */
193
#define FLASH_PEKEY1               (0x89ABCDEFU) /*!< Flash program erase key1 */
212
#define FLASH_PEKEY2               ((uint32_t)0x02030405U) /*!< Flash program erase key: used with FLASH_PEKEY2
194
#define FLASH_PEKEY2               (0x02030405U) /*!< Flash program erase key: used with FLASH_PEKEY2
213
                                                               to unlock the write access to the FLASH_PECR register and
195
                                                               to unlock the write access to the FLASH_PECR register and
214
                                                               data EEPROM */
196
                                                               data EEPROM */
215
 
197
 
216
#define FLASH_PRGKEY1              ((uint32_t)0x8C9DAEBFU) /*!< Flash program memory key1 */
198
#define FLASH_PRGKEY1              (0x8C9DAEBFU) /*!< Flash program memory key1 */
217
#define FLASH_PRGKEY2              ((uint32_t)0x13141516U) /*!< Flash program memory key2: used with FLASH_PRGKEY2
199
#define FLASH_PRGKEY2              (0x13141516U) /*!< Flash program memory key2: used with FLASH_PRGKEY2
218
                                                               to unlock the program memory */
200
                                                               to unlock the program memory */
219
 
201
 
220
#define FLASH_OPTKEY1              ((uint32_t)0xFBEAD9C8U) /*!< Flash option key1 */
202
#define FLASH_OPTKEY1              (0xFBEAD9C8U) /*!< Flash option key1 */
221
#define FLASH_OPTKEY2              ((uint32_t)0x24252627U) /*!< Flash option key2: used with FLASH_OPTKEY1 to
203
#define FLASH_OPTKEY2              (0x24252627U) /*!< Flash option key2: used with FLASH_OPTKEY1 to
222
                                                              unlock the write access to the option byte block */
204
                                                              unlock the write access to the option byte block */
223
/**
205
/**
224
  * @}
206
  * @}
225
  */
207
  */
226
/**
208
/**
Line 303... Line 285...
303
/**
285
/**
304
  * @brief  Clear the specified FLASH flag.
286
  * @brief  Clear the specified FLASH flag.
305
  * @param  __FLAG__ specifies the FLASH flags to clear.
287
  * @param  __FLAG__ specifies the FLASH flags to clear.
306
  *          This parameter can be any combination of the following values:
288
  *          This parameter can be any combination of the following values:
307
  *            @arg @ref FLASH_FLAG_EOP         FLASH End of Operation flag
289
  *            @arg @ref FLASH_FLAG_EOP         FLASH End of Operation flag
308
  *            @arg @ref FLASH_FLAG_ENDHV       FLASH End of High Voltage flag
-
 
309
  *            @arg @ref FLASH_FLAG_READY       FLASH Ready flag after low power mode
-
 
310
  *            @arg @ref FLASH_FLAG_PGAERR      FLASH Programming Alignment error flag
290
  *            @arg @ref FLASH_FLAG_PGAERR      FLASH Programming Alignment error flag
311
  *            @arg @ref FLASH_FLAG_SIZERR      FLASH Size error flag
291
  *            @arg @ref FLASH_FLAG_SIZERR      FLASH Size error flag
312
  *            @arg @ref FLASH_FLAG_OPTVERR     FLASH Option validity error error flag
292
  *            @arg @ref FLASH_FLAG_OPTVERR     FLASH Option validity error error flag
313
@if STM32L100xB
293
@if STM32L100xB
314
@elif STM32L100xBA
294
@elif STM32L100xBA