@amperka/buzzer

JS-модуль для работы с модулем зуммера и другими пьезоизлучателями звука.

Звук пищалки — простой и эффективный способ подтвердить пользователю завершение действия или предупредить об опасности. Используйте модуль, чтобы делать это легко.

var myBuzzer = require('@amperka/buzzer').connect(P6);
 
myBuzzer.turnOn();
myBuzzer.frequency(2000);
myBuzzer.toggle();
myBuzzer.beep(0.5, 0.5);

connect(pin)

Возвращает новый объект Buzzer для работы с зуммером подключённому к пину pin. Пин должен поддерживать широтно-импульсную модуляцию.

По умолчанию зуммер выключен, частота установлена в 2000 Гц.

Buzzer

Класс для работы с пьезоизлучателем. Чтобы создать новый экземпляр, используйте функцию connect.

Buzzer.turnOn()

Включает звук. Эквивалентно toggle(true).

Buzzer.turnOff()

Выключает звук. Эквивалентно toggle(false).

Buzzer.toggle([on])

Устанавливает включённость звука в соответствие со значением on:

true — включает
false — выключает
не передавался — переключает на противоположное текущему

Buzzer.isOn()

Возвращает true, если звук включён в момент вызова.

Buzzer.beep(onTime[, offTime])

Заставляет зуммер издавать периодический прерывистый звуковой сигнал: onTime секунд — включен, offTime секунд — выключен.

Последующий вызов методов turnOn, turnOff, toggle прекращает прерывистый сигнал.

Если параметр offTime опущен, зуммер издаст одиночный звуковой сигнал длительностью onTime секунд.

Buzzer.frequency([freq])

Устанавливает или возвращает частоту звука в герцах.

Частота не влияет на методы, отвечающие за включение (toggle, beep и др.). Она определяет лишь тональность генерации звука.

Содержание