Firmware (LuxOS)
API Docs
LUXMiner commands
fanset

fanset

Description

Updates the fan 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:

  • speed: set the power sent to the fans; 0-100 integer value for a fixed speed, or -1 to let luxminer control the fan speed automatically.
  • min_fans: a zero or positive value indicating the minimum required number of fans.
  • power_off_speed: is the fan power when the PSU is powered off because of curtailment or a power-off event.

Note: If autosave is disabled, the changes will be lost after a reboot.

Note: This command will return an error for machines that do not natively have fans (i.e. Hydro and Immersion models).

⚠️

Manual fan speed can cause overtemp shutdown / risk to hardware if not propery adjusted.

Command

$ echo '{"command": "fanset", "parameter":"yJN2nlj1,power_off_speed=20"}' | nc $MINER_IP 4028 | jq
💡

Note: In previous luxminer versions, this command required speed and min fans as sequential unnamed parameters.

However, for compatibility reasons, if the second parameter can be interpreted as a number, the command will be handled as the old approach so this way we are fully backward-compatible.

All of the examples on this page use the new format.

Examples

$ echo '{"command": "fanset", "parameter":"yJN2nlj1,-1,1"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 300,
      "Description": "LUXminer 0.1.0-15436f7140",
      "Msg": "Fan Speed Set",
      "STATUS": "S",
      "When": 1667917473
    }
  ],
  "id": 1
}

Parameters

ParameterNotes
session_idA valid session ID. See Session Management for details.
speedOptional. A 0-100 value for a fixed speed, or -1 to let luxminer control the fan speed.
min_fansOptional. A zero or positive value indicating the minimum required number of fans.
power_off_speedOptional. A 0-100 value that defines the fan speed when miner goes in power-off