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 enabled setting (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 to true or empty, the firmware automatically attempts to bring a failed board back online. When set to false, 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_boards or empty, the system will shut down all boards and turn off PSU in order to protect miner. When set to shutdown_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 | jq

Examples

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

ParameterNotes
session_idA valid session ID. See Session Management for details.
paramsList of key-value parameters to change.

On this page