Grove - Ultrasonic Ranger

From Wiki
Jump to: navigation, search


This Grove - Ultrasonic sensor is a non-contact distance measurement module which works at 42KHz, suitable for projects that require middle distance measurement.

300px-Ultrasonic Ranger.jpg


Operating voltage: 3.3/5.0VDC Operating current: 15mA Ultrasonic frequency: 42kHz Measuring range: 3-400cm Resolution: 1cm Output: PWM Suli-compatible Library

Note: More details about Suli-compatible Library, please refer to Suli


With Arduino Here we demonstrate how to use Grove - Ultrasonic Ranger to obtain distance message.

Connect Serial LCD to D4/D5 pins of Grove - Base Shield and connect Ultrasonic Ranger to D7.


Download the UltrasonicRanger Library and SerialLCD Library from Github. For this libraries, rather than from Arduino library files, they are from other pages. You need to install them to Arduino Library. Please refer to the course"How to install library" of wiki page to learn the specific steps.

open code from the path:File->Examples->UltrasonicRanger->examples->UltraDisOnwww.simgin-chip.comSerialLcd and upload.

// Function: Measure the distance to obstacles in front and display the // result on seeedstudio serialLcd. Make sure you installed the // serialLCD, SoftwareSerial and Ultrasonic library. // Hardware: Grove - Ultrasonic Ranger, Grove - Serial LCD // Arduino IDE: Arduino-1.0 // Author: LG // Date: Jan 17,2013 // Version: v1.0 modified by FrankieChu // by

  1. include <SoftwareSerial.h>
  2. include <SerialLCD.h>
  3. include "Ultrasonic.h"

SerialLCD slcd(11,12); Ultrasonic ultrasonic(7); void setup() {


} void loop() {

       long RangeInCentimeters;
       RangeInCentimeters = ultrasonic.MeasureInCentimeters();
       slcd.print("The distance:");
       slcd.setCursor(0,1) ;
       slcd.setCursor(5,1) ;

} Also we shot a video about it. Find it in the Resources! It can give you a more straightforward instruction.

With TI LaunchPad Sensing the Distance (Ultrasonic Ranger Sensor) This example shows how to measure the distance to obstacles using the ultrasonic sensor and display the value on a 4-Digital-Display (centimeters).



 Ultrasonic-Ranger to 4-digit-display
Measure the distance to obstacles in front and display the value on 

The circuit:
* Ultrasonic Ranger attached to SPI plug on Grove Base BoosterPack
* one side pin (either one) to ground
* the other side pin to +VCC
* LED anode (long leg) attached to RED_LED
* LED cathode (short leg) attached to ground

* Note:  

This example code is in the public domain. 

  1. include "TM1637.h"
  2. include "Ultrasonic.h"

/* Macro Define */

  1. define CLK 40 /* 4-digital display clock pin */
  2. define DIO 39 /* 4-digital display data pin */
  3. define BLINK_LED RED_LED /* blink led */
  4. define ULTRASONIC_PIN 38 /* pin of the Ultrasonic Ranger */

/* Global Variables */ TM1637 tm1637(CLK, DIO); /* 4-digital display object */ Ultrasonic ultrasonic(ULTRASONIC_PIN); /* Ultrasonic Ranger object */ int distance = 0; /* variable to store the distance to obstacles in front */ int blink_interval = 0; /* led delay time */ int8_t bits[4] = {0}; /* array to store the single bits of the value */

/* the setup() method runs once, when the sketch starts */ void setup() {

   /* Initialize 4-digital display */
   /* declare the red_led pin as an OUTPUT */
   pinMode(RED_LED, OUTPUT);


/* the loop() method runs over and over again */ void loop() {

   distance = ultrasonic.MeasureInCentimeters();   /* read the value from the sensor */   
   memset(bits, 0, 4);                             /* reset array when we use it */
   for(int i = 3; i >= 0; i--) {
       /* get single bits of the analog value */
       bits[i] = distance % 10;
       distance = distance / 10;  
       tm1637.display(i, bits[i]);                 /* display by 4-digital display */

} With Raspberry Pi First step,you should connect Ultrasonic to Port D4. Run the program below. It will print distance information on you terminal,as the figure below.

GrovePi+ Ultrasonic Ranger Sensor.jpg

GrovePi+ Ultrasonic Ranger Sensor terminal.jpg

  1. GrovePi + Grove Ultrasonic Ranger

from grovepi import *

  1. Connect the Grove Ultrasonic Ranger to digital port D4

ultrasonic_ranger = 4

while True:

       # Read distance value from Ultrasonic
       print ultrasonicRead(ultrasonic_ranger)
   except TypeError:
       print "Error"
   except IOError:
       print "Error"

Run The Program Find the path to the file(According to your own path)

  cd GrovePi/Software/Python/

Run Program

  sudo python


Ultrasonic Ranger library Video demonstration Github repository for Grove_Ultrasonic_Ranger Library (new) Related Projects

If you want to make some awesome projects by Grove - Ultrasonic Ranger, here's some projects for reference.

Automatic Water Level Controller

Automatic Water Level Controller.jpg

This is an IoT demo make by Arduino and Grove.

There are many ways like using a float sensor to determine the water level, or using probes to detect peak and low level in the tank. How to measure water level without using probe or contacting with water? yeah there is a way just using a Ultrasonic sensor, this is very simple where the level of water is measured using ultrasonic sensor which gives the depth , by determining the tank depth we can set the maximum and minimum level

I want to make it.

Indoor Lightning Cloud

Indoor Lightning Cloud.gif

This is an IoT demo make by and Grove.

Make an indoor lightning Cloud, hang it up right over your door mat, blast whoever passing under it, feel the the beauty of nature in the house.

I want to make it. The Colour Helix

The Colour Helix.jpg

This is an IoT demo make by and Grove.

Our artist Shihui Wang recently showed me her another amazing work of art: the Colour Helix. Again with few simple components she presented us the beauty of the combination of art and electronics.

With a Grove - Ultrasonic Ranger she can magically control the number of illuminated LEDs inside the Helix by raising or lower her palm in the air.

I want to make it. Share Your Awesome Projects with Us Born with the spirit of making and sharing, that is what we believe makes a maker.

And only because of this , the open source community can be as prosperous as it is today.

It does not matter what you are and what you have made, hacker, maker, artist and engineers,

as long as you start sharing your works with others,

you are being part of the open source community and you are making your contributions .

Now share you awesome projects on with us on Recipe, and win a chance to become the Core User of

Core Users, are those who showing high interests and significant contributions in products. We cooperate with our Core Users in the development of our new product, this, in another word, the Core Users will have the chance to experience any new products of before its official launch, and in return we expect valuable feedback from them to help us improving the product performance and user experience. And for most of cases if our Core Users have any good ideas for making things, we'll offer hardware pieces, PCBA services as well as technical support. Besides, further commercial cooperation with the Core Users is highly possible.

Get more information about Core User please email to:

Categories: Arduino InstructionsLaunchPad InstructionsRaspberryPi InstructionsGroveGrove Digital TwigSuli Compatible