David van Moolenbroek c58da9fbc3 Rename MINIX service(8) to minix-service(8)
IMPORTANT: this change has a docs/UPDATING entry!

This rename is unfortunately necessary because NetBSD has decided to
create its own service(8) utility, and we will want to import theirs
as well.  The two can obviously not coexist.

Also move ours from /bin to /sbin, as it is a superuser-only utility.

Change-Id: Ic6e46ffb3a84b4747d2fdcb0d74e62dbea065039
2017-02-22 17:16:21 +00:00

47 lines
1.1 KiB
Plaintext

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
/sbin/minix-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:
/sbin/minix-service down tsl2550.3.39