Package ev3dev.sensors.ev3

Class EV3IRSensor

java.lang.Object

ev3dev.hardware.EV3DevFileSystem

ev3dev.hardware.EV3DevPlatforms

ev3dev.hardware.EV3DevDevice

ev3dev.hardware.EV3DevSensorDevice

ev3dev.sensors.BaseSensor

ev3dev.sensors.ev3.EV3IRSensor

All Implemented Interfaces:

SensorMode, SensorModes

public class EV3IRSensor
extends BaseSensor

EV3 Infra Red sensors
The digital EV3 Infrared Seeking Sensor detects proximity to the robot and reads signals emitted by the EV3 Infrared Beacon. The sensors can alse be used as a receiver for a Lego Ev3 IR remote control. EV3 Infra Red sensors
The sensors can be used as a receiver for up to four Lego Ev3 IR remote controls using the methods. 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	EV3IRSensor.DistanceMode
private class	EV3IRSensor.RemoteMode
private class	EV3IRSensor.SeekMode

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	LEGO_EV3_IR

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
EV3IRSensor(Port portName)

Method Summary

Modifier and Type	Method and Description
SensorMode	getDistanceMode() EV3 Infra Red sensors, Distance mode Measures the distance to an object in front of the sensors.
SensorMode	getRemoteMode()
SensorMode	getSeekMode() EV3 Infra Red sensor, Seek mode In seek mode the sensor locates up to four beacons and provides bearing and distance of each beacon.
private void	init()

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

LEGO_EV3_IR

private static final java.lang.String LEGO_EV3_IR

See Also:

Constant Field Values

Constructor Detail

EV3IRSensor

public EV3IRSensor(Port portName)

Method Detail

init

private void init()

getDistanceMode

public SensorMode getDistanceMode()

EV3 Infra Red sensors, Distance mode
Measures the distance to an object in front of the sensors.

Size and content of the sample
The sample contains one element giving the distance to an object in front of the sensors. The distance provided is very roughly equivalent to meters but needs conversion to give better distance. See product page for details.
The effective range of the sensors in Distance mode is about 5 to 50 centimeters. Outside this range a zero is returned for low values and positive infinity for high values.

Returns:

A sampleProvider See leJOS conventions for SampleProviders See Sensor Product page

getSeekMode

public SensorMode getSeekMode()

EV3 Infra Red sensor, Seek mode
In seek mode the sensor locates up to four beacons and provides bearing and distance of each beacon.

Size and content of the sample
The sample contains four pairs of elements in a single sample. Each pair gives bearing of and distance to the beacon. The first pair of elements is associated with a beacon transmitting on channel 0, the second pair with a beacon transmitting on channel 1 etc.
The bearing values range from -25 to +25 (with values increasing clockwise when looking from behind the sensor). A bearing of 0 indicates the beacon is directly in front of the sensor.
Distance values are not to scale. Al increasing values indicate increasing distance.
If no beacon is detected both bearing is set to zero, and distance to positive infinity.

Returns:

A sampleProvider See leJOS conventions for SampleProviders See Sensor Product page

getRemoteMode

public SensorMode getRemoteMode()