Index
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
A
ACTION_IS_SET
139
additional instrumentation logging (AIL level) 28,
183
see also
instrumenting
default setting 29
additional instrumentation logging (AIL) level
working with 81-
88
AIL level,
see
additional instrumentation logging
Analysis
dialog box
using 31
analysis packs 58-
59,
183
Excel, viewing in 59
exporting data 60
memory usage 31
view graphs, viewing in 58
Analysis Packs
dialog box
60
working with 58-
59
API,
see
C++ API; Tcl API; triggers
application code
183
architecture (WindView) 115-
121
communication facilities 120-
121
host-side facilities 116
target-side facilities 117-
120
WDB protocol 120
auxiliary clock
183
timestamp driver, impact of 18
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
B
Base Events
drop-down combo box
26
binary semaphores
184
blocked tasks,
see
pended state
board support packages (BSP)
184
building for use with WindView 17-
20
third-party compatibility, ensuring 152
boot ROM, VxWorks
rebuilding 20
post-mortem mode, for 104
breakpoints
184
BSPs,
see
board support packages
buffers,
see
ring buffers
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
C
C++ API 123-
131
error code definitions 131
runtime errors, reporting 131
WVContext
class
125
WVCoords
class
128
WVEvent
class
126
WVEventBase
class
124
chained trigger
184
Choose Destination Location
dialog box
17
collecting data,
see
event logging
Collection Configuration
dialog box
default settings 9
working with 25-
34
configuring
target server for TSFS 20-
23
VxWorks support for WindView 17-
20
instrumentation 18
rebuilding system image 20
timestamp driver 18
TSFS 19
upload paths, defining 18
WindView
collecting data 25-
34
ring buffers, dynamic 36-
38
upload mode 42-
47
upload path 38-
42
upload task (
tWVUpload
)
104
configuring WindView
see also
default configuration
Context Attributes
dialog box
185
working with 61
Context State Information
window
52,
185
Context State Summary
window
53,
185
context states,
see
task states
context switch logging (CSE level) 27,
185
context switches 13,
185
current context 27
contexts,
see
context switches; current context; task context
continuous upload mode 100,
186
configuring for 43
ring buffers, dynamic
full, effect when 38
working with 96
threshold 43,
101
tWvRBuffMgr
task priority, setting
97
Control Properties
dialog box
default settings 10
Control
window
186
data collection
starting 34
stopping 34
counting semaphores
186
CPU starvation
187
CPU Usage
analysis pack
59
cross-development
187
CSE level,
see
context switch logging
CUpload Configuration
dialog box
Reset
button
10
current context 27,
187
customizing WindView 147-
153
see also
Tcl
initialization files, modifying 147
user-defined events, working with 148-
153
user-developed code compatible, making 152
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
D
data collecting,
see
event logging
data, displaying
event information, viewing 54-
57
data, exporting
UNIX 60
dead state
187
deadlock
187
default configuration 8-
11
resetting to 10
defaultUser
event
see also
eventpoints
e
( )
, using
88
wvEvent
( )
, using
89
deferred upload mode 100,
188
configuring for 42
ring buffers, dynamic
full, effect when 38
working with 96
delayed state
188
deletion safety
188
displaying data 49-
63
see also
view graphs
analog data, viewing 58-
60
context states 52
contexts 56
event types 56
event, summary of 56
hiding 60-
63
interrupt transitions 63
state stipples 62
tasks 60
transition lines 63
user-defined event IDs 63
log files, saving 12
refreshing 51
status bar, view graph 54
tasks, specifying displayed 52
time intervals 16
controlling 50
WindView Control
window, from the
12
distributing applications 23
documentation 4-
6
online help 5
downloading
188
dynamic ring buffers,
see
ring buffers
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
E
.e
files
115
e
( )
88
embedded systems
188
event buffers
189
event data
189
event data collection
189
see also
event logging
Event Data Receiver
dialog box
110
Event Dictionary
189
online version, accessing the 56
event icons (WindView)
189
defining 56
designing user-defined 152
event log
189
event logging 81-
98,
190
application routines 88-
91
log files, saving 111
logging levels, specifying 25-
29
memory usage 87
multiple files, saving to 109
multiple sources, from 109
multiprocessor support 91
post-mortem mode 44-
47
ring buffers, using dynamic 95-
98
sequence stamping 93
starting 33
stopping 33
TCP/IP sockets, using 109
timestamping 92-
94
triggering 73-
74
uploading data, effect on 43
Event Matches
drop-down menu
66
event pop-up menu 51,
190
context state data, displaying 52
Event Dictionary, accessing online 52
Help
command
52
Legend
command
52
time intervals, specifying 51
event port number 111,
190
event upload mode
190
eventpoints 88-
91,
190
e
( )
, setting with
88
wvEvent
( )
, setting with
89-
91
events
188
basic information 13-
17
displaying information about 54-
57
generic 89
triggering 65-
80
evtRecv
tool
108-
113,
191
event port number 111
log files, handling 111
multiple files, saving to 109
multiple sources, from 109
starting 109
TCP/IP sockets, using 109
UNIX, running on 109
Windows, running on 110
exception
event
191
executing state
191
execution thread
204
exporting data,
see
data, exporting
Expose
submenu
52
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
F
file descriptor (
fd
)
191
files
upload paths, defining
Filter Events/States
dialog box
191
opening 62
working with 62-
63
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
G
GUI (graphical user interface)
192
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
H
Help
command (event pop-up menu)
52
Hide Nonexecuting States
button
62
host
192
communication with target 120
requirements 3
WindView facilities on 116
host event buffer
192
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
I
I/O system
194
idle loop
192
INCLUDE_TIMESTAMP
18
INCLUDE_TRIGGERING
20
INCLUDE_USER_TIMESTAMP
167
INCLUDE_WDB
19
TSFS, for 39
INCLUDE_WDB_TSFS
19
INCLUDE_WINDVIEW
18
removing 23
INCLUDE_WVUPLOAD_ALL
19
INCLUDE_WVUPLOAD_FILE
19
INCLUDE_WVUPLOAD_SOCK
19
INCLUDE_WVUPLOAD_TSFSSOCK
19
inherited state
192
initialization sequence 18
installing WindView 17-
20
INSTRUMENT_ON
86
instrumented code
192
instrumenting
ACTION_IS_SET
, using
139
libraries
basic information 30
default setting, AIL 29
objects 30-
33,
192
memory 30-
32
triggering, interplay with 139-
141
timestamp driver for, configuring 167
instrumenting libraries
kernel 82-
86
memLib
library
87
netLib
library
87
overview 81
instrumenting objects
all, specifying programmatically 86
from creation time 85
individuals and groups, specifying 82
networking events 32-
33
instrumenting routines 82-
86
instrumenting signals programmatically 83
integrated WindView (simulator) 3
interrupt handler,
see
interrupt service routines (ISR)
interrupt latency
193
interrupt levels
193
interrupt lock
193
interrupt service routines (ISR)
193
interrupts
193
transitions, hiding 63
intertask communication facilities
194
intrusion
194
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
K
kernel libraries
instrumenting 82-
86
AIL default setting 29
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
L
launching WindView 8
Legend
command (event pop-up menu)
52
Legend
window
56,
194
Event Dictionary, accessing online 57
libraries
see individual libraries
; kernel libraries
locked state
194
log files
saving 12
updating 11
viewing 11
logging levels
195
additional instrumentation logging (AIL) 28
context switch logging (CSE) 27
specifying 25-
29
task state transition logging (TST) 28
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
M
main window
195
memLib
instrumenting 30-
32
memLib
library
logging information 86
routines associated with events 87
memory
post-mortem mode, reserving for 103
preserved 101,
198
target requirements 3
memory usage
displaying 31
event logging 87
ring buffers, impact on dynamic 98
Memory Usage
analysis pack
58
message logging
195
message queues
195
instrumenting 82
msgQLib
library
instrumenting specific objects 83
multitasking
196
mutual exclusion
196
mutual exclusion semaphores
196
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
N
netLib
library
about 30
instrumenting 32
Network File System (NFS)
uploading data 108
network task (
tNetTask
)
108
networking library 32
NFS,
see
Network File System
nonexecuting states,
see
state stipples
nonexistent state
196
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
O
online help 5
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
P
-p
flag
109
page (view graph)
197
pended state
197
pipes
197
post-mortem mode 101-
104,
197
boot ROMs for, rebuilding 104
configuring for 44-
47
memory for, reserving 103
ring buffers, dynamic
configuring 102-
103
effect on 97
full, effect when 38
preemption
197
preemption lock,
see
locked state
preemptive priority scheduling
198
preserved memory 101,
198
priority inheritance
198
priority inversion
198
priority levels
198
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
R
race condition
198
rBuff
199
see also
ring buffers
configuring
199
rBuff management task (
tWvRBuffMgr
)
97
rBuffLib
95-
98
ready state
199
real-time systems
199
resource
199
resume
199
ring buffers, dynamic 95-
98,
188
configuring 36-
38
default setting 10
full, effect when 38
number of, specifying 37
size, specifying 38
target memory limitations, handling 98
tWvRBuffMgr
task priority, setting
97
upload threshold, reaching the 101
round-robin scheduling
199
routines, instrumenting,
see
instrumenting routines
running state,
see
executing state
running WindView 8-
12
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
S
scheduling,
see
preemptive scheduling; round-robin scheduling
Select log path
dialog box
112
semaphores
200
instrumenting 82
semLib
library
instrumenting specific objects 83
sequence-stamp driver 93
sequential event display
200
Setup
dialog box (
evtRecv
)
111-
113
SETUP
program
17
Show Event
dialog box
200
customizing for user-defined events 148-
151
opening 55,
90
working with 55
show
( )
200
signal handler
201
signals
200
sockets
201
upload paths, defining 19
uploading data 107
starting WindView 11-
12
state stipples
201
defining 56
hiding 62
states,
see
task states
stopping WindView 12
sub-time intervals
201
suspended state
201
system clock
202
timestamp driver, impact of 18
system code
202
system requirements (WindView) 3
sysTimestamp
( )
162
sysTimestampConnect
( )
160
sysTimestampDisable
( )
161
sysTimestampEnable
( )
161
sysTimestampFreq
( )
162
sysTimestampLock
( )
163
sysTimestampPeriod
( )
162
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
T
target
202
communication with host 120
requirements 3
triggering, preparing for 72
WindView facilities on 117-
120
target routines, instrumenting objects 82
target server
configuring for TSFS 20-
23
launching 23
uploading data, configuring for 39
Target Server File System (TSFS)
202
configuring 19
target server for, configuring 20-
23
upload paths, defining 19
uploading data 106-
107
configuring for 39
WDB, configuring 39
task context
203
task levels
203
task pop-up menu 52,
203
context state data, summarizing 53
hiding data 60
task preemption
203
task state transition
203
task state transition logging (TST level) 28,
204
task states
203
dead
187
delayed
188
executing
191
inherited 192
locked
194
nonexistent 196
pended
197
ready
199
suspended
201
unknown
206
taskInit
( )
90
taskLib
library
instrumenting specific objects 83
tasks
202
see also
task states
deadlock
187
instrumenting 82
network (
tNetTask
)
108
preemption
197
priority levels
198
rBuff (
tWvRBuffMgr
)
97
resources
199
resuming
199
unblocked
206
unbreakable 90
upload (
tWVUpload
)
101,
207
configuring 104
event port number 111
taskSpawn
( )
90
Tcl (Tool command language)
204
displaying data 148-
151
documentation 6
initialization files, customizing 147
Show Event
dialog box, customizing
148-
151
user-defined events, working with 148-
151
wvUserEventFormat
Tcl array
148-
151
Tcl API 131-
137
commands, event-base 132
coordinates objects, creating 133-
134
event base, loading the 131
event record output, reformatting 133
file format 136
TCP/IP
uploading data 107
thread of execution
204
tick events
204
time intervals 16,
205
controlling 50
specifying
event pop-up menu 51
tool bar 50
time slice
205
timeout
205
timers
see also
timestamping
characteristics 158-
159
modes of operation 156-
157
timestamp
drivers, writing
code examples 168-
182
timestamping
205
clocks, effect on hardware 18
configuring for 18
drivers 155-
182
code examples
read while enabled 168-
172
using system clock 178-
182
working around deficiencies 172-
178
interface 160-
163
VxWorks requirements 159
WindView, using with 167
writing
read while enabled 163
using system clock 166
working around deficiencies 164-
166
high resolution 92
sequence-stamp driver 93
tNetTask
network task
108
tool bar (WindView)
time intervals, displaying 50
zooming in/out 50
time intervals, specifying 50
Tool command language,
see
Tcl (Tool command language)
transition lines, hiding 63
TRG_DISABLE
143
TRG_ENABLE
143
trgEvent
( )
66
example 78
Trigger Maintenance
dialog box
206
working with 66
TRIGGER_COND_FUNC
143
TRIGGER_COND_LIB
143
TRIGGER_COND_VAR
143
Triggering
window
206
working with 65
triggers 65-
80,
205
ACTION_IS_SET
, using
139
API 144-
146
activating triggers 145
adding triggers 144
changing status 146
deactivating 145
deleting triggers 144
displaying information 145
user events, creating trigger-related 146
chaining 72
conditions for, specifying 66-
70
routines 68-
70
variables 67
configuration files, loading trigger 71
configuring for 20
counting, for 80
creating 65
enabling triggering 72
event logging, starting and stopping 73-
74
examples
chaining 76
conditions, evaluating 76-
78
downloading definitions 74-
76
logging, starting and stopping 78
triggered actions, specifying 79
instrumenting, interplay with 139-
141
launching triggering 65
"no action," specifying 80
stopping triggering 72
structure, defining 141-
143
triggered actions, specifying 70
user-defined routines, calling 79
troubleshooting
post-mortem mode 101-
104
WindView for, using 2
TSFS,
see
Target Server File System
TST level,
see
task state transition logging
tWvRBuffMgr
rBuff task
priority, setting 97
tWVUpload
upload task
207
configuring 104
event port number 111
threshold, reaching the 101
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
U
unblocked tasks
206
UNIX environment 8
evtRecv
tool, running the
109
unknown state
206
Upload Configuration
dialog box
buffer addresses, setting 102
working with 35-
47
upload mode 100-
104,
206
see also individual modes
configuring 42-
47
default setting 11
ring buffers, effect on dynamic 96-
97
upload path 105-
108,
207
configuring 38-
42
default setting 11
defining 18
network facilities, using 39
file via NFS, to a 108
socket via TCP/IP, through a 107
TSFS, using
configuring for 39
file, to a 106
socket, through a 107
view graph, direct to a 106
Upload Path
drop-down combo box
40-
42
upload task (
tWVUpload
)
207
configuring 104
event port number 111
threshold, reaching the 101
uploading data 99-
113,
206
see also
ring buffers; upload mode; upload path
configuring for 35-
47
defining a path 18
destinations, choosing 40-
42,
206
event logging, effect on 43
evtRecv
tool, using the
108-
113
mode, configuring 42-
47
path, configuring a 38-
40
ring buffers, configuring dynamic 36-
38
view graphs, displaying in 12
WindView Control
window, from the
12
user interface,
see
GUI (graphical user interface)
USER_RESERVED_MEM
103
user-defined events
207
triggering, for 146
WindView
event icons, designing 152,
207
hiding IDs from display 63
searching for 56
Show Event
dialog box for, customizing
148-
151
usrConfig.c
customizing, impact of 18
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
V
view graphs 49-
63,
207
see also
displaying data; WindView tool bar
analog data, viewing 58-
60
anatomy of 16-
17
basic information 14-
17
context state data
displaying 52
summarizing 53
event data, summarizing 56
event icons, defining 56
event information, viewing 54-
57
event pop-up menu, using the 51
hiding data
interrupt transitions 63
state stipples 62
tasks 60
transition lines 63
user-defined event IDs 63
memory usage analog graph, displaying 31
opening new 12
refreshing 51
sequenced events, displaying 93
state stipples, defining 56
status bar, reading the 54
task pop-up menu, using the 52
tasks to display, specifying 52
time intervals 16
controlling 50
timestamped events, displaying 92
uploading data 12
VX_UNBREAKABLE
90
VxWorks
building for use with WindView 17-
20
post-mortem mode, reserving memory for 103
system image, rebuilding 20
post-mortem mode, for 104
timestamp drivers 155-
182
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
W
watchdog timers
208
instrumenting 82
WDB protocol 120
wdLib
library
instrumenting specific objects 83
Windows environment 8
evtRecv
tool, running the
110
WindView Control
window
using 11-
12
WVContext
class
125
WVCoords
class
128
wvCoordsCreate
command (Tcl)
133-
134
WVEvent
class
126
wvEvent
( )
89-
91
WVEventBase
class
124
wvEventBaseLoad
command (Tcl)
131
wvLib
34
wvNetLib
34
wvObjInst
( )
82
wvObjInstModeSet
( )
85
wvOff( )
34
wvOn( )
34
wvRBuffMgrPrioritySet
( )
97
wvUploadTaskConfig
( )
104
wvUserEventFormat
Tcl array
defining 148-
151
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
R
S
T
U
V
W
Z
Z
zooming
event pop-up menu, using the 51
tool bar, using the 50