Skip to content

wisnc/crub

Repository files navigation

crub


A lightweight bootloader/firmware flasher for M5Cardputer ADV with disk partition management and a UNIX-like file manager.


boot screen

partition info

running flash binary.bin

editor

overall


Building

git clone https://github.com/wisnc/crub
cd crub
pio run -e bootloader
pio run -e m5cardputer

Installing

Since this is a merged firmware, you need to use esptool.

python -m esptool --chip esp32s3 --port <COM PORT> --baud 1500000 --before default_reset --after hard_reset write_flash -z 0x0 .pio\build\bootloader\bootloader.bin 0x8000 .pio\build\m5cardputer\partitions.bin 0x10000 .pio\build\m5cardputer\firmware.bin

make sure to replace <COM PORT> with your cardputer serial port.

How to use

flash binaries from SD with

flash /path/to/binary.bin

then launch it with

launch

create aliases for flashing and launch: e.g. shortcut flash and launch bruce as "br"

alias br "bruce /binaries/bruce.bin && launch"

commands can be viewed with help

display can also be controlled with Fn + _ and Fn + = for dimmer and brighter display. also Btn0 toggles display to save battery

editor

edit (filename) to enter nano-like editor

Fn + , . / ; for left down right up

Fn + backspace for exit/save. moves to status line and prompts directory to save and filename. enter to save Fn + backspace to discard

Fn + C copy line

Fn + V paste line

Fn + X cut line


Version History / Changelog

v2.1

  • fixed an issue where having a LoRa Cap (or any Cap on that matter) interferes with reading the SD on boot

v2.0

  • updated UI
  • added a nano-like text editor
  • probably final update as no other features are planned

v1.8

  • nvs gets overwritten every time a firmware is being flashed. this was on 1.7 when i added functionality to name what firmware is inside ota_0 by writing it in nvs. it is also where the aliases are saved. fixed it by moving those to SD (firmware name and alias). because who would use this firmware flasher and file manager without an SD right?

v1.7

  • Public release
  • GitHub repository created

About

a lightweight bootloader/firmware flasher for M5Cardputer ADV with disk partition management and UNIX like file manager. Now with an editor!

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors