Upgrade to ARC Pro

Harnessing the power of ARC Pro, your robot can be more than just a simple automated machine.


Ultrasonic Collision Detection

How to add the Ultrasonic Collision Detection robot skill

  1. Load the most recent release of ARC (Get ARC).
  2. Press the Project tab from the top menu bar in ARC.
  3. Press Add Robot Skill from the button ribbon bar in ARC.
  4. Choose the Ultrasonic Distance category tab.
  5. Press the Ultrasonic Collision Detection icon to add the robot skill to your project.

Don't have a robot yet?

Follow the Getting Started Guide to build a robot and use the Ultrasonic Collision Detection robot skill.

How to use the Ultrasonic Collision Detection robot skill

Ultrasonic sensors use sonar (sound navigation ranging) to determine the distance to an object or wall, the same way that some animals like bats and dolphins do. They offer excellent range and accuracy in an easy-to-use package. Their operation is not affected by sunlight or black materials, as infrared sensors are. However, they do have trouble with some soft materials, the sonar echo works ideally when bouncing off hard surfaces.

When an HC-SR04 or equivalent Ultrasonic Distance Sensor is connected to an EZB, this skill will Stop a movement panel if an object is detected within the specified range. This skill does not cause a robot to steer or avoid obstacles; it merely stops the robot when the minimum distance is detected. For object avoidance and steering use the Radar skill.

This skill is integrated with scripting and will update when GetPing() is called (with matching port configured) and the PAUSE checkbox is checked. That way you can have this skill on your project but it won't use any communication resources unless it's called from a script with GetPing(). What this means is you can leave the PAUSED checkbox checked, and this skill will be updated when GetPing() is called.

It's worth noting that the distance displayed is not a unit of CM or Inches. The distance value is an arbitrary number that is related to the type of sensor, voltage, detected material, and temperature. If a specific distance unit is required, use a tape measure to identify the distance value.

Main Window

1. Ultrasonic Distance Value
This is a value between 0-255 that corresponds to the detected distance being sent by the ultrasonic sensor. If the value is the color red it indicates that the collision min distance has been achieved. If it's green the minimum distance hasn't been reached yet.

2. Bar Display
Displays a visual representation of the detected ultrasonic distance value.

3. Pause Checkbox
This checkbox pauses the capture of the ultrasonic distance value.


1. Title Field
This field contains the title of the skill. You can change it if you'd like. *Note: Changing the title will also change the title in the controlCommand() associated with this skill.

2. Board Index Drop-down
Select the EZB index number that your ultrasonic sensor is connected to.

3. Trigger Port Drop-down
Select the digital port that your ultrasonic trigger wire is connected to.

4. Echo Port Drop-down
Select the digital port that your ultrasonic echo wire is connected to. *Note: This port must be the same as the trigger port when using a 3-wire Ultrasonic sensor.

5. Interval Drop-down
This drop-down selects the interval rate in milliseconds that the ultrasonic sensor will be sampled at. The range is 100-60000 milliseconds. The default setting is 250.

6. Minimum Distance Drop-down
This drop-down selects the minimum distance that the ultrasonic sensor can detect before turning the ultrasonic distance value red and sending the Stop command to a movement panel. The range is 1-255. The default value is 30.

Wiring Diagram

Ultrasonic Distance Sensors come in 2 versions. A 4-wire type with/without an inline voltage regulator and 3 wires with/without a built-in voltage regulator. If an Ultrasonic has a voltage regulator it will need +6V or greater Voltage input, if it doesn't it will need +5V.

3-wire Wiring (with built-in regulator)
  • Ground = Black wire to GND
  • Power = Red wire to Vin
  • Trigger/Echo = white wire to Digital pin
4-wire Wiring (with regulator)
  • Ground = Black wire from regulator to GND
  • Power = Red wire from regulator to Vin
  • Trigger = white wire to Digital pin
  • Echo = green wire to a second Digital pin

How to Use Ultrasonic Collision Detection

1) Connect a Ultrasonic sensor to an EZB.

2) Add the Ultrasonic Collision Detection Skill to your ARC project (Project -> Add Skill -> Ultrasonic -> Collision Detection).

3) Setup the collision minimum distance value in the Settings menu.

4) Connect a Robot to EZB + ultrasonic sensor.

5) Add a Movement Panel Skill to your ARC project (Project -> Add Skill -> Movement Panels).

6) Start the Robot on it's movement trajectory and watch it stop when the ultrasonic minimum distance is detected.

Fix Resolution

Tech Detail Video


You will need an EZB I/O Controller and a Ultrasonic Sensor to use this skill.


Synthiam has a ultrasonic hardware reference design here.


Upgrade to ARC Pro

Unleash your creativity with the power of easy robot programming using Synthiam ARC Pro