Difference between pages "Tutorials/Getting Started" and "Creating an RBC file"

From ROBOTC API Guide
< Tutorials(Difference between pages)
Jump to: navigation, search
(Downloading ROBOTC)
 
(Virtual World Index)
 
Line 1: Line 1:
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
+
<yambe:breadcrumb self="Creating an RBC file">Main|Main page</yambe:breadcrumb>
<yambe:breadcrumb self="Getting Started">Tutorials|Tutorials</yambe:breadcrumb>
+
<br />
+
  
{{toc}}
+
{{tl|1|}}
<br />
+
  
== System Requirements ==
+
== What is an RBC file? ==
{|width="740px"
+
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 +
|-
 +
|An RBC file is a special type of XML file that can be used with ROBOTC v3.52 or later. Once an RBC file is created properly, you will be able to configure ROBOTC's Platform Type, Compiler Target, Menu Level, and other important settings all with the click of a button. You can even configure the RBC program to load a user program and automatically download it to a robot or Virtual World of your choosing.
 
|-
 
|-
|ROBOTC requires basic system specifications to run properly. The development environment is not processor intensive, but the interactive debugger may slow down computer performance on older machines.
 
 
 
'''System Requirements:'''<br />
 
Intel® Pentium® processor or compatible, 800 MHz minimum <br />
 
Windows XP Professional or Home Edition with Service Pack 2 or greater <br />
 
256MB of RAM minimum <br />
 
Up to 30MB of available hard disk space  <br />
 
1 available USB port <br />
 
Compatible Bluetooth adapter (optional)<br />
 
<br />
 
'''ROBOTC Virtual Worlds System Requirements:'''<br />
 
Intel® Core 2 Duo®/AMD® Athlon X2® or better processor <br />
 
Windows XP Home or Professional Edition with Service Pack 2 or greater, Windows Vista, Windows 7 <br />
 
2048 MB (2 GB) of RAM minimum <br />
 
Minimum 200MB free hard drive space <br />
 
NVIDIA® GeForce® 8800GTS/ATI Radeon™ HD 3850 or better video card <br />
 
DirectX® 9.0 or DirectX® 10 <br />
 
 
For more information on ROBOTC's Virtual World program, see our [http://www.robotc.net/download/rvw/specifications.php Computer Requirements and Performance page.]
 
 
ROBOTC will not run natively in any other operating system other than Microsoft Windows. ROBOTC will run with a Virtualization client on a Apple Macintosh. ROBOTC has been tested with VMWare Fusion, Parallels Desktop, and Apple's Boot Camp. You will still need to download/install device drivers found on your purchased CD or on the ROBOTC website.
 
 
|}
 
|}
<br />
 
  
== Downloading ROBOTC ==
+
== How to create an RBC file ==
{|
+
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
|Before we start programming in ROBOTC, we need to first download and install the client. This can be done by navigating to ROBOTC's website ( http://www.robotc.net) and selecting the 'Downloads' tab.
+
|-
+
|1) From the ROBOTC website, select the individual robotics platform you wish to program on. If you want to use multiple platforms or accidentally download the wrong version, you can manually activate and choose another platform thorugh the ROBOTC program. When you get to the correct platform page, click on the 'Download ROBOTC for X version x.xx' to start the download process:  
+
 
|-
 
|-
|<br />
+
|There are several steps required in order to create a working RBC file. You will need an activated installation of ROBOTC and a text file editor installed on the computer. For this demonstration, we used ROBOTC for VEX Robotics 4.0 and Notepad++ as our text file editor.
 
|-
 
|-
|[[File:Install_Download_Firefox.png]]
+
|'''1)''' Create a new file in your text file editor (generally found under the 'File -> New' menu option).
 
|-
 
|-
|<br />
+
|'''2)''' Save the file with a custom name and a '.rbc' file extension. You may also need to change the 'File Type' dropdown menu to 'All Files', depending on the text editor settings.
 
|-
 
|-
|[[File:Install_Download_IE.png]]
+
|'''3)''' Add the following parameters to the file:
 +
*<?xml version="1.0" encoding="UTF-8"?>
 +
*<RBCVersion>1.0.0</RBCVersion>
 +
