ibmaem: new driver for power/energy/temp meters in IBM System X hardware
[linux-2.6.git] / Documentation / hwmon / ibmaem
1 Kernel driver ibmaem
2 ======================
3
4 Supported systems:
5   * Any recent IBM System X server with Active Energy Manager support.
6     This includes the x3350, x3550, x3650, x3655, x3755, x3850 M2,
7     x3950 M2, and certain HS2x/LS2x/QS2x blades.  The IPMI host interface
8     driver ("ipmi-si") needs to be loaded for this driver to do anything.
9     Prefix: 'ibmaem'
10     Datasheet: Not available
11
12 Author: Darrick J. Wong
13
14 Description
15 -----------
16
17 This driver implements sensor reading support for the energy and power
18 meters available on various IBM System X hardware through the BMC.  All
19 sensor banks will be exported as platform devices; this driver can talk
20 to both v1 and v2 interfaces.  This driver is completely separate from the
21 older ibmpex driver.
22
23 The v1 AEM interface has a simple set of features to monitor energy use.
24 There is a register that displays an estimate of raw energy consumption
25 since the last BMC reset, and a power sensor that returns average power
26 use over a configurable interval.
27
28 The v2 AEM interface is a bit more sophisticated, being able to present
29 a wider range of energy and power use registers, the power cap as
30 set by the AEM software, and temperature sensors.
31
32 Special Features
33 ----------------
34
35 The "power_cap" value displays the current system power cap, as set by
36 the Active Energy Manager software.  Setting the power cap from the host
37 is not currently supported.