From 76e1185c20c0392443bf7232050569e07ede2ef1 Mon Sep 17 00:00:00 2001 From: drjones Date: Tue, 30 Jun 2026 01:43:53 -0700 Subject: [PATCH] Update README.md with Web Upload Panel and AP details --- README.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index a1215ec..67dba24 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,7 @@ The application reads PNG images and compressed MP3 / uncompressed WAV audio fil ## 🚀 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`). * **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: @@ -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) 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_PNG.h/.cpp # PNGdec utility for decoding and drawing images │ ├── 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 └── README.md # This file ```