RT-Thread-packages/micropython @ 60fede52da2bda603f64119b086ec600fd642cff

machine.RTC

machine.RTC 类是 machine 模块下面的一个硬件类，用于对指定 RTC 设备的配置和控制，提供对 RTC 设备的操作方法。

RTC（Real-Time Clock ）实时时钟可以提供精确的实时时间，它可以用于产生年、月、日、时、分、秒等信息。

构造函数

在 RT-Thread MicroPython 中 RTC 对象的构造函数如下：

class machine.RTC()

目前 RT-Thread 系统内只允许存在一个 RTC 设备，其名称为 "rtc"。

所以在给定的总线上结构一个 RTC 对象，无入参对象，默认初始化设备名称为 “rtc” 的设备，初始化方式可参考示例。

方法

RTC.init(datetime)

根据传入的参数初始化 RTC 设备起始时间。入参 datatime 为一个时间元组，格式如下：

(year, month, data[, wdata[, hour[, minute[, second[, yday]]]])

year：年份；
month：月份，范围 [1, 12]；
data：日期，范围 [1, 31]；
wdata：星期，范围 [0, 6]，0 表示星期一，以此类推；
hour：小时，范围 [0, 23]；
minute：分钟，范围[0, 59]；
second：秒，范围[0, 59]；
yday：从当前年份 1 月 1 日开始的天数，范围 [0, 365]，一般置位 0 未实现。

RTC.deinit()

重置 RTC 设备时间到 2015 年 1 月 1日，重新运行 RTC 设备。

RTC.now()

获取当前时间，返回值为上述 datatime 时间元组格式。

示例

>>> from machine import RTC
>>>
>>> rtc = RTC()                        # create rtc device object
>>> rtc.init((2019,6,5,2,10,22,30,0))  # set init time 
>>> rtc.now()                          # get local time
(2019, 6, 5, 2, 10, 22, 40, 0)
>>>
>>> rtc.deinit()                       # reset time to 2015.1.1
>>> rtc.now()                          # get local time
(2015, 1, 1, 3, 0, 0, 1, 0)

07-machine-RTC.md 1.9 KB Histórico Raw