This tutorial shows how to create a web server with a button that acts as momentary switch to remotely control ESP32 or ESP8266 outputs. The output state is HIGH as long as you keep holding the button in your web page. Once you release it, it changes to LOW. As an example, we’ll control an LED, but you can control any other output.
The ESP32/ESP8266 boards will be programmed using Arduino IDE. So make sure you have these boards installed:
- Installing ESP32 Board in Arduino IDE (Windows, Mac OS X, and Linux)
- Installing ESP8266 Board in Arduino IDE (Windows, Mac OS X, Linux)
Project Overview
The following diagram shows a simple overview of the project we’ll build.
- The ESP32 or ESP8266 hosts a web server that you can access to control an output;
- The output’s default state is LOW, but you can change it depending on your project application;
- There’s a button that acts like a momentary switch:
- if you press the button, the output changes its state to HIGH as long as you keep holding the button;
- once the button is released, the output state goes back to LOW.
Installing Libraries – Async Web Server
To build the web server you need to install the following libraries:
- ESP32: install the ESPAsyncWebServer and the AsyncTCP libraries.
- ESP8266: install the ESPAsyncWebServer and the ESPAsyncTCP libraries.
These libraries aren’t available to install through the Arduino Library Manager, so you need to copy the library files to the Arduino Installation Libraries folder. Alternatively, in your Arduino IDE, you can go to Sketch > Include Library > Add .zip Library and select the libraries you’ve just downloaded.
Code
Copy the following code to your Arduino IDE.
/*********
Rui Santos
Complete project details at https://RandomNerdTutorials.com/esp32-esp8266-web-server-outputs-momentary-switch/
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files.
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
*********/
#ifdef ESP32
#include <WiFi.h>
#include <AsyncTCP.h>
#else
#include <ESP8266WiFi.h>
#include <ESPAsyncTCP.h>
#endif
#include <ESPAsyncWebServer.h>
// REPLACE WITH YOUR NETWORK CREDENTIALS
const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";
const int output = 2;
// HTML web page
const char index_html[] PROGMEM = R"rawliteral(
<!DOCTYPE HTML><html>
<head>
<title>ESP Pushbutton Web Server</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<style>
body { font-family: Arial; text-align: center; margin:0px auto; padding-top: 30px;}
.button {
padding: 10px 20px;
font-size: 24px;
text-align: center;
outline: none;
color: #fff;
background-color: #2f4468;
border: none;
border-radius: 5px;
box-shadow: 0 6px #999;
cursor: pointer;
-webkit-touch-callout: none;
-webkit-user-select: none;
-khtml-user-select: none;
-moz-user-select: none;
-ms-user-select: none;
user-select: none;
-webkit-tap-highlight-color: rgba(0,0,0,0);
}
.button:hover {background-color: #1f2e45}
.button:active {
background-color: #1f2e45;
box-shadow: 0 4px #666;
transform: translateY(2px);
}
</style>
</head>
<body>
<h1>ESP Pushbutton Web Server</h1>
<button class="button" onmousedown="toggleCheckbox('on');" ontouchstart="toggleCheckbox('on');" onmouseup="toggleCheckbox('off');" ontouchend="toggleCheckbox('off');">LED PUSHBUTTON</button>
<script>
function toggleCheckbox(x) {
var xhr = new XMLHttpRequest();
xhr.open("GET", "/" + x, true);
xhr.send();
}
</script>
</body>
</html>)rawliteral";
void notFound(AsyncWebServerRequest *request) {
request->send(404, "text/plain", "Not found");
}
AsyncWebServer server(80);
void setup() {
Serial.begin(115200);
WiFi.mode(WIFI_STA);
WiFi.begin(ssid, password);
if (WiFi.waitForConnectResult() != WL_CONNECTED) {
Serial.println("WiFi Failed!");
return;
}
Serial.println();
Serial.print("ESP IP Address: http://");
Serial.println(WiFi.localIP());
pinMode(output, OUTPUT);
digitalWrite(output, LOW);
// Send web page to client
server.on("/", HTTP_GET, [](AsyncWebServerRequest *request){
request->send_P(200, "text/html", index_html);
});
// Receive an HTTP GET request
server.on("/on", HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(output, HIGH);
request->send(200, "text/plain", "ok");
});
// Receive an HTTP GET request
server.on("/off", HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(output, LOW);
request->send(200, "text/plain", "ok");
});
server.onNotFound(notFound);
server.begin();
}
void loop() {
}
You just need to enter your network credentials (SSID and password) and the web server will work straight away. The code is compatible with both the ESP32 and ESP8266 boards and controls the on-board LED GPIO 2 – you can change the code to control any other GPIO.
How the Code Works
We’ve already explained in great details how web servers like this work in previous tutorials (DHT Temperature Web Server), so we’ll just take a look at the relevant parts for this project.
Network Credentials
As said previously, you need to insert your network credentials in the following lines:
const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";Momentary Switch Button (web server)
The following line creates the momentary switch button.
<button class="button" onmousedown="toggleCheckbox('on');" ontouchstart="toggleCheckbox('on');" onmouseup="toggleCheckbox('off');" ontouchend="toggleCheckbox('off');">LED PUSHBUTTON</button>Let’s break this down into small parts.
In HTML, to create a button, use the <button></button> tags. In between you write the button text. For example:
<button>LED PUSHBUTTON</button>The button can have several attributes. In HTML, the attributes provide additional information about HTML elements, in this case, about the button.
Here, we have the following attributes:
class: provides a class name for the button. This way, it can be used by CSS or JavaScript to perform certain tasks for the button. In this case, it is used to format the button using CSS. The class attribute has the name “button”, but you could have called it any other name.
<button class="button">LED PUSHBUTTON</button>onmousedown: this is an event attribute. It executes a JavaScript function when you press the button. In this case it calls toggleCheckbox(‘on’). This function makes a request to the ESP32/ESP8266 on a specific URL, so that it knows it needs to change the output state to HIGH.
ontouchstart: this is an event attribute similar to the previous one, but it works for devices with a touch screen like a smartphone or table. It calls the same JavaScript function to change the output state to HIGH.
onmouseup: this is an event attribute that executes a JavaScript function when you release the mouse over the button. In this case, it calls toggleCheckbox(‘off’). This function makes a request to the ESP32/ESP8266 on a specific URL, so that it knows it needs to change the output state to LOW.
ontouchend: similar to the previous attribute but for devices with touchscreen.
So, in the end, our button looks like this:
<button class="button" onmousedown="toggleCheckbox('on');" ontouchstart="toggleCheckbox('on');" onmouseup="toggleCheckbox('off');" ontouchend="toggleCheckbox('off');">LED PUSHBUTTON</button>HTTP GET Request to Change Button State (JavaScript)
We’ve seen previously, that when you press or release the button, the toggleCheckbox() function is called. You either pass the “on” or “off” arguments, depending on the state you want.
That function, makes an HTTP request to the ESP32 either on the /on or /off URLs:
function toggleCheckbox(x) {
var xhr = new XMLHttpRequest();
xhr.open("GET", "/" + x, true);
xhr.send();
}Handle Requests
Then, we need to handle what happens when the ESP32 or ESP8266 receives requests on those URLs.
When a request is received on the /on URL, we turn the GPIO on (HIGH) as shown below:
server.on("/on", HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(output, HIGH);
request->send(200, "text/plain", "ok");
});When a request is received on the /off URL, we turn the GPIO off (LOW):
server.on("/off", HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(output, LOW);
request->send(200, "text/plain", "ok");
});Demonstration
Upload the code to your ESP32 or ESP8266 board.
Then, open the Serial Monitor at a baud rate of 115200. Press the on-board EN/RST button to get is IP address.
Open a browser on your local network, and type the ESP IP address. You should have access to the web server as shown below.
The on-board LED stays on as long as you keep holding down the button on the web page.
Note: it works the other way around for the ESP8266 because the on-board LED works with inverted logic.
When you release the button, the LED goes back to its default state (LOW).
Watch the next quick video for a live demonstration:
Wrapping Up
In this tutorial you’ve learned how to add event attributes to the buttons on your web server to make them act as momentary switches. This allows you to change the default’s output state as long as you’re pressing the button.
Other projects you may like:
- Display Images in ESP32 and ESP8266 Web Server
- Input Data on HTML Form ESP32/ESP8266 Web Server
- ESP32/ESP8266 Thermostat Web Server – Control Output Based on Temperature
- ESP32/ESP8266: Control Outputs with Web Server and a Physical Button Simultaneously
- ESP32 Web Server using SPIFFS (SPI Flash File System)
Learn more about the ESP32 and ESP8266 with our resources:
- Learn ESP32 using Arduino IDE
- Home Automation using ESP8266
- MicroPython Programming using ESP32/ESP8266
- More ESP32 tutorials …
- More ESP8266 tutorials …
Thanks for reading.
I have tried the ESP32 project first with interest without any adaptation to the script. I noticed that the LED often stays on after a short press of the button and although the button was released. I was planning to use it as a pulse relay but it doesn’t work as expected. Maybe there is another solution for a pulse relay?
Hi Roland,
You can use this example instead: https://gist.github.com/sarasantos/5e60cf40caaf5865cf56f39621501b5c
It’s a web server to control outputs. When you click on, it stays on for 1 seconds and then goes back to the initial state.
You can change the time if needed on line 55.
I hope this helps.
Regards,
Sara
Sorry to bother but you have a small mistake in the code.
The logical values applied to the LED pin should be inverted due to internal pullup!
Thank you
Hi, I made my project work thanks to you and I totally forgot I had made this comment in the beginning of its development. I was just scrolling around to show your website to a colleague and realized that it came out totally wrong! I meant to make a question and not at all doubt your work. In conclusion, nevermind my poor comment.
Thanks a lot for your help and keep up your excelent work!
Hi.
Don’t worry about that.
Thanks for following our work and good luck with all your projects 😀
Regards,
Sara
Leaving…
Hard resetting via RTS pin…
how to fix it?
Hello Edo. That’s the normal behavior and if you see that message your code has been uploaded successfully. Just restart your board to run the newly uploaded code!
Hello,
Can I use this example when the esp32 is configured in AP mode?
Yes.
It will also work in access point mode.
Regards,
Sara
I have to short tap the button on the web page to get the blue on board light to come back on. When I press and hold the button it will stay off, but flickers & wont come back on when I release, unless I give it a short tap, then it comes on (Im using an ESP8266). Is there a modification to make it more reliable/stable ?
Thanks
I tried a PC web page and it works fine. Its just not detecting when I release the button on my touch screen iphone. I can see the graphical button lifting up though when I take my finger off the button. Something about the touch interface
Hi Stephen.
Yes, it must be a problem with the touch interface. However, I don’t know what might be the problem.
Can you try adding the ontouchcancel event to the button element like this:
ontouchcancel = “toggleCheckbox(‘off’);”
?
REgards,
Sara
Hi
Just tried this project. It works great on PC and android but not on iphone. The led on the esp8266 does’nt turn on and off like it should on iphone. I tried the ontouchcancel = “toggleCheckbox(‘off’);” but it was the same.
Hello,
Can someone help me with the coding
since I have the example above (which was very useful)
i would like to put more buttons and GPIO Pins how would I be able to do it i would highly appreciate your help,
FYI: I am new so learning.
there was already an answer:
https://gist.github.com/sarasantos/5e60cf40caaf5865cf56f39621501b5c
this example is much nicer. I am also asking for a hint on how to make some nice keys
Hello,
I used this example to operate my garage door, perfect it’s operational. Using a sensor (example GPIO35 from ESP32), I would like to know the state of the door and display “door open” and “door closed” under the button “LEDPUSHBUTTON”. Someone could help me because I don’t understand HTML well.
Thank you.
Hello,
Automation of a garage door only becomes interesting if it can be operated and observed outside the local network. This requires internet access which makes things more complex. Usually a cloud server (e.g. Blynk) is used to make the bridge: the door is operated with a pulse relay and the status (reed contact open / close) is reported back in the app. Further automation is then optional such as automatic closing after a certain time interval or time in the evening. All this can be programmed on an ESP microcontroller (Arduino IDE). Unfortunately, different modules have to be cobbled together in the program or searched for ready-made .ino files for ESP8266 or ESP32.
Hopefully one day RNT will offer an integrated solution for the “garage door” as this is one of the most requested home automation solutions by starting DIYers.
Regards
How to make LED Button permanent on screen for quick access (EMERGENCY BUTTON).Can You help?
How can i use same time both momentary and switch relays , like 2 relay momentary and 2 relays switch.
Or all relays the same .. when hold button down 3 sec then its switch and when pushed momentary like 1 sec then its momentary relay.
Hello 🙂 i love to read your tutorials but i dont understand to mix 3 setups together 🙁
i need for my esp32:
-static ip adress
-1x momentary switch with relay output
-1x normal switch with relay output
can you help me? i break my head for this Projekt 🙂
Gruess Axel
Hi.
Here are some of our tutorials that might help:
– https://randomnerdtutorials.com/esp8266-relay-module-ac-web-server/
– https://randomnerdtutorials.com/esp8266-nodemcu-static-fixed-ip-address-arduino/
Regards,
Sara
Hey thanks to answer me. But i dont became All functions together in one Code by myself:-(
Hello, sorry but i dont became the two Buttons functionallety that one goes in 1sec off as in this here:
https://gist.github.com/sarasantos/5e60cf40caaf5865cf56f39621501b5c
And one switch normaly close and open via Button Press. Can you please help me or make me a Code wehre two Buttons inside are? I where crazy that iam so stupid that i dont understand the Codes. Thanks very much.
Hi.
I’m sorry, but I didn’t understand your request.
Regards,
Sara
Hi and sorry for my Bad english. I need a Code for 1 normaly switch and 1 momentary switch in the same arduino program. On your website gives a tutorial for a normale switch an on github gives a program for momentay switch but i dont understand to do both in one Program that i have bot Art of Switches in my webserver 🙂 i Hope you can now understand my Problem and you can make me a code/program?
Regards
Axel
can you give a simple example of multiple buttons controlling multiple GPIO’s?
radio silence. 🙂
Hello guys , nice site and best tutorials ever .
I have found all the thing i need here .
I am new to Arduino and esp
But i have a question:
How to assign other gpio pin?
This will do the trick?
”
// Set to true to define Relay as Normally Open (NO)
#define RELAY_NO true
// Set number of relays
#define NUM_RELAYS 1
// Assign each GPIO to a relay
int relayGPIOs[NUM_RELAYS] = {3};
”
This is also from your code, from other tutorial , as i see it for 1 relay.
This will set 1 relay NO at Gpio 3?
Got it .
Just modify “const int output =” with the gpio number.
But i think that example from before will work.
Hi.
What I need to do to add one more button?
Just define another pin and create another button?
Thanks!
great tutorial.
is any possibilities to make 4 buttons in different position like gamepad buttons
each button placed on top left right and bottom
thanks
Hi,
I modified the code, so I can arrange position the buttons.
on global variable I declared GPIO
const int up= 2; //Up
const int down= 3; //Down
const int left= 4; //LEFT
const int right= 5; //RIGHT
on setup function added
server.on(“/”, HTTP_GET, [](AsyncWebServerRequest *request){
request->send_P(200, “text/html”, index_html);
});
// Receive an HTTP GET request
server.on(“/on”, HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(up, HIGH);
request->send(200, “text/plain”, “ok”);
});
// Receive an HTTP GET request
server.on(“/off”, HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(up, LOW);
request->send(200, “text/plain”, “ok”);
});
// Receive an HTTP GET request
server.on(“/on”, HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(down, HIGH);
request->send(200, “text/plain”, “ok”);
});
// Receive an HTTP GET request
server.on(“/off”, HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(down, LOW);
request->send(200, “text/plain”, “ok”);
});
// Receive an HTTP GET request
server.on(“/on”, HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(left, HIGH);
request->send(200, “text/plain”, “ok”);
});
// Receive an HTTP GET request
server.on(“/off”, HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(right, LOW);
request->send(200, “text/plain”, “ok”);
});
but the GPIO 3, 4 and 5 state doesn’t change from HIGH to LOW vice versa
do you have any suggestions how to make GPIO 3, 4 and 5 work the same as GPIO 2 when the button is pressed and released…..
really appreciate if someone can help me
thanks
What do I need to change to replace “digitalWrite(output, HIGH);” with sequence of servo moves?
Changing 1:1 only executes 1st servo move, than stops
server.on(“/on”, HTTP_GET, [] (AsyncWebServerRequest *request) {
digitalWrite(output, HIGH);
request->send(200, “text/plain”, “ok”);
});
Hi.
You may want to use a library to control servos.
For example: https://github.com/RoboticsBrno/ServoESP32
After learning how to control a servo, replace that digitalWrite() with the instructions to control the servo motor.
Regards,
Sara
Hi,
Thanks for this tutorial. Can you please help me to create two momentary pushbutton for two led in a web interface using nodemcu?
Thanks Again!
Hi,
Thanks for this tutorial. I modifed this project. I added more three buttons with same function, also ather fixed state buttons. But know I need to add pin status in web html page. For this tutorial for exemple I need to add in the web digitalRead(2). How to do that?
Cannot seem to install ESP8266WiFi. I installed the library, however when compiling, I receive an error that ESP8266WiFi.h cannot be found.
What do I need to do. I even went into Arduino docs and enetered the infro for additional boards, no good.
Hi.
That library is part of the ESP8266 core by default. You don’t need to install it.
Just make sure you’ve selected ann ESP8266 board in Tools > Board.
Regards,
Sara
Great Website!
I installed the code for the project “ESP8266 Webserver with control outputs with momentary switch”. Works well. Question, I want to add two more buttons. But the Get statement does not have a variable attached as far as I see. In the past I’ve seen “if currentline.endswith(“Get/H”))
and it is easy to add “Get/L” or “Get/U” and so on, to add buttons
How do I add another button in this sketch?
Thanks
Mike
Thank you for the tutorial. very detailed and clear explanation.
I have tried to use %placeholder% to update the color of the push button relative to the state of a bit in the arduino program but i couldn’t get it to work.
Appreciate if you could guide me.
thanks,
Hi.
You need to provide more details.
How did you do that? Did you get any errors?
What is not working exactly?
Regards,
Sara