====== @amperka/led ======
Библиотека для управления [[amp>product/troyka-led-module|светодиодным модулем]] и другими одиночными светодиодами.
var myLed = require('@amperka/led').connect(P3);
myLed.turnOn();
myLed.brightness(0.6);
myLed.turnOff();
myLed.blink(0.9, 0.1);
===== Функции модуля =====
func:: connect(pin)
Возвращает новый объект ''Led'' для работы со светодиодом на пине ''pin''.
class:: Led
Класс-светодиод. Для создания нового объекта, используйте функцию ''connect''.
meth:: Led.turnOn()
Включает светодиод. Эквивалентно ''Led.toggle(true)''.
meth:: Led.turnOff()
Выключает светодиод. Эквивалентно ''Led.toggle(false)''.
meth:: Led.toggle([on])
Изменяет включёность светодиода на заданную аргументом ''on''. Если ''on'' не передан, меняет включёность на противоположную.
meth:: Led.isOn()
Возвращает ''true'', если светодиод включен в текущий момент.
meth:: Led.blink(onTime[, offTime])
Заставляет светодиод мигать в заданном темпе: ''onTime'' секунд — включен, ''offTime'' секунд — выключен.
Последующий вызов методов ''turnOn'', ''turnOff'', ''toggle'' прекращает мигание.
Если ''offTime'' опущен, светодиод включится на ''onTime'' секунд единоразово.
meth:: Led.brightness([value])
Устанавливает или возвращает яркость свечения. Яркость устанавливается в условных единицах в диапазоне [0.0; 1.0].
Яркость свечения не влияет на методы, отвечающие за включение (''toggle'', ''blink'' и т.д.). Она характеризует лишь интенсивность свечения, когда светодиод находится во включённом состоянии.