NAME

isl — Intersil(TM) I2C ISL29018 sensor driver

SYNOPSIS

To compile this driver into the kernel, place the following lines into the kernel configuration file:

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):

isl_load="YES"
ig4_load="YES"

In /boot/device.hints:
hint.isl.0.at="iicbus0"
hint.isl.0.addr="0x88"
hint.isl.1.at="iicbus1"
hint.isl.1.addr="0x88"

DESCRIPTION

The isl driver provides access to sensor data provided by the Intersil(TM) I2C ISL29018 Digital Ambient Light Sensor and Proximity Sensor with Interrupt Function. Functionality is basic and provided through the sysctl(8) interface.

On a system using device.hints(5), these values are configurable for isl:

hint.isl.%d.at

target iicbus(4).

hint.isl.%d.addr

isl i2c address on the iicbus(4).

SYSCTL VARIABLES

The following sysctl(8) variables are available:

dev.isl.X.als

Current ALS (Ambient Light Sensor) readout.

dev.isl.X.ir

Current IR (InfraRed) sensor readout.

dev.isl.X.prox

Current proximity sensor readout.

dev.isl.X.resolution

Current sensor resolution.

dev.isl.X.range

Current sensor range.

EXAMPLES

$ sysctl dev.isl.0.als
dev.isl.0.als: 64

$ pkg install intel-backlight
$ sh /usr/local/share/examples/intel-backlight/isl_backlight.sh

SEE ALSO

ig4(4), iicbus(4)

AUTHORS

The isl driver was written by Michael Gmelin <freebsd@grem.de>.

This manual page was written by Michael Gmelin <freebsd@grem.de>.

BUGS

The isl driver detects the device based from the I2C address. This might have unforeseen consequences if the initialization sequence is sent to an unknown device at that address.