ezButton Library - Single Button Events Example

Hardware Required

1×Arduino UNO or Genuino UNO
1×USB 2.0 cable type A/B
1×Push Button
1×(Optional) Panel-mount Push Button
1×Jumper Wires
1×(Optional) 9V Power Adapter for Arduino
1×(Recommended) Screw Terminal Block Shield for Arduino Uno
1×(Optional) Transparent Acrylic Enclosure For Arduino Uno
Please note: These are Amazon affiliate links. If you buy the components through these links, We will get a commission at no extra cost to you. We appreciate it.

About Button

About Button Library

Wiring Diagram

Arduino Button Library Wiring Diagram

This image is created using Fritzing. Click to enlarge image

Arduino Code

Quick Steps

  • Install ezButton library. See How To
  • Connect Arduino to PC via USB cable
  • Open Arduino IDE, select the right board and port
  • On Arduino IDE, Go to File Examples ezButton 02.SingleButtonEvents example
/* * Created by ArduinoGetStarted.com * * This example code is in the public domain * * Tutorial page: https://arduinogetstarted.com/tutorials/arduino-button-library * * This example detects the pressed and released events of a button without debounce. */ #include <ezButton.h> ezButton button(7); // create ezButton object that attach to pin 7; void setup() { Serial.begin(9600); } void loop() { button.loop(); // MUST call the loop() function first if(button.isPressed()) Serial.println("The button is pressed"); if(button.isReleased()) Serial.println("The button is released"); }
  • Click Upload button on Arduino IDE to upload code to Arduino
Arduino IDE Upload Code
  • Open Serial Monitor to see result:
  • Press the button and then release
The button is pressed The button is released
Autoscroll Show timestamp
Clear output
9600 baud  


Even you pressed and released the button only once, the output in Serial Monitor may show several pressed and release events. This is the normal behavior of the button. This behavior is called the “chattering phenomenon”. You can learn more in Arduino - Button Debounce tutorial.

To make it much easier, we can use the debouce function of this library. See Button debounce example with library.

Code Explanation

Read the line-by-line explanation in comment lines of source code!

The Best Arduino Starter Kit