<WRAP apidoc/>

====== @amperka/buzzer ======

JS-модуль для работы с [[amp>product/troyka-buzzer|модулем зуммера]] и другими пьезоизлучателями звука.

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

<code javascript>
var myBuzzer = require('@amperka/buzzer').connect(P6);

myBuzzer.turnOn();
myBuzzer.frequency(2000);
myBuzzer.toggle();
myBuzzer.beep(0.5, 0.5);
</code>
func:: connect(pin)

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

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

class:: Buzzer

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

meth:: Buzzer.turnOn()

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

meth:: Buzzer.turnOff()

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

meth:: Buzzer.toggle([on])

Устанавливает включённость звука в соответствие со значением ''on'':
  * ''true'' — включает
  * ''false'' — выключает
  * не передавался — переключает на противоположное текущему

meth:: Buzzer.isOn()

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

meth:: Buzzer.beep(onTime[, offTime])

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

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

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

meth:: Buzzer.frequency([freq])

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

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