Gitiles
Code Review Sign In
review.shift-gmbh.com / SHIFTPHONES / mainline / linux / dbd0b42350d5717786cb8257fbe5b528f3af9772 / . / Documentation / misc-devices / isl29003.rst
blob: 0cc38aed6c00012cc0d03a54b8c0ac8a694108c1 [file] [log] [blame]
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]1======================
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]2Kernel driver isl29003
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]3======================
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]4
5Supported chips:
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]6
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]7* Intersil ISL29003
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]8
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]9Prefix: 'isl29003'
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]10
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]11Addresses scanned: none
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]12
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]13Datasheet:
14http://www.intersil.com/data/fn/fn7464.pdf
15
16Author: Daniel Mack <daniel@caiaq.de>
17
18
19Description
20-----------
21The ISL29003 is an integrated light sensor with a 16-bit integrating type
22ADC, I2C user programmable lux range select for optimized counts/lux, and
23I2C multi-function control and monitoring capabilities. The internal ADC
24provides 16-bit resolution while rejecting 50Hz and 60Hz flicker caused by
25artificial light sources.
26
27The driver allows to set the lux range, the bit resolution, the operational
28mode (see below) and the power state of device and can read the current lux
29value, of course.
30
31
32Detection
33---------
34
35The ISL29003 does not have an ID register which could be used to identify
36it, so the detection routine will just try to read from the configured I2C
Masanari Iida96d8d5f2015-09-17 00:54:58 +0900[diff] [blame]37address and consider the device to be present as soon as it ACKs the
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]38transfer.
39
40
41Sysfs entries
42-------------
43
44range:
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]45 == ===========================
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]46 0: 0 lux to 1000 lux (default)
47 1: 0 lux to 4000 lux
48 2: 0 lux to 16,000 lux
49 3: 0 lux to 64,000 lux
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]50 == ===========================
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]51
52resolution:
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]53 == =====================
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]54 0: 2^16 cycles (default)
55 1: 2^12 cycles
56 2: 2^8 cycles
57 3: 2^4 cycles
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]58 == =====================
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]59
60mode:
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]61 == =================================================
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]62 0: diode1's current (unsigned 16bit) (default)
63 1: diode1's current (unsigned 16bit)
64 2: difference between diodes (l1 - l2, signed 15bit)
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]65 == =================================================
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]66
67power_state:
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]68 == =================================================
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]69 0: device is disabled (default)
70 1: device is enabled
Mauro Carvalho Chehab9b5db892019-06-28 18:23:13 -0300[diff] [blame]71 == =================================================
Daniel Mack3cdbbee2009-03-31 15:23:53 -0700[diff] [blame]72
73lux (read only):
74 returns the value from the last sensor reading
75