Difference between pages "TETRIX Samantha Module" and "Building License Installation - 4.0"

From ROBOTC API Guide
(Difference between pages)
Jump to: navigation, search
(Gather required information)
 
 
Line 1: Line 1:
<yambe:breadcrumb>TETRIX|TETRIX</yambe:breadcrumb>
+
=== Building License Installation - ROBOTC 4.0 ===
 +
{|
 +
|-
 +
|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
 +
* Run ROBOTC as an administrator
 +
|-
 +
|<br />
 +
|-
 +
|}
  
== Gather the Required Information ==
+
== Download the latest version of ROBOTC ==
{| 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.
 
|-
 
|-
| Before you can use your Samantha Module with ROBOTC, you must install the Windows drivers and set the device up for use.
+
|<br />
'''Note: There are many different router configurations, and many different combinations of network type, encryption type, etc. We are using a commonly used network setup (with the router in between the computer and modem, standard encryption, etc). Your particular setup may be different, and may require additional steps to set up properly.
+
 
|-
 
|-
|'''1.''' The first thing we will want to do is download and install FTC's Field Control Software package. This can be found on FIRST's site (usfirst.org).
+
|'''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:
 
|-
 
|-
|'''2.''' Next, we will need the SSID, encyption type, and password for the network we wish to connect to. For testing purposes, we named our router "SamoTest1" with an encryption type of WPA (TKIP).
+
|<br />
 
|-
 
|-
|[[File:Windows_Install_3.jpg]]
+
|[[File:Install_Download_Firefox.png]]
 
|-
 
|-
|'''3.''' You will also need a 4GB or smaller USB flash drive, formatted to FAT32 file format. To format the flash drive, navigate to the Start menu, select Computer, right click on the flash drive's name, then click Format. In the drop down box, select 'FAT32' as the file format, and check the 'Quick Format' box (for a faster format).
+
|<br />
 
|-
 
|-
|[[File:Windows_Install_4.jpg]]
+
|[[File:Install_Download_IE.png]]
 
|-
 
|-
|'''4.''' Navigate to the Start menu, All Programs, Samantha Field Control System, and start the program called "Samantha Network Config".
+
|<br />
 
|-
 
|-
|'''5.''' Close the program and navigate to your ROBOTC installation folder (default location of C:\Program Files(x86)\Robomatter Inc\ROBOTC Developement Environment). Navigate to the Firmware folder and copy the Samantha.hex file into your flash drive. You should also see a folder named "SMRTNTKY"; this is where the Network Config tool saved the config file for your network.
+
|'''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 />
 
  
== Flash the Samantha Module ==
+
== Install ROBOTC ==
{| 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.
 
|-
 
|-
| You must update the Samantha Module's firmware and install the config file you created using the Network Config tool before it will work properly on your network.
+
|<br />
 
|-
 
|-
|1.  Unplug the USB flash drive from your computer and (making sure the battery is unplugged) plug it into the Samantha Module. Plug in the battery while holding down the red/black button on top of the module. Release the button approximately 3 seconds after the red light appears on the module.
+
|[[File:Install_Normal.png]]
 
|-
 
|-
|[[File:Bluetooth_Link_1.jpg]]
+
|<br />
 
|-
 
|-
|2.  The Samantha Module will flash the red light twice in rapid succession and then flash the white repeatedly. You may also see the flash drive's LED flickering (if applicable). This means the Samantha Module is installing the firmware. When it's done, it will flash the red, white, and blue lights in sequence, then repeat the process. Be patient; this process normally takes 20-30 seconds and as long as 2-3 minutes. When it is done it should have a solid red light and a blinking white light (meaning it is connected to the network).
+
|'''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.
 
|-
 
|-
|[[File:Bluetooth_Link_2.jpg]]
+
|<br />
 
|-
 
|-
|}
+
|[[File:Install_End_User.png]]
<br />
+
 
