drjones/sunflower-girl
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README.md with Web Upload Panel and AP details

Browse Source
This commit is contained in:
drjones
2026-06-30 01:43:53 -07:00
parent 87c24338b5
commit 76e1185c20
1 changed files with 15 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
README.md
View File

@@ -8,6 +8,7 @@ The application reads PNG images and compressed MP3 / uncompressed WAV audio fil
## 🚀 Key Features ## 🚀 Key Features
* **WiFi Web Upload Interface:** Hosts a local WiFi network and web server so you can upload pictures and audio files directly to the microSD card from your phone or computer.
* **Alpha-Numeric Media Pairing:** Scans the root of the microSD card for PNG images and audio files (`.wav` or `.mp3`), sorting and matching them alphabetically (e.g., `01_image.png` pairs with `01_sound.mp3`). * **Alpha-Numeric Media Pairing:** Scans the root of the microSD card for PNG images and audio files (`.wav` or `.mp3`), sorting and matching them alphabetically (e.g., `01_image.png` pairs with `01_sound.mp3`).
* **Dual-Core Software Decoding:** Spawns a background task pinned to **Core 0** running the `ESP32-audioI2S` decoding loop. This prevents audio dropouts or stutters during heavy display updates on **Core 1**. * **Dual-Core Software Decoding:** Spawns a background task pinned to **Core 0** running the `ESP32-audioI2S` decoding loop. This prevents audio dropouts or stutters during heavy display updates on **Core 1**.
* **Interactive Multi-Click Gestures:** You can control slide progression, audio status, and volume from the board's single physical button: * **Interactive Multi-Click Gestures:** You can control slide progression, audio status, and volume from the board's single physical button:
@@ -25,6 +26,18 @@ The application reads PNG images and compressed MP3 / uncompressed WAV audio fil
--- ---
## 🌐 WiFi Upload Interface Setup
To upload new files to your photo frame over WiFi:
1. Connect your phone, tablet, or computer to the WiFi network hosted by the board:
* **SSID:** `ESP32-Photo-Frame`
* **Password:** None (Open Network)
2. Open your browser and navigate to: **`http://192.168.4.1`**
3. Choose a file (`.png`, `.mp3`, or `.wav`) and click **Upload to Frame**.
4. The file will be saved directly to the microSD card. The board will automatically re-scan the card, and the new files will be indexed and ready to play!
---
## 🔌 Hardware Connections (External I2S DAC) ## 🔌 Hardware Connections (External I2S DAC)
Because the Waveshare ESP32-S3-LCD-1.47 does not have built-in audio amplification or a speaker, you must connect an external **I2S DAC/Amplifier** (e.g., MAX98357A or PCM5102) to the exposed headers. Because the Waveshare ESP32-S3-LCD-1.47 does not have built-in audio amplification or a speaker, you must connect an external **I2S DAC/Amplifier** (e.g., MAX98357A or PCM5102) to the exposed headers.
@@ -51,7 +64,8 @@ Configure the pin connections as follows:
│ ├── Display_ST7789.h/.cpp # Waveshare display initialization & backlight control │ ├── Display_ST7789.h/.cpp # Waveshare display initialization & backlight control
│ ├── Display_PNG.h/.cpp # PNGdec utility for decoding and drawing images │ ├── Display_PNG.h/.cpp # PNGdec utility for decoding and drawing images
│ ├── SD_Card.h/.cpp # SD_MMC mount and folder retrieval helpers │ ├── SD_Card.h/.cpp # SD_MMC mount and folder retrieval helpers
│ └── Audio_Player.h/.cpp # background ESP32-audioI2S player task wrapper │ ├── Audio_Player.h/.cpp # background ESP32-audioI2S player task wrapper
│ └── Web_Server.h/.cpp # local SoftAP WiFi file upload panel
├── ESP32-S3-LCD-1.47-Demo/ # Waveshare Official Reference Demos ├── ESP32-S3-LCD-1.47-Demo/ # Waveshare Official Reference Demos
└── README.md # This file └── README.md # This file
``` ```