Merge tag 'scsi-fixes' of git://git.kernel.org/pub/scm/linux/kernel/git/jejb/scsi
[cris-mirror.git] / Documentation / devicetree / bindings / hwmon / ads1015.txt
blob918a507d1159f9aaaef2211f5ee9994b9f330f0f
1 ADS1015 (I2C)
3 This device is a 12-bit A-D converter with 4 inputs.
5 The inputs can be used single ended or in certain differential combinations.
7 For configuration all possible combinations are mapped to 8 channels:
8   0: Voltage over AIN0 and AIN1.
9   1: Voltage over AIN0 and AIN3.
10   2: Voltage over AIN1 and AIN3.
11   3: Voltage over AIN2 and AIN3.
12   4: Voltage over AIN0 and GND.
13   5: Voltage over AIN1 and GND.
14   6: Voltage over AIN2 and GND.
15   7: Voltage over AIN3 and GND.
17 Each channel can be configured individually:
18  - pga is the programmable gain amplifier (values are full scale)
19     0: +/- 6.144 V
20     1: +/- 4.096 V
21     2: +/- 2.048 V (default)
22     3: +/- 1.024 V
23     4: +/- 0.512 V
24     5: +/- 0.256 V
25  - data_rate in samples per second
26     0: 128
27     1: 250
28     2: 490
29     3: 920
30     4: 1600 (default)
31     5: 2400
32     6: 3300
34 1) The /ads1015 node
36   Required properties:
38    - compatible : must be "ti,ads1015"
39    - reg : I2C bus address of the device
40    - #address-cells : must be <1>
41    - #size-cells : must be <0>
43   The node contains child nodes for each channel that the platform uses.
45   Example ADS1015 node:
47     ads1015@49 {
48             compatible = "ti,ads1015";
49             reg = <0x49>;
50             #address-cells = <1>;
51             #size-cells = <0>;
53             [ child node definitions... ]
54     }
56 2) channel nodes
58   Required properties:
60    - reg : the channel number
62   Optional properties:
64    - ti,gain : the programmable gain amplifier setting
65    - ti,datarate : the converter data rate
67   Example ADS1015 channel node:
69     channel@4 {
70             reg = <4>;
71             ti,gain = <3>;
72             ti,datarate = <5>;
73     };