Releases: OpenNextion/opennextion-printsphere
Release list
OpenNextion-printsphere v0.2.1
OpenNextion-printsphere v0.2.1 Release Notes
v0.2.1 is a small bug-fix release for OpenNextion-printsphere.
The main fix is for the startup refresh issue where printer status data could
arrive after power-on or reboot, but the UI did not automatically repaint until
the user manually swiped or interacted with the screen.
Release Assets
Download the firmware image that matches your display model:
opennextion-printsphere-v0.2.1-onx3248g035-landscape.bin
opennextion-printsphere-v0.2.1-onx2432g028-landscape.bin
These are full initial flashing images. OTA images are not provided for this
release.
Expected file sizes and SHA256 values:
| Firmware file | Size | SHA256 |
|---|---|---|
opennextion-printsphere-v0.2.1-onx3248g035-landscape.bin |
3941984 bytes |
744537e211cc12c29923ab24d6e56254fa3b68eeb815794c12d2c77153da4fa1 |
opennextion-printsphere-v0.2.1-onx2432g028-landscape.bin |
3943696 bytes |
faeb8b0d80943cf51b99991ec9a776a3af2a99e8cf9c74973ddc0d014ff20835 |
What's Fixed
- Fixed initial UI snapshot replay after startup and cloud refresh.
- Fixed AMS page rendering after snapshot changes.
- Defaulted startup UI to the Main page to avoid an empty or stale initial page.
Together, these changes address the issue where the device could connect and
receive printer status after boot, but the displayed state stayed empty or stale
until manual screen interaction.
Supported Displays
v0.2.1 keeps the same public display targets as v0.2.0:
| Display model | Size | Resolution | Orientation |
|---|---|---|---|
| ONX3248G035 | 3.5 inch | 480 x 320 | Landscape |
| ONX2432G028 | 2.8 inch | 320 x 240 | Landscape |
The two public source build targets are selected with PRINTSPHERE_BOARD:
PRINTSPHERE_BOARD=onx3248g035
PRINTSPHERE_BOARD=onx2432g028
PRINTSPHERE_ONX_ORIENTATION=landscape
PRINTSPHERE_RELEASE_VERSION=v0.2.1
Validation Summary
- Clean release build passed for
PRINTSPHERE_BOARD=onx3248g035. - Clean release build passed for
PRINTSPHERE_BOARD=onx2432g028. - Firmware version plumbing was built as
v0.2.1for both targets.
Known Limitations
- Only landscape orientation is included for both public targets.
- Do not flash firmware built for one display model onto the other display
model. - OTA firmware is not provided in this release.
- Bambu Lab H2C hybrid / cloud mode camera remains unavailable in current
validation. - Bambu Lab P1S still needs local and hybrid validation.
- Other OpenNextion or Nextion screens require their own BSP, UI layout, build,
flash, and real-device validation before they can become public targets.
Flashing
Use the full initial flashing image for your display model and write it at
address 0x0:
python -m esptool --chip esp32s3 \
-p <SERIAL_PORT> \
-b 115200 \
--before default-reset \
--after hard-reset \
write-flash 0x0 <FIRMWARE_FILE>.binReplace <SERIAL_PORT> with your serial device and <FIRMWARE_FILE>.bin with
the asset matching your display model.
License
OpenNextion-printsphere is a non-commercial derivative of
PrintSphere. The repository and
release firmware are licensed under the Federation Non-Commercial License (FNCL) v1.1.
Use, copying, modification, and sharing are allowed for non-commercial purposes.
Commercial use requires separate written commercial permission from the original
copyright holder.
OpenNextion-printsphere v0.2.0
OpenNextion-printsphere v0.2.0 Release Notes
v0.2.0 is the second public release of OpenNextion-printsphere. It adds the
2.8 inch OpenNextion target while keeping the previously released 3.5 inch
target available.
Release Assets
Download the firmware image that matches your display model:
opennextion-printsphere-v0.2.0-onx3248g035-landscape.bin
opennextion-printsphere-v0.2.0-onx2432g028-landscape.bin
These are full initial flashing images. OTA images are not provided for this
release.
Expected file sizes and SHA256 values:
| Firmware file | Size | SHA256 |
|---|---|---|
opennextion-printsphere-v0.2.0-onx3248g035-landscape.bin |
3940672 bytes |
3d522614d9938fa4010d1128a83989f751d666afd1889247a3253403925e3701 |
opennextion-printsphere-v0.2.0-onx2432g028-landscape.bin |
3942368 bytes |
4a1c1d5fdef17c7209bf23d2edb1d93b5800b80e4f13e58945abf1bd15ec99e6 |
What's New
- Added public support for ONX2432G028
2.8 inch landscape. - Split the landscape UI into board-specific layout profiles:
- ONX3248G035: 480 x 320 landscape.
- ONX2432G028: 320 x 240 compact
landscape.
- Preserved and regression-validated
ONX3248G035 3.5 inch landscape
support. - Kept the CJK font subset for improved Chinese file name and UI text display.
Build Profiles
The two public source build targets are selected with PRINTSPHERE_BOARD:
PRINTSPHERE_BOARD=onx3248g035
PRINTSPHERE_BOARD=onx2432g028
PRINTSPHERE_ONX_ORIENTATION=landscape
PRINTSPHERE_RELEASE_VERSION=v0.2.0
Validation Summary
- Clean build passed for
PRINTSPHERE_BOARD=onx3248g035. - Clean build passed for
PRINTSPHERE_BOARD=onx2432g028. - ONX3248G035 landscape UI was kept
and validated on real hardware. - ONX2432G028 landscape UI was split
into its own layout profile and validated on real hardware. - A1 mini hybrid / cloud mode was tested with a CN region account.
Known Limitations
- Only landscape orientation is included for both public targets.
- Do not flash firmware built for one display model onto the other display
model. - OTA firmware is not provided in this release.
- Bambu Lab H2C hybrid / cloud mode camera remains unavailable in current
validation. - Bambu Lab P1S still needs local and hybrid validation.
- Other OpenNextion or Nextion screens require their own BSP, UI layout, build,
flash, and real-device validation before they can become public targets.
Flashing
Use the full initial flashing image for your display model and write it at
address 0x0:
python -m esptool --chip esp32s3 \
-p <SERIAL_PORT> \
-b 115200 \
--before default-reset \
--after hard-reset \
write-flash 0x0 <FIRMWARE_FILE>.binReplace <SERIAL_PORT> with your serial device and <FIRMWARE_FILE>.bin with
the asset matching your display model.
License
OpenNextion-printsphere is a non-commercial derivative of
PrintSphere. The repository and
release firmware are licensed under the Federation Non-Commercial License (FNCL) v1.1.
Use, copying, modification, and sharing are allowed for non-commercial purposes.
Commercial use requires separate written commercial permission from the original
copyright holder.
OpenNextion-printsphere v0.1.0
OpenNextion-printsphere v0.1.0 Release Notes
Summary
v0.1.0 is the first public release of OpenNextion-printsphere, a
non-commercial OpenNextion adaptation of PrintSphere for rectangular ESP32
display boards.
This release provides one full initial flashing image for the
ONX3248G035 3.5 inch display in
landscape orientation.
Firmware Asset
GitHub Release asset:
opennextion-printsphere-onx3248g035-landscape-full-v0.1.0.bin
SHA256:
130285c013db209ecd4b0e375c1346df36ea3d1fc0db9fb58b8812b764f11e18
MD5:
7b14550fea6b31431421e7d903041a1c
Size:
3811536 bytes
This is a full initial flashing image for writing the complete firmware image to
the device. OTA firmware is not provided in v0.1.0.
Supported Display
| Display | Orientation | Status |
|---|---|---|
| ONX3248G035 | Landscape | Included in v0.1.0 |
Portrait orientation and other display targets require a separate public build
profile and release validation. They are not v0.1.0 targets.
Highlights
- Added ONX3248G035 board support for
the OpenNextion ESP32 display. - Reworked the UI for a rectangular landscape display instead of the original
round-screen layout. - Added CN region Bambu Cloud endpoint handling for
api.bambulab.cn,
bambulab.cn, andcn.mqtt.bambulab.com. - Added
GlobalSign Root R3CA handling for selected CN region cloud HTTP,
preview image download, and related TLS paths. - Added the
onx_cjk_16LVGL CJK font subset generated from Source Han Sans SC,
with ASCII plus about 2,500 commonly used modern Chinese characters. - Improved Chinese file name and project title rendering on the device.
Validation Scope
Legend: Verified / Partially covered / Failed or unavailable / Not tested
| Printer | Mode | Connection / binding | Status data | AMS data | Cover image | Camera | Notes |
|---|---|---|---|---|---|---|---|
| Bambu Lab A1 mini | Local mode | Verified | Verified | Partially covered | Failed or unavailable | Verified | Current A1 mini test setup did not include AMS; cover page is unavailable in local mode |
| Bambu Lab A1 mini | Hybrid mode | Not tested | Not tested | Not tested | Not tested | Not tested | Needs separate validation |
| Bambu Lab H2C | Local mode | Not tested | Not tested | Not tested | Not tested | Not tested | Needs separate validation |
| Bambu Lab H2C | Hybrid / cloud mode | Verified | Verified | Verified | Verified | Failed or unavailable | Only tested with a CN region account |
| Bambu Lab P1S | Local mode | Not tested | Not tested | Not tested | Not tested | Not tested | Needs validation |
| Bambu Lab P1S | Hybrid mode | Not tested | Not tested | Not tested | Not tested | Not tested | Needs validation |
Known Limitations
v0.1.0only includes the
ONX3248G035 landscape full firmware
asset.- Portrait orientation and other display targets require a separate public build
profile and release validation; they are notv0.1.0targets. - Bambu Lab A1 mini local mode does not currently provide a cover page.
- Bambu Lab A1 mini AMS behavior has not been tested in an AMS-equipped setup.
- Bambu Lab H2C camera page is unavailable in the tested hybrid / cloud mode.
- Bambu Lab H2C testing only covered a CN region account.
- Bambu Lab P1S has not yet been validated.
- OTA update flow has not yet been validated, so OTA firmware is not included in
this release.
License Notice
OpenNextion-printsphere is a non-commercial derivative of
PrintSphere.
This project and the release firmware are provided under the
Federation Non-Commercial License (FNCL) v1.1. Use, copying, modification, and
sharing are allowed only for non-commercial purposes under the FNCL terms.
Commercial use requires separate written commercial permission from the original
copyright holder.
The repository includes a standalone LICENSE file containing the FNCL v1.1
text. Additional attribution, third-party component notices, and risk /
non-affiliation statements are provided in NOTICE.md and DISCLAIMER.md.