# Vnish Firmware: Special Handling Guide

## Dynamic Submodel Handling

Vnish firmware lets you adjust device performance using presets like Underclock or Overclock. That’s why the usual submodel may not match the device’s real performance.

#### Key points:

* The system calculates a **dynamic submodel (Dynsub)** based on the active preset.
* Device and board statuses are evaluated relative to this dynamic value.
* Devices using Dynsub are marked with a special icon.
* Hovering over the performance mode shows detailed info about the preset (e.g. *Underclock 2: 3080 W \~ 104 TH*).

{% hint style="info" %}

#### Why it matters:

This dynamic evaluation ensures more accurate detection of performance issues like **Lowhash** — now only flagged if an individual board falls below 75% of its expected hashrate (based on Dynsub).
{% endhint %}

## Error Handling Without Reboot

Some hardware errors detected by Vnish **no longer require a reboot**:

* Chain break detected;
* Break domain balance detected;
* Autotune failed.

#### How Moonone handles it:

* Automatically blocks reboot-related actions.
* Disables internal integrity checks safely, allowing self-recovery.
* If these checks fail after restart, the system applies a new config threshold to optimize further attempts.
* In rare cases where errors persist, a diagnostic task is created **automatically**.

{% hint style="info" %}
**The result:** fewer unnecessary reboots and improved long-term device stability.
{% endhint %}

## Performance Mode Interpretation

To improve the accuracy of performance labeling:

* Devices with Vnish firmware now classify the **Normal** mode as the **first available preset, not lower than the nominal value**.
* If only lower values exist, the highest one is used instead.
* Overclock and Underclock labels remain unchanged.

{% hint style="info" %}
**Purpose:** Consistent interpretation and display of device performance modes.
{% endhint %}

## Full Firmware Version Display

To improve transparency and streamline support, Vnish devices now display the full firmware version, including build name and platform details.

## Factory Reset with MAC Address Warning

Factory reset is now available for Vnish-powered devices — with a clear warning.

#### When triggered:

* The user must confirm the action.
* If any selected device runs on Vnish, a warning appears:

> ⚠️ After a reset, Vnish devices will move to 'Unimported' as their MAC address is cleared — reconfiguration is required to bring them back.

{% hint style="info" %}
**Purpose:** To prevent accidental resets of devices that require manual reimport.
{% endhint %}

## CV Board Protection

Devices with CV-type control boards are sensitive to full reboots, which can trigger a firmware rollback.

#### System behavior:

* If reboot is requested on such devices, the system will **automatically replace it with a safer** '**Restart mining**' command.
* This substitution also applies to automated reboots and unknown board types.
* A modal warning appears:

> ⚠️ Some selected devices use CV boards. Rebooting may reset Vnish firmware. We'll run ‘Restart mining’ instead.

This helps preserve device configuration and minimize downtime.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.moonone.online/other/vnish-firmware-special-handling-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
