ESP32 S3 - Webserver auf MicroSD-Karte

In diesem Tutorial lernen Sie, wie Sie auf dem ESP32 S3 einen Webserver bauen, der Webinhalte direkt von einer MicroSD-Karte bereitstellt. HTML-, CSS-, JavaScript- und Bilddateien auf einer MicroSD-Karte abzulegen ist ein praktischer Ansatz, wenn Ihre Webseiten zu groß für den internen Flash-Speicher des ESP32 S3 sind.

ESP32 S3 Webserver auf MicroSD-Karte - HTML-, CSS- und Bilddateien von der SD-Karte ausliefern

Was Sie bauen werden:

  1. Einen ESP32-S3-Webserver, der sich mit Ihrem lokalen WiFi-Netzwerk verbindet
  2. Ein MicroSD-Kartenmodul, das über SPI mit dem ESP32 S3 verbunden ist
  3. Eine HTML-Seite mit CSS-Gestaltung und einem Bild, die von der SD-Karte bereitgestellt wird
  4. Eine im Browser erreichbare Webseite, die auf jedem Gerät im Netzwerk über die IP-Adresse aufgerufen werden kann

Erforderliche Hardware

1×ESP32 S3 WROOM N16R8
1×(Alternativ) ESP32 S3 SuperMini Dev Module
1×(Alternativ) ESP32 S3 Uno-form Board
1×(Alternativ) ESP32 S3 Camera Board
1×USB-Kabel Typ-A zu Typ-C (für USB-A PC)
1×USB-Kabel Typ-C zu Typ-C (für USB-C PC)
1×Micro-SD-Karte
1×Micro-SD-Karten-Modul
1×(Alternativ) Small Micro SD Card Module
1×Verbindungskabel
1×Breadboard
1×USB 3.0 SD Card Reader
1×(Empfohlen) Screw Terminal Expansion Board for ESP32 S3
1×(Empfohlen) Breakout Expansion Board for ESP32 S3
1×(Empfohlen) Power Splitter for ESP32 S3

Oder Sie können die folgenden Kits kaufen:

1×DIYables ESP32 S3 Starter-Kit (ESP32 S3 enthalten)
1×DIYables Sensor-Kit (18 Sensoren/Displays)
Offenlegung: Einige der in diesem Abschnitt bereitgestellten Links sind Amazon-Affiliate-Links. Wir können eine Provision für Käufe erhalten, die über diese Links getätigt werden, ohne zusätzliche Kosten für Sie. Wir schätzen Ihre Unterstützung.

Überblick über ESP32 S3 and Web Server

Der ESP32 S3 ist ein leistungsstarker Mikrocontroller mit integriertem WiFi und Bluetooth und eignet sich daher gut für Webserver-Projekte. In Kombination mit einem über SPI angeschlossenen MicroSD-Kartenmodul können Sie umfangreiche Webinhalte — einschließlich gestalteter Seiten und Bilder — bereitstellen, ohne wertvollen internen Flash-Speicher zu belegen. Wenn Sie mit den Webserver- oder MicroSD-Karten-Funktionen des ESP32 S3 noch nicht vertraut sind, bieten die folgenden Tutorials die nötigen Grundlagen:

Wichtige Spezifikationen

  • Mikrocontroller: Xtensa LX7 Dual-Core, bis zu 240 MHz
  • Integriertes WiFi: 802.11 b/g/n (2,4 GHz)
  • Flash: 16 MB | PSRAM: 8 MB
  • SPI-Schnittstelle für das MicroSD-Kartenmodul
  • USB Typ-C für Programmierung und Stromversorgung

Verdrahtungsdiagramm

Verbinden Sie das MicroSD-Kartenmodul über die SPI-Schnittstelle mit dem ESP32 S3 und stellen Sie sicher, dass alle Daten- und Stromleitungen korrekt zugeordnet sind, bevor Sie das Board mit Strom versorgen.

ESP32 S3 Micro-SD-Kartenmodul Schaltplan

Dieses Bild wurde mit Fritzing erstellt. Klicken Sie, um das Bild zu vergrößern.

Sicherheitshinweise

Schalten Sie den ESP32 S3 immer aus, bevor Sie das MicroSD-Kartenmodul anschließen oder trennen, um eine Beschädigung der Karte oder des SPI-Busses zu vermeiden. Verwenden Sie ein SD-Kartenmodul mit kompatiblem Logikpegel (3,3 V), da die GPIO-Pins des ESP32 S3 mit 3,3 V arbeiten — ein direkt angeschlossenes 5-V-Modul kann das Board beschädigen.