*<Platform></Platform>
 +
*<CortexDLMethod></CortexDLMethod>
 +
*<CircuitBoard></CircuitBoard>
 +
*<MenuLevel></MenuLevel>
 +
*<CompilerMode></CompilerMode>
 +
*<CompileAndDownload></CompileAndDownload>
 +
*<VirtualWorldIndex></VirtualWorldIndex>
 +
*<SourceFileName>.c</SourceFileName>
 +
*<RVWParameters></RVWParameters>
 +
*<SourceCode></SourceCode>
 
|-
 
|-
|<br />
+
|'''4)''' Modify the parameters to fit the settings for the program. For a full listing of all of the available parameters, see the 'XML Parameters' section below.
 
|-
 
|-
|2) At this point click the 'Save' button to start downloading ROBOTC. You may get a warning pop-up from either Windows, your antivirus program, or both. This is to warn you that some programs downloaded from the internet can be malicious and to use care before running them; click allow to start the download.  
+
|'''5)''' Save the RBC file.
 
|-
 
|-
|<br />
+
|'''6)''' Manually open the RBC file icon by double clicking on it. If the file is configured correctly, ROBOTC should open with the specified parameters using the specified source code. If the program does not open correctly (or opens with the wrong settings), double check the parameters for accuracy.
 
|}
 
|}
  
== Installing and Uninstalling ROBOTC ==
+
== XML parameters ==
 
+
===XML Version===
=== Installing ===
+
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
{|
+
|1) Once the program is done downloading, navigate to the Downloads folder on your computer and start the ROBOTC installer. You may have to right click on the installer and select the "Run as Administrator" depending on individual computer restrictions; ROBOTC must be installed with administrator privileges.
+
 
|-
 
|-
|<br />
+
| The XML Version parameter will identify the document as valid XML. This must always be at the top of the RBC document.
 +
*'''<?xml version="1.0" encoding="UTF-8"?>'''
 
|-
 
|-
|[[File:Install_Normal.png]]
+
|}
 +
===RBC Version===
 +
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 
|-
 
|-
|<br />
+
| Identifies the current RBC specification being used.  As of today, this value should be specified as 1.0.0.
 +
*'''<RBCVersion>1.0.0</RBCVersion>'''
 
|-
 
|-
 
+
|}
 +
===Platform Type===
 +
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 
|-
 
|-
|2) Before you can proceed, you must read over and accept the End User License Agreement. If you agree to the End User Agreement, check the "I accept" and then the "Next" button to continue the installation.
+
| Sets the platform type in ROBOTC. Requires the ROBOTC installation to have an appropriate license activated and valid in order to work properly.
 +
*'''<Platform>PlatformType</Platform>'''
 
|-
 
|-
|<br />
+
|}
 +
{| class="wikitable"
 
|-
 
|-
|[[File:Install_End_User.png]]
+
|'''To set this platform type'''
 +
|'''Use this parameter'''
 
|-
 
|-
|<br />
+
|VEX PIC
 +
|VEX
 
|-
 
|-
|3) Next, select where you would like ROBOTC to install to. The default location is C:/Program Files (x86)/Robomatter Inc/ROBOTC Development Environment.
+
|VEX Cortex
 +
|VEX2
 
|-
 
|-
|<br />
+
|LEGO NXT
 +
|NXT
 
|-
 
|-
|[[File:Install_Select_Directory.png]]
+
|LEGO NXT + TETRIX
 +
|TETRIX
 
|-
 
|-
|<br />
+
|Arduino
 +
|ARDUINO
 +
|}
 +
 
 +
===Cortex Download Method (VEX Cortex only)===
 +
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 
|-
 
|-
|4) The installer will ask you to confirm your settings. If everything looks correct, click "Install" to being the installation process. The installer will then begin copying files from the installer to your computer. Please wait until this is complete.<br />
+
| Sets the Cortex Download Method – used to modify the cortex download method to allow the Cortex to either require a VEXnet/USB cable in order to run, or to allow “standalone” mode to run a user’s program without searching for a COMM link. If the Cortex is using the VEXNet system or will be physically tethered to a Joystick Controller using the USB A-to-A cable, the VEXNet option should be used. Otherwise, use the USB-Only mode
 +
