Prise connectée ESP32 : relais, panneau web et minuterie NTP
Fabrique une prise connectée ESP32 en Wi-Fi : relais, alimentation HLK-PM01, panneau web on/off, minuterie NTP, limite de charge et règles de sécurité 230 V.
Une prise connectée ESP32 transforme une prise ordinaire en appareil que tu peux allumer et éteindre depuis ton téléphone ou ton ordinateur via le Wi-Fi, et même faire fonctionner automatiquement à certaines heures. Le principe est simple : l'ESP32 se connecte à ton réseau domestique et publie un petit panneau web ; quand tu appuies sur « Allumer », l'ESP32 active un relais, et ce relais coupe ou ferme le fil de phase de la prise pour alimenter l'appareil branché. Pour alimenter tout le montage depuis le secteur, un minuscule module AC-DC appelé HLK-PM01 convertit le 230 V en 5 V ; pas besoin d'un adaptateur séparé dans le boîtier.
Dans ce guide, tu vas voir pas à pas comment choisir les composants, calculer le bilan de puissance, faire le câblage, écrire le code avec panneau web, puis ajouter une minuterie à rebours et un programme quotidien basé sur l'heure NTP. Mais ce projet travaille avec la tension secteur de 230 V et ne pardonne aucune erreur. C'est pourquoi il n'y a qu'une règle principale dans tout l'article : teste tout d'abord en basse tension ; quand le code et le câblage fonctionnent parfaitement, passe au secteur en respectant les règles de boîtier et d'isolation. Si tu n'as pas d'expérience avec les installations secteur, fais la dernière étape sous la surveillance de quelqu'un qui s'y connaît.

Qu'est-ce qu'une prise connectée ESP32 et comment fonctionne-t-elle ?
Les prises connectées du commerce contiennent les mêmes trois blocs : un microcontrôleur Wi-Fi, un élément de commutation (en général un relais) et une petite alimentation qui produit une basse tension à partir du secteur. Dans notre version, l'ESP32 gère à la fois la connexion Wi-Fi, le serveur web et l'horloge. Le relais commute la charge 230 V en la gardant isolée électriquement du signal faible de 3,3 V de l'ESP32 ; quand la bobine est alimentée, le contact interne se ferme, et tu l'entends avec un « clic » bien audible. Le HLK-PM01 est une alimentation à découpage sous boîtier fermé, avec isolation entre entrée et sortie ; il fournit du 5 V DC et au maximum 3 W (600 mA) à partir d'une entrée de 100–240 V AC. Pour sa structure interne et son circuit de protection, consulte l'article Convertisseur AC-DC HLK-PM01.
| Composant | Rôle | Valeur importante |
|---|---|---|
| ESP32 DevKit | Wi-Fi, panneau web, minuterie et horloge NTP | Logique 3,3 V, pic de courant de 250–350 mA lors de l'émission Wi-Fi |
| Module relais 5 V à 1 canal | Ouvre et ferme le fil de phase de la prise | Contact : 10 A 250 V AC (SRD-05VDC-SL-C) |
| HLK-PM01 | Convertit le 230 V AC en 5 V DC | 5 V, 600 mA (3 W), isolé |
| Fusible et varistance | Protègent l'entrée du HLK-PM01 contre les courts-circuits et les surtensions | Par exemple fusible temporisé 0,5 A, varistance 275 V AC (10D431K) |
| Bouton-poussoir | Marche/arrêt manuel sur le boîtier | GPIO 27, pull-up interne |
| Boîtier de projet et prise avec terre | Isolation et sécurité au toucher | Plastique ignifugé UL94 V-0 |

