ESP-Miner-Bonanza v0.1.0

ESP-Miner-Bonanza v0.1.0

First stable release for Bitaxe Bonanza board 1002, paired with bonanza-bridge-fw 0.0.1 and bridge protocol 1.0.

Highlights

• Adds working bonanzaDisplay protocol-v1 support over GPIO6/GPIO7, live connection health in AxeOS, external identify support, and the matching production bonanzaDisplay-v0.1.0.uf2 Release image.
• Adds configurable AxeOS/ESP log levels and silences routine nonce traffic at normal verbosity.
• Smooths instantaneous hashrate over a 30-second window.
• Reduces Bonanza TDM telemetry to the minimum supported cadence while restoring frequent result sampling; hardware validation recorded no new parser loss or bridge FIFO/ring overflow.
• Publishes only the supported board-1002 factory image.

Supported feature summary

Feature	Status	Notes
Four-chip BZM2 mining	Working	All four ASICs and 944 engines prove mining at 800 MHz, then continue mining while the controller moves to the configured target.
Bonanza startup and safety supervision	Working	Bridge compatibility, safe-off ownership, power sequencing, runtime fault handling, and controlled restart are enforced.
Stratum V1 and V2	Working	Primary/fallback pools, encrypted Stratum V2 transport, share submission, and recovery are supported.
Bonanza health dashboard	Working	Hashrate, shares, pool state, temperatures, measured ASIC-rail power, fan telemetry, and ASIC/engine diagnostics are live.
ESP firmware and AxeOS OTA	Working	esp-miner.bin and www.bin can be uploaded through AxeOS or the HTTP API.
RP2040 bridge update and recovery	Working	Manifested bridge images are programmed and read-back verified over onboard SWD.
On-device display	Working	ESP-Miner publishes identity and mining data once per second to the external RP2350/SSD1322 bonanzaDisplay; AxeOS reports connection state.
Pause/resume and recoverable overheat	Working	Both paths fail safe and require the complete production startup proof before mining resumes.
Automatic/manual fan and live tuning	Working	Bridge-owned fan control, 800-2000 MHz frequency targeting, and bounded 2.1-3.2 V direct rail control are available.

Images

• esp-miner-factory-1002-v0.1.0.bin: full 16 MB manufacturer/factory image for board 1002; resets settings.
• esp-miner.bin: ESP application OTA image.
• www.bin: AxeOS filesystem OTA image.
• bonanza-bridge-fw-0.0.1.bin: matching RP2040 bridge image, installable from AxeOS.
• bonanzaDisplay-v0.1.0.uf2: matching RP2350 ARM Secure display image, installable over the display's USB bootloader.
• SHA256SUMS: checksums for all binary assets and the manifest.
• RELEASE-MANIFEST.md: source revisions, artifact roles, build identity, and validation record.

Only use these images with Bitaxe Bonanza board 1002. Generic upstream ESP-Miner images do not contain the Bonanza bridge and safety contract.

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

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

Prototype beta for Bitaxe Bonanza board 1002, paired with bonanza-bridge-fw 0.0.1-beta.2 using bridge protocol 1.0.

Supported feature summary

