| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536 |
- /*!
- \file gd32f3x0_rtc.h
- \brief definitions for the RTC
- */
- /*
- Copyright (C) 2017 GigaDevice
- 2017-06-06, V1.0.0, firmware for GD32F3x0
- */
- #ifndef GD32F3X0_RTC_H
- #define GD32F3X0_RTC_H
- #include "gd32f3x0.h"
- /* RTC definitions */
- #define RTC RTC_BASE
- /* registers definitions */
- #define RTC_TIME REG32((RTC) + 0x00U) /*!< RTC time of day register */
- #define RTC_DATE REG32((RTC) + 0x04U) /*!< RTC date register */
- #define RTC_CTL REG32((RTC) + 0x08U) /*!< RTC control register */
- #define RTC_STAT REG32((RTC) + 0x0CU) /*!< RTC status register */
- #define RTC_PSC REG32((RTC) + 0x10U) /*!< RTC time prescaler register */
- #define RTC_ALRM0TD REG32((RTC) + 0x1CU) /*!< RTC alarm 0 time and date register */
- #define RTC_WPK REG32((RTC) + 0x24U) /*!< RTC write protection key register */
- #define RTC_SS REG32((RTC) + 0x28U) /*!< RTC sub second register */
- #define RTC_SHIFTCTL REG32((RTC) + 0x2CU) /*!< RTC shift function control register */
- #define RTC_TTS REG32((RTC) + 0x30U) /*!< RTC time of timestamp register */
- #define RTC_DTS REG32((RTC) + 0x34U) /*!< RTC date of timestamp register */
- #define RTC_SSTS REG32((RTC) + 0x38U) /*!< RTC sub second of timestamp register */
- #define RTC_HRFC REG32((RTC) + 0x3CU) /*!< RTC high resolution frequency compensation registor */
- #define RTC_TAMP REG32((RTC) + 0x40U) /*!< RTC tamper register */
- #define RTC_ALRM0SS REG32((RTC) + 0x44U) /*!< RTC alarm 0 sub second register */
- #define RTC_BKP0 REG32((RTC) + 0x50U) /*!< RTC backup 0 register */
- #define RTC_BKP1 REG32((RTC) + 0x54U) /*!< RTC backup 1 register */
- #define RTC_BKP2 REG32((RTC) + 0x58U) /*!< RTC backup 2 register */
- #define RTC_BKP3 REG32((RTC) + 0x5CU) /*!< RTC backup 3 register */
- #define RTC_BKP4 REG32((RTC) + 0x60U) /*!< RTC backup 4 register */
- /* bits definitions */
- /* RTC_TIME */
- #define RTC_TIME_SCU BITS(0,3) /*!< second units in BCD code */
- #define RTC_TIME_SCT BITS(4,6) /*!< second tens in BCD code */
- #define RTC_TIME_MNU BITS(8,11) /*!< minute units in BCD code */
- #define RTC_TIME_MNT BITS(12,14) /*!< minute tens in BCD code */
- #define RTC_TIME_HRU BITS(16,19) /*!< hour units in BCD code */
- #define RTC_TIME_HRT BITS(20,21) /*!< hour tens in BCD code */
- #define RTC_TIME_PM BIT(22) /*!< AM/PM notation */
- /* RTC_DATE */
- #define RTC_DATE_DAYU BITS(0,3) /*!< date units in BCD code */
- #define RTC_DATE_DAYT BITS(4,5) /*!< date tens in BCD code */
- #define RTC_DATE_MONU BITS(8,11) /*!< month units in BCD code */
- #define RTC_DATE_MONT BIT(12) /*!< month tens in BCD code */
- #define RTC_DATE_DOW BITS(13,15) /*!< day of week units */
- #define RTC_DATE_YRU BITS(16,19) /*!< year units in BCD code */
- #define RTC_DATE_YRT BITS(20,23) /*!< year tens in BCD code */
- /* RTC_CTL */
- #define RTC_CTL_TSEG BIT(3) /*!< valid event edge of time-stamp */
- #define RTC_CTL_REFEN BIT(4) /*!< reference clock detection function enable */
- #define RTC_CTL_BPSHAD BIT(5) /*!< shadow registers bypass control */
- #define RTC_CTL_CS BIT(6) /*!< display format of clock system */
- #define RTC_CTL_ALRM0EN BIT(8) /*!< alarm function enable */
- #define RTC_CTL_TSEN BIT(11) /*!< time-stamp function enable */
- #define RTC_CTL_ALRM0IE BIT(12) /*!< RTC alarm interrupt enable */
- #define RTC_CTL_TSIE BIT(15) /*!< time-stamp interrupt enable */
- #define RTC_CTL_A1H BIT(16) /*!< add 1 hour(summer time change) */
- #define RTC_CTL_S1H BIT(17) /*!< subtract 1 hour(winter time change) */
- #define RTC_CTL_DSM BIT(18) /*!< daylight saving mark */
- #define RTC_CTL_COS BIT(19) /*!< calibration output selection */
- #define RTC_CTL_OPOL BIT(20) /*!< output polarity */
- #define RTC_CTL_OS BITS(21,22) /*!< output selection */
- #define RTC_CTL_COEN BIT(23) /*!< calibration output enable */
- /* RTC_STAT */
- #define RTC_STAT_ALRM0WF BIT(0) /*!< alarm configuration can be write flag */
- #define RTC_STAT_SOPF BIT(3) /*!< shift function operation pending flag */
- #define RTC_STAT_YCM BIT(4) /*!< year configuration mark status flag */
- #define RTC_STAT_RSYNF BIT(5) /*!< register synchronization flag */
- #define RTC_STAT_INITF BIT(6) /*!< initialization state flag */
- #define RTC_STAT_INITM BIT(7) /*!< enter initialization mode */
- #define RTC_STAT_ALRM0F BIT(8) /*!< alarm occurs flag */
- #define RTC_STAT_TSF BIT(11) /*!< time-stamp flag */
- #define RTC_STAT_TSOVRF BIT(12) /*!< time-stamp overflow flag */
- #define RTC_STAT_TP0F BIT(13) /*!< RTC tamp 0 detected flag */
- #define RTC_STAT_TP1F BIT(14) /*!< RTC tamp 1 detected flag */
- #define RTC_STAT_SCPF BIT(16) /*!< recalibration pending flag */
- /* RTC_PSC */
- #define RTC_PSC_FACTOR_S BITS(0,14) /*!< synchronous prescaler factor */
- #define RTC_PSC_FACTOR_A BITS(16,22) /*!< asynchronous prescaler factor */
- /* RTC_ALRM0TD */
- #define RTC_ALRM0TD_SCU BITS(0,3) /*!< second units in BCD code */
- #define RTC_ALRM0TD_SCT BITS(4,6) /*!< second tens in BCD code */
- #define RTC_ALRM0TD_MSKS BIT(7) /*!< alarm second mask bit */
- #define RTC_ALRM0TD_MNU BITS(8,11) /*!< minutes units in BCD code */
- #define RTC_ALRM0TD_MNT BITS(12,14) /*!< minutes tens in BCD code */
- #define RTC_ALRM0TD_MSKM BIT(15) /*!< alarm minutes mask bit */
- #define RTC_ALRM0TD_HRU BITS(16,19) /*!< hour units in BCD code */
- #define RTC_ALRM0TD_HRT BITS(20,21) /*!< hour units in BCD code */
- #define RTC_ALRM0TD_PM BIT(22) /*!< AM/PM flag */
- #define RTC_ALRM0TD_MSKH BIT(23) /*!< alarm hour mask bit */
- #define RTC_ALRM0TD_DAYU BITS(24,27) /*!< date units or week day in BCD code */
- #define RTC_ALRM0TD_DAYT BITS(28,29) /*!< date tens in BCD code */
- #define RTC_ALRM0TD_DOWS BIT(30) /*!< day of week selection */
- #define RTC_ALRM0TD_MSKD BIT(31) /*!< alarm date mask bit */
- /* RTC_WPK */
- #define RTC_WPK_WPK BITS(0,7) /*!< key for write protection */
- /* RTC_SS */
- #define RTC_SS_SSC BITS(0,15) /*!< sub second value */
- /* RTC_SHIFTCTL */
- #define RTC_SHIFTCTL_SFS BITS(0,14) /*!< subtract a fraction of a second */
- #define RTC_SHIFTCTL_A1S BIT(31) /*!< one second add */
- /* RTC_TTS */
- #define RTC_TTS_SCU BITS(0,3) /*!< second units in BCD code */
- #define RTC_TTS_SCT BITS(4,6) /*!< second units in BCD code */
- #define RTC_TTS_MNU BITS(8,11) /*!< minute units in BCD code */
- #define RTC_TTS_MNT BITS(12,14) /*!< minute tens in BCD code */
- #define RTC_TTS_HRU BITS(16,19) /*!< hour units in BCD code */
- #define RTC_TTS_HRT BITS(20,21) /*!< hour tens in BCD code */
- #define RTC_TTS_PM BIT(22) /*!< AM/PM notation */
- /* RTC_DTS */
- #define RTC_DTS_DAYU BITS(0,3) /*!< date units in BCD code */
- #define RTC_DTS_DAYT BITS(4,5) /*!< date tens in BCD code */
- #define RTC_DTS_MONU BITS(8,11) /*!< month units in BCD code */
- #define RTC_DTS_MONT BIT(12) /*!< month tens in BCD code */
- #define RTC_DTS_DOW BITS(13,15) /*!< day of week units */
- /* RTC_SSTS */
- #define RTC_SSTS_SSC BITS(0,15) /*!< timestamp sub second units */
- /* RTC_HRFC */
- #define RTC_HRFC_CMSK BITS(0,8) /*!< calibration mask number */
- #define RTC_HRFC_CWND16 BIT(13) /*!< calibration window select 16 seconds */
- #define RTC_HRFC_CWND8 BIT(14) /*!< calibration window select 16 seconds */
- #define RTC_HRFC_FREQI BIT(15) /*!< increase RTC frequency by 488.5ppm */
- /* RTC_TAMP */
- #define RTC_TAMP_TP0EN BIT(0) /*!< tamper 0 detection enable */
- #define RTC_TAMP_TP0EG BIT(1) /*!< tamper 0 event trigger edge for RTC tamp 0 input */
- #define RTC_TAMP_TPIE BIT(2) /*!< tamper detection interrupt enable */
- #define RTC_TAMP_TP1EN BIT(3) /*!< tamper 1 detection enable */
- #define RTC_TAMP_TP1EG BIT(4) /*!< tamper 1 event trigger edge for RTC tamp 1 input */
- #define RTC_TAMP_TPTS BIT(7) /*!< make tamper function used for timestamp function */
- #define RTC_TAMP_FREQ BITS(8,10) /*!< sample frequency of tamper event detection */
- #define RTC_TAMP_FLT BITS(11,12) /*!< RTC tamp x filter count setting */
- #define RTC_TAMP_PRCH BITS(13,14) /*!< precharge duration time of RTC tamp x */
- #define RTC_TAMP_DISPU BIT(15) /*!< RTC tamp x pull up disable bit */
- #define RTC_TAMP_PC13VAL BIT(18) /*!< alarm output type control/PC13 output value */
- #define RTC_TAMP_PC13MDE BIT(19) /*!< PC13 mode */
- #define RTC_TAMP_PC14VAL BIT(20) /*!< PC14 output value */
- #define RTC_TAMP_PC14MDE BIT(21) /*!< PC14 mode */
- #define RTC_TAMP_PC15VAL BIT(22) /*!< PC15 output value */
- #define RTC_TAMP_PC15MDE BIT(23) /*!< PC15 mode */
- /* RTC_ALRM0SS */
- #define RTC_ALRM0SS_SSC BITS(0,14) /*!< alarm sub second value */
- #define RTC_ALRM0SS_MASKSSC BITS(24,27) /*!< mask control bit of SS */
- /* RTC_BKP0 */
- #define RTC_BKP0_DATA BITS(0,31) /*!< backup domain registers */
- /* RTC_BKP1 */
- #define RTC_BKP1_DATA BITS(0,31) /*!< backup domain registers */
- /* RTC_BKP2 */
- #define RTC_BKP2_DATA BITS(0,31) /*!< backup domain registers */
- /* RTC_BKP3 */
- #define RTC_BKP3_DATA BITS(0,31) /*!< backup domain registers */
- /* RTC_BKP4 */
- #define RTC_BKP4_DATA BITS(0,31) /*!< backup domain registers */
- /* constants definitions */
- /* structure for initialization of the RTC */
- typedef struct
- {
- uint8_t rtc_year; /*!< RTC year value: 0x0 - 0x99(BCD format) */
- uint8_t rtc_month; /*!< RTC month value */
- uint8_t rtc_date; /*!< RTC date value: 0x1 - 0x31(BCD format) */
- uint8_t rtc_day_of_week; /*!< RTC weekday value */
- uint8_t rtc_hour; /*!< RTC hour value */
- uint8_t rtc_minute; /*!< RTC minute value: 0x0 - 0x59(BCD format) */
- uint8_t rtc_second; /*!< RTC second value: 0x0 - 0x59(BCD format) */
- uint16_t rtc_factor_asyn; /*!< RTC asynchronous prescaler value: 0x0 - 0x7F */
- uint16_t rtc_factor_syn; /*!< RTC synchronous prescaler value: 0x0 - 0x7FFF */
- uint32_t rtc_am_pm; /*!< RTC AM/PM value */
- uint32_t rtc_display_format; /*!< RTC time notation */
- }rtc_parameter_struct;
- /* structure for RTC alarm configuration */
- typedef struct
- {
- uint32_t rtc_alarm_mask; /*!< RTC alarm mask */
- uint32_t rtc_weekday_or_date; /*!< specify RTC alarm is on date or weekday */
- uint8_t rtc_alarm_day; /*!< RTC alarm date or weekday value*/
- uint8_t rtc_alarm_hour; /*!< RTC alarm hour value */
- uint8_t rtc_alarm_minute; /*!< RTC alarm minute value: 0x0 - 0x59(BCD format) */
- uint8_t rtc_alarm_second; /*!< RTC alarm second value: 0x0 - 0x59(BCD format) */
- uint32_t rtc_am_pm; /*!< RTC alarm AM/PM value */
- }rtc_alarm_struct;
- /* structure for RTC time-stamp configuration */
- typedef struct
- {
- uint8_t rtc_timestamp_month; /*!< RTC time-stamp month value */
- uint8_t rtc_timestamp_date; /*!< RTC time-stamp date value: 0x1 - 0x31(BCD format) */
- uint8_t rtc_timestamp_day; /*!< RTC time-stamp weekday value */
- uint8_t rtc_timestamp_hour; /*!< RTC time-stamp hour value */
- uint8_t rtc_timestamp_minute; /*!< RTC time-stamp minute value: 0x0 - 0x59(BCD format) */
- uint8_t rtc_timestamp_second; /*!< RTC time-stamp second value: 0x0 - 0x59(BCD format) */
- uint32_t rtc_am_pm; /*!< RTC time-stamp AM/PM value */
- }rtc_timestamp_struct;
- /* structure for RTC tamper configuration */
- typedef struct
- {
- uint32_t rtc_tamper_source; /*!< RTC tamper source */
- uint32_t rtc_tamper_trigger; /*!< RTC tamper trigger */
- uint32_t rtc_tamper_filter; /*!< RTC tamper consecutive samples needed during a voltage level detection */
- uint32_t rtc_tamper_sample_frequency; /*!< RTC tamper sampling frequency during a voltage level detection */
- ControlStatus rtc_tamper_precharge_enable; /*!< RTC tamper precharge feature during a voltage level detection */
- uint32_t rtc_tamper_precharge_time; /*!< RTC tamper precharge duration if precharge feature is enabled */
- ControlStatus rtc_tamper_with_timestamp; /*!< RTC tamper time-stamp feature */
- }rtc_tamper_struct;
- /* time register value */
- #define TIME_SC(regval) (BITS(0,6) & ((uint32_t)(regval) << 0U)) /*!< write value to RTC_TIME_SC bit field */
- #define GET_TIME_SC(regval) GET_BITS((regval),0,6) /*!< get value of RTC_TIME_SC bit field */
- #define TIME_MN(regval) (BITS(8,14) & ((uint32_t)(regval) << 8U)) /*!< write value to RTC_TIME_MN bit field */
- #define GET_TIME_MN(regval) GET_BITS((regval),8,14) /*!< get value of RTC_TIME_MN bit field */
- #define TIME_HR(regval) (BITS(16,21) & ((uint32_t)(regval) << 16U)) /*!< write value to RTC_TIME_HR bit field */
- #define GET_TIME_HR(regval) GET_BITS((regval),16,21) /*!< get value of RTC_TIME_HR bit field */
- #define RTC_AM ((uint32_t)0x00000000U) /*!< AM format */
- #define RTC_PM RTC_TIME_PM /*!< PM format */
- /* date register value */
- #define DATE_DAY(regval) (BITS(0,5) & ((uint32_t)(regval) << 0U)) /*!< write value to RTC_DATE_DAY bit field */
- #define GET_DATE_DAY(regval) GET_BITS((regval),0,5) /*!< get value of RTC_DATE_DAY bit field */
- #define DATE_MON(regval) (BITS(8,12) & ((uint32_t)(regval) << 8U)) /*!< write value to RTC_DATE_MON bit field */
- #define GET_DATE_MON(regval) GET_BITS((regval),8,12) /*!< get value of RTC_DATE_MON bit field */
- #define RTC_JAN ((uint8_t)0x01U) /*!< Janurary */
- #define RTC_FEB ((uint8_t)0x02U) /*!< February */
- #define RTC_MAR ((uint8_t)0x03U) /*!< March */
- #define RTC_APR ((uint8_t)0x04U) /*!< April */
- #define RTC_MAY ((uint8_t)0x05U) /*!< May */
- #define RTC_JUN ((uint8_t)0x06U) /*!< June */
- #define RTC_JUL ((uint8_t)0x07U) /*!< July */
- #define RTC_AUG ((uint8_t)0x08U) /*!< August */
- #define RTC_SEP ((uint8_t)0x09U) /*!< September */
- #define RTC_OCT ((uint8_t)0x10U) /*!< October */
- #define RTC_NOV ((uint8_t)0x11U) /*!< November */
- #define RTC_DEC ((uint8_t)0x12U) /*!< December */
- #define DATE_DOW(regval) (BITS(13,15) & ((uint32_t)(regval) << 13U)) /*!< write value to RTC_DATE_DOW bit field */
- #define GET_DATE_DOW(regval) GET_BITS((regval),13,15) /*!< get value of RTC_DATE_DOW bit field */
- #define RTC_MONDAY ((uint8_t)0x01U) /*!< Monday */
- #define RTC_TUESDAY ((uint8_t)0x02U) /*!< Tuesday */
- #define RTC_WEDSDAY ((uint8_t)0x03U) /*!< Wednesday */
- #define RTC_THURSDAY ((uint8_t)0x04U) /*!< Thursday */
- #define RTC_FRIDAY ((uint8_t)0x05U) /*!< Friday */
- #define RTC_SATURDAY ((uint8_t)0x06U) /*!< Saturday */
- #define RTC_SUNDAY ((uint8_t)0x07U) /*!< Sunday */
- #define DATE_YR(regval) (BITS(16,23) & ((uint32_t)(regval) << 16U)) /*!< write value to RTC_DATE_YR bit field */
- #define GET_DATE_YR(regval) GET_BITS((regval),16,23) /*!< get value of RTC_DATE_YR bit field */
- /* ctl register value */
- #define CTL_OS(regval) (BITS(21,22) & ((uint32_t)(regval) << 21U)) /*!< write value to RTC_CTL_OS bit field */
- #define RTC_OS_DISABLE CTL_OS(0) /*!< disable output RTC_ALARM */
- #define RTC_OS_ENABLE CTL_OS(1) /*!< enable alarm flag output */
- #define RTC_CALIBRATION_512HZ RTC_CTL_COEN /*!< calibration output of 512Hz is enable */
- #define RTC_CALIBRATION_1HZ RTC_CTL_COEN | RTC_CTL_COS /*!< calibration output of 1Hz is enable */
- #define RTC_ALARM_HIGH RTC_CTL_OS_ENABLE /*!< enable alarm flag output with high level */
- #define RTC_ALARM_LOW RTC_CTL_OS_ENABLE | RTC_CTL_OPOL /*!< enable alarm flag output with low level*/
- #define RTC_24HOUR ((uint32_t)0x00000000U) /*!< 24-hour format */
- #define RTC_12HOUR RTC_CTL_CS /*!< 12-hour format */
- #define RTC_TIMESTAMP_RISING_EDGE ((uint32_t)0x00000000U) /*!< rising edge is valid event edge for time-stamp event */
- #define RTC_TIMESTAMP_FALLING_EDGE RTC_CTL_TSEG /*!< falling edge is valid event edge for time-stamp event */
-
- /* psc register value */
- #define PSC_FACTOR_S(regval) (BITS(0,14) & ((uint32_t)(regval) << 0U)) /*!< write value to RTC_PSC_FACTOR_S bit field */
- #define GET_PSC_FACTOR_S(regval) GET_BITS((regval),0,14) /*!< get value of RTC_PSC_FACTOR_S bit field */
- #define PSC_FACTOR_A(regval) (BITS(16,22) & ((uint32_t)(regval) << 16U)) /*!< write value to RTC_PSC_FACTOR_A bit field */
- #define GET_PSC_FACTOR_A(regval) GET_BITS((regval),16,22) /*!< get value of RTC_PSC_FACTOR_A bit field */
- /* alrm0td register value */
- #define ALRM0TD_SC(regval) (BITS(0,6) & ((uint32_t)(regval)<< 0U)) /*!< write value to RTC_ALRM0TD_SC bit field */
- #define GET_ALRM0TD_SC(regval) GET_BITS((regval),0,6) /*!< get value of RTC_ALRM0TD_SC bit field */
- #define ALRM0TD_MN(regval) (BITS(8,14) & ((uint32_t)(regval) << 8U)) /*!< write value to RTC_ALRM0TD_MN bit field */
- #define GET_ALRM0TD_MN(regval) GET_BITS((regval),8,14) /*!< get value of RTC_ALRM0TD_MN bit field */
- #define ALRM0TD_HR(regval) (BITS(16,21) & ((uint32_t)(regval) << 16U)) /*!< write value to RTC_ALRM0TD_HR bit field */
- #define GET_ALRM0TD_HR(regval) GET_BITS((regval),16,21) /*!< get value of RTC_ALRM0TD_HR bit field */
- #define ALRM0TD_DAY(regval) (BITS(24,29) & ((uint32_t)(regval) << 24U)) /*!< write value to RTC_ALRM0TD_DAY bit field */
- #define GET_ALRM0TD_DAY(regval) GET_BITS((regval),24,29) /*!< get value of RTC_ALRM0TD_DAY bit field */
- #define RTC_ALARM_NONE_MASK ((uint32_t)0x00000000U) /*!< alarm none mask */
- #define RTC_ALARM_DATE_MASK RTC_ALRM0TD_MSKD /*!< alarm date mask */
- #define RTC_ALARM_HOUR_MASK RTC_ALRM0TD_MSKH /*!< alarm hour mask */
- #define RTC_ALARM_MINUTE_MASK RTC_ALRM0TD_MSKM /*!< alarm minute mask */
- #define RTC_ALARM_SECOND_MASK RTC_ALRM0TD_MSKS /*!< alarm second mask */
- #define RTC_ALARM_ALL_MASK (RTC_ALRM0TD_MSKD|RTC_ALRM0TD_MSKH|RTC_ALRM0TD_MSKM|RTC_ALRM0TD_MSKS) /*!< alarm all mask */
- #define RTC_ALARM_DATE_SELECTED ((uint32_t)0x00000000U) /*!< alarm date format selected */
- #define RTC_ALARM_WEEKDAY_SELECTED RTC_ALRM0TD_DOWS /*!< alarm weekday format selected */
- /* wpk register value */
- #define WPK_WPK(regval) (BITS(0,7) & ((uint32_t)(regval) << 0U)) /*!< write value to RTC_WPK_WPK bit field */
- /* ss register value */
- #define SS_SSC(regval) (BITS(0,15) & ((uint32_t)(regval) << 0U)) /*!< write value to RTC_SS_SSC bit field */
- /* shiftctl register value */
- #define SHIFTCTL_SFS(regval) (BITS(0,14) & ((uint32_t)(regval) << 0U)) /*!< write value to RTC_SHIFTCTL_SFS bit field */
- #define RTC_SHIFT_ADD1S_RESET ((uint32_t)0x00000000U) /*!< not add 1 second */
- #define RTC_SHIFT_ADD1S_SET RTC_SHIFTCTL_A1S /*!< add one second to the clock */
- /* tts register value */
- #define TTS_SC(regval) (BITS(0,6) & ((uint32_t)(regval) << 0U)) /*!< write value to RTC_TTS_SC bit field */
- #define GET_TTS_SC(regval) GET_BITS((regval),0,6) /*!< get value of RTC_TTS_SC bit field */
- #define TTS_MN(regval) (BITS(8,14) & ((uint32_t)(regval) << 8U)) /*!< write value to RTC_TTS_MN bit field */
- #define GET_TTS_MN(regval) GET_BITS((regval),8,14) /*!< get value of RTC_TTS_MN bit field */
- #define TTS_HR(regval) (BITS(16,21) & ((uint32_t)(regval) << 16U)) /*!< write value to RTC_TTS_HR bit field */
- #define GET_TTS_HR(regval) GET_BITS((regval),16,21) /*!< get value of RTC_TTS_HR bit field */
- /* dts register value */
- #define DTS_DAY(regval) (BITS(0,5) & ((uint32_t)(regval) << 0U)) /*!< write value to RTC_DTS_DAY bit field */
- #define GET_DTS_DAY(regval) GET_BITS((regval),0,5) /*!< get value of RTC_DTS_DAY bit field */
- #define DTS_MON(regval) (BITS(8,12) & ((uint32_t)(regval) << 8U)) /*!< write value to RTC_DTS_MON bit field */
- #define GET_DTS_MON(regval) GET_BITS((regval),8,11) /*!< get value of RTC_DTS_MON bit field */
- #define DTS_DOW(regval) (BITS(13,15) & ((uint32_t)(regval) << 13U)) /*!< write value to RTC_DTS_DOW bit field */
- #define GET_DTS_DOW(regval) GET_BITS((regval),13,15) /*!< get value of RTC_DTS_DOW bit field */
- /* ssts register value */
- #define SSTS_SSC(regval) (BITS(0,15) & ((uint32_t)(regval) << 0U)) /*!< write value to RTC_SSTS_SSC bit field */
- /* hrfc register value */
- #define HRFC_CMSK(regval) (BITS(0,8) & ((uint32_t)(regval) << 0U)) /*!< write value to RTC_HRFC_CMSK bit field */
- #define RTC_CALIBRATION_WINDOW_32S ((uint32_t)0x00000000U) /*!< 2exp20 RTCCLK cycles, 32s if RTCCLK = 32768 Hz */
- #define RTC_CALIBRATION_WINDOW_16S RTC_HRFC_CWND16 /*!< 2exp19 RTCCLK cycles, 16s if RTCCLK = 32768 Hz */
- #define RTC_CALIBRATION_WINDOW_8S RTC_HRFC_CWND8 /*!< 2exp18 RTCCLK cycles, 8s if RTCCLK = 32768 Hz */
- #define RTC_CALIBRATION_PLUS_SET RTC_HRFC_FREQI /*!< increase RTC frequency by 488.5ppm */
- #define RTC_CALIBRATION_PLUS_RESET ((uint32_t)0x00000000U) /*!< no effect */
- /* tamp register value */
- #define TAMP_FREQ(regval) (BITS(8,10) & ((uint32_t)(regval) << 8U)) /*!< write value to RTC_TAMP_FREQ bit field */
- #define RTC_FREQ_DIV32768 TAMP_FREQ(0) /*!< sample once every 32768 RTCCLK(1Hz if RTCCLK=32.768KHz) */
- #define RTC_FREQ_DIV16384 TAMP_FREQ(1) /*!< sample once every 16384 RTCCLK(2Hz if RTCCLK=32.768KHz) */
- #define RTC_FREQ_DIV8192 TAMP_FREQ(2) /*!< sample once every 8192 RTCCLK(4Hz if RTCCLK=32.768KHz) */
- #define RTC_FREQ_DIV4096 TAMP_FREQ(3) /*!< sample once every 4096 RTCCLK(8Hz if RTCCLK=32.768KHz) */
- #define RTC_FREQ_DIV2048 TAMP_FREQ(4) /*!< sample once every 2048 RTCCLK(16Hz if RTCCLK=32.768KHz) */
- #define RTC_FREQ_DIV1024 TAMP_FREQ(5) /*!< sample once every 1024 RTCCLK(32Hz if RTCCLK=32.768KHz) */
- #define RTC_FREQ_DIV512 TAMP_FREQ(6) /*!< sample once every 512 RTCCLK(64Hz if RTCCLK=32.768KHz) */
- #define RTC_FREQ_DIV256 TAMP_FREQ(7) /*!< sample once every 256 RTCCLK(128Hz if RTCCLK=32.768KHz) */
- #define TAMP_FLT(regval) (BITS(11,12) & ((uint32_t)(regval) << 11U)) /*!< write value to RTC_TAMP_FLT bit field */
- #define RTC_FLT_EDGE TAMP_FLT(0) /*!< detecting tamper event using edge mode. precharge duration is disabled automatically */
- #define RTC_FLT_2S TAMP_FLT(1) /*!< detecting tamper event using level mode.2 consecutive valid level samples will make a effective tamper event */
- #define RTC_FLT_4S TAMP_FLT(2) /*!< detecting tamper event using level mode.4 consecutive valid level samples will make an effective tamper event */
- #define RTC_FLT_8S TAMP_FLT(3) /*!< detecting tamper event using level mode.8 consecutive valid level samples will make a effective tamper event */
- #define TAMP_PRCH(regval) (BITS(13,14) & ((uint32_t)(regval) << 13U)) /*!< write value to RTC_TAMP_PRCH bit field */
- #define RTC_PRCH_1C TAMP_PRCH(0) /*!< 1 RTC clock prechagre time before each sampling */
- #define RTC_PRCH_2C TAMP_PRCH(1) /*!< 2 RTC clock prechagre time before each sampling */
- #define RTC_PRCH_4C TAMP_PRCH(2) /*!< 4 RTC clock prechagre time before each sampling */
- #define RTC_PRCH_8C TAMP_PRCH(3) /*!< 8 RTC clock prechagre time before each sampling */
- #define RTC_TAMPER0 RTC_TAMP_TP0EN /*!< tamper 0 detection enable */
- #define RTC_TAMPER1 RTC_TAMP_TP1EN /*!< tamper 1 detection enable */
- #define RTC_TAMPER_TRIGGER_EDGE_RISING ((uint32_t)0x00000000U) /*!< tamper detection is in rising edge mode */
- #define RTC_TAMPER_TRIGGER_EDGE_FALLING RTC_TAMP_TP0EG /*!< tamper detection is in falling edge mode */
- #define RTC_TAMPER_TRIGGER_LEVEL_LOW ((uint32_t)0x00000000U) /*!< tamper detection is in low level mode */
- #define RTC_TAMPER_TRIGGER_LEVEL_HIGH RTC_TAMP_TP0EG /*!< tamper detection is in high level mode */
- #define RTC_TAMPER_TRIGGER_POS ((uint32_t)0x00000001U) /* shift position of trigger relative to source */
- #define RTC_ALARM_OUTPUT_OD ((uint32_t)0x00000000U) /*!< RTC alarm output open-drain mode */
- #define RTC_ALARM_OUTPUT_PP RTC_TAMP_PC13VAL /*!< RTC alarm output push-pull mode */
- /* alrm0ss register value */
- #define ALRM0SS_SSC(regval) (BITS(0,14) & ((uint32_t)(regval)<< 0U)) /*!< write value to RTC_ALRM0SS_SSC bit field */
- #define ALRM0SS_MASKSSC(regval) (BITS(24,27) & ((uint32_t)(regval) << 24U)) /*!< write value to RTC_ALRM0SS_MASKSSC bit field */
- #define RTC_MASKSSC_0_14 ALRM0SS_MASKSSC(0) /*!< mask alarm subsecond configuration */
- #define RTC_MASKSSC_1_14 ALRM0SS_MASKSSC(1) /*!< mask RTC_ALRM0SS_SSC[14:1], and RTC_ALRM0SS_SSC[0] is to be compared */
- #define RTC_MASKSSC_2_14 ALRM0SS_MASKSSC(2) /*!< mask RTC_ALRM0SS_SSC[14:2], and RTC_ALRM0SS_SSC[1:0] is to be compared */
- #define RTC_MASKSSC_3_14 ALRM0SS_MASKSSC(3) /*!< mask RTC_ALRM0SS_SSC[14:3], and RTC_ALRM0SS_SSC[2:0] is to be compared */
- #define RTC_MASKSSC_4_14 ALRM0SS_MASKSSC(4) /*!< mask RTC_ALRM0SS_SSC[14:4], and RTC_ALRM0SS_SSC[3:0] is to be compared */
- #define RTC_MASKSSC_5_14 ALRM0SS_MASKSSC(5) /*!< mask RTC_ALRM0SS_SSC[14:5], and RTC_ALRM0SS_SSC[4:0] is to be compared */
- #define RTC_MASKSSC_6_14 ALRM0SS_MASKSSC(6) /*!< mask RTC_ALRM0SS_SSC[14:6], and RTC_ALRM0SS_SSC[5:0] is to be compared */
- #define RTC_MASKSSC_7_14 ALRM0SS_MASKSSC(7) /*!< mask RTC_ALRM0SS_SSC[14:7], and RTC_ALRM0SS_SSC[6:0] is to be compared */
- #define RTC_MASKSSC_8_14 ALRM0SS_MASKSSC(8) /*!< mask RTC_ALRM0SS_SSC[14:8], and RTC_ALRM0SS_SSC[7:0] is to be compared */
- #define RTC_MASKSSC_9_14 ALRM0SS_MASKSSC(9) /*!< mask RTC_ALRM0SS_SSC[14:9], and RTC_ALRM0SS_SSC[8:0] is to be compared */
- #define RTC_MASKSSC_10_14 ALRM0SS_MASKSSC(10) /*!< mask RTC_ALRM0SS_SSC[14:10], and RTC_ALRM0SS_SSC[9:0] is to be compared */
- #define RTC_MASKSSC_11_14 ALRM0SS_MASKSSC(11) /*!< mask RTC_ALRM0SS_SSC[14:11], and RTC_ALRM0SS_SSC[10:0] is to be compared */
- #define RTC_MASKSSC_12_14 ALRM0SS_MASKSSC(12) /*!< mask RTC_ALRM0SS_SSC[14:12], and RTC_ALRM0SS_SSC[11:0] is to be compared */
- #define RTC_MASKSSC_13_14 ALRM0SS_MASKSSC(13) /*!< mask RTC_ALRM0SS_SSC[14:13], and RTC_ALRM0SS_SSC[12:0] is to be compared */
- #define RTC_MASKSSC_14 ALRM0SS_MASKSSC(14) /*!< mask RTC_ALRM0SS_SSC[14], and RTC_ALRM0SS_SSC[13:0] is to be compared */
- #define RTC_MASKSSC_NONE ALRM0SS_MASKSSC(15) /*!< mask none, and RTC_ALRM0SS_SSC[14:0] is to be compared */
- /* RTC interrupt source */
- #define RTC_INT_TIMESTAMP RTC_CTL_TSIE /*!< time-stamp interrupt enable */
- #define RTC_INT_ALARM RTC_CTL_ALRM0IE /*!< RTC alarm interrupt enable */
- #define RTC_INT_TAMP RTC_TAMP_TPIE /*!< tamper detection interrupt enable */
- /* write protect key */
- #define RTC_UNLOCK_KEY1 ((uint8_t)0xCAU) /*!< RTC unlock key1 */
- #define RTC_UNLOCK_KEY2 ((uint8_t)0x53U) /*!< RTC unlock key2 */
- #define RTC_LOCK_KEY ((uint8_t)0xFFU) /*!< RTC lock key */
- /* registers reset value */
- #define RTC_REGISTER_RESET ((uint32_t)0x00000000U) /*!< RTC common register reset value */
- #define RTC_DATE_RESET ((uint32_t)0x00002101U) /*!< RTC_DATE register reset value */
- #define RTC_STAT_RESET ((uint32_t)0x00000007U) /*!< RTC_STAT register reset value */
- #define RTC_PSC_RESET ((uint32_t)0x007F00FFU) /*!< RTC_PSC register reset value */
- /* RTC timeout value */
- #define RTC_INITM_TIMEOUT ((uint32_t)0x00004000U) /*!< initialization state flag timeout */
- #define RTC_RSYNF_TIMEOUT ((uint32_t)0x00008000U) /*!< register synchronization flag timeout */
- #define RTC_HRFC_TIMEOUT ((uint32_t)0x00001000U) /*!< recalibration pending flag timeout */
- #define RTC_SHIFTCTL_TIMEOUT ((uint32_t)0x00001000U) /*!< shift function operation pending flag timeout */
- #define RTC_ALRM0WF_TIMEOUT ((uint32_t)0x00008000U) /*!< alarm configuration can be write flag timeout */
- /* RTC flag */
- #define RTC_FLAG_RECALIBRATION RTC_STAT_SCPF /*!< recalibration pending flag */
- #define RTC_FLAG_TAMP1 RTC_STAT_TP1F /*!< tamper 1 event flag */
- #define RTC_FLAG_TAMP0 RTC_STAT_TP0F /*!< tamper 0 event flag */
- #define RTC_FLAG_TIMESTAMP_OVERFLOW RTC_STAT_TSOVRF /*!< time-stamp overflow event flag */
- #define RTC_FLAG_TIMESTAMP RTC_STAT_TSF /*!< time-stamp event flag */
- #define RTC_FLAG_ALARM0 RTC_STAT_ALRM0F /*!< alarm event flag */
- #define RTC_FLAG_INIT RTC_STAT_INITF /*!< init mode event flag */
- #define RTC_FLAG_RSYN RTC_STAT_RSYNF /*!< registers synchronized flag */
- #define RTC_FLAG_YCM RTC_STAT_YCM /*!< year parameter configured event flag */
- #define RTC_FLAG_SHIFT RTC_STAT_SOPF /*!< shift operation pending flag */
- #define RTC_FLAG_ALARM0_WRITTEN RTC_STAT_ALRM0WF /*!< alarm written available flag */
- /* function declarations */
- /* reset most of the RTC registers */
- ErrStatus rtc_deinit(void);
- /* initialize RTC registers */
- ErrStatus rtc_init(rtc_parameter_struct* rtc_initpara_struct);
- /* enter RTC init mode */
- ErrStatus rtc_init_mode_enter(void);
- /* exit RTC init mode */
- void rtc_init_mode_exit(void);
- /* wait until RTC_TIME and RTC_DATE registers are synchronized with APB clock, and the shadow registers are updated */
- ErrStatus rtc_register_sync_wait(void);
- /* get current time and date */
- void rtc_current_time_get(rtc_parameter_struct* rtc_initpara_struct);
- /* get current subsecond value */
- uint32_t rtc_subsecond_get(void);
- /* configure RTC alarm */
- void rtc_alarm_config(rtc_alarm_struct* rtc_alarm_time);
- /* configure subsecond of RTC alarm */
- void rtc_alarm_subsecond_config(uint32_t mask_subsecond, uint32_t subsecond);
- /* get RTC alarm */
- void rtc_alarm_get(rtc_alarm_struct* rtc_alarm_time);
- /* get RTC alarm subsecond */
- uint32_t rtc_alarm_subsecond_get(void);
- /* enable RTC alarm */
- void rtc_alarm_enable(void);
- /* disable RTC alarm */
- ErrStatus rtc_alarm_disable(void);
- /* enable RTC time-stamp */
- void rtc_timestamp_enable(uint32_t edge);
- /* disable RTC time-stamp */
- void rtc_timestamp_disable(void);
- /* get RTC timestamp time and date */
- void rtc_timestamp_get(rtc_timestamp_struct* rtc_timestamp);
- /* get RTC time-stamp subsecond */
- uint32_t rtc_timestamp_subsecond_get(void);
- /* enable RTC tamper */
- void rtc_tamper_enable(rtc_tamper_struct* rtc_tamper);
- /* disable RTC tamper */
- void rtc_tamper_disable(uint32_t source);
- /* enable specified RTC interrupt */
- void rtc_interrupt_enable(uint32_t interrupt);
- /* disble specified RTC interrupt */
- void rtc_interrupt_disable(uint32_t interrupt);
- /* check specified flag */
- FlagStatus rtc_flag_get(uint32_t flag);
- /* clear specified flag */
- void rtc_flag_clear(uint32_t flag);
- /* configure RTC alternate output source */
- void rtc_alter_output_config(uint32_t source, uint32_t mode);
- /* configure RTC calibration register */
- ErrStatus rtc_calibration_config(uint32_t window, uint32_t plus, uint32_t minus);
- /* ajust the daylight saving time by adding or substracting one hour from the current time */
- void rtc_hour_adjust(uint32_t operation);
- /* ajust RTC second or subsecond value of current time */
- ErrStatus rtc_second_ajust(uint32_t add, uint32_t minus);
- /* enable RTC bypass shadow registers function */
- void rtc_bypass_shadow_enable(void);
- /* disable RTC bypass shadow registers function */
- void rtc_bypass_shadow_disable(void);
- /* enable RTC reference clock detection function */
- ErrStatus rtc_refclock_detection_enable(void);
- /* disable RTC reference clock detection function */
- ErrStatus rtc_refclock_detection_disable(void);
- #endif /* GD32F3X0_RTC_H */
|
