219 lines
12 KiB
C
219 lines
12 KiB
C
|
/*!
|
||
|
|
\file gd32f30x_bkp.h
|
||
|
|
\brief definitions for the BKP
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
Copyright (C) 2017 GigaDevice
|
||
|
|
|
||
|
|
2017-02-10, V1.0.2, firmware for GD32F30x
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef GD32F30X_BKP_H
|
||
|
|
#define GD32F30X_BKP_H
|
||
|
|
|
||
|
|
#include "gd32f30x.h"
|
||
|
|
|
||
|
|
/* BKP definitions */
|
||
|
|
#define BKP BKP_BASE /*!< BKP base address */
|
||
|
|
|
||
|
|
/* registers definitions */
|
||
|
|
#define BKP_DATA0 REG16((BKP) + 0x04U) /*!< BKP data register 0 */
|
||
|
|
#define BKP_DATA1 REG16((BKP) + 0x08U) /*!< BKP data register 1 */
|
||
|
|
#define BKP_DATA2 REG16((BKP) + 0x0CU) /*!< BKP data register 2 */
|
||
|
|
#define BKP_DATA3 REG16((BKP) + 0x10U) /*!< BKP data register 3 */
|
||
|
|
#define BKP_DATA4 REG16((BKP) + 0x14U) /*!< BKP data register 4 */
|
||
|
|
#define BKP_DATA5 REG16((BKP) + 0x18U) /*!< BKP data register 5 */
|
||
|
|
#define BKP_DATA6 REG16((BKP) + 0x1CU) /*!< BKP data register 6 */
|
||
|
|
#define BKP_DATA7 REG16((BKP) + 0x20U) /*!< BKP data register 7 */
|
||
|
|
#define BKP_DATA8 REG16((BKP) + 0x24U) /*!< BKP data register 8 */
|
||
|
|
#define BKP_DATA9 REG16((BKP) + 0x28U) /*!< BKP data register 9 */
|
||
|
|
#define BKP_DATA10 REG16((BKP) + 0x40U) /*!< BKP data register 10 */
|
||
|
|
#define BKP_DATA11 REG16((BKP) + 0x44U) /*!< BKP data register 11 */
|
||
|
|
#define BKP_DATA12 REG16((BKP) + 0x48U) /*!< BKP data register 12 */
|
||
|
|
#define BKP_DATA13 REG16((BKP) + 0x4CU) /*!< BKP data register 13 */
|
||
|
|
#define BKP_DATA14 REG16((BKP) + 0x50U) /*!< BKP data register 14 */
|
||
|
|
#define BKP_DATA15 REG16((BKP) + 0x54U) /*!< BKP data register 15 */
|
||
|
|
#define BKP_DATA16 REG16((BKP) + 0x58U) /*!< BKP data register 16 */
|
||
|
|
#define BKP_DATA17 REG16((BKP) + 0x5CU) /*!< BKP data register 17 */
|
||
|
|
#define BKP_DATA18 REG16((BKP) + 0x60U) /*!< BKP data register 18 */
|
||
|
|
#define BKP_DATA19 REG16((BKP) + 0x64U) /*!< BKP data register 19 */
|
||
|
|
#define BKP_DATA20 REG16((BKP) + 0x68U) /*!< BKP data register 20 */
|
||
|
|
#define BKP_DATA21 REG16((BKP) + 0x6CU) /*!< BKP data register 21 */
|
||
|
|
#define BKP_DATA22 REG16((BKP) + 0x70U) /*!< BKP data register 22 */
|
||
|
|
#define BKP_DATA23 REG16((BKP) + 0x74U) /*!< BKP data register 23 */
|
||
|
|
#define BKP_DATA24 REG16((BKP) + 0x78U) /*!< BKP data register 24 */
|
||
|
|
#define BKP_DATA25 REG16((BKP) + 0x7CU) /*!< BKP data register 25 */
|
||
|
|
#define BKP_DATA26 REG16((BKP) + 0x80U) /*!< BKP data register 26 */
|
||
|
|
#define BKP_DATA27 REG16((BKP) + 0x84U) /*!< BKP data register 27 */
|
||
|
|
#define BKP_DATA28 REG16((BKP) + 0x88U) /*!< BKP data register 28 */
|
||
|
|
#define BKP_DATA29 REG16((BKP) + 0x8CU) /*!< BKP data register 29 */
|
||
|
|
#define BKP_DATA30 REG16((BKP) + 0x90U) /*!< BKP data register 30 */
|
||
|
|
#define BKP_DATA31 REG16((BKP) + 0x94U) /*!< BKP data register 31 */
|
||
|
|
#define BKP_DATA32 REG16((BKP) + 0x98U) /*!< BKP data register 32 */
|
||
|
|
#define BKP_DATA33 REG16((BKP) + 0x9CU) /*!< BKP data register 33 */
|
||
|
|
#define BKP_DATA34 REG16((BKP) + 0xA0U) /*!< BKP data register 34 */
|
||
|
|
#define BKP_DATA35 REG16((BKP) + 0xA4U) /*!< BKP data register 35 */
|
||
|
|
#define BKP_DATA36 REG16((BKP) + 0xA8U) /*!< BKP data register 36 */
|
||
|
|
#define BKP_DATA37 REG16((BKP) + 0xACU) /*!< BKP data register 37 */
|
||
|
|
#define BKP_DATA38 REG16((BKP) + 0xB0U) /*!< BKP data register 38 */
|
||
|
|
#define BKP_DATA39 REG16((BKP) + 0xB4U) /*!< BKP data register 39 */
|
||
|
|
#define BKP_DATA40 REG16((BKP) + 0xB8U) /*!< BKP data register 40 */
|
||
|
|
#define BKP_DATA41 REG16((BKP) + 0xBCU) /*!< BKP data register 41 */
|
||
|
|
#define BKP_OCTL REG16((BKP) + 0x2CU) /*!< RTC signal output control register */
|
||
|
|
#define BKP_TPCTL REG16((BKP) + 0x30U) /*!< tamper pin control register */
|
||
|
|
#define BKP_TPCS REG16((BKP) + 0x34U) /*!< tamper control and status register */
|
||
|
|
|
||
|
|
/* bits definitions */
|
||
|
|
/* BKP_DATA */
|
||
|
|
#define BKP_DATA BITS(0,15) /*!< backup data */
|
||
|
|
|
||
|
|
/* BKP_OCTL */
|
||
|
|
#define BKP_OCTL_RCCV BITS(0,6) /*!< RTC clock calibration value */
|
||
|
|
#define BKP_OCTL_COEN BIT(7) /*!< RTC clock calibration output enable */
|
||
|
|
#define BKP_OCTL_ASOEN BIT(8) /*!< RTC alarm or second signal output enable */
|
||
|
|
#define BKP_OCTL_ROSEL BIT(9) /*!< RTC output selection */
|
||
|
|
#define BKP_OCTL_CCOSEL BIT(14) /*!< RTC clock output selection */
|
||
|
|
#define BKP_OCTL_CALDIR BIT(15) /*!< RTC clock calibration direction */
|
||
|
|
|
||
|
|
/* BKP_TPCTL */
|
||
|
|
#define BKP_TPCTL_TPEN BIT(0) /*!< tamper detection enable */
|
||
|
|
#define BKP_TPCTL_TPAL BIT(1) /*!< tamper pin active level */
|
||
|
|
|
||
|
|
/* BKP_TPCS */
|
||
|
|
#define BKP_TPCS_TER BIT(0) /*!< tamper event reset */
|
||
|
|
#define BKP_TPCS_TIR BIT(1) /*!< tamper interrupt reset */
|
||
|
|
#define BKP_TPCS_TPIE BIT(2) /*!< tamper interrupt enable */
|
||
|
|
#define BKP_TPCS_TEF BIT(8) /*!< tamper event flag */
|
||
|
|
#define BKP_TPCS_TIF BIT(9) /*!< tamper interrupt flag */
|
||
|
|
|
||
|
|
/* constants definitions */
|
||
|
|
/* BKP register */
|
||
|
|
#define BKP_DATA0_9(number) REG16((BKP) + 0x04U + (number) * 0x04U)
|
||
|
|
#define BKP_DATA10_41(number) REG16((BKP) + 0x40U + ((number)-10U) * 0x04U)
|
||
|
|
|
||
|
|
/* get data of BKP data register */
|
||
|
|
#define BKP_DATA_GET(regval) GET_BITS((uint32_t)(regval), 0, 15)
|
||
|
|
|
||
|
|
/* RTC clock calibration value */
|
||
|
|
#define OCTL_RCCV(regval) (BITS(0,6) & ((uint32_t)(regval) << 0))
|
||
|
|
|
||
|
|
/* RTC output selection */
|
||
|
|
#define RTC_OUTPUT_ALARM_PULSE ((uint16_t)0x0000U) /*!< RTC alarm pulse is selected as the RTC output */
|
||
|
|
#define RTC_OUTPUT_SECOND_PULSE ((uint16_t)0x0200U) /*!< RTC second pulse is selected as the RTC output */
|
||
|
|
|
||
|
|
/* RTC clock output selection */
|
||
|
|
#define RTC_CLOCK_DIV_64 ((uint16_t)0x0000U) /*!< RTC clock div 64 */
|
||
|
|
#define RTC_CLOCK_DIV_1 ((uint16_t)0x4000U) /*!< RTC clock div 1 */
|
||
|
|
|
||
|
|
/* RTC clock calibration direction */
|
||
|
|
#define RTC_CLOCK_SLOWED_DOWN ((uint16_t)0x0000U) /*!< RTC clock slow down */
|
||
|
|
#define RTC_CLOCK_SPEED_UP ((uint16_t)0x8000U) /*!< RTC clock speed up */
|
||
|
|
|
||
|
|
/* tamper pin active level */
|
||
|
|
#define TAMPER_PIN_ACTIVE_HIGH ((uint16_t)0x0000U) /*!< the tamper pin is active high */
|
||
|
|
#define TAMPER_PIN_ACTIVE_LOW ((uint16_t)0x0002U) /*!< the tamper pin is active low */
|
||
|
|
|
||
|
|
/* tamper flag */
|
||
|
|
#define BKP_FLAG_TAMPER BKP_TPCS_TEF /*!< tamper event flag */
|
||
|
|
|
||
|
|
/* tamper interrupt flag */
|
||
|
|
#define BKP_INT_FLAG_TAMPER BKP_TPCS_TIF /*!< tamper interrupt flag */
|
||
|
|
|
||
|
|
/* BKP data register number */
|
||
|
|
typedef enum
|
||
|
|
{
|
||
|
|
BKP_DATA_0 = 1, /*!< BKP data register 0 */
|
||
|
|
BKP_DATA_1, /*!< BKP data register 1 */
|
||
|
|
BKP_DATA_2, /*!< BKP data register 2 */
|
||
|
|
BKP_DATA_3, /*!< BKP data register 3 */
|
||
|
|
BKP_DATA_4, /*!< BKP data register 4 */
|
||
|
|
BKP_DATA_5, /*!< BKP data register 5 */
|
||
|
|
BKP_DATA_6, /*!< BKP data register 6 */
|
||
|
|
BKP_DATA_7, /*!< BKP data register 7 */
|
||
|
|
BKP_DATA_8, /*!< BKP data register 8 */
|
||
|
|
BKP_DATA_9, /*!< BKP data register 9 */
|
||
|
|
BKP_DATA_10, /*!< BKP data register 10 */
|
||
|
|
BKP_DATA_11, /*!< BKP data register 11 */
|
||
|
|
BKP_DATA_12, /*!< BKP data register 12 */
|
||
|
|
BKP_DATA_13, /*!< BKP data register 13 */
|
||
|
|
BKP_DATA_14, /*!< BKP data register 14 */
|
||
|
|
BKP_DATA_15, /*!< BKP data register 15 */
|
||
|
|
BKP_DATA_16, /*!< BKP data register 16 */
|
||
|
|
BKP_DATA_17, /*!< BKP data register 17 */
|
||
|
|
BKP_DATA_18, /*!< BKP data register 18 */
|
||
|
|
BKP_DATA_19, /*!< BKP data register 19 */
|
||
|
|
BKP_DATA_20, /*!< BKP data register 20 */
|
||
|
|
BKP_DATA_21, /*!< BKP data register 21 */
|
||
|
|
BKP_DATA_22, /*!< BKP data register 22 */
|
||
|
|
BKP_DATA_23, /*!< BKP data register 23 */
|
||
|
|
BKP_DATA_24, /*!< BKP data register 24 */
|
||
|
|
BKP_DATA_25, /*!< BKP data register 25 */
|
||
|
|
BKP_DATA_26, /*!< BKP data register 26 */
|
||
|
|
BKP_DATA_27, /*!< BKP data register 27 */
|
||
|
|
BKP_DATA_28, /*!< BKP data register 28 */
|
||
|
|
BKP_DATA_29, /*!< BKP data register 29 */
|
||
|
|
BKP_DATA_30, /*!< BKP data register 30 */
|
||
|
|
BKP_DATA_31, /*!< BKP data register 31 */
|
||
|
|
BKP_DATA_32, /*!< BKP data register 32 */
|
||
|
|
BKP_DATA_33, /*!< BKP data register 33 */
|
||
|
|
BKP_DATA_34, /*!< BKP data register 34 */
|
||
|
|
BKP_DATA_35, /*!< BKP data register 35 */
|
||
|
|
BKP_DATA_36, /*!< BKP data register 36 */
|
||
|
|
BKP_DATA_37, /*!< BKP data register 37 */
|
||
|
|
BKP_DATA_38, /*!< BKP data register 38 */
|
||
|
|
BKP_DATA_39, /*!< BKP data register 39 */
|
||
|
|
BKP_DATA_40, /*!< BKP data register 40 */
|
||
|
|
BKP_DATA_41, /*!< BKP data register 41 */
|
||
|
|
}bkp_data_register_enum;
|
||
|
|
|
||
|
|
/* function declarations */
|
||
|
|
/* reset BKP registers */
|
||
|
|
void bkp_deinit(void);
|
||
|
|
/* write BKP data register */
|
||
|
|
void bkp_write_data(bkp_data_register_enum register_number, uint16_t data);
|
||
|
|
/* read BKP data register */
|
||
|
|
uint16_t bkp_read_data(bkp_data_register_enum register_number);
|
||
|
|
|
||
|
|
/* RTC related functions */
|
||
|
|
/* enable RTC clock calibration output */
|
||
|
|
void bkp_rtc_calibration_output_enable(void);
|
||
|
|
/* disable RTC clock calibration output */
|
||
|
|
void bkp_rtc_calibration_output_disable(void);
|
||
|
|
/* enable RTC alarm or second signal output */
|
||
|
|
void bkp_rtc_signal_output_enable(void);
|
||
|
|
/* disable RTC alarm or second signal output */
|
||
|
|
void bkp_rtc_signal_output_disable(void);
|
||
|
|
/* RTC output selection */
|
||
|
|
void bkp_rtc_output_select(uint16_t outputsel);
|
||
|
|
/* RTC clock output selection */
|
||
|
|
void bkp_rtc_clock_output_select(uint16_t clocksel);
|
||
|
|
/* RTC clock calibration direction */
|
||
|
|
void bkp_rtc_clock_calibration_direction(uint16_t direction);
|
||
|
|
/* set RTC clock calibration value */
|
||
|
|
void bkp_rtc_calibration_value_set(uint8_t value);
|
||
|
|
|
||
|
|
/* tamper pin related functions */
|
||
|
|
/* enable tamper pin detection */
|
||
|
|
void bkp_tamper_detection_enable(void);
|
||
|
|
/* disable tamper pin detection */
|
||
|
|
void bkp_tamper_detection_disable(void);
|
||
|
|
/* set tamper pin active level */
|
||
|
|
void bkp_tamper_active_level_set(uint16_t level);
|
||
|
|
/* enable tamper pin interrupt */
|
||
|
|
void bkp_tamper_interrupt_enable(void);
|
||
|
|
/* disable tamper pin interrupt */
|
||
|
|
void bkp_tamper_interrupt_disable(void);
|
||
|
|
|
||
|
|
/* flag functions */
|
||
|
|
/* get BKP flag state */
|
||
|
|
FlagStatus bkp_flag_get(uint16_t flag);
|
||
|
|
/* clear BKP flag state */
|
||
|
|
void bkp_flag_clear(uint16_t flag);
|
||
|
|
/* get BKP interrupt flag state */
|
||
|
|
FlagStatus bkp_interrupt_flag_get(uint16_t flag);
|
||
|
|
/* clear BKP interrupt flag state */
|
||
|
|
void bkp_interrupt_flag_clear(uint16_t flag);
|
||
|
|
|
||
|
|
#endif /* GD32F30X_BKP_H */
|