Feature	Status	Notes
Four-chip BZM2 mining	🟢 Working	All four ASICs and 944 engines prove mining at 800 MHz, then continue mining while the controller moves to the configured target.
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.
Bonanza health dashboard	🟢 Working	Bonanza Miner Health, hashrate, shares, pool state, hottest fresh ASIC temperature, measured ASIC-rail power, fan speed/RPM, and ASIC/engine diagnostics work.
Wi-Fi, mDNS, and Swarm discovery	🟢 Working	Setup, .local access, discovery, device listing, remote settings, restart, and identify are available.
Scoreboard and logs	🟢 Working	Highest-difficulty shares, live WebSocket logs, filtering, and log downloads are available.
ESP firmware and AxeOS OTA	🟢 Working	esp-miner.bin and www.bin can be uploaded through AxeOS or the HTTP API.
RP2040 bridge update and blank-bridge recovery	🟢 Working	Manifested raw bridge images are programmed and read-back verified over onboard SWD.
Pause and resume mining	🟢 Working	AxeOS and the REST API revoke dispatch, force and verify OFF_SAFE, then resume through the complete 2.8 V / 800 MHz production startup before restoring the configured live target.
Recoverable overheat protection	🟢 Working	ASIC temperatures above 75 C or regulator temperatures above 105 C close dispatch, force verified OFF_SAFE and 100% fan, cool for at least 30 seconds and to a regulator temperature no higher than 95 C, then reduce voltage/frequency by 100 mV/100 MHz and repeat full production startup.
Frequency targeting	🟢 Working	AxeOS accepts 800–2000 MHz without rebooting. The controller keeps mining through a bounded initial shortcut and then advances directly to the user target in 25 MHz steps, replacing work between steps.
Direct voltage tuning	🟢 Working	AxeOS accepts an aggregate TPS546 rail target from 2.1–3.2 V and applies it live with command, PGOOD, status, and telemetry readback validation.
Automatic and manual fan control	🟢 Working	The ESP PID/manual task drives the bridge after mining reaches RUNNING, with a hardware-qualified 36% command floor and a 1000 RPM live interlock. Safe/off, maintenance, and overheat states force 100%. The matching bridge image is included in Bonanza releases.
On-device display	🔴 Blocked by display firmware	The optional Bonanza display is a separate RP2354A/SSD1322 computer connected to ESP GPIO4–7, not an upstream passive I²C panel. Its repository publishes hardware only, with no RP2354 firmware or host protocol to implement against. Generic ESP-Miner display settings therefore do not control it.
Bonanza-aware latest-release lookup	🟢 Working	AxeOS queries the ESP-Miner-Bonanza feed, accepts its published beta releases, and links the ESP firmware, AxeOS filesystem, and matching bridge image.

Highlights

• Adds automatic and manual bridge-owned fan control, fan percentage/RPM telemetry throughout AxeOS, the hardware-qualified 36% floor, and forced 100% fan in startup, safe-off, maintenance, fault, shutdown, and overheat states.
• Adds guarded mining pause/resume in AxeOS and the REST API. Pause revokes dispatch and proves OFF_SAFE; resume repeats full 2.8 V / 800 MHz startup validation before restoring the saved live target.
• Adds upstream-style recoverable overheat handling: ASIC temperatures above 75 C or TPS546 temperatures above 105 C force safe-off and 100% fan, require at least 30 seconds of cooling and TPS546 temperature at or below 95 C, reduce the saved target by 100 MHz / 100 mV, and retry complete startup automatically.
• Completes live frequency and direct voltage targeting, bridge firmware update/recovery, Bonanza health reporting, latest-beta discovery, and safe restart integration.
• Hardens live PLL changes with the BIRDS 1-second TDM read window, scheduled safety-lease servicing, and bounded retries for transient I/O/readback failures.

The optional RP2354A/SSD1322 display remains blocked on external display firmware and a published ESP host protocol.

Images

• esp-miner-factory-1002-v0.1.0-beta.3.bin: full 16 MB manufacturer/factory image for board 1002; resets settings.
• esp-miner.bin: application OTA image.
• www.bin: AxeOS filesystem OTA image.
• bonanza-bridge-fw-0.0.1-beta.2.bin: matching RP2040 bridge image, installable from AxeOS.
• SHA256SUMS: checksums for all binary assets and the manifest.
• RELEASE-MANIFEST.md: source revisions, protocol contract, artifact roles, and validation record.

Only use these images with Bitaxe Bonanza board 1002. Generic upstream ESP-Miner images do not contain the Bonanza bridge and safety contract.

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

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

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

First beta release artifact set for Bitaxe Bonanza board 1002.

Supported feature summary

