RTC 类 – 实时时钟

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

用法示例:

rtc = pyb.RTC()
rtc.datetime((2014, 5, 1, 4, 13, 0, 0, 0))
print(rtc.datetime())

构造函数

class pyb.RTC

创建一个 RTC 对象。

方法

RTC.datetime([datetimetuple])

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

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

8 元组具有以下格式:

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

weekday周一至周日为 1-7。

subseconds从 255 倒数到 0

RTC.wakeup(timeout, callback=None)

将 RTC 唤醒定时器设置为每timeout 毫秒重复触发。此触发器可以将 pyboard 从睡眠状态唤醒:pyb.stop()pyb.standby()

如果 timeoutNone 则禁用唤醒定时器。

如果 callback 给出,则在唤醒定时器的每次触发时执行。 callback必须只采用一个参数。

RTC.info()

获取有关启动时间和重置源的信息。

  • 较低的 0xffff 是 RTC 启动所用的毫秒数。

  • 如果发生上电复位,则设置位 0x10000。

  • 如果发生外部复位,则设置位 0x20000

RTC.calibration(cal)

获取或设置 RTC 校准。

不带参数,calibration() 返回当前校准值,它是 [-511 : 512] 范围内的整数。用一个参数设置 RTC 校准。

RTC 平滑校准机制通过在 32 秒周期内(对应于 2^20 个时钟滴答)从 32768 Hz 时钟中添加或减去给定数量的滴答来调整 RTC 时钟速率。添加的每个滴答将使时钟加快 1 部分2^20 或 0.954 ppm;同样,RTC 时钟也减慢了负值。可用的校准范围是:(-511 * 0.954) ~= -487.5 ppm 到 (512 * 0.954) ~= 488.5 ppm