ESP32 S3 - Contrôler une voiture via le Web

Ce guide vous montre comment utiliser l'ESP32 S3 pour contrôler sans fil une voiture robot depuis un navigateur web sur votre smartphone ou votre PC via WiFi. Le contrôle se fait via une interface web graphique utilisant WebSocket, permettant un contrôle fluide et en temps réel de la voiture depuis n'importe où sur votre réseau local.

ESP32 S3 voiture robot 2WD pilotée depuis un navigateur web avec le driver L9110S

Ce que vous allez construire :

  1. Une interface de contrôle web hébergée sur l'ESP32 S3 lui-même
  2. Une connexion WebSocket pour la transmission de commandes en temps réel et à faible latence
  3. Un système de contrôle moteur qui fait avancer, reculer, tourner à gauche et à droite une voiture RC 2WD
  4. Une interface accessible par navigateur qui fonctionne aussi bien sur smartphone que sur PC

À propos de la voiture RC 2WD et de WebSocket

La voiture RC 2WD est une plateforme robotique populaire composée de deux roues motrices indépendantes et d'une roulette pour l'équilibre, ce qui permet de contrôler facilement la direction grâce à des vitesses moteur différentielles. WebSocket est un protocole de communication qui établit une connexion bidirectionnelle persistante entre le navigateur web et l'ESP32 S3, éliminant le besoin de recharger la page à chaque envoi de commande. Ensemble, ces technologies vous permettent de construire une voiture contrôlée par le web, réactive et en temps réel, avec une latence minimale.

Spécifications clés

Nous avons des tutoriels spécifiques sur la voiture RC 2WD et WebSocket. Chaque tutoriel contient des informations détaillées et des instructions étape par étape sur le brochage matériel, le principe de fonctionnement, le câblage vers l'ESP32 S3, le code ESP32 S3... Apprenez-en plus à ces liens :

Comment ça fonctionne

Le code de l'ESP32 S3 crée à la fois un serveur web et un serveur WebSocket, permettant au navigateur d'afficher l'interface de contrôle et d'envoyer des commandes en temps réel sans recharger la page. Voici comment cela fonctionne :

  • Lorsque vous saisissez l'adresse IP de l'ESP32 S3 dans un navigateur web, celui-ci demande la page web (interface utilisateur) à l'ESP32 S3.
  • Le serveur web de l'ESP32 S3 répond en envoyant le contenu de la page web (HTML, CSS, JavaScript).
  • Votre navigateur web affiche alors la page web.
  • Le code JavaScript de la page web établit une connexion WebSocket vers le serveur WebSocket de l'ESP32 S3.
  • Une fois cette connexion WebSocket établie, si vous appuyez sur les boutons de la page web ou les relâchez, le code JavaScript envoie discrètement les commandes à l'ESP32 S3 via cette connexion WebSocket en arrière-plan.
  • Le serveur WebSocket de l'ESP32 S3, en recevant les commandes, contrôle la voiture robot en conséquence.

Le tableau suivant montre la liste des commandes que la page web envoie à l'ESP32 S3 en fonction des actions de l'utilisateur :

User's Action Button Command Car Action
APPUI HAUT 1 AVANCER
APPUI BAS 2 RECULER
APPUI GAUCHE 4 TOURNER À GAUCHE
APPUI DROITE 8 TOURNER À DROITE
APPUI STOP 0 ARRÊT
RELÂCHEMENT HAUT 0 ARRÊT
RELÂCHEMENT BAS 0 ARRÊT
RELÂCHEMENT GAUCHE 0 ARRÊT
RELÂCHEMENT DROITE 0 ARRÊT
RELÂCHEMENT STOP 0 ARRÊT

Schéma de câblage entre la voiture RC 2WD et l'ESP32 S3

Connectez les composants en suivant le schéma de câblage et les notes ci-dessous. Le driver moteur L9110S sert de pont entre les signaux logiques de l'ESP32 S3 et les moteurs à courant plus élevé de la voiture 2WD.