Feature	Status	Notes
Four-chip BZM2 mining	🟢 Working	All four ASICs and 944 engines run at the fixed production profile of 800 MHz and a 2.8 V board rail.
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.
Bonanza health dashboard	🟡 Partially working	Bonanza Miner Health, hashrate, shares, pool state, and ASIC/engine diagnostics work. Some legacy generic power, heat, fan, and chart fields are not populated.
Wi-Fi, mDNS, and Swarm discovery	🟢 Working	Setup, .local access, discovery, device listing, remote settings, restart, and identify are available.
Scoreboard and logs	🟢 Working	Highest-difficulty shares, live WebSocket logs, filtering, and log downloads are available.
ESP firmware and AxeOS OTA	🟢 Working	esp-miner.bin and www.bin can be uploaded through AxeOS or the HTTP API.
RP2040 bridge update and blank-bridge recovery	🟢 Working	Manifested raw bridge images are programmed and read-back verified over onboard SWD.
Pause and resume mining	🔴 Not yet working	The API changes the AxeOS flag but does not stop or restart the Bonanza controller and work dispatcher.
Frequency targeting	🔴 Not yet implemented	This beta uses a fixed 800 MHz target. Runtime frequency target selection is planned for a future release.
Voltage tuning	🔴 Not supported	Board 1002 remains locked to its validated 2.8 V board rail.
Automatic and manual fan control	🔴 Not supported	The Bonanza safety controller currently requires the bridge-controlled fan to remain at 100%.
On-device display	🔴 Not yet working	Board 1002 routes display SCL/SDA to ESP32-S3 GPIO6/GPIO7, while this firmware initializes its I²C bus on GPIO48/GPIO47. AxeOS exposes display settings, but the board-specific display pin/bus path is not implemented or validated.
Bonanza-aware latest-release lookup	🔴 Not yet working	AxeOS still queries the upstream ESP-Miner release feed and must not be used to select Bonanza firmware.

Release assets

Asset	Size	Purpose
esp-miner-factory-1002-v0.1.0-beta.1.bin	15,802,368 bytes	Full board-1002 factory/manufacturer image for BitaxeTool. Includes the bootloader, partition table, Bonanza NVS configuration, ESP firmware, AxeOS, and initial OTA metadata.
esp-miner.bin	1,804,960 bytes	ESP32-S3 application OTA image for the AxeOS firmware update or /api/system/OTA.
www.bin	3,145,728 bytes	AxeOS filesystem OTA image for the AxeOS web update or /api/system/OTAWWW.
bonanza-bridge-fw-0.0.1-beta.1.bin	44,572 bytes	Raw RP2040 bridge image for the AxeOS bridge updater or /api/system/bridge/firmware.

Versions and source

• ESP-Miner-Bonanza and AxeOS version: v0.1.0-beta.1
• ESP-Miner-Bonanza source: b5d246f1e667235e4456f8eed2a058f52f545eae
• Bonanza bridge version: 0.0.1-beta.1
• Bonanza bridge source: 4fea080ffdf30f07b10430340259c3196ef12a60
• Bridge target and protocol: board 1002, protocol 1.0
• ESP-IDF: v5.5.3

Validation

• ESP application image checksum and validation hash are valid.
• ESP application metadata reports project esp-miner, app version v0.1.0-beta.1, and ESP-IDF v5.5.3.
• AxeOS version.txt reports v0.1.0-beta.1.
• Factory image byte-for-byte contains all six inputs at the expected flash offsets.
• Board-1002 factory configuration matches the fixed 800 MHz, 2800 mV BZM production profile.
• ESP QEMU suite: 305 tests, 0 failures.
• Blank-bridge recovery tooling: 9 tests passed.
• Bridge host suite: 41 tests passed; formatting and Clippy passed.
• Bridge release build passed and its manifest parsed at offset 42,964 with board 1002, protocol 1.0, and version 0.0.1-beta.1.
• GitHub CI for both exact source commits was green, including ESP backend/frontend tests and both bridge jobs.

Verify the assets before flashing:

sha256sum -c SHA256SUMS

Flash the full factory image with BitaxeTool:

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