ads1015 2.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. Kernel driver ads1015
  2. =====================
  3. Supported chips:
  4. * Texas Instruments ADS1015
  5. Prefix: 'ads1015'
  6. Datasheet: Publicly available at the Texas Instruments website :
  7. http://focus.ti.com/lit/ds/symlink/ads1015.pdf
  8. * Texas Instruments ADS1115
  9. Prefix: 'ads1115'
  10. Datasheet: Publicly available at the Texas Instruments website :
  11. http://focus.ti.com/lit/ds/symlink/ads1115.pdf
  12. Authors:
  13. Dirk Eibach, Guntermann & Drunck GmbH <eibach@gdsys.de>
  14. Description
  15. -----------
  16. This driver implements support for the Texas Instruments ADS1015/ADS1115.
  17. This device is a 12/16-bit A-D converter with 4 inputs.
  18. The inputs can be used single ended or in certain differential combinations.
  19. The inputs can be made available by 8 sysfs input files in0_input - in7_input:
  20. in0: Voltage over AIN0 and AIN1.
  21. in1: Voltage over AIN0 and AIN3.
  22. in2: Voltage over AIN1 and AIN3.
  23. in3: Voltage over AIN2 and AIN3.
  24. in4: Voltage over AIN0 and GND.
  25. in5: Voltage over AIN1 and GND.
  26. in6: Voltage over AIN2 and GND.
  27. in7: Voltage over AIN3 and GND.
  28. Which inputs are available can be configured using platform data or devicetree.
  29. By default all inputs are exported.
  30. Platform Data
  31. -------------
  32. In linux/i2c/ads1015.h platform data is defined, channel_data contains
  33. configuration data for the used input combinations:
  34. - pga is the programmable gain amplifier (values are full scale)
  35. 0: +/- 6.144 V
  36. 1: +/- 4.096 V
  37. 2: +/- 2.048 V
  38. 3: +/- 1.024 V
  39. 4: +/- 0.512 V
  40. 5: +/- 0.256 V
  41. - data_rate in samples per second
  42. 0: 128
  43. 1: 250
  44. 2: 490
  45. 3: 920
  46. 4: 1600
  47. 5: 2400
  48. 6: 3300
  49. Example:
  50. struct ads1015_platform_data data = {
  51. .channel_data = {
  52. [2] = { .enabled = true, .pga = 1, .data_rate = 0 },
  53. [4] = { .enabled = true, .pga = 4, .data_rate = 5 },
  54. }
  55. };
  56. In this case only in2_input (FS +/- 4.096 V, 128 SPS) and in4_input
  57. (FS +/- 0.512 V, 2400 SPS) would be created.
  58. Devicetree
  59. ----------
  60. Configuration is also possible via devicetree:
  61. Documentation/devicetree/bindings/hwmon/ads1015.txt