Schéma de câblage voiture RC 2WD ESP32 S3

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

Les fils mal branchés sont une cause fréquente de problèmes étranges. Vous pouvez placer la carte ESP32 S3 sur une carte à bornier à vis pour ESP32 S3 et brancher les fils sur ses borniers à vis. Voir le schéma ci-dessous pour la version avec borniers à vis.

Schéma de câblage voiture RC 2WD ESP32 S3 (Screw Terminal)

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

Une carte d'extension GPIO pour ESP32 S3 convient aussi. En plus des broches S, 3,3V et GND de chaque GPIO, elle a des broches 3,3V et 5V supplémentaires :

Schéma de câblage voiture RC 2WD ESP32 S3 (GPIO Breakout Board)

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

Voiture RC 2WD ESP32 S3 via le web

Notes de sécurité

Le module L9110S alimente directement les moteurs depuis ses broches VCC et GND et ne possède pas de régulateur 5V embarqué. Cela signifie que vous pouvez tout alimenter depuis une seule source d'alimentation — quatre piles AA de 1,5V (soit 6V au total). Voici comment procéder :

  • Connectez la batterie 6V aux broches VCC et GND du module L9110S pour alimenter les moteurs.
  • Connectez la même batterie 6V aux broches Vin et GND de l'ESP32 S3 pour alimenter la carte.
  • Assurez-vous que le module L9110S et l'ESP32 S3 partagent une masse (GND) commune.

Contrairement au L298N, le L9110S n'a pas de cavaliers d'activation ENA/ENB ni de bornier à vis 12V, ce qui rend le câblage plus simple.

Comme la voiture RC 2WD possède un interrupteur marche/arrêt, vous pouvez éventuellement connecter la batterie via cet interrupteur pour pouvoir allumer/éteindre l'alimentation de la voiture. Si vous voulez faire simple, ignorez simplement l'interrupteur.

Code ESP32 S3

Le code suivant est composé de deux fichiers. Le contenu de la page web (HTML, CSS, JavaScript) est stocké séparément dans un fichier index.h, ce qui garde le sketch principal propre et facile à maintenir. Ensemble, ces deux fichiers mettent en œuvre un serveur web, un serveur WebSocket et la logique de contrôle moteur.

  • Un fichier .ino qui est le code ESP32 S3, qui crée un serveur web et un serveur WebSocket, et contrôle la voiture
  • Un fichier .h, qui contient le contenu de la page web

