Releases: OpenCentauri/cc-fw-tools
Release list
v0.4.0
What's Changed
Rebase on upstream Elegoo 1.4.46 firmware, adding CANVAS support (#95)
- Rebase all OpenCentauri patches onto upstream 1.4.46 app binary
- Replace Entware bootstrap with Kipware bootstrap (https://github.com/OpenCentauri/pdscomp/releases)
- Add device-side flash, flash-artifact and switch-to-cosmos helpers
- New patches for 1.4.46:
- fix-noncanvas-load: resolve null-pointer crash on OG toolhead without FRS
- fix-singlecolor-filament-selection: respect user-selected color on single-color prints
- fix-end-print-hang: M117 workaround for screen freeze after print completion
- wait-for-chamber-temp: rebuilt trampoline to avoid code-cave collision
- disable-exhaust-fan: preserve manual fan control while disabling auto exhaust
Other Changes
- Add UART Serial Console Support for OpenCentauri (oc239) by @pdscomp in #67
- Reorganise patches by @suchmememanyskill in #87
- ci: fix release workflow tag_name, fix beta release name (builds off of main) by @pdscomp in #97
- fix: make set-firmware-version work on 1.4.46, relax brittle checks by @pdscomp in #98
- Config migration: update-printer-cfg.py preserves calibration across firmware updates
- CI: manual beta promotion workflow, push triggers restricted to main
Special thanks to all our beta testers in #patched-fw on the OpenCentauri Discord β and a shout-out to Savion, who bricked his printers one too many times helping us achieve our goals.
Full Changelog: v0.3.0...v0.4.0
Important Compatability Note!
- Firmware v0.3.0 is ONLY compatible with non-canvas (and older mainboard) CC1s, once you go CANVAS or if you happen to have the board with the new Wi-fi chip, you can only run OpenCentauri patched >= v0.4.0, or stock >=1.4.42
- If you are running a non-CANVAS CC1 and want to downgrade to v0.3.0 (certain things like manual filament changes still work better for the non-canvas path due to Elegoo-induced bugs in 1.4.4X), you can follow these instructions to downgrade (do not install v0.3.0 on a CANVAS printer or one with the new mainboard, it will get in a funky state!).
Downgrade to v0.3.0 from v0.4.0 (old motherboard, non-CANVAS only!!!):
- SSH to cc1 printer with root/OpenCentauri
- cd /user-resource
- wget https://github.com/OpenCentauri/cc-fw-tools/releases/download/v0.4.0/flash -O flash
- wget https://github.com/OpenCentauri/cc-fw-tools/releases/download/v0.3.0/update.swu -O update-v0.3.0.swu
- chmod +x flash
- ./flash ./update-v0.3.0.swu
- reboot
v0.0.0 - beta pre-release, do not install unless instructed
Latest beta build from run 30779518608 β commit a2d0b96
OpenCentauri Firmware Build
- Firmware version:
0.5.0-beta-a2d0b96-oc - Build complete time:
2026-08-03 02:32:35 UTC - Original firmware:
FW-CentauriCarbon-v1.4.49-2026-07-29.bin - Original SHA-256:
b38601e1224d6f73291550ab71c21b5e7995b78d1cd39baab5a6b453caa706cf - Final firmware:
update-2026-08-03-023235_0.5.0-beta-a2d0b96-oc.swu - Final SHA-256:
bd959973049ee30b24f078d067e9108450c4350c89348284008b3220f57beefb
Build metadata
- Build version:
oc-v0.5.0-integrate-a2d0b96 - Branch:
v0.5.0-integrate - Commit:
a2d0b968b5095160a87954857a5b64bc10c57797
Patches applied (TY Sims!)
| Order | Patch | ID | Source |
|---|---|---|---|
| 1 | Setup patching system | setup |
oc-patches/setup |
| 2 | Enable Entware setup, load new kernel modules and more | bootstrap_oc |
oc-patches/services/bootstrap-oc |
| 3 | Misc patches for the firmware | base |
oc-patches/firmware/misc-firmware-patch |
| 4 | Download tools from the OpenCentauri repository and install them in /bin | download_tools |
oc-patches/firmware/download-tools |
| 5 | Always allow adjusting z offset | always_allow_z_offset_adjust |
oc-patches/cc1-app/do-not-block-z-offset-adjust-patch |
| 6 | Fix API access during a print | api_during_printing |
oc-patches/cc1-app/allow-api-during-printing-patch |
| 7 | Allow use of TEMPERATURE_WAIT with SENSOR=box | wait_for_chamber_temp |
oc-patches/cc1-app/wait-for-chamber-temp |
| 8 | Adds both cumulative filament usage (per print) and filament requested per 250ms exports in PrintStats JSON | report_filament_usage |
oc-patches/cc1-app/report-filament-usage |
| 9 | Spoof firmware version reported to ElegooSlicer via SDCP attributes | spoof_slicer_firmware_version |
oc-patches/cc1-app/spoof-slicer-firmware-version |
| 10 | Block update checks | block_update_check |
oc-patches/cc1-app/block-update-check-patch |
| 11 | Set home position to front right | home_position_front_right |
oc-patches/cc1-app/home-position-front-right-patch |
| 12 | Misc patches for the CC1 app | misc_app |
oc-patches/cc1-app/misc-app-patch |
| 13 | Fix file uploads during a print | upload_during_printing |
oc-patches/cc1-app/allow-uploads-during-printing-patch |
| 14 | Block connectivity checks | block_connectivity_check |
oc-patches/cc1-app/block-connectivity-check-patch |
| 15 | Add gcode commands to control chamber light | add_chamber_light_gcode |
oc-patches/cc1-app/add-chamber-light-gcode-patch |
| 16 | Replace firmware version with OpenCentauri version | set_firmware_version |
oc-patches/cc1-app/set-firmware-version-patch |
| 17 | Fix exhaust fan automatically turning on during a print | disable_exhaust_fan |
oc-patches/cc1-app/disable-exhaust-fan-patch |
| 18 | Replace bootlogo | replace_bootlogo |
oc-patches/firmware/replace-bootlogo-patch |
| 19 | Install UART-enabled UBoot | uboot |
oc-patches/firmware/uboot-patch |
| 20 | Implement OTA updates for OpenCentauri firmware | ota_updates |
oc-patches/cc1-app/ota-updates-patch |
| 21 | Enable Uart | uart |
oc-patches/firmware/uart-patch |
| 22 | Finalise patches | finalise |
oc-patches/finalise |
v0.0.0 - beta pre-release from the 1.4.46 Canvas support branch
Updated beta 2026-06-20:
flash-artifact https://github.com/OpenCentauri/cc-fw-tools/actions/runs/27891546674/job/82535714940
Key changes:
- NTP sync is now more resilient (retries until network is ready)
- CI is cleaner: no automatic beta releases, manual promotion only
- Build triggers restricted: push only on main, PRs + manual on 1.4.46
- Kipware bootstrap bumped to 2026-06-20 (includes bash, unzip)
- Exhaust fan patch fixed for 1.4.46
Commits:
- d431812 β Update NTP sync code to retry every 5 seconds until successful, then wait a day to resync. This fixes time sync when WiFi/Ethernet take too long to come up.
- 7642f8b β CI workflow changes:
- Removed auto-beta-release from build.yaml (no longer uploads to 0.0.0 on every 1.4.46 push)
- Removed push trigger from 1.4.46; kept on main only
- Added new promote-beta.yaml manual workflow to promote any build run to beta release
- Updated Kipware bootstrap URL to 2026-06-20 with corrected SHA256
- 28079e1 β Fix: correct 1.4.46 exhaust fan patch
- 838f0c7 β Add driver-family comments to oc-startwifi.sh modprobe lines
- 0ceac50 β Fix disable-exhaust-fan 1.4.46 patch to match 1.1.40 logic
v0.3.0
Important Compatability Note!
Firmware v0.3.0 is ONLY compatible with non-canvas (and older mainboard) CC1s, once you go CANVAS or if you happen to have the board with the new Wi-fi chip, you can only run OpenCentauri patched >= v0.4.0, or stock >=1.4.42. Do not try and flash v0.3.0 or you will lock yourself out of the Elegoo UI and possibly break wifi, which we can help you recover from but it's not fun (join us in #software-support on the OC discord: https://discord.gg/ECJgHHt3t4)
v0.3.0 updates:
- New patch: Report filament usage via API (by @harpua555 in #40) (Fix #36)
- New patch: OTA Updates (by @suchmememanyskill)
- New patch: Allow uploads during printing (by @suchmememanyskill)
- New patch: Fix
TEMPERATURE_WAIT SENSOR=box(by @harpua555 in #32) (Fix #16) - Edit base patch: Disable boot delay & delegate hostname blocks to a background task (by @suchmememanyskill) (Fix #17)
- Edit base patch: Left align OpenCentauri logo in the webui (by @tvon in #21)
- Edit base patch: Fix corner radius (white pixels) in edges of the screen (by @parkerlreed in #38)
- Edit base patch: Prevent boot of Elegoo Klipper (/app/app) by creating a file at /app/noapp.kill (by @harpua555 in #41)
- Edit base patch: Fix SSL errors (by @SoffiMeower in #42)
- Edit base patch: Support Realtek/ASIX USB Ethernet adapters (By @pdscomp in #54)
- Edit replace bootlogo: Validate size of bootlogo before applying it (by @suchmememanyskill)
Read the docs for install instructions
Release is based off the 1.1.40 firmware image from Elegoo.
v0.2.0 - Minor fixes and improvements
- Edit base patch: Set new boot logo on webui (and remove store from webui)
- Edit base patch: Create uninstall script
- Edit base patch: New version scheme
- Edit connectivity check patch: Patch application to never send out dns requests for connectivity checks (#12)
- Edit replace bootlogos: New bootlogo
gradient - New patch: Allow editing Z offset while printer is idle
Release is based off the 1.1.40 firmware image from Elegoo.
v0.1.0 - New patching system
- Fix OC-firmware for 1.1.40
- Added new patching system (can plan patches around before/after other patches + can constrain to a version).
- New patch: Replace bootlogo, both from the patching system and while running the system (currently has 5 bootlogos available)
- New patch: Set homing position to front right (1.1.40 specific)
- New patch: Disable automatically re-enabling the exhaust fan based on filament type (1.1.40 specific)
- New patch: Block Elegoo updates
- New patch: Block connectivity checks
- New patch: Allow API access during printing (1.1.40 specific)
- New patch: Add chamber light gcode commands (1.1.40 specific)
Release is based off the 1.1.40 firmware image from Elegoo.
Full Changelog: v0.0.4...v0.1.0
SHA256: 668F0E45799BBC9AA88C0B346B1748EF41D05D9ECE4356817E21D4EEE0C79BC0
MD5: C7DC6F1F6EF1EB3B20FD26FDA34175D9
v0.0.4 - Initial Release
[0.0.4] - 2025-08-24
GitHub Release: v0.0.4
- Updated OpenCentauri firmware build and deploy process with a few additions:
- Enable uboot console output on serial UART (3.3v)
- Enable rootshell on serial UART (press enter after boot-up
- Change SWU process from
./install.shto just use/mnt/UDISK(so no real USB stick involved anymore)