ESP8266 NodeMCU with HC-SR04 Ultrasonic Sensor with Arduino IDE

Содержание

This guide shows how to use the HC-SR04 Ultrasonic Sensor with the ESP8266 NodeMCU board using the Arduino core. The ultrasonic sensor uses sonar to determine the distance to an object. We’ll show you how to wire the sensor to the ESP8266 and provide several example sketches to determine the distance to an object using the HC-SR04.

ESP8266 NodeMCU with HC-SR04 Ultrasonic Sensor with Arduino IDE

This tutorial covers the following topics:

Introducing the HC-SR04 Ultrasonic Sensor

The HC-SR04 ultrasonic sensor uses sonar to determine the distance to an object. This sensor reads from 2cm to 400cm (0.8inch to 157inch) with an accuracy of 0.3cm (0.1inches), which is good for most hobbyist projects. In addition, this particular module comes with ultrasonic transmitter and receiver modules.

The following picture shows the HC-SR04 ultrasonic sensor.

HC-SR04 Ultrasonic Sensor Module Distance Measurement Component Part Front

The next picture shows the other side of the sensor.

HC-SR04 Ultrasonic Sensor Module Distance Measurement Component Part Back

Where to buy HC-SR04 Ultrasonic Sensor?

You can check the Ultrasonic Sensor HC-SR04 sensor on Maker Advisor to find the best price:

HC-SR04 Ultrasonic Sensor Technical Data

The following table shows the key features and specs of the HC-SR04 ultrasonic sensor. For more information, you should consult the sensor’s datasheet.

Power Supply 5V DC
Working Current 15 mA
Working Frequency 40 kHz
Maximum Range 4 meters
Minimum Range 2 cm
Measuring Angle 15º
Resolution 0.3 cm
Trigger Input Signal 10uS TTL pulse
Echo Output Signal TTL pulse proportional to the distance range
Dimensions 45mm x 20mm x 15mm

HC-SR04 Ultrasonic Sensor Pinout

Here’s the pinout of the HC-SR04 Ultrasonic Sensor.

VCC Powers the sensor (5V)
Trig Trigger Input Pin
Echo Echo Output Pin
GND Common GND

How Does the HC-SR04 Ultrasonic Sensor Work?

The ultrasonic sensor uses sonar to determine the distance to an object. Here’s how it works:

  1. The ultrasound transmitter (trig pin) emits a high-frequency sound (40 kHz).
  2. The sound travels through the air. If it finds an object, it bounces back to the module.
  3. The ultrasound receiver (echo pin) receives the reflected sound (echo).

How HC-SR04 Ultrasonic Sensor Works

Taking into account the sound’s velocity in the air and the travel time (time passed since the transmission and reception of the signal) we can calculate the distance to an object. Here’s the formula:

  • speed of sound in the air at 20ºC (68ºF) = 343m/s

Parts Required

ESP8266 NodeMCU Board HC-SR04 Ultrasonic Sensor Module Arduino Demonstration

To complete this tutorial you need the following parts:

You can use the preceding links or go directly to MakerAdvisor.com/tools to find all the parts for your projects at the best price!

Schematic – ESP8266 NodeMCU with HC-SR04 Ultrasonic Sensor

Wire the HC-SR04 ultrasonic sensor to the ESP8266 as shown in the following schematic diagram. We’re connecting the Trig pin to GPIO 5 and the Echo pin to GPIO 18 , but you can use any other suitable pins.

ESP8266 NodeMCU Wiring Circuit Ultrasonic Sensor Diagram

Ultrasonic Sensor ESP8266
VCC VIN
Trig GPIO 12 (D6)
Echo GPIO 14 (D5)
GND GND

Preparing Arduino IDE

We’ll program the ESP8266 board using Arduino IDE. So, make sure you have the ESP8266 add-on installed. Follow the next tutorial:

If you want to use VS Code with the PlatformIO extension, follow the next tutorial instead to learn how to program the ESP8266:

Code – Getting Distance to an Object using the HC-SR04 Ultrasonic Sensor and ESP8266

The following sketch is a simple example of how you can get the distance between the sensor and an object using the ESP8266 board with the Arduino core.

Upload the code to your board and it will work straight away. Continue reading if you want to learn how the code works or skip to the demonstration section.

How the Code Works

First, define the trigger and the echo pins.

In this example, we’re using GPIO 12 and GPIO 14 . But you can use any other suitable GPIOs—read ESP8266 Pinout Reference: Which GPIO pins should you use?

The SOUND_SPEED variable saves the velocity of sound in the air at 20ºC. We’re using the value in cm/uS.

The CM_TO_INCH variable allows us to convert distance in centimeters to inches.

Then, initialize the following variables.

The duration variable saves the travel time of the ultrasonic waves (time elapsed since transmission and reception of the pulse wave). The distanceCm and distanceInch , as the names suggest, save the distance to an object in centimeters and inches.

setup()

