Arduino:Справочник языка Arduino/Функции/Дополнительные функции ввода/вывода/pulseIn()

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

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


pulseIn()

Считывает длину сигнала на заданном порту (HIGH или LOW). Например, если задано считывание HIGH функцией pulseIn(), функция ожидает пока на заданном порту не появиться HIGH. Когда HIGH получен, включается таймер, который будет остановлен когда на порту вход/выхода будет LOW. Функция pulseIn() возвращает длину сигнала в микросекундах. Функция возвращает 0, если в течение заданного времени (таймаута) не был зафиксирован сигнал на порту.

Возможны некоторые погрешности в измерение длинных сигналов. Функция может измерять сигналы длиной от 10 микросекунд до 3 минут.

Синтаксис

pulseIn(pin, value)
pulseIn(pin, value, timeout)

Параметры

pin: номер порта входа/выхода, на котором будет ожидаться сигнал. (int)
value: тип ожидаемого сигнала — HIGH или LOW.
timeout (опционально): время ожидания сигнала (таймаут) в микросекундах; по умолчанию - одна секунда. (unsigned long)

Возвращаемое значение

Длина сигнала в микросекундах или 0, если сигнал не получен до истечения таймаута. (unsigned long)

Пример

  1. int pin = 7;
  2. unsigned long duration;
  3.  
  4. void setup()
  5. {
  6.   pinMode(pin, INPUT);
  7. }
  8.  
  9. void loop()
  10. {
  11.   duration = pulseIn(pin, HIGH);
  12. }

См.также

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