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