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