Using the VEX AIR Flight Simulator#

Accessing the Simulator#

Connect the VEX AIR Controller to VEXcode AIR.

VEXcode AIR toolbar with a highlighted ‘Controller’ button, alongside Download, Run, and Stop buttons.

Select the Simulator tab.

VEXcode AIR interface with the ‘Simulator’ button highlighted, showing a controller icon and the word Simulator.

In VEXcode, the simulator will open to the Rings layout, showing the Pilot View.

When the simulator opens, the controller will make a sound and a message will appear on the controller’s screen indicating that a drone is connected and the Propeller Lock is enabled.

Top-down view of the drone simulator with a VEX AIR Drone on a starting platform, red and blue ring obstacles, score counters for rings and collisions, and an FPS indicator.

Propeller Lock#

By default, the Propeller Lock is enabled when the simulator opens. The drone cannot take off when the Propeller Lock is enabled.

Each time the field is reset or the layout is changed, the Propeller Lock will be enabled.

The Propeller Lock icon in the simulator and the power button on the drone will flash blue while the Propeller Lock is enabled, as shown in this video.

Select the Propeller Lock icon to disable propeller lock.

Vertical toolbar showing icons for information, settings, and a highlighted propeller lock icon displayed in blue, indicating propellers are locked.

The icon will turn green when propeller lock is disabled. Now the drone is ready to take off.

Vertical toolbar showing icons for information, settings, and a highlighted propeller lock icon displayed in green, indicating propellers are unlocked.

Using the Controller with the Simulator#

With the Propeller Lock disabled, the drone can be flown using the same controls as a real-life flight! The simulator utilizes the same controls as the default_fly project.

Flying in the Simulator#

Take off using the Takeoff & Land button on the controller. Press the button to open the project menu. Then hold the button until the drone takes off from the platform.

Pressing the Takeoff & Land button while flying in the simulator will land the drone. Press the button to open the menu. Then press the button again, or touch the Land button on the controller screen, to land the drone in its current location.

Close-up of the left side of a VEX AIR Drone controller with the lower takeoff and landing button highlighted in yellow.

The movement of the drone is controlled by the movements of the joysticks.

Camera Options#

To change the camera view of the drone, select the Change View button on the controller.

Front view of a VEX AIR Drone controller with the right-side Change View button highlighted in yellow.

This will rotate through the following camera options:

  • Pilot View - Shows the drone from the pilot’s position outside the field, just like in a competition. This view helps build spatial awareness and practice line-of-sight flying.

  • Front Camera - Displays the forward-facing camera (matching the drone’s forward camera) to show what the drone “sees” straight ahead. It’s useful for navigating through obstacles or lining up with targets.

  • Down Camera -Displays the downward-facing camera view (matching the drone’s own downward camera.) This is useful for aligning with objects and scoring elements.

  • Chase View - Follows behind the drone as it moves. This view gives a dynamic perspective that helps visualize flight paths and direction changes.

  • Split Screen 1 - Combines Pilot View on the top and Front Camera on the bottom.

  • Split Screen 2 - Combines Pilot View on the top and Down Camera on the bottom.

Controller Settings#

Select the Info button on the lower right side of the screen to view the controller configuration.

Vertical toolbar with the information icon highlighted, showing a white ‘i’ inside an orange square.

Select the X button in the upper left corner to close the configuration and return to the field.

Labeled diagram of a VEX AIR drone controller showing front and back views, with arrows identifying joystick functions, buttons, power, screen mode, payload drop, and unused controls. The X button in the top left is highlighted.

Pre-Flight Checklist Menu#

Select the Gear icon on the lower right side of the screen to open the Pre-Flight Checklist.

Vertical toolbar with icons for information, settings, propeller lock, and reset, with the settings gear icon highlighted.

Select the Confirm button on the bottom of the window to save your selections. Selecting the X button in the top left corner will close the checklist without saving your choices.

Pre-Flight Checklist window showing options for layout selection, module selection, pilot position, and drone audio, with highlighted Confirm button at the bottom.

When the Competition Layout is selected, the additional option of Field Side appears.

Expanded Pre-Flight Checklist window with layout selection set to Competition, field side options for Red or Blue, module selection, pilot position, and drone audio controls.

Scoring#

In the Rings Layout, the counter indicates the number of rings that are flown through, and the number of times the drone collides with a ring.

../../_images/scoring-on-rings-layout.png

In the Competition Layout, the counter indicates the number of rings flown through, and the number of game objects placed in or on each of the game elements.

On-screen scoreboard listing Rings, Pole, Drop Tower, Drop Zone, and Cargo Platform scores, all set to zero.

Resetting#

Select the Reset button in the lower right corner of the screen to reset the field and return the drone to the starting position on the platform, with the Propeller Lock enabled.

Vertical toolbar with the reset icon highlighted, shown as a circular arrow inside an orange square.