RTC on CLing

AT32 — 实时时钟 (RTC)

Tue, 08 Sep 2026 14:52:21 +0800

AT32 — 实时时钟 (RTC)

固件库: AT32F403A_407_Firmware_Library V2.2.2
示例数: 2

什么是实时时钟 (RTC)?

RTC（实时时钟）提供年月日时分秒的计时功能。由独立电池供电，MCU 复位或断电后时间不丢失。

示例列表

日历功能 — calendar
内部低频时钟校准 — lick_calibration

AT32 RTC — 内部低频时钟校准

Tue, 08 Sep 2026 14:52:21 +0800

RTC — 内部低频时钟校准

固件库: AT32F403A_407_Firmware_Library V2.2.2
芯片: AT32
源文件: AT32/AT32F403A_407_Firmware_Library_V2.2.2/project/at_start_f403a/examples/rtc/lick_calibration/src/main.c

功能简介

本示例演示实时时钟（RTC）功能。RTC 是独立运行的计时模块，常用纽扣电池供电，即使主电源断电也能保持时间。

完整代码

#include "at32f403a_407_board.h"
#include "at32f403a_407_clock.h"

int main(void)
{
  tmr_input_config_type tmr_ic_init_structure;

  system_clock_config();

  at32_board_init();

  uart_print_init(115200);

  /* rtc configuration */
  rtc_configuration();

  printf("\r\n\nstart calib\r\n\r\n");

  /* get the frequency value */
  crm_clocks_freq_get(&crm_clocks);

  /* enable tmr5 apb1 clocks */
  crm_periph_clock_enable(CRM_TMR5_PERIPH_CLOCK, TRUE);
  crm_periph_clock_enable(CRM_IOMUX_PERIPH_CLOCK, TRUE);

  /* connect internally the tm5_ch4 input capture to the lick clock output */
  gpio_pin_remap_config(TMR5CH4_MUX, TRUE);

  /* tmr5 time base configuration */
  tmr_base_init(TMR5, 0xFFFF, 0);
  tmr_cnt_dir_set(TMR5, TMR_COUNT_UP);
  tmr_clock_source_div_set(TMR5, TMR_CLOCK_DIV1);

  /* tmr5 channel4 input capture mode configuration */
  tmr_input_default_para_init(&tmr_ic_init_structure);
  tmr_ic_init_structure.input_channel_select = TMR_SELECT_CHANNEL_4;
  tmr_ic_init_structure.input_polarity_select = TMR_INPUT_RISING_EDGE;
  tmr_ic_init_structure.input_mapped_select = TMR_CC_CHANNEL_MAPPED_DIRECT;
  tmr_ic_init_structure.input_filter_value = 0;
  tmr_input_channel_init(TMR5, &tmr_ic_init_structure, TMR_CHANNEL_INPUT_DIV_1);

  /* reinitialize the index for the interrupt */
  operationcomplete = 0;

  /* enable the tmr5 input capture counter */
  tmr_counter_enable(TMR5, TRUE);

  /* Reset all tmr5 flags */
  tmr_flag_get(TMR5, TMR_C4_FLAG);

  /* enable the tmr5 channel 4 */
  tmr_interrupt_enable(TMR5, TMR_C4_INT, TRUE);

  /* nvic configuration */
  nvic_configuration();

  /* wait the tmr5 measuring operation to be completed */
  while(operationcomplete != 2);

  /* compute the actual frequency of the lick. (tim5_clk = 1 * pclk1)  */
  if(periodvalue != 0)
  {
    lickfreq = (uint32_t)((uint32_t)(crm_clocks.apb1_freq * 2) / (uint32_t)periodvalue);
  }

  printf("apb1_freq    = %d\r\n", crm_clocks.apb1_freq);
  printf("period_value = %d\r\n", periodvalue);
  printf("lick_freq    = %d\r\n", lickfreq);

  /* adjust the rtc prescaler value */
  rtc_divider_set((lickfreq - 1));

  /* wait for the register write to complete */
  rtc_wait_config_finish();

  /* turn on led2 */
  at32_led_on(LED2);

  while(1)
  {
  }
}

代码讲解

系统时钟初始化：配置 MCU 的主频和时钟树。不同芯片的时钟配置不同，一般由工具生成。

板级初始化：初始化开发板上的 LED、按键等基础外设。

串口初始化：配置串口波特率（这里是 115200），使能 printf 重定向。

printf 输出：通过串口打印调试信息。需要先调用 uart_print_init 完成重定向。

