rt-thread/components/drivers/rtc
Yang sheng eb2fc60207
[bsp] Make all warnings into errors with qemu-vexpress-a9 qemu-virt64… (#5785)
* [bsp] Make all warnings into errors with qemu-vexpress-a9 qemu-virt64-aarch64 and stm32f411-st-nucleo.
* [RTC] Fix compile errors
2022-04-09 00:39:00 +08:00
..
README.md 移除readme关于NTP部分 2021-05-09 16:10:58 +08:00
SConscript [rtc] 移除rtc_core.c/.h 将内容转移到rtc.c/.h 2021-07-30 03:24:50 +08:00
alarm.c [bsp] Make all warnings into errors with qemu-vexpress-a9 qemu-virt64… (#5785) 2022-04-09 00:39:00 +08:00
rtc.c [drivers][rtc]Add comments 2022-04-06 10:26:04 +08:00
soft_rtc.c [core] 使用rt_memcpy rt_memset代替memcpy memset 2022-01-09 00:23:18 +08:00

README.md

RT-Thread RTC 设备

1、介绍

RT-Thread 的 RTC (实时时钟)设备为操作系统的时间系统提供了基础服务。面对越来越多的 IoT 场景RTC 已经成为产品的标配,甚至在诸如 SSL 的安全传输过程中RTC 已经成为不可或缺的部分。

2、使用

应用层对于 RTC 设备一般不存在直接调用的 API ,如果使用到 C 标准库中的时间 API (目前主要是获取当前时间的 time_t time(time_t *t)),则会间接通过设备的 control 接口完成交互。

注意:目前系统内只允许存在一个 RTC 设备,且名称为 "rtc"

2.1 设置日期

rt_err_t set_date(rt_uint32_t year, rt_uint32_t month, rt_uint32_t day)
参数 描述
year 待设置生效的年份
month 待设置生效的月份
day 待设置生效的日

2.2 设置时间

rt_err_t set_time(rt_uint32_t hour, rt_uint32_t minute, rt_uint32_t second)
参数 描述
hour 待设置生效的时
minute 待设置生效的分
second 待设置生效的秒

2.3 使用 Finsh/MSH 命令 查看/设置 日期和时间

2.3.1 查看日期和时间

输入 date 即可,大致效果如下:

msh />date
Fri Feb 16 01:11:56 2018
msh />

2.3.2 设置日期和时间

同样使用 date 命令,在命令后面再依次输入 (中间空格隔开, 24H 制),大致效果如下:

msh />date 2018 02 16 01 15 30    # 设置当前时间为 2018-02-16 01:15:30
msh />

2.4 启用 Soft RTC (软件模拟 RTC

这个模式非常适用于对时间精度要求不高,没有硬件 RTC 的产品。

2.4.1 使用方法

在 menuconfig 中启用 RT_USING_SOFT_RTC 配置。