machine.RTC

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

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

构造函数

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

class machine.RTC()

所以在给定的总线上构造一个 RTC 对象,无入参对象,使用方式可参考 示例

方法

RTC.init(datetime)

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

(year, month, day, wday, hour, minute, second, yday)

参数介绍如下所示:

  • year:年份;
  • month:月份,范围 [1, 12];
  • day:日期,范围 [1, 31];
  • wday:星期,范围 [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()

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

示例

>>> from machine import RTC
>>> rtc = RTC()                        # 创建 RTC 设备对象
>>> rtc.init((2019,6,5,2,10,22,30,0))  # 设置初始化时间
>>> rtc.now()                          # 获取当前时间
(2019, 6, 5, 2, 10, 22, 40, 0)
>>> rtc.deinit()                       # 重置时间到2015年1月1日
>>> rtc.now()                          # 获取当前时间
(2015, 1, 1, 3, 0, 0, 1, 0)

Question && Feedback