--- /dev/null
+<!-- Copyright (C) 2003 Red Hat, Inc. -->
+<!-- This material may be distributed only subject to the terms -->
+<!-- and conditions set forth in the Open Publication License, v1.0 -->
+<!-- or later (the latest version is presently available at -->
+<!-- http://www.opencontent.org/openpub/). -->
+<!-- Distribution of the work or derivative of the work in any -->
+<!-- standard (paper) book form is prohibited unless prior -->
+<!-- permission is obtained from the copyright holder. -->
+<HTML
+><HEAD
+><TITLE
+>Execution</TITLE
+><meta name="MSSmartTagsPreventParsing" content="TRUE">
+<META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
+"><LINK
+REL="HOME"
+TITLE="eCos User Guide"
+HREF="ecos-user-guide.html"><LINK
+REL="UP"
+TITLE="The eCos Configuration Tool"
+HREF="the-ecos-configuration-tool.html"><LINK
+REL="PREVIOUS"
+TITLE="Selecting User Tools"
+HREF="config-tool-selecting-user-tools.html"><LINK
+REL="NEXT"
+TITLE="Creating a Shell"
+HREF="config-tool-creating-a-shell.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>eCos User Guide</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="config-tool-selecting-user-tools.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="config-tool-creating-a-shell.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="CONFIG-TOOL-TEST-EXECUTION">Chapter 22. Execution</H1
+><P
+>Test executables that have been linked using the Build/Tests
+operation against the current configuration can be executed by selecting <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Tools</I
+></SPAN
+>-><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Run
+Tests</I
+></SPAN
+>.</P
+><P
+>When tests are run, the <SPAN
+CLASS="APPLICATION"
+>Configuration Tool</SPAN
+> looks
+for a platform name corresponding to the currently loaded hardware template.
+If no such platform is found, a dialog will be displayed for you
+to define one; this dialog is similar to that displayed by the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Add</I
+></SPAN
+> function
+in the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Tools->Platforms</I
+></SPAN
+> dialog, but
+in this case the platform name cannot be changed.</P
+><P
+>When a test run is invoked, a property sheet is displayed,
+comprising three tabs: <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Executables</I
+></SPAN
+>, <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Output</I
+></SPAN
+> and <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Summary</I
+></SPAN
+>.</P
+><P
+>Note that the property sheet is resizable.</P
+><P
+>Three buttons appear on the property sheet itself: <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Run/Stop</I
+></SPAN
+>, <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Close</I
+></SPAN
+> and <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Properties</I
+></SPAN
+>.</P
+><P
+>The <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Run</I
+></SPAN
+> button is used to initiate a
+test run. Those tests selected on the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Executables</I
+></SPAN
+> tab
+are run, and the output recorded on the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Output</I
+></SPAN
+> and <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Summary</I
+></SPAN
+> tabs.
+During the course of a run, the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Run</I
+></SPAN
+> button
+changes to “Stop”. The button may be used to interrupt
+a test run at any point.</P
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="CONFIG-TOOL-TEST-PROPERTIES">Properties</H1
+><P
+>The <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Properties</I
+></SPAN
+> button is used to change
+the connectivity properties for the test run.</P
+><DIV
+CLASS="FIGURE"
+><A
+NAME="AEN1564"><P
+><B
+>Figure 22-1. Properties dialog box</B
+></P
+><P
+><IMG
+SRC="pix/ch-properties-dialog.png"></P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN1567">Download Timeout</H2
+><P
+> This group of controls serves to set the maximum time that
+ is allowed for downloading a test to the target board. If
+ the time is exceeded, the test will be deemed to have
+ failed for reason of “Download Timeout” and
+ the execution of that particular test will be abandoned.
+ This option only applies to tests run on hardware, not to
+ those executed in a simulator. Times are in units of
+ elapsed seconds.</P
+><P
+>Three options are available using the drop-down
+ list:</P
+><P
+></P
+><UL
+><LI
+><P
+>Calculated from file size - an estimate of the maximum
+time required for download is made using the (stripped) executable
+size and the currently used baud rate</P
+></LI
+><LI
+><P
+> Specified - a user-specified value may be entered in
+the adjacent edit box</P
+></LI
+><LI
+><P
+> None - no maximum download time is to be applied.</P
+></LI
+></UL
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN1578">Run time Timeout</H2
+><P
+>This group of controls serves to set the maximum time
+ that is allowed for executing a test on the target board
+ or in a simulator. If the time is exceeded, the test will
+ be deemed to have failed for reason of
+ “Timeout” and the execution of that particular
+ test will be abandoned. In the case of hardware, the time
+ is measured in elapsed seconds: in the case of a simulator
+ it is in CPU seconds.</P
+><P
+>Three options are available using the drop-down
+ list:</P
+><P
+></P
+><UL
+><LI
+><P
+>None - no maximum download time is to be
+ applied.</P
+></LI
+><LI
+><P
+>Specified - a user-specified value may be
+ entered in the adjacent edit box</P
+></LI
+><LI
+><P
+>Default - a default value of 30 seconds is
+ used</P
+></LI
+></UL
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN1589">Connection</H2
+><P
+>The <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Connection</I
+></SPAN
+> controls may be used
+ to specify how the target board is to be accessed.</P
+><P
+>If the target board is connected using a serial cable, the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Serial</I
+></SPAN
+> radio
+button should be checked. In this case you can select a port (COM1,
+COM2, …) and an appropriate baud rate using drop-list boxes.</P
+><P
+>If the target board is accessed remotely using GDB remote
+protocol, the “TCP/IP” radio button should
+be checked. In this case you can select a host name and TCP/IP port
+number using edit boxes.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN1596">Executables Tab</H2
+><P
+>This is used to adjust the set of tests available for execution.
+A check box against each executable name indicates whether that
+executable will be included when the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Run</I
+></SPAN
+> button
+is pressed. The <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Check All</I
+></SPAN
+> and <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Uncheck
+All</I
+></SPAN
+> buttons may be used to check or uncheck all items.</P
+><P
+>When the property sheet is first displayed, it will be pre-populated
+with those test executables that have been linked using the Build/Tests
+operation against the current configuration. </P
+><DIV
+CLASS="FIGURE"
+><A
+NAME="AEN1603"><P
+><B
+>Figure 22-2. Run tests </B
+></P
+><P
+><IMG
+SRC="pix/run-tests.png"></P
+></DIV
+><P
+>You can right-click in the window to display a context menu
+containing <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Add</I
+></SPAN
+> and <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Remove</I
+></SPAN
+> items.
+Clicking <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Remove</I
+></SPAN
+> will remove those executables
+selected. Clicking <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Add</I
+></SPAN
+> will display a dialog
+box that allows you to add to the set of items. Equivalently the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Add</I
+></SPAN
+> button
+may be used to add executables, and the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>DEL</I
+></SPAN
+> key
+may be used to remove them.</P
+><P
+>You can use the <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Add from Folder</I
+></SPAN
+> button
+to add a number of executables in a specified folder (optionally
+including subfolders, if you click on <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Yes</I
+></SPAN
+> when
+asked).</P
+><DIV
+CLASS="FIGURE"
+><A
+NAME="AEN1616"><P
+><B
+>Figure 22-3. Add files from folder </B
+></P
+><P
+><IMG
+SRC="pix/addfromfolder.png"></P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN1619">Output Tab</H2
+><P
+>This tab is used to display the output from running tests.
+The output can be saved to a file or cleared by means of the popup
+menu displayed when you right-click in the window.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN1622">Summary Tab</H2
+><P
+>This tab is used to display a record, in summary form, of
+those tests executed. For each execution, the following information
+is displayed:</P
+><P
+></P
+><UL
+><LI
+><P
+> <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Time</I
+></SPAN
+> - the date and time of execution</P
+></LI
+><LI
+><P
+> <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Host</I
+></SPAN
+> - the host name of the machine
+from which the test was downloaded</P
+></LI
+><LI
+><P
+> <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Platform</I
+></SPAN
+> - the platform on which
+the test was executed</P
+></LI
+><LI
+><P
+> <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Executable</I
+></SPAN
+> - the executable (file
+name) of the test executed</P
+></LI
+><LI
+><P
+> <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Status</I
+></SPAN
+> - the result of executing
+the test. This will be one of the following:</P
+></LI
+><LI
+><P
+> Not started</P
+></LI
+><LI
+><P
+>No result</P
+></LI
+><LI
+><P
+>Inapplicable</P
+></LI
+><LI
+><P
+> Pass</P
+></LI
+><LI
+><P
+>DTimeout</P
+></LI
+><LI
+><P
+>Timeout</P
+></LI
+><LI
+><P
+>Cancelled</P
+></LI
+><LI
+><P
+> Fail</P
+></LI
+><LI
+><P
+>Assert fail</P
+></LI
+><LI
+><P
+> <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Size</I
+></SPAN
+> - the size [stripped/unstripped] of
+the test executed</P
+></LI
+><LI
+><P
+> <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Download</I
+></SPAN
+> - the download time [mm:ss/mm:ss] used.
+The first of the two times displayed represents the actual time
+used: the second the limit time.</P
+></LI
+><LI
+><P
+> <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Elapsed</I
+></SPAN
+> - the elapsed time [mm:ss] used.</P
+></LI
+><LI
+><P
+> <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Execution</I
+></SPAN
+> - the execution time
+ [mm:ss/mm:ss] used. The first of the
+two times displayed represents the actual time used: the second
+the limit time.</P
+></LI
+></UL
+><P
+>The output can be saved to a file or cleared by means of the
+popup menu displayed when you right-click in the window.</P
+></DIV
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="config-tool-selecting-user-tools.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="ecos-user-guide.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="config-tool-creating-a-shell.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Selecting User Tools</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="the-ecos-configuration-tool.html"
+ACCESSKEY="U"
+>Up</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Creating a Shell</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
\ No newline at end of file
projects / karo-tx-redboot.git / blobdiff