Bilan de puissance : le HLK-PM01 suffit-il ?
| Consommateur | Courant typique (ligne 5 V) | Remarque |
|---|---|---|
| ESP32 (Wi-Fi connecté, au repos) | 80–120 mA | Le régulateur de la carte abaisse le 5 V en 3,3 V |
| ESP32 (pic d'émission Wi-Fi) | 250–350 mA (de courte durée) | À lisser avec un condensateur |
| Bobine du relais (5 V) | 70–90 mA | Uniquement quand le relais est activé |
| LED d'état | 5–10 mA | LED du module et de la carte |
| Total (pire cas) | Environ 450 mA | Limite du HLK-PM01 : 600 mA |
Comme tu le vois dans le tableau, une prise connectée à un seul relais tient dans les 600 mA du HLK-PM01, mais la marge n'est pas très large. C'est pourquoi placer un condensateur électrolytique d'au moins 470 µF près de la broche 5V (VIN) de l'ESP32, avec un condensateur céramique de 100 nF à côté, évite que la tension chute et que la carte redémarre lors des pics de courant Wi-Fi et à l'activation du relais. Si tu utilises un relais à quatre canaux et que tu les actives tous en même temps, les bobines seules dépassent 300 mA ; dans ce cas, choisis un module plus puissant comme le HLK-5M05 de 5 W. Tu peux vérifier rapidement les calculs de courant et de puissance avec la calculatrice de la loi d'Ohm.
Schéma de câblage : ESP32, relais et HLK-PM01
| Borne | Raccordée à | Remarque |
|---|---|---|
| Entrées AC du HLK-PM01 | L et N du secteur (après le fusible et la varistance) | Dans le compartiment haute tension du boîtier |
| HLK-PM01 +Vo | 5V (VIN) de l'ESP32 et VCC du module relais | Débranche le secteur pendant le téléversement du programme |
| HLK-PM01 -Vo | GND de l'ESP32 et GND du module relais | Masse commune |
| IN du relais | GPIO 26 de l'ESP32 | Broche sûre qui ne produit pas de signal au démarrage |
| Bouton | GPIO 27 et GND | INPUT_PULLUP, aucune résistance externe nécessaire |
| LED d'état | GPIO 2 | Intégrée sur la plupart des cartes DevKit |
| COM du relais | Phase du secteur (L), après le fusible | Seule la phase est coupée |
| NO du relais | Borne de phase de la prise | Normalement ouvert : si le relais retombe, la prise n'est plus alimentée |
| Neutre (N) et terre (PE) | Directement aux bornes N et terre de la prise | Ne passent pas par le relais, continuité permanente |
Il y a une raison à notre choix du GPIO 26 pour le relais : les GPIO 0, 2, 12 et 15 sont des broches de démarrage (strapping) qui influencent la façon dont la carte démarre ; les GPIO 1 et 3 sont réservés au port série, les 6–11 à la mémoire flash interne, et les GPIO 5 et 14 produisent de brefs signaux au démarrage. Le GPIO 26 ne fait rien de tout cela. Le GPIO 2, lui, ne pose pas de problème tant qu'il ne pilote que la LED de la carte. Utiliser la borne NO (normalement ouvert) du relais est aussi important : quand l'ESP32 est éteint, redémarre ou tombe en panne, le relais retombe et la prise reste hors tension. Si tu utilises la borne NC, c'est l'inverse : en cas de panne, l'appareil fonctionne en permanence.
Teste d'abord en basse tension
- Alimente l'ESP32 uniquement par le câble USB ; ne branche pas du tout le HLK-PM01 à ce stade. Relie la borne VCC du module relais à la broche 5V (VIN) de l'ESP32, GND à GND et IN au GPIO 26.
- Sur les bornes COM et NO du relais, branche une charge basse tension à la place du 230 V : un adaptateur 12 V avec un court ruban LED, ou une LED alimentée en 5 V avec une résistance de 220 Ω suffit.
- Téléverse le code de test ci-dessous et ouvre le Moniteur série à 115200 bauds ; le relais doit cliquer toutes les 2 secondes et la LED clignoter.
- Si le relais fonctionne à l'envers (la charge s'éteint alors que l'écran affiche « ACIK »), change la valeur de RELAY_ACTIVE_LOW dans le code.
- Téléverse ensuite le code avec panneau web, teste l'allumage/extinction depuis le téléphone et la minuterie ; redémarre l'ESP32 pour vérifier que le relais démarre éteint et que la carte ne se bloque pas quand le Wi-Fi se coupe.
- Fais fonctionner le montage une journée en basse tension et vérifie que le programme NTP allume et éteint à la bonne heure ; ce n'est qu'après que tu passes à l'installation sur le secteur.
1// Röle testi / Relay test
2const int RELAY_PIN = 26; // Röle IN pini / Relay IN pin
3const bool RELAY_ACTIVE_LOW = true; // Çoğu modül LOW ile çeker / Most modules energize on LOW
4
5void relaySet(bool on) {
6 if (RELAY_ACTIVE_LOW) digitalWrite(RELAY_PIN, on ? LOW : HIGH);
7 else digitalWrite(RELAY_PIN, on ? HIGH : LOW);
8}
9
10void setup() {
11 Serial.begin(115200);
12 pinMode(RELAY_PIN, OUTPUT);
13 relaySet(false); // kapalı başla / start off
14}
15
16void loop() {
17 relaySet(true);
18 Serial.println("Role ACIK / Relay ON");
19 delay(2000);
20 relaySet(false);
21 Serial.println("Role KAPALI / Relay OFF");
22 delay(2000);
23}La fonction relaySet() traduit les commandes « allumer » et « éteindre » dans la logique de déclenchement du module. La plupart des modules relais du marché sont à déclenchement LOW : le relais colle quand la borne IN est tirée à GND. Gérer cette logique inversée avec une seule constante (RELAY_ACTIVE_LOW) plutôt que d'y penser partout dans le code évite les erreurs. Il y a aussi un avantage : quand l'ESP32 démarre ou redémarre, ses broches sont en entrée, et un module à déclenchement LOW dont la borne IN est flottante ne colle pas de lui-même pendant ce temps. Pour la structure interne du relais et son circuit de commande, jette un œil à l'article Qu'est-ce qu'un module relais ?.
Code de la prise connectée avec panneau web
Si le test a réussi, tu peux passer au code principal. La bibliothèque WebServer, livrée avec le cœur Arduino de l'ESP32, ne demande aucune installation supplémentaire et fonctionne de la même façon avec les versions 2.x et 3.x du cœur. Le code fournit un panneau de contrôle sur la page d'accueil, des commandes aux adresses /on, /off, /toggle et /timer?min=30, et l'état de la prise en JSON à l'adresse /state. Le panneau interroge /state toutes les 2 secondes ; tu vois donc sur ton téléphone aussi les changements faits avec le bouton du boîtier ou par le programme. N'oublie pas de modifier le nom et le mot de passe Wi-Fi au début du code selon ton réseau ; l'ESP32 ne se connecte qu'aux réseaux 2,4 GHz. Pour une mise à jour instantanée, consulte l'article Serveur web et WebSocket ESP32.
1#include <WiFi.h>
2#include <WebServer.h>
3#include <ESPmDNS.h>
4#include <time.h>
5
6const char* WIFI_SSID = "WIFI_ADI"; // Wi-Fi adın / your Wi-Fi name
7const char* WIFI_PASS = "WIFI_SIFRESI"; // Wi-Fi şifren / your Wi-Fi password
8
9const int RELAY_PIN = 26; // Röle IN / Relay IN
10const int BUTTON_PIN = 27; // Yerel buton / Local button
11const int LED_PIN = 2; // Durum LED'i / Status LED
12const bool RELAY_ACTIVE_LOW = true; // LOW tetiklemeli modül / Active-LOW module
13
14// Günlük program (gece yarısından itibaren dakika) / Daily schedule (minutes after midnight)
15int onMinute = 18 * 60 + 30; // 18:30 aç / turn on
16int offMinute = 23 * 60; // 23:00 kapat / turn off
17bool scheduleEnabled = true;
18
19WebServer server(80);
20bool relayOn = false;
21bool timerActive = false;
22unsigned long offAtMs = 0;
23int lastCheckedMinute = -1;
24
25const char PAGE[] PROGMEM = R"rawliteral(
26<!DOCTYPE html><html><head><meta charset="utf-8">
27<meta name="viewport" content="width=device-width,initial-scale=1">
28<title>Akıllı Priz</title>
29<style>
30body{font-family:sans-serif;text-align:center;background:#0f172a;color:#e2e8f0}
31button{font-size:20px;margin:6px;padding:12px 22px;border:0;border-radius:10px;color:#fff}
32.on{background:#16a34a}.off{background:#dc2626}.t{background:#2563eb}
33</style></head><body>
34<h2>ESP32 Akıllı Priz</h2>
35<p id="s">...</p><p id="z"></p>
36<button class="on" onclick="go('/on')">AÇ</button>
37<button class="off" onclick="go('/off')">KAPAT</button><br>
38<button class="t" onclick="go('/timer?min=15')">15 dk</button>
39<button class="t" onclick="go('/timer?min=30')">30 dk</button>
40<button class="t" onclick="go('/timer?min=60')">60 dk</button>
41<script>
42function show(d){
43 document.getElementById('s').textContent='Priz: '+(d.on?'AÇIK':'KAPALI');
44 document.getElementById('z').textContent='Saat '+d.time+(d.left>0?' | Kalan: '+d.left+' dk':'');
45}
46function go(u){fetch(u).then(r=>r.json()).then(show);}
47setInterval(()=>go('/state'),2000);
48go('/state');
49</script></body></html>
50)rawliteral";
51
52void relaySet(bool on) {
53 relayOn = on;
54 if (RELAY_ACTIVE_LOW) digitalWrite(RELAY_PIN, on ? LOW : HIGH);
55 else digitalWrite(RELAY_PIN, on ? HIGH : LOW);
56 digitalWrite(LED_PIN, on ? HIGH : LOW);
57}
58
59String timeText() {
60 struct tm t;
61 if (!getLocalTime(&t, 10)) return "--:--"; // saat henüz yok / time not synced yet
62 char buf[16];
63 snprintf(buf, sizeof(buf), "%02d:%02d", t.tm_hour, t.tm_min);
64 return String(buf);
65}
66
67long minutesLeft() {
68 if (!timerActive) return 0;
69 long ms = (long)(offAtMs - millis());
70 return ms > 0 ? (ms + 59999L) / 60000L : 0;
71}
72
73void sendState() {
74 String json = "{\"on\":";
75 json += relayOn ? "true" : "false";
76 json += ",\"time\":\"";
77 json += timeText();
78 json += "\",\"left\":";
79 json += String(minutesLeft());
80 json += "}";
81 server.send(200, "application/json", json);
82}
83
84void handleOn() { timerActive = false; relaySet(true); sendState(); }
85void handleOff() { timerActive = false; relaySet(false); sendState(); }
86
87void handleTimer() {
88 int m = server.arg("min").toInt();
89 if (m < 1 || m > 720) { // 1-720 dakika / 1-720 minutes
90 server.send(400, "text/plain", "min 1-720");
91 return;
92 }
93 relaySet(true);
94 offAtMs = millis() + (unsigned long)m * 60000UL;
95 timerActive = true;
96 sendState();
97}
98
99void setup() {
100 Serial.begin(115200);
101 pinMode(RELAY_PIN, OUTPUT);
102 pinMode(LED_PIN, OUTPUT);
103 pinMode(BUTTON_PIN, INPUT_PULLUP);
104 relaySet(false); // güvenli başlangıç: kapalı / safe start: off
105
106 WiFi.mode(WIFI_STA);
107 WiFi.setAutoReconnect(true);
108 WiFi.begin(WIFI_SSID, WIFI_PASS);
109 unsigned long t0 = millis();
110 while (WiFi.status() != WL_CONNECTED && millis() - t0 < 20000) {
111 delay(500);
112 Serial.print(".");
113 }
114 Serial.println();
115 Serial.print("IP: ");
116 Serial.println(WiFi.localIP());
117
118 configTzTime("<+03>-3", "pool.ntp.org", "time.google.com"); // Türkiye UTC+3 / Turkey UTC+3
119
120 if (MDNS.begin("akillipriz")) {
121 Serial.println("http://akillipriz.local");
122 }
123
124 server.on("/", []() { server.send(200, "text/html; charset=utf-8", PAGE); });
125 server.on("/state", sendState);
126 server.on("/on", handleOn);
127 server.on("/off", handleOff);
128 server.on("/toggle", []() { timerActive = false; relaySet(!relayOn); sendState(); });
129 server.on("/timer", handleTimer);
130 server.begin();
131}
132
133void loop() {
134 server.handleClient();
135
136 // Yerel buton, basit debounce / Local button, simple debounce
137 static bool lastBtn = HIGH;
138 static unsigned long lastChange = 0;
139 bool btn = digitalRead(BUTTON_PIN);
140 if (btn != lastBtn && millis() - lastChange > 50) {
141 lastChange = millis();
142 lastBtn = btn;
143 if (btn == LOW) { // basıldı / pressed
144 timerActive = false;
145 relaySet(!relayOn);
146 }
147 }
148
149 // Geri sayım zamanlayıcısı / Countdown timer
150 if (timerActive && (long)(millis() - offAtMs) >= 0) {
151 timerActive = false;
152 relaySet(false);
153 }
154
155 // NTP saatine göre günlük program / Daily schedule from NTP time
156 static unsigned long lastTick = 0;
157 if (millis() - lastTick >= 1000) {
158 lastTick = millis();
159 struct tm t;
160 if (scheduleEnabled && getLocalTime(&t, 0)) {
161 int nowMin = t.tm_hour * 60 + t.tm_min;
162 if (nowMin != lastCheckedMinute) { // her dakika bir kez / once per minute
163 lastCheckedMinute = nowMin;
164 if (nowMin == onMinute) relaySet(true);
165 if (nowMin == offMinute) { timerActive = false; relaySet(false); }
166 }
167 }
168 }
169}| Morceau de code | Ce qu'il fait |
|---|---|
| relaySet(bool on) | Met à jour ensemble le relais, la LED d'état et la variable relayOn |
| server.on("/timer", ...) | Avec un paramètre comme ?min=30, allume la prise et l'éteint à la fin du délai (1–720 minutes) |
| minutesLeft() | Calcule le temps restant de la minuterie en minutes, arrondi au supérieur |
| (long)(millis() - offAtMs) >= 0 | Comparaison de durée qui résiste au débordement de millis() (environ 49,7 jours) |
| configTzTime("<+03>-3", ...) | Récupère l'heure auprès des serveurs NTP et la convertit à l'heure de la Turquie (UTC+3) |
| lastCheckedMinute | Fait en sorte que le programme ne soit vérifié qu'une fois par minute ; n'écrase pas une commande donnée à la main |
| MDNS.begin("akillipriz") | Te permet d'accéder au panneau via http://akillipriz.local au lieu de l'IP |
Fonctionnement automatique avec minuterie et NTP
L'ESP32 n'a pas d'horloge sur batterie ; au démarrage, il ne connaît pas l'heure du jour. L'appel à configTzTime() lance le client SNTP en arrière-plan, récupère l'heure UTC auprès de serveurs comme pool.ntp.org et la convertit en heure locale selon la chaîne de fuseau horaire que tu fournis. Une fois l'heure obtenue, l'ESP32 continue de compter avec son propre minuteur et se resynchronise par défaut toutes les heures. Comme la Turquie n'applique plus l'heure d'été depuis 2016, la chaîne "<+03>-3" suffit ; dans le format POSIX le signe est inversé, donc UTC+3 s'écrit -3. Pour les détails, consulte l'article Heure Internet avec NTP sur ESP32.
Le code propose deux types de fonctionnement automatique. Le premier est la minuterie à rebours : le bouton « 30 dk » du panneau allume la prise et l'éteint à la fin du délai ; c'est idéal pour les appareils que tu risques d'oublier allumés, comme un chargeur, l'aération d'un aquarium ou un ventilateur de chambre. Le second est le programme quotidien : la prise s'allume chaque jour à onMinute et s'éteint à offMinute. Comme le programme n'intervient qu'au moment où la minute change et exactement à cette minute, une lampe que tu as éteinte à la main à 20:00, par exemple, reste éteinte jusqu'à la prochaine heure d'allumage. Pour la même raison, les programmes qui passent minuit, comme allumer à 22:00 et éteindre à 06:00, fonctionnent sans problème.
| Réglage | Valeur d'exemple | Résultat |
|---|---|---|
| onMinute | 18 * 60 + 30 | Allume chaque jour à 18:30 |
| offMinute | 23 * 60 | Éteint chaque jour à 23:00 |
| onMinute et offMinute | 7 * 60 et 21 * 60 | L'aquarium ou la lampe de culture reste allumé de 07:00 à 21:00 |
| scheduleEnabled | false | Programme quotidien désactivé ; seuls le panneau, le bouton et la minuterie fonctionnent |
| Fuseau horaire configTzTime | "CET-1CEST,M3.5.0,M10.5.0/3" | Heure d'Europe centrale, avec les changements d'heure d'été |
Limite de charge : que peux-tu brancher sur la prise ?
Tu trouves le courant consommé par un appareil avec la formule I = P / V : à 230 V, un appareil de 1000 W consomme 1000 / 230 ≈ 4,3 A. Que « 10A 250VAC » soit écrit sur le relais ne veut pas dire que le module peut supporter 10 A en continu ; sur les modules bon marché, les pistes du circuit imprimé, les bornes à vis et le relais lui-même chauffent à ce courant. De plus, les appareils à moteur et à compresseur tirent au démarrage plusieurs fois leur courant de fonctionnement, et les contacts font un arc à chaque commutation. Comme limite pratique sûre, garde la charge continue sous 2–3 A (environ 500–700 W). Les détails du calcul de puissance sont dans l'article Calcul de la puissance électrique.
| Appareil | Puissance typique | Courant (230 V) | Pour cette prise |
|---|---|---|---|
| Ampoule LED | 9–12 W | 0,04–0,05 A | Convient |
| Routeur / box | 10–15 W | 0,04–0,07 A | Convient (idéal pour un redémarrage à distance) |
| Chargeur de téléphone et d'ordinateur portable | 20–65 W | 0,09–0,28 A | Convient |
| Ventilateur de bureau | 40–60 W | 0,17–0,26 A | Convient (charge inductive, les contacts s'usent plus vite) |
| Chauffage d'aquarium | 100–200 W | 0,43–0,87 A | Convient |
| Machine à café | 1000–1500 W | 4,3–6,5 A | Déconseillé |
| Bouilloire, fer à repasser, radiateur électrique | 2000–2400 W | 8,7–10,4 A | Absolument pas |
Boîtier et sécurité secteur
- On coupe la phase, pas le neutre : le relais se branche toujours sur le fil de phase (L). Si tu coupes le neutre, la phase reste présente dans l'appareil même prise éteinte, et le risque de contact demeure.
- Terre ininterrompue : la borne de terre de la prise avec terre est reliée directement au conducteur de terre d'entrée ; elle ne passe ni par le relais ni par le circuit imprimé.
- Sépare les compartiments : les câbles qui portent le 230 V, les contacts du relais et l'entrée du HLK-PM01 d'un côté du boîtier ; l'ESP32 et les fils 5 V de l'autre. Laisse au moins 6 mm entre les deux zones et ajoute si besoin une cloison en plastique.
- Bons câbles et bornes : côté secteur, utilise du câble multibrin d'au moins 1,5 mm², avec embouts sertis et bornes solides. Les fils jumper et la breadboard n'ont absolument pas leur place côté secteur.
- Fusible : place sur la ligne de charge un fusible inférieur à la limite du relais (par exemple 5 A), et un fusible séparé de faible valeur sur l'entrée du HLK-PM01.
- Boîtier : choisis un boîtier de projet en plastique ignifugé (UL94 V-0) ; si tu utilises un boîtier métallique, relie-le impérativement à la terre. Fixe le câble d'entrée avec un presse-étoupe ou un collier pour qu'il ne s'arrache pas des bornes quand on tire dessus.
- Mise à jour du programme : ne branche pas de câble USB et n'ouvre pas le couvercle quand le boîtier est relié au secteur. Pour téléverser le code sans fil, tu peux ajouter la méthode mise à jour OTA de l'ESP32.
- Première mise sous tension : avant de brancher au secteur pour la première fois, vérifie l'absence de court-circuit entre les fils avec un multimètre ; fais le premier essai sur une ligne protégée par un disjoncteur différentiel et avec une petite ampoule LED.
Idées de projets et améliorations
- Intègre-la à la domotique : ajoute la prise à tes autres appareils connectés et à tes scénarios d'automatisation avec MQTT et Home Assistant.
- Contrôle depuis l'extérieur : ajoute un bot Telegram pour allumer et éteindre la prise de n'importe où, sans ouvrir de port sur ta box.
- Sors le mot de passe du code : saisis les infos Wi-Fi depuis ton téléphone au premier démarrage avec WiFiManager ; pas besoin de retéléverser le code quand le réseau change.
- Prise à thermostat : ajoute un DHT11 ou un DS18B20 et fais fonctionner le chauffage ou le ventilateur selon la température.
- Commutation silencieuse : si tu ne veux ni clic ni usure des contacts, utilise un relais statique (SSR) pour les charges résistives.
- Prise à détection de mouvement : avec un capteur PIR, monte un système qui allume la lampe quand tu entres dans la pièce et l'éteint après 5 minutes sans mouvement.
- Version Pico W : si tu veux essayer la même idée en MicroPython, commence par l'article Serveur web sur Pico W.
Erreurs fréquentes et solutions
| Symptôme | Cause probable | Solution |
|---|---|---|
| Le relais ne retombe jamais | Module à déclenchement LOW alimenté en 5 V, ne se ferme pas complètement avec un HIGH à 3,3 V | Sépare le JD-VCC ou utilise un module à déclenchement 3,3 V |
| L'ESP32 redémarre quand le relais colle | Chute de tension (brownout) ou parasites créés par l'arc des contacts | Ajoute 470 µF et 100 nF sur la ligne 5V, raccourcis les câbles |
| Le panneau ne s'ouvre pas | Le téléphone est sur un autre réseau, l'IP a changé ou l'ESP32 n'a pas pu se connecter au Wi-Fi | Vérifie l'IP dans le Moniteur série, attribue une IP fixe |
| L'heure affiche « --:-- » | Le serveur NTP est injoignable | Vérifie la connexion Internet et le DNS, ajoute un second serveur |
| Le programme est décalé de 3 heures | Aucun fuseau horaire n'est défini, l'UTC est utilisé | Écris la bonne chaîne de fuseau horaire avec configTzTime |
| Le relais colle un instant au démarrage | Une broche de démarrage comme GPIO 0, 2, 12, 15 a été choisie, ou le module est à déclenchement HIGH | Utilise une broche sûre comme le GPIO 26, vérifie le type de module |
| Le relais et les bornes chauffent | La charge est trop grande pour ce que le module supporte | Ramène la charge sous 2–3 A, utilise un contacteur pour les grosses charges |
La prise connectée ESP32 est un projet très instructif, car il réunit en un seul montage le Wi-Fi, le serveur web, la gestion du temps et l'électronique de puissance. Si tu avances dans le bon ordre et avec patience, tu obtiens un appareil qui ressemble aux produits du commerce, entièrement sous ton contrôle. Dans l'application BlueGrays, tu peux améliorer encore cette prise en étudiant pas à pas, avec schémas de circuit et codes prêts à l'emploi, des projets de serveur web ESP32, d'horloge NTP, de mDNS et d'éclairage à relais.
Questions fréquentes
Est-ce sûr de fabriquer une prise connectée avec un ESP32 ?
Le côté basse tension (ESP32, bobine du relais et code) est totalement sûr ; le vrai risque se trouve côté 230 V. Les règles de base sont de couper la phase avec le relais, de laisser la terre ininterrompue, d'utiliser un fusible et de tout placer dans un boîtier fermé et ignifugé. Si tu n'as pas d'expérience, essaie d'abord avec une charge de 12 V et fais vérifier le raccordement au secteur par quelqu'un qui s'y connaît.
Le HLK-PM01 peut-il alimenter l'ESP32 et le relais en même temps ?
Oui, c'est suffisant pour un circuit à un seul relais. Le HLK-PM01 fournit 600 mA à 5 V ; l'ESP32 consomme en moyenne 80–120 mA, environ 300 mA lors des pics Wi-Fi, et la bobine du relais 70–90 mA. Pour lisser les fluctuations de tension, ajoute un condensateur de 470 µF sur la ligne 5 V ; si tu utilises plusieurs relais, choisis un module de 5 W comme le HLK-5M05.
L'ESP32 peut-il piloter un module relais 5 V ?
La plupart des modules dotés d'un transistor de commande se déclenchent sans problème avec la sortie 3,3 V de l'ESP32 ; la bobine est alimentée en 5 V et la broche de l'ESP32 ne fournit que quelques milliampères. Sur les modules à optocoupleur et à déclenchement LOW, en revanche, le niveau HIGH à 3,3 V peut ne pas faire retomber complètement le relais. Dans ce cas, retire le cavalier JD-VCC, relie VCC au 3V3 et JD-VCC au 5 V.
Que fait la prise connectée quand le courant est coupé puis revient ?
Par sécurité, le code de cet article démarre le relais éteint à chaque mise sous tension. Si tu veux qu'elle se souvienne du dernier état, tu peux l'écrire en flash avec la bibliothèque Preferences et le restaurer dans setup(). L'heure NTP est récupérée de nouveau en quelques secondes dès le retour d'Internet, et le programme quotidien reprend là où il en était.
Puis-je contrôler la prise depuis l'extérieur de la maison via Internet ?
Le panneau web de ce code n'est accessible que depuis le réseau local de la maison. Pour un contrôle à distance, plutôt que d'ouvrir un port sur ta box, utiliser un service comme un bot Telegram, MQTT, Blynk ou Firebase est à la fois plus simple et plus sûr. Comme l'ESP32 se connecte lui-même à ces services, tu n'ouvres pas de porte vers ton réseau domestique.
Quelle puissance d'appareil puis-je brancher sur la prise connectée ESP32 ?
Même si 10 A est écrit sur les modules relais pour bricoleurs, il est prudent de garder la charge continue sous 2–3 A, soit environ 500–700 W à 230 V. Les lampes, chargeurs, routeurs, ventilateurs et équipements d'aquarium conviennent. Les appareils de forte puissance comme la bouilloire, le fer à repasser, le radiateur électrique et la climatisation ne doivent pas être branchés sur ce projet.
Projets à réaliser après cet article
Voir tous les projets
Clignotement LED avec ESP32
Enseigne l'utilisation de base des sorties GPIO avec l'ESP32. Nous obtenons un effet de clignotement en allumant et éteignant une LED à partir de la broche numérique. Version ESP32 du projet blink classique sur Arduino UNO ; les commandes de base de blink dans l'environnement Arduino restent les mêmes, mais le brochage et les niveaux GPIO de 3,3 V de l'ESP32 diffèrent de ceux de l'Arduino UNO.

Serveur Web asynchrone ESP32 (avec affichage de l'adresse IP sur l'écran LCD)
On transforme l'ESP32 en serveur web asynchrone que tu pilotes depuis ton téléphone ou ton ordinateur sur le même réseau Wi-Fi. Grâce à la bibliothèque ESPAsyncWebServer, le serveur traite plusieurs requêtes à la fois (il ne bloque pas sur une seule requête comme le WebServer.h classique). Ouvre l'adresse IP de l'ESP32 dans le navigateur et allume ou éteins la LED sur GPIO 5 avec les boutons ON/OFF (adresses /on et /off).

ESP32 : heure réelle depuis Internet via NTP
L'ESP32 se connecte au Wi-Fi et récupère l'heure exacte auprès de serveurs NTP (Network Time Protocol) à la milliseconde près. Avec configTzTime(), le fuseau horaire de la Turquie (TRT, UTC+3) s'applique automatiquement, et dans les pays à heure d'été, le changement (DST) est géré tout seul par une chaîne POSIX TZ. L'heure s'affiche dans le Serial Monitor et sur un LCD I2C en option.

Connexion Wi-Fi STA ESP32 (avec écran LCD)
Dans ce projet, nous connectons l'ESP32 au réseau Wi-Fi domestique en mode Station (STA) de manière sécurisée et tolérante aux pannes. Nous isolons SSID/mot de passe dans un fichier secrets.h pour empêcher leur fuite sur Git, mettons en place une reconnexion automatique, et affichons le niveau RSSI et l'adresse IP sur un écran LCD I2C. La LED intégrée sert d'indicateur d'état.

Compteur ESP32 WebSocket (2 boutons + écran LCD + affichage Web en temps réel)
Dans ce projet, deux boutons reliés à l'ESP32 (GPIO 5 incrémente, GPIO 4 décrémente) modifient un compteur. La valeur se met à jour instantanément sur un écran LCD I2C 16x2 et, grâce au support WebSocket d'ESPAsyncWebServer, dans tous les navigateurs connectés sans recharger la page. Au lieu du polling HTTP, une seule connexion persistante est utilisée et l'ESP32 envoie la nouvelle valeur à tous avec ws.textAll().

ESP32 mDNS : accès à l'appareil via bluegrays-esp.local (avec écran LCD)
Dans ce projet, en ajoutant un service mDNS (Multicast DNS) à l'ESP32, nous permettons d'accéder à l'appareil via un nom d'hôte lisible, tel que bluegrays-esp.local, plutôt qu'à l'aide d'une adresse IP. Même si l'adresse IP attribuée par le DHCP venait à changer, vous pourrez toujours accéder à l'appareil sous le même nom. En exécutant également un petit serveur web sur l'appareil, nous envoyons des commandes de contrôle des LED depuis un navigateur via l'adresse http://bluegrays-esp.local/.

Éclairage Intelligent ESP32 (PIR + LDR + Relais + OLED)
Avec un ESP32, un capteur de mouvement PIR, un capteur de lumière LDR et un module relais, on transforme ton couloir, tes toilettes ou ton cellier en éclairage intelligent. Si la pièce est déjà claire, la lumière reste éteinte malgré le mouvement : pas de gaspillage d'énergie en journée. La lumière reste allumée 30 secondes et la durée se prolonge automatiquement tant que le mouvement continue.

Allumer une ampoule 220 V avec une télécommande
Allume et éteins une vraie ampoule de la maison avec une télécommande, sans quitter le canapé.
Autres articles
Application BlueGrays
Réalise ce montage pas à pas sur ton téléphone
Schéma, code et liste des composants sur un seul écran. Plus de 500 projets Arduino, ESP32 et Pico à réaliser.
Scanne avec ton téléphone
Pointe l’appareil photo vers le code : la boutique d’applications de ton téléphone s’ouvre.
ou ouvre la boutique