ESP32 S3 PinPin des MicroSD-Kartenmoduls
3.3VVCC
GNDGND
GPIO10CS
GPIO11MOSI
GPIO12SCK
GPIO13MISO

HTML-Inhalte auf die MicroSD-Karte kopieren

Bevor Sie Code auf den ESP32 S3 hochladen, bereiten Sie Ihre SD-Karte mit den Webdateien vor, die bereitgestellt werden sollen. Formatieren Sie die MicroSD-Karte mit FAT32 (unter Windows: Rechtsklick auf das Laufwerk → Formatieren → FAT32 auswählen) und erstellen Sie dann die folgenden Dateien im Stammverzeichnis der Karte.

  • Bitte stellen Sie sicher, dass Ihre Micro-SD-Karte wie unten im FAT32-Format formatiert ist (unter Windows: Rechtsklick → Formatieren):
Micro-SD-Karte als FAT32 formatieren
  • Erstellen Sie eine HTML-Datei index.html und fügen Sie den folgenden Code ein:
<!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>
  • Erstellen Sie eine CSS-Datei styles.css und fügen Sie den folgenden Code ein:
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; }
  • Bereiten Sie ein Bild vor. Dieses Tutorial verwendet luffy.jpg, das im HTML-Code eingebunden ist. Sie können dieses Bild hier herunterladen:
luffy
  • (Optional) Bereiten Sie ein Favicon vor. Dieses Tutorial verwendet dieses favicon.ico
  • Legen Sie alle Dateien im Stammverzeichnis der MicroSD-Karte ab, wie in den folgenden Bildern gezeigt:
ESP32 S3 HTML-Inhalte auf der microSD-Karte

Bitte beachten Sie, dass Sie weitere Dateien wie JavaScript, txt, csv... hinzufügen können.

ESP32 S3 Code - Webserver auf MicroSD-Karte

Der folgende Code konfiguriert den ESP32 S3 als Webserver, der Dateien über die SPI-Schnittstelle direkt von der MicroSD-Karte liest und bereitstellt. Fordert ein Browser eine Datei an, öffnet der Server sie von der SD-Karte und überträgt sie an den Client, einschließlich passender MIME-Type-Header für HTML-, CSS-, JavaScript- und Bilddateien. Passen Sie vor dem Hochladen die WiFi-Zugangsdaten im Code an Ihr Netzwerk an.

