btcflash

btcflash [SUBCOMMAND] [OPTIONS]

--help
    Print help information

--version
    Print version

--log-level
    Set log verbosity (off,error,warn,info,debug,trace)

--interface
    Interface type: net (default), uart

--port
    Port or IP/range (e.g., 192.168.1.0/24)

--url
    Firmware URL or local file path

--recovery-url
    Recovery firmware URL for bootloader

--force
    Skip confirmations and safety checks

--timeout
    Connection timeout in seconds (default: 30)

--progress
    Show flashing progress bar

--dry-run
    Simulate without flashing

btcflash is a command-line tool from Braiins for flashing firmware onto Bitcoin mining ASICs, such as Antminer S9/S17 series. It enables safe, network-based or serial updates to Braiins OS, an open-source miner OS that improves efficiency and security over stock firmware.

Key features include device discovery, bootloader flashing, full OS installation, and recovery modes. It supports multiple interfaces (Ethernet, UART) and verifies firmware integrity via checksums. Users can flash individual miners or batches, with progress monitoring and error handling.

Primarily used in mining farms for bulk upgrades, it requires network access or direct serial connection. Always backup original firmware before flashing to avoid bricking devices. Compatible with Braiins OS v20+ and select Avalon models via plugins.

The tool integrates with braiins-toolbox suite, offering automation scripts for large-scale deployments. It's lightweight, dependency-minimal, and logs extensively for troubleshooting.

Risk of bricking unsupported miners.
Requires admin privileges and stable network.
Not for stock firmware flashing.

list: Discover devices.
flash: Install firmware.
info: Device details.
recovery: Bootloader restore.

btcflash list --interface net
btcflash flash --url https://os.braiins.com/... 192.168.1.100
btcflash recovery --recovery-url ... --force

Introduced by Braiins in 2020 with OS v20. Enhanced in 2022 for batch flashing and Avalon support. Actively maintained for miner ecosystem evolution.

braiins-toolbox(1), avrdude(1), cgminer(8)