定时器配置：设置预分频器（PSC）和重装载值（ARR），定时时间 = (PSC+1) × (ARR+1) / 时钟频率。

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

AT32 RTC — 日历功能

Tue, 08 Sep 2026 14:52:21 +0800

RTC — 日历功能

固件库: AT32F403A_407_Firmware_Library V2.2.2
芯片: AT32
源文件: AT32/AT32F403A_407_Firmware_Library_V2.2.2/project/at_start_f403a/examples/rtc/calendar/src/main.c

功能简介

本示例演示 RTC 日历功能。RTC 可以提供年月日时分秒的实时时钟，即使 MCU 复位也不影响时间（只要有电池供电）。

完整代码

#include "at32f403a_407_board.h"
#include "at32f403a_407_clock.h"
#include "rtc.h"

void alarm_init(void)
{
  calendar_type alarm_struct;

  /* clear alarm flag */
  rtc_flag_clear(RTC_TA_FLAG);

  /* wait for the register write to complete */
  rtc_wait_config_finish();

  /* configure and enable rtc interrupt */
  nvic_irq_enable(RTC_IRQn, 0, 0);

  /* enable alarm interrupt */
  rtc_interrupt_enable(RTC_TA_INT, TRUE);

  /* wait for the register write to complete */
  rtc_wait_config_finish();

  /* config alarm */

  alarm_struct.year  = 2021;
  alarm_struct.month = 5;
  alarm_struct.date  = 1;
  alarm_struct.hour  = 12;
  alarm_struct.min   = 0;
  alarm_struct.sec   = 5;

  rtc_alarm_clock_set(&alarm_struct);
}

int main(void)
{
  calendar_type time_struct;

  /* config nvic priority group */
  nvic_priority_group_config(NVIC_PRIORITY_GROUP_4);

  system_clock_config();

  at32_board_init();

  uart_print_init(115200);

  /* config calendar */
  time_struct.year  = 2021;
  time_struct.month = 5;
  time_struct.date  = 1;
  time_struct.hour  = 12;
  time_struct.min   = 0;
  time_struct.sec   = 0;
  rtc_init(&time_struct);

  /* config alarm */
  alarm_init();

  printf("initial ok\r\n");

  while(1)
  {
    if(rtc_flag_get(RTC_TS_FLAG) != RESET)
    {
      at32_led_toggle(LED3);

      /* get time */
      rtc_time_get();

      /* print time */
      printf("%d/%d/%d ", calendar.year, calendar.month, calendar.date);
      printf("%02d:%02d:%02d %s\r\n", calendar.hour, calendar.min, calendar.sec, weekday_table[calendar.week]);

      /* wait for the register write to complete */
      rtc_wait_config_finish();

      /* clear the rtc second flag */
      rtc_flag_clear(RTC_TS_FLAG);

      /* wait for the register write to complete */
      rtc_wait_config_finish();
    }
  }
}

代码讲解

系统时钟初始化：配置 MCU 的主频和时钟树。不同芯片的时钟配置不同，一般由工具生成。

板级初始化：初始化开发板上的 LED、按键等基础外设。

串口初始化：配置串口波特率（这里是 115200），使能 printf 重定向。

printf 输出：通过串口打印调试信息。需要先调用 uart_print_init 完成重定向。

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

GD32 — 实时时钟 (RTC)

Tue, 08 Sep 2026 14:52:21 +0800

GD32 — 实时时钟 (RTC)

固件库: GD32F30x_Firmware_Library V3.0.3
示例数: 1

什么是实时时钟 (RTC)?

RTC（实时时钟）提供年月日时分秒的计时功能。由独立电池供电，MCU 复位或断电后时间不丢失。

示例列表

日历演示 — Calendar_demo

GD32 RTC — 日历演示

Tue, 08 Sep 2026 14:52:21 +0800

RTC — 日历演示

固件库: GD32F30x_Firmware_Library V3.0.3
芯片: GD32
源文件: GD32F30x_Firmware_Library_V3.0.3/Examples/RTC/Calendar_demo/main.c

功能简介

本示例演示 RTC 日历功能。RTC 可以提供年月日时分秒的实时时钟，即使 MCU 复位也不影响时间（只要有电池供电）。

完整代码

#include "gd32f30x.h"
#include "gd32f307c_eval.h"
#include "rtc.h"
#include <stdio.h>

