ShefRobot

Class UltrasonicSensor

java.lang.Object

ShefRobot.Sensor<ShefRobot.UltrasonicSensorAction>

ShefRobot.UltrasonicSensor

All Implemented Interfaces:

Runnable

public class UltrasonicSensor
extends Sensor<ShefRobot.UltrasonicSensorAction>

This class represents an EV3 UltrasonicSensor which has two modes of operation UltrasonicSensor.Mode.DISTANCE and UltrasonicSensor.Mode.LISTEN By default the sensor starts in UltrasonicSensor.Mode.DISTANCE mode.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UltrasonicSensor.Mode Modes that this sensor can be used in

Nested classes/interfaces inherited from class ShefRobot.Sensor

Sensor.Port

Method Summary

Modifier and Type	Method and Description
float	getDistance() Returns the distance detected by the sensor in metres When in distance mode, the Ultrasonic sensors light will be solid and it will continuously emit pings Values outside of the approximate range ~0.03-1.7m are returned as Float.POSITIVE_INFINITY
boolean	listen() When in Listen mode the Ultrasonic sensor will not emit ultrasound, it will only listen for other robots ultrasound.
void	run() This method is for internal use, it exists due to Sensors and Motors both extending runnable.

Methods inherited from class ShefRobot.Sensor

getRawSample

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getDistance

public float getDistance()

Returns the distance detected by the sensor in metres When in distance mode, the Ultrasonic sensors light will be solid and it will continuously emit pings Values outside of the approximate range ~0.03-1.7m are returned as Float.POSITIVE_INFINITY

Returns:

The distance detected by the ultrasonic sensor

listen

public boolean listen()

When in Listen mode the Ultrasonic sensor will not emit ultrasound, it will only listen for other robots ultrasound. When in Listen mode the Ultrasonic sensors light will blink It may take upto 300ms, after the first call to listen() for the sensor to stop reading it's own pings

Returns:

Whether the ultrasonic sensor detects any ultrasonic pings

run

public void run()

This method is for internal use, it exists due to Sensors and Motors both extending runnable.

Specified by:

run in interface Runnable