*'''<CortexDLMethod>DownloadMode</CortexDLMethod>'''
 
|-
 
|-
|<br />
+
|}
 +
{| class="wikitable"
 
|-
 
|-
|[[File:Install_Install_Progress.png]]
+
|'''To set this download method'''
 +
|'''Use this parameter'''
 
|-
 
|-
|<br />
+
|USB Only
 +
|USBOnly
 
|-
 
|-
|5) The installer will inform you of when the installation is complete. Click the "Finish" button to complete your install.<br />
+
|USB or VEXNet
 +
|USBorWifi
 
|-
 
|-
|<br />
+
|Competition (VEXNet)
 +
|Competition
 
|-
 
|-
|[[File:Install_Complete.png]]
+
|}
 +
 
 +
===Circuit Board===
 +
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 
|-
 
|-
|<br />
+
| This specifies the circuit board to be used. Has only real application with Arduino to differentiate between different board models (Uno,1280,2560,etc). Default value of blank (no value) for all other platforms.
 +
*'''<CircuitBoard></CircuitBoard>'''
 
|-
 
|-
|6) Right-Click on the ROBOTC icon and select "Run as Administrator" to run ROBOTC as an administrator (assuming the user account has administrator privileges). You will only need to do this one time.<br />
+
|}
 +
===Menu Level===
 +
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 
|-
 
|-
|<br />
+
| Sets the ROBOTC GUI Menu Level. Used to show/hide functionality by adjusting the menu level types (Basic, Advanced, and Super User)
 +
*'''<MenuLevel>Level</MenuLevel>'''
 
|-
 
|-
|[[File:Install_Run_Admin.png]]
+
|}
 +
{| class="wikitable"
 
|-
 
|-
|<br />
+
|'''To set this menu level'''
 +
|'''Use this parameter'''
 +
|-
 +
|Basic
 +
|Basic
 +
|-
 +
|Expert
 +
|Expert
 +
|-
 +
|Super User
 +
|SuperUser
 
|-
 
|-
|Depending on which platform you are installing, ROBOTC may also install additional drivers unique to each platform. If for any reason the drivers are not downloaded and installed properly they can be downloaded and installed manually from the [http://www.robotc.net/download/ ROBOTC website.]
 
 
|}
 
|}
<br />
 
  
=== Uninstalling ===
+
===Compiler Mode===
{|
+
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 
|-
 
|-
|To uninstall ROBOTC, follow the steps below:<br />
+
| Sets ROBOTC’s compiler mode (Compiler Target) – used to switch between real robots, the PC-based emulator, and Virtual Worlds compiling targets.
 +
*'''<CompilerMode>CompilerTarget</CompilerMode>'''
 
|-
 
|-
|<br />
+
|}
 +
{| class="wikitable"
 
|-
 
|-
|1) Open the Control Panel from your Windows "Start Menu"<br />
+
|'''To set this compiler target'''
 +
|'''Use this parameter'''
 
|-
 
|-
|[[File:Uninstall_Control_Panel.png]]
+
|Physical Robot
 +
|Real
 
|-
 
|-
|2) Inside of the Control Panel, select "Programs -> Uninstall a Program" or "Add or Remove Programs" (depending on view settings).<br />
+
|PC-based Emulator
 +
|Emulator
 
|-
 
|-
|3) Navigate through the "Add or Remove Programs" list until you find the version of ROBOTC that you wish to uninstall. Press the "Uninstall" button.<br />
+
|Virtual Worlds
 +
|VirtualWorlds
 
|-
 
|-
|<br />
+
|}
 +
 
 +
===Compile and Download===
 +
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 
|-
 
|-
||[[File:Uninstall_ROBOTC.png]]
+
| Flag to specify if the source code should be “compiled” or “compiled and downloaded”. If set to “Yes”, the code will automatically be downloaded to the robot or Virtual World. Otherwise ("No", it will only be compiled.
 +
*'''<CompileAndDownload>Yes</CompileAndDownload>'''
 +
|-
 +
|}
 +
===Virtual World Index===
 +
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 
|-
 
|-
|<br />
+
| Sets the numerical type of the RVW Level Pack Index that should be launched. – This is only a numerical number that references the RVW Level Pack “ID” number.
 +
