Difference between pages "NXT Program Chooser" and "Building License Installation - 4.0"

From ROBOTC API Guide
(Difference between pages)
Jump to: navigation, search
 
 
Line 1: Line 1:
<yambe:breadcrumb self="Program Chooser">TETRIX|TETRIX</yambe:breadcrumb>
+
{|
<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. The building license file is stored on the ROBOTC Customer Service server and can be accessed by the end user at any time. To do so, you will need to:
 +
|-
 +
|
 +
* Download the latest version of ROBOTC
 +
* Install ROBOTC
 +
* Download the building license file from the ROBOTC Customer Service page
 +
* Install and activate the building license file
 +
|-
 +
|<br />
 +
|-
 +
|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 file is 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 further action required.
 +
|-
 +
|<br />
 +
|-
 +
|There are, however, exceptions to this. 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 [[http://www.robotc.net/download/ ROBOTC downloads page]]). The building license file must also be properly installed on the network in order for networked computers to access ROBOTC.
 +
|-
 +
|}
  
{{tl|1|}}
+
== Download the latest version of ROBOTC ==
<br />
+
 
+
== The Program Chooser ==
+
 
{|
 
{|
 +
|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.
 
|-
 
|-
|The Program Chooser is a sample program in ROBOTC that allows users to assign programs on the NXT brick for tele-op use. Because autonomous programs are chosen before the start of an FTC match, the program chooser enables mixing-and-matching of programs and helps users account for game variables such as start location, alliance members, opposing alliance members, game object positions, etc before a match starts.
+
|<br />
 +
|-
 +
|'''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 />
 
|<br />
 
|-
 
|-
|To use the Program Chooser, users must first compile and download any autonomous and tele-op programs they wish to be able to choose from to the NXT brick. Then the Program Chooser must be opened, compiled, and downloaded to the NXT. It can be found by navigating to the File->Open Sample Program->FIRST Tech Challenge folder and selecting 'Program Chooser.c'
+
|[[File:BL4 Install Save.png]]
<br />
+
 
|-
 
|-
|[[File:NXT ProgChooser Open.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 />
 
|-
 
|-
 
|}
 
|}
  
<br />
+
== Install ROBOTC ==
 
+
== Using the Program Chooser ==
+
 
{|
 
{|
|Run the Program Chooser from the NXT. The program will first ask you to choose between Dual and Single Mode:
+
|-
 +
|'''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 />
 
|<br />
 
|-
 
|-
|[[File:NXT ProgChooser Mode.png]]
+
|[[File:BL4 Install Run1.png]]
 
|-
 
|-
 
|<br />
 
|<br />
 
|-
 
|-
|<ul><li><STRONG>Dual Mode</STRONG> - Allows users to pick separate autonomous and tele-op programs for the match.</li>
+
|'''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.
<li><STRONG>Single Mode</STRONG> - Configures the NXT to run only one program for both the autonomous and tele-op portions of the match.</li>
+
 
|-
 
|-
 +
|<br />
 
|-
 
|-
 +
|[[File:BL4 Install EULA.png]]
 
|-
 
|-
|If Dual Mode is chosen, the Program Chooser will then allow you to choose which program will be run in the tele-op portion of the match. Once a program is chosen, the Program Chooser will make the necessary changes to the FTCConfig.txt file and end the program.
+
|<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 4.X.
 
|-
 
|-
 
|<br />
 
|<br />
 
|-
 
|-
|[[File:NXT ProgChooser Select.png]]
+
|[[File:BL4 Install Run2.png]]
 
|-
 
|-
 
|<br />
 
|<br />
 
|-
 
|-
|If Single Mode is chosen, the Program Chooser will automatically make the necessary changes to the FTCConfig.txt file and end the program.
+
|'''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 />
 
|<br />
 
|-
 
|-
|[[File:NXT ProgChooser Success.png]]
+
|[[File:BL4 Install Run3.png]]
 
|-
 
|-
 
|<br />
 
|<br />
 
|-
 
|-
|When the program is run in an FTC match, the user will choose a program to run for autonomous and whichever program was chosen with the Program Chooser will be run in the user control stage. This can be tested by using the [[NXT_Using_Joysticks|Joystick Control - Competition]] debug window.
+
|'''5)''' During this process, ROBOTC will automatically install the drivers needed for your specific robotics platform, if applicable. You will be prompted if you would like to install the drivers; click the 'Install' button to start the driver install.
 +
|-
 +
|<br />
 +
|-
 +
|[[File:BL4 Install Drivers.png]]
 +
|-
 +
|<br />
 +
|-
 +
|'''6)''' The installer will inform you when the installation is complete. Click the "Finish" button to complete your install.<br />
 +
|-
 +
|<br />
 +
|-
 +
|[[File:BL4 Install Finish.png]]
 +
|-
 +
|<br />
 +
|-
 +
|}
 +
 
 +
== Download the ROBOTC Building License File ==
 +
{|
 +
|-
 +
|'''1)''' Navigate to the [https://secure.softwarekey.com/solo/customers/Default.aspx ROBOTC Customer Service page] and log in using your Customer ID and Password (this information will be sent to you in a confirmation email after purchasing a ROBOTC Building License).
 +
|-
 +
|<br />
 +
|-
 +
{|
 +
|-
 +
|style="border:1px solid black;"|[[File:BL4 CSP Login.png]]
 +
|-
 +
|}
 +
|-
 +
|<br />
 +
|-
 +
|'''2)''' Select the "Licenses and Activations" icon to view all of the licenses tied to that Customer ID.
 +
|-
 +
|<br /><br />
 +
|-
 +
{|
 +
|style="border:1px solid black;"|[[File:BL4 CSP Licenses.png|border]]<br />
 +
|}
 +
|-
 +
|<br />
 +
|-
 +
|'''3)''' Select the correct Building License File from the list of available licenses (in this example, a ROBOTC for VEX Robotics 4.0 Building License file).
 +
|-
 +
|<br /><br />
 +
|-
 +
{|
 +
|style="border:1px solid black;"|[[File:BL4 CSP Select.png|border]]<br />
 +
|}
 +
|-
 +
|<br />
 +
|-
 +
|'''4)''' Click the 'Download License File' button to download the license file to your computer.
 +
|-
 +
|<br /><br />
 +
|-
 +
{|
 +
|style="border:1px solid black;"|[[File:BL4 CSP Download.png|border]]<br />
 +
|}
 +
|-
 +
|}
 +
 
 +
== Install and Activate the Building License ==
 +
{|
 +
|-
 +
|'''1)''' To activate ROBOTC with a building license, copy the building license file into the ROBOTC directory (typically C:/Program Files (x86)/Robomatter Inc/ROBOTC Development Environment 4.X).
 +
|-
 +
|<br />
 +
|-
 +
{|
 +
|style="border:1px solid black;"|[[File:BL4 ROBOTC Directory.png]]
 +
|}
 +
|-
 +
|<br />
 +
|-
 +
|'''2)''' Once the building license file is installed to the ROBOTC directory, ROBOTC must be run as an administrator in order to write the activation changes to the Windows Registry. To run ROBOTC as an administrator, right click on the ROBOTC icon and select the 'Run as Administrator' option while logged into an administrator's account.
 +
|-
 +
|<br /><br />
 +
|-
 +
|[[File:BL4 ROBOTC Admin.png]]
 +
|-
 +
|<br /><br />
 +
|-
 
|}
 
|}

Revision as of 18:41, 14 May 2014

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. The building license file is stored on the ROBOTC Customer Service server and can be accessed by the end user at any time. To do so, you will need to:
  • Download the latest version of ROBOTC
  • Install ROBOTC
  • Download the building license file from the ROBOTC Customer Service page
  • Install and activate the building license file

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 file is 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 further action required.

There are, however, exceptions to this. 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.

Download the latest version of 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:

BL4 Install Save.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.

Install ROBOTC

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.

BL4 Install Run1.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.

BL4 Install EULA.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 4.X.

BL4 Install Run2.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.

BL4 Install Run3.png

5) During this process, ROBOTC will automatically install the drivers needed for your specific robotics platform, if applicable. You will be prompted if you would like to install the drivers; click the 'Install' button to start the driver install.

BL4 Install Drivers.png

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

BL4 Install Finish.png

Download the ROBOTC Building License File

1) Navigate to the ROBOTC Customer Service page and log in using your Customer ID and Password (this information will be sent to you in a confirmation email after purchasing a ROBOTC Building License).

BL4 CSP Login.png

2) Select the "Licenses and Activations" icon to view all of the licenses tied to that Customer ID.

BL4 CSP Licenses.png

3) Select the correct Building License File from the list of available licenses (in this example, a ROBOTC for VEX Robotics 4.0 Building License file).

BL4 CSP Select.png

4) Click the 'Download License File' button to download the license file to your computer.

BL4 CSP Download.png

Install and Activate the Building License

1) To activate ROBOTC with a building license, copy the building license file into the ROBOTC directory (typically C:/Program Files (x86)/Robomatter Inc/ROBOTC Development Environment 4.X).

BL4 ROBOTC Directory.png

2) Once the building license file is installed to the ROBOTC directory, ROBOTC must be run as an administrator in order to write the activation changes to the Windows Registry. To run ROBOTC as an administrator, right click on the ROBOTC icon and select the 'Run as Administrator' option while logged into an administrator's account.

BL4 ROBOTC Admin.png