Difference between revisions of "Tutorials/Getting Started"

From ROBOTC API Guide
Jump to: navigation, search
(Downloading ROBOTC)
 
(57 intermediate revisions by 2 users not shown)
Line 13: Line 13:
  
 
'''System Requirements:'''<br />  
 
'''System Requirements:'''<br />  
Intel® Pentium® processor or compatible, 800 MHz minimum  
+
Intel® Pentium® processor or compatible, 800 MHz minimum <br />
Windows XP Professional or Home Edition with Service Pack 2 or greater  
+
Windows XP Professional or Home Edition with Service Pack 2 or greater <br />
256MB of RAM minimum  
+
256MB of RAM minimum <br />
Up to 30MB of available hard disk space   
+
Up to 30MB of available hard disk space  <br />
1 available USB port  
+
1 available USB port <br />
Compatible Bluetooth adapter (optional)
+
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.
 
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.
Line 25: Line 34:
 
<br />
 
<br />
  
== Uninstalling and Installing ROBOTC ==
+
== Downloading ROBOTC ==
=== Uninstalling ===
+
{|
{|width="740px"
+
|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 />
 +
|-
 +
|[[File:Install_Download_Firefox.png]]
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Install_Download_IE.png]]
 +
|-
 +
|<br />
 
|-
 
|-
|You must uninstall your previous version of ROBOTC before upgrading to the newest version of ROBOTC.<br />
+
|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.  
 +
|-
 +
|<br />
 +
|}
  
To uninstall ROBOTC, follow these steps:<br />
+
== Installing and Uninstalling ROBOTC ==
 
+
1. Open the Control Panel from your "Start Menu"<br />
+
[[File:uninstall1.gif]]
+
 
+
 
+
2. Inside of the Control Panel, select "Add or Remove Programs"<br />
+
[[File:uninstall2.gif]]
+
 
+
 
+
3. Navigate through the "Add or Remove Programs" list until you find your version of ROBOTC that you wish to uninstall. Press the "Remove button"<br />
+
[[File:uninstall3.gif]]
+
 
+
 
+
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 />
+
[[File:uninstall4.gif]]
+
|}
+
<br />
+
  
 
=== Installing ===
 
