hashboardctrlget

Description

Returns each hashboard's voltage settings and the telemetry of its voltage regulator, on miners that have a voltage regulator on each hashboard. Today that is the Antminer Z15 Pro; on every other model the command returns error 438. Use hashboardctrlset to change a board's voltage.

With no parameter (or an empty one), every detected board is listed, in ascending ID order. Pass a board ID to list only that board. On the Z15 Pro the board IDs are the connector IDs 0 to 3, so they are not always 0, 1 and 2.

For each board, the reply separates three voltages: the one the regulator was last set to (HashboardVoltage), the one the current profile specifies (ProfileHashboardVoltage) and the factory value from the board's EEPROM (EepromHashboardVoltage). When a hashboardctrlset is in effect, HashboardVoltage differs from ProfileHashboardVoltage.

The measured fields (MeasuredHashboardVoltage, MeasuredHashboardCurrent, MeasuredHashboardPower and RegulatorTemperature) are optional. They are absent until the first regulator reading for that board arrives, and absent again after the board is powered off. The boards are read in turn, so a newly started board can take tens of seconds to report.

The TOTAL section sums the measured power and current over the boards listed and carries the hottest regulator temperature, so you don't have to add the boards up yourself. When no listed board is reporting (for example when the miner is curtailed), TOTAL holds only BoardsReporting: 0.

Command

$ echo '{"command": "hashboardctrlget"}' | nc $MINER_IP 4028 | jq

Examples

In this example, we list every board on an Antminer Z15 Pro with boards on connectors 0, 2 and 3, all running the 850MHz profile:

$ echo '{"command": "hashboardctrlget"}' | nc $MINER_IP 4028 | jq
{
  "HASHBOARDCTRL": [
    {
      "Board": 0,
      "EepromHashboardVoltage": 2.43,
      "HashboardVoltage": 2.53,
      "InputVoltage": 12.001,
      "MeasuredHashboardCurrent": 417,
      "MeasuredHashboardPower": 1053.76,
      "MeasuredHashboardVoltage": 2.527,
      "Profile": "850MHz",
      "ProfileHashboardVoltage": 2.53,
      "RegulatorTemperature": 87
    },
    {
      "Board": 2,
      "EepromHashboardVoltage": 2.43,
      "HashboardVoltage": 2.53,
      "InputVoltage": 12.074,
      "MeasuredHashboardCurrent": 417,
      "MeasuredHashboardPower": 1053.76,
      "MeasuredHashboardVoltage": 2.527,
      "Profile": "850MHz",
      "ProfileHashboardVoltage": 2.53,
      "RegulatorTemperature": 91
    },
    {
      "Board": 3,
      "EepromHashboardVoltage": 2.43,
      "HashboardVoltage": 2.53,
      "InputVoltage": 12.074,
      "MeasuredHashboardCurrent": 415,
      "MeasuredHashboardPower": 1048.71,
      "MeasuredHashboardVoltage": 2.527,
      "Profile": "850MHz",
      "ProfileHashboardVoltage": 2.53,
      "RegulatorTemperature": 87
    }
  ],
  "STATUS": [
    {
      "Code": 386,
      "Description": "LUXminer 2026.9.28.204000-ecdf06e",
      "Msg": "Hashboard Control",
      "STATUS": "S",
      "When": 1790635560
    }
  ],
  "TOTAL": [
    {
      "BoardsReporting": 3,
      "MeasuredHashboardCurrent": 1249,
      "MeasuredHashboardPower": 3156.22,
      "RegulatorTemperatureMax": 91
    }
  ],
  "id": 1
}

To list a single board, pass its ID, for example "parameter":"2".

Parameters

Parameter	Notes
`board_id`	Optional. ID of a detected board. If omitted, lists every board.

Field details

`HASHBOARDCTRL`

Field	Notes
`Board`	Board ID.
`EepromHashboardVoltage`	Factory voltage for this board, derived from its EEPROM, in volts.
`HashboardVoltage`	Voltage the regulator was last set to, in volts. This is the setpoint, not a measurement. `0` until the board has started, and after it is powered off.
`InputVoltage`	Measured voltage at the board's 12 V input, in volts. `0` when unavailable or powered off.
`MeasuredHashboardCurrent`	Optional. Current measured by the regulator, in amps.
`MeasuredHashboardPower`	Optional. `MeasuredHashboardVoltage` × `MeasuredHashboardCurrent`, in watts, rounded to 0.01 W.
`MeasuredHashboardVoltage`	Optional. Voltage measured by the regulator, in volts, to 1 mV.
`Profile`	Name of the current profile.
`ProfileHashboardVoltage`	Voltage the current profile specifies for this board, in volts. `0` if the profile specifies none.
`RegulatorTemperature`	Optional. Temperature of the board's voltage regulator, in °C.

`TOTAL`

Field	Notes
`BoardsReporting`	Number of listed boards that have regulator telemetry.
`MeasuredHashboardCurrent`	Optional. Sum of `MeasuredHashboardCurrent` over the reporting boards, in amps.
`MeasuredHashboardPower`	Optional. Sum of the measured power over the reporting boards, in watts, rounded to 0.01 W.
`RegulatorTemperatureMax`	Optional. The highest `RegulatorTemperature` among the reporting boards, in °C.

The optional TOTAL fields are present only when BoardsReporting is greater than 0.

Errors

Code	Reason
`401`	The `board_id` is not a number, or no such board exists.
`438`	This miner has no voltage regulator on each hashboard.

hashboardctrlget

On this page