RTC 类 – 实时时钟

RTC 是一个独立的时钟,用于跟踪日期和时间。

用法示例:

rtc = machine.RTC()
rtc.datetime((2020, 1, 21, 2, 10, 32, 36, 0))
print(rtc.datetime())

构造函数

class machine.RTC(id=0, ...)

创建一个 RTC 对象。初始化参数见init。

方法

RTC.datetime([datetimetuple])

获取或设置 RTC 的日期和时间。

在没有参数的情况下,此方法返回一个包含当前日期和时间的 8 元组。使用 1 个参数(是一个 8 元组),它设置日期和时间。

8 元组具有以下格式:

(年、月、日、工作日、小时、分钟、秒、亚秒)

subseconds字段的含义取决于硬件。

RTC.init(datetime)

初始化 RTC。日期时间是以下形式的元组:

(year, month, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]])

RTC.now()

获取当前日期时间元组。

RTC.deinit()

将 RTC 重置为 2015 年 1 月 1 日的时间并再次开始运行。

RTC.alarm(id, time, *, repeat=False)

设置 RTC 闹钟。时间可能是一个毫秒值,用于将警报编程为未来的当前时间 + time_in_ms,或者是一个日期时间元组。如果经过的时间以毫秒为单位,可以设置repeat True 使闹钟具有周期性。

RTC.alarm_left(alarm_id=0)

获取警报到期前剩余的毫秒数。

RTC.cancel(alarm_id=0)

取消正在运行的警报。

RTC.irq(*, trigger, handler=None, wake=machine.IDLE)

创建一个由实时时钟警报触发的 irq 对象。

  • trigger必须是 RTC.ALARM0

  • handler是触发回调时要调用的函数。

  • wake 指定此中断可以唤醒系统的睡眠模式。

常数

RTC.ALARM0

irq 触发源