Bumper

Introduction

The Bumper Switch is a mechanical switch that completes a circuit when pressed, allowing the robot to detect presses and releases.

This page uses bumper_switch as the example Bumper Switch name. Replace it with your own configured name as needed.

Below is a list of available methods:

• pressing – Returns whether the Bumper Switch is being pressed.

• pressed – Registers a function to be called whenever the Bumper Switch is pressed.

• released – Registers a function to be called whenever the Bumper Switch is released.

Constructor – Manually initialize and configure a Bumper Switch.

• Bumper – Create a Bumper Switch.

pressing

pressing returns a Boolean indicating whether the Bumper Switch is currently being pressed. This can be used to check if the robot bumps into other objects.

• True – The Bumper Switch is being pressed.

• False – The Bumper Switch is not being pressed.

Usage:
bumper_switch.pressing()

Parameters	Description
	This method has no parameters.

# Display a message after bumper_switch is pressed
while not bumper_switch.pressing():
  pass

brain.screen.print("Bumper Switch pressed!")

pressed

pressed registers a function to be called whenever the Bumper Switch is pressed.

Usage:
bumper_switch.pressed(callback, arg)

Parameters	Description
callback	A previously defined function that executes when the Bumper Switch is pressed.
arg	Optional. A tuple containing arguments to pass to the callback function. See Functions with Parameters for more information.

def my_function():
  brain.screen.print("Pressed")

# Call my_function whenever bumper_switch is pressed
bumper_switch.pressed(my_function)

released

released registers a function to be called whenever the Bumper Switch is released.

Usage:
bumper_switch.released(callback, arg)

Parameters	Description
callback	A previously defined function that executes when the Bumper Switch is released.
arg	Optional. A tuple containing arguments to pass to the callback function. See Functions with Parameters for more information.

def my_function():
  brain.screen.print("Released")

# Call my_function whenever bumper_switch is released
bumper_switch.released(my_function)

Constructor

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

Bumper

Bumper creates a Bumper Switch.

Usage:
Bumper(port)

Parameter	Description
port	The 3-Wire Port that the Bumper Switch is connected to: On the EXP Brain – brain.three_wire_port.x where x is the number of the port. On a 3-Wire Expander – expander.a where expander is the name of the expander instance.

# Create a Bumper Switch in Port A
bumper_switch = Bumper(brain.three_wire_port.a)