17. gc-powertest

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

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.

A typical output is shown in Listing 17.1. This example is for a single IPU in an IPU-M2000. Similar output will be generated for other systems. The output is constantly updated until the process is terminated.

Listing 17.1 Example of gc-powertest output
 |                                    CARD LEVEL                                    |                       IPU#0                      |
 +--------------------------------------------------------------------------------------------------------------------------------------
 |            XDPE132G5C             | B_COL0:1 B_COL1:1 B_IN:1   B_MID:1  B_OUT:1  | 0:PVT0    0:PVT1    0:PVT2    0:PVTE    CLOCK    |
 +--------------------------------------------------------------------------------------------------------------------------------------
 | 0001: 123.50W  049.00W  T172.50W  | 041C     040C     036C     032C     039C     | 040.7C    039.6C    040.5C    038.3C    1330MHz  |
 | 0002: 123.50W  048.50W  T172.00W  | 041C     040C     036C     032C     039C     | 041.6C    040.5C    041.3C    038.8C    1330MHz  |
 | 0003: 124.00W  047.50W  T171.50W  | 041C     040C     036C     032C     039C     | 041.8C    040.7C    041.8C    039.4C    1330MHz  |
 | 0004: 124.00W  048.00W  T172.00W  | 041C     040C     036C     032C     039C     | 042.1C    041.3C    042.1C    039.6C    1330MHz  |
 | 0005: 124.50W  047.50W  T172.00W  | 041C     040C     036C     032C     039C     | 042.7C    041.8C    042.4C    039.9C    1330MHz  |

The first column (shown in detail in Listing 17.2) shows power readings taken from the board at different locations. The first column of power readings is for IPU0, the second column for IPU1 and the third column (with the T prefix) is the total IPU power.

Listing 17.2 Power readings
 -------------------------------------
 |            XDPE132G5C             |
 -------------------------------------
 | 0001: 123.50W  049.00W  T172.50W  |
 | 0002: 123.50W  048.50W  T172.00W  |
 | 0003: 124.00W  047.50W  T171.50W  |
 | 0004: 124.00W  048.00W  T172.00W  |
 | 0005: 124.50W  047.50W  T172.00W  |

The second column (shown in detail in Listing 17.3) shows temperature readings taken from the board at different locations. The columns are defined in Table 17.1.

Listing 17.3 Temperature readings on the PCB (Table 17.1)
   CARD LEVEL                                   |
 -------------------------------------------------
 | B_COL0:1 B_COL1:1 B_IN:1   B_MID:1  B_OUT:1  |
 -------------------------------------------------
 | 041C     040C     036C     032C     039C     |
 | 041C     040C     036C     032C     039C     |
 | 041C     040C     036C     032C     039C     |
 | 041C     040C     036C     032C     039C     |
 | 041C     040C     036C     032C     039C     |

The third column (shown in detail in Listing 17.4) shows temperature and clock readings measured on the IPU.

Listing 17.4 Temperature and clock readings (Table 17.1)
 |                       IPU#0                      |
 -----------------------------------------------------
 | 0:PVT0    0:PVT1    0:PVT2    0:PVTE    CLOCK    |
 -----------------------------------------------------
 | 040.7C    039.6C    040.5C    038.3C    1330MHz  |
 | 041.6C    040.5C    041.3C    038.8C    1330MHz  |
 | 041.8C    040.7C    041.8C    039.4C    1330MHz  |
 | 042.1C    041.3C    042.1C    039.6C    1330MHz  |
 | 042.7C    041.8C    042.4C    039.9C    1330MHz  |
Table 17.1 Descriptions of column headings in gc-powertest output

Column Name

Description

B_COL0:0

temperature from sensor on Colossus 0

B_COL1:0

temperature from sensor on Colossus 1

B_IN:0

air inlet temperature

B_MID:0

mid-board PCB temperature

B_OUT:0

air exhaust temperature

0:PVT0

temperature from first on-chip sensor (West Edge)

0:PVT1

temperature from second on-chip sensor (West Edge)

0:PVT2

temperature from third on-chip sensor (West Edge)

0:PVTE

temperature from fourth on-chip sensor (East Edge)

CLOCK

clock speed

By default, the power test will run with 0% IPU processing load. The load can be set with the -p option. This must be in multiples of 10%. For systems older than IPU-M2000 only, 20%, 50% or 100% loads can be requested.

For example:

gc-powertest -d {device_id} -p 50

17.1. Usage

17.1.1. Allowed options

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

IPU load percentage (default: 0)

-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