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