summaryrefslogtreecommitdiff
path: root/docs/library/pyb.RTC.rst
diff options
context:
space:
mode:
authorDamien George <damien.p.george@gmail.com>2018-07-18 15:47:44 +1000
committerDamien George <damien.p.george@gmail.com>2018-07-18 15:47:44 +1000
commit805fd0cfe6880153b990acc19f547e740b87f23d (patch)
treee0c567712a6a9cdf08acf5e180c1a35835b1d223 /docs/library/pyb.RTC.rst
parent419eb8607415c3a0e47ebef231c7e57118924eee (diff)
docs/library: Remove "only" directive from all pyb module docs.
By virtue of its name, the pyb module would only be available on a pyboard and so does not need to have conditional "only" directives throughout its documentation. These conditionals were added mostly in cfcf47c0644952358e1a260db159e807872a37e6 in the initial development of the cc3200 port, which had the pyb module before it switched to the machine module. And wipy only conditionals were removed from the pyb module documentation in 4542643025c77a7272bde348b89d5039aea28d23, so there's no need to retain any more conditionals.
Diffstat (limited to 'docs/library/pyb.RTC.rst')
-rw-r--r--docs/library/pyb.RTC.rst87
1 files changed, 41 insertions, 46 deletions
diff --git a/docs/library/pyb.RTC.rst b/docs/library/pyb.RTC.rst
index 1a1df9095..286268655 100644
--- a/docs/library/pyb.RTC.rst
+++ b/docs/library/pyb.RTC.rst
@@ -33,51 +33,46 @@ Methods
date and time. With 1 argument (being an 8-tuple) it sets the date
and time (and ``subseconds`` is reset to 255).
- .. only:: port_pyboard
+ The 8-tuple has the following format:
- 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
-
-.. only:: port_pyboard
-
- .. 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
+ (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