*'''<VirtualWorldIndex>IndexNumber</VirtualWorldIndex>'''
 
|-
 
|-
|4) Windows will start the uninstall process. When the window below disappears and you are returned to the "Add or Remove Programs" list, ROBOTC has been successfully uninstalled.<br />
 
 
|}
 
|}
<br />
+
{| class="wikitable"
 
+
|-
=== Building Licenses ===
+
|'''To set this Virtual World'''
{|
+
|'''Use this parameter index'''
 +
|-
 +
|Learning ROBOTC Tables Preview
 +
|2
 
|-
 
|-
|There is a special type of ROBOTC license called a Building License . These licenses do not require an online activation but rather have a unique building license file that must be installed with the software in order for ROBOTC to work properly. When you order a building license you will be sent an email with a unique building license file.
+
|Curriculum Companion
 +
|3
 
|-
 
|-
|<br />
+
|FTC Block Party!
 +
|8
 
|-
 
|-
|To activate ROBOTC with a building license, download and run the installer as normal. Once the program is installed, copy the building license file into the ROBOTC directory (typically C:/Program Files (x86)/Robomatter Inc/ROBOTC Developement Environment).
+
|VEX Toss Up
 +
|9
 
|-
 
|-
|<br />
+
|FTC Ring It Up!
 +
|10
 
|-
 
|-
|[[File:Building_License_Location.png]]
+
|VEX Sack Attack
 +
|11
 
|-
 
|-
|One of the advantages of building licenses is that they help make automated installs easy. To roll out ROBOTC to multiple computers using a building license, make sure the base image has ROBOTC installed and the building license files in the correct directory. As long as those two conditions are met, ROBOTC should be active on each computer the image is rolled out to with no futher action required.
+
|Robots to the Rescue: Operation Reset
 +
|12
 
|-
 
|-
|<br />
+
|Palm Island: Luau Edition
 +
|14
 
|-
 
|-
|There is, however, an exception. If ROBOTC is being run from a centralized network, each computer that needs to access ROBOTC must also install a Network Dependencies package (available from the ROBOTC downloads page). The building license file must also be properly installed on the network in order for networked computers to access ROBOTC.
+
|Ruins of Atlantis
 +
|15
 +
|-
 +
|RVW Level Builder
 +
|18
 
|-
 
|-
 
|}
 
|}
  
== Activate Online ==
+
===Source File Name===
{|
+
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 +
|-
 +
| Name of the file that will be saved/displayed on the ROBOTC tab-bar at compile time – Note this file only is used if SourceCode is provided.
 +
*'''<SourceFileName>Name_Of_Program.c</SourceFileName>'''
 
|-
 
|-
|'''To continue using ROBOTC past the 30 day trial period''', you must purchase a ROBOTC license and then activate the license on each computer.
 
 
 
To activate ROBOTC, you will need the '''License ID and Password''' that was sent to you during the purchase process.
 
 
*If you purchased a ROBOTC license online, the License ID and Password were sent to the email address specified.
 
*If you ordered the CD-ROM version of ROBOTC, the License ID and Password are printed on the CD label.
 
 
'''If you are Activating the ROBOTC license on computers with internet access, follow the Activation instructions below.'''
 
 
'''''NOTE:''' ROBOTC must be activated on each individual computer. ROBOTC can no longer be activated offline; the computers must be activated with a working internet connection. Once activation is complete, the computers do not need to remain online to stay activated.''
 
 
 
Follow these steps to activate on a computer with internet access:
 
 
1) Open ROBOTC and navigate to the Help menu. From there, select 'Manage Licenses -> Add License'. If you do not already have a ROBOTC license, you may purchase one by clicking the 'Purchase License' option. <br />
 
 
 
[[File:Activating_Manage.png]]
 
 
<br />
 
2)  From the Manage License menu, select the 'Add License' button. Note that there is also a greyed out option for "Deactivate License". This allows you to deactivate the license (where applicable; not all licenses can be deactivated) and reactivate it on another computer. Once a license is activated, you can also see the registration information and create a desktop icon for ROBOTC by clikcing on their respective buttons.<br />
 
 
 
