NodeMCU ESP8266 : brochage, Arduino IDE et serveur web Wi-Fi

Le NodeMCU est une carte de développement bon marché qui associe la puce ESP8266 compatible Wi-Fi à une connexion USB, un régulateur 3,3 V et des broches adaptées à la breadboard. Tu la programmes avec les mêmes commandes que dans l'Arduino IDE, et à elle seule elle peut rejoindre ton réseau domestique et servir une page web que tu ouvres sur ton téléphone. Si tu veux mettre un capteur de température en ligne, commander un relais depuis ton téléphone ou piloter un ruban LED à la maison, le NodeMCU ESP8266 est l'un des points de départ les moins chers.

Dans ce guide, tu verras pas à pas les caractéristiques du NodeMCU, la correspondance déroutante entre D1–D8 et GPIO, les broches qui influencent le démarrage de la carte, l'installation dans l'Arduino IDE, la connexion au Wi-Fi et un serveur web qui allume une LED depuis ton téléphone. Dans les dernières sections, tu trouveras les différences entre l'ESP8266 et l'ESP32 ainsi que les solutions aux erreurs les plus fréquentes.

Que sont l'ESP8266 et le NodeMCU ?

L'ESP8266 est un microcontrôleur 32 bits avec Wi-Fi intégré qu'Espressif a lancé en 2014. Grâce à son prix très bas, il a popularisé les projets Wi-Fi dans le monde des makers. Le nom NodeMCU désignait à l'origine un firmware basé sur Lua écrit pour cette puce, ainsi que sa carte de développement open source ; aujourd'hui, il sert de nom générique aux cartes équipées du module ESP-12E. On ne la programme presque plus en Lua : la plupart utilisent l'Arduino IDE ou MicroPython.

On trouve deux versions courantes du NodeMCU. La V2 (Amica) est étroite, utilise un convertisseur USB-série CP2102 et laisse une rangée de trous libres de chaque côté une fois enfichée dans la breadboard. La V3 (LoLin) est plus large, utilise un CH340G et recouvre presque entièrement une breadboard standard ; avec une V3, il est donc bien plus pratique de placer deux breadboards côte à côte. Les deux versions ont le même brochage et exécutent le même code. Si tu veux une carte plus petite, la Wemos D1 Mini embarque la même puce et fonctionne avec les mêmes programmes.

Brochage du NodeMCU : correspondance D1–D8 et GPIO

Le point le plus déroutant du NodeMCU, c'est que les repères D imprimés sur la carte ne correspondent pas aux vrais numéros GPIO de la puce. Par exemple, la broche marquée D1 est en réalité le GPIO 5. Si tu sélectionnes la carte NodeMCU dans l'Arduino IDE, tu peux écrire D1 dans ton code et le compilateur le transforme automatiquement en 5 ; mais si tu écris digitalWrite(1, HIGH), tu pilotes le GPIO 1, c'est-à-dire la broche TX du port série. En MicroPython, on utilise toujours le numéro GPIO.

D'après ce tableau, les broches que tu peux utiliser sans crainte dans tes premiers projets sont D1, D2, D5, D6 et D7. D3, D4 et D8 déterminent en revanche le mode de démarrage : à la mise sous tension, l'ESP8266 lit les niveaux de GPIO 0, GPIO 2 et GPIO 15 et, pour un démarrage normal, attend GPIO 0 et GPIO 2 à HIGH et GPIO 15 à LOW. Si un bouton, un relais ou un capteur branché sur ces broches modifie le niveau au démarrage, la carte démarre en mode téléversement au lieu de lancer ton programme, ou ne démarre pas du tout. D3 et D4 restent utilisables pour des boutons, car un bouton n'est pas enfoncé au démarrage ; garde en revanche loin de ces broches les modules dont la sortie est à LOW.

La broche A0 est elle aussi un cas particulier : l'entrée analogique de la puce ESP8266 ne mesure que 0 à 1 V, mais grâce au pont diviseur de 220 kΩ et 100 kΩ présent sur la carte NodeMCU, tu peux appliquer environ 0 à 3,2 V sur A0, et analogRead(A0) renvoie cette plage sous forme de 0 à 1023. Comme il n'y a qu'une seule entrée analogique, tu auras besoin d'un CAN I2C comme l'ADS1115 pour utiliser plusieurs capteurs analogiques. Les broches D1 et D2 forment le bus I2C par défaut ; tu trouveras les bases de l'I2C dans Qu'est-ce que l'I2C ?.

