Configuring a Motor Group in VEXcode IQ (1st gen)

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, see this article.

This article covers the following options when configuring a motor group:


Adding a Motor Group

select_devices_icon.update.png

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

VEXcode_IQ_-_dev_6QwLpuyG4p.png

Select the generation that you are working with.

VEXcode_IQ_-_dev_v9vZZ2q9LM.png

Select “Add a device.”

VEXcode_IQ_-_dev_plp7SDcKfb.png

Select “Motor Group.”

motor_group_ports_01.png

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.

VEXcode_IQ_-_dev_Pu8QEn6f07.png

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)

VEXcode_IQ_-_dev_ze4RCCJ3S2.png

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

VEXcode_IQ_-_dev_titpbgutLJ.png

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

VEXcode_IQ_-_dev_xLPn2fxvjd.png

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_groups_renaming_group_name.png

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

renaming_the_defualt_motor_group_name.png

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.

VEXcode_IQ_-_dev_36XMDIHWy5.png

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

VEXcode_IQ_-_dev_Ya1f2VNcsA.png

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

VEXcode_IQ_-_dev_Dc605iK0H1.png

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

VEXcode_IQ_-_dev_meuT0jzOe0.png

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

VEXcode_IQ_-_dev_qvuHFi2Cv3.png

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.