tail head cat sleep
QR code linking to this page

Manual Pages  — ISL

NAME

isl – Intersil(TM) I2C ISL29018 sensor driver

CONTENTS

SYNOPSIS

To compile this driver into the kernel, place the following lines into the kernel configuration file: device isl device ig4 device iicbus

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"

On many Chromebook models this driver can be automatically configured with the help of the chromebook_platform(4) driver. Alternatively, the
isl driver can be manually configured 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

Ambient light sensor read out

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

Automatically adjust brightness

This requires the port graphics/intel-backlight and only works with laptops using a supported Intel(R) GPU.
$ pkg install intel-backlight
$ sh /usr/local/share/examples/intel-backlight/isl_backlight.sh

SEE ALSO

chromebook_platform(4), ig4(4), iicbus(4)

AUTHORS

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

This manual page was written by Michael Gmelin <Mt 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.

ISL (4) December 18, 2018

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

The most important thing in the programming language is the name. A language will not succeed without a good name. I have recently invented a very good name and now I am looking for a suitable language.
— Donald Knuth