MicroPython:Библиотеки/machine/Класс RTC: различия между версиями
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Myagkij (обсуждение | вклад) (Новая страница: «{{MicroPython/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} <syntaxhighlight lang="python" enclose="div"> =...») |
Myagkij (обсуждение | вклад) Нет описания правки |
||
Строка 3: | Строка 3: | ||
{{Myagkij-редактор}} | {{Myagkij-редактор}} | ||
=Класс RTC – часы реального времени<ref>[http://docs.micropython.org/en/latest/library/machine.RTC.html docs.micropython.org - class RTC – real time clock]</ref>= | |||
RTC (от англ. «real time clock») – это часы реального времени, работающие независимо от остального устройства и ведущие отсчет даты и времени. | |||
Пример использования: | |||
<syntaxhighlight lang="python" enclose="div"> | |||
rtc = machine.RTC() | |||
rtc.init((2014, 5, 1, 4, 13, 0, 0, 0)) | |||
print(rtc.now()) | |||
</syntaxhighlight> | |||
==Конструкторы== | |||
* [[MicroPython:Библиотеки/machine/Класс RTC/machine.RTC()|machine.RTC()]] | |||
* Класс machine.RTC(id=0, ...) – создает объект RTC. Аргументы для инициализации смотрите в описании функции init(). | |||
==Методы== | |||
* [[MicroPython:Библиотеки/machine/Класс RTC/RTC.init()|RTC.init()]] | |||
* [[MicroPython:Библиотеки/machine/Класс RTC/RTC.now()|RTC.now()]] | |||
* [[MicroPython:Библиотеки/machine/Класс RTC/RTC.deinit()|RTC.deinit()]] | |||
* [[MicroPython:Библиотеки/machine/Класс RTC/RTC.alarm()|RTC.alarm()]] | |||
* [[MicroPython:Библиотеки/machine/Класс RTC/RTC.alarm_left()|RTC.alarm_left()]] | |||
* [[MicroPython:Библиотеки/machine/Класс RTC/RTC.cancel()|RTC.cancel()]] | |||
* [[MicroPython:Библиотеки/machine/Класс RTC/RTC.irq()|RTC.irq()]] | |||
* 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 – это режим сна, из которого это прерывание пробуждает систему. | |||
==Константы== | |||
* [[MicroPython:Библиотеки/machine/Класс RTC/RTC.ALARM0|RTC.ALARM0]] | |||
* RTC.ALARM0 – источник запуска прерывания. | |||
<syntaxhighlight lang="python" enclose="div"> | <syntaxhighlight lang="python" enclose="div"> |
Версия от 10:08, 20 сентября 2020
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
Класс 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">