FirmwareAPI DocumentationLUXminer commands
hashboardoptsset
Updates hashboard options
hashboardoptsset
Description
Updates the hashboards control options. The parameters are the session_id, followed by a comma-separated list of key-value pairs, in the format key=value. The available keys are:
- overtemp_auto_recovery: Deprecated alias for the recovery
enabledsetting (see recoverctrlset); it is kept for backward compatibility and writing it updates the same value. This is the master on/off switch for automatic board recovery. When set totrueor empty, the firmware automatically attempts to bring a failed board back online. When set tofalse, a failed board is powered off and left off, with no recovery attempts. - no_pic_protection_mode: Defines the way the system will react when detecting a failing board in miners with no physical protection. When set to
shutdown_all_boardsor empty, the system will shut down all boards and turn off PSU in order to protect miner. When set toshutdown_failing_board, the system will only shut down the failing board.
Providing an invalid value is an error. You can see the current values with the hashboardopts command.
Note: If autosave is disabled, the changes will be lost after a reboot.
Note: overtemp_auto_recovery is a deprecated alias for the recovery enabled setting; prefer recoverctrlset to change it. The recovery attempt limits (rate limits, cooldown, consecutive-error threshold) are configured separately via recoverctrlset.
Command
$ echo '{"command": "hashboardoptsset", "parameter":"a8Y8K3lt,overtemp_auto_recovery=true,no_pic_protection_mode=shutdown_all_boards"}' | nc $MINER_IP 4028 | jqExamples
In this example, we are adjusting:
- The automatic board recovery to keep bringing a failed board back online (which is the default behavior) by setting overtemp_auto_recovery=true.
- The hashboard protection mode for miners without physical protection to shutdown all boards when detecting a failing board (which is the default behavior) by setting no_pic_protection_mode=shutdown_all_boards.
$ echo '{"command": "hashboardoptsset", "parameter":"a8Y8K3lt,overtemp_auto_recovery=true,no_pic_protection_mode=shutdown_all_boards"}' | nc $MINER_IP 4028 | jq
{
"STATUS": [
{
"Code": 348,
"Description": "LUXminer 2023.12.13.205218-54b9ac9b",
"Msg": "Hashboard options updated",
"STATUS": "S",
"When": 1702591990
}
],
"id": 1
}Parameters
| Parameter | Notes |
|---|---|
session_id | A valid session ID. See Session Management for details. |
params | List of key-value parameters to change. |