int main(void)
{
    /* COM0 config */
    gd_eval_com_init(EVAL_COM0);

    /* NVIC config */
    nvic_configuration();

    /* enable PMU and BKPI clocks */
    rcu_periph_clock_enable(RCU_BKPI);
    rcu_periph_clock_enable(RCU_PMU);

    /* allow access to BKP domain */
    pmu_backup_write_enable();
    if(RESET != (RCU_BDCTL & RCU_BDCTL_BKPRST)) {
        rcu_bkp_reset_disable();
    }

    printf( "\r\n This is a RTC demo...... \r\n" );

    /* get RTC clock entry selection */
    RTCSRC_FLAG = GET_BITS(RCU_BDCTL, 8, 9);

    if ((0xA5A5 != bkp_read_data(BKP_DATA_0)) || (0x00 == RTCSRC_FLAG)){
        /* backup data register value is not correct or not yet programmed
        or RTC clock source is not configured (when the first time the program 
        is executed or data in RCU_BDCTL is lost due to Vbat feeding) */
        printf("\r\nThis is a RTC demo!\r\n");
        printf("\r\n\n RTC not yet configured....");

        /* RTC configuration */
        rtc_configuration();

        printf("\r\n RTC configured....");

        /* adjust time by values entred by the user on the hyperterminal */
        time_adjust();

        bkp_write_data(BKP_DATA_0, 0xA5A5);
    }else{
        /* check if the power on reset flag is set */
        if (rcu_flag_get(RCU_FLAG_PORRST) != RESET){
            printf("\r\n\n Power On Reset occurred....");
        }else if (rcu_flag_get(RCU_FLAG_SWRST) != RESET){
            /* check if the pin reset flag is set */
            printf("\r\n\n External Reset occurred....");
        }

        /* allow access to BKP domain */
        rcu_periph_clock_enable(RCU_PMU);
        pmu_backup_write_enable();

        printf("\r\n No need to configure RTC....");
        /* wait for RTC registers synchronization */
        rtc_register_sync_wait();

        /* enable the RTC second */
        rtc_interrupt_enable(RTC_INT_SECOND);

        /* wait until last write operation on RTC registers has finished */
        rtc_lwoff_wait();
    }

#ifdef RTCCLOCKOUTPUT_ENABLE
    /* enable PMU and BKPI clocks */
    rcu_periph_clock_enable(RCU_BKPI);
    rcu_periph_clock_enable(RCU_PMU);
    /* allow access to BKP domain */
    pmu_backup_write_enable();

    /* disable the tamper pin */
    bkp_tamper_detection_disable();

    /* enable RTC clock output on tamper Pin */
    bkp_rtc_calibration_output_enable();
#endif

    /* clear reset flags */
    rcu_all_reset_flag_clear();

    /* display time in infinite loop */
    time_show();

    while (1){
    }
}

代码讲解

printf 输出：通过串口打印调试信息。需要先调用 uart_print_init 完成重定向。

中断优先级配置：NVIC 设置中断的抢占优先级和子优先级。数字越小优先级越高。

校准：ADC 使用前必须校准，消除工艺偏差。校准期间不要操作 ADC。

PUYA — 实时时钟 (RTC)

Tue, 08 Sep 2026 14:52:21 +0800

PUYA — 实时时钟 (RTC)

固件库: PY32F0xx_Firmware V1.5.0
示例数: 3

什么是实时时钟 (RTC)?

RTC（实时时钟）提供年月日时分秒的计时功能。由独立电池供电，MCU 复位或断电后时间不丢失。

示例列表

RTC_AlarmSecond_IT — RTC_AlarmSecond_IT
RTC_WakeUpAlarm — RTC_WakeUpAlarm
RTC_WakeUpSecond — RTC_WakeUpSecond

PUYA — 实时时钟 (RTC)

Tue, 08 Sep 2026 14:52:21 +0800

PUYA — 实时时钟 (RTC)

固件库: PY32F403_Firmware V1.4.5
示例数: 2

什么是实时时钟 (RTC)?

RTC（实时时钟）提供年月日时分秒的计时功能。由独立电池供电，MCU 复位或断电后时间不丢失。

示例列表

RTC_AlarmSecond_IT — RTC_AlarmSecond_IT
RTC_WakeUpAlarm — RTC_WakeUpAlarm

PUYA RTC — RTC_AlarmSecond_IT

Tue, 08 Sep 2026 14:52:21 +0800

RTC — RTC_AlarmSecond_IT

固件库: PY32F0xx_Firmware V1.5.0
芯片: PUYA
源文件: PUYA/PY32F0xx_Firmware_V1.5.0/Projects/PY32F030-STK/Example/RTC/RTC_AlarmSecond_IT/Src/main.c

