Releases: 21cncstudio/project_aura
Releases · 21cncstudio/project_aura
Release list
Project Aura v1.1.5
Project Aura v1.1.5
Release date: 2026-05-28
Highlights
- Promoted the post-1.1.4 work into a stable 1.1.5 release.
- Added dedicated optional gas UI screens and charts for the DFRobot optional gas slot.
- Optional gas sensors are now visible in the main dashboard, device info flow, boot diagnostics, and chart views.
- Added custom display thresholds so users can tune warning levels for their own environment.
- Display thresholds are now applied consistently to status warnings, dashboard state, and chart/status presentation.
- Added MQTT TLS / SSL support with CA certificate configuration for TLS-enabled brokers.
- Added an SFA40 diagnostics page and JSON debug endpoint for easier troubleshooting of formaldehyde sensor setups.
Optional Gas UI and Dashboard
- Added optional gas info screens for NH3, SO2, NO2, H2S, and O3.
- Added optional gas chart support and tuned chart scaling / axis behavior for each gas type.
- Fixed optional gas tile navigation from the dashboard.
- Added optional gas state visibility during boot diagnostics.
- Exposed HCHO sensor state to the dashboard so SFA30/SFA40 status is clearer.
Custom Display Thresholds
- Added a
DisplayThresholdsmanager with persisted custom threshold settings. - Added web API support for reading, updating, and resetting threshold configuration.
- Added dashboard state output for active threshold values.
- Applied display thresholds to background/status warnings.
- Fixed threshold label synchronization and custom threshold behavior.
MQTT and Security
- Added MQTT TLS CA certificate support for brokers that require TLS certificate validation.
- Hardened MQTT TLS certificate handling.
- Updated the MQTT setup documentation with TLS broker guidance.
- Avoided exposing the MQTT password on the settings page after it has been saved.
SFA30 / SFA40 Improvements
- Added a dedicated SFA40 diagnostics page and
/api/debug/sfa40JSON endpoint. - Improved SFA40 debug reporting with active sensor path, local humidity/temperature state, and last measurement frame details.
- Quieted expected SFA30 absent-probe warnings.
- Kept HCHO warmup value labels stable and non-localized where needed.
UI and Stability
- Refined main UI indicator styling.
- Added missing Chinese glyph coverage.
- Refactored optional gas chart axis configuration and info graph overlays.
- Isolated build ID generation from release version metadata.
Notes
- This release is built from the current
mainbranch after the 1.1.5 beta cycle. - OTA update keeps user settings.
- WebUI localization is still English-only.
- Stable v1.1.5 OTA dashboard asset:
project_aura_1.1.5_ota_firmware.bin.
Internal note:
- Full installer binaries and manifests are generated for the private web installer workflow.
Beta test firmware
project_aura_1.1.6-beta-c61c357_ota_firmware.binis a beta OTA firmware build frommaincommitc61c357for MQTT stale-session recovery testing (#125) and optional DFR gas precision / SEN0472 O3 validation (#96).- Optional DFR gas readings remain in ppm; values below
1 ppmcan now show two decimal places, while values at or above1 ppmuse one decimal place. project_aura_1.1.6-beta-22de4e7_ota_firmware.binis a beta OTA firmware build frommaincommit22de4e7with SD card support for daily history storage, SD card dashboard status/actions, and CSV export.- Use beta files only if you want to test beta fixes; the stable v1.1.5 OTA file remains
project_aura_1.1.5_ota_firmware.bin.
Project Aura v1.1.4
Project Aura v1.1.4
Release date: 2026-05-02
Highlights
- Added a generic optional DFRobot electrochemical gas slot at I2C address
0x75. - Supported optional DFRobot modules now include
SEN0469 NH3,SEN0470 SO2,SEN0471 NO2,SEN0467 H2S, andSEN0472 O3. One optional gas module can be installed at a time. - Added a 180 degree screen flip setting for inverted mounting, including matching touch-coordinate handling.
- Improved RTC handling for new or unset RTC modules. Aura now reports an unset clock as a setup state instead of treating it like a hardware fault.
- Added the
Europe/Berlintimezone with DST support. - Improved SFA30/SFA40 startup and warm-restart behavior.
Sensor Improvements
- Refactored the DFRobot CO driver into a shared DFR multi-gas driver used by
SEN0466 COand the optional gas slot. - Added passive-mode setup, warmup/cooldown handling, present grace, limited absent retries, and safer recovery behavior for DFR gas sensors.
- Added gas-type validation so a module installed in the wrong slot is reported clearly instead of publishing misleading readings.
- Added per-sensor ppm ranges for optional gases: NH3, SO2, NO2, H2S, and O3.
- Added compatibility for DFRobot firmware variants that use different checksum lengths.
- Boot diagnostics now shows the actual HCHO sensor variant instead of a generic HCHO status.
- Reduced I2C pull-up strength and quieted expected SFA40 fallback probe noise.
MQTT and Home Assistant
- Added MQTT/Home Assistant discovery for optional gas values:
nh3,so2,no2,h2s, ando3. - Added generic optional-gas state/type data so integrations can see which optional module is currently detected.
- Kept existing
SEN0466 COpublishing behavior while moving it onto the shared DFR driver.
UI and Settings
- Added the
180screen flip control to the theme screen. - Fresh installs now correctly show the default
Industrial Ambertheme preset as selected. - RTC UI/status handling now distinguishes unset time from invalid RTC hardware state.
- Date/time handling now prefers named timezones while preserving compatibility with older timezone index configs.
Documentation and Tests
- Updated README hardware documentation for optional DFR gas sensor support.
- Added dedicated tests for the optional DFR gas driver.
- Added and expanded tests for SFA30, SFA40, SensorManager, MQTT payloads, RTC unset handling, and timezone migration.
- Updated the release metadata flow for stable semver versioning.
Notes
- For optional DFR gas modules, set the module I2C address to
0x75. - A new RTC can show as time unset until NTP sync or manual time setup initializes it. This is expected and no longer treated as a board fault.
- New feature work after this release should go into the next
1.1.5-betacycle. - WebUI localization is still English-only.
Release assets to publish
- OTA dashboard asset only:
project_aura_1.1.4_ota_firmware.bin
Internal note:
- Full installer binaries and manifests are generated for the private web installer workflow.
Project Aura v1.1.3
Project Aura v1.1.3
Release date: 2026-04-08
Highlights
- Added support for the DFRobot Gravity SFA40 HCHO sensor. Aura now auto-detects SFA30/SFA40 variants and handles SFA40 warmup/startup behavior.
- Added MSL pressure support. Station altitude can be set from the device UI, and pressure can now be displayed as sea-level corrected pressure for weather comparison.
- MSL pressure is also used by the WebUI dashboard/charts and by Home Assistant/MQTT when altitude is configured.
- Added a separate Home Assistant/MQTT
pressure_absoluteentity while keeping the existingpressureentity as the main pressure value. - Added
Australia/Brisbanetimezone with fixedAEST / UTC+10and no daylight saving time.
Improvements
- CO2 calibration now has a confirmation dialog and visible progress state.
- CO2 ASC changes now show progress and roll back UI/config state if live apply fails.
- 12-hour clock display no longer uses a leading zero, for example
3:00 PMinstead of03:00 PM. - Settings-related screens now show
BACKwhen there are no pending changes, andSAVE & BACKonly when changes need to be saved. - RTC mode selection now opens correctly from the Date / Time screen.
- Night-mode indicator colors and time layout were refined for better readability.
- README hardware links were refreshed and SFA40 support is now documented.
Fixes
- Fixed OTA UI restore target after a failed upload.
- Fixed a WebUI live-state banner runtime error.
- Increased the HTTP request-header limit for reverse-proxy setups.
- Added background Wi-Fi recovery retry after repeated STA connection failures.
- Fixed pressure delta and graph consistency so MSL values, deltas, charts, WebUI, MQTT, and Home Assistant stay aligned.
- Fixed SFA boot diagnostics so SFA40 warmup is shown as startup instead of a fault.
Notes
- If upgrading directly from a version older than
1.1.2, please re-check your timezone after updating. Timezone storage was migrated to timezone names in1.1.2, and1.1.3adds a new timezone entry. - WebUI localization is still English-only.
Release assets to publish
- OTA dashboard asset only:
project_aura_1.1.3_ota_firmware.bin
Internal note:
- Website installer files are hosted outside GitHub Release.
Project Aura v1.1.2
Project Aura v1.1.2
Release date: 2026-03-28
Highlights
- Web OTA update flow has been hardened significantly. Upload handling is more resilient, failure reporting is clearer, stale/incomplete attempts recover better, and the web UI now tracks OTA outcome more reliably.
- Added realtime AQI in the device UI, web state, MQTT payloads, and Home Assistant integration for a faster overall air-quality view.
- Home Assistant and MQTT integration were expanded with event mirroring, summary sensors, and improved discovery/control behavior.
- Added 12h / 24h clock display support, custom NTP server configuration, and more reliable timezone persistence.
- Diagnostics are easier to use: the log status chip opens the diagnostics page, alerts can be cleared from the screen without losing the underlying history, and diagnostics text is now localized.
- MQTT / Wi-Fi behavior was refined further, including less aggressive sensitivity to short network hiccups and cleaner dashboard wording in STA mode.
Notes
- OTA update keeps user settings.
- Web OTA is much improved, but on very noisy networks browser-upload OTA can still be sensitive to upload-path instability.
Release assets to publish
- OTA dashboard asset only:
project_aura_1.1.2_ota_firmware.bin
Internal note:
- Website installer files are hosted outside GitHub Release.
v1.1.1
Project Aura v1.1.1
Release date: 2026-03-16
Status
- This is the latest stable firmware before the public Project Aura release on MakerWorld.
- A lot has changed since
v1.1.0; the points below summarize the main user-facing and stability improvements.
Highlights
- Web delivery has been reworked with embedded versioned assets for the Dashboard, Fan Control page, and Theme page, plus multiple transfer hardening improvements for difficult Wi-Fi environments.
- MQTT and Wi-Fi recovery behavior was refined for congested 2.4 GHz networks, with safer reconnect timing and reduced connection pressure.
- RTC support was expanded with DS3231 and PCF8523 autodetection, shared-address fault handling, clearer status visibility, and a manual RTC override mode.
- Sensor and peripheral robustness was improved for SEN66, SFA30, BMP58x/BMP388/BMP390, optional CO sensing, and DAC availability/fault reporting.
- Fan Control received multiple updates including HCHO support in auto mode, restored armed-auto behavior after reboot, synchronized timer presets, improved QR and direct-link access, and better web/UI consistency.
- The UI and web diagnostics flow were improved with a live system log screen, clearer OTA/update states, localized overlays, and more polished AP/STA dashboard behavior.
- Stability work also reduced steady-state memory drift and muted noisy low-level LCD panel I2C logs.
Notes
- OTA update keeps user settings.
- Recommended GitHub release asset:
project_aura_1.1.1_ota_firmware.bin
Internal note:
- Website installer files are hosted outside GitHub Release.
v1.1.0
Project Aura v1.1.0
Release date: 2026-02-22
Highlights
- New integrated web dashboard at
/dashboardwith tabs for Sensors, Charts, Events, Settings, and System. - OTA firmware update from the web dashboard (
Settings/System -> Update Firmware) using uploaded.binfiles. - Device UI now switches to a dedicated firmware update page during OTA to avoid a "frozen" screen impression.
- OTA flow hardened with upload lifecycle handling (
begin/write/end/abort) and OTA slot size checks.
Notes
- OTA update keeps user settings.
- Full web installer flow still supports complete flashing (bootloader, partitions, app, filesystem).
Release assets to publish
- OTA dashboard asset only:
project_aura_1.1.0_ota_firmware.bin
Internal note:
- Website installer files are hosted outside GitHub Release.
Test 25.02.2026: verified dashboard + OTA update in STA and AP modes on device.
v1.0.9
Highlights
- Added SEN0466 CO sensor integration with PM4 fallback behavior and improved CO-related status handling.
- Added full DAC fan control subsystem (manual/auto modes, timers, auto-demand by sensor bands).
- Added DAC web control page (/dac) with live state, auto-config editing, and explicit START AUTO/STOP actions.
- Improved MQTT reliability (.local mDNS fallback/cache, stable host buffer handling) and UI diagnostics around LVGL stalls.
What's Changed
- Fix RTC "Lost" status after restart by clearing OS bit by @21cncstudio in #2
- Enable PCF8523 battery switch-over to prevent spurious OS bit by @21cncstudio in #3
- Feature/wifi screen unload by @21cncstudio in #4
- Refactor/UI controller modularization by @21cncstudio in #5
- Refactor/UI controller modularization by @21cncstudio in #7
- Refactor/UI controller modularization by @21cncstudio in #10
- Refactor/UI controller modularization by @21cncstudio in #11
- fix(web): remove misleading MQTT test-connection action by @21cncstudio in #12
- Refactor/UI controller modularization by @21cncstudio in #13
New Contributors
- @21cncstudio made their first contribution in #2
Full Changelog: v1.0.7...v1.0.9
v1.0.7 — Multi‑language UI + RTC warmup fixes
Highlights
- New UI languages: DE, ES, FR, IT, PT-BR, NL, ZH (Simplified).
- Added absolute humidity and pressure delta 24h.
- Improved dew point thresholds and stability.
- Added About overlay in settings.
- SEN66 warmup extended to 300s; RTC init now retries on boot.
- Home Assistant dashboard example included.
- README refreshed with demo video and real device photos.