FirmwareAPI DocumentationLUXminer commands
recoverctrl
Shows recovery configuration and attempt counters
recoverctrl
Description
Returns the current recovery configuration along with the per-board recovery attempt counters. The Enabled field is the master on/off switch for automatic board recovery: when it is off, a failed board is powered off and left off, with no consecutive-error accounting, rate-limit windows, or scheduled retries. When it is on, the remaining fields control how often the firmware will automatically try to bring a failed board back online before giving up.
Command
$ echo '{"command": "recoverctrl"}' | nc $MINER_IP 4028 | jqExamples
$ echo '{"command": "recoverctrl"}' | nc $MINER_IP 4028 | jq
{
"RECOVER": [
{
"CooldownMinutes": 5,
"Enabled": true,
"MaxConsecutiveErrors": 10,
"MaxPerDay": 5,
"MaxPerHour": 1
}
],
"RECOVERATTEMPTS": [
{
"AttemptsLastDay": 1,
"AttemptsLastHour": 1,
"BoardID": 1,
"ConsecutiveErrors": 0
},
{
"AttemptsLastDay": 1,
"AttemptsLastHour": 1,
"BoardID": 2,
"ConsecutiveErrors": 0
},
{
"AttemptsLastDay": 1,
"AttemptsLastHour": 1,
"BoardID": 0,
"ConsecutiveErrors": 0
}
],
"STATUS": [
{
"Code": 364,
"Description": "LUXminer 2026.6.1.194014-8dd68647e",
"Msg": "Recovery control configuration values",
"STATUS": "S",
"When": 1780403805
}
],
"id": 1
}Field details
The RECOVER array holds the current recovery configuration:
| Field | Notes |
|---|---|
CooldownMinutes | Minutes to wait before allowing another recovery attempt for a board. |
Enabled | Master on/off switch for automatic board recovery. true (default) or false. When false, a failed board is powered off and left off, with no recovery attempts. |
MaxConsecutiveErrors | All-time consecutive errors before a board is considered irrecoverable. |
MaxPerDay | Maximum recovery attempts for a given board within a rolling 24-hour window. |
MaxPerHour | Maximum recovery attempts for a given board within a rolling one-hour window. |
The RECOVERATTEMPTS array holds the live recovery counters, one entry per board:
| Field | Notes |
|---|---|
BoardID | The board these counters refer to. |
AttemptsLastHour | Recovery attempts for this board within the last hour. |
AttemptsLastDay | Recovery attempts for this board within the last 24 hours. |
ConsecutiveErrors | Consecutive errors for this board; resets to zero once the board hashes. |