Tornado® 2.2 USER’S GUIDE UNIX VERSION Copyright 2002 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. AutoCode, Embedded Internet, Epilogue, ESp, FastJ, IxWorks, MATRIXX, pRISM, pRISM+, pSOS, RouterWare, Tornado, VxWorks, wind, WindNavigator, Wind River Systems, WinRouter, and Xmath are registered trademarks or service marks of Wind River Systems, Inc. Attaché Plus, BetterState, Doctor Design, Embedded Desktop, Emissary, Envoy, How Smart Things Think, HTMLWorks, MotorWorks, OSEKWorks, Personal JWorks, pSOS+, pSOSim, pSOSystem, SingleStep, SNiFF+, VxDCOM, VxFusion, VxMP,VxSim, VxVMI, Wind Foundation Classes, WindC++, WindManage, WindNet, Wind River, WindSurf, and WindView are trademarks or service marks of Wind River Systems, Inc. This is a partial list. For a complete list of Wind River trademarks and service marks, see the following URL: http://www.windriver.com/corporate/html/trademark.html Use of the above marks without the express written permission of Wind River Systems, Inc. is prohibited. All other trademarks mentioned herein are the property of their respective owners. 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 User’s Guide, 2.2 30 Jul 02 Part #: DOC-14208-2D-01 1 Overview ................................................................................................................... 1 2 Setup and Startup .................................................................................................... 15 3 Launcher ................................................................................................................... 65 4 Projects ..................................................................................................................... 93 5 Command-Line Configuration and Build ............................................................... 169 6 VxSim ........................................................................................................................ 217 7 Shell ........................................................................................................................... 245 8 Browser ..................................................................................................................... 307 9 Debugger ................................................................................................................... 333 10 Building VxDCOM Applications .............................................................................. 381 11 Customization ........................................................................................................... 403 A Directories and Files ................................................................................................ 421 B Makefile Details ........................................................................................................ 435 C Tcl .............................................................................................................................. 441 D Coding Conventions ................................................................................................ 449 E X Resources .............................................................................................................. 483 F VxWorks Initialization Timeline ............................................................................... 485 iii iv Contents 1 Overview ................................................................................................................... 1 1.1 Introduction ...................................................................................................... 1 1.2 Cross-Development with Tornado ................................................................. 3 1.3 VxWorks Target Environment ........................................................................ 4 1.4 Tornado Host Tools .......................................................................................... 5 Launcher .............................................................................................. 5 Project Management .......................................................................... 6 Compiler .............................................................................................. 6 WindSh Command Shell ................................................................... 6 CrossWind Debugger ........................................................................ 7 Browser ................................................................................................ 7 WindView Software Logic Analyzer ............................................... 8 VxSim Target Simulator .................................................................... 8 1.5 Host-Target Interface ....................................................................................... 9 Target Agent ....................................................................................... 9 Tornado Target Server ....................................................................... 10 Tornado Registry ................................................................................ 11 Virtual I/O .......................................................................................... 11 1.6 Customer Services ............................................................................................ 12 v Tornado 2.2 User’s Guide 2 Setup and Startup .................................................................................................... 15 2.1 Introducing Tornado ........................................................................................ 15 2.2 Setting up the Tornado Registry .................................................................... 19 2.3 The Tornado Host Environment .................................................................... 20 2.3.1 Environment Variables for Tornado Components ........................ 21 2.3.2 Environment Variable For Solaris Hosts ........................................ 22 2.3.3 Environment Variables for Convenience ....................................... 23 2.3.4 X Resource Settings ........................................................................... 23 2.4 Setting Up the Default Target Hardware ...................................................... 24 2.4.1 Default Target Configuration ........................................................... 24 2.4.2 Networking the Host and Target ..................................................... 25 Initializing the Host Network Software ......................................... 26 Establishing the VxWorks System Name and Address ............... 26 Giving VxWorks Access to the Host ............................................... 27 2.4.3 Configuring the Target Hardware ................................................... 27 Setting Up a Boot Mechanism .......................................................... 28 Setting Board Jumpers ...................................................................... 29 Board Installation and Power .......................................................... 29 Connecting the Cables ...................................................................... 30 2.5 Host-Target Communication Configuration ................................................ 31 2.5.1 Network Connections ....................................................................... 31 Configuring the Target Agent for Network Connection .............. 31 2.5.2 END Connections .............................................................................. 32 Configuring the Target Agent for END Connection ..................... 32 2.5.3 Serial-Line Connections .................................................................... 32 Configuring the Target Agent for Serial Connection ................... 33 Configuring the Boot Program for Serial Connection .................. 33 Testing the Connection ..................................................................... 33 Starting the Target Server ................................................................. 35 vi Contents 2.5.4 The NetROM ROM-Emulator Connection ..................................... 35 Configuring the Target Agent for NetROM ................................... 36 Configuring the NetROM ................................................................. 36 Starting the Target Server ................................................................. 40 Troubleshooting the NetROM ROM-Emulator Connection ........ 41 2.5.5 The Transparent Mode Driver (TMD) ............................................. 43 Configuring the Target Agent for TMD .......................................... 43 Configuring visionICE II/visionPROBE II ..................................... 44 Starting the Target Server ................................................................. 45 2.6 Booting VxWorks .............................................................................................. 46 2.6.1 Default Boot Process .........................................................................