Firmware (LuxOS)
API Docs
LUXMiner commands
atmset

atmset

Description

Sets the ATM configuration. 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:

  • enabled: either true or false to enable or disable ATM.
  • startup_minutes: the minimum amount of time, in minutes, before ATM starts working at system startup.
  • post_ramp_minutes: the minimum amount of time, in minutes, before ATM starts working after ramping.
  • temp_window: temperature window, before "Hot" in which ATM will trigger a profile change.
  • min_profile: lowest profile to be used (can be empty).
  • max_profile: highest profile to be used (can be empty).
  • prevent_oc: when turning off ATM, revert to the default profile if the miner is in a higher profile. This value is not persistent (it defaults to false) and is ignored unless the command is turning ATM off.

Providing an invalid value is an error, except min_profile, where you can set an empty value to leave it "unbounded". You can specify only the keys you want to change, and it can be done in any order. It is also safe to change ATM configuration while it is running; there is no need to reboot or turn it off and on again.

It is also possible to use the relative position of the profiles (e. g. "+1", "-2") for min_profile and/or max_profile, like in the profileset command.

The current ATM configuration can be seen on the atm command.

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

Command

$ echo '{"command": "atmset", "parameter":"tjqw4aNI,enabled=true"}' | nc $MINER_IP 4028 | jq

Examples

In this example, we enable ATM. This change will be persistent (as long as autosave is enabled). To disable, just change the value to false:

$ echo '{"command": "atmset", "parameter":"tjqw4aNI,enabled=true"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 340,
      "Description": "LUXminer 2023.7.7.220938-027e312",
      "Msg": "Advanced Thermal Management configuration updated",
      "STATUS": "S",
      "When": 1688824420
    }
  ],
  "id": 1
}

In the example below, we set all parameters at once:

$ echo '{"command": "atmset", "parameter":"tjqw4aNI,enabled=true,startup_minutes=99,post_ramp_minutes=1440,temp_window=7,min_profile=efficiency,max_profile=performance"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 340,
      "Description": "LUXminer 2023.7.7.220938-027e312",
      "Msg": "Advanced Thermal Management configuration updated",
      "STATUS": "S",
      "When": 1688824585
    }
  ],
  "id": 1
}

If you added a limit to the minimum profile, but want to leave it unbounded just set it to a blank value:

$ echo '{"command": "atmset", "parameter":"tjqw4aNI,min_profile="}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 340,
      "Description": "LUXminer 2023.7.7.220938-027e312",
      "Msg": "Advanced Thermal Management configuration updated",
      "STATUS": "S",
      "When": 1688824420
    }
  ],
  "id": 1
}

As pointed earlier, you can set the profile values by their relative position in regards to the default profile:

$ echo '{"command": "atmset", "parameter":"tjqw4aNI,min_profile=-3,max_profile=+2"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 340,
      "Description": "LUXminer 2023.7.7.220938-027e312",
      "Msg": "Advanced Thermal Management configuration updated",
      "STATUS": "S",
      "When": 1688824420
    }
  ],
  "id": 1
}

In the example below, we turn off ATM and use the prevent_oc option to ensure we go down to the default profile in case of overclocking:

$ echo '{"command": "atmset", "parameter":"tjqw4aNI,enabled=false,prevent_oc=true"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 340,
      "Description": "LUXminer 2024.5.7.211643-8dc7e72b",
      "Msg": "Advanced Thermal Management configuration updated",
      "STATUS": "S",
      "When": 1520600022
    }
  ],
  "id": 1
}

Parameters

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