/* * Dieser ESP32 S3 Code wurde von newbiely.de entwickelt * Dieser ESP32 S3 Code wird der Öffentlichkeit ohne jegliche Einschränkung zur Verfügung gestellt. * Für vollständige Anleitungen und Schaltpläne besuchen Sie bitte: * https://newbiely.de/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(); }

Schnelle Schritte

  1. Neu beim ESP32 S3? Arbeiten Sie zuerst unsere Anleitung Erste Schritte mit dem ESP32 S3 durch.
  2. Verbinden Sie das MicroSD-Kartenmodul gemäß dem obigen Schaltplan mit dem ESP32-S3-Board.
  3. Formatieren Sie Ihre MicroSD-Karte als FAT32 und kopieren Sie die HTML-, CSS- und Bilddateien in ihr Stammverzeichnis.
  4. Verbinden Sie das ESP32-S3-Board über ein USB-Typ-C-Kabel mit Ihrem PC.
  5. Öffnen Sie die Arduino IDE auf Ihrem PC.
  6. Wählen Sie das richtige ESP32-S3-Board (z. B. ESP32S3 Dev Module) und den richtigen COM-Port aus.
  7. Öffnen Sie den Bibliotheksverwalter, indem Sie auf das Symbol Library Manager in der linken Navigationsleiste der Arduino IDE klicken.
  8. Suchen Sie nach "DIYables ESP32 WebServer" und finden Sie dann die Web-Server-Bibliothek von DIYables.
  9. Klicken Sie auf die Schaltfläche Install, um die Web-Server-Bibliothek zu installieren.
  • 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. Kopieren Sie den obigen Code und öffnen Sie ihn mit der Arduino IDE.
  2. Ändern Sie die WiFi-Informationen (SSID und Passwort) im Code auf Ihre eigenen.
  3. Klicken Sie in der Arduino IDE auf die Schaltfläche Upload, um den Code auf den ESP32 S3 hochzuladen.
  4. Öffnen Sie den Seriellen Monitor und stellen Sie die Baudrate auf 115200 ein.
  5. Sehen Sie sich das Ergebnis im Seriellen Monitor an.
  6. Profi-Tipp: Sie können den Inhalt Ihrer Webseite (HTML, CSS, Bilder) aktualisieren, indem Sie einfach Dateien auf der MicroSD-Karte austauschen oder bearbeiten — die ESP32-S3-Firmware muss dafür nicht jedes Mal neu hochgeladen werden.

Serieller Monitor

Nachdem der Code erfolgreich hochgeladen wurde, öffnen Sie den Seriellen Monitor, um zu bestätigen, dass sich der ESP32 S3 mit dem WiFi verbindet und den Webserver startet. Sie sollten eine Ausgabe ähnlich der folgenden sehen:

∞
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
  • Im Seriellen Monitor sehen Sie eine IP-Adresse, zum Beispiel: 192.168.0.3
  • Geben Sie die IP-Adresse in die Adressleiste eines Webbrowsers auf Ihrem Smartphone oder PC ein.
  • Bitte beachten Sie, dass Sie 192.168.0.3 durch die IP-Adresse ersetzen müssen, die Sie im Seriellen Monitor erhalten haben.
  • Sie sehen eine Seite, die HTML, CSS und Bilder von der SD-Karte lädt.
ESP32 S3 Webseite auf SD-Karte

Wie Sie sehen, wurden das HTML, das CSS und die Bilder, die auf der MicroSD-Karte gespeichert sind, vom Webbrowser geladen. Sie können nun die HTML- und CSS-Dateien auf der SD-Karte ändern und Ihren Browser aktualisieren, um die Änderungen sofort zu sehen, ohne die Firmware erneut hochzuladen.

Anwendungen

Webinhalte von einer MicroSD-Karte bereitzustellen eröffnet viele praktische Anwendungsfälle, in denen die Weboberfläche zu groß oder zu dynamisch für den internen Flash-Speicher ist:

  1. Hausautomations-Dashboard: Stellen Sie ein umfangreiches Bedienfeld mit mehreren Seiten, Symbolen und Skripten bereit, um Smart-Home-Geräte zu überwachen und zu steuern.
  2. Anzeige für Datenlogger: Stellen Sie eine Webseite bereit, die auf derselben SD-Karte gespeicherte CSV-Protokolldateien liest und anzeigt — so erhalten Sie einen browserbasierten Datenbetrachter.
  3. Tragbarer Informationskiosk: Setzen Sie eine eigenständige Informationsanzeige ein (z. B. in einem Museum oder einer Werkstatt), die eine mehrseitige Website von einem einzigen ESP32-S3-Gerät bereitstellt.
  4. OTA-Weboberfläche: Legen Sie eine Aktualisierungsseite auf der SD-Karte ab, mit der Benutzer WiFi-Zugangsdaten oder Geräteeinstellungen konfigurieren können, ohne die Firmware neu zu flashen.
  5. Mediengalerie: Stellen Sie Bildergalerien oder kleine Audiodateien von der SD-Karte für schlanke Multimedia-Projekte bereit.

Video Tutorial

Wir erwägen die Erstellung von Video-Tutorials. Wenn Sie Video-Tutorials für wichtig halten, abonnieren Sie bitte unseren YouTube-Kanal , um uns zu motivieren, die Videos zu erstellen.

Sehen Sie sich unten die Schritt-für-Schritt-Videoanleitung zu diesem ESP32-S3-Projekt an.

Herausforderungen

Da Ihr ESP32-S3-Webserver nun Dateien von einer MicroSD-Karte bereitstellt, erweitern Sie das Projekt mit diesen Aufgaben, um Ihr Verständnis zu vertiefen:

  1. Anfänger: Fügen Sie der SD-Karte eine zweite HTML-Seite hinzu (z. B. about.html) und erstellen Sie einen Navigationslink zwischen index.html und der neuen Seite.
  2. Fortgeschritten: Fügen Sie der SD-Karte eine JavaScript-Datei hinzu, die regelmäßig einen Sensorwert von einem neuen Endpunkt /data auf dem ESP32 S3 abruft und ihn ohne Neuladen der Seite auf der Webseite anzeigt.
  3. Experte: Setzen Sie auf dem ESP32-S3-Webserver einen Datei-Upload-Endpunkt um, damit Benutzer neue HTML- oder Bilddateien direkt aus einem Browser auf die MicroSD-Karte hochladen können, was eine vollständige Fernverwaltung der Inhalte ermöglicht.

※ UNSERE NACHRICHTEN

  • Sie können gerne den Link zu diesem Tutorial teilen. Bitte verwenden Sie jedoch unsere Inhalte nicht auf anderen Websites. Wir haben viel Mühe und Zeit in die Erstellung der Inhalte investiert, bitte respektieren Sie unsere Arbeit!