Installer l'ESP8266 dans l'Arduino IDE

1. Dans l'Arduino IDE, ouvre Fichier > Préférences et ajoute https://arduino.esp8266.com/stable/package_esp8266com_index.json dans le champ « URL de gestionnaire de cartes supplémentaires ».
2. Ouvre Outils > Type de carte > Gestionnaire de cartes, cherche esp8266 et installe le paquet ESP8266 Community.
3. Dans le menu Outils > Type de carte, choisis NodeMCU 1.0 (ESP-12E Module). Pour une Wemos D1 Mini, choisis plutôt LOLIN(WEMOS) D1 R2 & mini.
4. Branche la carte avec un câble de données et sélectionne son port dans Outils > Port. Si aucun port n'apparaît, installe le pilote CH340 pour les cartes V3 ou le pilote CP2102 pour les cartes V2.
5. Laisse Upload Speed à 115200 ; une fois les téléversements fiables, tu peux passer à 921600 pour aller plus vite.

Premier programme : faire clignoter la LED intégrée

Sur le NodeMCU, le module ESP-12E porte une LED bleue reliée au GPIO 2 (D4) ; les cartes V2 (Amica) ont une seconde LED sur D0. Ces LED fonctionnent en logique inversée : elles s'allument quand la broche est à LOW et s'éteignent à HIGH. Dans le cœur Arduino, la constante LED_BUILTIN est déjà définie à 2 :

1// NodeMCU dahili LED'i: GPIO2 (D4), ters mantık / onboard LED: GPIO2 (D4), inverted logic
2
3void setup() {
4  pinMode(LED_BUILTIN, OUTPUT);
5}
6
7void loop() {
8  digitalWrite(LED_BUILTIN, LOW);    // LOW = yanar / LOW = on
9  delay(500);
10  digitalWrite(LED_BUILTIN, HIGH);   // HIGH = söner / HIGH = off
11  delay(500);
12}

Se connecter au Wi-Fi

Le vrai point fort de l'ESP8266, c'est le Wi-Fi. Le programme ci-dessous connecte la carte à ton réseau domestique en mode station et affiche dans le moniteur série l'adresse IP attribuée par la box ainsi que la force du signal. S'il ne parvient pas à se connecter en 20 secondes, il arrête d'attendre et affiche un avertissement. Remplace le nom du réseau et le mot de passe par les tiens, puis ouvre le moniteur série à 115200 bauds :

1#include <ESP8266WiFi.h>
2
3const char* ssid = "AgAdi";          // Wi-Fi adın / your Wi-Fi name
4const char* password = "Sifre123";   // Wi-Fi şifren / your Wi-Fi password
5
6void setup() {
7  Serial.begin(115200);
8  Serial.println();
9  WiFi.mode(WIFI_STA);               // istemci modu / station mode
10  WiFi.begin(ssid, password);
11  Serial.print("Baglaniyor / connecting");
12  unsigned long start = millis();
13  while (WiFi.status() != WL_CONNECTED) {
14    delay(500);
15    Serial.print('.');
16    if (millis() - start > 20000) {  // 20 sn'de bağlanamazsa / give up after 20 s
17      Serial.println("\nBaglanamadi, ag adini ve sifreyi kontrol et / failed, check SSID and password");
18      return;
19    }
20  }
21  Serial.println();
22  Serial.print("IP: ");
23  Serial.println(WiFi.localIP());    // modemin verdiği adres / address given by the router
24  Serial.print("Sinyal / RSSI: ");
25  Serial.print(WiFi.RSSI());         // -50 iyi, -80 zayıf / -50 good, -80 weak
26  Serial.println(" dBm");
27}
28
29void loop() {
30}

Piloter une LED depuis ton téléphone : un serveur web simple

Transformons maintenant le NodeMCU en petit serveur web. Branche une LED sur la broche D1 (GPIO 5) avec une résistance de 220 Ω : la patte longue de la LED va à D1 via la résistance, la patte courte à GND. Pour une LED rouge, cette résistance donne un courant de (3,3 V − 2 V) / 220 Ω ≈ 6 mA, bien en dessous de la limite de la broche ; pour calculer la valeur adaptée à ta LED, utilise le Calculateur de résistance pour LED. Après le téléversement, ouvre l'adresse affichée dans le moniteur série dans le navigateur d'un téléphone connecté au même Wi-Fi.

