📄 config-tool-test-execution.html
字号:
<!-- 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"><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+"><LINKREL="HOME"TITLE="eCos User Guide"HREF="ecos-user-guide.html"><LINKREL="UP"TITLE="The eCos Configuration Tool"HREF="the-ecos-configuration-tool.html"><LINKREL="PREVIOUS"TITLE="Selecting User Tools"HREF="config-tool-selecting-user-tools.html"><LINKREL="NEXT"TITLE="Creating a Shell"HREF="config-tool-creating-a-shell.html"></HEAD><BODYCLASS="CHAPTER"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLESUMMARY="Header navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><THCOLSPAN="3"ALIGN="center">eCos User Guide</TH></TR><TR><TDWIDTH="10%"ALIGN="left"VALIGN="bottom"><AHREF="config-tool-selecting-user-tools.html"ACCESSKEY="P">Prev</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom"></TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="config-tool-creating-a-shell.html"ACCESSKEY="N">Next</A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><DIVCLASS="CHAPTER"><H1><ANAME="CONFIG-TOOL-TEST-EXECUTION">Chapter 22. Execution</H1><P>Test executables that have been linked using the Build/Testsoperation against the current configuration can be executed by selecting <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Tools</I></SPAN>-><SPANCLASS="emphasis"><ICLASS="EMPHASIS">RunTests</I></SPAN>.</P><P>When tests are run, the <SPANCLASS="APPLICATION">Configuration Tool</SPAN> looksfor a platform name corresponding to the currently loaded hardware template.If no such platform is found, a dialog will be displayed for youto define one; this dialog is similar to that displayed by the <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Add</I></SPAN> functionin the <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Tools->Platforms</I></SPAN> dialog, butin this case the platform name cannot be changed.</P><P>When a test run is invoked, a property sheet is displayed,comprising three tabs: <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Executables</I></SPAN>, <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Output</I></SPAN> and <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Summary</I></SPAN>.</P><P>Note that the property sheet is resizable.</P><P>Three buttons appear on the property sheet itself: <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Run/Stop</I></SPAN>, <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Close</I></SPAN> and <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Properties</I></SPAN>.</P><P>The <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Run</I></SPAN> button is used to initiate atest run. Those tests selected on the <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Executables</I></SPAN> tabare run, and the output recorded on the <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Output</I></SPAN> and <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Summary</I></SPAN> tabs.During the course of a run, the <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Run</I></SPAN> buttonchanges to “Stop”. The button may be used to interrupta test run at any point.</P><DIVCLASS="SECT1"><H1CLASS="SECT1"><ANAME="CONFIG-TOOL-TEST-PROPERTIES">Properties</H1><P>The <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Properties</I></SPAN> button is used to changethe connectivity properties for the test run.</P><DIVCLASS="FIGURE"><ANAME="AEN1564"><P><B>Figure 22-1. Properties dialog box</B></P><P><IMGSRC="pix/ch-properties-dialog.png"></P></DIV><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="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 maximumtime required for download is made using the (stripped) executablesize and the currently used baud rate</P></LI><LI><P> Specified - a user-specified value may be entered inthe adjacent edit box</P></LI><LI><P> None - no maximum download time is to be applied.</P></LI></UL></DIV><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="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><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="AEN1589">Connection</H2><P>The <SPANCLASS="emphasis"><ICLASS="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 <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Serial</I></SPAN> radiobutton 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 remoteprotocol, the “TCP/IP” radio button shouldbe checked. In this case you can select a host name and TCP/IP portnumber using edit boxes.</P></DIV><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="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 thatexecutable will be included when the <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Run</I></SPAN> buttonis pressed. The <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Check All</I></SPAN> and <SPANCLASS="emphasis"><ICLASS="EMPHASIS">UncheckAll</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-populatedwith those test executables that have been linked using the Build/Testsoperation against the current configuration. </P><DIVCLASS="FIGURE"><ANAME="AEN1603"><P><B>Figure 22-2. Run tests </B></P><P><IMGSRC="pix/run-tests.png"></P></DIV><P>You can right-click in the window to display a context menucontaining <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Add</I></SPAN> and <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Remove</I></SPAN> items.Clicking <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Remove</I></SPAN> will remove those executablesselected. Clicking <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Add</I></SPAN> will display a dialogbox that allows you to add to the set of items. Equivalently the <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Add</I></SPAN> buttonmay be used to add executables, and the <SPANCLASS="emphasis"><ICLASS="EMPHASIS">DEL</I></SPAN> keymay be used to remove them.</P><P>You can use the <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Add from Folder</I></SPAN> buttonto add a number of executables in a specified folder (optionallyincluding subfolders, if you click on <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Yes</I></SPAN> whenasked).</P><DIVCLASS="FIGURE"><ANAME="AEN1616"><P><B>Figure 22-3. Add files from folder </B></P><P><IMGSRC="pix/addfromfolder.png"></P></DIV></DIV><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="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 popupmenu displayed when you right-click in the window.</P></DIV><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="AEN1622">Summary Tab</H2><P>This tab is used to display a record, in summary form, ofthose tests executed. For each execution, the following informationis displayed:</P><P></P><UL><LI><P> <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Time</I></SPAN> - the date and time of execution</P></LI><LI><P> <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Host</I></SPAN> - the host name of the machinefrom which the test was downloaded</P></LI><LI><P> <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Platform</I></SPAN> - the platform on whichthe test was executed</P></LI><LI><P> <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Executable</I></SPAN> - the executable (filename) of the test executed</P></LI><LI><P> <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Status</I></SPAN> - the result of executingthe 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> <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Size</I></SPAN> - the size [stripped/unstripped] ofthe test executed</P></LI><LI><P> <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Download</I></SPAN> - the download time [mm:ss/mm:ss] used.The first of the two times displayed represents the actual timeused: the second the limit time.</P></LI><LI><P> <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Elapsed</I></SPAN> - the elapsed time [mm:ss] used.</P></LI><LI><P> <SPANCLASS="emphasis"><ICLASS="EMPHASIS">Execution</I></SPAN> - the execution time [mm:ss/mm:ss] used. The first of thetwo times displayed represents the actual time used: the secondthe limit time.</P></LI></UL><P>The output can be saved to a file or cleared by means of thepopup menu displayed when you right-click in the window.</P></DIV></DIV></DIV><DIVCLASS="NAVFOOTER"><HRALIGN="LEFT"WIDTH="100%"><TABLESUMMARY="Footer navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top"><AHREF="config-tool-selecting-user-tools.html"ACCESSKEY="P">Prev</A></TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="ecos-user-guide.html"ACCESSKEY="H">Home</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top"><AHREF="config-tool-creating-a-shell.html"ACCESSKEY="N">Next</A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top">Selecting User Tools</TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="the-ecos-configuration-tool.html"ACCESSKEY="U">Up</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">Creating a Shell</TD></TR></TABLE></DIV></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -