Documentation/hwmon/lineage-pem

   1 Kernel driver lineage-pem
   2 =========================
   3
   4 Supported devices:
   5   * Lineage Compact Power Line Power Entry Modules
   6     Prefix: 'lineage-pem'
   7     Addresses scanned: -
   8     Documentation:
   9         http://www.lineagepower.com/oem/pdf/CPLI2C.pdf
  10
  11 Author: Guenter Roeck <linux@roeck-us.net>
  12
  13
  14 Description
  15 -----------
  16
  17 This driver supports various Lineage Compact Power Line DC/DC and AC/DC
  18 converters such as CP1800, CP2000AC, CP2000DC, CP2100DC, and others.
  19
  20 Lineage CPL power entry modules are nominally PMBus compliant. However, most
  21 standard PMBus commands are not supported. Specifically, all hardware monitoring
  22 and status reporting commands are non-standard. For this reason, a standard
  23 PMBus driver can not be used.
  24
  25
  26 Usage Notes
  27 -----------
  28
  29 This driver does not probe for Lineage CPL devices, since there is no register
  30 which can be safely used to identify the chip. You will have to instantiate
  31 the devices explicitly.
  32
  33 Example: the following will load the driver for a Lineage PEM at address 0x40
  34 on I2C bus #1:
  35 $ modprobe lineage-pem
  36 $ echo lineage-pem 0x40 > /sys/bus/i2c/devices/i2c-1/new_device
  37
  38 All Lineage CPL power entry modules have a built-in I2C bus master selector
  39 (PCA9541). To ensure device access, this driver should only be used as client
  40 driver to the pca9541 I2C master selector driver.
  41
  42
  43 Sysfs entries
  44 -------------
  45
  46 All Lineage CPL devices report output voltage and device temperature as well as
  47 alarms for output voltage, temperature, input voltage, input current, input power,
  48 and fan status.
  49
  50 Input voltage, input current, input power, and fan speed measurement is only
  51 supported on newer devices. The driver detects if those attributes are supported,
  52 and only creates respective sysfs entries if they are.
  53
  54 in1_input               Output voltage (mV)
  55 in1_min_alarm           Output undervoltage alarm
  56 in1_max_alarm           Output overvoltage alarm
  57 in1_crit                Output voltage critical alarm
  58
  59 in2_input               Input voltage (mV, optional)
  60 in2_alarm               Input voltage alarm
  61
  62 curr1_input             Input current (mA, optional)
  63 curr1_alarm             Input overcurrent alarm
  64
  65 power1_input            Input power (uW, optional)
  66 power1_alarm            Input power alarm
  67
  68 fan1_input              Fan 1 speed (rpm, optional)
  69 fan2_input              Fan 2 speed (rpm, optional)
  70 fan3_input              Fan 3 speed (rpm, optional)
  71
  72 temp1_input
  73 temp1_max
  74 temp1_crit
  75 temp1_alarm
  76 temp1_crit_alarm
  77 temp1_fault