[[File:Activating_Add_Main.png]]
 
 
<br />
 
3) Clicking the Add License button will bring up a 'Add New ROBOTC License' window. From here you must first select which type of license you have and then enter your License ID and Password (to see the password characters as you type, uncheck the 'mask' checkbox). <br />
 
 
 
[[File:Activating_Add_Select.png]]
 
 
[[File:Activating_Add_Activate.png]]
 
 
<br />
 
4) Once the information is entered, click the 'Activate Online' button to activate the product. If you wish to activate multiple products, simply repeat the process. You may also start a trial of any of the ROBOTC versions (assuming the trial has not already been activated on the computer) by selecting the program you'd wish to try and selecting "Start Trial". <br />
 
 
 
|}
 
|}
<br />
+
===RVW Parameters===
 
+
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
== Select Platform Type ==
+
|-
{|width="740px"
+
| Command Line Parameters that will be passed the next time Robot Virtual Worlds is launched. If the “CompileAndDownload” flag is set to “NO”, these parameters will be stored for the next execution. After the Virtual Worlds has been executed once, these parameters are discarded.
 +
*'''<RVWParameters>parameter1 parameter2 parameter3</RVWParameters>'''
 +
|-
 +
|}
 +
===Source Code===
 +
{| style="font-family:Verdana, Geneva, sans-serif; color:black; background-color:#FFFFFF; text-align:left; font-size:100%;" width="100%" cellpadding="5%" cellspacing="0" border="0"
 +
|-
 +
| Source Code of program to be open/compiled/downloaded. This is not a reference to an existing file but rather the actual contents of the file. Because the RBC file uses XML formatting, the file cannot contain any XML escape markups in the Source Code section. Instead, the escape markups must be replaced with the characters below:
 
|-
 
|-
|Open the "Robot" menu in ROBOTC and hover your cursor over the "Platform Type" menu option. This will open up the platform select menu. Select the platform you wish you use with ROBOTC. You can change the platform type at any time.
 
 
ROBOTC for MINDSTORMS has support for five different platforms:
 
* LEGO Mindstorms NXT
 
* LEGO Mindstorms NXT + TETRIX/MATRIX
 
* Natural Language (NXT)
 
* Natural Language (TETRIX/MATRIX)
 
* Robot Algebra (NXT)
 
 
Before you use ROBOTC, make sure to select which platform you are currently using (in this example, the Lego Mindstorms/TETRIX/MATRIX platform is selected).
 
 
 
[[File:Selecting_Platform_Type.png]]
 
 
|}
 
|}
<br />
 

Revision as of 16:31, 8 April 2014

Creating an RBC file


What is an RBC file?

An RBC file is a special type of XML file that can be used with ROBOTC v3.52 or later. Once an RBC file is created properly, you will be able to configure ROBOTC's Platform Type, Compiler Target, Menu Level, and other important settings all with the click of a button. You can even configure the RBC program to load a user program and automatically download it to a robot or Virtual World of your choosing.

How to create an RBC file

There are several steps required in order to create a working RBC file. You will need an activated installation of ROBOTC and a text file editor installed on the computer. For this demonstration, we used ROBOTC for VEX Robotics 4.0 and Notepad++ as our text file editor.
1) Create a new file in your text file editor (generally found under the 'File -> New' menu option).
2) Save the file with a custom name and a '.rbc' file extension. You may also need to change the 'File Type' dropdown menu to 'All Files', depending on the text editor settings.
3) Add the following parameters to the file:
  • <?xml version="1.0" encoding="UTF-8"?>
  • <RBCVersion>1.0.0</RBCVersion>
  • <Platform></Platform>
  • <CortexDLMethod></CortexDLMethod>
  • <CircuitBoard></CircuitBoard>
  • <MenuLevel></MenuLevel>
  • <CompilerMode></CompilerMode>
  • <CompileAndDownload></CompileAndDownload>
  • <VirtualWorldIndex></VirtualWorldIndex>
  • <SourceFileName>.c</SourceFileName>
  • <RVWParameters></RVWParameters>
  • <SourceCode></SourceCode>
