---
tags: fabacademy, sensors, mdef, workshops
---

# HC-SR04 → Ultrasonic distance sensor

> Ultrasonic Sensor HC-SR04 is a sensor that can measure **distance**. It emits an ultrasound at 40 000 Hz (40kHz) which travels through the air and if there is an object or obstacle on its path It will bounce back to the module. Considering the travel time and the speed of the sound you can calculate the distance.


Connect the sensor taking note wich pins you are using for the **Trig** and **Echo** marked pins.

:::danger
Since the HC-SR04 is a **5V device** it won't work with the 3.3V provided by the ESP, but we can connect the **HC-SR04 VCC pin to Vin pin on the ESP** to power the sensor with 5V.
:::

> In order to generate the ultrasound we need to set the **Trigger Pin** on a **High** State for 10 µs. That will send out an 8 cycle sonic burst which will travel at the speed sound and it will be received in the Echo Pin. The Echo Pin will output the time in microseconds the sound wave traveled.


> For example, if the object is 20 cm away from the sensor, and the **speed of the sound is 340 m/s or 0.034 cm/µs** the sound wave will need to travel about 588 microseconds. But what you will get from the Echo pin will be double that number because the sound wave needs to travel forward and bounce backward. So in order to get the distance in cm we need to **multiply the received travel time value from the echo pin by 0.034 and divide it by 2.**

Code example
~~~clike
// Define pin's number
#define echoPin D7 // Pin number connected to Echo
#define trigPin D8 // Pin number connected to Trigger

// defines variables
long duration; // variable for the duration of sound wave travel
int distance; // variable for the distance measurement

void setup() {
pinMode(trigPin, OUTPUT);
pinMode(echoPin, INPUT);
Serial.begin(115200);
}

void loop() {

// Clears the trigPin condition
digitalWrite(trigPin, LOW);
delayMicroseconds(2);

// Sets the trigPin HIGH (ACTIVE) for 10 microseconds
digitalWrite(trigPin, HIGH);
delayMicroseconds(10);
digitalWrite(trigPin, LOW);

// Reads the echoPin, returns the sound wave travel time in microseconds
duration = pulseIn(echoPin, HIGH);

// Calculating the distance
distance = duration * 0.034 / 2; // Speed of sound wave divided by 2 (go and back)

// Displays the distance (in cm) on the Serial Monitor
Serial.println(distance);
delay(100);
}
~~~


:::info
**References**
Arduino [tutorial](https://create.arduino.cc/projecthub/abdularbi17/ultrasonic-sensor-hc-sr04-with-arduino-tutorial-327ff6)
[ESP8266 is 5V-tolerant after all?](https://hackaday.io/page/2024-esp8266-is-5v-tolerant-after-all)
HC-SR04 [Datasheet](https://cdn.sparkfun.com/datasheets/Sensors/Proximity/HCSR04.pdf)
:::