Configuring the project for VMXpi

This guide will show the steps required to configure the project to be deployed to the VMXpi.

Important

This extension is also used to cache updates to be sent to the VMXpi. It is important to make sure this extension and the version of build.gradle is up to date.

Installing VMXpi Extension

A VSCode extension was created to manage the build.gradle file in the project folder. The extension allows for the project to swap between the roboRIO and VMXpi as targets for deployment.

To install the extension head over to the Extensions tab on the left panel or hit Ctrl + Shift + X.

../../../_images/configuring-the-project-for-vmxpi-1.png

In the search bar, search for VMX.

../../../_images/configuring-the-project-for-vmxpi-2.png

Click on the extension to open the extension page in the main window.

../../../_images/configuring-the-project-for-vmxpi-3.png

Click on Install to install the extension.

The installation will be successful when you see the VMXpi logo pop up next to the WPILib logo.

../../../_images/configuring-the-project-for-vmxpi-4.png

Using the Extension

There are four commands in the extension palette.

../../../_images/configuring-the-project-for-vmxpi-5.png
  • Update WPILib Version will update to the current GradleRIO version for the VMXpi

  • Change the deploy target to VMX-Pi (from RoboRIO) will update the build.gradle file to use the VMXpi as a target

  • Change the deploy target to RoboRIO (from VMX-Pi) will update the build.gradle file to use the roboRIO as a targets

  • Verify the Project's build.grade file checks if everything is good to go with the file

To switch the project over for the VMXpi, the command Change the deploy target to VMX-Pi (from RoboRIO) needs to be run. After running, it will auto rebuild the project and cache any libraries that are missing.

Installing the Raspbain Toolchain (c++ only)

For c++ the Raspbian Toolchain is required for building and deploying to the VMX-pi.

Option 1

The first option is to use the VMX-pi Extension. Open the extension and use the command Change the deploy target to VMX-pi (from RoboRIO). This process will then install a bunch of files including the toolchain.

Option 2

The second option is to download toolchain manually. Open the WPILib extension and use the run a command in gradle command.

../../../_images/configuring-the-project-for-vmxpi-6.png

In the window then use the command installRaspbianToolchain

../../../_images/configuring-the-project-for-vmxpi-7.png