lineage-pem.rst 2.4 KB

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