fOS 2.0.0

fOS 2.0.0 is a touchscreen firmware for ESP32-S3 CrowPanel devices. This release introduces a fully SD-driven app workflow with dynamic launcher tiles, unloadable app content, and new built-in app types (calculator and radio).

What's New in 2.0.0

• New SD App Launcher architecture (up to 6 app tiles on AppL1 to AppL6).
• Apps are loaded from /apps and opened in a dedicated AppContent runtime area.
• App content can be unloaded via UnloadApp() to free runtime memory.
• New app type: calculator
  • Addition, subtraction, multiplication, division
  • Decimal comma support (,)
  • Division by zero shows Math Error
• New app type: radio
  • Local audio list from /music/files/
  • Webradio list from /music/webradio/webradio.txt (Sender|URL)
  • Start/Stop toggle button
• Storage Manager now supports directory navigation from filesystem root /:
  • Open folders via StorageManagerSelect()
  • .. entry for navigating to parent folder

Prerequisites

Hardware

• ESP32-S3 CrowPanel (default project config is CrowPanel_70)
• microSD card
• USB cable for flashing

Software

• Arduino IDE 2.x
• ESP32 board package: esp32 by Espressif Systems
• Arduino libraries:
  • lvgl
  • LovyanGFX
  • ESP32-audioI2S (provides Audio.h)

Notes

• Active panel type is set in LGFX_CrowPanel.h.
• Supported panel defines in this project:
  • CrowPanel_70
  • CrowPanel_50
  • CrowPanel_43
• SD chip-select is set to SD_CS = 10 in fOS2.0.ino.

Installation

1. Install Arduino IDE 2.x.
2. Install esp32 by Espressif Systems in Board Manager.
3. Install required libraries: lvgl, LovyanGFX, ESP32-audioI2S.
4. Open fOS2.0.ino in Arduino IDE.
5. Select your ESP32-S3 target board and serial port.
6. Verify panel define in LGFX_CrowPanel.h.
7. Build and upload firmware.
8. Prepare SD card as described below and insert it.
9. Reboot the device.

SD Card Setup

Required format

• Filesystem: FAT32
• Partition scheme: MBR (recommended)

Use a clean FAT32 card for first boot. Avoid exFAT and NTFS.

Folder and file layout

The firmware creates missing system folders automatically on startup.

• /apps
  • SD apps (max 6 loaded)
• /text
  • text files for file manager and text editor
• /music/files
  • local audio files (.mp3, .wav, .ogg, .aac, .m4a)
• /music/webradio/webradio.txt
  • one station per line in this format:

Sender Name|https://stream-url.example

Example:

SomaFM Groove Salad|http://ice1.somafm.com/groovesalad-128-mp3
ByteFM|https://stream.byte.fm/stream/bytefm_www

Optional system-managed files:

• /system/wifi/wlans.txt
  • Wi-Fi profiles as SSID|PASSWORD (one per line)
• /system/timezone/timezone.txt
  • saved timezone rule

SD App Format

Each app is a folder under /apps/<app_name>/ with at least app.cfg.

app.cfg keys

name=Display Name
icon=Optional short tile text/symbol
type=ui|text|button|calculator|radio
scrollable=true|false

Additional keys by type:

• type=ui
  • layout=layout.ui
• type=text
  • content=content.txt
• type=button
  • button_text=...
  • button_message=...

layout.ui (for type=ui)

One element per line, semicolon-separated fields.

type=label;x=40;y=40;w=720;h=40;text=Hello
type=button;x=40;y=100;w=240;h=70;text=Start;bg=0x2095F6;fg=0xFFFFFF
type=textarea;x=40;y=190;w=420;h=140;text=Line1\nLine2
type=switch;x=500;y=120;value=true
type=checkbox;x=500;y=180;text=Option;value=false
type=panel;x=20;y=20;w=760;h=430;bg=0xF2F2F2

Supported type= values in layout lines:

• label
• button
• textarea
• switch
• checkbox
• panel

Included Screens / Features

• Home
• Settings (Wi-Fi, timezone, system info)
• Storage Manager (folder navigation + delete file)
• Text Editor (open/create/overwrite-save)
• App Launcher (AppL1 to AppL6)
• App Content runtime area

Example Bundle

See example app/ for ready-to-copy examples:

• hello_fos
• button_demo
• ebook_demo
• ui_demo
• calculator_demo
• radio_demo

Webradio example list:

• example app/music/webradio/webradio.txt

Troubleshooting

• SD not detected:
  • Reformat SD to FAT32
  • Check card seating and wiring
  • Verify SD_CS in fOS2.0.ino
• SD apps not visible:
  • Ensure app folders are under /apps
  • Ensure each app has valid app.cfg
  • Max 6 apps are shown
• No local files in radio app:
  • Place audio files in /music/files
• No web stations in radio app:
  • Ensure /music/webradio/webradio.txt exists
  • Validate Sender|URL format