isl29003.rst 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. ======================
  2. Kernel driver isl29003
  3. ======================
  4. Supported chips:
  5. * Intersil ISL29003
  6. Prefix: 'isl29003'
  7. Addresses scanned: none
  8. Datasheet:
  9. http://www.intersil.com/data/fn/fn7464.pdf
  10. Author: Daniel Mack <daniel@caiaq.de>
  11. Description
  12. -----------
  13. The ISL29003 is an integrated light sensor with a 16-bit integrating type
  14. ADC, I2C user programmable lux range select for optimized counts/lux, and
  15. I2C multi-function control and monitoring capabilities. The internal ADC
  16. provides 16-bit resolution while rejecting 50Hz and 60Hz flicker caused by
  17. artificial light sources.
  18. The driver allows to set the lux range, the bit resolution, the operational
  19. mode (see below) and the power state of device and can read the current lux
  20. value, of course.
  21. Detection
  22. ---------
  23. The ISL29003 does not have an ID register which could be used to identify
  24. it, so the detection routine will just try to read from the configured I2C
  25. address and consider the device to be present as soon as it ACKs the
  26. transfer.
  27. Sysfs entries
  28. -------------
  29. range:
  30. == ===========================
  31. 0: 0 lux to 1000 lux (default)
  32. 1: 0 lux to 4000 lux
  33. 2: 0 lux to 16,000 lux
  34. 3: 0 lux to 64,000 lux
  35. == ===========================
  36. resolution:
  37. == =====================
  38. 0: 2^16 cycles (default)
  39. 1: 2^12 cycles
  40. 2: 2^8 cycles
  41. 3: 2^4 cycles
  42. == =====================
  43. mode:
  44. == =================================================
  45. 0: diode1's current (unsigned 16bit) (default)
  46. 1: diode1's current (unsigned 16bit)
  47. 2: difference between diodes (l1 - l2, signed 15bit)
  48. == =================================================
  49. power_state:
  50. == =================================================
  51. 0: device is disabled (default)
  52. 1: device is enabled
  53. == =================================================
  54. lux (read only):
  55. returns the value from the last sensor reading