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 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.h。 40 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 66 67#### 创建RTC设备句柄 68 69RTC驱动加载成功后,使用驱动框架提供的查询接口并调用RTC设备驱动接口。 70 71>  **说明:**<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 >  **说明:**<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 >  **说明:**</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