Range Finder

The Ultrasonic Range Finder measures the distance to the nearest object using sound waves. It works by sending out an ultrasonic pulse and measuring how long it takes for the sound to bounce back.

This page uses range_finder as the example Range Finder name. Replace it with your own configured name as needed.

Below is a list of available methods:

• found_object – Returns whether the Range Finder detects an object.

• distance – Returns the distance between the Range Finder and the nearest detected object.

Constructors – Manually initialize a Range Finder.

• Sonar – Create a Range Finder.

found_object

found_object returns a Boolean indicating whether the Range Finder detects an object within its field of view.

• True – The Range Finder is detecting an object.

• False – The Range Finder is not detecting an object.

Usage:
range_finder.found_object()

Parameters	Description
	This method has no parameters.

distance

distance returns the measured distance to the nearest object detected by the sensor.

Usage:
range_finder.distance(units)

Parameter	Description
units	The unit that will represent the distance: MM – millimeters INCHES

Constructors

Constructors are used to manually create Sonar objects, which are necessary for configuring Range Finders outside of VEXcode.

Sonar

Sonar creates a Range Finder.

Usage:
Sonar(port)

Parameter	Description
port	The 3-Wire Port that the Range Finder is connected to: On the V5 Brain – brain.three_wire_port.x where x is the number of the port. On a 3-Wire Expander – expander.a where expander is the name of the expander instance.

# Create a Range Finder in Port A
range_finder = Sonar(brain.three_wire_port.a)