ch.aplu.android.ev3

Class LightSensor

java.lang.Object

ch.aplu.android.ev3.Part

ch.aplu.android.ev3.Sensor

ch.aplu.android.ev3.LightSensor

public class LightSensor
extends Sensor

Class that represents a light sensor (EV3 color sensor in RED mode). The red LED is automatically turned on.

Constructor Summary

Constructors

Constructor and Description
LightSensor() Creates a sensor instance connected to port S1.
LightSensor(SensorPort port) Creates a sensor instance connected to the given port.

Method Summary

Methods

Modifier and Type	Method and Description
void	activate(boolean enable) Turns on/off the LED used for reflecting light back into the sensor.
void	addLightListener(LightListener lightListener) Registers the given light listener with default trigger level 500.
void	addLightListener(LightListener lightListener, int triggerLevel) Registers the given light listener for the given trigger level.
int	getValue() Polls the sensor.
int	setTriggerLevel(int triggerLevel) Sets a new trigger level and returns the previous one.

Methods inherited from class java.lang.Object

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

Constructor Detail

LightSensor

public LightSensor(SensorPort port)

Creates a sensor instance connected to the given port.

Parameters:

port - the port where the sensor is plugged-in

LightSensor

public LightSensor()

Creates a sensor instance connected to port S1.

Method Detail

addLightListener

public void addLightListener(LightListener lightListener,
                    int triggerLevel)

Registers the given light listener for the given trigger level.

Parameters:

lightListener - the LightListener to become registered.

triggerLevel - the trigger level where the callback is triggered

addLightListener

public void addLightListener(LightListener lightListener)

Registers the given light listener with default trigger level 500.

Parameters:

lightListener - the LightListener to become registered.

setTriggerLevel

public int setTriggerLevel(int triggerLevel)

Sets a new trigger level and returns the previous one.

Parameters:

triggerLevel - the new trigger level

Returns:

the previous trigger level

getValue

public int getValue()

Polls the sensor.

Returns:

the current value the sensor reported: 0 (dark) .. >1000 (bright)

activate

public void activate(boolean enable)

Turns on/off the LED used for reflecting light back into the sensor. Due to a bug in leJOS version 0.8-beta, the floodlight is activated when the sensor is read.

Parameters:

enable - if true, turn the LED on, otherwise turn it off