In the setup() , initialize a serial communication at a baud rate of 115200 so that we can print the measurements on the Serial Monitor.

Define the trigger pin as an OUTPUT —the trigger pin emits the ultrasound. And define the echo pin as an INPUT —the echo pin receives the reflected wave and sends a signal to the ESP8266 that is proportional to the travel time.

In the loop() , the following lines produce a 10uS HIGH pulse on the trigger pin—this means the pin will emit an ultrasound. Note that before sending the pulse, we give a short LOW pulse to ensure you’ll get a clean HIGH pulse.

We use the pulseIn() function to get the sound wave travel time:

The pulseIn() function reads a HIGH or a LOW pulse on a pin. It accepts as arguments the pin and the state of the pulse (either HIGH or LOW). It returns the length of the pulse in microseconds. The pulse length corresponds to the time it took to travel to the object plus the time traveled on the way back.

Then, we simply calculate the distance to an object taking into account the sound speed.

Convert the distance to inches:

And finally, print the results on the Serial Monitor.

Demonstration

Upload the code to your board. Don’t forget to select the board you’re using in Tools Boards. Also, don’t forget to select the right COM port in Tools Port.

ESP8266 NodeMCU Board HC-SR04 Ultrasonic Sensor Module Arduino

After uploading, open the Serial Monitor at a baud rate of 115200. Press the on-board RST button to restart the board and it will start printing the distance to the closest object on the Serial Monitor. Something as shown in the picture below.

Ultrasonic Sensor ESP32 ESP8266 Get Distance to an Object Arduino

ESP8266 with HC-SR04 and OLED Display

ESP8266 NodeMCU Board HC-SR04 Ultrasonic Sensor Module Arduino OLED Parts Required

This section will show you a simple example with the ESP8266 that displays the distance on an I2C OLED display.

To better understand how the project works, we recommend taking a look at our ESP8266 tutorial with the I2C OLED display.

Parts Required

Here’s a list with the parts required to complete this example:

You can use the preceding links or go directly to MakerAdvisor.com/tools to find all the parts for your projects at the best price!

Schematic Diagram – ESP8266 with HC-SR04 and OLED Display

Wire all the parts as shown in the following schematic diagram.

ESP8266 NodeMCU Wiring Circuit Ultrasonic Sensor Diagram OLED Display SSD1306

Learn more about the OLED display with the ESP8266: ESP8266 OLED Display with Arduino IDE

Code – ESP8266 Display Distance (HC-SR04) on OLED Display

To use this example, make sure you have the Adafruit SSD1306 and Adafruit GFX libraries installed. You can install these libraries through the Arduino Library Manager.

Go to Sketch Library Manage Libraries, search for “SSD1306,” and install the SSD1306 library from Adafruit.

Install Library I2C OLED Display SSD1306 Arduino IDE

After installing the SSD1306 library from Adafruit, type “GFX” in the search box and install the library.

Installing GFX Library ESP8266 ESP32 Arduino

After installing the libraries, restart your Arduino IDE.

Then, simply copy the following code to your Arduino IDE and upload the code to the board.

How the Code Works

Start by including the required libraries for the OLED display:

Define the width and height of the OLED display. We’re using a 128×64 OLED display:

Create an Adafruit_SSD1306 object called display to handle the OLED display.

Define the pins that the HC-SR04 sensor is connected to.

Create variables to save the distance and the duration between the transmission and reception of the sound waves.

setup()

In the setup() , initialize a serial communication at a baud rate of 115200 so that we can print the results on the Serial Monitor.

Define the trigger pin as an OUTPUT and the echo pin as an INPUT .

Initialize the OLED display:

Set the font size and color for the display.

In the loop() is where we’ll get the distance and display it on the OLED.

Get the distance (we’ve already explained in the previous section how to calculate the distance).

Print the distance on the Serial Monitor.

Clear the display in each loop() to write new readings.

Set the display cursor to (0, 25).

The following lines print the distance in centimeters in the OLED display.

Comment the previous lines and uncomment the following lines if you want to display the readings in inches.

Lastly, call display.display() to actually show the readings on the OLED.

The distance is updated every 500 milliseconds.

Demonstration

Go to Tools Board and select the ESP8266 board you’re using. Go to Tools Port and select the port your board is connected to. Then, click the upload button.

Open the Serial Monitor at a baud rate of 115200, press the on-board RST button. The sensor measurements will be displayed both on the Serial Monitor and on the OLED display.

Move an object in front of the sensor and see the values changing.

ESP8266 NodeMCU Board HC-SR04 Ultrasonic Sensor Module Arduino OLED Demonstration

You can watch a quick video demonstration:

Wrapping Up

The HC-SR04 Ultrasonic Sensor allows us to determine the distance to an object. In this tutorial you’ve learned how to use the HC-SR04 with the ESP8266. We have tutorials for other popular sensors that you may like:


Источник: randomnerdtutorials.com