=== Installing ===
{|width="740px"
+
{|
 +
|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.
 
|-
 
|-
|To Install the latest version of ROBOTC, follow these steps:
+
|<br />
 
+
1. Double click on the ROBOTC installer. You will be presented with the Installshield installer for ROBOTC. Click "Next" to proceed.<br />
+
[[File:install1.gif]]
+
 
+
 
+
2. Before you can proceed, you must read over the accept the End User License Agreement. Click "I accept" and then the "Next" button to proceed.<br />
+
[[File:install2.gif]]
+
 
+
 
+
3. Choose where you would like to install ROBOTC to. By default, ROBOTC is installed to your "Program Files" folder. Click "Next" to proceed.<br />
+
[[File:install3.gif]]
+
 
+
 
+
4. The installer will ask you to confirm your settings. If everything looks correct, click "Install" to being the installation process.<br />
+
[[File:install4.gif]]
+
 
+
 
+
5. The installer will begin copying files from the installer to your computer. Please wait until this is complete.<br />
+
[[File:install5.gif]]
+
 
+
6. When the installation is complete, the install will inform you of this. Click "Finish" to complete your install.<br />
+
[[File:install6.gif]]
+
 
+
7. Double click the "ROBOTC for Mindstorms" icon to launch ROBOTC.<br />
+
[[File:install7.gif]]
+
|}
+
<br />
+
 
+
== Activate Online ==
+
{|width="740px"
+
 
|-
 
|-
|'''To continue using ROBOTC past the 30 day trial period''', you must purchase a ROBOTC license and then activate the license on each computer.
+
|[[File:Install_Normal.png]]
 
+
|-
 
+
|<br />
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.''' If you are activating the ROBOTC license on computers without internet access, skip to  Activate by Web instructions.
+
 
+
'''''NOTE:''' ROBOTC must be activated on each individual computer.''
+
 
+
 
+
Follow these steps to activate on a computer with internet access:
+
 
+
1. Open ROBOTC and select "Activate ROBOTC" from the start-up prompt.<br />
+
[[File:Activate_Main.gif]]
+
 
+
 
+
2. Select "Activate ROBOTC for MINDSTORMS Online"<br />
+
[[File:Activate_Selection_Online.gif]]
+
 
+
 
+
3. Enter in your License ID and Password that you received via emaill. Click the "Continue" button to proceed.<br />
+
[[File:Activate_Online_LicenseIDPass.gif]]
+
 
+
 
+
4. ROBOTC will communicate with the activation server via the internet to verify your License ID and Password.<br />
+
[[File:Activate_Processing.gif]]
+
 
+
 
+
5. ROBOTC is activated and ready for use. Click Continue to use ROBOTC for MINDSTORMS.<br />
+
[[File:Activate_Success.gif]]
+
|}
+
<br />
+
 
+
== Activate by Web ==
+
{|width="740px"
+
 
|-
 
|-
|'''Follow these steps to activate on a computer without internet access:
 
  
Note: You will need to use a separate computer with Internet access in step 4 at this activation process. You must repeat this process on each computer without internet access.
 
 
1. Open ROBOTC and select "Activate ROBOTC" from the menu.<br />
 
[[File:Activate_Main.gif]]
 
 
 
2. Select "Activate by Web"<br />
 
[[File:Activate_Selection_Web.gif]]
 
 
 
3. Two user codes will be displayed. Copy both of these down. Take these codes with you to a separate computer with Internet access.<br />
 
[[File:Activate_Web_UserCodes.gif]]
 
 
 
4. At a separate computer with internet access, visit http://www.robotc.net/register. Enter your License ID and Password that you received via email and click "Next."<br />
 
[[File:Activate_Web_EnterLicense.gif]]
 
 
 
5. Enter User Code 1 and User Code 2 that you copied down in step 3. Click "Next" to proceed.<br />
 
[[File:Activate_Web_EnterUserCoders.gif]]
 
 
 
6. A Registration code will be displayed. Write this down and return to the original computer on which ROBOTC is installed.<br />
 
[[File:Activate_Web_RegistrationCode.gif]]
 
 
 
7. Enter the Registration code from step 6 into the "Activation Code 1" field. <br />
 
Note: Leave Activation Code 2 blank.<br />
 
[[File:Activate_Web_UserCodes_EnterReg.gif]]
 
 
 
8. ROBOTC will be activated and ready for use. Click Continue to use ROBOTC.<br />
 
[[File:Activate_Success.gif]]
 
|}
 
<br />
 
 
== Getting Started with the VEX PIC ==
 
=== Configuring Serial Port ===
 
{|width="740px"
 
 
|-
 
|-
|When using ROBOTC for the first time, you may need to specify which Serial Port is used to communicate with your VEX. To change the Serial Port, follow these steps:
+
|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.
 
+
|-
1. Open the Preferences menu under the "View" menu.<br />
+
|<br />
[[File:robotc_view_menu.png]]
+
 
+
 
+
2. Select the serial COM port that your controller is attached to from the Communications Port drop-down menu. Click 'OK' to save your settings.<br />
+
''Be sure to also select the correct Platform with the "Platform" drop-down menu.''<br />
+
[[File:robotc_preference_port.png]]
+
|}
+
<br />
+
 
+
=== Download Master Firmware ===
+
{|width="740px"
+
 
|-
 
|-
|The Master Firmware for the VEX is sperate from the ROBOTC Firmware. The Master firmware controls all of the lower-level controls of the VEX controller (such as serial and radio communication). This firmware is supplied by Innovation FIRST and has not been modified by ROBOTC. Every VEX Microcontroller is preloaded with a version of the master firmware, but downloading the latest version will ensure that your robot is compatible with the latest hardware available.
+
|[[File:Install_End_User.png]]
 
+
|-
 
+
|<br />
'''To update the VEX Master Firmware:'''<br />
+
|-
1. Open ROBOTC for IFI. Ensure that your VEX controller is connected and turned on.<br />
+
|3) Next, select where you would like ROBOTC to install to. The default location is C:/Program Files (x86)/Robomatter Inc/ROBOTC Development Environment.
 
+
|-
 
+
|<br />
2. Go to View > Preferences > Detailed Preferences. On the Platform tab, ensure that VEX 0.5 Microchip is selected as the Platform, alsong with the Prolific USB-to-Serial option as the Communication Port.<br />
+
|-
[[File:SS-2010-10-13_14.27.33.png]]
+
|[[File:Install_Select_Directory.png]]
 
+
|-
 
+
|<br />
3. Go to Robot > Download Firmware > Master CPU Firmware > Standard File to download the Master Firmware.<br />
+
|-
[[File:SS-2010-10-13_14.31.58.png]]
+
|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 />
 
+
|-
 
+
|<br />
4. A Download Progress window will appear. When the window closes, the download is complete.<br />
+
|-
[[File:SS-2010-10-13_14.05.46.png]]
+
|[[File:Install_Install_Progress.png]]
 +
|-
 +
|<br />
 +
|-
 +
|5) The installer will inform you of when the installation is complete. Click the "Finish" button to complete your install.<br />
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Install_Complete.png]]
 +
