projects / linux-2.6-block.git / blame
| 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 | ======================= =============================== |