MDZ_temperature

LocalePresentation string
en-GBTemperature monitoring

Overview

When enabled this extension provides temperature of a variety of devices. This is mostly geared towards compute devices.

The main goal is to observe temperature differences across the day and relation to performance.

Interactions with other extensions

If MDZ_long_term_stats is supported then a new stream is defined with name temperature.
A new sample is generated every time at least one of the supported devices signals a temperature change of at least 1 degree Celsius.
The value type will have the following form:
{
    device: [D0, D1, ... , DN-1],
    temperature: [T0, T1, ... , TN-1]
}
More information about Di values can be inferred using listTemperatureSensors.

Configuration file additions

A new value tempInterval is added. Valid values are unsigned integers, representing the number of seconds between successive temperature readings. Default value is 10.
If a system does not contain at least one supported temperature sensor the extension will fail to start at initialization. In this case, the extension token will not be produced in the extension string.

New common commands

None.

New monitor commands

listTemperatureSensors

Parameters: none.

Purpose: retrieve description of the various sensors and reconstruct mappings to unique indices.

Reply: an array containing as many entries as supported temperature sensors, each entry is in the following form:
{
    presentation: <string>,
    processorIndex: <uint>,
}
The field processorIndex is optional. If specified, the sensor in attached to a specific compute device regardless the device itself is used or not. The index is the very same linear-index to be used by standard commands.

Push: not allowed.

probeTemp

Parameters: an array of unsigned integers being the index of the sensor to query.

Purpose: retrieve current temperature.

Reply: an array containing as many entries as request. Each entry is a floating-point value.

Notes:

  1. implementations are free to actually poll the temperature sensors or report the known temperature reported at last refresh;
  2. when MDZ_long_term_stats is supported, a sample can be produced by iterating on all sensors and adding them to the lists whatever the measured temperature is different.

Push: allowed, but no more than one.

New admin commands

None.

Issues

None.