TETRIX FTC Templates

From ROBOTC API Guide
Revision as of 15:07, 11 September 2012 by Jwatson (Talk | contribs)

Jump to: navigation, search
TETRIX → TETRIX FTC Templates


FTC Templates

ROBOTC has built-in FTC templates that can be used to quickly and easily program a robot for both the autonomous and tele-op (remote control) portions of a competition. To open a template through ROBOTC, navigate to the File menu and select "New". There are three options under this menu:
  • New File - Creates a blank ROBOTC file.
  • Autonomous Template - Creates a FTC Autonomous Template (used for the autonomous portion of the competition.
  • User Control Template - Creates a FTC User Control Template (used for the autonomous portion of the competition.
For FTC competitions we will want to focus on the latter two options, Autonomous Template and User Control Template.

Autonomous Template

After creating a new autonomous template, you will be greeted by segments of code that my look new to you. The first three #pragma statements are automatically generated by ROBOTC to set up a basic TETRIX bot and will more than likely be changed as ROBOTC is configured for your specific robot (through the Motors and Sensors Setup page).
The next line of code is an what is called an "include" directive. These directives tell ROBOTC to look at other files (in this case, the file named "JoystickDriver.c") for functions and commands. This is useful if certain segments of code are used in multiple programs; instead of having to copy the code into every program that would use it, said programs only have to have to 'include' the include file. For instance, the JoystickDriver.c file has all of the commands and functions needed to use the Logitech USB Joystick Controller with ROBOTC. By right-clicking on the 'JoystickDriver.c' line of code in the Autonomous Template and selecting "Open include file 'JoystickDriver.c', we can see all the code that is in the include file. Again, without the include directive this code would be needed in every program that needed to use a Joystick Controller.
After the include directive there is a function called 'initializeRobot' of the void type. This function is used to 'initialize' the robot before the autonomous period. It should be used to perform pre-autonomous actions such as setting servo positions and calibrating sensors; normally, it should not be used to move the robot since most competitions require the robots to be still before the start of the match.