1 /********************************** (C) COPYRIGHT  *******************************
2  * File Name          : ch32v10x_bkp.h
3  * Author             : WCH
4  * Version            : V1.0.0
5  * Date               : 2020/04/30
6  * Description        : This file contains all the functions prototypes for the
7  *                      BKP firmware library.
8  * Copyright (c) 2021 Nanjing Qinheng Microelectronics Co., Ltd.
9  * SPDX-License-Identifier: Apache-2.0
10  *******************************************************************************/
11 #ifndef __CH32V10x_BKP_H
12 #define __CH32V10x_BKP_H
13 
14 #ifdef __cplusplus
15 extern "C" {
16 #endif
17 
18 #include "ch32v10x.h"
19 
20 /* Tamper_Pin_active_level */
21 #define BKP_TamperPinLevel_High           ((uint16_t)0x0000)
22 #define BKP_TamperPinLevel_Low            ((uint16_t)0x0001)
23 
24 /* RTC_output_source_to_output_on_the_Tamper_pin */
25 #define BKP_RTCOutputSource_None          ((uint16_t)0x0000)
26 #define BKP_RTCOutputSource_CalibClock    ((uint16_t)0x0080)
27 #define BKP_RTCOutputSource_Alarm         ((uint16_t)0x0100)
28 #define BKP_RTCOutputSource_Second        ((uint16_t)0x0300)
29 
30 /* Data_Backup_Register */
31 #define BKP_DR1                           ((uint16_t)0x0004)
32 #define BKP_DR2                           ((uint16_t)0x0008)
33 #define BKP_DR3                           ((uint16_t)0x000C)
34 #define BKP_DR4                           ((uint16_t)0x0010)
35 #define BKP_DR5                           ((uint16_t)0x0014)
36 #define BKP_DR6                           ((uint16_t)0x0018)
37 #define BKP_DR7                           ((uint16_t)0x001C)
38 #define BKP_DR8                           ((uint16_t)0x0020)
39 #define BKP_DR9                           ((uint16_t)0x0024)
40 #define BKP_DR10                          ((uint16_t)0x0028)
41 #define BKP_DR11                          ((uint16_t)0x0040)
42 #define BKP_DR12                          ((uint16_t)0x0044)
43 #define BKP_DR13                          ((uint16_t)0x0048)
44 #define BKP_DR14                          ((uint16_t)0x004C)
45 #define BKP_DR15                          ((uint16_t)0x0050)
46 #define BKP_DR16                          ((uint16_t)0x0054)
47 #define BKP_DR17                          ((uint16_t)0x0058)
48 #define BKP_DR18                          ((uint16_t)0x005C)
49 #define BKP_DR19                          ((uint16_t)0x0060)
50 #define BKP_DR20                          ((uint16_t)0x0064)
51 #define BKP_DR21                          ((uint16_t)0x0068)
52 #define BKP_DR22                          ((uint16_t)0x006C)
53 #define BKP_DR23                          ((uint16_t)0x0070)
54 #define BKP_DR24                          ((uint16_t)0x0074)
55 #define BKP_DR25                          ((uint16_t)0x0078)
56 #define BKP_DR26                          ((uint16_t)0x007C)
57 #define BKP_DR27                          ((uint16_t)0x0080)
58 #define BKP_DR28                          ((uint16_t)0x0084)
59 #define BKP_DR29                          ((uint16_t)0x0088)
60 #define BKP_DR30                          ((uint16_t)0x008C)
61 #define BKP_DR31                          ((uint16_t)0x0090)
62 #define BKP_DR32                          ((uint16_t)0x0094)
63 #define BKP_DR33                          ((uint16_t)0x0098)
64 #define BKP_DR34                          ((uint16_t)0x009C)
65 #define BKP_DR35                          ((uint16_t)0x00A0)
66 #define BKP_DR36                          ((uint16_t)0x00A4)
67 #define BKP_DR37                          ((uint16_t)0x00A8)
68 #define BKP_DR38                          ((uint16_t)0x00AC)
69 #define BKP_DR39                          ((uint16_t)0x00B0)
70 #define BKP_DR40                          ((uint16_t)0x00B4)
71 #define BKP_DR41                          ((uint16_t)0x00B8)
72 #define BKP_DR42                          ((uint16_t)0x00BC)
73 
74 void       BKP_DeInit(void);
75 void       BKP_TamperPinLevelConfig(uint16_t BKP_TamperPinLevel);
76 void       BKP_TamperPinCmd(FunctionalState NewState);
77 void       BKP_ITConfig(FunctionalState NewState);
78 void       BKP_RTCOutputConfig(uint16_t BKP_RTCOutputSource);
79 void       BKP_SetRTCCalibrationValue(uint8_t CalibrationValue);
80 void       BKP_WriteBackupRegister(uint16_t BKP_DR, uint16_t Data);
81 uint16_t   BKP_ReadBackupRegister(uint16_t BKP_DR);
82 FlagStatus BKP_GetFlagStatus(void);
83 void       BKP_ClearFlag(void);
84 ITStatus   BKP_GetITStatus(void);
85 void       BKP_ClearITPendingBit(void);
86 
87 #ifdef __cplusplus
88 }
89 #endif
90 
91 #endif /* __CH32V10x_BKP_H */
92