1 /******************** (C) COPYRIGHT 2007 STMicroelectronics ********************
\r
2 * File Name : stm32f10x_bkp.c
\r
3 * Author : MCD Application Team
\r
4 * Date First Issued : 09/29/2006
\r
5 * Description : This file provides all the BKP firmware functions.
\r
6 ********************************************************************************
\r
11 ********************************************************************************
\r
12 * THE PRESENT SOFTWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
\r
13 * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE TIME.
\r
14 * AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY DIRECT,
\r
15 * INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING FROM THE
\r
16 * CONTENT OF SUCH SOFTWARE AND/OR THE USE MADE BY CUSTOMERS OF THE CODING
\r
17 * INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
\r
18 *******************************************************************************/
\r
20 /* Includes ------------------------------------------------------------------*/
\r
21 #include "stm32f10x_bkp.h"
\r
22 #include "stm32f10x_rcc.h"
\r
24 /* Private typedef -----------------------------------------------------------*/
\r
25 /* Private define ------------------------------------------------------------*/
\r
26 /* ------------ BKP registers bit address in the alias region ----------- */
\r
27 #define BKP_OFFSET (BKP_BASE - PERIPH_BASE)
\r
29 /* --- RTCCR Register ---*/
\r
30 /* Alias word address of CCO bit */
\r
31 #define RTCCR_OFFSET (BKP_OFFSET + 0x2C)
\r
32 #define CCO_BitNumber 0x07
\r
33 #define RTCCR_CCO_BB (PERIPH_BB_BASE + (RTCCR_OFFSET * 32) + (CCO_BitNumber * 4))
\r
35 /* --- CR Register ---*/
\r
36 /* Alias word address of TPAL bit */
\r
37 #define CR_OFFSET (BKP_OFFSET + 0x30)
\r
38 #define TPAL_BitNumber 0x01
\r
39 #define CR_TPAL_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (TPAL_BitNumber * 4))
\r
41 /* Alias word address of TPE bit */
\r
42 #define TPE_BitNumber 0x00
\r
43 #define CR_TPE_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (TPE_BitNumber * 4))
\r
45 /* --- CSR Register ---*/
\r
46 /* Alias word address of TPIE bit */
\r
47 #define CSR_OFFSET (BKP_OFFSET + 0x34)
\r
48 #define TPIE_BitNumber 0x02
\r
49 #define CSR_TPIE_BB (PERIPH_BB_BASE + (CSR_OFFSET * 32) + (TPIE_BitNumber * 4))
\r
51 /* Alias word address of TIF bit */
\r
52 #define TIF_BitNumber 0x09
\r
53 #define CSR_TIF_BB (PERIPH_BB_BASE + (CSR_OFFSET * 32) + (TIF_BitNumber * 4))
\r
55 /* Alias word address of TEF bit */
\r
56 #define TEF_BitNumber 0x08
\r
57 #define CSR_TEF_BB (PERIPH_BB_BASE + (CSR_OFFSET * 32) + (TEF_BitNumber * 4))
\r
60 /* ---------------------- BKP registers bit mask ------------------------ */
\r
61 /* RTCCR register bit mask */
\r
62 #define RTCCR_CAL_Mask ((u16)0xFF80)
\r
64 /* CSR register bit mask */
\r
65 #define CSR_CTE_Set ((u16)0x0001)
\r
66 #define CSR_CTI_Set ((u16)0x0002)
\r
68 /* Private macro -------------------------------------------------------------*/
\r
69 /* Private variables ---------------------------------------------------------*/
\r
70 /* Private function prototypes -----------------------------------------------*/
\r
71 /* Private functions ---------------------------------------------------------*/
\r
73 /*******************************************************************************
\r
74 * Function Name : BKP_DeInit
\r
75 * Description : Deinitializes the BKP peripheral registers to their default
\r
80 *******************************************************************************/
\r
81 void BKP_DeInit(void)
\r
83 RCC_BackupResetCmd(ENABLE);
\r
84 RCC_BackupResetCmd(DISABLE);
\r
87 /*******************************************************************************
\r
88 * Function Name : BKP_TamperPinLevelConfig
\r
89 * Description : Configures the Tamper Pin active level.
\r
90 * Input : - BKP_TamperPinLevel: specifies the Tamper Pin active level.
\r
91 * This parameter can be one of the following values:
\r
92 * - BKP_TamperPinLevel_High: Tamper pin active on high level
\r
93 * - BKP_TamperPinLevel_Low: Tamper pin active on low level
\r
96 *******************************************************************************/
\r
97 void BKP_TamperPinLevelConfig(u16 BKP_TamperPinLevel)
\r
99 /* Check the parameters */
\r
100 assert(IS_BKP_TAMPER_PIN_LEVEL(BKP_TamperPinLevel));
\r
102 *(vu32 *) CR_TPAL_BB = BKP_TamperPinLevel;
\r
105 /*******************************************************************************
\r
106 * Function Name : BKP_TamperPinCmd
\r
107 * Description : Enables or disables the Tamper Pin activation.
\r
108 * Input : - NewState: new state of the Tamper Pin activation.
\r
109 * This parameter can be: ENABLE or DISABLE.
\r
112 *******************************************************************************/
\r
113 void BKP_TamperPinCmd(FunctionalState NewState)
\r
115 /* Check the parameters */
\r
116 assert(IS_FUNCTIONAL_STATE(NewState));
\r
118 *(vu32 *) CR_TPE_BB = (u32)NewState;
\r
121 /*******************************************************************************
\r
122 * Function Name : BKP_ITConfig
\r
123 * Description : Enables or disables the Tamper Pin Interrupt.
\r
124 * Input : - NewState: new state of the Tamper Pin Interrupt.
\r
125 * This parameter can be: ENABLE or DISABLE.
\r
128 *******************************************************************************/
\r
129 void BKP_ITConfig(FunctionalState NewState)
\r
131 /* Check the parameters */
\r
132 assert(IS_FUNCTIONAL_STATE(NewState));
\r
134 *(vu32 *) CSR_TPIE_BB = (u32)NewState;
\r
137 /*******************************************************************************
\r
138 * Function Name : BKP_RTCCalibrationClockOutputCmd
\r
139 * Description : Enables or disables the output of the Calibration Clock.
\r
140 * Input : - NewState: new state of the Calibration Clock output.
\r
141 * This parameter can be: ENABLE or DISABLE.
\r
144 *******************************************************************************/
\r
145 void BKP_RTCCalibrationClockOutputCmd(FunctionalState NewState)
\r
147 /* Check the parameters */
\r
148 assert(IS_FUNCTIONAL_STATE(NewState));
\r
150 *(vu32 *) RTCCR_CCO_BB = (u32)NewState;
\r
153 /*******************************************************************************
\r
154 * Function Name : BKP_SetRTCCalibrationValue
\r
155 * Description : Sets RTC Clock Calibration value.
\r
156 * Input : - CalibrationValue: specifies the RTC Clock Calibration value.
\r
157 * This parameter must be a number between 0 and 0x7F.
\r
160 *******************************************************************************/
\r
161 void BKP_SetRTCCalibrationValue(u8 CalibrationValue)
\r
165 /* Check the parameters */
\r
166 assert(IS_BKP_CALIBRATION_VALUE(CalibrationValue));
\r
168 tmpreg = BKP->RTCCR;
\r
170 /* Clear CAL[6:0] bits */
\r
171 tmpreg &= RTCCR_CAL_Mask;
\r
173 /* Set CAL[6:0] bits according to CalibrationValue value */
\r
174 tmpreg |= CalibrationValue;
\r
176 /* Store the new value */
\r
177 BKP->RTCCR = tmpreg;
\r
180 /*******************************************************************************
\r
181 * Function Name : BKP_WriteBackupRegister
\r
182 * Description : Writes user data to the specified Data Backup Register.
\r
183 * Input : - BKP_DR: specifies the Data Backup Register.
\r
184 * This parameter can be BKP_DRx where x:[1, 10]
\r
185 * - Data: data to write
\r
188 *******************************************************************************/
\r
189 void BKP_WriteBackupRegister(u16 BKP_DR, u16 Data)
\r
191 /* Check the parameters */
\r
192 assert(IS_BKP_DR(BKP_DR));
\r
194 *(vu16 *) (BKP_BASE + BKP_DR) = Data;
\r
197 /*******************************************************************************
\r
198 * Function Name : BKP_ReadBackupRegister
\r
199 * Description : Reads data from the specified Data Backup Register.
\r
200 * Input : - BKP_DR: specifies the Data Backup Register.
\r
201 * This parameter can be BKP_DRx where x:[1, 10]
\r
203 * Return : The content of the specified Data Backup Register
\r
204 *******************************************************************************/
\r
205 u16 BKP_ReadBackupRegister(u16 BKP_DR)
\r
207 /* Check the parameters */
\r
208 assert(IS_BKP_DR(BKP_DR));
\r
210 return (*(vu16 *) (BKP_BASE + BKP_DR));
\r
213 /*******************************************************************************
\r
214 * Function Name : BKP_GetFlagStatus
\r
215 * Description : Checks whether the Tamper Pin Event flag is set or not.
\r
218 * Return : The new state of the Tamper Pin Event flag (SET or RESET).
\r
219 *******************************************************************************/
\r
220 FlagStatus BKP_GetFlagStatus(void)
\r
222 return (FlagStatus)(*(vu32 *) CSR_TEF_BB);
\r
225 /*******************************************************************************
\r
226 * Function Name : BKP_ClearFlag
\r
227 * Description : Clears Tamper Pin Event pending flag.
\r
231 *******************************************************************************/
\r
232 void BKP_ClearFlag(void)
\r
234 /* Set CTE bit to clear Tamper Pin Event flag */
\r
235 BKP->CSR |= CSR_CTE_Set;
\r
238 /*******************************************************************************
\r
239 * Function Name : BKP_GetITStatus
\r
240 * Description : Checks whether the Tamper Pin Interrupt has occurred or not.
\r
243 * Return : The new state of the Tamper Pin Interrupt (SET or RESET).
\r
244 *******************************************************************************/
\r
245 ITStatus BKP_GetITStatus(void)
\r
247 return (ITStatus)(*(vu32 *) CSR_TIF_BB);
\r
250 /*******************************************************************************
\r
251 * Function Name : BKP_ClearITPendingBit
\r
252 * Description : Clears Tamper Pin Interrupt pending bit.
\r
256 *******************************************************************************/
\r
257 void BKP_ClearITPendingBit(void)
\r
259 /* Set CTI bit to clear Tamper Pin Interrupt pending bit */
\r
260 BKP->CSR |= CSR_CTI_Set;
\r
263 /******************* (C) COPYRIGHT 2007 STMicroelectronics *****END OF FILE****/
\r