MicroPython:Библиотеки/machine.TimerWiPy

Содержание

Введение

Основы

Примеры

Библиотеки

Программы

Платы

Прошивки

Резерв

Резерв

Перевод: Максим Кузьмин

Проверка/Оформление/Редактирование: Мякишев Е.А.

Класс TimerWiPy – управление аппаратными таймерами

Примечание: Этот класс – это нестандартная реализация класса Timer для WiPy. На WiPy он именуется machine.Timer, но в документации ниже он именуется machine.TimerWiPy, чтобы отличить его от более общего класса machine.Timer.

Аппаратные таймеры нужны для работы с периодами и событиями. Таймеры – это, возможно, самый универсальный и неоднородный тип оборудования в микроконтроллерах и SoC-системах. Таймеры, установленные в разные модели, могут очень сильно отличаться друг от друга. В MicroPython’овском классе Timer определена базовая операция периодического запуска функции обратного вызова через заданное время (или один раз после задержки). Но в то же время этот класс позволяет задавать более нестандартное поведение для отдельных плат (не портируемое на другие платы).

О важных ограничениях использования функций обратного вызова в классе Timer читайте тут.

Примечание: Внутри прерываний память выделять нельзя, и поэтому исключения, возбуждаемые внутри обработчиков (функций обратного вызова), будут малоинформативны. О том, как обойти это ограничение, читайте в описании метода micropython.alloc_emergency_exception_buf().

Конструкторы

• machine.TimerWiPy(id, ...)

Методы

• TimerWiPy.init(mode, *, width=16)
• TimerWiPy.deinit()
• TimerWiPy.channel(channel, **, freq, period, polarity=TimerWiPy.POSITIVE, duty_cycle=0)

• TimerWiPy.deinit() – деинициализирует таймер. Останавливает таймер и отключает таймерный компонент. • TimerWiPy.channel(channel, **, freq, period, polarity=TimerWiPy.POSITIVE, duty_cycle=0) – если в этом методе задан аргумент channel (идентификатор канала), то он вернет ранее инициализированный объект TimerChannel (или None, если ранее никакого объекта TimerChannel инициализировано не было). В противном случае будет инициализирован и возвращен новый объект TimerChannel. Режимом работы будет тот, что был настроен в объекте Timer, который использовался для создания канала. o channel – если разрядность данных таймера составляет 16 бит, здесь должно быть TIMER.A или TIMER.B, а если 32 бита, то здесь должно быть TIMER.A | TIMER.B. Именованные аргументы: o freq – задает частоту (в герцах). o period – задает период (в микросекундах). Примечание: Нужно задавать либо freq, либо period, но никогда не оба аргумента одновременно. o polarity – этот аргумент нужен для ШИМ, и в нем задается полярность ШИМ-сигнала. o duty_cycle – это коэффициент заполнения ШИМ (этот аргумент нужен только для ШИМ). Это процентное значение (0.00-100.00). Поскольку WiPy не поддерживает числа с плавающей точкой, значение здесь должно быть задано в диапазоне 0-10000, где «10000» – означает 100.00%, 5050 – 50.50% и т.д. Примечание: Когда канал работает в ШИМ-режиме, соответствующий контакт присваивается автоматически, что избавляет от необходимости присваивать контакту альтернативную функцию при помощи класса Pin. ШИМ поддерживают следующими контактами: o GP24 – таймер 0, канал A. o GP25 – таймер 1, канал A. o GP9 – таймер 2, канал B. o GP10 – таймер 3, канал A. o GP11 – таймер 3, канал B.