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:

             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 <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.

Debian                                          December 18, 2018                                         ISL(4)