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