temps

Description

Shows per-board temperature data with associated metadata.

Command

$ echo '{"command": "temps"}' | nc $MINER_IP 4028 | jq

The output fields change depending on the miner model. The example below shows the fields available on a Hydro model; please check the Field Details section to see the full list of available fields.

$ echo '{"command": "temps"}' | nc $MINER_IP 4028 | jq
{
  "METADATA": [
    {
      "BottomLeft": {
        "IsCritical": true,
        "Label": "Board Outlet",
        "Position": [
          0,
          0
        ]
      },
      "BottomRight": {
        "IsCritical": true,
        "Label": "Water Inlet",
        "Position": [
          1,
          1
        ]
      },
      "TopLeft": {
        "IsCritical": false,
        "Label": "Board Inlet",
        "Position": [
          0,
          1
        ]
      },
      "TopRight": {
        "IsCritical": true,
        "Label": "Water Outlet",
        "Position": [
          1,
          0
        ]
      }
    }
  ],
  "STATUS": [
    {
      "Code": 201,
      "Description": "LUXminer 2024.10.3.150831-2f8692f0",
      "Msg": "3 Temp(s)",
      "STATUS": "S",
      "When": 1728398031
    }
  ],
  "TEMPS": [
    {
      "BottomLeft": 58,
      "BottomRight": 42,
      "ID": 1,
      "TEMP": 1,
      "TopLeft": 56,
      "TopRight": 48
    },
    {
      "BottomLeft": 58,
      "BottomRight": 42,
      "ID": 2,
      "TEMP": 2,
      "TopLeft": 55,
      "TopRight": 48
    },
    {
      "BottomLeft": 59,
      "BottomRight": 43,
      "ID": 0,
      "TEMP": 0,
      "TopLeft": 56,
      "TopRight": 48
    }
  ],
  "id": 1
}

Field details

For the METADATA section:

Alongside TEMPS, the response includes a METADATA object keyed by sensor field name (e.g. TopLeft, BoardCh0). Each entry has:

Field	Notes
`Label`	Human-readable name for UI display (e.g. `"Board Exhaust (top)"`, `"Chip (Max)"`, `"Water Inlet"`).
`Position`	`[x, y]` grid coordinates for UI layout.
`IsCritical`	`true` if this sensor participates in overtemp/shutdown decisions; `false` if it is display-only.

For the TEMPS section:

All temperatures are in °C. The set of fields present in each TEMPS entry depends on the miner's hardware — clients should iterate the entry's keys rather than assume a fixed schema.

Field	Notes
`ID`	Board ID. Starts at zero.
`TEMP`	Same as `ID`.
`Board`	Board temperature. (Whatsminer)
`Chip`	Maximum chip on-die temperature for the hashboard. (Whatsminer)
`TopLeft`	"Top left" board sensor. (S19, some S21 models, S19a)
`TopRight`	"Top right" board sensor. (S19, some S21 models, S19a)
`BottomLeft`	"Bottom left" board sensor. (S19, some S21 models, S19a)
`BottomRight`	"Bottom right" board sensor. (S19, some S21 models, S19a)
`TopLeftChip`	Top-left chip temperature. (S19a)
`TopRightChip`	Top-right chip temperature. (S19a)
`BottomLeftChip`	Bottom-left chip temperature. (S19a)
`BottomRightChip`	Bottom-right chip temperature. (S19a)
`BoardInlet`	Board inlet sensor. (some Hydro models)
`BoardOutlet`	Board outlet sensor. (some Hydro models)
`WaterInlet`	Water inlet temperature. (some Hydro models)
`WaterOutlet`	Water outlet temperature. (some Hydro models)
`BoardTopLeft`	Top-left board sensor. (I2C-mux models, e.g. S21 Pro, S21 XP, some Hydro models)
`BoardMiddleLeft`	Middle-left board sensor. (I2C-mux models)
`BoardBottomLeft`	Bottom-left board sensor. (I2C-mux models)
`BoardTopRight`	Top-right board sensor. (I2C-mux models)
`ChipTopLeft`	Top-left chip temperature. (I2C-mux models)
`ChipMiddleLeft`	Middle-left chip temperature. (I2C-mux models)
`ChipBottomLeft`	Bottom-left chip temperature. (I2C-mux models)
`ChipTopRight`	Top-right chip temperature. (I2C-mux models)
`BoardCh0` … `BoardCh4`	Board sensor on channels 0–4. (I2C-mux hydro, e.g. U3 S21e XP Hydro)
`ChipCh0` … `ChipCh4`	Chip on-die temperature on channels 0–4. (I2C-mux hydro)

temps

temps

Description

Command

Examples

Field details

On this page