Étapes rapides

  • Nouveau avec l'ESP32 S3 ? Complétez d'abord notre guide ESP32 S3 - Premiers pas.
  • Effectuez le câblage comme sur l'image ci-dessus.
  • Connectez la carte ESP32 S3 à votre PC via un câble USB Type-C
  • Ouvrez l'Arduino IDE sur votre PC.
  • Sélectionnez la bonne carte ESP32 S3 (par exemple ESP32S3 Dev Module) et le bon port COM.
  • Ouvrez le gestionnaire de bibliothèques en cliquant sur l'icône Library Manager dans la barre de navigation gauche de l'Arduino IDE.
  • Recherchez "DIYables ESP32 WebServer", puis trouvez la bibliothèque Web Server créée par DIYables.
  • 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
  • Sur l'Arduino IDE, créez un nouveau sketch, donnez-lui un nom, par exemple newbiely.com.ino
  • Copiez le code ci-dessous et ouvrez-le avec 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-controls-car-via-web */ #include <DIYables_ESP32_WebServer.h> #include "index.h" #define CMD_STOP 0 #define CMD_FORWARD 1 #define CMD_BACKWARD 2 #define CMD_LEFT 4 #define CMD_RIGHT 8 #define MOTOR_A_IA_PIN 18 // The ESP32 S3 pin GPIO18 connected to the A-IA pin of the L9110S (Motor A) #define MOTOR_A_IB_PIN 8 // The ESP32 S3 pin GPIO8 connected to the A-IB pin of the L9110S (Motor A) #define MOTOR_B_IA_PIN 9 // The ESP32 S3 pin GPIO9 connected to the B-IA pin of the L9110S (Motor B) #define MOTOR_B_IB_PIN 10 // The ESP32 S3 pin GPIO10 connected to the B-IB pin of the L9110S (Motor B) // 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) { server.sendResponse(client, HTML_CONTENT); // HTML_CONTENT is from index.h } // WebSocket event handlers void onWebSocketOpen(net::WebSocket& ws) { Serial.println("WebSocket client connected"); } void onWebSocketMessage(net::WebSocket& ws, const net::WebSocket::DataType dataType, const char* message, uint16_t length) { String angle = String(message); int command = angle.toInt(); Serial.print("command: "); Serial.println(command); switch (command) { case CMD_STOP: Serial.println("Stop"); CAR_stop(); break; case CMD_FORWARD: Serial.println("Move Forward"); CAR_moveForward(); break; case CMD_BACKWARD: Serial.println("Move Backward"); CAR_moveBackward(); break; case CMD_LEFT: Serial.println("Turn Left"); CAR_turnLeft(); break; case CMD_RIGHT: Serial.println("Turn Right"); CAR_turnRight(); break; default: Serial.println("Unknown command"); } } 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(115200); delay(1000); pinMode(MOTOR_A_IA_PIN, OUTPUT); pinMode(MOTOR_A_IB_PIN, OUTPUT); pinMode(MOTOR_B_IA_PIN, OUTPUT); pinMode(MOTOR_B_IB_PIN, OUTPUT); 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(); } void CAR_moveForward() { digitalWrite(MOTOR_A_IA_PIN, HIGH); digitalWrite(MOTOR_A_IB_PIN, LOW); digitalWrite(MOTOR_B_IA_PIN, HIGH); digitalWrite(MOTOR_B_IB_PIN, LOW); } void CAR_moveBackward() { digitalWrite(MOTOR_A_IA_PIN, LOW); digitalWrite(MOTOR_A_IB_PIN, HIGH); digitalWrite(MOTOR_B_IA_PIN, LOW); digitalWrite(MOTOR_B_IB_PIN, HIGH); } void CAR_turnLeft() { digitalWrite(MOTOR_A_IA_PIN, HIGH); digitalWrite(MOTOR_A_IB_PIN, LOW); digitalWrite(MOTOR_B_IA_PIN, LOW); digitalWrite(MOTOR_B_IB_PIN, LOW); } void CAR_turnRight() { digitalWrite(MOTOR_A_IA_PIN, LOW); digitalWrite(MOTOR_A_IB_PIN, LOW); digitalWrite(MOTOR_B_IA_PIN, HIGH); digitalWrite(MOTOR_B_IB_PIN, LOW); } void CAR_stop() { digitalWrite(MOTOR_A_IA_PIN, LOW); digitalWrite(MOTOR_A_IB_PIN, LOW); digitalWrite(MOTOR_B_IA_PIN, LOW); digitalWrite(MOTOR_B_IB_PIN, LOW); }
  • Modifiez les informations WiFi (SSID et mot de passe) dans le code pour qu'elles correspondent à vos propres identifiants réseau.
  • Créez le fichier index.h sur l'Arduino IDE en :
    • Cliquant sur le bouton situé 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 ajoute un fichier
    • Donnant au fichier le nom index.h et en cliquant sur le bouton OK
    Arduino IDE 2 ajoute le fichier 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-controls-car-via-web */ const char *HTML_CONTENT = R"=====( <!DOCTYPE html> <html> <head> <title>ESP32 S3 Control Car via Web</title> <meta name="viewport" content="width=device-width, initial-scale=0.7, maximum-scale=1, user-scalable=no"> <style type="text/css"> body { text-align: center; font-size: 24px;} button { text-align: center; font-size: 24px;} #container { margin-right: auto; margin-left: auto; width: 400px; height: 400px; position: relative; margin-bottom: 10px; } div[class^='button'] { position: absolute; } .button_up, .button_down { width:214px; height:104px;} .button_left, .button_right { width:104px; height:214px;} .button_stop { width:178px; height:178px;} .button_up { background: url('https://newbiely.com/images/tutorial/up_inactive.png') no-repeat; background-size: contain; left: 200px; top: 0px; transform: translateX(-50%); } .button_down { background: url('https://newbiely.com/images/tutorial/down_inactive.png') no-repeat; background-size: contain; left:200px; bottom: 0px; transform: translateX(-50%); } .button_right { background: url('https://newbiely.com/images/tutorial/right_inactive.png') no-repeat; background-size: contain; right: 0px; top: 200px; transform: translateY(-50%); } .button_left { background: url('https://newbiely.com/images/tutorial/left_inactive.png') no-repeat; background-size: contain; left:0px; top: 200px; transform: translateY(-50%); } .button_stop { background: url('https://newbiely.com/images/tutorial/stop_inactive.png') no-repeat; background-size: contain; left:200px; top: 200px; transform: translate(-50%, -50%); } </style> <script> var CMD_STOP = 0; var CMD_FORWARD = 1; var CMD_BACKWARD = 2; var CMD_LEFT = 4; var CMD_RIGHT = 8; var img_name_lookup = { [CMD_STOP]: "stop", [CMD_FORWARD]: "up", [CMD_BACKWARD]: "down", [CMD_LEFT]: "left", [CMD_RIGHT]: "right" } var ws = null; function init() { var container = document.querySelector("#container"); container.addEventListener("touchstart", mouse_down); container.addEventListener("touchend", mouse_up); container.addEventListener("touchcancel", mouse_up); container.addEventListener("mousedown", mouse_down); container.addEventListener("mouseup", mouse_up); container.addEventListener("mouseout", mouse_up); } function ws_onmessage(e_msg) { e_msg = e_msg || window.event; // MessageEvent //alert("msg : " + e_msg.data); } function ws_onopen() { document.getElementById("ws_state").innerHTML = "OPEN"; document.getElementById("wc_conn").innerHTML = "Disconnect"; } function ws_onclose() { document.getElementById("ws_state").innerHTML = "CLOSED"; document.getElementById("wc_conn").innerHTML = "Connect"; console.log("socket was closed"); ws.onopen = null; ws.onclose = null; ws.onmessage = null; ws = null; } function wc_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 mouse_down(event) { if (event.target !== event.currentTarget) { var id = event.target.id; send_command(id); event.target.style.backgroundImage = "url('https://newbiely.com/images/tutorial/" + img_name_lookup[id] + "_active.png')"; } event.stopPropagation(); event.preventDefault(); } function mouse_up(event) { if (event.target !== event.currentTarget) { var id = event.target.id; send_command(CMD_STOP); event.target.style.backgroundImage = "url('https://newbiely.com/images/tutorial/" + img_name_lookup[id] + "_inactive.png')"; } event.stopPropagation(); event.preventDefault(); } function send_command(cmd) { if(ws != null) if(ws.readyState == 1) ws.send(cmd + "\r\n"); } window.onload = init; </script> </head> <body> <h2>ESP32 S3 - RC Car via Web</h2> <div id="container"> <div id="0" class="button_stop"></div> <div id="1" class="button_up"></div> <div id="2" class="button_down"></div> <div id="8" class="button_right"></div> <div id="4" class="button_left"></div> </div> <p> WebSocket : <span id="ws_state" style="color:blue">closed</span><br> </p> <button id="wc_conn" type="button" onclick="wc_onclick();">Connect</button> <br> <br> <div class="sponsor">Sponsored by <a href="https://amazon.com/diyables">DIYables</a></div> </body> </html> )=====";
    • Vous avez maintenant le code dans deux fichiers : newbiely.com.ino et index.h
    • Cliquez sur le bouton Upload de l'Arduino IDE pour téléverser le code sur l'ESP32 S3
    • Ouvrez le Moniteur Série
    • Consultez le résultat dans le Moniteur Série.
    ∞
    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
    • Notez l'adresse IP affichée, et saisissez cette adresse dans la barre d'adresse d'un navigateur web sur votre smartphone ou votre PC.
    • Vous verrez la page web suivante :
    L'ESP32 S3 contrôle une voiture via un navigateur web
    • Le code JavaScript de la page web crée automatiquement la connexion WebSocket vers l'ESP32 S3.
    • Vous pouvez maintenant contrôler la voiture pour tourner à gauche/droite, avancer/reculer via l'interface web.

    Pour économiser la mémoire de l'ESP32 S3, les images des boutons de contrôle ne sont PAS stockées sur l'ESP32 S3. Elles sont plutôt stockées sur internet, donc votre téléphone ou votre PC doit avoir une connexion internet pour charger les images de la page de contrôle web.

    ※ Note:

    • Si vous modifiez le contenu HTML dans le fichier index.h et que vous ne touchez à rien dans le fichier newbiely.com.ino, lorsque vous compilez et téléversez le code sur l'ESP32 S3, l'Arduino IDE ne mettra pas à jour le contenu HTML.
    • Pour forcer l'Arduino IDE à mettre à jour le contenu HTML dans ce cas, apportez une modification au fichier newbiely.com.ino (par exemple, ajoutez une ligne vide, ajoutez un commentaire...)

    Astuce pro : Si la voiture ne se déplace pas correctement après le câblage, essayez d'inverser les connexions des fils moteur sur le module L9110S — inverser la polarité d'un moteur change son sens de rotation sans nécessiter de modification du code.

    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 Moniteur Série

