Getting Started

First Steps

The most important characteristic of PROS to note when getting started is that PROS is just C. Anything that works in standard C will work as a part of a PROS project, and similarly the errors given for code that doesn’t work will match errors given for any similar C code. Learning C is essential for using PROS.

If you are already familiar with C development outside of VEX, skip ahead to Using PROS.

If you have not used PROS or done non-VEX C code development before, checking out these following C tutorials is highly recommended.

  • Functions. C is a language that heavily emphasizes functions, and knowing how they work is essential to using PROS. The PROS API <../api/index.html>`_ is a set of functions, so any time that you want to interact with a sensor or motor, you’re using functions.
  • Header Files. The PROS template (the set of files automatically created when you start a PROS project) contains a couple of header files, and it’s recommended that you make additional header files as you develop your code. Header files contain the declarations for functions and global variables (among other things), which is why the PROS API can be found in API.h. Knowing what code should go in a header file (.h) or a source file (.c) can be difficult to determine at first, but it is a very useful skill to learn.
  • printf(). At some point when developing PROS code, you will likely want to get some feedback on what the value of a variable is. This is not an exact replacement for a full debugging utility by any means, but is the standard method for troubleshooting issues in most languages and can be used for viewing sensor values or your own variables’ values. The output from these printf() statements can be viewed in the terminal by running pros terminal.

And then for additional C tutorial topics, visit CProgramming.com or StudyTonight. A good video tutorial series (as opposed to the previous text-based tutorials) can be found on YouTube.

I know C, now how do I use PROS?

The PROS tutorials are designed to show the application of C programming to a PROS project. The Programming the Clawbot <../tutorials/clawbot.html>`_ tutorial is a great place to start, as it goes through every step of putting together a sample PROS project. Once you are ready to branch out and create your own custom project, looking through the following tutorials is recommended:

And then you can find tutorials for specific subjects from analog sensors to tasks and multithreading as well.