Brain

Introduction

The VEX IQ (2nd Gen) Brain Sensing category offers methods for interacting with the Brain’s buttons and connected battery.

Below is a list of all methods:

Actions – Interact with the VEX IQ (2nd Gen) Buttons.

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

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

Getters – Return data from the buttons and battery.

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

• capacity – Returns the remaining battery capacity as a percentage.

• voltage – Returns the voltage of the battery.

• current – Returns the current drawn by the battery.

Constructors – Manually initialize the Brain.

• brain – Create a brain.

Actions

pressed

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

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

Button	Command
buttonCheck	brain.buttonCheck.pressed(callback, arg) — The Check button
buttonLeft	brain.buttonLeft.pressed(callback, arg) — The Left button
buttonRight	brain.buttonRight.pressed(callback, arg) — The Right 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. See Functions with Parameters for more information.

# Turn in a circle when the left button
# is pressed
def button_pressed():
    drivetrain.turn_for(RIGHT, 360, DEGREES)

brain.buttonLeft.pressed(button_pressed)

released

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

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

Button	Command
buttonCheck	brain.buttonCheck.released(callback, arg) — The Check button
buttonLeft	brain.buttonLeft.released(callback, arg) — The Left button
buttonRight	brain.buttonRight.released(callback, arg) — The Right 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. See Functions with Parameters for more information.

# Turn in a circle when the left button
# is released
def button_released():
    drivetrain.turn_for(LEFT, 360, DEGREES)

brain.buttonLeft.released(button_released)

Getters

pressing

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

• True - The specified button is being pressed.

• False - The specified button is not being pressed.

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

Button	Command
buttonCheck	brain.buttonCheck.pressing() — The Check button
buttonLeft	brain.buttonLeft.pressing() — The Left button
buttonRight	brain.buttonRight.pressing() — The Right button

Parameters	Description
	This method has no parameters.

# Turn when the check button is pressed
while True:
    if brain.buttonCheck.pressing():
        drivetrain.turn(RIGHT)
    else:
        drivetrain.stop()

capacity

capacity returns the remaining capacity of the battery as a percentage.

Usage:
brain.battery.capacity()

Parameters	Description
	This method has no parameters.

# Display the current battery capacity
brain.screen.print(brain.battery.capacity())

voltage

voltage returns the voltage of the battery as a float.

Usage:
brain.battery.voltage(units)

Parameters	Description
units	Optional. The unit that represents the voltage: MV (default) – Millivolts VOLT

# Display the current voltage of the battery
brain.screen.print(brain.battery.voltage())

current

current returns the current drawn from the battery in milliamps as a float.

Usage:
brain.battery.current()

Parameters	Description
	This method has no parameters.

# Display the current of the battery
brain.screen.print(brain.battery.current())

Constructors

Brain

Brain creates an object of the brain class.

Usage:
brain = Brain()

Parameters	Description
	This method has no parameters.

brain = Brain()

# Turn when the check button is pressed
while True:
    if brain.buttonCheck.pressing():
        drivetrain.turn(RIGHT)
    else:
        drivetrain.stop()