Функция pulseIn в Arduino IDE: измерение длительности импульсов с легкостью

Функция используется для считывания длины импульса сигнала заданного уровня на заданном пине. Если задан уровень HIGH (логическая единица), то функция будет ожидать появления этого уровня на пине, затем включит таймер и остановит его тогда, когда на пине снова образуется логический ноль (LOW).

Если за определённый таймаут, который может быть задан входным параметром функции, на пине не появится ожидаемый логический уровень, то функция вернёт 0, в противном случае – длительность считанного импульса в микросекундах.

Не рекомендуется использовать для считывания длинных импульсов, хотя теоретически возможно считывание импульса длиной до 3 минут.

Синтаксис

pulseIn(pin, value)

pulseIn(pin, value, timeout)

Параметры

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

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

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

Замечания

В случае нахождения входа в высокоимпедансном состоянии, на нём будут возникать случайные значения, которые можно использовать как «зерно» для генератора псевдослучайных чисел.

Пример использования

int pin = 7;
unsigned long duration;

void setup()
{
  pinMode(pin, INPUT);
}

void loop()
{
  duration = pulseIn(pin, HIGH);
}

int pin = 7;

unsigned long duration;

void setup()

{

pinMode(pin, INPUT);

}

void loop()

{

duration = pulseIn(pin, HIGH);

}

Смотрите также

Функция tone()
Функция noTone()
Функция shiftOut()