Wind River Workbench
USER'S GUIDE
®
3.1
Wind River Workbench User's Guide, 3.1
Copyright © 2008 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, 3.1
3 Dec 08
Part #: DOC-16292-ND-00
iii
Contents
PART I: INTRODUCTION
1 Overview .............................................................................................. 3
1.1 Introduction ............................................................................................................. 3
1.1.1 Introducing Wind River Workbench ..................................................... 3
1.2 Starting Workbench ............................................................................................... 4
1.2.1 Starting Workbench on a Linux or Solaris Host .................................. 5
1.2.2 Starting Workbench on a Windows Host ............................................. 5
1.2.3 Deciding which Workspace to Use ........................................................ 5
1.3 Wind River Documentation ................................................................................. 6
1.3.1 Introducing this Guide ............................................................................ 6
Understanding the Typefaces in this Guide ......................................... 7
1.4 Accessing and Searching Workbench Context-Sensitive Help ..................... 7
1.4.1 Searching for Information in the Documentation ............................... 8
1.4.2 Refining a Search ...................................................................................... 8
Restricting a Search to Local Help ......................................................... 9
Restricting a Search to Another Information Source .......................... 9
1.4.3 For More Information .............................................................................. 10
Wind River Workbench
User's Guide, 3.1
iv
PART II: PROJECTS
2 Building and Debugging a Sample Project ....................................... 13
2.1 Introduction ............................................................................................................. 13
2.2 Creating a Project and Running a Program ....................................................... 14
2.2.1 Resetting to the Default Perspective ...................................................... 14
2.2.2 Creating the ball Project .......................................................................... 14
Creating the Project for the VxWorks Simulator ................................. 15
Creating the Project for a Linux Target ................................................. 15
2.2.3 Importing Source Files Into Your Project ............................................. 15
2.2.4 Building the ball Project .......................................................................... 16
2.2.5 Connecting to the Target ......................................................................... 16
2.2.6 Running the ball Application in the Debugger .................................... 17
2.2.7 Setting Up the Device Debug Perspective ............................................ 18
2.2.8 Stepping Through Code .......................................................................... 19
2.2.9 Setting and Running to a Breakpoint .................................................... 21
2.2.10 Modifying the Breakpoint to Execute Continuously .......................... 23
2.3 Editing and Debugging Source Files .................................................................. 24
2.3.1 Using Bookmarks in Lines and Files ..................................................... 24
Introducing an Error for this Tutorial ................................................... 24
Creating the Bookmark to the Error ...................................................... 24
Locating and Viewing the Bookmark .................................................... 25
2.3.2 Building a Project with Introduced Errors ........................................... 25
2.3.3 Rebuilding the Project Without Errors .................................................. 26
2.3.4 Displaying a File’s History ...................................................................... 26
2.4 Using the Editor’s Code Development Features .............................................. 27
2.4.1 Changing File Preferences ....................................................................... 27
2.4.2 Navigating in the Source ......................................................................... 28
Using the Outline View ........................................................................... 28
Contents
v
Finding Elements (Text Filtering) .......................................................... 29
Finding Strings ......................................................................................... 29
2.4.3 Using Code Completion to Suggest Elements ..................................... 30
2.4.4 Getting Parameter Hints for Routine Data Types ............................... 31
2.4.5 Finding Symbols in Source Files ............................................................ 31
2.4.6 Using Bracket Matching to Find Code Open and Close Sections ..... 32
3 Projects Overview ................................................................................ 33
3.1 Introduction ............................................................................................................. 33
3.2 Choosing Locations for Workspaces and Projects ........................................... 34
3.3 Creating New Projects ........................................................................................... 35
3.3.1 Modifying Project Settings ...................................................................... 36
3.4 Project Types ........................................................................................................... 36
3.4.1 Linux-Specific Projects ............................................................................ 37
Wind River Workbench Projects ............................................................ 37
Wind River Linux Application Project .................................................. 37
Wind River Linux User-Defined Projects ............................................. 37
Wind River Linux Platforms Project ..................................................... 37
Wind River Linux Kernel Module Projects .......................................... 38
Customer-Specific Linux Application Project ...................................... 38
Customer-Specific Linux Kernel Project ............................................... 38
3.4.2 VxWorks-Specific Projects ...................................................................... 38
VxWorks Image Project ........................................................................... 38
VxWorks Source Build Project ............................................................... 39
VxWorks Boot Loader/BSP Project ....................................................... 39
VxWorks Downloadable Kernel Module Project ................................ 39
VxWorks Real-time Process Project ....................................................... 40
VxWorks Shared Library Project ........................................................... 41
VxWorks ROMFS File System Project ................................................... 41
3.4.3 User-Defined Projects .............................................................................. 42
3.4.4 Native Application Projects .................................................................... 43
3.5 Structuring Projects ................................................................................................ 43