docs/library/pyb.RTC.rst · QuecPython/microPython

代码拉取完成,页面将自动刷新

richgiteeai

Watch

不关注关注所有动态仅关注版本发行动态关注但不提醒动态

6 Star 12 Fork 11

QuecPython/microPython

代码 Issues 0 Pull Requests 0 Wiki 统计流水线

服务

加入 Gitee

与超过 1400万开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)

免费加入

已有帐号? 立即登录

文件

master

分支 (2)

管理

master

review

克隆/下载

HTTPS SSH SVN SVN+SSH 下载ZIP

提示

下载代码请复制以下命令到终端执行

为确保你提交的代码身份被 Gitee 正确识别,请执行以下命令完成配置

git config --global user.name userName 
git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时,需按下述提示完成 SSH 配置

1 生成 RSA 密钥

2 获取 RSA 公钥内容,并配置到 SSH公钥中

在 Gitee 上使用 SVN,请访问使用指南

使用 HTTPS 协议时,命令行会出现如下账号密码验证步骤。基于安全考虑,Gitee 建议配置并使用私人令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com': # 私人令牌

分支 2

标签 0

microPython

docs

library

pyb.RTC.rst

pyb.RTC.rst 2.30 KB

.. currentmodule:: pyb
.. _pyb.RTC:

class RTC -- real time clock
============================

The RTC is and independent clock that keeps track of the date
and time.

Example usage::

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

Constructors
------------

.. class:: pyb.RTC()

Create an RTC object.

Methods
-------

.. method:: RTC.datetime([datetimetuple])

Get or set the date and time of the RTC.

With no arguments, this method returns an 8-tuple with the current
 date and time. With 1 argument (being an 8-tuple) it sets the date
 and time (and ``subseconds`` is reset to 255).

The 8-tuple has the following format:

(year, month, day, weekday, hours, minutes, seconds, subseconds)

``weekday`` is 1-7 for Monday through Sunday.

``subseconds`` counts down from 255 to 0

.. method:: RTC.wakeup(timeout, callback=None)

Set the RTC wakeup timer to trigger repeatedly at every ``timeout``
 milliseconds. This trigger can wake the pyboard from both the sleep
 states: :meth:`pyb.stop` and :meth:`pyb.standby`.

If ``timeout`` is ``None`` then the wakeup timer is disabled.

If ``callback`` is given then it is executed at every trigger of the
 wakeup timer. ``callback`` must take exactly one argument.

.. method:: RTC.info()

Get information about the startup time and reset source.

- The lower 0xffff are the number of milliseconds the RTC took to
 start up.
 - Bit 0x10000 is set if a power-on reset occurred.
 - Bit 0x20000 is set if an external reset occurred

.. method:: RTC.calibration(cal)

Get or set RTC calibration.

With no arguments, ``calibration()`` returns the current calibration
 value, which is an integer in the range [-511 : 512]. With one
 argument it sets the RTC calibration.

The RTC Smooth Calibration mechanism adjusts the RTC clock rate by
 adding or subtracting the given number of ticks from the 32768 Hz
 clock over a 32 second period (corresponding to 2^20 clock ticks.)
 Each tick added will speed up the clock by 1 part in 2^20, or 0.954
 ppm; likewise the RTC clock it slowed by negative values. The
 usable calibration range is:
 (-511 * 0.954) ~= -487.5 ppm up to (512 * 0.954) ~= 488.5 ppm

一键复制编辑原始数据按行查看历史

chenchi 提交于 2021年06月03日 16:44 +08:00 . first commit

.. currentmodule:: pyb

class RTC -- real time clock

The RTC is and independent clock that keeps track of the date and time.

Example usage:

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

Constructors

Create an RTC object.

Methods

.. method:: RTC.datetime([datetimetuple])

 Get or set the date and time of the RTC.

 With no arguments, this method returns an 8-tuple with the current
 date and time. With 1 argument (being an 8-tuple) it sets the date
 and time (and ``subseconds`` is reset to 255).

 The 8-tuple has the following format:

 (year, month, day, weekday, hours, minutes, seconds, subseconds)

 ``weekday`` is 1-7 for Monday through Sunday.

 ``subseconds`` counts down from 255 to 0

.. method:: RTC.wakeup(timeout, callback=None)

 Set the RTC wakeup timer to trigger repeatedly at every ``timeout``
 milliseconds. This trigger can wake the pyboard from both the sleep
 states: :meth:`pyb.stop` and :meth:`pyb.standby`.

 If ``timeout`` is ``None`` then the wakeup timer is disabled.

 If ``callback`` is given then it is executed at every trigger of the
 wakeup timer. ``callback`` must take exactly one argument.

.. method:: RTC.info()

 Get information about the startup time and reset source.

 - The lower 0xffff are the number of milliseconds the RTC took to
 start up.
 - Bit 0x10000 is set if a power-on reset occurred.
 - Bit 0x20000 is set if an external reset occurred

.. method:: RTC.calibration(cal)

 Get or set RTC calibration.

 With no arguments, ``calibration()`` returns the current calibration
 value, which is an integer in the range [-511 : 512]. With one
 argument it sets the RTC calibration.

 The RTC Smooth Calibration mechanism adjusts the RTC clock rate by
 adding or subtracting the given number of ticks from the 32768 Hz
 clock over a 32 second period (corresponding to 2^20 clock ticks.)
 Each tick added will speed up the clock by 1 part in 2^20, or 0.954
 ppm; likewise the RTC clock it slowed by negative values. The
 usable calibration range is:
 (-511 * 0.954) ~= -487.5 ppm up to (512 * 0.954) ~= 488.5 ppm