Documentation/hwmon/pcf8591

   1 Kernel driver pcf8591
   2 =====================
   3
   4 Supported chips:
   5   * Philips/NXP PCF8591
   6     Prefix: 'pcf8591'
   7     Addresses scanned: I2C 0x48 - 0x4f
   8     Datasheet: Publicly available at the NXP website
   9                http://www.nxp.com/pip/PCF8591_6.html
  10
  11 Authors:
  12         Aurelien Jarno <aurelien@aurel32.net>
  13         valuable contributions by Jan M. Sendler <sendler@sendler.de>,
  14         Jean Delvare <khali@linux-fr.org>
  15
  16
  17 Description
  18 -----------
  19
  20 The PCF8591 is an 8-bit A/D and D/A converter (4 analog inputs and one
  21 analog output) for the I2C bus produced by Philips Semiconductors (now NXP).
  22 It is designed to provide a byte I2C interface to up to 4 separate devices.
  23
  24 The PCF8591 has 4 analog inputs programmable as single-ended or
  25 differential inputs :
  26 - mode 0 : four single ended inputs
  27         Pins AIN0 to AIN3 are single ended inputs for channels 0 to 3
  28
  29 - mode 1 : three differential inputs
  30         Pins AIN3 is the common negative differential input
  31         Pins AIN0 to AIN2 are positive differential inputs for channels 0 to 2
  32
  33 - mode 2 : single ended and differential mixed
  34         Pins AIN0 and AIN1 are single ended inputs for channels 0 and 1
  35         Pins AIN2 is the positive differential input for channel 3
  36         Pins AIN3 is the negative differential input for channel 3
  37
  38 - mode 3 : two differential inputs
  39         Pins AIN0 is the positive differential input for channel 0
  40         Pins AIN1 is the negative differential input for channel 0
  41         Pins AIN2 is the positive differential input for channel 1
  42         Pins AIN3 is the negative differential input for channel 1
  43
  44 See the datasheet for details.
  45
  46 Module parameters
  47 -----------------
  48
  49 * input_mode int
  50
  51     Analog input mode:
  52          0 = four single ended inputs
  53          1 = three differential inputs
  54          2 = single ended and differential mixed
  55          3 = two differential inputs
  56
  57
  58 Accessing PCF8591 via /sys interface
  59 -------------------------------------
  60
  61 ! Be careful !
  62 The PCF8591 is plainly impossible to detect! Stupid chip.
  63 So every chip with address in the interval [0x48..0x4f] is
  64 detected as PCF8591. If you have other chips in this address
  65 range, the workaround is to load this module after the one
  66 for your others chips.
  67
  68 On detection (i.e. insmod, modprobe et al.), directories are being
  69 created for each detected PCF8591:
  70
  71 /sys/bus/i2c/devices/<0>-<1>/
  72 where <0> is the bus the chip was detected on (e. g. i2c-0)
  73 and <1> the chip address ([48..4f])
  74
  75 Inside these directories, there are such files:
  76 in0_input, in1_input, in2_input, in3_input, out0_enable, out0_output, name
  77
  78 Name contains chip name.
  79
  80 The in0_input, in1_input, in2_input and in3_input files are RO. Reading gives
  81 the value of the corresponding channel. Depending on the current analog inputs
  82 configuration, files in2_input and in3_input may not exist. Values range
  83 from 0 to 255 for single ended inputs and -128 to +127 for differential inputs
  84 (8-bit ADC).
  85
  86 The out0_enable file is RW. Reading gives "1" for analog output enabled and
  87 "0" for analog output disabled. Writing accepts "0" and "1" accordingly.
  88
  89 The out0_output file is RW. Writing a number between 0 and 255 (8-bit DAC), send
  90 the value to the digital-to-analog converter. Note that a voltage will
  91 only appears on AOUT pin if aout0_enable equals 1. Reading returns the last
  92 value written.