Sleep Mode has been added - V2.3.0

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.