1#include <ESP8266WiFi.h>
2#include <ESP8266WebServer.h>
3#include <ESP8266mDNS.h>
4
5const char* ssid = "AgAdi";          // Wi-Fi adın / your Wi-Fi name
6const char* password = "Sifre123";   // Wi-Fi şifren / your Wi-Fi password
7
8const int LED_PIN = D1;              // GPIO5, 220 ohm direnç ile LED / LED through a 220 ohm resistor
9bool ledOn = false;
10
11ESP8266WebServer server(80);
12
13void handleRoot() {
14  String html = "<!DOCTYPE html><html><head><meta charset='utf-8'>"
15                "<meta name='viewport' content='width=device-width,initial-scale=1'>"
16                "<title>NodeMCU</title></head>"
17                "<body style='font-family:sans-serif;text-align:center'>"
18                "<h1>NodeMCU LED</h1><p>LED: <b>";
19  html += ledOn ? "ACIK / ON" : "KAPALI / OFF";
20  html += "</b></p><p>A0: ";
21  html += analogRead(A0);            // 0-1023 arası analog değer / analog value 0-1023
22  html += "</p><p><a href='/on'><button>AC / ON</button></a> "
23          "<a href='/off'><button>KAPAT / OFF</button></a></p></body></html>";
24  server.send(200, "text/html", html);
25}
26
27void setLed(bool on) {
28  ledOn = on;
29  digitalWrite(LED_PIN, on ? HIGH : LOW);
30  server.sendHeader("Location", "/");   // ana sayfaya yönlendir / redirect to the main page
31  server.send(303, "text/plain", "");
32}
33
34void setup() {
35  pinMode(LED_PIN, OUTPUT);
36  digitalWrite(LED_PIN, LOW);
37  Serial.begin(115200);
38  WiFi.mode(WIFI_STA);
39  WiFi.begin(ssid, password);
40  while (WiFi.status() != WL_CONNECTED) {
41    delay(500);
42    Serial.print('.');
43  }
44  Serial.println();
45  Serial.print("Tarayicida ac / open in browser: http://");
46  Serial.println(WiFi.localIP());
47
48  if (MDNS.begin("nodemcu")) {       // http://nodemcu.local adresi / address http://nodemcu.local
49    MDNS.addService("http", "tcp", 80);
50  }
51
52  server.on("/", handleRoot);
53  server.on("/on", []() { setLed(true); });
54  server.on("/off", []() { setLed(false); });
55  server.onNotFound([]() { server.send(404, "text/plain", "Bulunamadi / not found"); });
56  server.begin();
57}
58
59void loop() {
60  server.handleClient();             // gelen istekleri işle / handle incoming requests
61  MDNS.update();
62}

Si la page ne s'ouvre pas, vérifie que ton téléphone est connecté au même réseau Wi-Fi que le NodeMCU, et non à un réseau invité ou aux données mobiles. Le nom nodemcu.local fonctionne généralement sur les ordinateurs et les iPhone ; certains téléphones Android ne gèrent pas le mDNS, il te faudra alors l'adresse IP. Si tu branches un module relais à la place de la LED, le même code te permet de commander une vraie lampe ; tous les détails sont dans Qu'est-ce qu'un module relais ?.

Mode point d'accès (AP) : connexion sans box

S'il n'y a pas de Wi-Fi à proximité, le NodeMCU peut créer son propre réseau. En mode point d'accès, tu connectes ton téléphone directement au réseau NodeMCU-AP, et la carte répond généralement à l'adresse 192.168.4.1. Ce mode est idéal pour un système d'arrosage au jardin ou un appareil de mesure utilisé sur le terrain. Pour combiner le serveur web précédent avec ce mode, il suffit d'utiliser les lignes softAP à la place des lignes WiFi.begin ; le mode WIFI_AP_STA assure les deux rôles à la fois. Le mot de passe doit compter au moins 8 caractères, sinon le réseau n'est pas créé.

1#include <ESP8266WiFi.h>
2
3void setup() {
4  Serial.begin(115200);
5  WiFi.mode(WIFI_AP);                            // kendi ağını kur / create its own network
6  bool ok = WiFi.softAP("NodeMCU-AP", "12345678"); // ad ve en az 8 karakter şifre / name and 8+ char password
7  Serial.println(ok ? "AP hazir / AP ready" : "AP hatasi / AP error");
8  Serial.print("IP: ");
9  Serial.println(WiFi.softAPIP());               // genellikle 192.168.4.1 / usually 192.168.4.1
10}
11
12void loop() {
13  Serial.print("Bagli cihaz / stations: ");
14  Serial.println(WiFi.softAPgetStationNum());
15  delay(3000);
16}

