Converting an IQ (1st gen) project to use with an IQ (2nd gen) Brain

While working with VEX IQ, you may want to run a project that was configured for a (1st generation) Brain on a robot with a (2nd generation) Brain. In this scenario, you will need to convert your project from '1st gen' to '2nd gen' in VEXcode IQ.

2nd_gen.png

In most cases, there will not be any changes to the project during the conversion. However, there are a few instances where minor changes are made automatically when certain blocks are used in a 1st generation project. These changes will not affect how your project runs on an IQ (2nd generation) Brain. 

This article will cover the following:


Converting a Project with No Changes to Code

select_device_window_icon.png

Open a (1st generation) project in the workspace. Then, select the Devices window icon.

select2nd_gen.png

Once the Devices window is open, select the '2nd gen' icon.

update.png

The '2nd gen' icon will highlight in blue to show that the project has been converted. You can now run this project on a (2nd gen) Brain.


Converting a Project with Minor Changes to Code Made Automatically

select_device_window_icon.png

Open a (1st generation) project in the workspace. Then, select the Devices window icon.

select2nd_gen.png

Once the Devices window is open, select the '2nd gen' icon.

select_continue.png

A message will appear to alert you that the project will need to be converted. Select 'Continue' to proceed with the conversion.

Note: This message will only open if changes were made to the project code. 

select_ok_conversion.png

A conversion completion message will open and list any changes that were made. In this example, the {When Brain button} event block dropdown menu was updated from 1st to 2nd generation configuration.

  • See the section below for more information on the different messages that you may receive, and how to interpret them.

Select 'OK' to save the project conversion.

update.png

The '2nd gen' icon will be highlighted in blue to show that the project has been converted. You can now run this project on a (2nd generation) Brain.


Interpreting Dialog Messages when Converting Projects

If there was a conversion to the code needed due to any of the conditions shown below, the message after conversion will be: "Project conversion has been completed with these changes," followed by a list of any changes that were made to the code. Below are the changes that you may encounter when converting a (1st generation) project to run on a (2nd generation) Brain. 

{When Brain button} Dropdown Menu Updated

brain_button_event.png

Here the message tells you that the conversion is completed, and the dropdown menu of the {When Brain button} block has been updated.

update_when_brain_button_pressed.png

Because the Arrow buttons on the (1st gen) Brain are 'Up' and 'Down', but they are 'Left' and 'Right' on the (2nd gen) Brain, the parameters in the dropdown menu for the Blocks connected to the Arrow buttons have to be updated.

Dropdown Menu Updated

brain_button_sensing.png

Here the message tells you that the conversion is completed, and the dropdown menu of the <Brain button pressed> block has been updated.

update_brain_button_sensing.png

Because the Arrow buttons on the (1st gen) Brain are 'Up' and 'Down', but they are 'Left' and 'Right' on the (2nd gen) Brain, the parameters in the dropdown menu for the Blocks connected to the Arrow buttons have to be updated.