<WRAP apidoc/>
====== @amperka/light-sensor ======

JS-модуль для работы с [[amp>product/troyka-light-sensor|модулем датчика освещённости]].

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

<code javascript>
var mySensor = require('@amperka/light-sensor').connect(A0);

console.log('Room lightness:', mySensor.read('lx'), 'luxes');
</code>

func:: connect(pin)

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

class:: LightSensor

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

meth:: LightSensor.read([units])

Возвращает значение освещённости в единицах, заданными параметром ''unit'':
  * ''"lx"'' — освещённость в люксах;
  * ''"V"'' — значение с делителя напряжения как есть, в вольтах;
  * ''"mV"'' — значение с делителя в милливольтах;
  * не передан — значение в условных единицах пропорциональных напряжению в диапазоне [0.02; 1).