Blame view

Documentation/hwmon/ads1015 1.99 KB
8c22a8f57   Dirk Eibach   hwmon: Add suppor...
1
2
3
4
5
6
7
8
  Kernel driver ads1015
  =====================
  
  Supported chips:
    * Texas Instruments ADS1015
      Prefix: 'ads1015'
      Datasheet: Publicly available at the Texas Instruments website :
                 http://focus.ti.com/lit/ds/symlink/ads1015.pdf
60c1f31fc   Evgeniy Dushistov   hwmon: (ads1015) ...
9
10
11
12
    * Texas Instruments ADS1115
      Prefix: 'ads1115'
      Datasheet: Publicly available at the Texas Instruments website :
                 http://focus.ti.com/lit/ds/symlink/ads1115.pdf
8c22a8f57   Dirk Eibach   hwmon: Add suppor...
13
14
15
16
17
18
  
  Authors:
          Dirk Eibach, Guntermann & Drunck GmbH <eibach@gdsys.de>
  
  Description
  -----------
60c1f31fc   Evgeniy Dushistov   hwmon: (ads1015) ...
19
  This driver implements support for the Texas Instruments ADS1015/ADS1115.
8c22a8f57   Dirk Eibach   hwmon: Add suppor...
20

60c1f31fc   Evgeniy Dushistov   hwmon: (ads1015) ...
21
  This device is a 12/16-bit A-D converter with 4 inputs.
8c22a8f57   Dirk Eibach   hwmon: Add suppor...
22
23
  
  The inputs can be used single ended or in certain differential combinations.
c0046867f   Dirk Eibach   hwmon: (ads1015) ...
24
  The inputs can be made available by 8 sysfs input files in0_input - in7_input:
8c22a8f57   Dirk Eibach   hwmon: Add suppor...
25
26
27
28
29
30
31
32
  in0: Voltage over AIN0 and AIN1.
  in1: Voltage over AIN0 and AIN3.
  in2: Voltage over AIN1 and AIN3.
  in3: Voltage over AIN2 and AIN3.
  in4: Voltage over AIN0 and GND.
  in5: Voltage over AIN1 and GND.
  in6: Voltage over AIN2 and GND.
  in7: Voltage over AIN3 and GND.
c0046867f   Dirk Eibach   hwmon: (ads1015) ...
33
  Which inputs are available can be configured using platform data or devicetree.
8c22a8f57   Dirk Eibach   hwmon: Add suppor...
34
35
36
37
38
  
  By default all inputs are exported.
  
  Platform Data
  -------------
c0046867f   Dirk Eibach   hwmon: (ads1015) ...
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
  In linux/i2c/ads1015.h platform data is defined, channel_data contains
  configuration data for the used input combinations:
  - pga is the programmable gain amplifier (values are full scale)
    0: +/- 6.144 V
    1: +/- 4.096 V
    2: +/- 2.048 V
    3: +/- 1.024 V
    4: +/- 0.512 V
    5: +/- 0.256 V
  - data_rate in samples per second
    0: 128
    1: 250
    2: 490
    3: 920
    4: 1600
    5: 2400
    6: 3300
8c22a8f57   Dirk Eibach   hwmon: Add suppor...
56
57
58
  
  Example:
  struct ads1015_platform_data data = {
c0046867f   Dirk Eibach   hwmon: (ads1015) ...
59
60
61
62
  	.channel_data = {
  		[2] = { .enabled = true, .pga = 1, .data_rate = 0 },
  		[4] = { .enabled = true, .pga = 4, .data_rate = 5 },
  	}
8c22a8f57   Dirk Eibach   hwmon: Add suppor...
63
  };
c0046867f   Dirk Eibach   hwmon: (ads1015) ...
64
65
  In this case only in2_input (FS +/- 4.096 V, 128 SPS) and in4_input
  (FS +/- 0.512 V, 2400 SPS) would be created.
8c22a8f57   Dirk Eibach   hwmon: Add suppor...
66
67
68
  
  Devicetree
  ----------
c0046867f   Dirk Eibach   hwmon: (ads1015) ...
69
70
  Configuration is also possible via devicetree:
  Documentation/devicetree/bindings/hwmon/ads1015.txt