Commit | Line | Data |
---|---|---|
502b5a01 GR |
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 | ||
e3333e57 | 11 | Author: Guenter Roeck <linux@roeck-us.net> |
502b5a01 GR |
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 |