功能简介

本示例演示 RTC 闹钟功能。设定一个目标时间，到达时自动触发中断唤醒 MCU。适合定时任务和低功耗唤醒。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA RTC — RTC_AlarmSecond_IT

Tue, 08 Sep 2026 14:52:21 +0800

RTC — RTC_AlarmSecond_IT

固件库: PY32F403_Firmware V1.4.5
芯片: PUYA
源文件: PUYA/PY32F403_Firmware_V1.4.5/Projects/PY32F403-STK/Example/RTC/RTC_AlarmSecond_IT/Src/main.c

功能简介

本示例演示 RTC 闹钟功能。设定一个目标时间，到达时自动触发中断唤醒 MCU。适合定时任务和低功耗唤醒。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA RTC — RTC_WakeUpAlarm

Tue, 08 Sep 2026 14:52:21 +0800

RTC — RTC_WakeUpAlarm

固件库: PY32F0xx_Firmware V1.5.0
芯片: PUYA
源文件: PUYA/PY32F0xx_Firmware_V1.5.0/Projects/PY32F030-STK/Example/RTC/RTC_WakeUpAlarm/Src/main.c

功能简介

本示例演示 RTC 闹钟功能。设定一个目标时间，到达时自动触发中断唤醒 MCU。适合定时任务和低功耗唤醒。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA RTC — RTC_WakeUpAlarm

Tue, 08 Sep 2026 14:52:21 +0800

RTC — RTC_WakeUpAlarm

固件库: PY32F403_Firmware V1.4.5
芯片: PUYA
源文件: PUYA/PY32F403_Firmware_V1.4.5/Projects/PY32F403-STK/Example/RTC/RTC_WakeUpAlarm/Src/main.c

功能简介

本示例演示 RTC 闹钟功能。设定一个目标时间，到达时自动触发中断唤醒 MCU。适合定时任务和低功耗唤醒。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

PUYA RTC — RTC_WakeUpSecond

Tue, 08 Sep 2026 14:52:21 +0800

RTC — RTC_WakeUpSecond

固件库: PY32F0xx_Firmware V1.5.0
芯片: PUYA
源文件: PUYA/PY32F0xx_Firmware_V1.5.0/Projects/PY32F030-STK/Example/RTC/RTC_WakeUpSecond/Src/main.c

功能简介

本示例演示实时时钟（RTC）功能。RTC 是独立运行的计时模块，常用纽扣电池供电，即使主电源断电也能保持时间。

完整代码

`1`	`#include "main.h"`

代码讲解

代码结构清晰，主要包含外设初始化配置和主循环中的功能逻辑。请结合注释理解每一步的含义。

RTC on CLing

AT32 — 实时时钟 (RTC)

AT32 — 实时时钟 (RTC)

什么是 实时时钟 (RTC)?

示例列表

AT32 RTC — 内部低频时钟校准

RTC — 内部低频时钟校准

功能简介

完整代码

代码讲解

AT32 RTC — 日历功能

RTC — 日历功能

功能简介

完整代码

代码讲解

GD32 — 实时时钟 (RTC)

GD32 — 实时时钟 (RTC)

什么是 实时时钟 (RTC)?

示例列表

GD32 RTC — 日历演示

RTC — 日历演示

功能简介

完整代码

代码讲解

PUYA — 实时时钟 (RTC)

PUYA — 实时时钟 (RTC)

什么是 实时时钟 (RTC)?

示例列表

PUYA — 实时时钟 (RTC)

PUYA — 实时时钟 (RTC)

什么是 实时时钟 (RTC)?

示例列表

PUYA RTC — RTC_AlarmSecond_IT

RTC — RTC_AlarmSecond_IT

功能简介

完整代码

代码讲解

PUYA RTC — RTC_AlarmSecond_IT

RTC — RTC_AlarmSecond_IT

功能简介

完整代码

代码讲解

PUYA RTC — RTC_WakeUpAlarm

RTC — RTC_WakeUpAlarm

功能简介

完整代码

代码讲解

PUYA RTC — RTC_WakeUpAlarm

RTC — RTC_WakeUpAlarm

功能简介

完整代码

代码讲解

PUYA RTC — RTC_WakeUpSecond

RTC — RTC_WakeUpSecond

功能简介

完整代码

代码讲解

什么是实时时钟 (RTC)?

什么是实时时钟 (RTC)?

什么是实时时钟 (RTC)?

什么是实时时钟 (RTC)?