ESP-Miner-rs is bitcoin miner firmware designed to run on the ESP32-S3 of various Bitaxe:
- BitaxeMax with 1 Bitmain ASIC BM1397
- BitaxeUltra with 1 Bitmain ASIC BM1366
- BitaxeGamma with 1 Bitmain ASIC BM1370
and more to come.
This fork adds Gamma 601 power management and the official AxeOS interface, served by the Rust firmware. Compilation and host tests have been completed; validation on physical hardware is still required. See integration status for supported features and current limitations.
firmware/: the#[no_std]firmware for the ESP32-S3 (esp-hal + embassy), built from its own directorycrates/miner-core/: the hardware independent mining logic (block header, share check, job book, core voltage, fan curve), tested on the hostweb/axeos/: the official Angular AxeOS interface, connected to the Rust API- ASIC driver: bm13xx-rs, included in
vendor/bm13xx-rs/with BM1370 support
- install rust
- follow the espup installation guide
- skip §3.2 "RISC-V Targets Only" as our target is Xtensa ESP32-S3
- in §3.3 "RISC-V and Xtensa Targets" you can install only esp32s3 target
espup install -t esp32s3 - skip §3.4 "std Development Requirements" as we are
#[no_std]
- install probe-rs if you are using
USB-JTAG-SERIALperipheral (recommended) or espflash
dev profile can potentially be one or more orders of magnitude slower than release, and may cause issues with timing-sensitive peripherals and/or devices of esp-hal
- set your local Wi-Fi credentials:
export WIFI_SSID="my_ssid" WIFI_PASSWORD="my_password" just build maxto build esp-miner-rs for BitaxeMaxjust build ultrato build esp-miner-rs for BitaxeUltrajust build gammato build esp-miner-rs for BitaxeGamma 601just testto run the host workspace tests
cd firmwareWIFI_SSID="my_ssid" WIFI_PASSWORD="my_password" cargo build --release --features=bitaxe-maxWIFI_SSID="my_ssid" WIFI_PASSWORD="my_password" cargo build --locked --release --features=bitaxe-gammaWIFI_SSID="my_ssid" WIFI_PASSWORD="my_password" cargo run --release --features=bitaxe-maxcargo testfrom the repository root runs the host workspace tests
For the initial USB installation, run the following from firmware/ with the supplied partition table:
espflash flash --partition-table partitions.csv \
target/xtensa-esp32s3-none-elf/release/esp-miner-rsThen open the device’s DHCP IPv4 address in your browser. Gamma 601 defaults to 525 MHz / 1,150 mV. See the build guide for installation details.
The official production interface is already embedded in the firmware. To preview AxeOS without hardware, use Node.js 22:
cd web/axeos
npm ci
npm run generate:api
npm startOpen http://localhost:4200. This preview uses the official mock data.
From the repository root, python3 scripts/build-axeos.py rebuilds the production interface and its embedded assets; Python 3.11+ is required. Rebuild the firmware afterwards. The --demo option builds a mock preview without replacing the embedded production assets.
AxeOS retains its upstream license. Source provenance is recorded in docs/upstream.json.