1# RTC
2
3## 概述
4
5### 功能简介
6
7RTC(real-time clock)为操作系统中的实时时钟设备,为操作系统提供精准的实时时间和定时报警功能。当设备下电后,通过外置电池供电,RTC继续记录操作系统时间;设备上电后,RTC提供实时时钟给操作系统,确保断电后系统时间的连续性。
8
9### 运作机制
10
11在HDF框架中,RTC模块采用独立服务模式,在这种模式下,每一个设备对象会独立发布一个设备服务来处理外部访问,设备管理器收到API的访问请求之后,通过提取该请求的参数,达到调用实际设备对象的相应内部方法的目的。独立服务模式可以直接借助HDFDeviceManager的服务管理能力,但需要为每个设备单独配置设备节点,若设备过多会增加内存占用。通常,一个硬件系统中只需要一个RTC设备,因此RTC模块采用独立服务模式较为合适。
12
13独立服务模式下,核心层不会统一发布一个服务供上层使用,因此这种模式下驱动要为每个控制器发布一个服务,具体表现为:
14
15- 驱动适配者需要实现HdfDriverEntry的Bind钩子函数以绑定服务。
16
17- device_info.hcs文件中deviceNode的policy字段为1或2,不能为0。
18
19**图 1** RTC独立服务模式结构图<a name="fig1"></a>
20
21![RTC独立服务模式结构图](figures/独立服务模式结构图.png)
22
23RTC模块各分层作用:
24
25- 接口层提供打开RTC设备、RTC设备读取时间、RTC设备设置时间、RTC设备读取警报时间、RTC设备设置警报时间、RTC设备定时报警回调函数、RTC设备设置定时报警中断使能去使能、RTC设备设置RTC外频、RTC设备读取RTC外频、复位RTC、设置RTC自定义寄存器配置,读取RTC自定义寄存器配置以及关闭RTC设备的接口。
26
27- 核心层主要提供RTC控制器的创建、销毁,通过钩子函数与适配层交互。
28
29- 适配层主要是将钩子函数的功能实例化,实现具体的功能。
30
31## 使用指导
32
33### 场景介绍
34
35RTC主要用于提供实时时间和定时报警功能。
36
37### 接口说明
38
39RTC模块提供的主要接口如表1所示,具体API详见//drivers/hdf_core/framework/include/platform/rtc_if.h40
41**表 1** RTC设备API接口功能介绍
42
43|  接口名  | 接口描述 |
44| -------- | -------- |
45| DevHandle RtcOpen(void) | 获取RTC设备驱动句柄 |
46| void RtcClose(DevHandle handle) | 释放RTC设备驱动句柄 |
47| int32_t RtcReadTime(DevHandle handle, struct RtcTime \*time) | 读RTC时间信息 |
48| int32_t RtcWriteTime(DevHandle handle, const struct RtcTime \*time) | 写RTC时间信息,包括年、月、星期、日、时、分、秒、毫秒 |
49| int32_t RtcReadAlarm(DevHandle handle, enum RtcAlarmIndex alarmIndex, struct RtcTime \*time) | 读RTC报警时间信息 |
50| int32_t RtcWriteAlarm(DevHandle handle, enum RtcAlarmIndex alarmIndex, const struct RtcTime \*time) | 写RTC报警时间信息 |
51| int32_t RtcRegisterAlarmCallback(DevHandle handle, enum RtcAlarmIndex alarmIndex, RtcAlarmCallback cb) | 注册报警超时回调函数 |
52| int32_t RtcAlarmInterruptEnable(DevHandle handle, enum RtcAlarmIndex alarmIndex, uint8_t enable) | 使能/去使能RTC报警中断 |
53| int32_t RtcGetFreq(DevHandle handle, uint32_t \*freq) | 读RTC外接晶振频率 |
54| int32_t RtcSetFreq(DevHandle handle, uint32_t freq) | 配置RTC外接晶振频率 |
55| int32_t RtcReset(DevHandle handle) | RTC复位 |
56| int32_t RtcReadReg(DevHandle handle, uint8_t usrDefIndex, uint8_t \*value) | 读用户自定义寄存器 |
57| int32_t RtcWriteReg(DevHandle handle, uint8_t usrDefIndex, uint8_t value) | 写用户自定义寄存器 |
58
59### 使用流程
60
61使用RTC设备的一般流程如图2所示。
62
63**图 2** RTC设备使用流程图
64
65![RTC设备使用流程图](figures/RTC设备使用流程图.png)
66
67#### 创建RTC设备句柄
68
69RTC驱动加载成功后,使用驱动框架提供的查询接口并调用RTC设备驱动接口。
70
71> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**<br>
72> 当前操作系统仅支持一个RTC设备。本文涉及的RTC的所有接口,支持内核态及用户态使用。
73
74```c
75DevHandle RtcOpen(void);
76```
77
78**表 2** RtcOpen参数和返回值描述
79
80| **参数** | **描述** |
81| -------- | -------- |
82| void | NA |
83| **返回值** | **描述** |
84| handle | 获取对应的RTC设备句柄成功 |
85| NULL | 获取对应的RTC设备句柄成功失败 |
86
87
88```c
89DevHandle handle = NULL;
90
91// 获取RTC句柄
92handle = RtcOpen();
93if (handle == NULL) {
94    // 错误处理
95    HDF_LOGE("open rtc fail!");
96    return HDF_FAILURE;
97}
98```
99
100#### 注册RTC定时报警回调函数
101
102系统启动后需要注册RTC定时报警回调函数,报警超时后触发回调函数。
103
104```c
105int32_t RtcRegisterAlarmCallback(DevHandle handle, enum RtcAlarmIndex alarmIndex, RtcAlarmCallback cb);
106```
107
108**表 3** RtcRegisterAlarmCallback参数和返回值描述
109
110| **参数** | **描述** |
111| -------- | -------- |
112| handle | DevHandle类型,RTC设备句柄 |
113| alarmIndex | 枚举类型,报警索引 |
114| cb | 定时报警回调函数 |
115| **返回值** | **描述** |
116| HDF_SUCCESS | 操作成功 |
117| 负数 | 操作失败 |
118
119注册RTC_ALARM_INDEX_A的定时报警处理函数, 示例如下:
120
121```c
122// 用户注册RTC定时报警回调函数的方法
123int32_t RtcAlarmACallback(enum RtcAlarmIndex alarmIndex)
124{
125    if (alarmIndex == RTC_ALARM_INDEX_A) {
126        // 报警A的处理
127        HDF_LOGD("RTC Alarm A callback function\n\r");
128        return HDF_SUCCESS;
129    } else if (alarmIndex == RTC_ALARM_INDEX_B) {
130        // 报警B的处理
131        HDF_LOGD("RTC Alarm B callback function\n\r");
132        return HDF_SUCCESS;
133    } else {
134        // 错误处理
135        HDF_LOGE("RTC Alarm callback function fail!\n");
136        return HDF_FAILURE;
137    }
138    return HDF_SUCCESS;
139}
140int32_t ret;
141// 注册报警A的定时回调函数
142ret = RtcRegisterAlarmCallback(handle, RTC_ALARM_INDEX_A, RtcAlarmACallback);
143if (ret != HDF_SUCCESS) {
144    // 错误处理
145    HDF_LOGE("register alarm callback fail, ret:%d", ret);
146    return ret;
147}
148```
149
150
151#### 操作RTC
152
153- 读取RTC时间。
154
155    系统从RTC读取时间信息,包括年、月、星期、日、时、分、秒、毫秒,则可以通过以下函数完成:
156
157    ```c
158    int32_t RtcReadTime(DevHandle handle, struct RtcTime *time);
159    ```
160
161    **表 4** RtcReadTime参数和返回值描述
162
163    | **参数** | **描述** |
164    | -------- | -------- |
165    | handle | DevHandle类型,RTC设备句柄 |
166    | time | 结构体指针类型,RTC读取时间信息,包括年、月、星期、日、时、分、秒、毫秒 |
167    | **返回值** | **描述** |
168    | HDF_SUCCESS | 读取RTC时间成功 |
169    | 负数 | 读取RTC时间失败 |
170
171    ```c
172    int32_t ret;
173    struct RtcTime tm;
174
175    // 系统从RTC读取时间信息
176    ret = RtcReadTime(handle, &tm);
177    if (ret != HDF_SUCCESS) {
178        // 错误处理
179        HDF_LOGE("%s:read time fail, ret:%d", __func__, ret);
180        return ret;
181    }
182    ```
183
184- 设置RTC时间
185
186    设置RTC时间,则可以通过以下函数完成:
187
188    ```c
189    int32_t RtcWriteTime(DevHandle handle, struct RtcTime *time);
190    ```
191
192    **表 5** RtcWriteTime参数和返回值描述
193
194    | **参数** | **描述** |
195    | -------- | -------- |
196    | handle | DevHandle类型,RTC设备句柄 |
197    | time | 结构体指针类型,写RTC时间信息,包括年、月、星期、日、时、分、秒、毫秒 |
198    | **返回值** | **描述** |
199    | HDF_SUCCESS | 设置RTC时间成功 |
200    | 负数 | 设置RTC时间失败 |
201
202    > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**<br>
203    > RTC起始时间为UTC 1970/01/01 Thursday 00:00:00,年的最大取值按照用户器件手册要求计算配置,星期不用配置。
204
205    ```c
206    int32_t ret;
207    struct RtcTime tm;
208
209    // 设置RTC时间为 UTC 2020/01/01 00:59:00 .000
210    tm.year = 2020;
211    tm.month = 01;
212    tm.day = 01;
213    tm.hour= 00;
214    tm.minute = 59;
215    tm.second = 00;
216    tm.millisecond = 0;
217    // 写RTC时间信息
218    ret = RtcWriteTime(handle, &tm);
219    if (ret != HDF_SUCCESS) {
220        // 错误处理
221        HDF_LOGE("write time fail, ret:%d", ret);
222        return ret;
223    }
224    ```
225
226- 读取RTC报警时间
227
228    如果需要读取定时报警时间,则可以通过以下函数完成:
229
230    ```c
231    int32_t RtcReadAlarm(DevHandle handle, enum RtcAlarmIndex alarmIndex, struct RtcTime *time);
232    ```
233
234    **表 6** RtcReadAlarm参数和返回值描述
235
236    | **参数** | **描述** |
237    | -------- | -------- |
238    | handle | DevHandle类型,RTC设备句柄 |
239    | alarmIndex | 枚举类型,报警索引 |
240    | time | 结构体指针类型,RTC报警时间信息,包括年、月、星期、日、时、分、秒、毫秒 |
241    | **返回值** | **描述** |
242    | HDF_SUCCESS | 读取RTC报警时间成功 |
243    | 负数 | 读取RTC报警时间失败 |
244
245    ```c
246    int32_t ret;
247    struct RtcTime alarmTime;
248
249    // 读RTC_ALARM_INDEX_A索引的RTC定时报警时间信息
250    ret = RtcReadAlarm(handle, RTC_ALARM_INDEX_A, &alarmTime);
251    if (ret != HDF_SUCCESS) {
252        // 错误处理
253        HDF_LOGE("read alarm fail, ret:%d", ret);
254        return ret;
255    }
256    ```
257
258- 设置RTC报警时间
259
260    根据报警索引设置RTC报警时间,通过以下函数完成:
261
262    ```c
263    int32_t RtcWriteAlarm(DevHandle handle, enum RtcAlarmIndex alarmIndex, struct RtcTime *time);
264    ```
265
266    **表 7** RtcWriteAlarm参数和返回值描述
267
268    | **参数** | **描述** |
269    | -------- | -------- |
270    | handle | DevHandle类型,RTC设备句柄 |
271    | alarmIndex | 枚举类型,报警索引 |
272    | time | 结构体指针类型,RTC报警时间信息,包括年、月、星期、日、时、分、秒、毫秒 |
273    | **返回值** | **描述** |
274    | HDF_SUCCESS | 设置RTC报警时间成功 |
275    | 负数 | 设置RTC报警时间失败 |
276
277    > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**</br>
278    > RTC起始时间为UTC 1970/01/01 Thursday 00:00:00,年的最大取值按照用户器件手册要求计算配置,星期不用配置。
279
280    ```c
281    int32_t ret;
282    struct RtcTime alarmTime;
283
284    // 设置RTC报警时间为2020/01/01 00:59:59 .000
285    alarmTime.year = 2020;
286    alarmTime.month = 01;
287    alarmTime.day = 01;
288    alarmTime.hour = 00;
289    alarmTime.minute = 59;
290    alarmTime.second = 59;
291    alarmTime.millisecond = 0;
292    // 设置RTC_ALARM_INDEX_A索引的定时报警时间
293    ret = RtcWriteAlarm(handle, RTC_ALARM_INDEX_A, &alarmTime);
294    if (ret != HDF_SUCCESS) {
295        // 错误处理
296        HDF_LOGE("write alarm fail, ret:%d", ret);
297        return ret;
298    }
299    ```
300
301- 设置定时报警中断使能或去使能
302
303    在启动报警操作前,需要先设置报警中断使能,报警超时后会触发告警回调函数,可以通过以下函数完成:
304
305    ```c
306    int32_t RtcAlarmInterruptEnable(DevHandle handle, enum RtcAlarmIndex alarmIndex, uint8_t enable);
307    ```
308
309    **表 8** RtcAlarmInterruptEnable参数和返回值描述
310
311    | **参数** | **描述** |
312    | -------- | -------- |
313    | handle | DevHandle类型,RTC设备句柄 |
314    | alarmIndex | 枚举类型,报警索引 |
315    | enable | uint8_t类型,RTC报警中断配置,1:使能,0:去使能 |
316    | **返回值** | **描述** |
317    | HDF_SUCCESS | 设置定时报警中断使能或去使能成功 |
318    | 负数 | 设置定时报警中断使能或去使能失败 |
319
320    ```c
321    int32_t ret;
322
323    // 设置RTC报警中断使能
324    ret = RtcAlarmInterruptEnable(handle, RTC_ALARM_INDEX_A, 1);
325    if (ret != HDF_SUCCESS) {
326        // 错误处理
327        HDF_LOGE("alarm interrupt enable fail, ret:%d", ret);
328        return ret;
329    }
330    ```
331
332- 读取RTC外频
333
334    读取RTC外接晶体振荡频率,可以通过以下函数完成:
335
336    ```c
337    int32_t RtcGetFreq(DevHandle handle, uint32_t *freq);
338    ```
339
340    **表 9** RtcGetFreq参数和返回值描述
341
342    | **参数** | **描述** |
343    | -------- | -------- |
344    | handle | DevHandle类型,RTC设备句柄 |
345    | freq | uint32_t类型指针,RTC的外接晶体振荡频率,单位(HZ) |
346    | **返回值** | **描述** |
347    | HDF_SUCCESS | 读取RTC外频成功 |
348    | 负数 | 读取RTC外频失败 |
349
350    ```c
351    int32_t ret;
352    uint32_t freq = 0;
353
354    // 读取RTC外接晶体振荡频率
355    ret = RtcGetFreq(handle, &freq);
356    if (ret != HDF_SUCCESS) {
357        // 错误处理
358        HDF_LOGE("get freq fail, ret:%d", ret);
359    }
360    ```
361
362- 配置RTC外频
363
364    配置RTC外接晶体振荡频率,可以通过以下函数完成:
365
366    ```c
367    int32_t RtcSetFreq(DevHandle handle, uint32_t freq);
368    ```
369
370    **表 10** RtcSetFreq参数和返回值描述
371
372    | **参数** | **描述** |
373    | -------- | -------- |
374    | handle | DevHandle类型,RTC设备句柄 |
375    | freq | uint32_t类型,RTC的外接晶体振荡频率,单位(HZ) |
376    | **返回值** | **描述** |
377    | HDF_SUCCESS | 配置RTC外频成功 |
378    | 负数 | 配置RTC外频失败 |
379
380    ```c
381    int32_t ret;
382    uint32_t freq = 32768; // 32768 Hz
383
384    // 设置RTC外接晶体振荡频率,注意按照器件手册要求配置RTC外频
385    ret = RtcSetFreq(handle, freq);
386    if (ret != HDF_SUCCESS) {
387        // 错误处理
388        HDF_LOGE("set freq fail, ret:%d", ret);
389        return ret;
390    }
391    ```
392
393- 复位RTC
394
395    复位RTC,复位RTC后各配置寄存器恢复默认值,可以通过以下函数完成:
396
397    ```c
398    int32_t RtcReset(DevHandle handle);
399    ```
400
401    **表 11** RtcReset参数和返回值描述
402
403    | **参数** | **描述** |
404    | -------- | -------- |
405    | handle | DevHandle类型,RTC设备句柄 |
406    | **返回值** | **描述** |
407    | HDF_SUCCESS | 复位RTC成功 |
408    | 负数 | 复位RTC失败 |
409
410    ```c
411    int32_t ret;
412
413    // 复位RTC,各配置寄存器恢复默认值
414    ret = RtcReset(handle);
415    if (ret != HDF_SUCCESS) {
416        // 错误处理
417        HDF_LOGE("reset fail, ret:%d", ret);
418        return ret;
419    }
420    ```
421
422- 读取RTC自定义寄存器配置
423
424    按照用户定义的寄存器索引,读取对应的寄存器配置,一个索引对应一字节的配置值,通过以下函数完成:
425
426    ```c
427    int32_t RtcReadReg(DevHandle handle, uint8_t usrDefIndex, uint8_t *value);
428    ```
429
430    **表 12** RtcReadReg参数和返回值描述
431
432    | **参数** | **描述** |
433    | -------- | -------- |
434    | handle | DevHandle类型,RTC设备句柄 |
435    | usrDefIndex | uint8_t类型,用户定义的寄存器对应索引 |
436    | value | uint8_t类型指针,待读取寄存器值 |
437    | **返回值** | **描述** |
438    | HDF_SUCCESS | 读取RTC自定义寄存器配置成功 |
439    | 负数 | 读取RTC自定义寄存器配置失败 |
440
441    ```c
442    int32_t ret;
443    uint8_t usrDefIndex = 0; // 定义0索引对应用户定义的第一个寄存器
444    uint8_t value = 0;
445
446    // 按照用户定义的寄存器索引,读取对应的寄存器配置,一个索引对应一字节的配置值
447    ret = RtcReadReg(handle, usrDefIndex, &value);
448    if (ret != HDF_SUCCESS) {
449        // 错误处理
450        HDF_LOGE("read reg fail, ret:%d", ret);
451        return ret;
452    }
453    ```
454
455- 设置RTC自定义寄存器配置
456
457    按照用户定义的寄存器索引,设置对应的寄存器配置,一个索引对应一字节的配置值,通过以下函数完成:
458
459    ```c
460    int32_t RtcWriteReg(DevHandle handle, uint8_t usrDefIndex, uint8_t value);
461    ```
462
463    **表 13** RtcWriteReg参数和返回值描述
464
465    | **参数** | **描述** |
466    | -------- | -------- |
467    | handle | DevHandle类型,RTC设备句柄 |
468    | usrDefIndex | uint8_t类型,用户定义的寄存器对应索引 |
469    | value |  uint8_t类型,寄存器值 |
470    | **返回值** | **描述** |
471    | HDF_SUCCESS | 设置RTC自定义寄存器配置成功 |
472    | 负数 | 设置RTC自定义寄存器配置失败 |
473
474    ```c
475    int32_t ret;
476    uint8_t usrDefIndex = 0; // 定义0索引对应用户定义第一个寄存器
477    uint8_t value = 0x10;
478
479    // 按照用户的定义的寄存器索引,设置对应的寄存器配置,一个索引对应一字节的配置值
480    ret = RtcWriteReg(handle, usrDefIndex, value);
481    if (ret != HDF_SUCCESS) {
482        // 错误处理
483        HDF_LOGE("write reg fail, ret:%d", ret);
484        return ret;
485    }
486    ```
487
488#### 销毁RTC设备句柄
489
490销毁RTC设备句柄,系统释放对应的资源。
491
492```c
493void RtcClose(DevHandle handle);
494```
495
496**表 14** RtcClose参数描述
497
498| **参数** | **描述** |
499| -------- | -------- |
500| handle | DevHandle类型,RTC设备句柄 |
501
502```c
503// 销毁RTC句柄
504RtcClose(handle);
505```
506
507### 使用实例
508
509本例基于Hi3516DV300开发板,提供RTC接口的完整使用流程:
510
5111. 系统启动,驱动管理模块会识别系统当前的RTC器件;
512
5132. 驱动管理模块完成RTC设备的初始化和设备创建;
514
5153. 用户通过不同API,对该RTC设备进行对应的操作;
516
5174. 关闭RTC设备,释放设备资源。
518
519示例如下:
520
521```c有问题
522#include "hdf_log.h"                  // 标准日志打印头文件
523#include "osal_time.h"                // 标准延迟&睡眠接口头文件
524#include "rtc_if.h"
525
526int32_t RtcAlarmACallback(enum RtcAlarmIndex alarmIndex)
527{
528    if (alarmIndex == RTC_ALARM_INDEX_A) {
529        // 报警A的处理
530        HDF_LOGD("RtcAlarmACallback: RTC Alarm A callback function\n\r");
531        return HDF_SUCCESS;
532    } else if (alarmIndex == RTC_ALARM_INDEX_B) {
533        // 报警B的处理
534        HDF_LOGD("RtcAlarmACallback:RTC Alarm B callback function\n\r");
535        return HDF_SUCCESS;
536    } else {
537        // 错误处理
538        HDF_LOGE("RtcAlarmACallback:RTC Alarm callback function fail!\n\r");
539        return HDF_FAILURE;
540    }
541    return HDF_SUCCESS;
542}
543
544int32_t RtcTestSample(void)
545{
546    int32_t ret;
547    struct RtcTime tm;
548    struct RtcTime alarmTime;
549    uint32_t freq;
550    uint8_t usrDefIndex = 0;
551    uint8_t value = 0;
552    DevHandle handle = NULL;
553
554    // 获取RTC设备句柄
555    handle = RtcOpen();
556    if (handle == NULL) {
557        HDF_LOGE("RtcTestSample:open rtc fail!");
558        return HDF_FAILURE;
559    }
560    // 注册报警A的定时回调函数
561    ret = RtcRegisterAlarmCallback(handle, RTC_ALARM_INDEX_A, RtcAlarmACallback);
562    if (ret != HDF_SUCCESS) {
563        HDF_LOGE("RtcTestSample:register alarm callback fail, ret:%d", ret);
564        goto ERR;
565    }
566    // 设置RTC外接晶体振荡频率,注意按照器件手册要求配置RTC外频
567    freq = 32768; // 32768 Hz
568    ret = RtcSetFreq(handle, freq);
569    if (ret != HDF_SUCCESS) {
570        HDF_LOGE("RtcTestSample:set freq fail, ret:%d", ret);
571        goto ERR;
572    }
573
574    freq = 0;
575    ret = RtcGetFreq(handle, &freq);
576    if (ret != HDF_SUCCESS) {
577        HDF_LOGE("RtcTestSample:get freq fail, ret:%d", ret);
578        goto ERR;
579    }
580
581    // 设置RTC报警中断使能
582    ret = RtcAlarmInterruptEnable(handle, RTC_ALARM_INDEX_A, 1);
583    if (ret != HDF_SUCCESS) {
584        HDF_LOGE("RtcTestSample:alarm interrupt enable fail, ret:%d", ret);
585        goto ERR;
586    }
587    // 设置RTC时间为2020/01/01 00:00:10 .990
588    tm.year = 2020;
589    tm.month = 01;
590    tm.day = 01;
591    tm.hour= 0;
592    tm.minute = 0;
593    tm.second = 10;
594    tm.millisecond = 990;
595    // 写RTC时间信息
596    ret = RtcWriteTime(handle, &tm);
597    if (ret != HDF_SUCCESS) {
598        HDF_LOGE("RtcTestSample:write time fail, ret:%d", ret);
599        goto ERR;
600    }
601    // 设置RTC报警时间为2020/01/01 00:00:30 .100
602    alarmTime.year = 2020;
603    alarmTime.month = 01;
604    alarmTime.day = 01;
605    alarmTime.hour = 0;
606    alarmTime.minute = 0;
607    alarmTime.second = 30;
608    alarmTime.millisecond = 100;
609    // 设置RTC_ALARM_INDEX_A索引定时报警时间信息, 定时时间到后会打印"RTC Alarm A callback function"
610    ret = RtcWriteAlarm(handle, RTC_ALARM_INDEX_A, &alarmTime);
611    if (ret != HDF_SUCCESS) {
612        HDF_LOGE("RtcTestSample:write alarm fail, ret:%d", ret);
613        goto ERR;
614    }
615    OsalSleep(5);
616
617    ret = RtcReadAlarm(handle, RTC_ALARM_INDEX_A, &alarmTime);
618    if (ret != HDF_SUCCESS) {
619        HDF_LOGE("RtcTestSample: read alarm fail, ret: %d!", ret);
620        goto ERR;
621    }
622    // 读取RTC实时时间
623    ret = RtcReadTime(handle, &tm);
624    if (ret != HDF_SUCCESS) {
625        HDF_LOGE("RtcTestSample:read time fail, ret:%d", ret);
626        goto ERR;
627    }
628
629    ret = RtcWriteReg(handle, usrDefIndex, value);
630    if (ret != HDF_SUCCESS) {
631        HDF_LOGE("RtcTestSample: write reg fail, ret: %d!", ret);
632        return ret;
633    }
634
635    ret = RtcReadReg(handle, usrDefIndex, &value);
636    if (ret != HDF_SUCCESS) {
637        HDF_LOGE("RtcTestSample: read reg fail, ret :%d!", ret);
638        return ret;
639    }
640
641    HDF_LOGD("RtcTestSample: RTC read time:\n\r");
642    HDF_LOGD("RtcTestSample: year-month-date-weekday hour:minute:second .millisecond %04u-%02u-%02u-%u %02u:%02u:%02u .%03u",
643        tm.year, tm.month, tm.day, tm.weekday, tm.hour, tm.minute, tm.second, tm.millisecond);
644    HDF_LOGD("RtcTestSample: all test end.");
645
646ERR:
647    // 销毁RTC设备句柄
648    RtcClose(handle);
649    return ret;
650}
651```
652