Библиотека позволяет получать расстояние в см, от датчика расстояния HC-SR04 до препятствия.
Данная библиотека использует внешнее прерывание, поэтому вывод ECHO датчика может быть подключён только к выводу Arduino использующему внешнее прерывание. Но благодаря прерыванию, библиотека не приостанавливает выполнение кода при ожидании ответа от датчика, которое может достигать 38 мс. Если Ваш код не критичен к таким задержкам, воспользуйтесь библиотекой без внешнего прерывания iarduino_HC_SR04, при использовании которой, датчики можно подключать к любым выводам Arduino. Так же датчики можно подключать к любым выводам при использовании библиотеки iarduino_HC_SR04_tmr которая не приостанавливает код во время чтения показаний, так как она постоянно опрашивает датчики в фоновом режиме используя второй аппаратный таймер Arduino.
Синтаксис трёх библиотек одинаков, но у библиотеки использующей аппаратный таймер есть две дополнительные функции begin() и work().
Подробное описание работы с библиотекой, находится в разделе Wiki - датчик HC-SR04.
#include <iarduino_HC_SR04_int.h> // Подключаем библиотеку
iarduino_HC_SR04_int ОБЪЕКТ( ВЫВОД_TRIG , ВЫВОД_ECHO ); // Создаём объект.
Функция distance( [ ТЕМПЕРАТУРА ] ); // Возвращает расстояние в см, принимая, в качестве необязательного параметра, температуру воздуха.
Переменная averaging // Положительное целое число - коэффициент усреднения показаний возвращаемых функцией distance().