1 <!-- Copyright (C) 2003 Red Hat, Inc. -->
2 <!-- This material may be distributed only subject to the terms -->
3 <!-- and conditions set forth in the Open Publication License, v1.0 -->
4 <!-- or later (the latest version is presently available at -->
5 <!-- http://www.opencontent.org/openpub/). -->
6 <!-- Distribution of the work or derivative of the work in any -->
7 <!-- standard (paper) book form is prohibited unless prior -->
8 <!-- permission is obtained from the copyright holder. -->
13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
19 TITLE="eCos User Guide"
20 HREF="ecos-user-guide.html"><LINK
22 TITLE="The eCos Configuration Tool"
23 HREF="the-ecos-configuration-tool.html"><LINK
25 TITLE="Selecting User Tools"
26 HREF="config-tool-selecting-user-tools.html"><LINK
28 TITLE="Creating a Shell"
29 HREF="config-tool-creating-a-shell.html"></HEAD
40 SUMMARY="Header navigation table"
57 HREF="config-tool-selecting-user-tools.html"
71 HREF="config-tool-creating-a-shell.html"
84 NAME="CONFIG-TOOL-TEST-EXECUTION">Chapter 22. Execution</H1
86 >Test executables that have been linked using the Build/Tests
87 operation against the current configuration can be executed by selecting <SPAN
102 >When tests are run, the <SPAN
104 >Configuration Tool</SPAN
106 for a platform name corresponding to the currently loaded hardware template.
107 If no such platform is found, a dialog will be displayed for you
108 to define one; this dialog is similar to that displayed by the <SPAN
119 >Tools->Platforms</I
122 in this case the platform name cannot be changed.</P
124 >When a test run is invoked, a property sheet is displayed,
125 comprising three tabs: <SPAN
145 >Note that the property sheet is resizable.</P
147 >Three buttons appear on the property sheet itself: <SPAN
173 > button is used to initiate a
174 test run. Those tests selected on the <SPAN
181 are run, and the output recorded on the <SPAN
194 During the course of a run, the <SPAN
201 changes to “Stop”. The button may be used to interrupt
202 a test run at any point.</P
208 NAME="CONFIG-TOOL-TEST-PROPERTIES">Properties</H1
216 > button is used to change
217 the connectivity properties for the test run.</P
223 >Figure 22-1. Properties dialog box</B
227 SRC="pix/ch-properties-dialog.png"></P
234 NAME="AEN1567">Download Timeout</H2
236 > This group of controls serves to set the maximum time that
237 is allowed for downloading a test to the target board. If
238 the time is exceeded, the test will be deemed to have
239 failed for reason of “Download Timeout” and
240 the execution of that particular test will be abandoned.
241 This option only applies to tests run on hardware, not to
242 those executed in a simulator. Times are in units of
245 >Three options are available using the drop-down
252 >Calculated from file size - an estimate of the maximum
253 time required for download is made using the (stripped) executable
254 size and the currently used baud rate</P
258 > Specified - a user-specified value may be entered in
259 the adjacent edit box</P
263 > None - no maximum download time is to be applied.</P
272 NAME="AEN1578">Run time Timeout</H2
274 >This group of controls serves to set the maximum time
275 that is allowed for executing a test on the target board
276 or in a simulator. If the time is exceeded, the test will
277 be deemed to have failed for reason of
278 “Timeout” and the execution of that particular
279 test will be abandoned. In the case of hardware, the time
280 is measured in elapsed seconds: in the case of a simulator
281 it is in CPU seconds.</P
283 >Three options are available using the drop-down
290 >None - no maximum download time is to be
295 >Specified - a user-specified value may be
296 entered in the adjacent edit box</P
300 >Default - a default value of 30 seconds is
310 NAME="AEN1589">Connection</H2
318 > controls may be used
319 to specify how the target board is to be accessed.</P
321 >If the target board is connected using a serial cable, the <SPAN
328 button should be checked. In this case you can select a port (COM1,
329 COM2, …) and an appropriate baud rate using drop-list boxes.</P
331 >If the target board is accessed remotely using GDB remote
332 protocol, the “TCP/IP” radio button should
333 be checked. In this case you can select a host name and TCP/IP port
334 number using edit boxes.</P
341 NAME="AEN1596">Executables Tab</H2
343 >This is used to adjust the set of tests available for execution.
344 A check box against each executable name indicates whether that
345 executable will be included when the <SPAN
352 is pressed. The <SPAN
365 > buttons may be used to check or uncheck all items.</P
367 >When the property sheet is first displayed, it will be pre-populated
368 with those test executables that have been linked using the Build/Tests
369 operation against the current configuration. </P
375 >Figure 22-2. Run tests </B
379 SRC="pix/run-tests.png"></P
382 >You can right-click in the window to display a context menu
402 > will remove those executables
403 selected. Clicking <SPAN
409 > will display a dialog
410 box that allows you to add to the set of items. Equivalently the <SPAN
417 may be used to add executables, and the <SPAN
424 may be used to remove them.</P
426 >You can use the <SPAN
433 to add a number of executables in a specified folder (optionally
434 including subfolders, if you click on <SPAN
447 >Figure 22-3. Add files from folder </B
451 SRC="pix/addfromfolder.png"></P
459 NAME="AEN1619">Output Tab</H2
461 >This tab is used to display the output from running tests.
462 The output can be saved to a file or cleared by means of the popup
463 menu displayed when you right-click in the window.</P
470 NAME="AEN1622">Summary Tab</H2
472 >This tab is used to display a record, in summary form, of
473 those tests executed. For each execution, the following information
486 > - the date and time of execution</P
496 > - the host name of the machine
497 from which the test was downloaded</P
507 > - the platform on which
508 the test was executed</P
518 > - the executable (file
519 name) of the test executed</P
529 > - the result of executing
530 the test. This will be one of the following:</P
576 > - the size [stripped/unstripped] of
587 > - the download time [mm:ss/mm:ss] used.
588 The first of the two times displayed represents the actual time
589 used: the second the limit time.</P
599 > - the elapsed time [mm:ss] used.</P
609 > - the execution time
610 [mm:ss/mm:ss] used. The first of the
611 two times displayed represents the actual time used: the second
616 >The output can be saved to a file or cleared by means of the
617 popup menu displayed when you right-click in the window.</P
626 SUMMARY="Footer navigation table"
637 HREF="config-tool-selecting-user-tools.html"
646 HREF="ecos-user-guide.html"
655 HREF="config-tool-creating-a-shell.html"
665 >Selecting User Tools</TD
671 HREF="the-ecos-configuration-tool.html"
679 >Creating a Shell</TD