fOS is a touch interface for the 7-inch CrowPanel with ESP32-S3 and the 7-inch Waveshare with ESP32-P4. It combines built-in applications, SD card management and installable fScript apps with Wi-Fi, audio and firmware updates.
The following features are included in both the CrowPanel and Waveshare projects.
4.1.1: App downloads and installations now run in a separate FreeRTOS
worker instead of blocking the LVGL UI. See release notes.
The precompiled binaries in firmware/ are inherited from the earlier package
and do not contain these 4.1.1 fixes. Build and export a new binary for
each board before performing OTA; do not publish the inherited binaries as
4.1.1.
2026-11-11 follow-up: Waveshare app deletion is now also handled by the
AppStore worker to prevent loopTask stack overflows. CrowPanel failed HTTPS
connections now report Wi-Fi and TLS-heap diagnostics. See the release notes
for what is and is not verified on hardware.
| Area | Features | Detailed documentation |
|---|---|---|
| Interface and launcher | Touch controls, on-screen keyboards, home screen and launching installed apps | Apps, Keyboards |
| Settings | Theme selection, saved display brightness, time zone and system information | Configuration |
| Wi-Fi | Network scanning, multiple saved network profiles, enable/disable control and automatic reconnection | Configuration |
| Clock and calendar | Date and time with NTP synchronization over Wi-Fi, time zone selection, monthly calendar, stopwatch and countdown timer | Configuration |
| Storage management | FAT32 microSD, folder navigation and deletion with confirmation; shared directories for apps and user files | SD card |
| Text editor | Open, edit and save text files; file selection and subfolders within /text |
Text app |
| Calculator and drawing | Calculator and a fScript drawing app with a touch canvas | Apps |
| Weather | Location search and weather forecasts with an internet connection | Weather app |
| Music and web radio | Local music with folder navigation, internet radio stations, play/stop, volume and seeking in local files | Radio and audio |
| IMAP or POP3 reception, SMTP sending over direct TLS, separate inbox/outgoing lists and a local message cache | Email setup | |
| App Store | Install, update and uninstall apps; select compatible versions. App updates preserve existing appdata folders |
App data and updates, Store files |
| Firmware updates | OTA updates staged on the SD card with a separate recovery application; dedicated firmware paths for each board | Firmware and recovery |
| fScript apps | Compiled app logic in the VM, UI events, timers, HTTP/JSON, file and audio access controlled by app permissions | English manual, German manual |
| Relative app layouts | The same layout.ui files adapt to 800×480 and 1024×600, including nested dialogs, keyboards and canvases |
UI layouts |
| Credentials and app permissions | Device-bound encryption of Wi-Fi/email passwords, separate read/write permissions per app and a protected /system directory |
Credentials, App permissions |
Text editing, the calculator, drawing and local music do not require Wi-Fi. Weather, web radio, mail transfers, the online App Store and online updates require an appropriate network connection. The clock first needs a valid system time; Waveshare-specific RTC restoration is described below.
The radio and text applications are also supplied as fScript apps. Native
demo entries such as radio_demo remain available. You can compile your own
apps with fosc and test them on a computer with fosrun, including
previews for both display sizes: fosc and fosrun.
“Waveshare only” refers to the implementation in this project. It does not describe every feature that could be developed for other hardware.
| Feature | CrowPanel ESP32-S3 | Waveshare ESP32-P4 | Details |
|---|---|---|---|
| SD card exposed to a computer as a USB drive | Not implemented in the included sketch | Waveshare only: Set USBStorageSwitch in Connections and apply it with Save connections. Local SD access pauses while the computer owns the card | USB storage |
| RTC/VBAT time restoration before Wi-Fi starts | No equivalent battery-backed RTC path integrated | Waveshare only: Capture a time anchor after NTP synchronization and restore time at startup using the live RTC counter | RTC and battery operation |
| Prepared battery backup sleep | Not implemented | Waveshare only: Hold BOOT/GPIO0 for three seconds and release to enter controlled VBAT deep sleep | RTC procedure |
| Extended 32 MB partition layout | Uses its own CrowPanel partition table | Waveshare only: 25 MiB main application, 1 MiB recovery and a reserved 5.9375 MiB SPIFFS data partition | Partitions |
P4 RTC/VBAT support is implemented; battery retention and wake-up still need verification on the physical board. Arbitrary power loss during operation has not been confirmed to preserve time. Follow the procedure in RTC.md. The SPIFFS partition is reserved and is not yet mounted automatically as additional file storage; fOS files continue to use the SD card.
Display button on both boards: A short press turns the display off or back on; a long press requests light sleep when running tasks allow it. The button uses GPIO38 on CrowPanel and GPIO52 on Waveshare. Sleep and wake-up behavior depends on the board; see the board guides. P4 battery backup sleep through BOOT is a separate function.
| Board | Main sketch | Recovery sketch | ESP32 core | LVGL |
|---|---|---|---|---|
| CrowPanel, 800×480 | fOS4.0/fOS4.0.ino |
recovery/recovery.ino |
3.3.12 | 8.3.11 |
| Waveshare, 1024×600 | fOS_Waveshare_P4/fOS_Waveshare_P4.ino |
recovery_p4/recovery_p4.ino |
3.3.12 | 9.2.2, bundled with the sketch |
Sketch folders retain their existing names to preserve build paths. Both main sketches already support the shared relative app layouts. Board settings, connections and flashing instructions are documented in the CrowPanel and Waveshare guides.
| Folder | Contents |
|---|---|
apps |
Shared apps to copy into /apps on the SD card |
firmware |
Earlier-version prebuilt images (not 4.1.1); CrowPanel images are in the CrowPanel subfolder |
fScript_Development_Environment/fosc |
Shared fosc/fosrun source code, examples and tests |
github_repository_files |
Prepared App Store and OTA files for both boards |
tools |
Index generator and required tests |
docs |
Central guides, manuals and current release notes |
- Installing and using apps
- SD card and Wi-Fi/email configuration
- Firmware and recovery
- fosc and fosrun
- Build and verification records
- All documentation
Preserve your own appdata folders when updating apps. Device-bound Wi-Fi
and email credentials must be entered again when moving to a different board.
See docs/CROWPANEL_APPSTORE_HTTPS_411.md for the PSRAM catalog-cache optimization, error diagnostics and retest procedure. These source changes require a new CrowPanel build; bundled old binaries were not rebuilt.