2.2.1
Tornado
Getting Started Guide
WINDOWS VERSION
®
getStart.book Page i Friday, April 25, 2003 11:55 AM
Copyright 2003 Wind River Systems, Inc.
ALL RIGHTS RESERVED. No part of this publication may be copied in any form, by
photocopy, microfilm, retrieval system, or by any other means now known or hereafter
invented without the prior written permission of Wind River Systems, Inc.
Wind River, the Wind River logo, Tornado, and VxWorks are registered trademarks of
Wind River Systems, Inc. Any third-party trademarks referenced are the property of their
respective owners. For further information regarding Wind River trademarks, please see:
http://www.windriver.com/company/terms/trademark.html
Corporate Headquarters
Wind River Systems, Inc.
500 Wind River Way
Alameda, CA 94501-1153
U.S.A.
toll free (
U.S.): (800) 545-WIND
telephone: (510) 748-4100
facsimile: (510) 749-2010
For additional contact information, please visit the Wind River URL:
http://www.windriver.com
For information on how to contact Customer Support, please visit the following URL:
http://www.windriver.com/support
Tornado Getting Started Guide, 2.2.1 (Windows Version)
25 Apr 03
Part #: DOC-15098-8D-00
getStart.book Page ii Friday, April 25, 2003 11:55 AM
iii
Contents
Documentation Guide .............................................................................................. v
Introduction ........................................................................................ v
Printed Documentation ..................................................................... v
List of Documents .............................................................................. vi
Accessing Online Documentation ................................................... viii
Content Overview .............................................................................. ix
Release and Migration Information ................................................ ix
Tornado IDE and Tools ...................................................................... x
VxWorks Operating System ............................................................. xi
GNU Compiler and Tools ................................................................. xiii
Diab C/C++ Compiler and Tools .................................................... xiii
Documentation Conventions ........................................................... xiv
1 Overview ................................................................................................................... 1
1.1 Introduction ...................................................................................................... 1
1.2 Terminology and Conventions ....................................................................... 2
2 Installation and License Management .................................................................... 3
2.1 Overview ........................................................................................................... 3
2.2 Installing Tornado and Related Products ..................................................... 3
Host System Requirements .............................................................. 3
Installation Media .............................................................................. 4
Installation Keys ................................................................................. 4
getStart.book Page iii Friday, April 25, 2003 11:55 AM
Tornado 2.2.1
Getting Started Guide
iv
License Management ........................................................................ 4
Restricting Group Usage in a Solaris Environment ...................... 5
Running SETUP ................................................................................. 6
Setting Environment Variables ........................................................ 8
Running Tornado ............................................................................... 10
Uninstalling Tornado ........................................................................ 11
2.3 Installing and Administering a License Server ........................................... 12
Installing and Configuring a License Server ................................. 12
Administering a License Server ...................................................... 12
UNIX License Server Lock File Permission Issues ....................... 14
Getting Help With License Management ....................................... 14
3 Tornado Tutorial ........................................................................................................ 15
3.1 Introduction ...................................................................................................... 15
3.2 Start Tornado .................................................................................................... 16
3.3 Create a Project ................................................................................................. 18
3.4 Add the Sample Source File to the Project ................................................... 22
3.5 Build the Project ............................................................................................... 24
3.6 Download the Project to the VxWorks Target Simulator ........................... 26
3.7 Run the Application from the Tornado Shell ............................................... 29
3.8 Examine Target Memory Consumption ....................................................... 31
3.9 Examine Task Activity ..................................................................................... 32
3.10 Fix Task Priorities and Find the Next Bug .................................................... 35
3.11 Fix the Last Bug and Take it for a Spin ......................................................... 37
3.12 What Next? ....................................................................................................... 40
getStart.book Page iv Friday, April 25, 2003 11:55 AM
v
Documentation Guide
Introduction
This guide to Tornado 2.2.1 documentation provides an overview of the
documentation, which includes:
■
how to obtain printed books
■
a list of documents and available formats
■
how to access documents online
■
a content overview
■
documentation conventions
Printed Documentation
This release of Tornado is shipped with printed versions of the Tornado Release
Notes, the Tornado Getting Started Guide (for Windows or UNIX), the GNU Toolchain
for Tornado 2.2 Release Notes, and the Diab Release Notes, 5.0.3 (for ColdFire, or for
other architectures when purchased as an optional product).
The full documentation set for this release is shown in Table 1. Please refer to the
flyer entitled “Obtaining Your Printed Manuals” in your software shipment for
information on obtaining the printed books that are part of your purchase. Books
are distributed through the online Wind River bookstore located at:
http://www.windriver.com/windsurf/bookstore/
getStart.book Page v Friday, April 25, 2003 11:55 AM