psuset

Description

Sets the PSU (Power Supply Unit) 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:

Bypass Configuration

• bypass_enabled: either true or false to enable or disable PSU bypass mode.
• bypass_voltage: the bypass voltage value. See limits for the allowed range (BypassVoltageMin to BypassVoltageMax).

Fan Control

• fan_enabled: either true or false to enable or disable the PSU fan.
• fan_duty_cycle: the fan duty cycle percentage (0-100). Also accepts the alias fan_speed.

Fault Management

• clear_faults: clears all PSU fault flags. No value is required (e.g. clear_faults=1).

Protection Thresholds

These parameters set PMBus protection thresholds directly on the PSU hardware. Not all PSUs support all thresholds — if a threshold is not supported by the PSU firmware, the command will return error code 434. The current threshold values can be seen in the PSUCONFIGLIMITS section of the psuget response.

Each threshold has a short name and a long alias:

You can specify only the keys you want to change, and it can be done in any order.

The current PSU configuration can be seen on the psuget command.

Note: Bypass configuration changes (bypass_enabled, bypass_voltage) are persisted to the miner config. After changing bypass_enabled, the setting will only be applied after a system reboot. If autosave is disabled, the changes will be lost after a reboot.

Note: Fan control and protection threshold changes are written directly to the PSU hardware and are not persisted to the miner config. They may be reset if the PSU is power-cycled.

Command

$ echo '{"command": "psuset", "parameter":"<session_id>,<key>=<value>[,<key>=<value>...]"}' | nc $MINER_IP 4028 | jq

Examples

Setting bypass configuration

In this example, we enable bypass mode and set a bypass voltage of 13.5:

$ echo '{"command": "psuset", "parameter":"jKk8ljbU,bypass_enabled=true,bypass_voltage=13.5"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 362,
      "Description": "LUXminer 2026.2.2.200326-61240a682",
      "Msg": "PSU configuration updated",
      "STATUS": "S",
      "When": 1770063511
    }
  ],
  "id": 1
}

Setting a protection threshold

In this example, we set the overtemperature warning threshold to 55°C:

$ echo '{"command": "psuset", "parameter":"jKk8ljbU,ot_warn=55"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 362,
      "Description": "LUXminer 2026.2.2.200326-61240a682",
      "Msg": "PSU configuration updated",
      "STATUS": "S",
      "When": 1770063511
    }
  ],
  "id": 1
}

Unsupported threshold error

If the PSU firmware does not support a given threshold, an error is returned:

$ echo '{"command": "psuset", "parameter":"jKk8ljbU,vout_uv_warn=10"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 434,
      "Description": "LUXminer 2026.2.2.200326-61240a682",
      "Msg": "vout_uv_warn is not supported on this PSU",
      "STATUS": "E",
      "When": 1770063511
    }
  ],
  "id": 1
}

Setting fan duty cycle

$ echo '{"command": "psuset", "parameter":"jKk8ljbU,fan_duty_cycle=80"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 362,
      "Description": "LUXminer 2026.2.2.200326-61240a682",
      "Msg": "PSU configuration updated",
      "STATUS": "S",
      "When": 1770063511
    }
  ],
  "id": 1
}

Parameters