Professional Documents
Culture Documents
Document Data
COPYRIGHT
Copyright 2009-2012 Atollic AB. All rights reserved. No part of this document may be reproduced or distributed without prior written consent of Atollic AB. The software product described in this document is furnished under a license and may only be used, or copied, according to the license terms.
TRADEMARKS
Atollic, TrueSTUDIO, TrueINSPECTOR, TrueANALYZER, TrueVERIFIER and the Atollic logotype are trademarks, or registered trademarks, owned by Atollic. ECLIPSE is a registered trademark of the Eclipse foundation. Microsoft, Windows, Word, Excel and PowerPoint are registered trademarks of Microsoft Corporation. Adobe and Acrobat are registered trademarks of Adobe Systems Incorporated. All other product names are trademarks, or registered trademarks, of their respective owners.
DISCLAIMER
The information in this document is subject to change without notice and does not represent a commitment of Atollic AB. The information contained in this document is assumed to be accurate, but Atollic assumes no responsibility for any errors or omissions. In no event shall Atollic AB, its employees, its contractors, or the authors of this document be liable for any type of damage, losses, costs, charges, claims, demands, claim for lost profits, fees, or expenses of any nature or kind.
DOCUMENT IDENTIFICATION
TS-IG Feb 2010
REVISION
9
th th th
Feb 2012 Updated for Atollic TrueSTUDIO v3.0 September 2012 Updated for Atollic TrueSTUDIO v3.2 November 2012 Updated for Atollic TrueSTUDIO v3.3
10 11
ii | P a g e
Document Data
Atollic AB
Science Park Gjuterigatan 7 SE- 553 18 Jnkping Sweden +46 (0) 36 19 60 50 Email: sales@atollic.com Web: www.atollic.com
Atollic Inc.
115 Route 46 Building F, Suite 1000 Mountain Lakes, NJ 07046-1668 USA +1 (973) 784 0047 (Voice) +1 (877) 218 9117 (Toll Free) +1 (973) 794 0075 (Fax) Email: sales.usa@atollic.com Web: www.atollic.com
iii | P a g e
Table of Contents
Contents
Introduction............................................................................. 6
Intended Readers ....................................................................................... 6 Document Conventions .............................................................................. 7
List of Contents
iv | P a g e
List of Figures
Figures
Figure 1 - Installer Welcome Dialog ............................................................. 14 Figure 2 - License Agreement Dialog............................................................ 15 Figure 3 Selection of GDB Servers ............................................................. 15 Figure 4 - Choose Installation Location ........................................................ 16 Figure 5 Selection of Pro License Type ...................................................... 17 Figure 6 - License Registration ..................................................................... 18 Figure 7 Floating License Registration....................................................... 19 Figure 8 - Register License Web Page .......................................................... 19 Figure 9 License Registration Web Form .................................................. 20 Figure 10 - License Registration Dialog ........................................................ 21 Figure 11 Installing Dialog ......................................................................... 22 Figure 12 - Installation Complete ................................................................. 22 Figure 13 File Association .......................................................................... 23 Figure 14 Upgrade information ................................................................. 23 Figure 15 - Highlighted Features Atollic TrueSTUDIO Pro ....................... 24 Figure 16 - Highlighted Features Atollic TrueINSPECTOR, Atollic TrueANALYZER and Atollic TrueVERIFIER................................................. 24 Figure 17 - Finishing the Installation ............................................................ 25 Figure 18 - License Information Dialog ........................................................ 28 Figure 19 - License Activation Dialog ........................................................... 29 Figure 20 - Successful Activation .................................................................. 30 Figure 21 No Connection ........................................................................... 30 Figure 22- License Not Enabled or Already Activated .................................. 30 Figure 23 - Manual Activation Dialog ........................................................... 31 Figure 24 - Activate Pro License Web Form ................................................. 32 Figure 25 - Manual Activation with Installation Key .................................... 33 Figure 26 - Successful Activation .................................................................. 33 Figure 27 - Invalid Installation Key ............................................................... 34 Figure 28 Open the License Manager ....................................................... 36 Figure 29 Kill License Panel ........................................................................ 37 Figure 30 Confirm License Kill Dialog ......................................................... 37 Figure 31 License Kill Code Dialog. ............................................................ 38 Figure 32 Installer Shortcut dialog. ........................................................... 42
iv | P a g e
List of Tables
Tables
Table 1 Typographic Conventions ............................................................... 7
v|Page
Introduction
INTRODUCTION
Welcome to the Atollic TrueSTUDIO Installation guide. The purpose of this document is to give directions on how to install and register the Atollic TrueSTUDIO product.
INTENDED READERS
This document is primarily intended for system administrators or software developers about to install the Atollic TrueSTUDIO product.
6|Page
Introduction
DOCUMENT CONVENTIONS
The text in this document is formatted to ease understanding and provide clear and structured information on the topics covered. The following typographic conventions apply:
Style
Command Object Name
Use
Keyboard Command or Source Code Section. Name of a User Interface Object (Menu, Menu Command, Button, Dialog Box, etc.) that appears on the computer screen. Cross reference within the document, or to an external document. Name of Atollic product. Identifies instructions specific to the Graphical User Interface (GUI). Identifies instructions specific to the Command Line Interface (CLI).
Cross Reference
Product Name
Identifies a Caution.
7|Page
Introduction
Section 1.
System Requirements Important Information Installation Registration
INSTALLATION
This section provides information on how to install and register Atollic TrueSTUDIO. The following topics are covered:
8|Page
License Activation
Lite version license limitation summary Atollic TrueSTUDIO Lite is a free of charge and reduced version of Atollic TrueSTUDIO Pro. The Lite version contains almost all features needed for development and debugging, but lacks some of the more advanced features from the Pro version. It also has a code-size limitation. The Lite version may be used for commercial development, given that the end-user manual of the product developed clearly advertises that the product is developed using Atollic TrueSTUDIO. The manual must also include a link to www.atollic.com. This is required as long as at least one of the product developers use the Lite version. Only if all developers use the Pro version, may this be omitted.
For more information on the features and differences between the Lite and Pro version, please read the Atollic TrueSTUDIO Feature Comparison Guide, which is available here: www.atollic.com/index.php/feature-comparison
9|Page
License Activation
SYSTEM REQUIREMENTS
Atollic TrueSTUDIO is tested and verified on the following Operating Systems: Microsoft Windows XP Microsoft Windows Vista (32-bit version) Microsoft Windows Vista (64-bit version) Microsoft Windows 7 (32-bit version) Microsoft Windows 7 (64-bit version)
The following Hardware Requirements apply: 1 GB RAM 3 GB of free hard disk space An Ethernet Network Card Internet access. Required to register the license An email account. Required to obtain an Installation Key For the Atollic TrueSTUDIO Pro version: A valid License Number. This is delivered via email to the account registered in conjunction with purchase of the product. This may differ from the email account above needed to receive the Installation Key. If you do not have access to a valid License Number, please contact the person who purchased the product.
The user must have write-access to the home directory to be able to start Atollic TrueSTUDIO.
10 | P a g e
License Activation
IMPORTANT INFORMATION
This section contains important information on installing the product.
EMAIL DELIVERY
During installation, the Atollic TrueSTUDIO product will be registered at Atollic. This is done online on the Atollic web site. The process involves receiving an Installation Key, via email.
In case an email related to the Atollic TrueSTUDIO product is not delivered as expected, it is most likely caught in a spam filter. Please check the local spam filter of your email client, and the central spam filter of your organization, or IT-provider. When in doubt, contact support@atollic.com for help.
11 | P a g e
License Activation
To transfer a Node Locked License, do not uninstall the Atollic TrueSTUDIO product from the original computer, before deactivating (killing) the license.
12 | P a g e
License Activation
Before installing the product, make sure the date is set correctly on the computer. Once the installation with the Temporary Installation Key is completed, the date must not be changed, until the product is activated with the Permanent Installation Key.
13 | P a g e
License Activation
1. 2. 3.
Launch the product installer (.exe-file) During the installation process, Microsoft Windows may display a warning dialog, concerning Unknown software publisher. Please accept to let the installer continue. Wait for the installer Welcome dialog to be displayed:
14 | P a g e
License Activation
4.
Read the license agreements. Click I Accept to accept them, or Cancel to abort the installation. If the license agreements are accepted, the installation wizard will display the Choose Components dialog.
5.
15 | P a g e
License Activation
Select the GDB Server components to be installed together with Atollic TrueSTUDIO. A server is needed for each type of JTAG probe that are to be used for debugging with Atollic TrueSTUDIO. The set of GDB server components available for selection depends on which targets the Atollic TrueSTUDIO product is aimed for.
6.
Click the Browse button to optionally change the default installation directory. Click Next to continue the installation. If the installation concerns Atollic TrueSTUDIO Lite, please continue with step 9.
16 | P a g e
License Activation
7.
Applies to Atollic TrueSTUDIO Pro installation only: Please wait for the Please select license type dialog to be displayed. If the purchased license has a USB License Key, please insert your USB License Key and select USB License Key in this dialog. If the USB License Key is already registered to have a valid Installation Key, please press Next and continue with step 18.
The USB License Key needs to have an assigned drive letter greater then C:. If it has been assigned A:, B: or C: it will not work properly.
If the purchased license is a Floating Network License, then select Floating Network License. Please press Next to continue. Otherwise, select Node Locked License and press Next to continue.
17 | P a g e
License Activation
8.
Depending on the selection in the License type selection page you will be shown one of these two registration forms. This first dialog is used for node locked, remote desktop and USB license key users:
The product installer calculates a unique Computer Id and opens the registration page on the Atollic web site (http://www.atollic.com/register). If this webpage is not opened automatically, please browse to it manually. If Floating Network License was selected in the previous page, a Network Client Installation Key is needed to complete the installation. This key was delivered to your organization when your system administrator registered the Floating Network License server installation. Please enter the Network Client Installation Key and press Next and continue on step 16:
18 | P a g e
License Activation
9.
Please wait for the Register license page to be displayed in the web browser. The installer uses the default web browser registered on the computer.
19 | P a g e
License Activation
11.Enter the contact information and select customer type: Please make sure
that a valid email address is entered. Only use Latin characters when entering your information. When installing a Pro version, a valid License Number must also be entered. This License Number should have been delivered via email to the person who purchased the product. If you do not have access to the License Number, please contact this person.
12. Copy the Computer Id from the installation program (see Figure 6) and paste
it in the Computer Id field in the form on the webpage. Note: If installing a Pro version, please observe that the Computer ID and the License Number are different entities.
13. When all information is entered as required, please click the Register button
to register the product license.
20 | P a g e
License Activation
14. Please
close the web browser. Open the email client and check for new messages. A message should have been received a message from Atollic with the title Your Atollic TrueSTUDIO Installation key. If the email is not received as expected, it may have been caught in a Spam Filter, or ended up in a Thrash Folder, rather than the Inbox.
15.Open the email, copy the Installation Key and paste it into the Installation
Key field in the installation program.
16. Please click Next to start the installation. Wait for the product installation to
start. This may take several minutes depending on the computer performance.
21 | P a g e
License Activation
22 | P a g e
License Activation
Please enter the desired associations between file-extensions and Atollic TrueSTUDIO. By associating the .project-file, it is possible to automatically import and start editing new projects, just by double-clicking on the file.
19. A page showing information that is relevant to users who are upgrading from
a previous version of Atollic TrueSTUDIO is displayed. Please read this information carefully when upgrading from a previous version.
23 | P a g e
License Activation
This dialog is not displayed in Pro versions. Please click Next to continue.
Figure 16 - Highlighted Features Atollic TrueINSPECTOR, Atollic TrueANALYZER and Atollic TrueVERIFIER
24 | P a g e
License Activation
21. Please click Next to continue to the final step of the installation process.
A NOTE TO FLOATING NETWORK LICENSE USERS Contact your system administrator to receive a ts.cec.ini file that is configured for your network. Place this file in the ide folder of the Atollic TrueSTUDIO client installation folder. For more information about this file and the installation of a floating network license server, please see the separate document Floating network license server installation guide.
25 | P a g e
License Activation
Section 2.
Introduction to License Activation License Manager Automatic License Activation Manual License Activation
LICENSE ACTIVATION
This section provides information on how to activate Atollic TrueSTUDIO. The following topics are covered:
26 | P a g e
License Activation
Please contact your distributor or Atollic customer support via email support@atollic.com if the license is not activated in time and therefor has become invalid. Always include the license number in communication with us.
27 | P a g e
License Activation
28 | P a g e
License Activation
ACTIVATION
When Atollic has enabled the product for activation, the customer will be notified via email. Please make sure this email has been received, before proceeding to the next step. Open the License Manager using the Help, License Manager menu command.
1.
2.
In the Activation panel, use the radio buttons to select the preferred method of activation. If the computer is connected to internet, please select Activate Automatically and press the Activate button. If the computer is not connected to internet, please select Activate Manually and press the Activate button.
AUTOMATIC ACTIVATION
If automatic activation is selected, the activation is performed as follows.
29 | P a g e
License Activation
1.
When the Activate button is pressed, the system responds in one of three different ways. a) Successful Activation. The new license is installed correctly.
b) No Connection with License Server. Please check the internet connection of the computer, and retry activating the license.
Figure 21 No Connection
c)
License Activation Not Enabled, or License Already Activated. This message is displayed if Atollic has not yet enabled activation of the license, or if the license is already activated. Please contact support@atollic.com for help.
30 | P a g e
License Activation
MANUAL ACTIVATION
If manual activation is selected, the activation is performed as follows:
1.
When the Activate button is pressed, the user will be prompted to activate the license manually at www.atollic.com/activate using the presented License Number and Computer Id.
31 | P a g e
License Activation
2.
Open a web browser and visit the web page at www.atollic.com/activate. Please enter the License Number and Computer Id obtained in the previous step. Please click the Activate button.
As a result, an email will be sent to the address entered as part of the license registration (section Installation and Registration). Please make sure that this email has been received, before proceeding to the next step.
32 | P a g e
License Activation
3.
The email contains the Permanent Installation Key for the license. Please copy and paste the Permanent Installation Key into the Installation Key field in the License Manager dialog.
4.
When the Activate button is pressed, the system responds in one of two different ways. a) Successful Activation. The new license is installed correctly
33 | P a g e
License Activation
b) Invalid Installation Key. This message is displayed if the Permanent Installation Key entered is not valid. Please make sure that the complete key is copied and pasted into the Installation Key field. If the problem persists, contact support@atollic.com for help.
34 | P a g e
Introduction
35 | P a g e
TRANSFERRING A LICENSE
A Node Locked License may be transferred from the originally installed computer to another one. This is done through a two-step procedure. First, the license must be deactivated (killed) on the original computer through a dedicated process. Secondly, Atollic TrueSTUDIO must be uninstalled from the original computer. To transfer a Node Locked License, please proceed as follows:
1.
On the original computer, select the menu command Help -> License Manager
36 | P a g e
2. 3.
Wait for the License Manager dialog to be displayed. Select the Kill License panel. Please enter the dedicated password needed to kill the license. The password is kiLLTrueSTUDIOLicensE.
4.
5.
Wait for the License Kill Confirmation dialog to be displayed. Please copy, or make a note of, the License Kill Code, and store it safely.
37 | P a g e
6. 7.
Please send an email containing the License Number and the License Kill Code to support@atollic.com. Upon reception of this email, Atollic checks the License Kill Code for authenticity. Atollic resets the license, provided that the code matches the License Number. An email is sent to the customer, confirming the license reset. Before proceeding, please make sure that this email has been received. Please uninstall the Atollic TrueSTUDIO product from the original computer.
8. 9.
38 | P a g e
39 | P a g e
1. 2. 3. 4. 5.
Launch Atollic TrueSTUDIO Kill the license as described in section 3 above. After the license has been killed, the License Kill Code is displayed. This License Kill Code must be emailed to support@atollic.com for verification. Wait for clearance from Atollic Support that your license is ready to be converted into USB-locked license. Locate the file TS.LIC in the "ide" folder of your TrueSTUDIO install directory. Open this file, remove all content and save the (now empty TS.LIC) file. Insert your USB-dongle into your computer, and then launch TrueSTUDIO. Re-register the product. When this is done the product will work with the USB-dongle. The license is stored on the USB-dongle and can freely be moved between installations for this license type.
6. 7. 8.
For additional information or help, please contact support@atollic.com. Always include the license number in any conversation with us.
40 | P a g e
Introduction
41 | P a g e
FAQ
1. 2. 3.
Right click on the installation executable (the Installer) in the Microsoft Windows Explorer File Browser. Choose Create Shortcut from the Context Menu Right click on the Shortcut and choose Properties. In the Target edit field: Enter reallyadmin following the name of the executable.
42 | P a g e
FAQ
4. 5.
Click OK to close the Shortcut dialog. Double-click on the Shortcut to start the Installer. A message is displayed, announcing that the Check for Administration Rights is overridden.
43 | P a g e
FAQ
Please open this file with Notepad and check for the Kill Code. Send the Kill Code together with the license number to support@atollic.com to verify that your license is no longer in use. This enables us to allow installation of the same license number on another computer.
44 | P a g e
FAQ
NO INTERNET CONNECTION
The computer, on which Atollic TrueSTUDIO is to be installed, may not need an internet connection during normal operation. However, internet access is needed to complete the License Registration. It is not mandatory to register the license from the same computer as Atollic TrueSTUDIO is being installed on. The installation process is basically the same; the only difference is in the registration process.
1. 2.
Please note the address to the http://www.atollic.com/register web page and the Computer Id that the installation program generates on the computer where the product is being installed. Please find another computer with internet access. Please open a web browser, and enter the address http://www.atollic.com/register. Please select Lite Version Registration or Professional Version Registration depending on the version of the product being installed. Please fill in the forms as described in section Installation. Use the Computer Id of the computer where the product is being installed, i.e. the Computer Id noted in Step 1. Please note the Installation Key received via email after a successful registration. Please continue the installation process on the computer where the product is being installed. Use the above Installation Key.
3. 4. 5.
45 | P a g e
FAQ
NO NETWORK CARD
The license management system in Atollic TrueSTUDIO requires an installed network card. The product cannot be installed or run on a computer without a network card. The power saving scheme on some computers (in particular on laptops) may shut down the power supply to the network card, if no network cable (connected to a network) is inserted. If this happens, the existing network card behaves as if there is no network card installed, and the product cannot be installed, or run. To prevent this, please make sure that the network card is activated, and a network cable (connected to a network) is inserted.
46 | P a g e