BambuHelper v3.3 - Release Notes
Firmware Builds
| Build Target | Board / Hardware | Display | OTA Update File | Full Flash File |
|---|---|---|---|---|
esp32s3
| ESP32-S3 Super Mini | ST7789 240x240 | BambuHelper-esp32s3-v3.3-ota.bin
| BambuHelper-esp32s3-v3.3-Full.bin
|
esp32s3_zero
| Waveshare ESP32-S3-Zero | external ST7789 240x240 | BambuHelper-esp32s3_zero-v3.3-ota.bin
| BambuHelper-esp32s3_zero-v3.3-Full.bin
|
cyd
| ESP32-2432S028 (CYD / Cheap Yellow Display) | ILI9341 240x320 | BambuHelper-cyd-v3.3-ota.bin
| BambuHelper-cyd-v3.3-Full.bin
|
ws_lcd_154
| Waveshare ESP32-S3-Touch-LCD-1.54 | ST7789 240x240 | BambuHelper-ws_lcd_154-v3.3-ota.bin
| BambuHelper-ws_lcd_154-v3.3-Full.bin
|
ws_lcd_200
| Waveshare ESP32-S3-Touch-LCD-2 | ST7789 240x320 | BambuHelper-ws_lcd_200-v3.3-ota.bin
| BambuHelper-ws_lcd_200-v3.3-Full.bin
|
jc3248w535
| Guition JC3248W535 (ESP32-S3-N16R8, 16MB flash / 8MB PSRAM) | AXS15231B QSPI 320x480 | BambuHelper-jc3248w535-v3.3-ota.bin
| BambuHelper-jc3248w535-v3.3-Full.bin
|
esp32c3
| ESP32-C3 Super Mini | ST7789 240x240 | BambuHelper-esp32c3-v3.3-ota.bin
| BambuHelper-esp32c3-v3.3-Full.bin
|
Guition JC3248W535 note: this is an initial beta build contributed by Niels (@theNailz). It adds the first supported firmware target for the 3.5 inch 320x480 AXS15231B QSPI board and should be treated as beta while board-specific polish continues.
OTA is for updating an already working device from the BambuHelper web UI.
Full is for first-time flashing, recovery, or ESP Web Flasher use.
First-time flashing? Easiest path is the hosted web flasher at keralots.github.io/BambuHelper - pick your board in the dropdown, click Install, and the browser handles bootloader + partitions + firmware in one go (no downloads, no flash offsets). The
-Full.binfiles below are only needed if you prefer the generic ESP Web Flasher or are flashing one of the community / beta boards that the hosted flasher doesn't list yet.
Changes
New Features
- Added Guition JC3248W535 support - initial beta - new
jc3248w535firmware target for the Guition 3.5 inch 320x480 IPS board with ESP32-S3-N16R8, 16MB flash, 8MB PSRAM, AXS15231B QSPI display, and integrated I2C touch. The build uses a new 320x480 layout, a 16MB dual-OTA partition table, and an Arduino_GFX-backed AXS15231B panel wrapper for LovyanGFX. Initial port contributed by Niels (@theNailz). - Added ESP32-S3-Zero 240x320 panel variant - new
esp32s3_zero_320DIY firmware target for the ESP32-S3-Zero wired to a larger 240x320 ST7789V panel module (e.g. GMT020-02-8P) instead of the standard 1.54" 240x240 display. Same pinout as the standardesp32s3_zerobuild, driven through the existing 240x320 layout. - Added X2D / H2C airduct fan support - BambuHelper now parses
device.airduct.parts[], tracks the right auxiliary fan and exhaust fan separately, and exposes new gauge slots forAux Fan Right (X2D)andExhaust Fan. The web UI only offers these gauges when a configured printer reports the matching capability. - Added the BambuHelper Companion Tool - Windows users get
tools/BambuHelper-CompanionTool.exe, while Mac/Linux users can runpython tools/bambu_diag.py. It can configure a BambuHelper device over the LAN, fetch Cloud printer details after login, and capture diagnosticpushalldumps for support.
Improvements
- Improved the JC3248W535 dashboard layout - the 320x480 screen now has a permanent AMS strip below the gauges, larger primary gauge values, and gauge arc thickness tuned for the bigger portrait display. The print screen also reclaims the bottom dead space: taller AMS bars, repositioned ETA, a new file-name line above the bottom bar, and a status bar pinned near the edge.
- Improved the simple clock screen - the clock is vertically centered, 12-hour mode shows AM/PM inline beside the time, and Display settings now include time size (
Auto,Normal,Medium,Large) plus an option to hide the date. - Improved smart printer rotation - Smart rotation now treats AMS drying as an active state alongside printing, so the display wakes and follows the drying printer instead of rotating past it as idle.
- Improved Tasmota auto power-off safety - auto-off is held while AMS drying is active, so a drying cycle cannot accidentally power down the printer after a completed print.
- Improved the finished-print energy display - the kWh row is centered as a group with the lightning icon, and cost is split to a second line where the screen layout has room.
- Changed Tasmota tariff to a global setting - the electricity rate is now one shared tariff for all plugs, with backwards-compatible import from older per-plug settings.
- Replaced older helper scripts -
tools/get_token.py,tools/mqtt_test.py, and the old MQTT test howto were replaced by the packaged Companion Tool and the new diagnostics guide.
Bug Fixes
- Fixed Smart rotation respecting manual button switch - tapping the button to peek at the idle slot while another printer was printing or drying used to be reverted on the next loop iteration. Smart mode now tracks a short manual-override window after every button cycle and suppresses both the snap-to-active and the global drying-wake during that window.
- Fixed automatic OTA on CYD - automatic web updates now avoid IDLE0 watchdog starvation during HTTPS downloads by running the OTA task on core 1 and temporarily pausing the core 0 watchdog during the transfer.
- Fixed AMS filament color handling - currently-feeding filament is shown correctly on single-nozzle printers, and printers that report tray
remain=0no longer lose their filament colors. - Fixed P2S door sensor reporting - P2S door state is now read from the MQTT
statbit used by that model, while X1-stylehome_flagparsing remains for printers that use it.
Documentation
- Updated DIY hardware documentation - the DIY wiring section was polished, optional LED / buzzer / touch-button accessories were documented, and the wiring image was refreshed.
- Clarified web flasher wording - the hosted flasher copy now describes browser-based flashing more accurately instead of calling it one-click.