Wind River Workbench User's Guide
Total Page:16
File Type:pdf, Size:1020Kb
Wind River Workbench User's Guide Wind River® Workbench USER’S GUIDE 2.4 VxWorks Version Copyright © 2005 Wind River Systems, Inc. All rights reserved. No part of this publication may be reproduced or transmitted in any form or by any means 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 This product may include software licensed to Wind River by third parties. Relevant notices (if any) are provided in your product installation at the following location: installDir/product_name/3rd_party_licensor_notice.pdf. Wind River may refer to third-party documentation by listing publications or providing links to third-party Web sites for informational purposes. Wind River accepts no responsibility for the information provided in such third-party documentation. 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 Wind River Workbench User’s Guide, 2.4 (VxWorks Version) 11 Oct 05 Part #: DOC-15623-ZD-00 Contents PART I: INTRODUCTION 1 Overview .............................................................................................. 3 1.1 Introduction ............................................................................................................. 3 1.2 Wind River Documentation ................................................................................. 4 1.3 Road Map to the Wind River Workbench User’s Guide ................................. 4 1.4 Understanding Cross-Development Concepts ................................................. 5 1.4.1 Hardware in a Cross-Development Environment ............................... 5 1.5 Basic Eclipse Concepts .......................................................................................... 7 1.5.1 Window ..................................................................................................... 7 1.5.2 Workspace ................................................................................................. 7 1.5.3 Perspectives ............................................................................................... 8 1.5.4 Views .......................................................................................................... 10 1.5.5 Editors ........................................................................................................ 11 1.5.6 Projects ....................................................................................................... 11 1.6 Accessing Additional Interface Information .................................................... 12 iii Wind River Workbench User’s Guide, 2.4 (VxWorks Version) 2 Wind River Workbench Tutorials ....................................................... 13 2.1 Introduction ............................................................................................................. 13 2.2 Starting Wind River Workbench ......................................................................... 14 2.3 Tutorial: Creating a Project and Running a Program ...................................... 15 2.3.1 Before You Begin ....................................................................................... 15 2.3.2 Creating a Project ..................................................................................... 15 2.3.3 Importing Source Files Into Your Project .............................................. 16 2.3.4 Building Your Project ............................................................................... 17 2.3.5 Creating a Connection Definition to the VxWorks simulator ............ 17 2.3.6 Downloading the Program and Attaching the Debugger .................. 18 2.3.7 Setting Up the Device Debug Perspective ............................................ 18 2.3.8 Setting and Running to a Breakpoint. ................................................... 20 2.3.9 Modifying the Breakpoint ....................................................................... 21 2.4 Tutorial: Editing and Debugging Source Files ................................................. 21 2.4.1 Before You Begin ....................................................................................... 22 2.4.2 Introducing an Error into the Source Code .......................................... 22 2.4.3 Tracking Down a Build Failure .............................................................. 22 2.4.4 Rebuilding the Project ............................................................................. 23 2.5 Tutorial: Using the Editor’s Code Development Features .............................. 23 2.5.1 Using Code Completion to Add Symbols to Your File ....................... 23 2.5.2 Using Parameter Hints ........................................................................... 24 2.5.3 Using Bracket Matching to Clarify Syntax ........................................... 25 2.6 Tutorial: Tracking Items of Interest in Your Files ............................................. 25 2.6.1 Creating a Bookmark on a Source Line in a File .................................. 26 2.6.2 Creating a Bookmark for an Entire File ................................................. 26 2.6.3 Locating and Viewing Your Bookmarks ............................................... 26 iv Contents 3 Setting Up Your Hardware .................................................................. 29 3.1 Introduction ............................................................................................................. 29 3.1.1 Overview of Host and Target Configuration Tasks ............................. 30 3.1.2 Understanding Target Servers and Target Agents .............................. 30 3.2 Configuring Your Cross-Development System ................................................ 33 3.2.1 Configuring Host Software ..................................................................... 33 3.2.2 Verifying Serial Setup and Power .......................................................... 37 3.3 Setting Up a Boot Mechanism ............................................................................. 41 3.4 Booting VxWorks .................................................................................................... 43 3.4.1 Default Boot Process ................................................................................ 43 3.4.2 Entering New Boot Parameters .............................................................. 44 3.4.3 Boot Program Commands ....................................................................... 46 3.4.4 Description of Boot Parameters ............................................................. 47 3.4.5 Booting With New Parameters ............................................................... 50 3.4.6 Alternate Boot Methods .......................................................................... 52 3.4.7 Rebooting VxWorks ................................................................................. 53 3.5 Configuring Host-Target Communication for Workbench ............................ 54 3.5.1 Ethernet Connections ............................................................................... 54 3.5.2 Serial-Line Connections ........................................................................... 57 3.6 Troubleshooting VxWorks Problems ................................................................. 60 PART II: PROJECTS 4 Projects Overview ................................................................................ 63 4.1 Introduction ............................................................................................................. 63 4.2 Workspace/Project Location ................................................................................. 64 v Wind River Workbench User’s Guide, 2.4 (VxWorks Version) 4.3 Creating New Projects ........................................................................................... 64 4.3.1 Subsequent Modification of Project Creation Wizard Settings .......... 65 4.3.2 Projects and Application Code ............................................................... 65 4.4 Overview of Preconfigured Project Types ......................................................... 66 4.4.1 Workbench Sample Projects .................................................................... 66 4.4.2 VxWorks Image Project ........................................................................... 66 4.4.3 VxWorks Board Support Package Project ............................................. 67 4.4.4 VxWorks Downloadable Kernel Module Projects ............................... 67 4.4.5 Real-time Process Projects ....................................................................... 68 4.4.6 VxWorks Shared Library Projects .......................................................... 69 4.4.7 VxWorks File System Projects ................................................................. 69 4.4.8 Native Application Projects .................................................................... 70 4.5 Projects and Project