ESP-Miner-Bonanza v0.1.0-beta.2

ESP-Miner-Bonanza v0.1.0-beta.2

Second beta release for Bitaxe Bonanza board 1002. This release adds live, user-authoritative frequency and voltage targeting while preserving the proven 800 MHz / 2.8 V startup path and fail-closed Bonanza safety model.

Changes since v0.1.0-beta.1

• Added live 800–2000 MHz frequency targeting without rebooting the ESP.
• Added the startup shortcut followed by direct 25 MHz steps to the requested frequency.
• Kept mining synchronized by completing a full work replacement between PLL steps.
• Added live 2.1–3.2 V aggregate ASIC-rail control with TPS546 command, PGOOD, status, and telemetry verification.
• Enforced safe transition ordering: voltage rises before frequency, while frequency falls before voltage.
• Made saved user frequency and voltage settings authoritative; manual changes do not use automatic voltage retries, pass-rate frequency caps, or automatic rollback.
• Fixed startup tuning so the controller waits for real 800 MHz mining proof before applying saved targets.
• Fixed long-running local rejection spikes by refreshing independent-engine work every 100 ms, keeping the measured full rotation within the 60-ntime budget.
• Added hottest-ASIC temperature reporting and expanded Bonanza power, voltage, bridge, parser, result, ASIC, and engine health telemetry.
• Updated AxeOS frequency and voltage settings, presets, validation, and live-change behavior for board 1002.
• Updated the production and feature documentation to distinguish verified electrical transitions from runtime pass-rate qualification.

Feature status

Feature	Status	Notes
Four-chip BZM2 mining	🟢 Working	All four ASICs and all 944 engines prove mining at 800 MHz before applying saved targets.
Stratum V1 and V2	🟢 Working	Primary and fallback pools, encrypted Stratum V2 transport, share submission, and recovery are supported.
Bonanza startup and safety supervision	🟢 Working	Bridge compatibility, safe-off ownership, power sequencing, runtime fault handling, and controlled restart are enforced.
Frequency targeting	🟢 Working	AxeOS accepts 800–2000 MHz and applies the target live through bounded 25 MHz steps.
Direct voltage tuning	🟢 Working	AxeOS accepts a 2.1–3.2 V aggregate TPS546 rail target and applies it live with command and telemetry verification.
Bonanza health dashboard	🟡 Partially working	Hashrate, shares, pool state, hottest ASIC temperature, measured ASIC-rail power, and ASIC/engine diagnostics work. Generic fan chart data is not populated.
Historical charts	🟡 Partially working	Hashrate, ASIC-rail power, hottest ASIC temperature, input voltage, rail voltage, and current are populated. Generic fan samples remain unavailable.
Swarm metrics and actions	🟡 Partially working	Metrics, remote settings, restart, and identify work. Pause/resume retains the limitation below.
REST and live WebSocket API	🟡 Partially working	System, ASIC, statistics, settings, live tuning, OTA, and bridge update paths work. Pause/resume and generic Bonanza fan telemetry remain incomplete.
Pause and resume mining	🔴 Not yet working	The generic API flag does not yet stop or restart the Bonanza controller and work dispatcher.
Automatic voltage tuning	🔴 Not yet working	The performance curve and retry helpers are not connected to runtime control; the saved user voltage remains authoritative.
Automatic and manual fan control	🔴 Not supported	Bonanza safety currently requires the bridge-controlled fan to remain at 100%.
On-device display	🔴 Not yet working	Board 1002 routes display I²C to GPIO6/GPIO7, while the current firmware bus uses GPIO48/GPIO47.
Overheat-mode reset	🔴 Not yet working	Bonanza uses its dedicated fail-closed safety supervisor and requires inspection and restart after a latched fault.
Bonanza-aware latest-release lookup	🔴 Not yet working	AxeOS still queries the upstream ESP-Miner release feed; select Bonanza firmware from this repository’s releases.

Release assets

Asset	Purpose
esp-miner-factory-1002-v0.1.0-beta.2.bin	Full board-1002 factory/manufacturer image for BitaxeTool.
esp-miner.bin	ESP32-S3 application OTA image for AxeOS or /api/system/OTA.
www.bin	AxeOS filesystem OTA image for /api/system/OTAWWW.
bonanza-bridge-fw-0.0.1-beta.1.bin	Released raw RP2040 bridge firmware for the AxeOS bridge updater.
SHA256SUMS	SHA-256 checksums for every flashable release artifact.
RELEASE-MANIFEST.md	Versions, source commits, sizes, flashing roles, and validation evidence.

The ESP application and AxeOS images must be updated together. The bridge remains version 0.0.1-beta.1 with protocol 1.0.

Validation

• Physical Bitaxe 1002 startup, live frequency changes, live voltage changes, and sustained mining were validated on the release code.
• At 1250 MHz / 3.0 V, the test unit sustained approximately 1.5 TH/s at approximately 48 W, 56 °C board temperature, and 53 °C regulator temperature.
• ESP QEMU suite: 322 tests, 0 failures.
• AxeOS suite: 48 tests passed.
• Exact tagged AxeOS and ESP-IDF 5.5.3 production builds passed.
• Final source-head GitHub Unit Test and Build Firmware workflows passed.
• The factory image contains the board-1002 configuration, application, AxeOS, and OTA metadata at the documented flash offsets.

Verify downloads before flashing:

sha256sum -c SHA256SUMS

Flash the full factory image with BitaxeTool:

bitaxetool --firmware ./esp-miner-factory-1002-v0.1.0-beta.2.bin