Après avoir téléversé le code et ouvert le Moniteur Série à 115200 bauds, vous devriez voir une sortie similaire aux relevés suivants pendant que l'ESP32 S3 se connecte au WiFi et traite les commandes WebSocket entrantes.

∞
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

Applications

Les voitures robots contrôlées par le web construites avec l'ESP32 S3 constituent une base polyvalente pour d'innombrables applications concrètes et éducatives.

  1. Robot de surveillance domestique : Montez une caméra sur la voiture et diffusez la vidéo en direct tout en naviguant dans les pièces à distance.
  2. Robot d'inspection d'entrepôt : Parcourez les allées d'un site pour inspecter l'inventaire ou détecter des dangers sans présence physique.
  3. Plateforme robotique éducative : Enseignez aux élèves les technologies web, le réseau et le contrôle moteur dans un format pratique et engageant.
  4. Robot de patrouille de sécurité : Programmez la voiture pour suivre des itinéraires de patrouille définis et alerter les utilisateurs en cas de détection de mouvement.
  5. Véhicule de surveillance agricole : Naviguez dans les rangées d'une serre pour surveiller la santé des plantes ou les relevés d'un capteur d'humidité du sol.

Vidéo tutoriel

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

Défis

Une fois que votre voiture contrôlée par le web avec l'ESP32 S3 fonctionne, essayez d'étendre le projet avec ces défis progressifs pour approfondir votre compréhension du réseau, du contrôle moteur et du développement web embarqué.

  1. Débutant : Ajoutez un curseur de contrôle de vitesse à l'interface web qui ajuste le rapport cyclique PWM envoyé aux broches d'entrée du moteur du L9110S.
  2. Intermédiaire : Affichez la direction et la vitesse actuelles de la voiture sur la page web en temps réel à l'aide de messages WebSocket envoyés par l'ESP32 S3 vers le navigateur.
  3. Avancé : Ajoutez un capteur à ultrasons à la voiture et mettez en œuvre un évitement automatique d'obstacles qui remplace les commandes web lorsqu'un objet est détecté à moins de 20 cm.

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