Configuring a Motor Group in VEXcode IQ

When starting to program with VEXcode IQ, motor group blocks will not appear in the Toolbox until a motor group has been configured. A motor group will allow you to link two motors together in a VEXcode IQ project.

There are a number of reasons for creating a motor group, for more information on building with VEX IQ motor groups, view this article from the Knowledge Base.

Here are the different options when configuring a motor group:


Adding a Motor Group

devices button

To configure a motor group, select the Devices button to open the Devices window.

add a device

Select “Add a device.”

select motor group

Select “Motor Group.”

select which ports the motors are attatched to

Select which ports the motors in the motor group are attached to on the IQ Brain. Ports that are already configured for other devices will be unavailable.

select done

Once the motor group has been configured, select “Done” to submit the device to the configuration.

Note: Selecting “Cancel” will undo any changes you have made to the device and will not be a part of the configuration.

To configure the motor group further, see the additional options below.


Changing a Motor Group’s Port Number(s)

change port number

You can change the port number of a motor by first selecting the motor group in the Devices window.

select plug icon

Then, select the plug icon of the port you want to change in the top right corner of the Options screen.

select its port

Select its port on the Port Selection screen, and the port number will turn green. Then select “Done” to submit the change.


Naming Motor Group Directions

motor options screen

The motor group Options screen allows you to rename the directions the motor spins from their default of “forward” and “reverse.” For example, if configuring an arm motor group, you can rename the directions to “Up” and “Down.” Then select “Done” to submit the device changes to the configuration.


Renaming a Motor Group

rename the motor group

You can also rename the motor group by changing the name in the text box at the top of the Options screen. If you select an invalid name, the text box will highlight red to indicate. Then select “Done” to submit the device changes to the configuration.

Note: for more information about naming rules for variables and devices, view this article from the Knowledge Base.

update motor name in block

If you change the name of a motor that is already being used in your project, you will need to update the motor name in the block to the new name using the drop down.


Reversing a Motor(s) in a Motor Group

options screen

The Options screen also allows the direction of the motors to be reversed.

select done

Once a motor has been reversed, select “Done” to submit the changes to the configuration.

Note: if two motors in a motor group are facing one another, such as when two motors share a single shaft, one of the motors will need to be reversed or the two motors will be fighting against one another. For more information on building with VEX IQ motor groups, view this article from the Knowledge Base.


Deleting a Motor Group

select delete option

A motor group can also be deleted by selecting the “Delete” option at the bottom of the screen.

Note: if you delete a motor group that is already being used in your project, the project will not work until the blocks using that motor group have also been deleted.


Using a Motor Group with a Controller

configure buttons on controller

If you have both a controller and a motor group configured, you can configure the buttons on the controller to control the entire motor group, instead of a single motor.