ESP32 S3 - WebSocket

WebSocket ermöglicht eine bidirektionale Kommunikation in Echtzeit zwischen einem Webbrowser und einem Gerät wie dem ESP32 S3 – ohne die Seite jemals neu zu laden. In diesem Tutorial lernen wir, was WebSocket ist, warum es sich ideal für die reibungslose Steuerung und Überwachung des ESP32 S3 eignet und wie man es anhand einer praktischen Chat-Anwendung einrichtet.

Was Sie bauen werden:

  1. Einen WebSocket-Server, der auf dem ESP32 S3 läuft.
  2. Eine vom ESP32 S3 bereitgestellte Webseite, die sich mit dem WebSocket-Server verbindet.
  3. Eine Chat-Oberfläche, über die Sie im Browser eine Nachricht eingeben und an den ESP32 S3 senden können.
  4. Antworten des ESP32 S3 in Echtzeit, die ohne Neuladen der Seite im Browser angezeigt werden.
ESP32 S3 WebSocket - Echtzeit-Kommunikation in beide Richtungen zwischen Webbrowser und ESP32 S3

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×(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.

Was ist ESP32 S3 WebSocket?

WebSocket ist eine Technologie, mit der ein Webbrowser in Echtzeit direkt mit einem Webserver kommunizieren kann. Dabei bleibt eine dauerhafte Verbindung geöffnet, sodass Daten jederzeit in beide Richtungen fließen können. Ohne WebSocket muss der Browser die Seite wiederholt aktualisieren oder den Server abfragen, um Aktualisierungen zu erhalten, was langsam und ineffizient ist. Mit WebSocket bleiben ESP32 S3 und Browser ständig verbunden, was einen sofortigen Datenaustausch ohne Neuladen der Seite ermöglicht – genau die Reaktionsfähigkeit, die für Steuerungs- und Überwachungsprojekte benötigt wird.

Wichtige Spezifikationen

  • Protokoll: Vollduplex-WebSocket auf TCP-Basis (RFC 6455)
  • Richtung: Gleichzeitig vom Browser zum ESP32 S3 und vom ESP32 S3 zum Browser
  • Latenz: Nahezu sofort; kein Neuladen der Seite erforderlich
  • Typische Anwendungsfälle: Online-Spiele, Instant Messaging, Live-Dashboards, IoT-Bedienfelder

Warum brauchen wir WebSocket, um den ESP32 S3 reibungslos zu steuern?

Stellen Sie sich vor, Sie steuern ein ferngesteuertes Gerät über eine Weboberfläche auf Ihrem Smartphone. Ohne WebSocket erfordert jede Richtungs- oder Geschwindigkeitsänderung ein Neuladen der Seite – so, als müssten Sie vor jedem Befehl einen „Neu laden“-Knopf drücken, bevor er das Gerät erreicht. Mit WebSocket haben Sie eine ständige, direkte Verbindung zwischen Browser und ESP32 S3, sodass Befehle sofort und ohne Verzögerung durch Neuladen ankommen.

Im Allgemeinen ermöglicht WebSocket Folgendes:

  • Daten vom Webbrowser an den ESP32 S3 senden, ohne die Webseite neu zu laden.
  • Daten vom ESP32 S3 an den Webbrowser senden, ohne die Webseite neu zu laden.

Dies ermöglicht eine echte bidirektionale Kommunikation in Echtzeit.

Vorteile von WebSocket mit dem ESP32 S3:

  • Echtzeitsteuerung: WebSocket ermöglicht eine sofortige Kommunikation mit dem ESP32 S3 und sorgt für schnelle Reaktionen auf Befehle und eine nahtlose Benutzererfahrung.
  • Dauerhafte Verbindung: Eine ständige Verbindung ohne Aktualisierung der Steuerseite aufrechterhalten – eine stets bereite Kommunikationsleitung für sofortige Anweisungen.
  • Effizienz: Schnelle Reaktionen ohne ständiges Neuladen der Seite, was Bedienkomfort und Effizienz insgesamt verbessert.

Web-Chat mit dem ESP32 S3 über WebSocket

Der Inhalt der Webseite (HTML, CSS, JavaScript) wird separat in einer Datei index.h gespeichert. Wir haben also zwei Codedateien in der Arduino IDE:

  • Eine .ino-Datei mit dem ESP32-S3-Code, der einen Webserver und einen WebSocket-Server erstellt
  • Eine .h-Datei, die den Inhalt der Webseite enthält.

Schnelle Schritte

  1. Neu beim ESP32 S3? Arbeiten Sie zuerst unsere Anleitung Erste Schritte mit dem ESP32 S3 durch.
  2. Verbinden Sie das ESP32-S3-Board über ein USB-Typ-C-Kabel mit Ihrem PC.
  3. Öffnen Sie die Arduino IDE auf Ihrem PC.
  4. Wählen Sie das richtige ESP32-S3-Board (z. B. ESP32S3 Dev Module) und den COM-Port aus.
  5. Öffnen Sie den Bibliotheksverwalter, indem Sie auf das Symbol Library Manager in der linken Navigationsleiste der Arduino IDE klicken.
  6. Suchen Sie nach "DIYables ESP32 WebServer" und finden Sie dann die Web-Server-Bibliothek von DIYables.
  7. Klicken Sie auf die Schaltfläche Install, um die Web-Server-Bibliothek zu installieren.
ESP32 S3 Web-Server-Bibliothek
  1. Erstellen Sie in der Arduino IDE einen neuen Sketch und geben Sie ihm einen Namen, zum Beispiel newbiely.com.ino.
  2. Der folgende Code implementiert den WebSocket-Server des ESP32 S3 – er verarbeitet eingehende Browserverbindungen, empfängt Nachrichten und sendet Antworten in Echtzeit. Kopieren Sie ihn und öffnen Sie ihn in der Arduino IDE.
/* * 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-websocket */ /* * 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-websocket */ #include <DIYables_ESP32_WebServer.h> #include "index.h" // WiFi credentials const char WIFI_SSID[] = "YOUR_WIFI_SSID"; const char WIFI_PASSWORD[] = "YOUR_WIFI_PASSWORD"; // Create web server instance DIYables_ESP32_WebServer server; DIYables_ESP32_WebSocket* webSocket; // Web Page handlers void handleHome(WiFiClient& client, const String& method, const String& request, const QueryParams& params, const String& jsonData) { // HTML_CONTENT from the index.h file server.sendResponse(client, HTML_CONTENT); } // WebSocket event handlers void onWebSocketOpen(net::WebSocket& ws) { Serial.println("New WebSocket connection"); // Send welcome message const char welcome[] = "Connected to ESP32-S3 WebSocket Server!"; } void onWebSocketMessage(net::WebSocket& ws, const net::WebSocket::DataType dataType, const char* message, uint16_t length) { Serial.print("WebSocket Received ("); Serial.print(length); Serial.print(" bytes): "); Serial.println(message); // Broadcast response to all connected clients using the library if (webSocket != nullptr) { String response = "Received: " + String((char*)message); webSocket->broadcastTXT(response); Serial.print("WebSocket sent ("); Serial.print(response.length()); Serial.print(" bytes): "); Serial.println(response); } } void onWebSocketClose(net::WebSocket& ws, const net::WebSocket::CloseCode code, const char* reason, uint16_t length) { Serial.println("WebSocket client disconnected"); } void setup() { Serial.begin(9600); delay(1000); Serial.println("ESP32-S3 Web Server and WebSocket Server"); // Configure web server routes server.addRoute("/", handleHome); // Start web server with WiFi connection server.begin(WIFI_SSID, WIFI_PASSWORD); // Enable WebSocket functionality webSocket = server.enableWebSocket(81); if (webSocket != nullptr) { // Set up WebSocket event handlers webSocket->onOpen(onWebSocketOpen); webSocket->onMessage(onWebSocketMessage); webSocket->onClose(onWebSocketClose); } else { Serial.println("Failed to start WebSocket server"); } } void loop() { // Then handle HTTP requests server.handleClient(); // Handle WebSocket server.handleWebSocket(); }
  1. Ändern Sie die WLAN-Daten (SSID und Passwort) im Code entsprechend Ihren eigenen Netzwerkzugangsdaten.
  2. Erstellen Sie die Datei index.h in der Arduino IDE wie folgt:
    • Klicken Sie entweder auf die Schaltfläche direkt unter dem Symbol des seriellen Monitors und wählen Sie New Tab, oder verwenden Sie die Tasten Ctrl+Shift+N.
    Datei in Arduino IDE 2 hinzufügen
    • Geben Sie als Dateinamen index.h ein und klicken Sie auf die Schaltfläche OK.
    Datei index.h in Arduino IDE 2 hinzufügen
    • Der folgende Code definiert die an den Browser ausgelieferte Webseite, einschließlich der Chat-Oberfläche und des JavaScript-Codes, der die WebSocket-Verbindung verwaltet. Kopieren Sie ihn und fügen Sie ihn in index.h ein.
    /* * 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-websocket */ const char *HTML_CONTENT = R"=====( <!DOCTYPE html> <!-- saved from url=(0019)http://192.168.0.2/ --> <html><head><meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> <title>ESP32 WebSocket</title> <meta name="viewport" content="width=device-width, initial-scale=0.7"> <link rel="icon" href="https://diyables.io/images/page/diyables.svg"> <style> /* Add some basic styling for the chat window */ body { font-size: 16px; } .chat-container { width: 400px; margin: 0 auto; padding: 10px; } .chat-messages { height: 250px; overflow-y: auto; border: 1px solid #444; padding: 5px; margin-bottom: 5px; } .user-input { display: flex; margin-bottom: 20px; } .user-input input { flex: 1; border: 1px solid #444; padding: 5px; } .user-input button { margin-left: 5px; background-color: #007bff; color: #fff; border: none; padding: 5px 10px; cursor: pointer; } .websocket { display: flex; align-items: center; margin-bottom: 5px; } .websocket button { background-color: #007bff; color: #fff; border: none; padding: 5px 10px; cursor: pointer; } .websocket .label { margin-left: auto; } </style> <script> var ws; var wsm_max_len = 4096; /* bigger length causes uart0 buffer overflow with low speed smart device */ function update_text(text) { var chat_messages = document.getElementById("chat-messages"); chat_messages.innerHTML += text + '<br>'; chat_messages.scrollTop = chat_messages.scrollHeight; } function send_onclick() { if(ws != null) { var message = document.getElementById("message").value; if (message) { document.getElementById("message").value = ""; ws.send(message + "\n"); update_text('<span style="color:navy">' + message + '</span>'); // You can send the message to the server or process it as needed } } } function connect_onclick() { if(ws == null) { ws = new WebSocket("ws://" + window.location.host + ":81"); document.getElementById("ws_state").innerHTML = "CONNECTING"; ws.onopen = ws_onopen; ws.onclose = ws_onclose; ws.onmessage = ws_onmessage; } else ws.close(); } function ws_onopen() { document.getElementById("ws_state").innerHTML = "<span style='color:blue'>CONNECTED</span>"; document.getElementById("bt_connect").innerHTML = "Disconnect"; document.getElementById("chat-messages").innerHTML = ""; } function ws_onclose() { document.getElementById("ws_state").innerHTML = "<span style='color:gray'>CLOSED</span>"; document.getElementById("bt_connect").innerHTML = "Connect"; ws.onopen = null; ws.onclose = null; ws.onmessage = null; ws = null; } function ws_onmessage(e_msg) { e_msg = e_msg || window.event; // MessageEvent console.log(e_msg.data); update_text('<span style="color:blue">' + e_msg.data + '</span>'); } </script> </head> <body> <div class="chat-container"> <h2>ESP32 WebSocket</h2> <div class="websocket"> <button class="connect-button" id="bt_connect" onclick="connect_onclick()">Connect</button> <span class="label">WebSocket: <span id="ws_state"><span style="color:blue">CLOSED</span></span></span> </div> <div class="chat-messages" id="chat-messages"></div> <div class="user-input"> <input type="text" id="message" placeholder="Type your message..."> <button onclick="send_onclick()">Send</button> </div> <div class="sponsor">Sponsored by <a href="https://amazon.com/diyables">DIYables</a></div> </div> </body></html> )=====";
    1. Jetzt haben Sie den Code in zwei Dateien: newbiely.com.ino und index.h.
    2. Klicken Sie in der Arduino IDE auf die Schaltfläche Upload, um den Code auf den ESP32 S3 hochzuladen.
    3. Öffnen Sie den seriellen Monitor und prüfen Sie die Ausgabe. Sie sollten Ausgaben ähnlich den folgenden sehen (die Zeitstempel dienen nur als Beispiel):
    ∞
    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 09:12:03] Connecting to WiFi... [2026-01-15 09:12:05] Connected to WiFi [2026-01-15 09:12:05] ESP32 S3 Web Server's IP address: 192.168.0.2 [2026-01-15 09:12:11] WebSocket client connected
    Ln 11, Col 1
    ESP32S3 Dev Module on COM15
    2
    1. Notieren Sie sich die angezeigte IP-Adresse und geben Sie sie in die Adressleiste eines Webbrowsers auf Ihrem Smartphone oder PC ein.
    2. Sie sehen die Webseite wie unten dargestellt:
    ESP32 S3 WebSocket im Webbrowser
    1. Klicken Sie auf die Schaltfläche CONNECT, um die Webseite über WebSocket mit dem ESP32 S3 zu verbinden.
    2. Geben Sie einige Wörter ein und senden Sie sie an den ESP32 S3.
    3. Sie sehen die Antwort des ESP32 S3.
    ESP32 S3 WebSocket-Chat-Server
    1. Profi-Tipp: Wenn Sie nur den HTML-Inhalt in index.h ändern, ohne newbiely.com.ino anzufassen, kompiliert die Arduino IDE das HTML möglicherweise nicht neu. Um eine Aktualisierung zu erzwingen, nehmen Sie vor dem Hochladen eine kleine Änderung in der .ino-Datei vor (z. B. eine Leerzeile oder einen Kommentar hinzufügen).

    ※ Notiz:

    • Wenn Sie den HTML-Inhalt in index.h ändern und nichts an der Datei newbiely.com.ino ändern, aktualisiert die Arduino IDE beim Kompilieren und Hochladen des Codes auf den ESP32 S3 den HTML-Inhalt nicht.
    • Damit die Arduino IDE den HTML-Inhalt in diesem Fall aktualisiert, nehmen Sie eine Änderung an der Datei newbiely.com.ino vor (z. B. eine Leerzeile oder einen Kommentar hinzufügen ...)

    Zeilenweise Code-Erklärung

    Der obige ESP32-S3-Code enthält eine zeilenweise Erklärung. Bitte lesen Sie die Kommentare im Code!

So funktioniert das System

Der ESP32-S3-Code erstellt sowohl einen Webserver als auch einen WebSocket-Server, sodass Browser und Board einen aktiven, bidirektionalen Kanal aufrechterhalten können. Der Ablauf ist wie folgt:

  • Wenn Sie die IP-Adresse des ESP32 S3 in einen Webbrowser eingeben, wird die Webseite (Benutzeroberfläche) vom ESP32 S3 angefordert.
  • Der Webserver des ESP32 S3 antwortet, indem er den Inhalt der Webseite (HTML, CSS, JavaScript) überträgt.
  • Anschließend zeigt Ihr Webbrowser die Webseite an.
  • Wenn Sie auf die Schaltfläche CONNECT klicken, baut der in die Webseite eingebettete JavaScript-Code eine WebSocket-Verbindung zum WebSocket-Server auf dem ESP32 S3 auf.
  • Sobald die WebSocket-Verbindung besteht und Sie etwas eingeben und auf die Schaltfläche SEND klicken, sendet der JavaScript-Code diesen Text im Hintergrund über die WebSocket-Verbindung an den ESP32 S3.
  • Nach dem Empfang der Nachricht sendet der WebSocket-Server eine Antwort an die Webseite zurück.

Praxisanwendungen

WebSocket ist die Grundlage für eine Vielzahl interaktiver ESP32-S3-Projekte, die eine latenzarme, kontinuierliche Kommunikation zwischen dem Board und einer browserbasierten Oberfläche erfordern.

  1. Fernsteuerung von Robotern: Bewegungsbefehle vom Browser an ein Roboterauto senden und Live-Sensordaten ohne Neuladen der Seite empfangen.
  2. Live-Sensor-Dashboard: Temperatur-, Luftfeuchtigkeits- oder Bewegungsdaten vom ESP32 S3 an ein Browser-Diagramm übertragen, das sich in Echtzeit aktualisiert.
  3. Smart-Home-Bedienfeld: Lampen, Lüfter und Relais von einer einzigen Webseite aus mit sofortiger Ein/Aus-Rückmeldung steuern.
  4. Industrielle Überwachung: Maschinenstatus, Fehlermeldungen und Zähler von Fabrikanlagen anzeigen, die mit dem ESP32 S3 verbunden sind.
  5. IoT-Mehrspielerspiele: Mehrere ESP32-S3-Geräte über einen gemeinsamen WebSocket-Server für synchronisierte interaktive Erlebnisse koordinieren.

Video-Tutorial

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

Herausforderungen

Sobald der grundlegende WebSocket-Chat funktioniert, können Sie ihn mit diesen Erweiterungen weiterentwickeln. Jede davon vertieft einen anderen Aspekt der Echtzeit-Webkommunikation mit dem ESP32 S3.

  1. Anfänger: Eine Schaltfläche auf der Webseite hinzufügen, die eine feste Befehlszeichenfolge (z. B. "LED_ON") an den ESP32 S3 sendet, und das Board diese mit einer Bestätigungsmeldung zurücksenden lassen.
  2. Fortgeschritten: Den ESP32-S3-Sketch so ändern, dass er jede Sekunde einen Zählerwert an alle verbundenen WebSocket-Clients sendet, und diesen als Live-Zahl auf der Webseite anzeigen.
  3. Experte: Eine passwortgeschützte WebSocket-Verbindung implementieren – der Browser muss als erste Nachricht ein geheimes Token senden, und der ESP32 S3 schließt die Verbindung, wenn das Token falsch ist.

Weitere ESP32-S3-WebSocket-Beispiele finden Sie hier:

※ 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!