Capability-aware Bitaxe tuning and safety improvements

[yashbhutwala]

Summary

This PR turns the single-miner script into a capability-aware, multi-miner AxeOS tuner and improves its safety and measurement quality.

• Discover frequency and voltage candidates from /api/system/asic instead of assuming fixed increments.
• Support multiple miners, parallel workers, --status, --dry-run, adaptive and matrix strategies, and checkpointed JSON results.
• Verify settings after restart and guard chip temperature, VR temperature, input voltage, power, faults, hashrate ratio, and error rate.
• Use trimmed statistics and tolerate isolated error-percentage spikes while still rejecting sustained or extreme errors.
• Avoid restoring an unsupported or thermally marginal baseline after a failed run; use the advertised factory point when needed.
• Add tests and documentation for the workflow.

Live validation

Tested against three Gamma 601 / BM1370 miners running ESP-Miner/AxeOS v2.15.0:

• 625 MHz / 1100 mV, approximately 1.27 TH/s; 10-minute confirmation averaged 14.55 J/TH.
• kept at 525 MHz / 1150 mV because 550 MHz reached the 70 C chip safety ceiling.
• kept at 525 MHz / 1150 mV because 550 MHz reached the 85 C VR safety ceiling.

The official firmware API is documented in the ESP-Miner repository: https://github.com/bitaxeorg/ESP-Miner. Gamma hardware guidance is at https://github.com/bitaxeorg/bitaxeGamma.

Verification

• python3 -m unittest discover -s tests -v — 10 tests passed.
• python3 -m py_compile bitaxe_hashrate_benchmark.py — passed.
• Read-only status and dry-run checks passed against all three miners.

This is a draft for maintainer review; the live miner measurements are included to make the safety and tuning decisions reproducible.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d990a0da-7777-41af-ad1a-8e037a4631fe

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}