Difference between revisions of "Tutorials/Getting Started"

From ROBOTC API Guide
Jump to: navigation, search
(Downloading ROBOTC)
 
(73 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
 
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
<yambe:breadcrumb self=Getting Started>Tutorials|Tutorials</yambe:breadcrumb>
+
<yambe:breadcrumb self="Getting Started">Tutorials|Tutorials</yambe:breadcrumb>
 
<br />
 
<br />
  
Line 6: Line 6:
 
<br />
 
<br />
  
== Error 42 IPM Issues ==
+
== System Requirements ==
 
{|width="740px"
 
{|width="740px"
 
|-
 
|-
|'''"Error 42 (IPM)"''' when launching ROBOTC after installing ROBOTC<br />
+
|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.
[[File:Error_42_IPM.gif]]
+
  
  
=== Solution ===
+
'''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 />
  
This error is caused when Windows XP or Windows VISTA does not have the appropriate rights to initialize the activation software. To fix this issue, you will need to run the application "As an Administrator." Once you have followed these steps once, you can use ROBOTC as a normal user (without Administrative Privileges) without issue.
+
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 />
  
==== Windows VISTA ====
+
== Downloading ROBOTC ==
[[File:Run_As_Administrator.gif]]<br />
+
{|
Step 1: Right Click on the ROBOTC icon. Select "Run as Administrator"<br />
+
|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 />
 +
|-
 +
|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 />
 +
|}
  
 +
== Installing and Uninstalling ROBOTC ==
  
[[File:User_Account_Control.gif]]<br />
+
=== Installing ===
Step 2: Windows VISTA will prompt you to give Administrative Access to this application. Select "Allow" to continue.
+
{|
 +
|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 />
 +
|-
 +
|[[File:Install_Normal.png]]
 +
|-
 +
|<br />
 +
|-
  
ROBOTC should now open to the Licensing Screen. You will not have to repeat these steps again to use ROBOTC in the future.
+
|-
 
+
|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.
 
+
|-
==== Windows XP ====
+
|<br />
[[File:Run_As_Dialog-XP.gif]]<br />
+
|-
Step 1: Right Click on the ROBOTC icon. Select "Run as..."<br />
+
|[[File:Install_End_User.png]]
 +
|-
 +
|<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 />
 +
|-
 +
|[[File:Install_Select_Directory.png]]
 +
|-
 +
|<br />
 +
|-
 +
|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 />
 +
|-
 +
|[[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 />
  
 
+
=== Uninstalling ===
[[File:Run_As_User_Dialog_XP.gif]]<br />
+
{|
Step 2. At the "Run As" dialog, select the "Following User" dialog and enter the user name and password of a user with administrative rights.
+
|-
 
+
|To uninstall ROBOTC, follow the steps below:<br />
ROBOTC should now open to the Licensing Screen. You will not have to repeat these steps again to use ROBOTC in the future.
+
|-
 +
|<br />
 +
|-
 +
|1) Open the Control Panel from your Windows "Start Menu"<br />
 +
|-
 +
|[[File:Uninstall_Control_Panel.png]]
 +
|-
 +
|2) Inside of the Control Panel, select "Programs -> Uninstall a Program" or "Add or Remove Programs" (depending on view settings).<br />
 +
|-
 +
|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 />
 +
|-
 +
|<br />
 +
|-
 +
||[[File:Uninstall_ROBOTC.png]]
 +
|-
 +
|<br />
 +
|-
 +
|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 />
 
<br />
  
== Side-By-Side Error ==
+
=== Building Licenses ===
{|width="740px"
+
{|
 
|-
 
|-
|'''"Application Failed to Start: Side-by-Side" Error''' - ROBOTC will not open<br />
+
|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.
[[File:Side_by_Side_Config_Error.gif]]
+
|-
 +
|<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.
 +
|-
 +
|}
  
 +
== 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.
  
=== Solution ===
 
  
If you have installed ROBOTC and tried to move the ROBOTC folder to another computer, you will recieve this error. This error is caused because the runtime engines ROBOTC is based off of need to be installed along with the application. If the runtime engines are not installed, you will recieve a "Side-by-Side configuration is incorrect" error.
+
To activate ROBOTC, you will need the '''License ID and Password''' that was sent to you during the purchase process.
  
This issue will also be caused if you are using ROBOTC from a network location without running the "Network Dependencies" on the computer attempting to use ROBOTC.
+
*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.
  
To fix this issue, you can do two things:
+
'''If you are Activating the ROBOTC license on computers with internet access, follow the Activation instructions below.'''
#Re-install the latest version of ROBOTC
+
#Install the Network Dependencies pack which is found from the download section of the ROBOTC.net website.
+
|}
+
<br />
+
  
== Unable to Save File Error ==
+
'''''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.''
{|width="740px"
+
|-
+
|'''"Unable to Save File" Error''' - ROBOTC will not install<br />
+
[[File:Cannot Install Network Install.gif]]
+
  
  
=== Solution ===
+
Follow these steps to activate on a computer with internet access:
  
If the ROBOTC installer is "Unable to save file", this error means that ROBOTC does not have permission to write to a temporary installation directory inside of the Windows folder. The installer needs to opened with Administrator privileges.
+
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 />
  
  
==== Windows VISTA ====
+
[[File:Activating_Manage.png]]
[[File:Run_as_admin_vista.gif]]<br />
+
Step 1: Right Click on the Installer icon. Select "Run as adminisrator".<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 />
  
[[File:User_Account_Control.gif]]<br />
 
Step 2: Windows VISTA will prompt you to give Administrative Access to this application. Select "Allow" to continue.
 
  
Step 3: Follow the directions on the installer. ROBOTC should install successfully now.
+
[[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 />
  
==== Windows XP ====
 
[[File:run_as_admin_xp.gif]]<br />
 
Step 1: Right Click on the ROBOTC icon. Select "Run as..."<br />
 
  
 +
[[File:Activating_Add_Select.png]]
  
[[File:Run_As_User_Dialog_XP.gif]]<br />
+
[[File:Activating_Add_Activate.png]]
Step 2. At the "Run As" dialog, select the "Following User" dialog and enter the user name and password of a user with administrative rights.
+
  
Step 3: Follow the directions on the installer. ROBOTC should install successfully now.
 
|}
 
 
<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 />
  
== Other Activation Issues ==
 
=== Could Not Communicate With License Server (Error Code 2) ===
 
{|width="740px"
 
|-
 
|[[File:error2-nointernet.gif]]<br />
 
''Error #2''<br />
 
'''Cause:''' Could Not Communicate With License Server<br />
 
'''Solution:''' Connect to the internet to the computer you are trying to activate, or follow these instructions on using the "Activate by Web."
 
 
|}
 
|}
 
<br />
 
<br />
  
=== No Activations Left for this License (Error Code 7) ===
+
== Select Platform Type ==
 
{|width="740px"
 
{|width="740px"
 
|-
 
|-
|[[File:error7-outoflicenses.gif]]<br />
+
|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.  
''Error #7''<br />
+
'''Cause:''' The License ID you are trying to activate with has been activated on too many computers.<br />
+
'''Solution:''' Contact ROBOTC Support at support@robotc.net
+
|}
+
<br />
+
  
=== Firewall or Trouble Communicating with License Server (Error Code 13) ===
+
ROBOTC for MINDSTORMS has support for five different platforms:
{|width="740px"
+
* LEGO Mindstorms NXT
|-
+
* LEGO Mindstorms NXT + TETRIX/MATRIX
|[[File:No Internet Connection.gif]]<br />
+
* Natural Language (NXT)
''Error #13''<br />
+
* Natural Language (TETRIX/MATRIX)
'''Cause:''' The license password is invalid or could not communicate with server.<br />
+
* Robot Algebra (NXT)
'''Solution:''' Check the LicenseID and Password. Connect to the internet to the computer you are trying to activate, or follow these instructions on using the "Activate by Web."
+
|}
+
<br />
+
  
=== Invalid Registration Code (Error Code 69) ===
+
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).
{|width="740px"
+
|-
+
|[[File:error69-bad_manual_activation.gif]]<br />
+
''Error #69''<br />
+
'''Cause:''' Invalid "Web Activation" Registration Code.<br />
+
'''Solution:''' Make sure you have typed the generated code correctly, or follow the instructions on using the "Activate by Web" again.  
+
|}
+
<br />
+
  
=== Invalid License ID or Password (Error Code 100) ===
 
{|width="740px"
 
|-
 
|[[File:error100-badlicense.gif]]<br />
 
''Error #100''<br />
 
'''Cause:''' Invalid "Web Activation" Registration Code.<br />
 
'''Solution:''' Make sure you have typed the generated code correctly, or follow the instructions on using the "Activate by Web" again.
 
|}
 
<br />
 
  
=== All Other Errors ===
+
[[File:Selecting_Platform_Type.png]]
{|width="740px"
+
|-
+
|'''All Other Errors:''' Contact support@robotc.net
+
 
|}
 
|}
 
<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