Firmware (LuxOS)
Features
Advanced Features

Advanced Features

💡

The following settings can be found in LuxOS under Settings -> Advanced Settings

NoPIC Shutdown

LuxOS is able to run any miner (PIC & NoPIC) with a hashboard powered off. However, by default, LuxOS will power off NoPIC miners by powering off hashboards and disabling the PSU when a hashboard fails preventing from sending voltage to failing hashboards. This feature can be disabled by the user. To do so, go into Settings, click on the Advanced Settings section, then scroll down to disable the NoPIC Hashboard Protection setting. Alternatively, users can disable this functionality through the API by calling the hashboardoptsset command or with LuxOS Commander (opens in a new tab).

  • True: Enabled (default).
  • False: Disabled.

OverTempAutoRecovery

As standard behavior, LuxOS will attempt to recover a hashboard that was powered off due to reaching the dangerous temperature. If the hashboard is still reaching the dangerous temperature after 5 attempts of being powered on, LuxOS will power off the hashboard and will not attempt to further recover it. This behavior can be disabled by the user. To do so, go into Settings, click on the Advanced Settings section, and disable the
Over Temp Auto Recovery setting. Alternatively, users can disable this functionality through the API by calling the hashboardoptsset command or with LuxOS Commander (opens in a new tab). If this feature is disabled, LuxOS will turn off hashboards and disable the PSU when any hashboard reaches the dangerous temperature.

  • True: Enabled (default).
  • False: Disabled.

Advanced Features, NoPIC Shutdown and OverTempAutoRecovery

Logging Level

💡

Changing the logging level requires a Luxminer restart. You can restart Luxminer using the 3 line drop-down menu in the top right corner of every page.

Defines the verbosity of the logs generated by LuxOS. The levels are:

  • TRACE: Provides process level information, useful for enhanced debugging.
  • DEBUG: Provides detailed information useful for debugging issues.
  • INFO: Provides general information about system operation.
  • WARN: Only logs items that can be issues, but do not need immediate user attention.
  • ERROR: Only logs critical errors that require user attention.
  • FATAL: Only logs items that are catastrophic to the miners operation.

To configure the logging level:

  1. Navigate to Settings > Advanced Settings > Logging.
  2. Select the desired logging level from the dropdown menu.

Logging Level settings

Stratum Settings

Smart Switch

Enables Luxminer to automatically revert to the primary mining pool when it becomes available again. This helps ensure maximum mining efficiency.

  • True: Enabled.
  • False: Disabled.

Smart Switch Seconds

Specifies how often (in seconds) Luxminer checks if the primary pool is available. Default: 60

Timeout Seconds

Defines the timeout in seconds for each connection attempt to a mining pool. Default: 5

Max Errors

Sets the maximum number of errors allowed before switching pool priority. Default: 5

Backoff On Error

Enables incremental backoff on subsequent connection errors, helping the miner avoid repeated failed connections when the network is unstable.

  • True: Enabled.
  • False: Disabled.

Stratum settings

Auto Updates

Source

💡

Selecting a software branch will impact both automatic updates and manual firmware updates.

Specifies the type of updates LuxOS will download:

  • Stable: Production-ready updates.
  • Preview: Beta versions for early access.
  • Testing: Experimental updates for advanced users.

Timeout

Defines the interval (in minutes) for checking new updates. Default: 60

On Timeout

Determines the action LuxOS takes when a Timeout interval occurs:

  • Off: No action.
  • Download: Downloads updates but does not apply them.
  • Apply: Downloads and applies updates.
  • Full: Downloads, applies updates, and restarts the miner.

On Startup

Determines the action LuxOS takes on miner startup:

  • Off: No action.
  • Download: Downloads updates but does not apply them.
  • Apply: Downloads and applies updates.
  • Full: Downloads, applies updates, and restarts the miner.

On User

Determines the action triggered manually via the GUI or updaterun API:

  • Off: No action.
  • Download: Downloads updates but does not apply them.
  • Apply: Downloads and applies updates.
  • Full: Downloads, applies updates, and restarts the miner.

Auto update settings

Temperature Control

Required Sensors per Board

Specifies the minimum number of functional temperature sensors required per hashboard. If this threshold is not met, LuxOS will attempt to reboot the board or shut it down if issues persist. Options: 1, 2, 3, 4

Max Bad Readings

Sets the maximum number of consecutive bad temperature readings before considering the sensor "broken." Default: 10

Bad Avg Threshold

Determines the average temperature threshold above which readings are considered unreliable. Default: 2

Temperature Control settings

Uninstall Firmware

This option allows users to remove LuxOS from the miner.

To uninstall LuxOS:

  1. Navigate to Settings > Advanced Settings > Uninstall Firmware, and select Uninstall.
  2. Follow the on-screen instructions to complete the uninstall process.

Uninstall LuxOS setting