RTC（实时时钟）

内置 RTC，提供日历时钟 + 秒中断，供数字时钟、模拟时钟、计数器、倒计时等控件使用。

一、读写时间

#include "rtc.h"
extern _calendar_obj calendar;      // w_year / w_month / w_date / hour / min / sec / week

RTC_Get();                          // 读硬件 → 刷新 calendar
LTPrintf("%04d-%02d-%02d %02d:%02d:%02d week=%d\r\n",
         calendar.w_year, calendar.w_month, calendar.w_date,
         calendar.hour, calendar.min, calendar.sec, calendar.week);

RTC_Set(2026, 10, 20, 14, 30, 0);   // 设置时间
RTC_Get();                          // 立即生效

二、注意：年份有 2000 偏移

硬件只存「天计数 + 时:分:秒」，年月日是软件从 RTC_BASE_YEAR（rtc.h）换算的。

写到 UI 变量时，年要减 2000：

RTC_Set() 内部会 +2000，用函数就不用管；直接写 UI 变量或上位机下发时要自己换算。

上位机写时间（0x7002 起连续 6 个字）：

5A A5 11 10 70 02 00 1A 00 0A 00 14 00 0E 00 1E 00 00 70 3F
              │    年=26  月=10  日=20  时=14  分=30  秒=0
              └ 首地址 0x7002，连续写 6 个字

• LEN = 1 + 2 + 12 + 2 = 0x11
• 只改部分字段时改首地址与字数（只改时分秒 → 首地址 0x7005，3 个字）

这个坑很常见：写指令里第一个数据字容易被误写成数量（0x0006），
正确应为年份偏移值。上面的帧已按 Modbus CRC16、低字节在前 校验。

三、秒中断：每秒刷新三个标志

// Function/rtc.c —— RTC_Handler()，IRQ 13（EIC_IT_RTC）
RTC->PRCSR = prcsr | (1 << 19);         // 写 1 清标志
RTC_Get();                              // 刷新 calendar
RTC_flag = 1;  Clock_flag = 1;  Count_flag = 1;

目前只开了秒中断（Sec_IEN）和闹钟（Ala_IEN），其余 Min_IEN/Hou_IEN/Day_IEN 是注释掉的。

中断里没有喂狗，往里加耗时逻辑时注意主循环是否还在喂，避免被复位。

四、改常用参数

五、改底层

• RTC_Get() 跨天才重算年月日（先减整年再减整月），时分秒每次刷新 —— 可放心高频调用
• 改 PRCSR 前必须解锁：RTC->PRKEYR = 0x5aa55aa5;
• 主要寄存器：PRT1R（天计数）、PRT2R（时/分/秒）、PRCSR（控制+状态）、
  PRKEYR（钥匙）、PRENR（总使能）

六、注意事项