L'ESP8266 avec MicroPython

En plus du langage Arduino, le NodeMCU peut aussi se programmer en MicroPython. Une fois le firmware MicroPython flashé sur la carte avec esptool, tu exécutes du code Python directement depuis un éditeur comme Thonny. Comme la mémoire de l'ESP8266 est limitée, les gros programmes MicroPython peuvent provoquer des erreurs de mémoire ; pour des projets Wi-Fi et capteurs simples, c'est néanmoins très pratique. Attention : en MicroPython, le numéro de broche est le GPIO, pas le repère D :

1import network, time
2from machine import Pin
3
4led = Pin(2, Pin.OUT)                     # D4 = GPIO2, dahili LED / onboard LED
5wlan = network.WLAN(network.STA_IF)
6wlan.active(True)
7wlan.connect("AgAdi", "Sifre123")         # Wi-Fi adı ve şifresi / Wi-Fi name and password
8
9while not wlan.isconnected():
10    time.sleep(0.5)
11print("IP:", wlan.ifconfig()[0])
12
13while True:
14    led.value(not led.value())            # ters mantık: 0 = yanar / inverted: 0 = on
15    time.sleep(0.5)

ESP8266 ou ESP32 ?

En résumé, l'ESP8266 reste largement suffisant pour envoyer les données d'un capteur sur internet, commander un relais depuis ton téléphone ou servir une page web simple, et il coûte moins cher. Pour les nouveaux projets qui demandent du Bluetooth, de nombreuses entrées analogiques, une caméra, beaucoup de puissance de calcul ou plusieurs tâches en parallèle, l'ESP32 est le meilleur choix. Le code se transpose facilement : il suffit souvent d'écrire WiFi.h au lieu de ESP8266WiFi.h, WebServer.h au lieu de ESP8266WebServer.h et ESPmDNS.h au lieu de ESP8266mDNS.h, de supprimer la ligne MDNS.update() (absente sur l'ESP32) et d'utiliser les numéros GPIO au lieu des repères de carte comme D1. Pour en savoir plus, lis Qu'est-ce que l'ESP32 ? et Arduino ou ESP32 ?.

Alimentation et sommeil profond

Le NodeMCU s'alimente en 5 V par l'USB ou la broche VIN, et le régulateur de la carte abaisse cette tension à 3,3 V. Le pic de 170 mA pendant l'émission Wi-Fi peut faire chuter la tension sur un port USB faible ou avec un câble fin et provoquer un redémarrage spontané de la carte ; utilise donc un bon câble et un adaptateur d'au moins 1 A. Pour les projets sur batterie, ESP.deepSleep() endort la puce à environ 20 µA ; pour qu'elle se réveille à la fin de la minuterie, tu dois relier la broche D0 (GPIO 16) à la broche RST. Cependant, le convertisseur USB-série et le régulateur de la carte continuent de consommer pendant le sommeil, c'est pourquoi un module ESP-12 nu ou une carte basse consommation donnent de meilleurs résultats pour une longue autonomie. Pour estimer l'autonomie, utilise le Calculateur d'autonomie de batterie.

Idées de projets avec le NodeMCU

• Thermomètre Wi-Fi : Affiche la température et l'humidité mesurées par un DHT11 sur une page que tu ouvres sur ton téléphone.
• Prise connectée : Allume et éteins une lampe avec un module relais et un bouton sur une page web.
• Alerte d'arrosage : Branche un capteur d'humidité du sol sur A0 et affiche une alerte sur la page quand la terre s'assèche.
• Ruban LED Wi-Fi : Choisis depuis ton téléphone la couleur et l'effet d'un ruban WS2812B.
• Horloge internet : Récupère l'heure auprès d'un serveur NTP et affiche-la sur un écran LCD I2C.
• Alarme de mouvement : Envoie un message Telegram quand un capteur PIR détecte un mouvement.

Erreurs fréquentes et solutions

Le NodeMCU ESP8266 est le moyen le plus économique de transposer ce que tu as appris avec Arduino dans le monde sans fil : en quelques lignes de code, il rejoint ton réseau domestique et te permet de créer des appareils pilotés depuis ton téléphone. Dans l'application BlueGrays, tu trouveras des projets sans fil sur ESP32, comme la connexion Wi-Fi, le serveur web, le WebSocket, l'horloge NTP et le mDNS, avec schémas de câblage et code pas à pas, et tu pourras facilement adapter la même logique à ton NodeMCU.