Skip to content

About

Bitaxe ESP Mining firmware written in rust

Resources

Stars

20 stars

Watchers

3 watching

Forks

Repository files navigation

ESP-Miner-rs

Introduction

ESP-Miner-rs is bitcoin miner firmware designed to run on the ESP32-S3 of various Bitaxe:

and more to come.

Architecture

  • firmware/: the #[no_std] firmware for the ESP32-S3 (esp-hal + embassy), built from its own directory
  • miner-core/: the hardware independent mining logic (block header, share check, job book, core voltage, fan curve), tested on the host
  • ASIC driver: bm13xx-rs

Setup

Nix user

nix-shell

Other

  • install rust
  • follow the espup installation guide
    • skip §3.2 "RISC-V Targets Only" as out 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 is you are using USB-JTAG-SERIAL peripheral (recommanded) or espflash

Build and/or Run

dev profile can potentially be one or more orders of magnitude slower than release, and may cause issues with timing-senstive peripherals and/or devices of esp-hal

Using Just

  • edit the just file to change your local WIFI SSID/PASSWORD
  • just build max to build esp-miner-rs for BitaxeMax
  • just build ultra to build esp-miner-rs for BitaxeUltra
  • just run max to build/flash/run esp-miner-rs for BitaxeMax on the connected hardware
  • just test to run the miner-core tests on the host

Manually

  • cd firmware
  • WIFI_SSID="my_ssid" WIFI_PASSWORD="my_password" cargo build --release --features=bitaxe-max
  • WIFI_SSID="my_ssid" WIFI_PASSWORD="my_password" cargo run --release --features=bitaxe-max
  • cargo test from the repository root runs the miner-core tests on the host

About

Bitaxe ESP Mining firmware written in rust

Resources

Stars

20 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages