ESP32 S3 - Matrice de LED via le web

Les affichages à matrice de LED associés à une interface web Wi-Fi créent une combinaison puissante pour la signalétique à distance et les panneaux de messages en temps réel. Dans ce tutoriel, vous apprendrez à programmer l'ESP32 S3 pour qu'il agisse comme un serveur web compatible WebSocket qui accepte des messages texte depuis n'importe quel navigateur et les fait défiler immédiatement sur un affichage à matrice de LED connecté.

Ce que vous allez construire :

  1. Un serveur web ESP32 S3 qui sert une page de contrôle basée sur navigateur via Wi-Fi
  2. Une connexion WebSocket qui permet aux utilisateurs de taper et d'envoyer des messages depuis un navigateur en temps réel
  3. Un affichage à matrice de LED qui montre le message reçu dès que l'ESP32 S3 le reçoit
  4. Un sketch Arduino complet avec un fichier HTML/CSS/JavaScript compagnon pour l'interface web
ESP32 S3 - Matrice de LED via le web

À propos de la matrice de LED et du serveur web

L'ESP32 S3 peut héberger simultanément une interface web complète et un serveur WebSocket, en utilisant son Wi-Fi intégré pour recevoir des messages depuis n'importe quel navigateur sur le même réseau. Bien qu'une simple requête HTTP POST puisse être utilisée pour envoyer du texte à la carte, WebSocket rend la communication instantanée et réactive — le navigateur reste connecté et l'ESP32 S3 reçoit chaque message avec une latence minimale, sans le coût d'ouvrir une nouvelle connexion HTTP chaque fois.

Concepts clés

  • WebSocket fournit une connexion persistante et bidirectionnelle entre le navigateur et l'ESP32 S3
  • L'ESP32 S3 agit à la fois comme serveur web (servant la page HTML) et serveur WebSocket (recevant les messages)
  • Les messages reçus sont transmis directement à la matrice de LED pour l'affichage

Pour en savoir plus sur les composants individuels impliqués, voir ces tutoriels compagnons :

Schéma de câblage

Connectez les broches d'entrée de la matrice de LED à l'ESP32 S3 en utilisant l'interface SPI comme indiqué dans le schéma ci-dessous, en vous assurant que l'alimentation peut gérer la consommation de courant de l'affichage.

Notes de sécurité

La matrice de LED FC-16 peut consommer jusqu'à 1A à la luminosité maximale quand toutes les LED sont allumées. Ne comptez pas uniquement sur la broche 5V intégrée de l'ESP32 S3 pour alimenter l'affichage — utilisez une alimentation 5V externe et faites partager la même masse d'alimentation entre l'ESP32 S3 et la matrice de LED.

Connexions de câblage (ESP32 S3 → broches d'entrée de la matrice de LED) :

  • 5V : VCC
  • GND : GND
  • GPIO38 : CLK (horloge)
  • GPIO40 : DIN (entrée de données)
  • GPIO39 : CS (sélection de puce)
ESP32 S3 LED matrix display wiring diagram

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

Code ESP32 S3

Le sketch est divisé en deux fichiers pour garder l'interface web séparée de la logique de la carte. Le fichier principal .ino configure la connexion Wi-Fi, instancie le serveur web et le serveur WebSocket, et pilote la matrice de LED. Le fichier compagnon index.h contient le HTML, le CSS et le JavaScript pour la page de contrôle dans le navigateur. Le code suivant montre les deux fichiers — téléversez-les ensemble depuis l'Arduino IDE.

/* * 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-led-matrix-via-web */ /* * 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-led-matrix-via-web */ #include <DIYables_ESP32_WebServer.h> #include "index.h" #include <MD_Parola.h> #include <MD_MAX72xx.h> #define HARDWARE_TYPE MD_MAX72XX::FC16_HW #define MAX_DEVICES 4 // 4 blocks #define CLK_PIN 38 // ESP32-S3 pin GPIO38 connected to CLK #define DATA_PIN 40 // ESP32-S3 pin GPIO40 connected to DIN #define CS_PIN 39 // ESP32-S3 pin GPIO39 connected to CS // 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; // create an instance of the MD_Parola class MD_Parola ledMatrix = MD_Parola(HARDWARE_TYPE, DATA_PIN, CLK_PIN, CS_PIN, MAX_DEVICES); // Web Page handlers void handleHome(WiFiClient& client, const String& method, const String& request, const QueryParams& params, const String& jsonData) { 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); ledMatrix.displayClear(); // clear led matrix display ledMatrix.displayScroll(message, PA_CENTER, PA_SCROLL_LEFT, 100); // Broadcast response to all connected clients using the library if (webSocket != nullptr) { String response = "Displayed: " + String(message) + "on LED Matrix"; 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"); ledMatrix.begin(); // initialize the object ledMatrix.setIntensity(15); // set the brightness of the LED matrix display (from 0 to 15) ledMatrix.displayClear(); // clear led matrix display ledMatrix.displayScroll("esp32io.com", PA_CENTER, PA_SCROLL_LEFT, 100); // 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(); if (ledMatrix.displayAnimate()) { ledMatrix.displayReset(); } }

Étapes rapides

  1. Nouveau sur ESP32 S3 ? Complétez d'abord notre guide ESP32 S3 - Premiers pas.
  2. Faites le câblage comme indiqué dans le schéma ci-dessus.
  3. Connectez la carte ESP32 S3 à votre PC via un câble USB Type-C.
  4. Ouvrez l'Arduino IDE sur votre PC.
  5. Sélectionnez la bonne carte ESP32 S3 (par ex. ESP32S3 Dev Module) et le port COM.
How to upload ESP32 S3 code on Arduino IDE
  1. Ouvrez le Library Manager en cliquant sur l'icône Library Manager dans la barre de navigation gauche de l'Arduino IDE.
  2. Recherchez "DIYables ESP32 WebServer", puis trouvez la bibliothèque Web Server créée par DIYables.
  3. 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. Recherchez "MD_Parola", puis trouvez la bibliothèque MD_Parola.
  2. Cliquez sur le bouton Install.
  • Search for MD_Parola created by majicDesigns 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
MD_Parola by majicDesigns
Implemented using the MD_MAX72xx library for hardware control. Provides functions to simplify the implementation of text special effects on the LED matrix. More info
3.7.2
INSTALL
Newbiely.ino
···
1 void setup() {
Output
Serial Monitor
Ln 1, Col 1
ESP32S3 Dev Module on COM15
1
  1. Il vous sera demandé d'installer la bibliothèque "MD_MAX72XX".
  2. Cliquez sur le bouton Install All pour installer la dépendance.
  3. Sur l'Arduino IDE, créez un nouveau sketch et donnez-lui un nom, par exemple, newbiely.com.ino.
  4. Copiez le code ci-dessus et ouvrez-le avec l'Arduino IDE.
  5. Créez le fichier index.h dans l'Arduino IDE en :
    • Cliquant sur le bouton juste en dessous de l'icône du moniteur série et en choisissant New Tab, ou en utilisant les touches Ctrl+Shift+N.
    Arduino IDE 2 adds file
    • Donnant au fichier le nom index.h et en cliquant sur le bouton OK.
    Arduino IDE 2 adds file index.h
    • Copiant le code ci-dessous et en le collant dans index.h.
    /* * 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-led-matrix-via-web */ 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. Vous avez maintenant le code dans deux fichiers : newbiely.com.ino et index.h.
    2. Mettez à jour YOUR_WIFI_SSID et YOUR_WIFI_PASSWORD dans le sketch avec les identifiants de votre réseau.
    3. Cliquez sur le bouton Upload dans l'Arduino IDE pour téléverser le code sur l'ESP32 S3.
    4. Ouvrez le Serial Monitor et vérifiez la sortie.
    5. Notez l'adresse IP affichée dans le Serial Monitor, puis saisissez-la dans la barre d'adresse d'un navigateur sur votre smartphone ou PC.
    6. Cliquez sur le bouton CONNECT pour établir une connexion WebSocket vers l'ESP32 S3.
    7. Tapez un message et envoyez-le à l'ESP32 S3 — vous le verrez défiler sur la matrice de LED.
    ESP32 S3 LED matrix web interface

    ※ Note:

    • Si vous modifiez le contenu HTML dans index.h et ne touchez à rien dans le fichier newbiely.com.ino, l'Arduino IDE peut ne pas mettre à jour le contenu HTML quand vous compilez et téléversez.
    • Pour forcer l'Arduino IDE à mettre à jour le contenu HTML dans ce cas, faites un petit changement dans le fichier newbiely.com.ino (par exemple, ajoutez une ligne vide ou un commentaire).

    Explication du code ligne par ligne

    Le code ESP32 S3 ci-dessus contient une explication ligne par ligne. Veuillez lire les commentaires dans le code !

Sortie du Serial Monitor

Ouvrez le Serial Monitor à 115200 bauds pour observer les événements de connexion et de messagerie de l'ESP32 S3. Les relevés suivants montrent une sortie typique pendant le démarrage et quand un client web envoie un message :

  1. [2026-06-16 09:00:01] Connecting to WiFi...
  2. [2026-06-16 09:00:04] Connected to WiFi. IP address: 192.168.0.2
  3. [2026-06-16 09:00:10] WebSocket client connected
  4. [2026-06-16 09:00:15] Message received: "Hello World" — displaying on LED matrix

Applications

Les affichages à matrice de LED contrôlés par le web sont bien adaptés aux scénarios où les messages doivent être mis à jour à distance sans accès physique au matériel. Voici quelques applications courantes :

  1. Panneau d'annonces de bureau : Publiez des rappels de réunion, des notifications de visiteurs, ou des annonces d'entreprise depuis n'importe quel appareil sur le réseau Wi-Fi du bureau.
  2. Affichage promotionnel de magasin : Mettez à jour les messages promotionnels ou les informations de prix sur une enseigne LED en magasin en temps réel sans toucher au matériel.
  3. Panneau de décompte d'événement : Envoyez des messages sensibles au temps, tels que les heures de début de session ou les mises à jour de l'état de la file d'attente, depuis une tablette de gestion d'événement.
  4. Indicateur d'état IoT : Affichez l'état actuel d'un système connecté — comme la santé d'un serveur ou des alertes de capteurs — en envoyant du texte d'état depuis un service backend.
  5. Affichage de salle de classe ou de laboratoire : Permettez à un enseignant de diffuser des instructions ou des rappels sur une enseigne LED de classe depuis un ordinateur portable sans quitter l'avant de la salle.

Vidéo

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

Défis

Ces défis vous aideront à étendre le projet de matrice de LED contrôlée par le web et à approfondir votre compréhension de la communication WebSocket et du contrôle d'affichage sur l'ESP32 S3.

  1. Débutant : Changez la vitesse de défilement de la matrice de LED en ajoutant un curseur à l'interface web qui permet à l'utilisateur d'ajuster la vitesse de défilement et envoie la nouvelle valeur de vitesse à l'ESP32 S3 via WebSocket.
  2. Intermédiaire : Ajoutez un contrôle de luminosité à l'interface web qui ajuste la valeur setIntensity() sur l'ESP32 S3 en temps réel, permettant aux utilisateurs de baisser l'affichage à distance.
  3. Avancé : Étendez le système pour prendre en charge plusieurs cartes ESP32 S3 connectées à différents affichages à matrice de LED, en diffusant le même message à toutes les cartes simultanément depuis une seule interface web.

Tutoriels connexes

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