mirror of
https://github.com/Klipper4FlashForge/firmware.git
synced 2026-10-22 05:12:16 -05:00
Oleksandr Shyshatskyi
4415905fb3
Builds a modified FlashForge update package that the printer installs by itself from a USB stick, reusing FlashForge's own updater rather than a parallel one. Integration is a single file: /usr/prog/PROGRAM/software/firmwareExe is replaced with a shell script. Everything funnels through that binary, so app_startup.sh, rcS and the init chain stay completely stock. The genuine binary is kept as firmwareExe.stock and remains the default UI. Key findings from the stock firmware, each enforced by a test: - components named *.tar.xz are PLAIN tar; the installer runs bare `tar -xvf` - the .tgz is DES3-encrypted plain tar, not gzip - nothing in init starts Klipper -- firmwareExe runs start.sh, so replacing the UI without S70klipper leaves a printer that cannot move - the installer wipes the software dir before run.sh, so an uninstall package must ship the genuine firmwareExe rather than back one up - ssh already works: stock ships dropbear + an enabled S50dropbear, only the root password is missing Brick-safety is designed in, not bolted on: a five-rung profile ladder starting with a probe that changes nothing, a container-based simulation that actually runs the installer and asserts the printer would still boot, an uninstall round-trip test, and a SAFE-MODE latch for UI crash loops. 75 checks pass. Not yet run on hardware.
24 lines
791 B
Bash
24 lines
791 B
Bash
# STAGE 0 -- the first thing you should ever flash.
|
|
#
|
|
# Changes NOTHING on the printer. It reinstalls the stock software component
|
|
# byte-for-byte and adds one extra step: write a diagnostic report to the USB
|
|
# stick, then reboot.
|
|
#
|
|
# Purpose: prove the whole chain works on YOUR machine -- the filename glob,
|
|
# the DES3 key, the md5 gate, run.sh execution -- and learn the real partition
|
|
# sizes BEFORE you commit to a package that modifies anything.
|
|
#
|
|
# Pull the stick afterwards and read anvil-report.txt.
|
|
PROFILE_DESC="stage 0: no changes, writes a diagnostic report to the USB stick"
|
|
|
|
MOD_REPORT=1 # write the report
|
|
MOD_APPLY=0 # master switch: change nothing at all
|
|
|
|
MOD_KLIPPER=stock
|
|
MOD_TOOLCHANGE=0
|
|
MOD_MAINSAIL=0
|
|
MOD_HELIX=0
|
|
MOD_SSH=0
|
|
MOD_WEB=0
|
|
ROOT_PW_HASH=""
|