forked from RedhawkSDR/Documentation
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathmainch22.html
826 lines (776 loc) · 41.3 KB
/
mainch22.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html >
<head><title>22 Exploring a Running Domain Using the REDHAWK IDE</title>
<meta http-equiv="Content-Type" content="text/html; charset="utf-8"">
<meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)">
<meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)">
<!-- html,2,next,javascript,charset="utf-8" -->
<meta name="src" content="main.tex">
<meta name="date" content="2013-03-12 19:46:00">
<link rel="stylesheet" type="text/css" href="main.css">
<script type="text/javascript" src="scripts/shCore.js"></script>
<script type="text/javascript" src="scripts/shBrushCpp.js"></script>
<script type="text/javascript" src="scripts/shBrushJava.js"></script>
<script type="text/javascript" src="scripts/shBrushPython.js"></script>
<script type="text/javascript" src="scripts/shBrushBash.js"></script>
<script type="text/javascript" src="scripts/shBrushXml.js"></script>
<link href="styles/shCore.css" rel="stylesheet" type="text/css" />
<link href="styles/shThemeDefault.css" rel="stylesheet" type="text/css" />
<script type="text/javascript">
SyntaxHighlighter.all()
</script>
</head><body
>
<script>
function f() {
document.getElementById('main_content_wrap').focus();
}
if (window.addEventListener) {
window.addEventListener("load", f, false);
} else if (window.attachEvent) {
window.attachEvent("onload", f);
}
</script>
<div class="header">
<ul class="navbar">
<li><a class="logo-small" href="index.html"><img src="images/RedHawk_Logo_ALT_B_121px.png"/></a></li> <li><a href="index.html">Home</a></li>
<li><a href="gettingstarted/main.html">Getting Started</a></li>
<li><a class="active" href="main.html">Documentation</a></li>
<li><a href="download.html">Download</a></li>
<li><a href="support.html">Support</a></li>
</ul>
<div class="pattern right"></div>
<a id="forkme_banner" href="https://github.com/redhawksdr">View on GitHub</a>
</div>
<!-- Custom MAIN CONTENT -->
<div id="main_content_wrap" tabindex="0" class="outer">
<section id="main_content" class="inner">
<!--l. 1--><div class="crosslinks"><p class="noindent">[<a
href="mainch23.html" >next</a>] [<a
href="mainch21.html" >prev</a>] [<a
href="mainch21.html#tailmainch21.html" >prev-tail</a>] [<a
href="#tailmainch22.html">tail</a>] [<a
href="main.html#mainch22.html" >up</a>] </p></div>
<h2 class="chapterHead"><span class="titlemark">Chapter 22</span><br /><a
id="x24-30500022"></a>Exploring a Running Domain Using the REDHAWK IDE</h2>
<!--l. 3--><p class="noindent" >The <a
href="mainli2.html#glo:domainmanager">Domain Manager</a>, as described in <a
href="mainch11.html#x13-15700011.2">Section 11.2</a>, contains knowledge of all existing
<a
href="mainap3.html#corba">CORBA</a>-enabled objects installed or loaded onto the system. This includes references to all file
systems (through the <a
href="mainli2.html#glo:filemanager">File Manager</a>), <a
href="mainli2.html#glo:devicemanager">Device Managers</a>, and all <a
href="mainli2.html#glo:application">Applications</a> (and their Resources).
The <a
href="mainli2.html#glo:domainmanager">Domain Manager</a> is seen as the central bookkeeper. The REDHAWK <a
href="mainap3.html#ide">IDE</a> can be used to run
or connect to a running <a
href="mainli2.html#glo:domain">Domain</a>, view the contents of a running <a
href="mainli2.html#glo:domain">Domain</a>, and launch and interact
with <a
href="mainli2.html#glo:application">Applications</a> within the <a
href="mainli2.html#glo:domain">Domain</a>.
<h3 class="sectionHead"><span class="titlemark">22.1 </span> <a
id="x24-30600022.1"></a>Connecting to a Domain</h3>
<!--l. 15--><p class="noindent" >The <a
href="mainap3.html#ide">IDE</a> provides the options of either launching a <a
href="mainli2.html#glo:domain">Domain</a> through the <a
href="mainap3.html#ide">IDE</a> interface or
connecting to a <a
href="mainli2.html#glo:domain">Domain</a> that has been launched outside of the <a
href="mainap3.html#ide">IDE</a>.
<!--l. 18--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">22.1.1 </span> <a
id="x24-30700022.1.1"></a>Launching and Connecting Using the IDE</h4>
<!--l. 20--><p class="noindent" >To launch and connect to a <a
href="mainli2.html#glo:domain">Domain</a> using the <a
href="mainap3.html#ide">IDE</a>:
<!--l. 22--><p class="noindent" >
<ol class="enumerate1" >
<li
class="enumerate" id="x24-307002x1">Right click the <span
class="cmbx-12">Target </span><a
href="mainap3.html#sdr"><span
class="cmbx-12">SDR</span></a> from the <a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a> <span
class="cmbx-12">Explorer </span>view and select <span
class="cmbx-12">Launch</span><span
class="cmbx-12">…</span>
<!--l. 26--><p class="noindent" ><hr class="figure"><div class="figure"
><table class="figure"><tr class="figure"><td class="figure"
><a
id="x24-307003r1"></a> <img
src="images/REDHAWK_Launch_domain.png" alt="PIC"
>
<br /> <table class="caption"
><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 22.1: </td><td
class="content">Right-clicking the target <a
href="mainap3.html#sdr">SDR</a> will bring up a menu allowing the <a
href="mainli2.html#glo:domain">Domain</a> to
be launched</td></tr></table><!--tex4ht:label?: x24-307003r1 -->
<!--l. 30--><p class="noindent" ></td></tr></table></div><hr class="endfigure">
</li>
<li
class="enumerate" id="x24-307005x2">Choose a name for the <a
href="mainli2.html#glo:domainmanager">Domain Manager</a>
</li>
<li
class="enumerate" id="x24-307007x3">Select a <a
href="mainli2.html#glo:devicemanager">Device Manager</a> to start. While this step is optional, a running <a
href="mainli2.html#glo:devicemanager">Device Manager</a> is
required to launch <a
href="mainli2.html#glo:application">Applications</a>.
<!--l. 36--><p class="noindent" ><div class="admonition block tip block-indent"><div class="tip-inner"><p class="para block block-first"> Optionally, the debug level may be set. By default it is set to <span
class="cmbx-12">info </span>which will display any
messages at the info level or higher which includes: info, warning, error, and fatal message
levels. If this is the first time using REDHAWK, changing the level from <span
class="cmbx-12">Info </span>to <span
class="cmbx-12">Debug </span>for
both the <a
href="mainli2.html#glo:domain">Domain</a> and <a
href="mainli2.html#glo:devicemanager">Device Manager</a> may be helpful in the learning process. </p></div></div>
</li>
<li
class="enumerate" id="x24-307009x4">Finally, click <span
class="cmbx-12">OK </span>to launch and connect to the new <a
href="mainli2.html#glo:domain">Domain</a>.
</li>
<li
class="enumerate" id="x24-307011x5">Notice that the <a
href="mainap3.html#ide">IDE</a> reacts to the newly launched <a
href="mainli2.html#glo:domain">Domain</a>:
<ol class="enumerate2" >
<li
class="enumerate" id="x24-307013x1">The new <a
href="mainli2.html#glo:domain">Domain</a> has been added to the <a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a> <span
class="cmbx-12">Explorer </span>view
</li>
<li
class="enumerate" id="x24-307015x2">The new <a
href="mainli2.html#glo:domain">Domain</a>, within a short amount of time, should have connected and will
indicate this to the right of the <a
href="mainli2.html#glo:domain">Domain</a> name within the <a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a> <span
class="cmbx-12">Explorer </span>view.
</li>
<li
class="enumerate" id="x24-307017x3">At least one new <span
class="cmbx-12">Console </span>view (within the <a
href="mainap3.html#ide">IDE</a>) have been created. One contains
a nodeBooter instance for the <a
href="mainli2.html#glo:domainmanager">Domain Manager</a> that launched and one nodeBooter
instance for each <a
href="mainli2.html#glo:devicemanager">Device Manager</a>.</li></ol>
</li></ol>
<!--l. 67--><p class="noindent" ><hr class="figure"><div class="figure"
><table class="figure"><tr class="figure"><td class="figure"
>
<a
id="x24-307018r2"></a>
<!--l. 69--><p class="noindent" ><img
src="images/REDHAWK_Domain_Console.png" alt="PIC"
>
<br /> <table class="caption"
><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 22.2: </td><td
class="content">Console showing the <a
href="mainli2.html#glo:domainmanager">Domain Manager</a> start up with debug logging and the
available <a
href="mainli2.html#glo:devicemanager">Device Manager</a> console</td></tr></table><!--tex4ht:label?: x24-307018r2 -->
<!--l. 71--><p class="noindent" ></td></tr></table></div><hr class="endfigure">
<h4 class="subsectionHead"><span class="titlemark">22.1.2 </span> <a
id="x24-30800022.1.2"></a>Connecting to a Running Domain</h4>
<!--l. 79--><p class="noindent" >How a <a
href="mainli2.html#glo:domain">Domain</a> and a <a
href="mainli2.html#glo:devicemanager">Device Manager</a> can be launched from the command line is shown in <a
href="mainch11.html#x13-15800011.2.1">Section
11.2.1</a>.
<!--l. 82--><p class="noindent" >To connect to this <a
href="mainli2.html#glo:domain">Domain</a> through the <a
href="mainap3.html#ide">IDE</a>:
<ol class="enumerate1" >
<li
class="enumerate" id="x24-308002x1">Click the <span
class="cmbx-12">New </span><a
href="mainli2.html#glo:domain"><span
class="cmbx-12">Domain</span></a> <span
class="cmbx-12">Connection </span>button (i.e. the plus symbol) in the upper right
of the <a
href="mainli2.html#glo:SCA Explorer View"><a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a> <span
class="cmbx-12">Explorer View</span></a>.
</li>
<li
class="enumerate" id="x24-308004x2">Provide the <a
href="mainli2.html#glo:domain">Domain</a> name and the running <a
href="mainli2.html#glo:namingservice">Naming Service</a>’s location. If unsure of the
<a
href="mainli2.html#glo:namingservice">Naming Service</a> location, use the default.
</li>
<li
class="enumerate" id="x24-308006x3">Click one of the options to:
<ul class="itemize1">
<li class="itemize"><span
class="cmbx-12">Don’t connect</span>: This will add the <a
href="mainli2.html#glo:domain">Domain</a> to the <a
href="mainli2.html#glo:SCA Explorer View"><a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a> <span
class="cmbx-12">Explorer View</span></a> but
will leave the <a
href="mainli2.html#glo:domain">Domain</a> in the disconnected state. When the <a
href="mainap3.html#ide">IDE</a> is restarted, the
<a
href="mainli2.html#glo:domain">Domain</a> will remain in the <a
href="mainap3.html#sca">SCA</a> Explorer and will be in the disconnected state.
After adding a disconnected <a
href="mainli2.html#glo:domain">Domain</a> to the <a
href="mainap3.html#sca">SCA</a> Explorer view the <a
href="mainli2.html#glo:domain">Domain</a> may
be connected by right clicking on the <a
href="mainli2.html#glo:domain">Domain</a> and selecting <span
class="cmbx-12">Connect</span>.
</li>
<li class="itemize"><span
class="cmbx-12">Connect Once</span>: This will add the <a
href="mainli2.html#glo:domain">Domain</a> to the <a
href="mainli2.html#glo:SCA Explorer View"><a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a> <span
class="cmbx-12">Explorer View</span></a> and will
connect the <a
href="mainap3.html#ide">IDE</a> with the <a
href="mainli2.html#glo:domain">Domain</a>. When the REDHAWK <a
href="mainap3.html#ide">IDE</a> is restarted, the
<a
href="mainli2.html#glo:domain">Domain</a> will remain in the <a
href="mainap3.html#sca">SCA</a> Explorer but will be in the disconnected state.
</li>
<li class="itemize"><span
class="cmbx-12">Always Connect</span>: This will add the <a
href="mainli2.html#glo:domain">Domain</a> to the <a
href="mainli2.html#glo:SCA Explorer View"><a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a> <span
class="cmbx-12">Explorer View</span></a> and
will connect with <a
href="mainap3.html#ide">IDE</a> with the <a
href="mainli2.html#glo:domain">Domain</a>. When the REDHAWK <a
href="mainap3.html#ide">IDE</a> is restarted,
the <a
href="mainli2.html#glo:domain">Domain</a> will remain in the <a
href="mainap3.html#sca">SCA</a> Explorer and will attempt to connect with
this <a
href="mainli2.html#glo:domain">Domain</a>.</li></ul>
<!--l. 106--><p class="noindent" ><hr class="figure"><div class="figure"
><table class="figure"><tr class="figure"><td class="figure"
><a
id="x24-308007r3"></a> <img
src="images/REDHAWK_New_Domain_Wizard.png" alt="PIC"
>
<br /> <table class="caption"
><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 22.3: </td><td
class="content">New <a
href="mainli2.html#glo:domainmanager">Domain Manager</a> dialog set to connect once</td></tr></table><!--tex4ht:label?: x24-308007r3 -->
<!--l. 110--><p class="noindent" ></td></tr></table></div><hr class="endfigure">
</li>
<li
class="enumerate" id="x24-308009x4">Select <span
class="cmbx-12">Finish </span>to close the wizard.
</li>
<li
class="enumerate" id="x24-308011x5">The <a
href="mainli2.html#glo:domain">Domain</a> should now appear in the <a
href="mainli2.html#glo:SCA Explorer View"><a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a> <span
class="cmbx-12">Explorer View</span></a>. If <span
class="cmbx-12">Connect Once </span>or <span
class="cmbx-12">Always</span>
<span
class="cmbx-12">Connect </span>was chosen, the <a
href="mainli2.html#glo:domain">Domain</a> should have connected. If <span
class="cmbx-12">Don’t Connect </span>was selected,
right click on the <a
href="mainli2.html#glo:domain">Domain</a> and select <span
class="cmbx-12">Connect</span>.
<!--l. 118--><p class="noindent" ><div class="admonition block tip block-indent"><div class="tip-inner"><p class="para block block-first"> Many of these options may be changed later through the <a
href="mainli2.html#glo:Properties View"><span
class="cmbx-12">Properties View</span></a>.
</p></div></div>
</li></ol>
<!--l. 123--><p class="noindent" >
<h3 class="sectionHead"><span class="titlemark">22.2 </span> <a
id="x24-30900022.2"></a>Viewing the Contents of the Domain in the SCA Explorer View</h3>
<!--l. 124--><p class="noindent" >Once the <a
href="mainli2.html#glo:domain">Domain</a> has been connected, a user may look at the file system visible to the <a
href="mainli2.html#glo:domainmanager">Domain
Manager</a> and its attached <a
href="mainli2.html#glo:devicemanager">Device Managers</a>. If the <a
href="mainli2.html#glo:Properties View"><span
class="cmbx-12">Properties View</span></a> is open, note that clicking
through the items within the <a
href="mainli2.html#glo:domainmanager">Domain Manager</a> shows detailed information about each
item.
<!--l. 129--><p class="noindent" >The <a
href="mainli2.html#glo:domainmanager">Domain Manager</a>’s root contains three folders:
<ul class="itemize1">
<li class="itemize"><a
href="mainli2.html#glo:devicemanager"><span
class="cmbx-12">Device Managers</span></a>: Shows the currently connected <a
href="mainli2.html#glo:devicemanager">Device Managers</a>. More than one
<a
href="mainli2.html#glo:devicemanager">Device Manager</a> may be connected to the <a
href="mainli2.html#glo:domain">Domain</a>. Each <a
href="mainli2.html#glo:devicemanager">Device Manager</a> entry consists
of a single <a
href="mainli2.html#glo:node">Node</a> and where each <a
href="mainli2.html#glo:node">Node</a> may contain multiple <a
href="mainli2.html#glo:device">Devices</a>. Right-click on
<a
href="mainli2.html#glo:device">Devices</a> to monitor <a
href="mainli2.html#glo:port">Port</a> information, plot <a
href="mainli2.html#glo:port">Port</a> output and play audio.
</li>
<li class="itemize"><a
href="mainli2.html#glo:waveform"><span
class="cmbx-12">SCA Waveforms</span></a>: This folder contains the running <a
href="mainli2.html#glo:application">Applications</a> on the <a
href="mainli2.html#glo:domain">Domain</a>. As
<a
href="mainli2.html#glo:application">Applications</a> are launched, they appear here and can be expanded to show each of the
running <a
href="mainli2.html#glo:component">Components</a> within the <a
href="mainli2.html#glo:application">Application</a>. These <a
href="mainli2.html#glo:component">Components</a> can be expanded to
show the <a
href="mainli2.html#glo:device">Device</a> they are executing on and <a
href="mainli2.html#glo:port">Port</a> information.
</li>
<li class="itemize"><a
href="mainli2.html#glo:filemanager"><span
class="cmbx-12">File Manager</span></a>: The <a
href="mainli2.html#glo:filemanager">File Manager</a> shows all the file systems in the <a
href="mainli2.html#glo:domain">Domain</a>’s view.
It contains references to all <a
href="mainli2.html#glo:component">Components</a>, <a
href="mainli2.html#glo:device">Devices</a>, <a
href="mainli2.html#glo:waveformapplication">Waveforms</a>, and the <a
href="mainli2.html#glo:device">Device</a> and
<a
href="mainli2.html#glo:domainmanager">Domain Managers</a> configuration and executable files.</li></ul>
<!--l. 146--><p class="noindent" ><hr class="figure"><div class="figure"
><table class="figure"><tr class="figure"><td class="figure"
>
<a
id="x24-309001r4"></a>
<!--l. 148--><p class="noindent" ><img
src="images/REDHAWK_Domain_File_System_1.png" alt="PIC"
>
<br /> <table class="caption"
><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 22.4: </td><td
class="content">Example <a
href="mainli2.html#glo:domain">Domain</a> file system</td></tr></table><!--tex4ht:label?: x24-309001r4 -->
<!--l. 150--><p class="noindent" ></td></tr></table></div><hr class="endfigure">
<h3 class="sectionHead"><span class="titlemark">22.3 </span> <a
id="x24-31000022.3"></a>Launching an Application</h3>
<!--l. 156--><p class="noindent" >In this section, it is assumed that a running <a
href="mainli2.html#glo:domainmanager">Domain Manager</a> and <a
href="mainli2.html#glo:devicemanager">Device Manager</a> exist and that
the <a
href="mainli2.html#glo:domainmanager">Domain Manager</a> contains a working <a
href="mainli2.html#glo:waveformapplication">Waveform</a>.
<!--l. 159--><p class="noindent" >To launch an <a
href="mainli2.html#glo:application">Application</a>:
<ol class="enumerate1" >
<li
class="enumerate" id="x24-310002x1">Right-click on the <a
href="mainli2.html#glo:domain">Domain</a> and select <span
class="cmbx-12">Launch Waveform</span><span
class="cmbx-12">…</span>.
</li>
<li
class="enumerate" id="x24-310004x2">In the <span
class="cmbx-12">Launch </span><a
href="mainli2.html#glo:waveform"><span
class="cmbx-12">SCA Waveform</span></a> <span
class="cmbx-12">Wizard </span>dialog, select the <a
href="mainli2.html#glo:waveformapplication">Waveform</a> to launch.
</li>
<li
class="enumerate" id="x24-310006x3">If there are no additional settings to specify, click <span
class="cmbx-12">Finish </span>to immediately launch the
<a
href="mainli2.html#glo:application">Application</a>. For completeness, we will step through the additional pages of the
dialog.
</li>
<li
class="enumerate" id="x24-310008x4">On the second page, the user has the chance to set the <a
href="mainli2.html#glo:property">Properties</a> of the <a
href="mainli2.html#glo:component">Components</a> within
the <a
href="mainli2.html#glo:application">Application</a>. Any <a
href="mainli2.html#glo:property">Property</a> modified here is specific to this <a
href="mainli2.html#glo:application">Application</a> and will not
impact the <a
href="mainli2.html#glo:component">Component</a>s execution in other environments. Notice that as the <a
href="mainli2.html#glo:property">Properties</a> are
changed from their default values the now non-default values appear in bold as shown in
<a
href="#x24-31000022.3">Figure 22.3</a>.
</li>
<li
class="enumerate" id="x24-310010x5">The third, and final page, allows the user to specify what executable <a
href="mainli2.html#glo:device">Device</a> each of the
<a
href="mainli2.html#glo:component">Components</a> will launch on. If left on <span
class="cmbx-12">Auto</span>, REDHAWK will determine the executable
device based on any allocation <a
href="mainli2.html#glo:property">Properties</a> and dependencies set on the <a
href="mainli2.html#glo:component">Components</a> and
<a
href="mainli2.html#glo:device">Devices</a>.
</li>
<li
class="enumerate" id="x24-310012x6">Click <span
class="cmbx-12">Finish </span>to launch the <a
href="mainli2.html#glo:application">Application</a>. <div class="admonition block tip block-indent"><div class="tip-inner"><p class="para block block-first"> Notice that the <a
href="mainli2.html#glo:domainmanager">Domain Manager</a> within the <a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a>
<span
class="cmbx-12">Explorer </span>view now shows the launched <a
href="mainli2.html#glo:application">Application</a> within the <a
href="mainli2.html#glo:waveform">SCA Waveforms</a> folder. </p></div></div>
</li>
<li
class="enumerate" id="x24-310014x7">Unless the user has specified to start the <a
href="mainli2.html#glo:application">Application</a> on launch in the Launch <a
href="mainli2.html#glo:waveform">SCA
Waveform</a> Wizard, the <a
href="mainli2.html#glo:application">Application</a> has not been started.
<!--l. 201--><p class="noindent" >There are multiple options for starting the <a
href="mainli2.html#glo:application">Application</a>.
<ul class="itemize1">
<li class="itemize">Click the <span
class="cmbx-12">Start </span><a
href="mainli2.html#glo:waveform"><span
class="cmbx-12">SCA Waveform</span></a> (i.e. the green arrow) button located above the
<a
href="mainap3.html#sad">SAD</a> Editor.
</li>
<li class="itemize">Right clicking the <a
href="mainli2.html#glo:waveformapplication">Waveform</a> from the <a
href="mainli2.html#glo:domain">Domain</a>’s <a
href="mainli2.html#glo:waveform">SCA Waveform</a> folder within the
<a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a> <span
class="cmbx-12">Explorer </span>view and selecting <span
class="cmbx-12">Start</span>.
</li>
<li class="itemize">Or right-clicking on the <a
href="mainli2.html#glo:component">Component</a> from within the <a
href="mainap3.html#sad">SAD</a> Editor and selecting
<span
class="cmbx-12">Start</span>.</li></ul>
</li>
<li
class="enumerate" id="x24-310016x8">Regardless of how the <a
href="mainli2.html#glo:application">Application</a> is started, the <a
href="mainli2.html#glo:component">Components</a> within the <a
href="mainli2.html#glo:application">Application</a> should
now have a green glow in the upper portion indicating that they are in the started
state.
</li>
<li
class="enumerate" id="x24-310018x9">The <a
href="mainap3.html#sca"><span
class="cmbx-12">SCA</span></a> <span
class="cmbx-12">Explorer </span>view should also indicate that the <a
href="mainli2.html#glo:application">Application</a> has started by displaying
“STARTED” next to this <a
href="mainli2.html#glo:application">Application</a>’s instance.
</li>
<li
class="enumerate" id="x24-310020x10">When finished, the <a
href="mainli2.html#glo:application">Application</a> may be stopped and released using any of the methods listed
to start the <a
href="mainli2.html#glo:application">Application</a> except this time selecting either <span
class="cmbx-12">Stop </span>then <span
class="cmbx-12">Release</span>. <div class="admonition block tip block-indent"><div class="tip-inner"><p class="para block block-first"> Note that it is
not necessary to select stop prior to releasing the <a
href="mainli2.html#glo:application">Application</a>. The <a
href="mainap3.html#ide">IDE</a> will try to stop the
<a
href="mainli2.html#glo:application">Application</a> before releasing. </p></div></div>
</li></ol>
<!--l. 225--><p class="noindent" ><hr class="figure"><div class="figure"
><table class="figure"><tr class="figure"><td class="figure"
>
<a
id="x24-310021r5"></a>
<!--l. 228--><p class="noindent" ><img
src="images/REDHAWK_Launch_Waveform_p2b.png" alt="PIC"
>
<br /> <table class="caption"
><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 22.5: </td><td
class="content"><a
href="mainli2.html#glo:application">Application</a> <a
href="mainli2.html#glo:property">Properties</a> turn bold when non-default values are set</td></tr></table><!--tex4ht:label?: x24-310021r5 -->
<!--l. 230--><p class="noindent" ></td></tr></table></div><hr class="endfigure">
<h3 class="sectionHead"><span class="titlemark">22.4 </span> <a
id="x24-31100022.4"></a>Plotting BulkIO Ports</h3>
<!--l. 233--><p class="noindent" >The REDHAWK <a
href="mainap3.html#ide">IDE</a> contains the ability to plot using the NeXtMidas plotting framework. If the
output <a
href="mainli2.html#glo:port">Port</a> uses the <a
href="mainap3.html#bulkio">BulkIO</a> interface, it can take advantage of this feature and plot a line graph
or a falling raster.
<!--l. 237--><p class="noindent" >To bring up a plot within the <a
href="mainap3.html#ide">IDE</a>:
<!--l. 239--><p class="noindent" >
<ol class="enumerate1" >
<li
class="enumerate" id="x24-311002x1">Make sure that the <a
href="mainli2.html#glo:component">Component</a> is currently in the started state.
</li>
<li
class="enumerate" id="x24-311004x2">Right click on the desired <a
href="mainli2.html#glo:port">Port</a> to plot, it should have two options regarding plotting:
<span
class="cmbx-12">Plot </span><a
href="mainli2.html#glo:port"><span
class="cmbx-12">Port</span></a> <span
class="cmbx-12">Data </span>and <span
class="cmbx-12">Plot </span><a
href="mainli2.html#glo:port"><span
class="cmbx-12">Port</span></a> <a
href="mainap3.html#fft"><span
class="cmbx-12">FFT</span></a>.
</li>
<li
class="enumerate" id="x24-311006x3">Select either <span
class="cmbx-12">Plot </span><a
href="mainli2.html#glo:port"><span
class="cmbx-12">Port</span></a> <span
class="cmbx-12">Data </span>or <span
class="cmbx-12">Plot </span><a
href="mainli2.html#glo:port"><span
class="cmbx-12">Port</span></a> <a
href="mainap3.html#fft"><span
class="cmbx-12">FFT</span></a>.
</li>
<li
class="enumerate" id="x24-311008x4">A new view is created which contains the plot of the <a
href="mainli2.html#glo:port">Ports</a> output data.
<!--l. 248--><p class="noindent" ><div class="admonition block tip block-indent"><div class="tip-inner"><p class="para block block-first"> Notice that this is a tabbed view. Each time a <a
href="mainli2.html#glo:port">Port</a> is plotted an additional tab will be
added to the lower left corner of this view. </p></div></div>
</li></ol>
<!--l. 255--><p class="noindent" >The NeXt Midas framework has an in plot menu system and mouse zoom functionality that may
be used within the plot window. The full use and features of the plotting menus are
beyond the scope of this guide and should be explained within the official NeXtMidas
documentation.
<!--l. 260--><p class="noindent" >Interact with the plot in the following ways:
<ul class="itemize1">
<li class="itemize">Zoom In: Left click and drag to form a box to zoom in on a portion of the plot
</li>
<li class="itemize">Zoom Out: Right-click to zoom out a single level
</li>
<li class="itemize">Open Menu: Center-click to bring up the NeXtMidas plot menu.
</li>
<li class="itemize">Close Menu: Right-click on an open menu to close the pop-up menu.
</li>
<li class="itemize">Switch to Line or Raster: In the upper right corner there is a <span
class="cmbx-12">Show Raster </span>toggle
button which will switch between the Line and Raster plot styles.</li></ul>
<!--l. 270--><p class="noindent" >In addition to the NeXt Midas plot menus, the plot view also contains a drop down menu to the
right of the <span
class="cmbx-12">Show Raster </span>toggle, shown in <a
href="#x24-31100022.4">Figure 22.4</a>.
<!--l. 274--><p class="noindent" >From the plot menu there are the following options:
<ul class="itemize1">
<li class="itemize"><span
class="cmbx-12">New Plot </span>view: Opens an identical plot view. Useful to view both the line and raster
plots of the same data simultaneously.
</li>
<li class="itemize"><a
href="mainap3.html#sri"><span
class="cmbx-12">SRI</span></a>: Opens a pop-up window containing the <a
href="mainli2.html#glo:port">Ports</a> <a
href="mainap3.html#sri">SRI</a>
</li>
<li class="itemize"><span
class="cmbx-12">New Data Plot</span>: Prompts the user for information pertaining to the <a
href="mainli2.html#glo:port">Port</a> to plot and
creates a new tab within the Plot View plotting this <a
href="mainli2.html#glo:port">Port</a>.
</li>
<li class="itemize"><span
class="cmbx-12">New </span><a
href="mainap3.html#fft"><span
class="cmbx-12">FFT</span></a> <span
class="cmbx-12">Plot</span>: Same as <span
class="cmbx-12">New Data Plot </span>except it performs an <a
href="mainap3.html#fft">FFT</a> of the data
prior to plotting.</li></ul>
<!--l. 287--><p class="noindent" ><hr class="figure"><div class="figure"
><table class="figure"><tr class="figure"><td class="figure"
>
<a
id="x24-311009r6"></a>
<!--l. 290--><p class="noindent" ><img
src="images/REDHAWK_Plot_Menu.png" alt="PIC"
>
<br /> <table class="caption"
><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 22.6: </td><td
class="content">The plot views drop down menu</td></tr></table><!--tex4ht:label?: x24-311009r6 -->
<!--l. 292--><p class="noindent" ></td></tr></table></div><hr class="endfigure">
<h3 class="sectionHead"><span class="titlemark">22.5 </span> <a
id="x24-31200022.5"></a>Displaying Link Statistics</h3>
<!--l. 296--><p class="noindent" >In addition to <a
href="mainli2.html#glo:port">Port</a> plotting, a user may want to monitor the amount of data flowing
out or into a particular <a
href="mainli2.html#glo:port">Port</a>. These link statistics are helpful when debugging and can
help identify which <a
href="mainli2.html#glo:component">Component</a> is slowing down or dropping information during data
processing.
<!--l. 301--><p class="noindent" >To bring up the <a
href="mainli2.html#glo:port"><span
class="cmbx-12">Port</span></a> <span
class="cmbx-12">Monitor </span>view:
<ol class="enumerate1" >
<li
class="enumerate" id="x24-312002x1">Make sure that the <a
href="mainli2.html#glo:component">Component</a> to be monitored is currently in the Started state.
</li>
<li
class="enumerate" id="x24-312004x2">Right click on the <a
href="mainli2.html#glo:port">Port</a> to monitor.
</li>
<li
class="enumerate" id="x24-312006x3">Select <span
class="cmbx-12">Monitor </span><a
href="mainli2.html#glo:port"><span
class="cmbx-12">Port</span></a>.
<!--l. 308--><p class="noindent" >This will bring up a new view and display the following information:
<ul class="itemize1">
<li class="itemize"><span
class="cmbx-12">Name</span>: The name of the <a
href="mainli2.html#glo:port">Port</a> or <a
href="mainli2.html#glo:port">Port</a> connection.
</li>
<li class="itemize"><span
class="cmbx-12">Elements/sec</span>: The rate of <a
href="mainap3.html#corba">CORBA</a> elements transferred in the pushPacket data
call.
</li>
<li class="itemize"><a
href="mainap3.html#mb"><span
class="cmbx-12">MB</span></a><span
class="cmbx-12">ps</span>: Mega Bytes transferred per second.
</li>
<li class="itemize"><span
class="cmbx-12">calls/sec</span>: Number of push calls per second to the <a
href="mainli2.html#glo:port">Port</a>.
</li>
<li class="itemize"><span
class="cmbx-12">Stream </span><a
href="mainap3.html#id"><span
class="cmbx-12">ID</span></a><span
class="cmbx-12">s</span>: List of all active stream <a
href="mainap3.html#id">ID</a>s.
</li>
<li class="itemize"><span
class="cmbx-12">Avg. Queue Depth</span>: For <a
href="mainli2.html#glo:component">Components</a> that queue data before
processing/sending, the average queue depth measured as a percentage. If a <a
href="mainli2.html#glo:port">Port</a>
does not queue data this value is set to zero.
</li>
<li class="itemize"><span
class="cmbx-12">Time</span>: The elapsed time, in seconds, since the last packet was transferred via a
push packet call.</li></ul>
</li></ol>
<!--l. 324--><p class="noindent" >
<h3 class="sectionHead"><span class="titlemark">22.6 </span> <a
id="x24-31300022.6"></a>Getting Details About Error Conditions</h3>
<!--l. 325--><p class="noindent" >If an error condition occurs within the <a
href="mainli2.html#glo:domainmanager">Domain Manager</a> which prevents a <a
href="mainli2.html#glo:component">Component</a>, <a
href="mainli2.html#glo:device">Device</a>,
<a
href="mainli2.html#glo:domainmanager">Domain Manager</a>, or <a
href="mainli2.html#glo:devicemanager">Device Manager</a> from running correctly, the objects representation in the
<a
href="mainap3.html#sca">SCA</a> Explorer will be marked with a decorator in the lower left corner. Mouse hovering
over the items icon will provide a short description of the issue; however, if more than
one problem has occurred, the hover text will read “Multiple Problems exist with this
item”.
<!--l. 332--><p class="noindent" ><hr class="figure"><div class="figure"
><table class="figure"><tr class="figure"><td class="figure"
>
<a
id="x24-313001r7"></a>
<!--l. 335--><p class="noindent" ><img
src="images/REDHAWK_Domain_Error_Mouse_Hover.png" alt="PIC"
>
<br /> <table class="caption"
><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 22.7: </td><td
class="content">Mouse hovering over items with error decorators will often provide information
about the error</td></tr></table><!--tex4ht:label?: x24-313001r7 -->
<!--l. 337--><p class="noindent" ></td></tr></table></div><hr class="endfigure">
<!--l. 339--><p class="noindent" ><div class="admonition block tip block-indent"><div class="tip-inner"><p class="para block block-first"> More detail about an error can be found within the <a
href="mainli2.html#glo:property">Properties</a> view of the item. </p></div></div>
<!--l. 343--><p class="noindent" >To view the details about an error condition:
<ol class="enumerate1" >
<li
class="enumerate" id="x24-313003x1">With the item selected, select or open the <a
href="mainli2.html#glo:Properties View"><span
class="cmbx-12">Properties View</span></a>.
</li>
<li
class="enumerate" id="x24-313005x2">From the <a
href="mainli2.html#glo:Properties View"><span
class="cmbx-12">Properties View</span></a>, select the <span
class="cmbx-12">Advanced </span>tab
</li>
<li
class="enumerate" id="x24-313007x3">Select the status row. This should cause the <span
class="cmbx-12">Details </span>button to appear.
</li>
<li
class="enumerate" id="x24-313009x4">Click <span
class="cmbx-12">Details </span>to bring up a detailed dialog of the current error conditions.</li></ol>
<!--l. 352--><p class="noindent" ><hr class="figure"><div class="figure"
><table class="figure"><tr class="figure"><td class="figure"
>
<a
id="x24-313010r8"></a>
<!--l. 354--><p class="noindent" ><img
src="images/REDHAWK_Property_View_Error_Dialog.png" alt="PIC"
>
<br /> <table class="caption"
><tr style="vertical-align:baseline;" class="caption"><td class="id">Figure 22.8: </td><td
class="content">Error event details dialog</td></tr></table><!--tex4ht:label?: x24-313010r8 -->
<!--l. 356--><p class="noindent" ></td></tr></table></div><hr class="endfigure">
<!--l. 1--><div class="crosslinks"><p class="noindent">[<a
href="mainch23.html" >next</a>] [<a
href="mainch21.html" >prev</a>] [<a
href="mainch21.html#tailmainch21.html" >prev-tail</a>] [<a
href="mainch22.html" >front</a>] [<a
href="main.html#mainch22.html" >up</a>] </p></div>
<!--l. 1--><p class="noindent" ><a
id="tailmainch22.html"></a>
<div class=license>
<hr>
<a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/deed.en_US"><img alt="Creative Commons License" style="border-width:0" src="http://i.creativecommons.org/l/by-sa/3.0/80x15.png" /></a><br /><span xmlns:dct="http:// purl.org/dc/terms/" property="dct:title">REDHAWK Documentation</span> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/deed.en_US">Creative Commons Attribution-ShareAlike 3.0 Unported License</a>.
</div>
</body></html>