Controller#

Introduction#

The IQ (2nd gen) Brain can connect to either an IQ (2nd gen) or IQ (1st gen) Controller. Both controllers have two analog joysticks and multiple buttons that the Brain can use to detect movements and presses.

For the examples below, the configured controller will be named controller and will be used in all subsequent examples throughout this API documentation when referring to Controller class methods.

Below is a list of all available methods:

Actions – Turn Controller-programmed actions on or off.

Getters – Read button states and joystick positions.

  • .pressing – Returns whether the specified button is being pressed.

  • .position – Returns the position of the joystick’s specified axis.

Callback – Run code when buttons or joysticks change state.

  • .pressed – Calls a function when the specified button is pressed.

  • .released – Calls a function when the specified button is released.

  • .changed – Calls a function when the joystick’s axis changes.

Constructors – Manually initialize and configure the controller.

Actions#

remote_control_code_enabled#

remote_control_code_enabled is a variable that can be set to a boolean that enables or disables Controller configured actions from the Devices menu. The Controller is enabled by default. It can be set to either of the following:

  • True — Enable Controller configured actions.

  • False — Disable Controller configured actions.

Usage: remote_control_code_enabled = False

# Example coming soon!

Getters#

.pressing#

.pressing returns an integer indicating whether a specific button on the controller is currently being pressed. This method must be called on a specific button object, such as buttonEDown (see full list of button objects below).

  • 1 - The specified button is being pressed.

  • 0 - The specified button is not being pressed.

Usage:
One of five available button objects can be used with this method, as shown below:

Button

Command

buttonEDown

controller.buttonEDown.pressing() — The E Down button

buttonEUp

controller.buttonEUp.pressing() — The E Up button

buttonFDown

controller.buttonFDown.pressing() — The F Down button

buttonFUp

controller.buttonFUp.pressing() — The F Up button

buttonL3

controller.buttonL3.pressing() — The Left Joystick button - IQ (2nd gen) Controller only

buttonLDown

controller.buttonLDown.pressing() — The L Down button

buttonLUp

controller.buttonLUp.pressing() — The L Up button

buttonR3

controller.buttonR3.pressing() — The Right Joystick button - IQ (2nd gen) Controller only

buttonRDown

controller.buttonRDown.pressing() — The R Down button

buttonRUp

controller.buttonRUp.pressing() — The R Up button

Parameters

Description

This method has no parameters.

# Example coming soon

.position#

.position returns the position of the joystick’s specified axis as an integer from –100 to 100, representing a percentage. This method must be called on a specific axis object, such as axisA (see full list of axis objects below).

Usage:

One of four available axes can be used with this method, as shown below:

Axis

Command

axisA

controller.axisA.position() — The Left Joystick’s vertical axis

axisB

controller.axisB.position() — The Left Joystick’s horizontal axis

axisC

controller.axisC.position() — The Right Joystick’s horizontal axis

axisD

controller.axisD.position() — The Right Joystick’s vertical axis

Parameters

Description

This method has no parameters.

# Example coming soon

Callback#

.pressed#

.pressed registers a function to be called when a specific button on the controller is pressed. This method must be called on a specific button object, such as buttonEDown – (see full list of button objects below).

Usage:
One of the available button objects can be used with this method, as shown below:

Button

Command

buttonEDown

controller.buttonEDown.pressed(callback, arg) — The E Down button

buttonEUp

controller.buttonEUp.pressed(callback, arg) — The E Up button

buttonFDown

controller.buttonFDown.pressed(callback, arg) — The F Down button

buttonFUp

controller.buttonFUp.pressed(callback, arg) — The F Up button

buttonL3

controller.buttonL3.pressed(callback, arg) — The Left Joystick button - IQ (2nd gen) only

buttonLDown

controller.buttonLDown.pressed(callback, arg) — The L Down button

buttonLUp

controller.buttonLUp.pressed(callback, arg) — The L Up button

buttonR3

controller.buttonR3.pressed(callback, arg) — The Right Joystick button - IQ (2nd gen) only

buttonRDown

controller.buttonRDown.pressed(callback, arg) — The R Down button

buttonRUp

controller.buttonRUp.pressed(callback, arg) — The R Up button

Parameters

Description

callback

A function that is previously defined to execute when the specified button is being pressed.

arg

Optional. A tuple containing arguments to pass to the callback function. Functions with Parameters for more information.

# Example coming soon

.released#

.released registers a function to be called when a specific button on the controller is released. This method must be called on a specific button object, such as buttonEDown – (see full list of button objects below).

Usage:
One of the available button objects can be used with this method, as shown below:

Button

Command

buttonEDown

controller.buttonEDown.released(callback, arg) — The E Down button

buttonEUp

controller.buttonEUp.released(callback, arg) — The E Up button

buttonFDown

controller.buttonFDown.released(callback, arg) — The F Down button

buttonFUp

controller.buttonFUp.released(callback, arg) — The F Up button

buttonL3

controller.buttonL3.released(callback, arg) — The Left Joystick button - IQ (2nd gen) Controller only

buttonLDown

controller.buttonLDown.released(callback, arg) — The L Down button

buttonLUp

controller.buttonLUp.released(callback, arg) — The L Up button

buttonR3

controller.buttonR3.released(callback, arg) — The Right Joystick button - IQ (2nd gen) Controller only

buttonRDown

controller.buttonRDown.released(callback, arg) — The R Down button

buttonRUp

controller.buttonRUp.released(callback, arg) — The R Up button

Parameters

Description

callback

A function that is previously defined to execute when the specified button is released.

arg

Optional. A tuple containing arguments to pass to the callback function. Functions with Parameters for more information.

# Example coming soon

.changed#

.changed registers a function to be called when the joystick’s position changes. This method must be called on a specific axis object, such as axisA (see full list of axis objects below).

Usage:
One of four available axes can be used with this method, as shown below:

Axis

Command

axisA

controller.axisA.changed(callback, arg) — The Left Joystick’s vertical axis

axisB

controller.axisB.changed(callback, arg) — The Left Joystick’s horizontal axis

axisC

controller.axisC.changed(callback, arg) — The Right Joystick’s horizontal axis

axisD

controller.axisD.changed(callback, arg) — The Right Joystick’s vertical axis

Parameters

Description

callback

A function that is previously defined to execute when the axis’ value changes.

arg

Optional. A tuple containing arguments to pass to the callback function. See Functions with Parameters for more information.

# Function to display an emoji when the joystick is moved
def move_joystick():
    robot.screen.show_emoji(CONFUSED)

# Run the function when the joystick is moved up or down
controller.axis1.changed(move_joystick)

Constructors#

Constructors are used to manually create Controller objects, which are necessary for configuring a controller outside of VEXcode.

Controller#

Controller creates a controller.

Usage:
Controller()

Parameters

Description

This constructor has no parameters.

# Example coming soon