4) Modify the parameters to fit the settings for the program. For a full listing of all of the available parameters, see the 'XML Parameters' section below.
5) Save the RBC file.
6) Manually open the RBC file icon by double clicking on it. If the file is configured correctly, ROBOTC should open with the specified parameters using the specified source code. If the program does not open correctly (or opens with the wrong settings), double check the parameters for accuracy.

XML parameters

XML Version

The XML Version parameter will identify the document as valid XML. This must always be at the top of the RBC document.
  • <?xml version="1.0" encoding="UTF-8"?>

RBC Version

Identifies the current RBC specification being used. As of today, this value should be specified as 1.0.0.
  • <RBCVersion>1.0.0</RBCVersion>

Platform Type

Sets the platform type in ROBOTC. Requires the ROBOTC installation to have an appropriate license activated and valid in order to work properly.
  • <Platform>PlatformType</Platform>
To set this platform type Use this parameter
VEX PIC VEX
VEX Cortex VEX2
LEGO NXT NXT
LEGO NXT + TETRIX TETRIX
Arduino ARDUINO

Cortex Download Method (VEX Cortex only)

Sets the Cortex Download Method – used to modify the cortex download method to allow the Cortex to either require a VEXnet/USB cable in order to run, or to allow “standalone” mode to run a user’s program without searching for a COMM link. If the Cortex is using the VEXNet system or will be physically tethered to a Joystick Controller using the USB A-to-A cable, the VEXNet option should be used. Otherwise, use the USB-Only mode
  • <CortexDLMethod>DownloadMode</CortexDLMethod>
To set this download method Use this parameter
USB Only USBOnly
USB or VEXNet USBorWifi
Competition (VEXNet) Competition

Circuit Board

This specifies the circuit board to be used. Has only real application with Arduino to differentiate between different board models (Uno,1280,2560,etc). Default value of blank (no value) for all other platforms.
  • <CircuitBoard></CircuitBoard>

Menu Level

Sets the ROBOTC GUI Menu Level. Used to show/hide functionality by adjusting the menu level types (Basic, Advanced, and Super User)
  • <MenuLevel>Level</MenuLevel>
To set this menu level Use this parameter
Basic Basic
Expert Expert
Super User SuperUser

Compiler Mode

Sets ROBOTC’s compiler mode (Compiler Target) – used to switch between real robots, the PC-based emulator, and Virtual Worlds compiling targets.
  • <CompilerMode>CompilerTarget</CompilerMode>
To set this compiler target Use this parameter
Physical Robot Real
PC-based Emulator Emulator
Virtual Worlds VirtualWorlds

Compile and Download

Flag to specify if the source code should be “compiled” or “compiled and downloaded”. If set to “Yes”, the code will automatically be downloaded to the robot or Virtual World. Otherwise ("No", it will only be compiled.
  • <CompileAndDownload>Yes</CompileAndDownload>

Virtual World Index

Sets the numerical type of the RVW Level Pack Index that should be launched. – This is only a numerical number that references the RVW Level Pack “ID” number.
  • <VirtualWorldIndex>IndexNumber</VirtualWorldIndex>
To set this Virtual World Use this parameter index
Learning ROBOTC Tables Preview 2
Curriculum Companion 3
FTC Block Party! 8
VEX Toss Up 9
FTC Ring It Up! 10
VEX Sack Attack 11
Robots to the Rescue: Operation Reset 12
Palm Island: Luau Edition 14
Ruins of Atlantis 15
RVW Level Builder 18

Source File Name

Name of the file that will be saved/displayed on the ROBOTC tab-bar at compile time – Note this file only is used if SourceCode is provided.
  • <SourceFileName>Name_Of_Program.c</SourceFileName>

RVW Parameters

Command Line Parameters that will be passed the next time Robot Virtual Worlds is launched. If the “CompileAndDownload” flag is set to “NO”, these parameters will be stored for the next execution. After the Virtual Worlds has been executed once, these parameters are discarded.
  • <RVWParameters>parameter1 parameter2 parameter3</RVWParameters>

Source Code

Source Code of program to be open/compiled/downloaded. This is not a reference to an existing file but rather the actual contents of the file. Because the RBC file uses XML formatting, the file cannot contain any XML escape markups in the Source Code section. Instead, the escape markups must be replaced with the characters below: