fOS v2.3.0 Release Notes

Release date: 2026年06月05日

Highlights

fOS 2.3.0 adds a hardware display/sleep button workflow for CrowPanel ESP32-S3 devices:

• short press on GPIO38 turns display output and backlight off
• short press while off turns the display back on
• 1,5-second long press forces ESP32-S3 Light Sleep
• update installs and music playback are protected from interruption

Added

• Hardware display/sleep button on GPIO38:
  • configured as input with pull-up
  • intended wiring: momentary button between GPIO38 and GND
  • short press toggles display/backlight state
• Display-off idle mode:
  • LVGL display flushing is skipped while the display is off
  • normal background work is reduced while no uninterruptible process is active
  • music playback and OTA/update work remain active when needed
• Long-press Light Sleep override:
  • holding the button for 1,5 seconds opts into Light Sleep
  • Light Sleep starts after the button is released to avoid immediate wakeup
  • forced sleep is blocked while OTA/update or radio/music playback is active
• Serial diagnostics:
  • reset reason and sleep wake cause at boot
  • GPIO38 level changes while running
  • display on/off and sleep transition messages

Changed

• Sleep behavior is now split into two modes:
  • short press uses the stable display-off idle mode
  • long press explicitly attempts real ESP32-S3 Light Sleep
• Deep Sleep is no longer used for the button workflow because wakeup from Deep Sleep restarts the firmware and returns to the boot process.
• The sleep button handler now learns the button edge from the observed pin transition, making it more tolerant of different button wiring states.

Fixed

• Avoided accidental boot-process restarts for normal short-press display-off usage.
• Prevented sleep entry while OTA/update or music playback is active.
• Prevented immediate wakeups by waiting for button release before entering Light Sleep.

Compatibility Notes

• Existing SD app format remains supported:
  • type=ui|text|button|calculator|radio|clock|weather
• OTA + Recovery from 2.2.0 remains included:
  • app0/app1 partition model
  • update staging in /system/update/update.bin
  • recovery staging in /system/update/recovery.bin
• Display brightness persistence remains stored in /system/display/brightness.txt.
• SD card format recommendation remains FAT32 (MBR preferred).

Known Limitations

• GPIO38 can be electrically sensitive on some ESP32-S3/CrowPanel boards.
• Long-press Light Sleep may still cause a board-level reset on unstable wiring or sensitive hardware revisions.
• For the most stable real Light Sleep wakeup behavior, use a safer dedicated GPIO for the button instead of GPIO38.
• Internet-dependent features (OTA listing/download, weather, web radio) still depend on network quality and remote endpoint availability.

fOS v2.2.0 Release Notes

Release date: 2026年05月24日

Highlights

fOS 2.2.0 introduces a full SD-staged OTA and dedicated recovery architecture:

• main system in app0
• minimal recovery system in app1
• update staging in /system/update/
• automatic boot fallback logic for failed update boots

Added

• Full OTA + recovery pipeline for CrowPanel ESP32-S3:
  • OTA list fetch from GitHub
  • selected OTA image download to /system/update/update.bin
  • recovery image download to /system/update/recovery.bin
  • flash recovery into app1
  • set boot partition to app1 and reboot
• Recovery runtime:
  • validates staged update image
  • flashes staged update to app0
  • switches boot partition back to app0
  • restarts device
• Boot protection and self-healing state:
  • pending_update
  • boot_attempt_counter
  • automatic fallback to recovery after repeated failed boots
• Display settings persistence:
  • brightness saved via display settings page
  • minimum brightness clamped to 5%
  • value stored in /system/display/brightness.txt
  • value restored at boot
• System update folder management:
  • auto-create /system/update during SD initialization

Changed

• OTA file lookup is now asynchronous:
  • moved from blocking UI path into a background FreeRTOS task
  • update screen remains responsive while OTA file list is loading
• OTA/Recovery staging paths moved from root SD to:
  • /system/update/update.bin
  • /system/update/recovery.bin
• Update install flow now keeps stronger error traces in serial logs ([OTA] ERROR: ...) for every failing step.

Fixed

• Fixed UI freeze during OTA file search after Wi-Fi connection.
• Improved OTA listing/download robustness with retries, longer timeouts, and recovery RAW fallback names when GitHub API listing fails.

Compatibility Notes

• Existing SD app format remains supported:
  • type=ui|text|button|calculator|radio|clock|weather
• This release uses the dedicated app0/app1 partition model (see partitions.csv).
• SD card format recommendation remains FAT32 (MBR preferred).

Known Limitations

• Recovery uses a minimal display output path and can still show visible RGB artifacts on some panels while flash operations are running.
• Internet-dependent features (OTA listing/download, weather, web radio) still depend on network quality and remote endpoint availability.

fOS v2.2.0 Release Notes

Release date: 2026年05月24日

Highlights

fOS 2.2.0 introduces a full SD-staged OTA and dedicated recovery architecture:

• main system in app0
• minimal recovery system in app1
• update staging in /system/update/
• automatic boot fallback logic for failed update boots

