2 ******************************************************************************
\r
3 * @file stm32f10x_bkp.c
\r
4 * @author MCD Application Team
\r
7 * @brief This file provides all the BKP firmware functions.
\r
8 ******************************************************************************
\r
11 * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
\r
12 * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
\r
13 * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
\r
14 * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
\r
15 * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
\r
16 * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
\r
18 * <h2><center>© COPYRIGHT 2010 STMicroelectronics</center></h2>
\r
21 /* Includes ------------------------------------------------------------------*/
\r
22 #include "stm32f10x_bkp.h"
\r
23 #include "stm32f10x_rcc.h"
\r
25 /** @addtogroup STM32F10x_StdPeriph_Driver
\r
30 * @brief BKP driver modules
\r
34 /** @defgroup BKP_Private_TypesDefinitions
\r
42 /** @defgroup BKP_Private_Defines
\r
46 /* ------------ BKP registers bit address in the alias region --------------- */
\r
47 #define BKP_OFFSET (BKP_BASE - PERIPH_BASE)
\r
49 /* --- CR Register ----*/
\r
51 /* Alias word address of TPAL bit */
\r
52 #define CR_OFFSET (BKP_OFFSET + 0x30)
\r
53 #define TPAL_BitNumber 0x01
\r
54 #define CR_TPAL_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (TPAL_BitNumber * 4))
\r
56 /* Alias word address of TPE bit */
\r
57 #define TPE_BitNumber 0x00
\r
58 #define CR_TPE_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (TPE_BitNumber * 4))
\r
60 /* --- CSR Register ---*/
\r
62 /* Alias word address of TPIE bit */
\r
63 #define CSR_OFFSET (BKP_OFFSET + 0x34)
\r
64 #define TPIE_BitNumber 0x02
\r
65 #define CSR_TPIE_BB (PERIPH_BB_BASE + (CSR_OFFSET * 32) + (TPIE_BitNumber * 4))
\r
67 /* Alias word address of TIF bit */
\r
68 #define TIF_BitNumber 0x09
\r
69 #define CSR_TIF_BB (PERIPH_BB_BASE + (CSR_OFFSET * 32) + (TIF_BitNumber * 4))
\r
71 /* Alias word address of TEF bit */
\r
72 #define TEF_BitNumber 0x08
\r
73 #define CSR_TEF_BB (PERIPH_BB_BASE + (CSR_OFFSET * 32) + (TEF_BitNumber * 4))
\r
75 /* ---------------------- BKP registers bit mask ------------------------ */
\r
77 /* RTCCR register bit mask */
\r
78 #define RTCCR_CAL_Mask ((uint16_t)0xFF80)
\r
79 #define RTCCR_Mask ((uint16_t)0xFC7F)
\r
81 /* CSR register bit mask */
\r
82 #define CSR_CTE_Set ((uint16_t)0x0001)
\r
83 #define CSR_CTI_Set ((uint16_t)0x0002)
\r
90 /** @defgroup BKP_Private_Macros
\r
98 /** @defgroup BKP_Private_Variables
\r
106 /** @defgroup BKP_Private_FunctionPrototypes
\r
114 /** @defgroup BKP_Private_Functions
\r
119 * @brief Deinitializes the BKP peripheral registers to their default reset values.
\r
123 void BKP_DeInit(void)
\r
125 RCC_BackupResetCmd(ENABLE);
\r
126 RCC_BackupResetCmd(DISABLE);
\r
130 * @brief Configures the Tamper Pin active level.
\r
131 * @param BKP_TamperPinLevel: specifies the Tamper Pin active level.
\r
132 * This parameter can be one of the following values:
\r
133 * @arg BKP_TamperPinLevel_High: Tamper pin active on high level
\r
134 * @arg BKP_TamperPinLevel_Low: Tamper pin active on low level
\r
137 void BKP_TamperPinLevelConfig(uint16_t BKP_TamperPinLevel)
\r
139 /* Check the parameters */
\r
140 assert_param(IS_BKP_TAMPER_PIN_LEVEL(BKP_TamperPinLevel));
\r
141 *(__IO uint32_t *) CR_TPAL_BB = BKP_TamperPinLevel;
\r
145 * @brief Enables or disables the Tamper Pin activation.
\r
146 * @param NewState: new state of the Tamper Pin activation.
\r
147 * This parameter can be: ENABLE or DISABLE.
\r
150 void BKP_TamperPinCmd(FunctionalState NewState)
\r
152 /* Check the parameters */
\r
153 assert_param(IS_FUNCTIONAL_STATE(NewState));
\r
154 *(__IO uint32_t *) CR_TPE_BB = (uint32_t)NewState;
\r
158 * @brief Enables or disables the Tamper Pin Interrupt.
\r
159 * @param NewState: new state of the Tamper Pin Interrupt.
\r
160 * This parameter can be: ENABLE or DISABLE.
\r
163 void BKP_ITConfig(FunctionalState NewState)
\r
165 /* Check the parameters */
\r
166 assert_param(IS_FUNCTIONAL_STATE(NewState));
\r
167 *(__IO uint32_t *) CSR_TPIE_BB = (uint32_t)NewState;
\r
171 * @brief Select the RTC output source to output on the Tamper pin.
\r
172 * @param BKP_RTCOutputSource: specifies the RTC output source.
\r
173 * This parameter can be one of the following values:
\r
174 * @arg BKP_RTCOutputSource_None: no RTC output on the Tamper pin.
\r
175 * @arg BKP_RTCOutputSource_CalibClock: output the RTC clock with frequency
\r
176 * divided by 64 on the Tamper pin.
\r
177 * @arg BKP_RTCOutputSource_Alarm: output the RTC Alarm pulse signal on
\r
179 * @arg BKP_RTCOutputSource_Second: output the RTC Second pulse signal on
\r
183 void BKP_RTCOutputConfig(uint16_t BKP_RTCOutputSource)
\r
185 uint16_t tmpreg = 0;
\r
186 /* Check the parameters */
\r
187 assert_param(IS_BKP_RTC_OUTPUT_SOURCE(BKP_RTCOutputSource));
\r
188 tmpreg = BKP->RTCCR;
\r
189 /* Clear CCO, ASOE and ASOS bits */
\r
190 tmpreg &= RTCCR_Mask;
\r
192 /* Set CCO, ASOE and ASOS bits according to BKP_RTCOutputSource value */
\r
193 tmpreg |= BKP_RTCOutputSource;
\r
194 /* Store the new value */
\r
195 BKP->RTCCR = tmpreg;
\r
199 * @brief Sets RTC Clock Calibration value.
\r
200 * @param CalibrationValue: specifies the RTC Clock Calibration value.
\r
201 * This parameter must be a number between 0 and 0x7F.
\r
204 void BKP_SetRTCCalibrationValue(uint8_t CalibrationValue)
\r
206 uint16_t tmpreg = 0;
\r
207 /* Check the parameters */
\r
208 assert_param(IS_BKP_CALIBRATION_VALUE(CalibrationValue));
\r
209 tmpreg = BKP->RTCCR;
\r
210 /* Clear CAL[6:0] bits */
\r
211 tmpreg &= RTCCR_CAL_Mask;
\r
212 /* Set CAL[6:0] bits according to CalibrationValue value */
\r
213 tmpreg |= CalibrationValue;
\r
214 /* Store the new value */
\r
215 BKP->RTCCR = tmpreg;
\r
219 * @brief Writes user data to the specified Data Backup Register.
\r
220 * @param BKP_DR: specifies the Data Backup Register.
\r
221 * This parameter can be BKP_DRx where x:[1, 42]
\r
222 * @param Data: data to write
\r
225 void BKP_WriteBackupRegister(uint16_t BKP_DR, uint16_t Data)
\r
227 __IO uint32_t tmp = 0;
\r
229 /* Check the parameters */
\r
230 assert_param(IS_BKP_DR(BKP_DR));
\r
232 tmp = (uint32_t)BKP_BASE;
\r
235 *(__IO uint32_t *) tmp = Data;
\r
239 * @brief Reads data from the specified Data Backup Register.
\r
240 * @param BKP_DR: specifies the Data Backup Register.
\r
241 * This parameter can be BKP_DRx where x:[1, 42]
\r
242 * @retval The content of the specified Data Backup Register
\r
244 uint16_t BKP_ReadBackupRegister(uint16_t BKP_DR)
\r
246 __IO uint32_t tmp = 0;
\r
248 /* Check the parameters */
\r
249 assert_param(IS_BKP_DR(BKP_DR));
\r
251 tmp = (uint32_t)BKP_BASE;
\r
254 return (*(__IO uint16_t *) tmp);
\r
258 * @brief Checks whether the Tamper Pin Event flag is set or not.
\r
260 * @retval The new state of the Tamper Pin Event flag (SET or RESET).
\r
262 FlagStatus BKP_GetFlagStatus(void)
\r
264 return (FlagStatus)(*(__IO uint32_t *) CSR_TEF_BB);
\r
268 * @brief Clears Tamper Pin Event pending flag.
\r
272 void BKP_ClearFlag(void)
\r
274 /* Set CTE bit to clear Tamper Pin Event flag */
\r
275 BKP->CSR |= CSR_CTE_Set;
\r
279 * @brief Checks whether the Tamper Pin Interrupt has occurred or not.
\r
281 * @retval The new state of the Tamper Pin Interrupt (SET or RESET).
\r
283 ITStatus BKP_GetITStatus(void)
\r
285 return (ITStatus)(*(__IO uint32_t *) CSR_TIF_BB);
\r
289 * @brief Clears Tamper Pin Interrupt pending bit.
\r
293 void BKP_ClearITPendingBit(void)
\r
295 /* Set CTI bit to clear Tamper Pin Interrupt pending bit */
\r
296 BKP->CSR |= CSR_CTI_Set;
\r
311 /******************* (C) COPYRIGHT 2010 STMicroelectronics *****END OF FILE****/
\r