MicroPython:Библиотеки/machine/Класс RTC: различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
(Новая страница: «{{MicroPython/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} <syntaxhighlight lang="python" enclose="div"> =...»)
 
Нет описания правки
Строка 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">

См.также

Внешние ссылки