|-
 +
|<br />
 +
|-
 +
|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 />
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Install_Run_Admin.png]]
 +
|-
 +
|<br />
 +
|-
 +
|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 />
 
<br />
  
=== Download ROBOTC Firmware ===
+
=== Uninstalling ===
{|width="740px"
+
{|
 +
|-
 +
|To uninstall ROBOTC, follow the steps below:<br />
 +
|-
 +
|<br />
 +
|-
 +
|1) Open the Control Panel from your Windows "Start Menu"<br />
 +
|-
 +
|[[File:Uninstall_Control_Panel.png]]
 
|-
 
|-
|Before you can use ROBOTC with the VEX platform, you have to download the ROBOTC firmware to the VEX.
+
|2) Inside of the Control Panel, select "Programs -> Uninstall a Program" or "Add or Remove Programs" (depending on view settings).<br />
 
+
|-
'''Prerequisites:'''
+
|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 />
*Connect the VEX to your computer and power it on.
+
|-
*Make sure VEX 0.5 Microchip is selected as the Platform Type
+
|<br />
 
+
|-
1. Open the Robot menu, select "Download Firmware", "ROBOTC Firmware", and then "Standard File". <br />
+
||[[File:Uninstall_ROBOTC.png]]
[[File:SS-2010-10-13_14.35.48.png]]
+
|-
 
+
|<br />
2. A Download Progress window will appear. When the window closes, the download is complete.<br />
+
|-
[[File:vex-firm-download.png]]
+
|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 />
 
+
 
+
3. Power cycle the VEX so that the new firmware will take effect.<br />
+
 
|}
 
|}
 
<br />
 
<br />
  
=== Sample Programs ===
+
=== Building Licenses ===
{|width="740px"
+
{|
 +
|-
 +
|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.
 +
|-
 +
|<br />
 +
|-
 +
|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).
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Building_License_Location.png]]
 +
|-
 +
|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.
 +
|-
 +
|<br />
 +
|-
 +
|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.
 
|-
 
|-
|One of the best ways to start working with ROBOTC and learning how to program is to look at already developed programs. ROBOTC comes with over 75 sample programs to help the programmer learn how to program their robotics controllers.
 
 
To access these sample programs, open the "Sample Programs" folder by going to the "File" menu and selecting "Open Sample Program."<br />
 
[[File:sampleprograms_menu.png]]
 
 
 
Inside of the sample programs folder, there are a number of samples organized by topic. ROBOTC will automatically open the sample programs folder of the platform you currently have selected.<br />
 
[[File:sampleprogram_files.png]]
 
 
 
Just double click on one of the sample programs to open it up and learn more about ROBOTC programming.<br />
 
 
|}
 
