Arduino:Библиотеки/MsTimer2

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

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



Библиотека MsTimer2[1]

Эта маленькая и простая в использовании библиотека служит «интерфейсом» между timer2 и пользователем. Она позволяет периодически запускать нужную функцию и настраивать, какой будет продолжительность у этого периода. Она называется «MsTimer2», потому что «зашивает» в timer2 разрешение в 1 миллисекунду (ms).

Лицензия – LGPL. Автор – Хавьер Валенсиа (Javier Valencia).

Загрузка

Чтобы загрузить библиотеку, пройдите по этой ссылке, кликните на зеленую кнопку Clone or download, а затем на Download ZIP. Когда ZIP-файл скачается, распакуйте его. Проверьте эту папку на наличие файлов «MsTimer2.cpp» и «MsTimer2.h».

Установка

Чтобы использовать библиотеку, поместите распакованный ZIP-файл в папку для библиотек IDE Arduino. Чтобы узнать, где находится эта папка на PC, откройте IDE Arduino, кликните на Файл > Настройки (File > Preferences) – адрес папки будет указан в самом верху, в поле «Размещение папки скетчей» (Sketchbook location). Затем перезапустите IDE Arduino. Если папки «libraries» нет, ее нужно создать.

FlexiTimer2

У библиотеки MsTimer2 есть разновидность FlexiTimer2, написанная Уимом Лирсом (Wim Leers). Она позволяет поменять разрешение временного интервала, тогда как в MsTimer2 оно «зашито» на 1 миллисекунде. Скачать эту библиотеку можно тут.

Функции

  • Функция MsTimer2::set(ms, (*f)()) задает нужный временной интервал в миллисекундах (первый аргумент; ms). При завершении интервала будет вызвана «f». Ее нужно вызывать пустой, безо всяких аргументов.
  • Функция MsTimer2::start() включает прерывание.
  • Функция MsTimer2::stop() отключает прерывание.

Проблемы с контекстом прерывания

Библиотеки MsTimer2 и FlexiTimer2 вызывают функцию из контекста прерывания. Таким образом, работа вашего скетча может быть прервана в любой момент, поэтому чтобы эти данные могли быть использованы и в остальной части скетча, с его написанием придется немного помудрить.

Во-первых, переменные в таком скетче должны быть волатильными. Это намекнет компилятору, что нужно избегать оптимизаций, которые предполагают, что значения в переменных постоянны и не могут ни с того, ни с сего вдруг измениться. Это своеобразная «подсказка», которая необходима вашему компилятору, потому что ваша функция может поменять значения в этих переменных, пока скетч их использует. Но одних волатильных переменных недостаточно.

Когда разные системы запрашивают доступ к одной и той же переменной, прерывания должны быть отключены. Если прерывание «вклинится» в серию команд и поменяет многобайтную переменную, она может быть считана некорректно. Если ваши данные – как раз такие (это может быть, к примеру, массив), то на время запуска серии всех команд, имеющихся в скетче и обладающих доступ к изменяемым данным, прерывание нужно выключить.

Примеры

  • FlashLed - Периодическое включение и выключение светодиода

См.также

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