MicroPython:Библиотеки/machine/Класс RTC
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
Класс RTC – часы реального времени[1]
RTC (от англ. «real time clock») – это часы реального времени, работающие независимо от остального устройства и ведущие отсчет даты и времени.
Пример использования:
rtc = machine.RTC()
rtc.init((2014, 5, 1, 4, 13, 0, 0, 0))
print(rtc.now())
Конструкторы
- Класс machine.RTC(id=0, ...) – создает объект RTC. Аргументы для инициализации смотрите в описании функции init().
Методы
- RTC.init(datetime) – инициализирует объект RTC. Значение в аргументе datetime – это кортеж следующей формы:
(year, month, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]])
- RTC.now() – считывает текущие время/дату в виде кортежа.
- RTC.deinit() – сбрасывает RTC-время к 1 января 2015 года и снова запускает часы.
- RTC.alarm(id, time, *, repeat=False) – задает будильник для RTC-часов. Значение в аргументе time можно задать либо в миллисекундах (и тогда будильник сработает в момент «текущее время + время в миллисекундах»), либо в кортеже с датой и временем. Если время задано в миллисекундах, то в аргументе repeat можно задать True, и тогда будильник будет срабатывать неоднократно.
- RTC.alarm_left(alarm_id=0) – считывает количество миллисекунд, оставшихся до срабатывания будильника.
- RTC.cancel(alarm_id=0) – отключает работающий будильник.
- RTC.irq(*, trigger, handler=None, wake=machine.IDLE) – создает объект запроса на прерывание, которое будет запускаться при срабатывании RTC-будильника.
- trigger – здесь должно быть значение RTC.ALARM0.
- handler – функция обратного вызова, вызываемая при срабатывании RTC-будильника.
- wake – это режим сна, из которого это прерывание пробуждает систему.
Константы
- RTC.ALARM0 – источник запуска прерывания.
<syntaxhighlight lang="python" enclose="div">
