From 4df386887debc888014c242d3917c7aabca39f03 Mon Sep 17 00:00:00 2001 From: M-Factory Date: Sun, 16 Nov 2025 19:17:34 +0900 Subject: [PATCH] Update README.md --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index a9bd79c..f1fb27f 100644 --- a/README.md +++ b/README.md @@ -221,7 +221,20 @@ Follow these steps to prepare your Arduino IDE for ESP8266 development: * `MD_Parola` by majicDesigns (this will typically also install its dependency: `MD_MAX72xx`) * `ESPAsyncTCP` by ESP32Async * `ESPAsyncWebServer` by ESP32Async + + **⚠️ ESP8266 Library Compatibility Notice** +Due to internal changes in **ESPAsyncWebServer 3.9.0**, large files served from SPIFFS/LittleFS may fail to load on ESP8266 (blank page). +Version **3.8.1** is currently the most stable release for ESP8266, and is recommended for this project. + +Install version **3.8.1** manually: + * Arduino IDE → Tools → Manage Libraries + * Search: ESPAsyncWebServer + * Install version 3.8.1 + +>Future versions may fix this, but for now 3.8.1 ensures full compatibility. + +  #### ⚙️ ESP32 Setup Follow these steps to prepare your Arduino IDE for ESP32 development: @@ -479,4 +492,5 @@ If you enjoy this project, please consider supporting my work: +