class RTC – real time clock¶
The RTC is and independent clock that keeps track of the date and time.
Example usage:
rtc = machine.RTC()
rtc.datetime((2014, 5, 1, 4, 13, 0, 0, 0))
print(rtc.datetime())
Constructors¶
-
class
machine.RTC(id=0, ...)¶ Create an RTC object. See init for parameters of initialization.
Methods¶
-
rtc.init(id, datetime)¶ Initialise the RTC. Datetime is a tuple of the form:
(year, month, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]])
-
rtc.now()¶ Get get the current datetime tuple.
-
rtc.deinit()¶ Resets the RTC to the time of January 1, 2015 and starts running it again.
-
rtc.alarm(id, time, /*, repeat=False)¶ Set the RTC alarm. Time might be either a milllisecond value to program the alarm to current time + time_in_ms in the future, or a datetimetuple. If the time passed is in milliseconds, repeat can be set to
Trueto make the alarm periodic.
-
rtc.alarm_left(alarm_id=0)¶ Get the number of milliseconds left before the alarm expires.
-
rtc.cancel(alarm_id=0)¶ Cancel a running alarm.
-
rtc.irq(*, trigger, handler=None, wake=machine.IDLE)¶ Create an irq object triggered by a real time clock alarm.
triggermust beRTC.ALARM0handleris the function to be called when the callback is triggered.wakespecifies the sleep mode from where this interrupt can wake up the system.