ESP32-P4 OLED

ESP32-P4 SB Player

An FSEQ sequence player for the ESP32-P4 that drives holiday and animated light displays. Reads .fseq v2 files from an SD card and streams channel data out over E1.31 (sACN) and/or DDP to LED controllers, with synchronized audio playback and a time-based scheduler.

Features

• FSEQ v2 playback — reads uncompressed sequences from SD card, frame-accurate timing via FreeRTOS tasks
• E1.31 (sACN) output — up to 8 outputs, unicast or multicast, configurable universe/channel mapping
• DDP output — up to 8 outputs with per-output channel mapping
• Audio playback — WAV and MP3 via I2S DAC (PCM5102A / UDA1334A), auto-matched from sequence media field
• MultiSync — master mode to keep secondary players frame-synced
• Scheduler — time-windowed autoplay with named playlists; repeat and shuffle support
• Wired Ethernet — DHCP or static IP; NTP time sync
• WiFi AP — always-on access point for configuration (SB-Player / sbplayer by default)
• Web UI — browser-based management for config, outputs, sequences, playlists, schedule, and OTA firmware updates
• OLED status display — 128×64 SSD1306 shows IP, current sequence, frame progress, FPS, and audio state
• RTC support — DS3231, DS1307, or PCF8523 for accurate scheduling without NTP; NTP writes back to RTC on first sync

Repository Layout

firmware/SBPlayer/       Arduino sketch and headers
  SBPlayer.ino           Main sketch: setup, playback task, audio task, loop
  config.h               Device config struct + JSON load/save
  fseq.h                 FSEQ v2 parser
  audio.h                I2S audio player (WAV/MP3)
  e131.h                 E1.31/sACN sender
  ddp.h                  DDP sender
  multisync.h            FPP MultiSync master
  scheduler.h            Time-based scheduler + playlist engine
  oled.h                 SSD1306 OLED driver
  rtc.h                  RTC abstraction (DS3231/DS1307/PCF8523)
  webui.h                Async HTTP + WebSocket API and web UI
  data/                  LittleFS web pages (config, outputs, sequences,
                          playlists, schedule, OTA)

hardware/                KiCad ( PCB project (ESP32-P4 + OLED, I2S audio and RTC carrier)
  ESP32-P4_OLED.*        Schematic, PCB, project files
  jlcpcb/                JLCPCB-ready gerbers, BOM, and CPL

Hardware

The carrier board breaks out:

Production files for JLCPCB are in hardware/jlcpcb/.

Firmware Setup

Board: esp32:esp32:esp32p4 (Arduino ESP32 core 3.x)

Required libraries (install via Arduino Library Manager or clone into ~/Arduino/libraries):

• ESPAsyncWebServer
• ArduinoJson
• ESP32-audioI2S (or equivalent — provides AudioFileSourceSD, AudioGeneratorWAV/MP3, AudioOutputI2S)
• Adafruit GFX Library
• Adafruit SSD1306

Build and flash:

1. Open firmware/SBPlayer/SBPlayer.ino in Arduino IDE
2. Select board ESP32P4 Dev Module and your port
3. Flash the sketch
4. Flash the LittleFS filesystem image (littlefs.bin) using the ESP32 LittleFS upload tool — this deploys the web UI pages

SD Card Layout

/sequences/      FSEQ v2 sequence files + matching audio (*.wav / *.mp3)
/playlists/      JSON playlist files
schedule.json    Active schedule (created/managed via web UI)

Example schedule.json:

{
  "entries": [
    { "days": 127, "start_hour": 18, "start_min": 0,
      "end_hour": 23, "end_min": 0, "playlist": "default.json" }
  ]
}

Example playlists/default.json:

{ "repeat": true, "shuffle": false, "entries": ["show1.fseq", "show2.fseq"] }

Default Pin Assignments

All pins are configurable via the web UI.

Web UI Endpoints

License

CC BY-NC 4.0 — free for personal and non-commercial use; commercial use is not permitted.

First Boot

1. Connect to the SB-Player WiFi AP (password sbplayer)
2. Open http://192.168.4.1 in a browser
3. Configure Ethernet, NTP timezone, output universes, and I2S pins
4. Copy sequences to the SD card and create a playlist
5. Add a schedule entry or play sequences manually from the UI