BambuHelper v2.9 - Release Notes

Firmware Builds

CYD display note: v2.9 changes the display library from TFT_eSPI to LovyanGFX. Some CYD panel revisions may boot with inverted colors, a white background, mirrored/rotated image, or other display artifacts. If that happens, open the BambuHelper web UI, go to Display, and enable Invert display colors (fix white background) and/or Use Classic CYD panel fallback (older units only - device will reboot).

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.

Changes

• Migrated display library from TFT_eSPI to LovyanGFX - the underlying display driver has been replaced with LovyanGFX across all build targets. This migration improves arc drawing quality and lays the groundwork for future display improvements.
• Added Waveshare display builds - ws_lcd_200 and ws_lcd_154 are now available as first-class firmware targets.
• Added optional external LED support - an external PWM-dimmed LED can now be enabled from Hardware settings with GPIO selection, brightness control, and live preview. Pin validation prevents conflicts with display, touch, backlight, buzzer, button, flash, and USB pins; CYD defaults to GPIO 22 on the P3 connector.
• Improved CYD compatibility - CYD devices now support runtime selection between the corrected V2 panel driver and a Classic fallback panel driver. This fixes mirrored/rotated output and the extra garbage band seen on some 240x320 CYD units.
• Improved gauge rendering - smooth gauge arcs were refined to reduce visual artifacts without bringing back redraw flicker.
• Refreshed AMS layout in 240x320 portrait mode - 1-2 AMS units now use the enhanced portrait AMS view by default, with wider rounded tray bars, filament type labels, and clearer AMS captions. 3+ AMS units continue to use the compact strip layout where labels would not fit.
• Reworked 240x320 landscape mode - landscape screens now use the full active 320x240 canvas instead of behaving like a 240x240 dashboard with an AMS column attached.
• Fixed landscape progress/header/bottom layout - splash, setup, WiFi, OTA, MQTT, clock, progress bar, ETA, and bottom status areas now align to the real landscape screen size.
• Improved landscape AMS view - the right-side AMS area now uses the same rounded tray styling as the portrait AMS refresh, with the print state badge placed above the AMS column.
• Fixed landscape AMS column redraws - the 240x320 landscape AMS side panel is no longer wiped by header or bottom-bar refreshes, and partial MQTT AMS updates no longer collapse the side column to zero units.
• Adjusted 4-AMS landscape spacing - the landscape AMS side panel now uses tighter top and label spacing so four connected AMS units fit cleanly under the header badge.
• Fixed print-complete landscape clipping - the finished screen has dedicated landscape positions for gauges and text, and the kWh row no longer overlaps the file name. Fixes GitHub issue #72.
• Improved file-name fitting on the finished screen - long file names are now truncated by measured pixel width instead of a fixed character count.
• Improved AMS drying screen - drying temperature, remaining time, humidity, ETA, and progress now redraw independently to reduce flicker in both portrait and landscape mode.
• Fixed Celsius symbol rendering on the drying screen - the degree mark is now drawn manually instead of relying on a font glyph that could render as a rectangle.
• Wake display when AMS drying starts - if the screen is in clock/screensaver or off mode, starting AMS drying now wakes the display and opens the drying screen automatically.
• Fixed X1C/X1E door detection - X1-series chamber door status now uses home_flag bit 23 instead of the H2-specific stat path. Fixes GitHub issue #67.
• Fixed Keep Print Screen setting persistence - applying display settings no longer resets the Keep print status screen after completion option.
• Corrected ESP32-C3 panel configuration - the ESP32-C3 ST7789 display configuration now matches the documented 240x240 panel size.