Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
SummerGao.
rt-thread
提交
ae867e1b
R
rt-thread
项目概览
SummerGao.
/
rt-thread
与 Fork 源项目一致
Fork自
RT-Thread / rt-thread
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
R
rt-thread
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
ae867e1b
编写于
2月 16, 2018
作者:
armink_ztl
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
[DeviceDriver][RTC] Add readme doc.
上级
cd237280
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
80 addition
and
0 deletion
+80
-0
components/drivers/rtc/README.md
components/drivers/rtc/README.md
+80
-0
未找到文件。
components/drivers/rtc/README.md
0 → 100644
浏览文件 @
ae867e1b
# 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 设置日期
```
C
rt_err_t set_date(rt_uint32_t year, rt_uint32_t month, rt_uint32_t day)
```
|参数 |描述|
|:----- |:----|
|year |待设置生效的年份|
|month |待设置生效的月份|
|day |待设置生效的日|
### 2.2 设置时间
```
C
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 启用 NTP 时间自动同步
如果 RT-Thread 已接入互联网,可启用 NTP 时间自动同步功能,定期同步本地时间。
在 menuconfig 中启用
`RTC_SYNC_USING_NTP`
配置。启用该功能后,会自动开启
[
netutils package
](
https://github.com/RT-Thread-packages/netutils
)
的 NTP 功能。同时务必确保 RT-Thread 网络访问正常。
启用该配置后,还有两个配置是用户可选配置:
-
`RTC_NTP_FIRST_SYNC_DELAY`
: 首次执行 NTP 时间同步的延时。延时的目的在于,给网络连接预留一定的时间,尽量提高第一次执行 NTP 时间同步时的成功率。默认时间为 30S;
-
`RTC_NTP_SYNC_PERIOD`
: NTP 自动同步周期,单位为秒,默认一小时(即 3600S)同步一次。
> 注意:如果没有使用组件自动初始化功能,则需手动调用 `int rt_rtc_ntp_sync_init(void)` ,完成该功能初始化。
### 2.5 启用 Soft RTC (软件模拟 RTC)
这个模式非常适用于对时间精度要求不高,没有硬件 RTC 的产品。
#### 2.5.1 使用方法
在 menuconfig 中启用
`RT_USING_SOFT_RTC`
配置。
> 注意:如果没有使用组件自动初始化功能,则需手动调用 `int rt_soft_rtc_init(void)` ,完成该功能初始化。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录