Added

• Full OTA + recovery pipeline for CrowPanel ESP32-S3:
  • OTA list fetch from GitHub
  • selected OTA image download to /system/update/update.bin
  • recovery image download to /system/update/recovery.bin
  • flash recovery into app1
  • set boot partition to app1 and reboot
• Recovery runtime:
  • validates staged update image
  • flashes staged update to app0
  • switches boot partition back to app0
  • restarts device
• Boot protection and self-healing state:
  • pending_update
  • boot_attempt_counter
  • automatic fallback to recovery after repeated failed boots
• Display settings persistence:
  • brightness saved via display settings page
  • minimum brightness clamped to 5%
  • value stored in /system/display/brightness.txt
  • value restored at boot
• System update folder management:
  • auto-create /system/update during SD initialization

Changed

• OTA file lookup is now asynchronous:
  • moved from blocking UI path into a background FreeRTOS task
  • update screen remains responsive while OTA file list is loading
• OTA/Recovery staging paths moved from root SD to:
  • /system/update/update.bin
  • /system/update/recovery.bin
• Update install flow now keeps stronger error traces in serial logs ([OTA] ERROR: ...) for every failing step.

Fixed

• Fixed UI freeze during OTA file search after Wi-Fi connection.
• Improved OTA listing/download robustness with retries, longer timeouts, and recovery RAW fallback names when GitHub API listing fails.

Compatibility Notes

• Existing SD app format remains supported:
  • type=ui|text|button|calculator|radio|clock|weather
• This release uses the dedicated app0/app1 partition model (see partitions.csv).
• SD card format recommendation remains FAT32 (MBR preferred).

Known Limitations

• Recovery uses a minimal display output path and can still show visible RGB artifacts on some panels while flash operations are running.
• Internet-dependent features (OTA listing/download, weather, web radio) still depend on network quality and remote endpoint availability.

fOS v2.1.0 Release Notes

Release date: 2026年05月17日

Highlights

fOS 2.1.0 extends the SD app runtime with new app types and major runtime decoupling:

• new clock and weather SD app types in AppContent
• SD text editor app no longer depends on legacy ui_ScreenText runtime
• upgraded radio, clock, and weather app UX in the shared app runtime

Added

• New app type: clock
  • Current Time and Stopwatch tabs
  • calendar view with current day highlight
  • current month opened by default
  • stopwatch controls (Reset, Start/Pause)
• New app type: weather
  • weather UI rendered in AppContent
  • IP-based location detection
  • current temperature and humidity
  • current weather phenomenon and detected location
  • 7-day weather forecast in roller
• New weather data pipeline:
  • geolocation via ip-api.com
  • weather data via open-meteo.com
• New SD example app entries:
  • clock_demo
  • weather_demo
  • text (AppContent-based text editor app)

Changed

• type=text app in folder /apps/text now opens as the full editor UI inside AppContent (independent runtime path).
• Radio runtime UI redesigned to match the new visual system:
  • tabs: File Player and Web Radio
  • centered play/pause control (> / ||)
  • updated dark panel/roller styling
• Clock runtime behavior updates:
  • stopwatch does not auto-start on app open
  • auto-sync to current calendar month once system time becomes valid
• UnloadApp() now also clears clock/weather runtime state.

Fixed

• Clock app startup stability improved (reduced object pressure and guarded UI creation paths).
• Weather app data-fetch reliability improved by replacing unstable provider path that returned server/client errors in field testing.

SD App Metadata (Current)

Supported app.cfg keys in 2.1.0:

• name
• icon
• type=ui|text|button|calculator|radio|clock|weather
• scrollable
• layout (for type=ui)
• content (for type=text)
• button_text, button_message (for type=button)

Compatibility Notes

• Existing SD app formats remain supported.
• For web radio, station lines must be Sender|URL in /music/webradio/webradio.txt.
• Weather app requires active internet connectivity for ip-api.com and api.open-meteo.com.
• Recommended Arduino board options:
  • Partition Scheme: Huge APP
  • PSRAM: OPI PSRAM
• Recommended SD format remains FAT32 (MBR preferred).

Known Limitations

• App launcher renders up to 6 app directories from /apps (first 6 discovered).
• Internet-dependent apps (radio streams, weather) depend on network quality and endpoint availability.

fOS v2.0.0 Release Notes

Release date: 2026年05月08日

Highlights

fOS 2.0.0 is a major app-system upgrade:

• dynamic SD apps on 6 launcher tiles
• unloadable app runtime to reduce memory pressure
• new built-in app types: calculator and radio
• root-based storage navigation with parent-folder support

Added

• SD App Launcher capacity increased to 6 apps (AppL1 to AppL6).
• New app type: calculator
  • +, -, *, /
  • decimal comma input
  • Math Error on division by zero
• New app type: radio
  • local file playback from /music/files/
  • web radio playback from /music/webradio/webradio.txt
  • Start/Stop toggle button
