minix/minix/drivers/sensors/tsl2550
Lionel Sambuc 50a1aef12b Move all services to /service
This concerns all services, a.k.a drivers, filesystem drivers, network
(inet, lwip, uds) servers, and the system servers.

Change-Id: I626fd15c795e15af42df2d10d47fb4a703665d63
2014-07-31 16:00:31 +02:00
..
Makefile New sources layout 2014-07-31 16:00:30 +02:00
README.txt Move all services to /service 2014-07-31 16:00:31 +02:00
tsl2550.c New sources layout 2014-07-31 16:00:30 +02:00

TSL2550 Driver (Ambient Light Sensor)
=====================================

Overview
--------

This is the driver for the ambient light sensor commonly found on the
WeatherCape expansion board for the BeagleBone.

Interface
---------

This driver implements the character device interface. It supports reading
through /dev/tsl2550b{1,3}s39. When read from, it returns a string containing
a data label, a colon, and the sensor value.

Example output of `cat /dev/tsl2550b3s39`:

ILLUMINANCE     : 830

Illuminance is expressed in lux. Valid values are 0 to 1846.

Limitations
-----------

Extended mode isn't implemented. Normal mode should be sufficient for most
applications.

Testing the Code
----------------

The driver should have been started by a script in /etc/rc.capes/ If not,
this is how you start up an instance:

cd /dev && MAKEDEV tsl2550b3s39
/bin/service up /service/tsl2550 -label tsl2550.3.39 -dev /dev/tsl2550b3s39 \
	-args 'bus=3 address=0x39'

Getting the sensor value:

cat /dev/tsl2550b3s39

Killing an instance:

/bin/service down tsl2550.3.39