URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [user-guide/] [config-tool-test-execution.html] - Blame information for rev 773

Go to most recent revision | Details | Compare with Previous | View Log


<!-- 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
>-&gt;<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-&gt;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 &#8220;Stop&#8221;. 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 &#8220;Download Timeout&#8221; 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
            &#8220;Timeout&#8221; 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, &#8230;) and an appropriate baud rate using drop-list boxes.</P
><P
>If the target board is accessed remotely using GDB remote
protocol, the &#8220;TCP/IP&#8221; 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 &#0091;stripped/unstripped&#0093; of
the test executed</P
></LI
><LI
><P
>                       <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Download</I
></SPAN
> - the download time &#0091;mm:ss/mm:ss&#0093; 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 &#0091;mm:ss&#0093; used.</P
></LI
><LI
><P
>                       <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Execution</I
></SPAN
> - the execution time
 &#0091;mm:ss/mm:ss&#0093; 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
>

Line No.	Rev	Author	Line
1	28	unneback	`<!-- 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. -->`
9			`<HTML`
10			`><HEAD`
11			`><TITLE`
12			`>Execution</TITLE`
13			`><meta name="MSSmartTagsPreventParsing" content="TRUE">`
14			`<META`
15			`NAME="GENERATOR"`
16			`CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+`
17			`"><LINK`
18			`REL="HOME"`
19			`TITLE="eCos User Guide"`
20			`HREF="ecos-user-guide.html"><LINK`
21			`REL="UP"`
22			`TITLE="The eCos Configuration Tool"`
23			`HREF="the-ecos-configuration-tool.html"><LINK`
24			`REL="PREVIOUS"`
25			`TITLE="Selecting User Tools"`
26			`HREF="config-tool-selecting-user-tools.html"><LINK`
27			`REL="NEXT"`
28			`TITLE="Creating a Shell"`
29			`HREF="config-tool-creating-a-shell.html"></HEAD`
30			`><BODY`
31			`CLASS="CHAPTER"`
32			`BGCOLOR="#FFFFFF"`
33			`TEXT="#000000"`
34			`LINK="#0000FF"`
35			`VLINK="#840084"`
36			`ALINK="#0000FF"`
37			`><DIV`
38			`CLASS="NAVHEADER"`
39			`><TABLE`
40			`SUMMARY="Header navigation table"`
41			`WIDTH="100%"`
42			`BORDER="0"`
43			`CELLPADDING="0"`
44			`CELLSPACING="0"`
45			`><TR`
46			`><TH`
47			`COLSPAN="3"`
48			`ALIGN="center"`
49			`>eCos User Guide</TH`
50			`></TR`
51			`><TR`
52			`><TD`
53			`WIDTH="10%"`
54			`ALIGN="left"`
55			`VALIGN="bottom"`
56			`><A`
57			`HREF="config-tool-selecting-user-tools.html"`
58			`ACCESSKEY="P"`
59			`>Prev</A`
60			`></TD`
61			`><TD`
62			`WIDTH="80%"`
63			`ALIGN="center"`
64			`VALIGN="bottom"`
65			`></TD`
66			`><TD`
67			`WIDTH="10%"`
68			`ALIGN="right"`
69			`VALIGN="bottom"`
70			`><A`
71			`HREF="config-tool-creating-a-shell.html"`
72			`ACCESSKEY="N"`
73			`>Next</A`
74			`></TD`
75			`></TR`
76			`></TABLE`
77			`><HR`
78			`ALIGN="LEFT"`
79			`WIDTH="100%"></DIV`
80			`><DIV`
81			`CLASS="CHAPTER"`
82			`><H1`
83			`><A`
84			`NAME="CONFIG-TOOL-TEST-EXECUTION">Chapter 22. Execution</H1`
85			`><P`
86			`>Test executables that have been linked using the Build/Tests`
87			`operation against the current configuration can be executed by selecting <SPAN`
88			`CLASS="emphasis"`
89			`><I`
90			`CLASS="EMPHASIS"`
91			`>Tools</I`
92			`></SPAN`
93			`>-><SPAN`
94			`CLASS="emphasis"`
95			`><I`
96			`CLASS="EMPHASIS"`
97			`>Run`
98			`Tests</I`
99			`></SPAN`
100			`>.</P`
101			`><P`
102			`>When tests are run, the <SPAN`
103			`CLASS="APPLICATION"`
104			`>Configuration Tool</SPAN`
105			`> looks`
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`
109			`CLASS="emphasis"`
110			`><I`
111			`CLASS="EMPHASIS"`
112			`>Add</I`
113			`></SPAN`
114			`> function`
115			`in the <SPAN`
116			`CLASS="emphasis"`
117			`><I`
118			`CLASS="EMPHASIS"`
119			`>Tools->Platforms</I`
120			`></SPAN`
121			`> dialog, but`
122			`in this case the platform name cannot be changed.</P`
123			`><P`
124			`>When a test run is invoked, a property sheet is displayed,`
125			`comprising three tabs: <SPAN`
126			`CLASS="emphasis"`
127			`><I`
128			`CLASS="EMPHASIS"`
129			`>Executables</I`
130			`></SPAN`
131			`>, <SPAN`
132			`CLASS="emphasis"`
133			`><I`
134			`CLASS="EMPHASIS"`
135			`>Output</I`
136			`></SPAN`
137			`> and <SPAN`
138			`CLASS="emphasis"`
139			`><I`
140			`CLASS="EMPHASIS"`
141			`>Summary</I`
142			`></SPAN`
143			`>.</P`
144			`><P`
145			`>Note that the property sheet is resizable.</P`
146			`><P`
147			`>Three buttons appear on the property sheet itself: <SPAN`
148			`CLASS="emphasis"`
149			`><I`
150			`CLASS="EMPHASIS"`
151			`>Run/Stop</I`
152			`></SPAN`
153			`>, <SPAN`
154			`CLASS="emphasis"`
155			`><I`
156			`CLASS="EMPHASIS"`
157			`>Close</I`
158			`></SPAN`
159			`> and <SPAN`
160			`CLASS="emphasis"`
161			`><I`
162			`CLASS="EMPHASIS"`
163			`>Properties</I`
164			`></SPAN`
165			`>.</P`
166			`><P`
167			`>The <SPAN`
168			`CLASS="emphasis"`
169			`><I`
170			`CLASS="EMPHASIS"`
171			`>Run</I`
172			`></SPAN`
173			`> button is used to initiate a`
174			`test run. Those tests selected on the <SPAN`
175			`CLASS="emphasis"`
176			`><I`
177			`CLASS="EMPHASIS"`
178			`>Executables</I`
179			`></SPAN`
180			`> tab`
181			`are run, and the output recorded on the <SPAN`
182			`CLASS="emphasis"`
183			`><I`
184			`CLASS="EMPHASIS"`
185			`>Output</I`
186			`></SPAN`
187			`> and <SPAN`
188			`CLASS="emphasis"`
189			`><I`
190			`CLASS="EMPHASIS"`
191			`>Summary</I`
192			`></SPAN`
193			`> tabs.`
194			`During the course of a run, the <SPAN`
195			`CLASS="emphasis"`
196			`><I`
197			`CLASS="EMPHASIS"`
198			`>Run</I`
199			`></SPAN`
200			`> button`
201			`changes to “Stop”. The button may be used to interrupt`
202			`a test run at any point.</P`
203			`><DIV`
204			`CLASS="SECT1"`
205			`><H1`
206			`CLASS="SECT1"`
207			`><A`
208			`NAME="CONFIG-TOOL-TEST-PROPERTIES">Properties</H1`
209			`><P`
210			`>The <SPAN`
211			`CLASS="emphasis"`
212			`><I`
213			`CLASS="EMPHASIS"`
214			`>Properties</I`
215			`></SPAN`
216			`> button is used to change`
217			`the connectivity properties for the test run.</P`
218			`><DIV`
219			`CLASS="FIGURE"`
220			`><A`
221			`NAME="AEN1564"><P`
222			`><B`
223			`>Figure 22-1. Properties dialog box</B`
224			`></P`
225			`><P`
226			`><IMG`
227			`SRC="pix/ch-properties-dialog.png"></P`
228			`></DIV`
229			`><DIV`
230			`CLASS="SECT2"`
231			`><H2`
232			`CLASS="SECT2"`
233			`><A`
234			`NAME="AEN1567">Download Timeout</H2`
235			`><P`
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`
243			`elapsed seconds.</P`
244			`><P`
245			`>Three options are available using the drop-down`
246			`list:</P`
247			`><P`
248			`></P`
249			`><UL`
250			`><LI`
251			`><P`
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`
255			`></LI`
256			`><LI`
257			`><P`
258			`> Specified - a user-specified value may be entered in`
259			`the adjacent edit box</P`
260			`></LI`
261			`><LI`
262			`><P`
263			`> None - no maximum download time is to be applied.</P`
264			`></LI`
265			`></UL`
266			`></DIV`
267			`><DIV`
268			`CLASS="SECT2"`
269			`><H2`
270			`CLASS="SECT2"`
271			`><A`
272			`NAME="AEN1578">Run time Timeout</H2`
273			`><P`
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`
282			`><P`
283			`>Three options are available using the drop-down`
284			`list:</P`
285			`><P`
286			`></P`
287			`><UL`
288			`><LI`
289			`><P`
290			`>None - no maximum download time is to be`
291			`applied.</P`
292			`></LI`
293			`><LI`
294			`><P`
295			`>Specified - a user-specified value may be`
296			`entered in the adjacent edit box</P`
297			`></LI`
298			`><LI`
299			`><P`
300			`>Default - a default value of 30 seconds is`
301			`used</P`
302			`></LI`
303			`></UL`
304			`></DIV`
305			`><DIV`
306			`CLASS="SECT2"`
307			`><H2`
308			`CLASS="SECT2"`
309			`><A`
310			`NAME="AEN1589">Connection</H2`
311			`><P`
312			`>The <SPAN`
313			`CLASS="emphasis"`
314			`><I`
315			`CLASS="EMPHASIS"`
316			`>Connection</I`
317			`></SPAN`
318			`> controls may be used`
319			`to specify how the target board is to be accessed.</P`
320			`><P`
321			`>If the target board is connected using a serial cable, the <SPAN`
322			`CLASS="emphasis"`
323			`><I`
324			`CLASS="EMPHASIS"`
325			`>Serial</I`
326			`></SPAN`
327			`> radio`
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`
330			`><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`
335			`></DIV`
336			`><DIV`
337			`CLASS="SECT2"`
338			`><H2`
339			`CLASS="SECT2"`
340			`><A`
341			`NAME="AEN1596">Executables Tab</H2`
342			`><P`
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`
346			`CLASS="emphasis"`
347			`><I`
348			`CLASS="EMPHASIS"`
349			`>Run</I`
350			`></SPAN`
351			`> button`
352			`is pressed. The <SPAN`
353			`CLASS="emphasis"`
354			`><I`
355			`CLASS="EMPHASIS"`
356			`>Check All</I`
357			`></SPAN`
358			`> and <SPAN`
359			`CLASS="emphasis"`
360			`><I`
361			`CLASS="EMPHASIS"`
362			`>Uncheck`
363			`All</I`
364			`></SPAN`
365			`> buttons may be used to check or uncheck all items.</P`
366			`><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`
370			`><DIV`
371			`CLASS="FIGURE"`
372			`><A`
373			`NAME="AEN1603"><P`
374			`><B`
375			`>Figure 22-2. Run tests </B`
376			`></P`
377			`><P`
378			`><IMG`
379			`SRC="pix/run-tests.png"></P`
380			`></DIV`
381			`><P`
382			`>You can right-click in the window to display a context menu`
383			`containing <SPAN`
384			`CLASS="emphasis"`
385			`><I`
386			`CLASS="EMPHASIS"`
387			`>Add</I`
388			`></SPAN`
389			`> and <SPAN`
390			`CLASS="emphasis"`
391			`><I`
392			`CLASS="EMPHASIS"`
393			`>Remove</I`
394			`></SPAN`
395			`> items.`
396			`Clicking <SPAN`
397			`CLASS="emphasis"`
398			`><I`
399			`CLASS="EMPHASIS"`
400			`>Remove</I`
401			`></SPAN`
402			`> will remove those executables`
403			`selected. Clicking <SPAN`
404			`CLASS="emphasis"`
405			`><I`
406			`CLASS="EMPHASIS"`
407			`>Add</I`
408			`></SPAN`
409			`> will display a dialog`
410			`box that allows you to add to the set of items. Equivalently the <SPAN`
411			`CLASS="emphasis"`
412			`><I`
413			`CLASS="EMPHASIS"`
414			`>Add</I`
415			`></SPAN`
416			`> button`
417			`may be used to add executables, and the <SPAN`
418			`CLASS="emphasis"`
419			`><I`
420			`CLASS="EMPHASIS"`
421			`>DEL</I`
422			`></SPAN`
423			`> key`
424			`may be used to remove them.</P`
425			`><P`
426			`>You can use the <SPAN`
427			`CLASS="emphasis"`
428			`><I`
429			`CLASS="EMPHASIS"`
430			`>Add from Folder</I`
431			`></SPAN`
432			`> button`
433			`to add a number of executables in a specified folder (optionally`
434			`including subfolders, if you click on <SPAN`
435			`CLASS="emphasis"`
436			`><I`
437			`CLASS="EMPHASIS"`
438			`>Yes</I`
439			`></SPAN`
440			`> when`
441			`asked).</P`
442			`><DIV`
443			`CLASS="FIGURE"`
444			`><A`
445			`NAME="AEN1616"><P`
446			`><B`
447			`>Figure 22-3. Add files from folder </B`
448			`></P`
449			`><P`
450			`><IMG`
451			`SRC="pix/addfromfolder.png"></P`
452			`></DIV`
453			`></DIV`
454			`><DIV`
455			`CLASS="SECT2"`
456			`><H2`
457			`CLASS="SECT2"`
458			`><A`
459			`NAME="AEN1619">Output Tab</H2`
460			`><P`
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`
464			`></DIV`
465			`><DIV`
466			`CLASS="SECT2"`
467			`><H2`
468			`CLASS="SECT2"`
469			`><A`
470			`NAME="AEN1622">Summary Tab</H2`
471			`><P`
472			`>This tab is used to display a record, in summary form, of`
473			`those tests executed. For each execution, the following information`
474			`is displayed:</P`
475			`><P`
476			`></P`
477			`><UL`
478			`><LI`
479			`><P`
480			`> <SPAN`
481			`CLASS="emphasis"`
482			`><I`
483			`CLASS="EMPHASIS"`
484			`>Time</I`
485			`></SPAN`
486			`> - the date and time of execution</P`
487			`></LI`
488			`><LI`
489			`><P`
490			`> <SPAN`
491			`CLASS="emphasis"`
492			`><I`
493			`CLASS="EMPHASIS"`
494			`>Host</I`
495			`></SPAN`
496			`> - the host name of the machine`
497			`from which the test was downloaded</P`
498			`></LI`
499			`><LI`
500			`><P`

Browse

Tools

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [user-guide/] [config-tool-test-execution.html] - Blame information for rev 773