|}
<br />
 
  
=== Compiling and Downloading ===
+
== Activate Online ==
{|width="740px"
+
{|
 
|-
 
|-
|ROBOTC is considered to be an "Integrated Development Environment." This means that ROBOTC has a custom text editor for developing code that will assist the programmer by color coding different potions of code to differentiate between integers, reserved words, functions and parameters.<br />
+
|'''To continue using ROBOTC past the 30 day trial period''', you must purchase a ROBOTC license and then activate the license on each computer.
[[File:robotc_gui.png]]
+
  
  
ROBOTC also contains a compiler for turning this user generated code in a byte-code language that the different controller platforms can understand. To run the compiler, access the compile function from the "Robot" menu.<br />
+
To activate ROBOTC, you will need the '''License ID and Password''' that was sent to you during the purchase process.
[[File:compile_program.png]]
+
  
 +
*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.
  
When the compiler runs, ROBOTC will check your program for errors and warnings that would cause your program to not run properly on the robot. Rather than send this broken code to your robot, ROBOTC will inform you of these errors so they can be corrected.
+
'''If you are Activating the ROBOTC license on computers with internet access, follow the Activation instructions below.'''
  
In the example 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.''
*The reserved word 'motor' was incorrectly typed as 'Motor', generating a warning. A warning tells the user that they've created an error, but ROBOTC is able to correct this error itself when the program is sent to the controller. A program with warning will compile successfully, but users should use good programming practice to avoid warnings. Warnings are denoted by a yellow "X".
+
*The code on line 5 is missing a semicolon, which is generating an error. An error will prevent the program from being sent to the controller. ROBOTC will do its best to explain what the error to assist the user. In this example, ROBOTC is informing the user they left a semicolon off a line of their program which is preventing the program from being compiled. Errors are denoted by a red "X".<br />
+
[[Image:errors_and_warnings.png]]
+
  
  
Once your program has successfully compiled, you can send the program to the controller by clicking the "Compile and Download Program" option under the "Robot" menu. Note:  Your robot must be turned on and connected to the computer before you can download a program.<br />
+
Follow these steps to activate on a computer with internet access:
[[Image:download.png]]
+
  
 +
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 />
  
Once the download starts, a "Download Progress" bar will appear. This bar will show the status of the transfer of the compiled byte-code to the controller.<br />
 
[[Image:SS-2010-10-14_11.36.04.png]]
 
  
 +
[[File:Activating_Manage.png]]
  
Once the download starts, a "Download Progress" bar will appear. This bar will show the status of the transfer of the compiled byte-code to the controller.<br />
 
[[File:SS-2010-10-13_14.05.46.png]]
 
 
 
Once the download finishes, ROBOTC's built in debugger will be launched. There will be a number of windows that launch, such as the Global Variables window, the Devices window and the Program Debug window. You can start your programs execution by clicking the "Start" button on the "Program Debug" window. Learn more about these windows in the 'Debugger' section of the help file.<br />
 
[[File:compiler.png]]
 
|}
 
 
<br />
 
<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 />
  
== Getting Started with the VEX PIC ==
 
=== Configuring Serial Port ===
 
{|width="740px"
 
|-
 
|When using ROBOTC for the first time, you may need to specify which Serial Port is used to communicate with your VEX. To change the Serial Port, follow these steps:
 
  
1. Open the Preferences menu under the "View" menu.<br />
+
[[File:Activating_Add_Main.png]]
[[File:robotc_view_menu.png]]
+
  
 
2. Select the serial COM port that your controller is attached to from the Communications Port drop-down menu. Click 'OK' to save your settings.<br />
 
''Be sure to also select the correct Platform with the "Platform" drop-down menu.''<br />
 
[[File:robotc_preference_port.png]]
 
|}
 
 
<br />
 
<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 />
  
=== Download Master Firmware ===
 
{|width="740px"
 
|-
 
|The Master Firmware for the VEX is sperate from the ROBOTC Firmware. The Master firmware controls all of the lower-level controls of the VEX controller (such as serial and radio communication). This firmware is supplied by Innovation FIRST and has not been modified by ROBOTC. Every VEX Microcontroller is preloaded with a version of the master firmware, but downloading the latest version will ensure that your robot is compatible with the latest hardware available.
 
  
 +
[[File:Activating_Add_Select.png]]
  
'''To update the VEX Master Firmware:'''<br />
+
[[File:Activating_Add_Activate.png]]
1. Open ROBOTC for IFI. Ensure that your VEX controller is connected and turned on.<br />
+
  
 
2. Go to View > Preferences > Detailed Preferences. On the Platform tab, ensure that VEX 0.5 Microchip is selected as the Platform, alsong with the Prolific USB-to-Serial option as the Communication Port.<br />
 
[[File:SS-2010-10-13_14.27.33.png]]
 
 
 
3. Go to Robot > Download Firmware > Master CPU Firmware > Standard File to download the Master Firmware.<br />
 
[[File:SS-2010-10-13_14.31.58.png]]
 
 
 
4. A Download Progress window will appear. When the window closes, the download is complete.<br />
 
[[File:SS-2010-10-13_14.05.46.png]]
 
|}
 
 
<br />
 
<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 />
  
=== Download ROBOTC Firmware ===
 
{|width="740px"
 
|-
 
|Before you can use ROBOTC with the VEX platform, you have to download the ROBOTC firmware to the VEX.
 
 
'''Prerequisites:'''
 
*Connect the VEX to your computer and power it on.
 
*Make sure VEX 0.5 Microchip is selected as the Platform Type
 
 
1. Open the Robot menu, select "Download Firmware", "ROBOTC Firmware", and then "Standard File". <br />
 
[[File:SS-2010-10-13_14.35.48.png]]
 
 
2. A Download Progress window will appear. When the window closes, the download is complete.<br />
 
[[File:vex-firm-download.png]]
 
 
 
3. Power cycle the VEX so that the new firmware will take effect.<br />
 
 
|}
 
|}
 
