RTC使用实例

本实例提供RTC接口的完整使用流程：

  1. 系统启动，驱动管理模块会识别系统当前的RTC器件;
  2. 驱动管理模块完成RTC设备的初始化和设备创建；
  3. 用户通过不同API，对该RTC设备进行对应的操作；
  4. 关闭RTC设备，释放设备资源。

示例如下：

  1. #include "rtc_if.h"
  2. int32_t RtcAlarmACallback(enum RtcAlarmIndex alarmIndex)
  3. {
  4.     if (alarmIndex == RTC_ALARM_INDEX_A) {
  5.         /* 报警A的处理 */
  6.         printf("RTC Alarm A callback function\n\r");
  7.     } else if (alarmIndex == RTC_ALARM_INDEX_B) {
  8.         /* 报警B的处理 */
  9.         printf("RTC Alarm B callback function\n\r");
  10.     } else {
  11.         /* 错误处理 */
  12.     }
  13.     return 0;
  14. }
  16. void RtcTestSample(void)
  17. {
  18.     int32_t ret;
  19.     struct RtcTime tm;
  20.     struct RtcTime alarmTime;
  21.     uint32_t freq;
  22.     struct DevHandle *handle = NULL;
  24.     /* 获取RTC设备句柄 */
  25.     handle = RtcOpen();
  26.     if (handle == NULL) {
  27.         /* 错误处理 */
  28.     }
  29.     /* 注册报警A的定时回调函数 */
  30.     ret = RtcRegisterAlarmCallback(handle, RTC_ALARM_INDEX_A, RtcAlarmACallback);
  31.     if (ret != 0) {
  32.         /* 错误处理 */
  33.     }
  34.     /* 设置RTC外接晶体振荡频率，注意按照器件手册要求配置RTC外频 */
  35.     freq = 32768; /* 32768 Hz */
  36.     ret = RtcSetFreq(handle, freq);
  37.     if (ret != 0) {
  38.         /* 错误处理 */
  39.     }
  40.     /* 设置RTC报警中断使能 */
  41.     ret = RtcAlarmInterruptEnable(handle, RTC_ALARM_INDEX_A, 1);
  42.     if (ret != 0) {
  43.         /* 错误处理 */
  44.     }
  45.     /* 设置RTC时间为2020/01/01 00:00:10 .990 */
  46.     tm.year = 2020;
  47.     tm.month = 01;
  48.     tm.day = 01;
  49.     tm.hour= 0;
  50.     tm.minute = 0;
  51.     tm.second = 10;
  52.     tm.millisecond = 990;
  53.     /* 写RTC时间信息 */
  54.     ret = RtcWriteTime(handle, &tm);
  55.     if (ret != 0) {
  56.         /* 错误处理 */
  57.     }
  58.     /* 设置RTC报警时间为2020/01/01 00:00:30 .100 */
  59.     alarmTime.year = 2020;
  60.     alarmTime.month = 01;
  61.     alarmTime.day = 01;
  62.     alarmTime.hour = 0;
  63.     alarmTime.minute = 0;
  64.     alarmTime.second = 30;
  65.     alarmTime.millisecond = 100;
  66.     /* 设置RTC_ALARM_INDEX_A索引定时报警时间信息, 定时时间到后会打印"RTC Alarm A callback function" */
  67.     ret = RtcWriteAlarm(handle, RTC_ALARM_INDEX_A, &alarmTime);
  68.     if (ret != 0) {
  69.         /* 错误处理 */
  70.     }
  72.     /* 读取RTC实时时间 */
  73.     ret = RtcReadTime(handle, &tm);
  74.     if (ret != 0) {
  75.         /* 错误处理 */
  76.     }
  77.     sleep(5)
  78.     printf("RTC read time:\n\r");
  79.     printf("year-month-date-weekday hour:minute:second .millisecond %04u-%02u-%02u-%u %02u:%02u:%02u .%03u",
  80.         tm.year, tm.month, tm.day, tm.weekday, tm.hour, tm.minute, tm.second, tm.millisecond);
  81.     /* 销毁RTC设备句柄 */
  82.     RtcClose(handle);
  83. }