PROS stands for PROS Robot Operating System – a recursive acronym. It is the most feature-packed and versatile programming system for V5. To read more about PROS, read this tutorial.
PROS is made of two parts – the PROS CLI and the PROS Editor. The CLI is mandatory. It is what creates a project, compiles, and uploads the code to the robot. It lets you run commands in the terminal, and also allows the PROS Editor to run commands. The PROS Editor is is a re-skinned distribution of the Atom Editor, and is recommended for use with PROS projects. The benefit of using the PROS editor over another editor such as Atom or VS Code is that it is completely pre-configured for building PROS projects. However, the CLI allows the use of any other editor to edit and compile PROS projects.
Installing the Editor
To install the complete PROS package, head over to the Releases page. For the Windows installer, download one of these two files, depending on your computer’s architecture:
Now let’s run that installer. There are a couple settings that are good to change before installing. First, if you are on a school or shared computer with no access to the C: drive, make sure to select “Only for me”, as this will install PROS into your user directory.
Next, we get to the features page. If you plan on using the terminal for PROS, it is important that you select the “Toolchain on Path” option. This allows you to directly access the PROS tools from any command line. We recommend enabling that option if you are unsure.
It is also a good idea to install the V5 Drivers, though it might not be mandatory. The V5 Vision Utility is always useful.
After it is done installing, open PROS. The first time it opens it has to do some setup, so it might take some time. When you install PROS, all it does is install the CLI and a base version of Atom. However, when you first launch it, it automatically installs the PROS plugin and a whole other list of plugins such as the tool-bar and terminal. It will also create and populate the PROS user directory.
Wait about 10 minutes until the blue installing notification goes away. After that, the PROS menu-bar should show up.
For good measure, restart PROS.
Now you have PROS set up and are ready to create a project! However, follow along if you want to have some useful packages and themes.
Here is a list of the packages that add some nice features to PROS.
- atom-save-all – Bound to Ctrl-S
- atom-touch-events – Lets you use touchscreen
- expose – A nice file view – Linked to F10
- clipboard-plus – Remembers clipboard history – bound to ctrl-shift-v
- remember-file-positions – Leaves the code where you left off
- todo-show – Scans the code looking for Todos or notes – button in bottom left menu
- switch-header-source – ALT-O to switch between header and source file
To install these packages, go to Settings->Install and search for the packages.
Installing the CLI
If you want to install the CLI without the editor, follow the below steps. Keep in mind that the CLI gets installed with the Editor by default.
First, install Python 3.6 or newer: https://python.org/download/
Make sure that you enable the system path option when you install.
Then, in a new cmd terminal window, type:
pip install https://github.com/purduesigbots/pros-cli3/releases/download/3.1.3/pros_cli_v5-3.1.3-py3-none-any.whl
If you run into permissions issues, you should run the command in an elevated prompt.
Alternatively, you can use the
--user <user> flag with the above snippet to install the CLI specifically to a user.
This should install the PROS CLI and put it on the Path. Now restart your terminal. If typing prosv5 works, and it gives you a list of commands, then you have done everything properly. When you create a new project it will automatically upgrade the PROS kernel to the latest version.
Now, you have everything set up to create a new PROS project. We will explain how to do that in this tutorial.