• New filesystem navigation flow in Storage Manager:
  • starts at /
  • folder enter via StorageManagerSelect()
  • .. to go to parent folder
• New and updated example app package entries:
  • hello_fos
  • button_demo
  • ebook_demo
  • ui_demo
  • calculator_demo
  • radio_demo

Changed

• App content now runs as a dedicated runtime scene in uic_AppContentArea.
• UnloadApp() now actively clears app runtime objects and reloads launcher state.
• SD app default type is now ui (with layout.ui support).
• Launcher tiles now support optional icon= metadata in app.cfg.
• SD init now ensures /music/webradio exists.

Removed / Reworked

• Legacy fixed UI handlers tied to old calculator/weather/radio screens were removed or replaced by app-runtime implementations.
• App rendering is now centered around SD app metadata and app type dispatch.

SD App Metadata (Current)

Supported app.cfg keys in 2.0.0:

• name
• icon
• type=ui|text|button|calculator|radio
• scrollable
• layout (for type=ui)
• content (for type=text)
• button_text, button_message (for type=button)

Compatibility Notes

• Existing type=text and type=button SD apps remain supported.
• For web radio, station lines must be Sender|URL in /music/webradio/webradio.txt.
• Recommended SD format remains FAT32 (MBR preferred).

Known Limitations

• App launcher renders up to 6 app directories from /apps (first 6 discovered).
• Stream reliability depends on station format/codec and network quality.
• No in-app persisted calculator history in this release.

fOS v1.5.0 Release Notes

Release date: 2026年05月02日

Highlights

fOS 1.5.0 introduces an SD-based App Launcher workflow with dedicated app content rendering, plus stability work for long-running UI usage.

Added

• SD App Launcher support via /apps (max 4 apps loaded).
• AppContent screen workflow for opening selected SD apps.
• Configurable SD app metadata via app.cfg:
  • name
  • type=text|button
  • content (text app)
  • button_text, button_message (button app)
• Example app bundle in example app/:
  • create_example_app.sh
  • hello_fos
  • button_demo
  • ebook_demo

Changed

• App Launcher now refreshes app entries only when StartAppLauncher() is opened.
• Launcher tiles now show app names (icon-less SD app list style).
• App content text rendering switched to static buffer usage to reduce dynamic heap churn.
• Wi-Fi reconnect changed to a persistent worker-task model (notify-driven) instead of repeated task create/delete.

Fixed

• Multiple SD directory-iteration paths now explicitly close file handles.
• AppContent view stability improved for repeated enter/exit cycles.
• Additional heap instrumentation added for debugging (free, min, largest).

SD Card Requirements

• Required format: FAT32 (MBR recommended)
• Avoid: exFAT, NTFS

Known Limitation

• Device stability can decrease as more SD apps are loaded and used over time.
• In practice: the more apps are loaded, opened, and switched repeatedly, the higher the chance of freezes on this hardware/runtime setup.

fOS v1.4.0 Release Notes

Release date: 2026年05月01日

Highlights

fOS 1.4.0 introduces a significantly improved calculator engine with better expression handling, precision, and UX.

Added

• New evaluate_expression(const char * expr) parser in fOS1.0.ino.
• Support for multi-operator expressions with correct precedence (* and / before + and -).
• Full decimal-number support in calculator expressions.

Changed

• Calculator logic moved out of ui_events.c/.h into fOS1.0.ino data handlers.
• ui_events.c now keeps only event forwarding for calculator actions.
• Calculator keyboard handling improved for ✓, ⌫, <, and > behavior.

Fixed

• Division by zero now returns a clear calculator output: Math Error.
• Calculator textarea now shows a cursor immediately by auto-focusing the input field.

SD Card Requirements

• Required format: FAT32 (MBR recommended)
• Avoid: exFAT, NTFS

fOS v1.3.1 Release Notes

Release date: 2026年04月26日

Highlights

fOS 1.3.1 improves weather forecasting and fixes a Wi-Fi stability issue.

Changed

• Weather forecast extended from 5 days to 7 days.
• Improved behavior when no Wi-Fi networks are found.

Fixed

• Fixed an issue where the device could freeze when no Wi-Fi network was found.

SD Card Requirements

• Required format: FAT32 (MBR recommended)
• Avoid: exFAT, NTFS

fOS v1.3.0 Release Notes

Release date: 2026年04月26日

Highlights

fOS 1.3.0 focuses on turning the UI into a complete daily-use firmware with improved connectivity, weather integration, better media support, and stronger SD-based persistence.

Added

• Weather app with:
  • Automatic location detection (IP geolocation)
  • Current temperature + humidity display
  • Multi-day forecast roller
• Weather requests now support HTTPS with HTTP fallback handling.

Improvements

• Better runtime UI state handling for unavailable data (SD, Wi-Fi, weather).
• More robust startup sequence with staged initialization feedback.

SD Card Requirements

• Ensure your SD card follows the new/expected folder layout.
• Required format: FAT32 (MBR recommended)
• Unsupported/recommended to avoid: exFAT, NTFS

• A stopwatch has been added.