+
== Installing and updating the NXT ==
+
{| 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.  Like all other Windows devices, the NXT requires a driver in order to work properly. You can find the NXT drivers here on ROBOTC's website. Download and install it.
+
|<br />
 
|-
 
|-
|[[File:Bluetooth_connect_1.gif]]
+
|'''3)''' Next, select where you would like ROBOTC to install to. The default location is C:/Program Files (x86)/Robomatter Inc/ROBOTC Development Environment.
 
|-
 
|-
|2.  Next, download ROBOTC's firmware to the NXT. To do this, connect the NXT to the computer and turn it on. Navigate to the Robot menu in ROBOTC and make sure that "LEGO MINDSTORMS NXT+TETRIX" is chosen as the 'Platform Type' and that 'Physical Robot' is chosen in 'Compiler Target'. Then, click Download Firmware->Standard File to download the ROBOTC firmware to the NXT (this should take anywhere from 10 seconds up to a minute).
+
|<br />
 
|-
 
|-
|[[File:Bluetooth_connect_1.2.gif]]
+
|[[File:Install_Select_Directory.png]]
 
|-
 
|-
|3.  Navigate to File->Open Sample Program->NXT->Samantha Module->samostat.c. Compile and download this program onto the NXT brick.
+
|<br />
 
|-
 
|-
|[[File:Bluetooth_connect_2.gif]]
+
|'''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 />
 
|-
 
|-
|4.  Navigate to Robot->NXT Brick->Communication Link Setup and change the 'Search Selection' drop down menu to "USB, Bluetooth, or Wifi". This will enable ROBOTC to search your network for the NXT once it is connected. Click close to save the changes.
+
|<br />
 
|-
 
|-
|[[File:Bluetooth_connect_4.gif]]
+
|[[File:Install_Install_Progress.png]]
 
|-
 
|-
 +
|<br />
 +
|-
 +
|'''5)''' The installer will inform you 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 />
 
  
== Connecting the NXT and Samantha Module ==
+
 
{| 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"
+
== 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 />
 +
|-
 +
|[[File:Building License Login.png]]<br />
 +
|-
 +
|<br />
 +
|-
 +
|'''2)''' Select the "Licenses and Activations" icon to view all of the licenses tied to that Customer ID.
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Building License Select.png]]<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 />
 +
|-
 +
|[[File:Building License Select2.png]]<br />
 +
|-
 +
|<br />
 +
|-
 +
|'''4)''' Click the 'Download License File' button to download the license file to your computer.
 +
|-
 +
|<br />
 +
|-
 +
|[[File:Building License Download.png]]<br />
 
|-
 
|-
|1.  Keeping the USB-B end connected to the NXT, disconnect the USB flash drive from the Samantha Module and the USB-A connector from the computer. Connect the USB cable to the Samantha Module instead.
+
|<br />
 
|-
 
|-
|[[File:Disconnect_bluetooth_1.gif]]
+
|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).  
 
|-
 
|-
|2.  Turn on the NXT and th Samantha Module if you have not done so already. The NXT will show that it is connected via USB and the Samantha Module's 'NXT' LED should turn a solid blue (it may flicker from time to time; this means that it is transferring data to the NXT).
+
|<br />
 
|-
 
|-
|[[File:Disconnect_bluetooth_2.gif]]
+
|[[File:Building_License_Location.png]]
 
|-
 
|-
|3.  If the blue NXT does not light up, press the red/black button on top of the Samantha module.
+
|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.  
 
|-
 
|-
|[[File:Disconnect_bluetooth_3.gif]]
+
|<br />
 
|-
 
|-
|4. Run the "samostat" program on the NXT. After a few seconds, it should connect to the wireless network through the Samantha Module and display information such as the SSID, IP address, etc. You can then type in the IP address displayed into a web browser to pull up the Samantha Module's NXT Status Page.
+
|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.
 
|-
 
|-
 
|}
 
|}
<br />
 

Revision as of 15:41, 14 May 2014

Building License Installation - ROBOTC 4.0

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
  • Run ROBOTC as an administrator

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:

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.

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.

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


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

Building License Login.png

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

Building License Select.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).

Building License Select2.png

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

Building License Download.png

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.