<br />
 
<br />
  
=== Sample Programs ===
+
== Select Platform Type ==
 
{|width="740px"
 
{|width="740px"
 
|-
 
|-
|One of the best ways to start working with ROBOTC and learning how to program is to look at already developed programs. ROBOTC comes with over 75 sample programs to help the programmer learn how to program their robotics controllers.
+
|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.  
 
+
To access these sample programs, open the "Sample Programs" folder by going to the "File" menu and selecting "Open Sample Program."<br />
+
[[File:sampleprograms_menu.png]]
+
 
+
 
+
Inside of the sample programs folder, there are a number of samples organized by topic. ROBOTC will automatically open the sample programs folder of the platform you currently have selected.<br />
+
[[File:sampleprogram_files.png]]
+
 
+
 
+
Just double click on one of the sample programs to open it up and learn more about ROBOTC programming.<br />
+
|}
+
<br />
+
 
+
=== Compiling and Downloading ===
+
{|width="740px"
+
|-
+
|ROBOTC is considered to be an "Integrated Development Environment." This means that ROBOTC has a custom text editor for developing code that will assist the programmer by color coding different potions of code to differentiate between integers, reserved words, functions and parameters.<br />
+
[[File:SS-2010-10-14_11.33.22.png]]
+
 
+
 
+
ROBOTC also contains a compiler for turning this user generated code in a byte-code language that the different controller platforms can understand. To run the compiler, access the compile function from the "Robot" menu.<br />
+
[[File:SS-2010-10-14_11.33.57.png]]
+
 
+
 
+
When the compiler runs, ROBOTC will check your program for errors and warnings that would cause your program to not run properly on the robot. Rather than send this broken code to your robot, ROBOTC will inform you of these errors so they can be corrected.
+
 
+
In the example below:
+
*The reserved word 'motor' was incorrectly typed as 'Motor', generating a warning. A warning tells the user that they've created an error, but ROBOTC is able to correct this error itself when the program is sent to the controller. A program with warning will compile successfully, but users should use good programming practice to avoid warnings. Warnings are denoted by a yellow "X".
+
*The code on line 5 is missing a semicolon, which is generating an error. An error will prevent the program from being sent to the controller. ROBOTC will do its best to explain what the error to assist the user. In this example, ROBOTC is informing the user they left a semicolon off a line of their program which is preventing the program from being compiled. Errors are denoted by a red "X".<br />
+
[[Image:SS-2010-10-14_11.34.58.png]]
+
 
+
 
+
Before downloading code to your robot, you should verify that the "VEX Cortex Download Method" matches your setup.<br />
+
[[Image:SS-2010-10-14_11.35.39.png]]
+
 
+
 
+
'''Option 1: Download Using VEXnet or USB'''<br />
+
With this option selected, ROBOTC will download ROBOTC firmware and programs to your Cortex using a VEXnet or USB connection. In this mode, when the Cortex is powered ON it will look for a VEXnet or USB connection before running your program. (The Communication Port > Automatic Selection option in the ROBOTC Preferences should be selected if you plan on switching between VEXnet and USB as your download method.)
+
 
+
'''Option 2: Download Using USB Only'''<br />
+
With this option selected, ROBOTC will download firmware and programs to your Cortex using only the USB connection. In this mode, when the Cortex is powered ON it will immediately run your program. This option is NOT recommended if you are using the VEXnet Joysticks to download to the Cortex, or remotely control it.
+
 
+
'''Option 3: Download for Competition (VEXnet)'''<br />
+
This option disables the ROBOTC debugger, and is not recommended for classroom use.
+
 
+
''Note: Switching between Download Modes may require you to power cycle your Cortex before it takes effect.''
+
 
+
Once your program has successfully compiled and you've selected the appropriate Download Method, you can send the program to the controller by clicking the "Compile and Download Program" option under the "Robot" menu. Note:  Your robot must be turned on and connected to the computer before you can download a program.<br />
+
[[Image:SS-2010-10-14_11.36.04.png]]
+
  
 +
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)
  
Once the download starts, a "Download Progress" bar will appear. This bar will show the status of the transfer of the compiled byte-code to the controller.<br />
+
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:SS-2010-10-13_14.05.46.png]]
+
  
  
Once the download finishes, ROBOTC's built in debugger will be launched. There will be a number of windows that launch, such as the Global Variables window, the Devices window and the Program Debug window. You can start your programs execution by clicking the "Start" button on the "Program Debug" window. Learn more about these windows in the 'Debugger' section of the help file.<br />
+
[[File:Selecting_Platform_Type.png]]
[[File:compiler.png]]
+
 
