ESP32 S3 - Serveur Web sur carte MicroSD

Dans ce tutoriel, vous apprendrez à construire un serveur Web sur l'ESP32 S3 qui sert du contenu Web directement depuis une carte MicroSD. Héberger vos fichiers HTML, CSS, JavaScript, et image sur une carte MicroSD est une approche pratique quand vos pages Web sont trop volumineuses pour être stockées dans la mémoire flash interne de l'ESP32 S3.

ESP32 S3 serveur web sur carte MicroSD - servir des fichiers HTML, CSS et images depuis la carte SD

Ce que vous allez construire :

  1. Un serveur Web ESP32 S3 qui se connecte à votre réseau WiFi local
  2. Un module de carte MicroSD câblé à l'ESP32 S3 via SPI
  3. Une page HTML avec une mise en forme CSS et une image servies depuis la carte SD
  4. Une page Web accessible par navigateur, joignable par adresse IP depuis n'importe quel appareil du réseau

À propos de l'ESP32 S3 et du serveur Web

L'ESP32 S3 est un puissant microcontrôleur avec WiFi et Bluetooth intégrés, ce qui le rend bien adapté aux projets de serveur Web. Combiné à un module de carte MicroSD via SPI, vous pouvez servir un contenu Web riche — incluant des pages stylées et des images — sans consommer le précieux stockage flash interne. Si vous n'êtes pas encore familier avec les capacités de serveur Web ou de carte MicroSD de l'ESP32 S3, les tutoriels suivants fournissent le contexte nécessaire :

Spécifications clés

  • Microcontrôleur : Xtensa LX7 double cœur, jusqu'à 240 MHz
  • WiFi intégré : 802.11 b/g/n (2,4 GHz)
  • Flash : 16 Mo | PSRAM : 8 Mo
  • Interface SPI pour le module de carte MicroSD
  • USB Type-C pour la programmation et l'alimentation

Schéma de câblage

Connectez le module de carte MicroSD à l'ESP32 S3 en utilisant l'interface SPI, en vous assurant que toutes les lignes de données et d'alimentation sont correctement mappées avant de mettre la carte sous tension.

ESP32 S3 Micro SD Card Module Wiring Diagram

Cette image a été créée avec Fritzing. Cliquez pour agrandir l'image.

Notes de sécurité

Éteignez toujours l'ESP32 S3 avant de connecter ou de déconnecter le module de carte MicroSD pour éviter de corrompre la carte ou d'endommager le bus SPI. Utilisez un module de carte SD compatible avec un niveau logique de 3,3 V, car les broches GPIO de l'ESP32 S3 fonctionnent en 3,3 V — connecter un module 5 V directement peut endommager la carte.

Broche ESP32 S3Broche du module de carte MicroSD
3.3VVCC
GNDGND
GPIO10CS
GPIO11MOSI
GPIO12SCK
GPIO13MISO

Copier le contenu HTML sur la carte MicroSD

Avant de téléverser le code vers l'ESP32 S3, préparez votre carte SD avec les fichiers Web qu'elle servira. Formatez la carte MicroSD en FAT32 (sur Windows : clic droit sur le lecteur → Format → sélectionnez FAT32), puis créez les fichiers suivants dans le répertoire racine de la carte.

  • Assurez-vous que votre carte Micro SD est formatée au format FAT32 comme ci-dessous (sur Windows, clic droit de la souris → format) :
Micro SD Card format FAT32
  • Créez un fichier HTML index.html et ajoutez le code suivant :
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>ESP32 S3 Web Page</title> <link rel="icon" href="favicon.ico" type="image/x-icon"> <link rel="stylesheet" href="styles.css"> </head> <body> <div class="container"> <h1>Web Page hosted on MicroSD Card</h1> <img src="luffy.jpg" alt="A beautiful image"> <p>Sponsored by <a href="https://amazon.com/diyables">DIYables</a></p> </div> </body> </html>
  • Créez un fichier CSS styles.css et ajoutez le code suivant :
body { font-family: Arial, sans-serif; margin: 0; padding: 0; background-color: white; } h1 { font-size: 28px; } .container { max-width: 800px; margin: 20px auto; text-align: center; } img { max-width: 80%; height: auto; display: block; margin: 20px auto; }
  • Préparez une image. Ce tutoriel utilise luffy.jpg, qui est utilisée dans le code HTML. Vous pouvez télécharger cette image ici :
luffy
  • (Optionnel) Préparez une image favicon. Ce tutoriel utilise ce favicon.ico
  • Placez tous les fichiers dans le répertoire racine de la carte MicroSD, comme sur les images ci-dessous :
ESP32 S3 HTML contents on microSD Card

Veuillez noter que vous pouvez ajouter d'autres fichiers comme JavaScript, txt, csv...

Code ESP32 S3 - Serveur Web sur carte MicroSD

Le code suivant configure l'ESP32 S3 comme serveur Web qui lit et sert des fichiers directement depuis la carte MicroSD via l'interface SPI. Quand un navigateur demande un fichier, le serveur l'ouvre depuis la carte SD et le diffuse vers le client, en incluant les en-têtes de type MIME appropriés pour les fichiers HTML, CSS, JavaScript, et image. Mettez à jour les identifiants WiFi dans le code pour correspondre à votre réseau avant de téléverser.

/* * Ce code ESP32 S3 a été développé par newbiely.fr * Ce code ESP32 S3 est mis à disposition du public sans aucune restriction. * Pour des instructions complètes et des schémas de câblage, veuillez visiter: * https://newbiely.fr/tutorials/esp32-s3/esp32-s3-web-server-on-sd-card */ /* * This ESP32-S3 code is created by esp32io.com * * This ESP32-S3 code is released in the public domain * * For more detail (instruction and wiring diagram), visit https://esp32io.com/tutorials/esp32-s3-web-server-on-sd-card */ #include <WiFi.h> #include <WebServer.h> #include <FS.h> #include <SPI.h> #include <SD.h> // MicroSD Card module on the default SPI pins: // CS -> ESP32-S3 pin GPIO10, MOSI -> ESP32-S3 pin GPIO11, SCK -> ESP32-S3 pin GPIO12, MISO -> ESP32-S3 pin GPIO13 #define PIN_SPI_CS 10 // ESP32-S3 pin GPIO10 connected to the CS pin of the MicroSD Card module // Replace with your network credentials const char* ssid = "YOUR_WIFI_SSID"; // CHANGE IT const char* password = "YOUR_WIFI_PASSWORD"; // CHANGE IT WebServer server(80); // create a web server object on port 80 // return the content type of a file from its extension String getContentType(const String& path) { if (path.endsWith(".html") || path.endsWith(".htm")) return "text/html"; if (path.endsWith(".css")) return "text/css"; if (path.endsWith(".js")) return "application/javascript"; if (path.endsWith(".json")) return "application/json"; if (path.endsWith(".png")) return "image/png"; if (path.endsWith(".jpg") || path.endsWith(".jpeg")) return "image/jpeg"; if (path.endsWith(".gif")) return "image/gif"; if (path.endsWith(".ico")) return "image/x-icon"; if (path.endsWith(".svg")) return "image/svg+xml"; if (path.endsWith(".txt")) return "text/plain"; if (path.endsWith(".csv")) return "text/csv"; return "application/octet-stream"; } // read the requested file from the MicroSD Card and send it to the browser void handleFile() { String path = server.uri(); if (path.endsWith("/")) path += "index.html"; // the home page is index.html if (!SD.exists(path)) { server.send(404, "text/plain", "404: File Not Found"); return; } Serial.print("Serving file: "); Serial.println(path); File file = SD.open(path, FILE_READ); server.streamFile(file, getContentType(path)); file.close(); } void setup() { Serial.begin(115200); // init MicroSD Card if (!SD.begin(PIN_SPI_CS)) { while (1) { Serial.println(F("SD CARD FAILED, OR NOT PRESENT!")); delay(1000); } } // Connect to Wi-Fi WiFi.begin(ssid, password); while (WiFi.status() != WL_CONNECTED) { delay(1000); Serial.println("Connecting to WiFi..."); } Serial.println("Connected to WiFi"); // Print the ESP32-S3's IP address Serial.print("ESP32 S3 Web Server's IP address: "); Serial.println(WiFi.localIP()); server.onNotFound(handleFile); // every request is served from the MicroSD Card server.begin(); } void loop() { server.handleClient(); }

Étapes rapides

  1. Nouveau sur l'ESP32 S3 ? Terminez d'abord notre guide ESP32 S3 - Premiers pas.
  2. Connectez le module de carte MicroSD à la carte ESP32 S3 en suivant le schéma de câblage ci-dessus.
  3. Formatez votre carte MicroSD en FAT32 et copiez les fichiers HTML, CSS, et image dans son répertoire racine.
  4. Connectez la carte ESP32 S3 à votre PC via un câble USB Type-C.
  5. Ouvrez l'Arduino IDE sur votre PC.
  6. Sélectionnez la bonne carte ESP32 S3 (par exemple ESP32S3 Dev Module) et le bon port COM.
  7. Ouvrez le gestionnaire de bibliothèques en cliquant sur l'icône Library Manager dans la barre de navigation gauche de l'Arduino IDE.
  8. Recherchez "DIYables ESP32 WebServer", puis trouvez la bibliothèque Web Server créée par DIYables.
  9. Cliquez sur le bouton Install pour installer la bibliothèque Web Server.
  • Search for DIYables ESP32 WebServer created by DIYables.io and click the Install button.
