11. gc-powertest

This tool is used to test power consumption and temperature of the C2 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/C2 cards.

  • 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). It is constantly updated until the process is killed. The first column shows power and temperature readings taken from the C2 card itself:

|                            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 power and temperature readings taken from the C2 card itself:

  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

11.1. Usage

11.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