FirmwareAPI DocumentationCGminer commands
temps
Shows per-board temperature data
temps
Description
Shows per-board temperature data with associated metadata.
Command
$ echo '{"command": "temps"}' | nc $MINER_IP 4028 | jqExamples
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) |