|}
 
|}
 
<br />
 
<br />

Latest revision as of 19:06, 13 February 2014

Tutorials → Getting Started




System Requirements

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:
Intel® Pentium® processor or compatible, 800 MHz minimum
Windows XP Professional or Home Edition with Service Pack 2 or greater
256MB of RAM minimum
Up to 30MB of available hard disk space
1 available USB port
Compatible Bluetooth adapter (optional)

ROBOTC Virtual Worlds System Requirements:
Intel® Core 2 Duo®/AMD® Athlon X2® or better processor
Windows XP Home or Professional Edition with Service Pack 2 or greater, Windows Vista, Windows 7
2048 MB (2 GB) of RAM minimum
Minimum 200MB free hard drive space
NVIDIA® GeForce® 8800GTS/ATI Radeon™ HD 3850 or better video card
DirectX® 9.0 or DirectX® 10

For more information on ROBOTC's Virtual World program, see our 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.


Downloading ROBOTC

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:

Install Download Firefox.png

Install Download IE.png

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.

Installing and Uninstalling ROBOTC

Installing

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.

Install Normal.png

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.

Install End User.png

3) Next, select where you would like ROBOTC to install to. The default location is C:/Program Files (x86)/Robomatter Inc/ROBOTC Development Environment.

Install Select Directory.png

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.

Install Install Progress.png

5) The installer will inform you of when the installation is complete. Click the "Finish" button to complete your install.

Install Complete.png

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.

Install Run Admin.png

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 ROBOTC website.


Uninstalling

To uninstall ROBOTC, follow the steps below:

1) Open the Control Panel from your Windows "Start Menu"
Uninstall Control Panel.png
2) Inside of the Control Panel, select "Programs -> Uninstall a Program" or "Add or Remove Programs" (depending on view settings).
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.

Uninstall ROBOTC.png

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.


Building Licenses

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.

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).

Building License Location.png
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.

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.

Activate Online

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.


Activating Manage.png


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.


Activating Add Main.png


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).


Activating Add Select.png

Activating Add Activate.png


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".


Select Platform Type

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).


Selecting Platform Type.png