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))


class pyb.RTC

Create an RTC object.



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.

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

rtc.callback(*, value, handler=None, wakes=pyb.Sleep.ACTIVE)

Create a callback object triggered by a real time clock alarm.

  • value is the alarm timeout in milliseconds. This parameter is required.
  • handler is the function to be called when the callback is triggered.
  • wakes specifies the power mode from where this interrupt can wake up the system.