WindView

User's Guide

2.0.1

Edition 1

[Copyright][Online Manuals]

Contents

1 Introduction
1.1 What WindView Can Do for You
1.2 Integrated WindView
1.3 System Requirements: Optional Product
1.4 Documentation Guide
About This Document
Release Notes
Online Help
Other Resources
2 Getting Started
2.1 Introduction
2.2 Running WindView
2.2.1 The WindView Defaults
Launch WindView
Collection Configuration
Control Properties
2.2.2 Collecting Data
Start WindView
View Log Status
Stop WindView
Upload Data
Saving the Log File
2.3 An Overview of WindView
2.3.1 Understanding Events
2.3.2 The View Graph
2.4 WindView Optional Product
2.4.1 Installing WindView
2.4.2 Configuring VxWorks
WindView Libraries
Timestamp Driver
Upload Path
Post-Mortem Analysis
Triggering
Rebuilding VxWorks and Rebooting Your Target
2.4.3 Starting a Target Server
Configuring the Target Server for TSFS
Launching the Target Server
2.5 Preparing for Distribution
3 Configuring Data Collection
3.1 Introduction
3.2 Selecting a Logging Level
Context Switch Logging Level (CSE Level)
Task State Transition Logging Level (TST Level)
Additional Instrumentation Logging Level (AIL Level)
3.3 Instrumented Objects
The Selection Screen
The Memory Library
3.4 Starting and Stopping Data Collection
4 Configuring Data Upload
4.1 Introduction
4.2 Dynamic Ring Buffer
4.2.1 Parameters
Minimum Buffer Count
Maximum Buffer Count
Buffer Size
4.2.2 Buffer-Full Behavior
4.3 Upload Path and Destination
4.3.1 Alternative Upload Paths
Target Server
Network Facilities
4.3.2 Alternative Destinations
View Graph
File
4.3.3 Choosing the Path and Destination
Direct to Graph
File via TSFS
Socket via TSFS
Socket via TCP/IP
NFS to File
4.4 Upload Mode
Deferred Upload Mode
Continuous Upload Mode
Post-Mortem Mode
5 Data Display
5.1 Introduction
5.2 Controlling the Displayed Interval
The Tool Bar
The Event Pop-Up Menu
5.3 Viewing Context Information
The Task Pop-Up Menu
Context State Information
Context State Summary
5.4 Viewing Event Information
The Status Bar
The Show Event Dialog Box
The Legend Window
The Event Dictionary
5.5 Viewing Analog Information
Analysis Packs
Splitting the View Graph
Exporting Data to Excel (Windows only)
5.6 Filtering for Data of Interest
Specify Which Tasks to Display
Hide Nonexecuting States
The Filter Events/States Dialog Box
6 Triggering
6.1 Introduction
6.2 The Triggering GUI
Specifying a Trigger
Specifying an Action
Saving a Trigger Configuration
Loading a Trigger Configuration File
Starting Triggering
Stopping Triggering
Chaining Triggers
6.3 Using Triggers
Using a Trigger to Start Log Collection
Using a Trigger to Stop Log Collection
Triggering Examples
Other Uses of Triggering
7 Data Collection
7.1 Introduction
7.2 WindView Instrumentation Classes
7.3 Selecting Additional Libraries
Kernel Libraries
Additional Libraries
7.4 Adding Eventpoints
The e( ) Routine
The wvEvent( ) Routine
7.5 Merging Logs from Multiple Processors
7.6 Timestamping
High-Resolution Timestamp Driver
Sequence-Stamp Driver
7.7 Dynamic Buffer Allocation
7.7.1 Configuring the Event Log Buffer
Upload Mode
rBuff Task Priority
Target Memory Constraints
7.7.2 Configuration Tuning
8 Data Upload
8.1 Introduction
8.2 Data Upload Mode
Deferred Upload Mode
Continuous Upload Mode
Post-Mortem Mode
Configuring the Upload Task
8.3 Data Upload to the Host
The Target Server Path
The Network Path
8.4 The evtRecv Tool
Running evtRecv on UNIX
Running evtRecv on Windows
A WindView Architecture
A.1 Introduction
A.2 Host Facilities
WindView
Event-Base
Non-WindView Tools
A.3 Target Facilities
WindView
VxWorks Events
Logging
Timestamp Driver
Triggering
Dynamic Ring Buffer
A.4 Communication Facilities
WindView Communication
Event Data Upload
B Event Dictionary
B.1 Introduction
B.2 Using the Event Dictionary
B.3 Event Dictionary
Exception and ISR
Memory Library
Message Queue
Semaphore
Signal
Task
Tick
Unknown
User Event
Watchdog Timer
C Library and Subroutine Reference
D Event-Base API
D.1 Introduction
D.2 C++ API
WVEventBase Class
WVContext Class
WVEvent Class
WVCoords Class
Supported Compilers
Runtime Errors
D.3 Tcl API
Event-Base Commands
Alternative Output Formats
Coordinates Commands
Typical (Simplified) Tcl Session
Event Definition File Format
D.4 Example
E Triggering API
E.1 Overview
E.2 Trigger Structure
E.3 Triggering API
Adding a Trigger to the Trigger List
Deleting a Trigger from the Trigger List
Activating Triggering
Deactivating Triggering
Showing Information on Triggers
Changing Trigger Status
Creating a User Event to Fire a Trigger
F Customizing WindView and User Applications
F.1 Introduction
F.2 Customizing WindView Tcl Initialization Files
F.3 Customizing the Show Event Dialog Box for User Events
F.4 Creating Icons for User-Defined Events
F.5 Updating Non-WRS Code to WindView 2.0
G Creating a VxWorks Timestamp Driver
G.1 Introduction
G.2 Hardware Overview
Modes of Operation
Characteristics of Hardware Timers
VxWorks Requirements for Timestamp Timers
G.3 Timestamp Driver Interface
Path Name Conventions
sysTimestampConnect( )
sysTimestampEnable( )
sysTimestampDisable( )
sysTimestampPeriod( )
sysTimestampFreq( )
sysTimestamp( )
sysTimestampLock( )
G.4 Writing the Driver
Timers That Can Be Read While Enabled
Working Around Deficiencies in Hardware Timers
Using the VxWorks System Clock Timer
G.5 Using the Timestamp Driver with WindView
Attaching the Timestamp Driver to VxWorks
Using the System Clock
G.6 Examples
H Glossary
Index