Skip to content

Latest commit

 

History

History
45 lines (35 loc) · 1.86 KB

README.md

File metadata and controls

45 lines (35 loc) · 1.86 KB

logo bashflash

A small TUI script to flash firmware

Usage

[erovia@pc]$ bash <(curl -s https://raw.githubusercontent.com/Erovia/bashflash/main/bashflash)

demo

Features

  • Uses only Bash (v4+) and a few POSIX tools. (On macOS, please use the Bash from Homebrew.)
  • No external dependencies besides the low-level flasher tools.
  • No download/install necessary.
  • Flashing/Multiflashing (similar to Toolbox's Auto-flash)
  • Doctor menu for showing basic system info.
  • Supported bootloaders and flashers:
Bootloader Flasher
Caterina avrdude
Atmel DFU dfu-programmer
DFU dfu-util
WB32 DFU wb32-dfu-updater_cli
ISP/ASP avrdude
UF2 uf2conv.py (see below)
Massdrop mdloader
QMK HID avrdude
PJRC HalfKay avrdude

Flashing RP2040

Flashing RP2040-based devices (Raspberry Pi Pico, SparkFun Pro Micro RP2040, Adafruit KB2040, etc) requires the uf2conv.py script from Microsoft.
Bashflash looks at a number of directories for this script (such as local QMK installation directory, if it can find one) and tries to use that.
Otherwise, you can quickly download the script from its official repository:

curl -LO https://raw.githubusercontent.com/microsoft/uf2/master/utils/uf2conv.py
curl -LO https://github.com/microsoft/uf2/blob/master/utils/uf2families.json

Note: You need both uf2conv.py and uf2families.json.