ShefRobot

Class Robot

java.lang.Object

ShefRobot.Robot

public class Robot
extends Object

Objects of this class represent particular EV3 based Lego robots.

Constructor Summary

Constructors

Constructor and Description
Robot() Create a new Robot object.
Robot(String ip) Create a new Robot object with a specific IP address.

Method Summary

Modifier and Type	Method and Description
void	close() Close a Robot's connections.
void	closeMotor(Motor.Port port) This method allows you to close one Motor connection.
void	closeSensor(Sensor.Port port) This method allows you to close one Sensor connection.
Buttons	getButtons() Get a Buttons object You can use Buttons for creating ButtonListeners and waiting for ButtonPresses
ColorSensor	getColorSensor(Sensor.Port port) Get a ColorSensor object attached to the specified port.
GyroSensor	getGyroSensor(Sensor.Port port) Get a GyroSensor object attached to the specified port.
LargeMotor	getLargeMotor(Motor.Port port) Get a Motor object attached to the specified port.
MediumMotor	getMediumMotor(Motor.Port port) Get a Motor object attached to the specified port.
Speaker	getSpeaker() Get a Speaker object You can use a Speaker for playing tones through the Robot
TouchSensor	getTouchSensor(Sensor.Port port) Get an TouchSensor object attached to the specified port.
UltrasonicSensor	getUltrasonicSensor(Sensor.Port port) Get an UltrasonicSensor object attached to the specified port.
static void	sleep(long millis) Causes the currently executing thread to sleep (temporarily cease execution) for the specified number of milliseconds, subject to the precision and accuracy of system timers and schedulers.

Methods inherited from class java.lang.Object

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

Constructor Detail

Robot

public Robot()

Create a new Robot object. This will find the first available EV3 on the local network or Bluetooth.

Robot

public Robot(String ip)

Create a new Robot object with a specific IP address.

Parameters:

ip - This defines the IP address of the Robot.

Method Detail

getLargeMotor

public LargeMotor getLargeMotor(Motor.Port port)

Get a Motor object attached to the specified port. If a LargeMotor is already attached to this port, then this function will retern a reference to that Motor object, otherwise a new object is (re)created.

Parameters:

port - The port to which the motor is connected. Must be from Motor.Port.

Returns:

The LargeMotor object.

See Also:

Motor

getMediumMotor

public MediumMotor getMediumMotor(Motor.Port port)

Get a Motor object attached to the specified port. If a MediumMotor is already attached to this port, then this function will retern a reference to that Motor object, otherwise a new object is (re)created.

Parameters:

port - The port to which the motor is connected. Must be from Motor.Port.

Returns:

The MediumMotor object.

See Also:

Motor

getSpeaker

public Speaker getSpeaker()

Get a Speaker object You can use a Speaker for playing tones through the Robot

Returns:

The Speaker object.

See Also:

Speaker

getButtons

public Buttons getButtons()

Get a Buttons object You can use Buttons for creating ButtonListeners and waiting for ButtonPresses

Returns:

The Buttons object.

See Also:

Buttons

getUltrasonicSensor

public UltrasonicSensor getUltrasonicSensor(Sensor.Port port)

Get an UltrasonicSensor object attached to the specified port. If an UltrasonicSensor is already attached to this port, then this function will retern a reference to that Sensor object, otherwise a new object is created.

Parameters:

port - The port to which the sensor is connected. Must be from Sensor.Port.

Returns:

The UltrasonicSensor object.

getTouchSensor

public TouchSensor getTouchSensor(Sensor.Port port)

Get an TouchSensor object attached to the specified port. If an TouchSensor is already attached to this port, then this function will retern a reference to that Sensor object, otherwise a new object is created.

Parameters:

port - The port to which the sensor is connected. Must be from Sensor.Port.

Returns:

The TouchSensor object.

getColorSensor

public ColorSensor getColorSensor(Sensor.Port port)

Get a ColorSensor object attached to the specified port. If a ColorSensor is already attached to this port, then this function will retern a reference to that Sensor object, otherwise a new object is created.

Parameters:

port - The port to which the sensor is connected. Must be from Sensor.Port.

Returns:

The ColorSensor object.

getGyroSensor

public GyroSensor getGyroSensor(Sensor.Port port)

Get a GyroSensor object attached to the specified port. If a GyroSensor is already attached to this port, then this function will retern a reference to that Sensor object, otherwise a new object is created.

Parameters:

port - The port to which the sensor is connected. Must be from Sensor.Port.

Returns:

The GyroSensor object.

sleep

public static void sleep(long millis)

Causes the currently executing thread to sleep (temporarily cease execution) for the specified number of milliseconds, subject to the precision and accuracy of system timers and schedulers.

Parameters:

millis - the length of time to sleep in milliseconds

Throws:

IllegalArgumentException - if the value of millis is negative

close

public void close()

Close a Robot's connections.

closeMotor

public void closeMotor(Motor.Port port)

This method allows you to close one Motor connection.

Parameters:

port - The port to which the motor is connected.

closeSensor

public void closeSensor(Sensor.Port port)

This method allows you to close one Sensor connection.

Parameters:

port - The port to which the sensor is connected.