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
fetch
overall
git clone https://github.com/wisnc/crub
cd crub
pio run -e bootloader
pio run -e m5cardputer
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.binmake sure to replace <COM PORT> with your cardputer serial port.
flash binaries from SD with
flash /path/to/binary.bin
then launch it with
launch
aliases can be externally edited (or with the built in editor) and is located as a text file in
/.crub/aliases
create aliases for flashing and launch: e.g. shortcut flash and launch bruce as "br"
alias br "flash /binaries/bruce.bin && launch"
view binary partition scheme
pt info /path/to/binary.bin
run scripts from SD
run /path/to/script.sh
scripts are just text files with one command per line. lines starting with # are comments. you can use echo, sleep, and any other crub command inside them. output redirection works with > and >>
echo hello > /notes/test.txt
echo second line >> /notes/test.txt
ls /binaries > /logs/filelist.txt
boot scripts run automatically if /.crub/boot exists on the SD card. the boot screen itself is just a command, boots <ms>, so the default boot script is
boots 1500
fetch
delete the boots line to skip the splash, change the number to adjust how long it shows, or replace everything with launch -f for instant firmware boot
for waiting in scripts, waits <seconds> and waitms <milliseconds> are also available alongside sleep
drop a bmp at /.crub/bootscreen.bmp and boots will show it instead of the built in logo. it has to be exactly 240x135.
convert and scale any image with ffmpeg. example below
ffmpeg -i input.png -vf scale=240:135:flags=lanczos -pix_fmt bgr24 bootscreen.bmp
if the source is not 16:9 that command stretches it. to crop to fill instead
ffmpeg -i input.png -vf "scale=240:135:force_original_aspect_ratio=increase:flags=lanczos,crop=240:135" -pix_fmt bgr24 bootscreen.bmp
the cardputer has an ir transmitter on the top edge. crub can fire raw codes or from SD
ir add tv nec <hex>
ir send tv
ir raw samsung <hex>
ir list
ir del tv
ir file /ir/tcl.ir
ir file /ir/tcl.ir Power
ir add tvpower file /ir/tcl.ir Power
protocols are nec, samsung, and sony. codes are hex in the same form IRremoteESP8266 and most online code tables use, the bits as transmitted with the first one leftmost. nec and samsung are 32 bit, sony defaults to 12 and takes a bits argument for 15 or 20 bit remotes
ir file reads flipper zero .ir files. ir add <name> file <path> <entry> copies the code into /.crub/ir so the .ir file is not needed after
saved codes can be found in /.crub/ir
crub has the capability to connect to a PC/smartphone and act as an SD Card reader (reading the inserted SD card on the cardputer). before plugging in, enter the command
usbsd
connect your cardputer via usbc to usbc or usba to a pc/smartphone and refresh your drives. you should be able to see the SD card and manage your files from your pc/smartphone
fetch can be reconfigured without touching code. pick which fields show and in what order
fetch fields cpu ram bat uptime mac temp
available fields are cpu, ram, flash, boot, fw, sd, lcd, bat, uptime, mac, and temp. fetch fields reset restores the default set
change the ascii art with any file, or edit it directly in the editor
fetch logo /path/to/art.txt
fetch edit
fetch logo reset restores the built in logo. fetch config lives in /.crub/
general settings live in /.crub/config
right now only lssort key exists.
lssort sorts ls. name is alphabetical, date is newest first, both with folders first. none is the raw order from the card.
all crub config lives under a single /.crub/ directory. run crub fix to move any old loose config files into it and create missing defaults
on boot, a /.crub/theme is created which contains the default theme of crub, edit it with the editor. you are also able to use .bmp files as a background for the console, make sure it is also 240x135.
color primary 00D0FF
color border 0080FF
color info FFFFFF
color ok 00FF88
color warn FFD000
color error FF4040
background <file.bmp>
blur on|off
bgtrans <0-255>
these are the default values for the theme and can be found on the /.crub/theme file.
write launch -f to /.crub/boot and crub will skip the boot screen and launch installed firmware instantly on power on. remove the SD card to enter crub normally
echo launch -f > /.crub/boot
you can also quickly do calculations. start the expression with '='. for example
>=5*3
15
>=2.5*(3+1)
10
>=100/3
33.3333
>=17%5
2
>=(2+3)*(7-1)
30
commands can be viewed with help
display can also be controlled with bright <0-255>, Fn + _ and Fn + = for dimmer and brighter display. also Btn0 toggles display to save battery
Fn + ; . browse command history
Fn + , / move the cursor
Ctrl + ; . scroll the console
Ctrl + C abort the current line
the prompt shows the current directory, /binaries > _
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
Opt + . move to end of the file
Opt + ; move to top of the file
pressing right at the end of a line wraps to the start of the next line
previously(pre v3.0.0), pt subcommands create, resize, and delete, was not working.
crub can now create new partitions, resize and delete existing partitions. This opens up the possibility of multiple firmwares to exist and switch very quickly without reflashing.
pt create app1 app 1280 creates a 1280kb app partition allowing you to flash firmware on it within 1280kb size limit
launch -f app1 launches firmware from the app1 partition with fast -f flag
your imagination and 8MB is your limit with app combinations!
app partitions are placed on 64kb boundaries automatically and pt write refuses a table that would not boot
- ir blaster.
ir add,ir send,ir raw,ir del,ir list. nec, samsung and sony protocol, codes saved in/.crub/ir pt writeno longer needsyesconfig lssort name|date|nonesortsls. settings file at/.crub/configir add <name> file <path> <entry>copies the code out of a flipper .ir file
- multiple firmwares now supported!
- pt create/resize/delete fixed
- ctrl+c, history and cursor keys on the console, prompt shows the current directory
- custom boot screens. put a 240x135 at
/.crub/bootscreen.bmp - boot script now runs before console and USB init. the border no longer flashes before the boot screen
- background on the console feature
- crub partition grown from 704K to 768K. app0 moves to 0xD0000, re-fetch firmware after flashing the new table
- all crub config moved to a single
/.crub/directory to stop cluttering the SD root - added
crub fixcommand to migrate old config files and create missing defaults - moved fetch config and firmware name to SD since NVS was getting overwritten during flashing
- fetch is now customizable with
fetch fields,fetch logo, andfetch edit - boot screen is now a command,
boots <ms>, controlled from the boot script - added
waitsandwaitmsfor scripting - editor cursor now wraps to the next line at the end of a line
- THEME UPDATE
- added color command to change crub colors
- .crub_fw has been moved to NVS and can now be deleted.
- .crub_theme has been added to run color command on each line
- editor overhaul
- removed static hardcoded col and line limit
- switched to dynamic allocation
- added
bright <0-255>command for display brightness control - added
sdcommand to reinitialize SD card and reload aliases without rebooting - added
launch -fflag for instant launch with no delay
- added file utilities:
head,find,tree,wc,hex - added system commands:
uptime,free,i2cscan,md5,beep - added scripting:
run,echo,sleep,#comments - added
/.crub_bootboot script. runs on every boot if it exists on SD
- added basic calculator feature
- fixed an issue: aliases only having 16 entries as limit. now it is practically infinite
- added Cardputer v1.1 support. thanks u/First-Preference5831
- added fetch
- fixed an issue where larger binaries are unflashable. new functionality to view binary partition scheme
bininfo /path/to/binary.bin
- fixed an issue where having a LoRa Cap (or any Cap on that matter) interferes with reading the SD on boot
- updated UI
- added a nano-like text editor
- probably final update as no other features are planned
- 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?
- Public release
- GitHub repository created