ESP32 OLED Display with Arduino IDE<\/a><\/p>\n\n\n\nCode – ESP32 Display Distance (HC-SR04) on OLED Display<\/h3>\n\n\n\n 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.<\/p>\n\n\n\n
Go to Sketch <\/strong>> Library<\/strong> > Manage Libraries<\/strong>, search for “SSD1306,<\/strong>” and install the SSD1306 library from Adafruit.<\/p>\n\n\n\nAfter installing the SSD1306 library from Adafruit, type \u201cGFX<\/strong>\u201d in the search box and install the library.<\/p>\n\n\n\nAfter installing the libraries, restart your Arduino IDE.<\/p>\n\n\n\n
Then, simply copy the following code to your Arduino IDE and upload the code to the board.<\/p>\n\n\n
\/*********\n Rui Santos\n Complete project details at https:\/\/RandomNerdTutorials.com\/esp32-hc-sr04-ultrasonic-arduino\/\n \n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files.\n \n The above copyright notice and this permission notice shall be included in all\n copies or substantial portions of the Software.\n*********\/\n\n#include <Wire.h>\n#include <Adafruit_GFX.h>\n#include <Adafruit_SSD1306.h>\n\n#define SCREEN_WIDTH 128 \/\/ OLED display width, in pixels\n#define SCREEN_HEIGHT 64 \/\/ OLED display height, in pixels\n\n\/\/ Declaration for an SSD1306 display connected to I2C (SDA, SCL pins)\nAdafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);\n\nconst int trigPin = 5;\nconst int echoPin = 18;\n\n\/\/define sound speed in cm\/uS\n#define SOUND_SPEED 0.034\n#define CM_TO_INCH 0.393701\n\nlong duration;\nint distanceCm;\nint distanceInch;\n\nvoid setup() {\n Serial.begin(115200);\n pinMode(trigPin, OUTPUT); \/\/ Sets the trigPin as an Output\n pinMode(echoPin, INPUT); \/\/ Sets the echoPin as an Input\n\n if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) {\n Serial.println(F("SSD1306 allocation failed"));\n for(;;);\n }\n delay(500);\n display.clearDisplay();\n\n display.setTextSize(2);\n display.setTextColor(WHITE);\n}\n\nvoid loop() {\n \/\/ Clears the trigPin\n digitalWrite(trigPin, LOW);\n delayMicroseconds(2);\n \/\/ Sets the trigPin on HIGH state for 10 micro seconds\n digitalWrite(trigPin, HIGH);\n delayMicroseconds(10);\n digitalWrite(trigPin, LOW);\n \n \/\/ Reads the echoPin, returns the sound wave travel time in microseconds\n duration = pulseIn(echoPin, HIGH);\n \n \/\/ Calculate the distance\n distanceCm = duration * SOUND_SPEED\/2;\n \n \/\/ Convert to inches\n distanceInch = distanceCm * CM_TO_INCH;\n \n \/\/ Prints the distance in the Serial Monitor\n Serial.print("Distance (cm): ");\n Serial.println(distanceCm);\n Serial.print("Distance (inch): ");\n Serial.println(distanceInch);\n\n display.clearDisplay();\n display.setCursor(0, 25);\n \/\/Display distance in cm\n display.print(distanceCm);\n display.print(" cm");\n \n \/\/ Display distance in inches\n \/* display.print(distanceInch);\n display.print(" in");*\/\n display.display(); \n\n delay(500); \n}\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\nHow the Code Works<\/h3>\n\n\n\n Start by including the required libraries for the OLED display:<\/p>\n\n\n\n
#include <Wire.h>\n#include <Adafruit_GFX.h>\n#include <Adafruit_SSD1306.h><\/code><\/pre>\n\n\n\nDefine the width and height of the OLED display. We’re using a 128×64 OLED display:<\/p>\n\n\n\n
#define SCREEN_WIDTH 128 \/\/ OLED display width, in pixels\n#define SCREEN_HEIGHT 64 \/\/ OLED display height, in pixels<\/code><\/pre>\n\n\n\nCreate an Adafruit_SSD1306<\/span> object called display<\/span> to handle the OLED display.<\/p>\n\n\n\nAdafruit_SSD1306 display = Adafruit_SSD1306(128, 64, &Wire);<\/code><\/pre>\n\n\n\nDefine the pins that the HC-SR04 sensor is connected to.<\/p>\n\n\n\n
const int trigPin = 5;\nconst int echoPin = 18;<\/code><\/pre>\n\n\n\nCreate variables to save the distance and the duration between the transmission and reception of the sound waves.<\/p>\n\n\n\n
long duration;\nint distanceCm;\nint distanceInch;<\/code><\/pre>\n\n\n\nsetup()<\/h4>\n\n\n\n In the setup()<\/span>, initialize a serial communication at a baud rate of 115200 so that we can print the results on the Serial Monitor.<\/p>\n\n\n\nSerial.begin(115200);<\/code><\/pre>\n\n\n\nDefine the trigger pin as an OUTPUT<\/span> and the echo pin as an INPUT<\/span>.<\/p>\n\n\n\npinMode(trigPin, OUTPUT); \/\/ Sets the trigPin as an Output\npinMode(echoPin, INPUT); \/\/ Sets the echoPin as an Input<\/code><\/pre>\n\n\n\nInitialize the OLED display:<\/p>\n\n\n\n
if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) {\n Serial.println(F(\"SSD1306 allocation failed\"));\n for(;;);\n}<\/code><\/pre>\n\n\n\nSet the font size and color for the display.<\/p>\n\n\n\n
display.setTextSize(2);\ndisplay.setTextColor(WHITE);<\/code><\/pre>\n\n\n\nloop()<\/h4>\n\n\n\n In the loop()<\/span> is where we’ll get the distance and display it on the OLED.<\/p>\n\n\n\nGet the distance (we’ve already explained in the previous section how to calculate the distance).<\/p>\n\n\n\n
\/\/ Clears the trigPin\ndigitalWrite(trigPin, LOW);\ndelayMicroseconds(2);\n\/\/ Sets the trigPin on HIGH state for 10 micro seconds\ndigitalWrite(trigPin, HIGH);\ndelayMicroseconds(10);\ndigitalWrite(trigPin, LOW);\n \n\/\/ Reads the echoPin, returns the sound wave travel time in microseconds\nduration = pulseIn(echoPin, HIGH);\n \n\/\/ Calculate the distance\ndistanceCm = duration * SOUND_SPEED\/2;\n \n\/\/ Convert to inches\ndistanceInch = distanceCm * CM_TO_INCH;<\/code><\/pre>\n\n\n\nPrint the distance on the Serial Monitor.<\/p>\n\n\n\n
\/\/ Prints the distance on the Serial Monitor\nSerial.print(\"Distance (cm): \");\nSerial.println(distanceCm);\nSerial.print(\"Distance (inch): \");\nSerial.println(distanceInch);<\/code><\/pre>\n\n\n\n
![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/ESP32-HC-SR04-Ultrasonic-Sensor-with-Arduino-IDE-Tutorial.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"HC-SR04](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/HC-SR04-Ultrasonic-Sensor-Module-Distance-Measurement-Component-Part-Front.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"HC-SR04](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/HC-SR04-Ultrasonic-Sensor-Module-Distance-Measurement-Component-Part-Back.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"How](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/how-ultrasonic-sensor-works-01.png?resize=750%2C453&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/ESP32-Board-HC-SR04-Ultrasonic-Sensor-Module-Arduino.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2017\/10\/header-200.png?w=1200&quality=100&strip=all&ssl=1\")
<\/a><\/p>\n\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/ESP32-Ultrasonic-Sensor-Wiring-Fritzing-Diagram.png?resize=846%2C688&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/ESP32-Board-HC-SR04-Ultrasonic-Sensor-Module-Arduino-Demonstration.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"Ultrasonic](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/Ultrasonic-Sensor-ESP32-ESP8266-Get-Distance-To-An-Object-Arduino.png?resize=601%2C525&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/ESP32-Board-HC-SR04-Ultrasonic-Sensor-Module-Arduino-OLED-Parts.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/ESP32-Ultrasonic-Sensor-I2C-OLED-Display-Wiring-Diagram.png?resize=750%2C1035&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"Install](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/install-ssd1306-adafruit-library.png?resize=788%2C443&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/install-gfx-library-adafruit.png?resize=786%2C443&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n