∞
Newbiely | Arduino IDE 2.3.8
──
☐
✕
File
Edit
Sketch
Tools
Help
ESP32S3 Dev Module
Library Manager
Type:
All
Topic:
All
DIYables ESP32 WebServer by DIYables.io
DIYables ESP32 WebServer library designed for ESP32 boards. It includes multi-page web server capabilities and WebSocket support for real-time communication, perfect for IoT projects and DIYables ESP32 boards. More info
1.0.1
INSTALL
Newbiely.ino
···
1 void setup() {
Output
Serial Monitor
Ln 1, Col 1
ESP32S3 Dev Module on COM15
1
  1. Copiez le code ci-dessus et ouvrez-le avec l'Arduino IDE.
  2. Changez les informations WiFi (SSID et mot de passe) dans le code par les vôtres.
  3. Cliquez sur le bouton Upload dans l'Arduino IDE pour téléverser le code vers l'ESP32 S3.
  4. Ouvrez le moniteur série et réglez le débit en bauds sur 115200.
  5. Consultez le résultat dans le moniteur série.
  6. Astuce : Vous pouvez mettre à jour le contenu de votre page Web (HTML, CSS, images) simplement en remplaçant ou en modifiant les fichiers sur la carte MicroSD — pas besoin de retéléverser le firmware de l'ESP32 S3 à chaque fois.

Moniteur série

Après le téléversement réussi du code, ouvrez le moniteur série pour confirmer que l'ESP32 S3 se connecte au WiFi et démarre le serveur Web. Vous devriez voir une sortie similaire aux relevés suivants :

∞
Newbiely | Arduino IDE 2.3.8
──
☐
✕
File
Edit
Sketch
Tools
Help
ESP32S3 Dev Module
Newbiely.ino
···
8 Serial.println("Hello World!");
Output
Serial Monitor
Message (Enter to send message to 'ESP32S3 Dev Module' on 'COM15')
New Line
9600 baud
[2026-01-15 08:32:11] Connecting to WiFi... [2026-01-15 08:32:14] Connected to WiFi [2026-01-15 08:32:14] ESP32 S3 Web Server's IP address: 192.168.0.3 [2026-01-15 08:32:28] Serving file: /index.html
Ln 11, Col 1
ESP32S3 Dev Module on COM15
2
  • Vous verrez une adresse IP dans le moniteur série, par exemple : 192.168.0.3
  • Tapez l'adresse IP dans la barre d'adresse d'un navigateur Web sur votre smartphone ou PC.
  • Veuillez noter que vous devez remplacer 192.168.0.3 par l'adresse IP que vous avez obtenue dans le moniteur série.
  • Vous verrez une page charger le HTML, le CSS, les images depuis la carte SD.
ESP32 S3 Web page on SD Card

Comme vous pouvez le voir, le HTML, le CSS, et les images stockés sur la carte MicroSD ont été chargés par le navigateur Web. Vous pouvez maintenant modifier les fichiers HTML et CSS sur la carte SD et actualiser votre navigateur pour voir les changements immédiatement, sans retéléverser le firmware.

Applications

Servir du contenu Web depuis une carte MicroSD ouvre un large éventail de cas d'usage pratiques où l'interface Web est trop volumineuse ou trop dynamique pour tenir dans la mémoire flash interne :

  1. Tableau de bord de domotique : Hébergez un panneau de contrôle complet avec plusieurs pages, icônes, et scripts pour surveiller et contrôler des appareils domotiques.
  2. Affichage d'enregistreur de données : Servez une page Web qui lit et affiche des fichiers journaux CSV stockés sur la même carte SD, vous donnant un visualiseur de données basé sur navigateur.
  3. Kiosque d'information portable : Déployez un affichage d'information autonome (par exemple dans un musée ou un atelier) qui sert un site Web multi-pages depuis un seul appareil ESP32 S3.
  4. Interface Web OTA : Hébergez une page de mise à jour sur la carte SD qui permet aux utilisateurs de configurer les identifiants WiFi ou les réglages de l'appareil sans reflasher le firmware.
  5. Galerie multimédia : Servez des galeries d'images ou de petits fichiers audio depuis la carte SD pour des projets multimédias légers.

Vidéo

Regardez la vidéo pas à pas pour ce projet ESP32 S3 ci-dessous.

Défis

Maintenant que votre serveur Web ESP32 S3 sert des fichiers depuis une carte MicroSD, essayez d'étendre le projet avec ces défis pour approfondir votre compréhension :

  1. Débutant : Ajoutez une seconde page HTML (par exemple about.html) sur la carte SD et créez un lien de navigation entre index.html et la nouvelle page.
  2. Intermédiaire : Ajoutez un fichier JavaScript sur la carte SD qui récupère périodiquement une lecture de capteur depuis un nouveau point de terminaison /data sur l'ESP32 S3 et l'affiche sur la page Web sans rechargement de page.
  3. Avancé : Implémentez un point de terminaison de téléversement de fichiers sur le serveur Web de l'ESP32 S3 afin que les utilisateurs puissent téléverser de nouveaux fichiers HTML ou image directement sur la carte MicroSD depuis un navigateur, permettant une gestion de contenu entièrement à distance.

※ NOS MESSAGES

  • N'hésitez pas à partager le lien de ce tutoriel. Cependant, veuillez ne pas utiliser notre contenu sur d'autres sites web. Nous avons investi beaucoup d'efforts et de temps pour créer ce contenu, veuillez respecter notre travail !