12. gc-powertest

This tool is used to test power consumption and temperature of the IPU processor cards.

Note that:

  • The program runs indefinitely until killed (with Ctrl-C).

  • It can be run multiple times to start code on other IPUs.

  • Temperatures are reported in degrees Celsius.

  • After running gc-powertest it’s a good idea to reset the IPUs (using the gc-reset tool) otherwise they’ll be left running at high power.

To use this tool, run:

gc-powertest -d {device_id}

where {device_id} is the id number returned by the gc-inventory tool.

Some typical output is shown below (split into three separate columns here). This example is for a C2 card in a PCIe server. Similar output will be generated for other systems.

The output is constantly updated until the process is killed. The first column shows power readings taken from the C2 card:

|                            CARD LEVEL
----------------------------------------------
|                   INA3221                  |
----------------------------------------------
| 0001: 017.57W  027.84W  046.08W  T091.49W  |
| 0002: 017.66W  032.16W  052.42W  T102.24W  |
| 0003: 017.66W  032.16W  052.42W  T102.24W  |
| 0004: 017.66W  032.26W  052.32W  T102.24W  |

The second column shows temperature readings taken from the C2 card:

  CARD LEVEL                          |
---------------------------------------
| B_IN     B_OUT    B_COL0   B_COL1   |
---------------------------------------
| 037C     040C     039C     040C     |
| 036C     040C     039C     039C     |
| 036C     040C     039C     039C     |
| 035C     040C     039C     039C     |

The third column shows temperature readings measured on each of the IPUs:

|                  IPU1                 |
-----------------------------------------
| 0:PVT0    0:PVT1    0:PVT2    0:PVTE  |
-----------------------------------------
| 036.7C    037.4C    037.6C    036.0C  |
| 036.7C    036.5C    036.5C    036.0C  |
| 036.2C    036.5C    035.5C    035.3C  |
| 036.9C    036.5C    037.2C    035.3C  |

By default, the power test will run with 0% IPU processing load. 20% or 75% loads can be requested with the -p option, for example:

gc-powertest -d {device_id} -p 20

12.1. Usage

12.1.1. Allowed options

-p {arg}, --percent-load {arg}

IPU load percentage 20|50|100

-d {id}, --device-id {id}

Device id

-b {binary}, --binary {binary}

Use custom IPU binary file

-v, --verbose

Verbose mode

-j, --json-output

Emit JSON output

-t {time}, --time {time}

Time in seconds of the measurements (0 is infinite) (default: 0)

-h, --help

Produce help message

--version

Version number