MDZ_fan_speed_monitor

Locale	Presentation string
en-GB	Fan speed monitoring

Overview

Temperature alone tells little about the amount of work performed by a device as the user might prefer silent operation over keeping the computing devices cool.

This extension provides a way to query speed of available fans. Each fan could be mapped to a specific computing device or not.

Interactions with other extensions

If MDZ_long_term_stats is supported then a new stream is defined with name fanSpeed.
A new sample is generated every time at least one of the supported sensors reports a different rotational speed.
The value type will have the following form:


	{

	    fan: [F₀, F₁, ... , F_N-1],

	    speed: [S₀, S₁, ... , S_N-1]

	}

More information about F_i values can be inferred using listFans.

Configuration file additions

A new value fanPollInterval is added. Valid values are unsigned integers, representing the number of seconds between successive fan speed readings. Default value is 5.
The extension will successfully initialize only on systems exposing at least one measurable fan. In case this doesn't happen, the extension token will not be produced in the extension string.

New common commands

None.

New monitor commands

listFans

Parameters: none.

Purpose: retrieve information on available fans for measurements.

Reply: an array containing as many entries as available fans on the system, each entry is in the following form:
{ presentation: <string>, processorIndex: <uint>, }
The field processorIndex is optional. If specified, the fan is 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.

probeFan

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

Purpose: retrieve current fan speed.

Reply: an array containing as many entries as request. Each entry is an unsigned integer representing the percentage of maximum speed.

Notes: see issues.

Push: allowed, but no more than one.

New admin commands