drivers/tsl2550/README.txt

   1 TSL2550 Driver (Ambient Light Sensor)
   2 =====================================
   3
   4 Overview
   5 --------
   6
   7 This is the driver for the ambient light sensor commonly found on the
   8 WeatherCape expansion board for the BeagleBone.
   9
  10 Interface
  11 ---------
  12
  13 This driver implements the character device interface. It supports reading
  14 through /dev/tsl2550b{1,3}s39. When read from, it returns a string containing
  15 a data label, a colon, and the sensor value.
  16
  17 Example output of `cat /dev/tsl2550b3s39`:
  18
  19 ILLUMINANCE     : 830
  20
  21 Illuminance is expressed in lux. Valid values are 0 to 1846.
  22
  23 Limitations
  24 -----------
  25
  26 Extended mode isn't implemented. Normal mode should be sufficient for most
  27 applications.
  28
  29 Testing the Code
  30 ----------------
  31
  32 The driver should have been started by a script in /etc/rc.capes/ If not,
  33 this is how you start up an instance:
  34
  35 cd /dev && MAKEDEV tsl2550b3s39
  36 /bin/service up /usr/sbin/tsl2550 -label tsl2550.3.39 -dev /dev/tsl2550b3s39 \
  37         -args 'bus=3 address=0x39'
  38
  39 Getting the sensor value:
  40
  41 cat /dev/tsl2550b3s39
  42
  43 Killing an instance:
  44
  45 /bin/service down tsl2550.3.39
  46