Package ev3dev.sensors.ev3

Class EV3UltrasonicSensor

java.lang.Object

ev3dev.hardware.EV3DevFileSystem

ev3dev.hardware.EV3DevPlatforms

ev3dev.hardware.EV3DevDevice

ev3dev.hardware.EV3DevSensorDevice

ev3dev.sensors.BaseSensor

ev3dev.sensors.ev3.EV3UltrasonicSensor

All Implemented Interfaces:

SensorMode, SensorModes

public class EV3UltrasonicSensor
extends BaseSensor

Lego EV3 Ultrasonic sensors
The EV3 Ultrasonic sensors measures distance to an object in front of the sensors. It can also be used to detect other (active) Ultrasonic sensors in the vicinity.

Sensor configuration
The sensors can be switched off and on using the enable() and disable() methods. Disabling the sensors also shuts down the lights.

See Sensor Product page See The leJOS sensors framework See leJOS conventions for SampleProviders

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	EV3UltrasonicSensor.DistanceMode
private class	EV3UltrasonicSensor.ListenMode Represents a Ultrasonic sensors in listen mode

Field Summary

Fields

Modifier and Type	Field and Description
private static int	DISABLED
private static java.lang.String	LEGO_EV3_US

Fields inherited from class ev3dev.sensors.BaseSensor

currentMode, currentModeS, modes, SWITCH_DELAY

Fields inherited from class ev3dev.hardware.EV3DevSensorDevice

LEGO_ANALOG_SENSOR, LEGO_I2C, LEGO_UART_SENSOR, SENSOR_MODE, SENSOR_MODES

Fields inherited from class ev3dev.hardware.EV3DevDevice

ADDRESS, DEVICE, LEGO_PORT, LEGO_SENSOR, MODE, PATH_DEVICE

Fields inherited from class ev3dev.hardware.EV3DevFileSystem

EV3DEV_ROOT_PATH, EV3DEV_TESTING_KEY, ROOT_PATH

Constructor Summary

Constructors

Constructor and Description
EV3UltrasonicSensor(Port portName) Create the Ultrasonic sensors class.

Method Summary

Modifier and Type	Method and Description
void	disable() Disable the sensors.
void	enable() Enable the sensors.
SampleProvider	getDistanceMode() Lego EV3 Ultrasonic sensors, Distance mode Measures distance to an object in front of the sensors
SampleProvider	getListenMode() Lego EV3 Ultrasonic sensors, Listen mode Listens for the presence of other ultrasonic sensors.
private void	init()
boolean	isEnabled() Indicate that the sensors is enabled.

Methods inherited from class ev3dev.sensors.BaseSensor

fetchSample, getAvailableModes, getCurrentMode, getMode, getMode, getModeCount, getName, sampleSize, setCurrentMode, setCurrentMode, setModes, switchMode, switchMode

Methods inherited from class ev3dev.hardware.EV3DevDevice

detect, getIntegerAttribute, getStringAttribute, setIntegerAttribute, setStringAttribute

Methods inherited from class ev3dev.hardware.EV3DevPlatforms

getMotorPort, getPlatform, getSensorPort

Methods inherited from class ev3dev.hardware.EV3DevFileSystem

getROOT_PATH

Methods inherited from class java.lang.Object

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

Field Detail

DISABLED

private static final int DISABLED

See Also:

Constant Field Values

LEGO_EV3_US

private static final java.lang.String LEGO_EV3_US

See Also:

Constant Field Values

Constructor Detail

EV3UltrasonicSensor

public EV3UltrasonicSensor(Port portName)

Create the Ultrasonic sensors class.

Parameters:

portName - port

Method Detail

init

private void init()

getListenMode

public SampleProvider getListenMode()

Lego EV3 Ultrasonic sensors, Listen mode
Listens for the presence of other ultrasonic sensors.

Size and content of the sample
The sample contains one elements indicating the presence of another ultrasonic sensors. A value of 1 indicates that the sensors detects another ultrasonic sensors.

Returns:

A sampleProvider

getDistanceMode

public SampleProvider getDistanceMode()

Lego EV3 Ultrasonic sensors, Distance mode
Measures distance to an object in front of the sensors

Size and content of the sample
The sample contains one elements representing the distance (in metres) to an object in front of the sensors. unit).

Returns:

A sampleProvider

enable

public void enable()

Enable the sensors. This puts the indicater LED on.

disable

public void disable()

Disable the sensors. This puts the indicater LED off.

isEnabled

public boolean isEnabled()

Indicate that the sensors is enabled.

Returns:

True, when the sensors is enabled.
False, when the sensors is disabled.