config-tool.sgml

eCos操作系统源码

</FIGURE>
</SECT1>
</CHAPTER>

<!-- }}} -->  
<!-- {{{ Execution                      -->

<CHAPTER id="config-tool-test-execution"><!--<conditionaltext>-->
<TITLE>Execution</TITLE>
<PARA>Test executables that have been linked using the Build/Tests
operation against the current configuration can be executed by selecting <!--<conditionaltext>--><EMPHASIS>Tools</EMPHASIS>-&gt;<EMPHASIS>Run
Tests<!--<conditionaltext>--></EMPHASIS>.</PARA>
<PARA>When tests are run, the <application>Configuration Tool</application> 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 <EMPHASIS>Add</EMPHASIS> function
in the <EMPHASIS>Tools-&gt;Platforms</EMPHASIS> dialog, but
in this case the platform name cannot be changed.</PARA>
<PARA>When a test run is invoked, a property sheet is displayed,
comprising three tabs: <EMPHASIS>Executables</EMPHASIS>, <EMPHASIS>Output</EMPHASIS> and <EMPHASIS>Summary</EMPHASIS>.</PARA>
<PARA>Note that the property sheet is resizable.</PARA>
<PARA>Three buttons appear on the property sheet itself: <EMPHASIS>Run/Stop</EMPHASIS>, <EMPHASIS>Close</EMPHASIS> and <EMPHASIS>Properties</EMPHASIS>.</PARA>
<PARA>The <EMPHASIS>Run</EMPHASIS> button is used to initiate a
test run. Those tests selected on the <EMPHASIS>Executables</EMPHASIS> tab
are run, and the output recorded on the <EMPHASIS>Output</EMPHASIS> and <EMPHASIS>Summary</EMPHASIS> tabs.
During the course of a run, the <EMPHASIS>Run</EMPHASIS> button
changes to &ldquo;Stop&rdquo;. The button may be used to interrupt
a test run at any point.</PARA>
<SECT1 id="config-tool-test-properties">
<TITLE>Properties</TITLE>
<PARA>The <EMPHASIS>Properties</EMPHASIS> button is used to change
the connectivity properties for the test run.</PARA>
<FIGURE>
<TITLE>Properties dialog box</TITLE>
<GRAPHIC ENTITYREF="graphic25"></GRAPHIC>
</FIGURE>
<SECT2>
<TITLE>Download Timeout</TITLE>
<PARA>	    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 &ldquo;Download Timeout&rdquo; 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.</PARA>
<PARA>Three options are available using the drop-down
	    list:</PARA>
<ITEMIZEDLIST>
<LISTITEM>
<PARA>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</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			Specified - a user-specified value may be entered in
the adjacent edit box</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			None - no maximum download time is to be applied.</PARA>
</LISTITEM>
</ITEMIZEDLIST>
</SECT2>
<SECT2>
<TITLE>Run time Timeout</TITLE>
<PARA>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
	    &ldquo;Timeout&rdquo; 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.</PARA>
<PARA>Three options are available using the drop-down
	  list:</PARA>
<ITEMIZEDLIST>
<LISTITEM>
<PARA>None - no maximum download time is to be
		applied.</PARA>
</LISTITEM>
<LISTITEM>
<PARA>Specified - a user-specified value may be
		entered in the adjacent edit box</PARA>
</LISTITEM>
<LISTITEM>
<PARA>Default - a default value of 30 seconds is
		used</PARA>
</LISTITEM>
</ITEMIZEDLIST>
</SECT2>
<SECT2>
<TITLE>Connection</TITLE>
<PARA>The <EMPHASIS>Connection</EMPHASIS> controls may be used
	    to specify how the target board is to be accessed.</PARA>

<PARA>If the target board is connected using a serial cable, the <EMPHASIS>Serial</EMPHASIS> radio
button should be checked. In this case you can select a port (COM1,
COM2, &hellip;) and an appropriate baud rate using drop-list boxes.</PARA>
<PARA>If the target board is accessed remotely using GDB remote
protocol, the &ldquo;TCP/IP&rdquo; radio button should
be checked. In this case you can select a host name and TCP/IP port
number using edit boxes.</PARA>
</SECT2>
<SECT2>
<TITLE>Executables Tab</TITLE>
<PARA>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 <EMPHASIS>Run</EMPHASIS> button
is pressed. The <EMPHASIS>Check All</EMPHASIS> and <EMPHASIS>Uncheck
All</EMPHASIS> buttons may be used to check or uncheck all items.</PARA>
<PARA>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. </PARA>
<FIGURE>
<TITLE>Run tests </TITLE>
<GRAPHIC ENTITYREF="graphic27"></GRAPHIC>
</FIGURE>
<PARA>You can right-click in the window to display a context menu
containing <EMPHASIS>Add</EMPHASIS> and <EMPHASIS>Remove</EMPHASIS> items.
Clicking <EMPHASIS>Remove</EMPHASIS>  will remove those executables
selected. Clicking <EMPHASIS>Add</EMPHASIS> will display a dialog
box that allows you to add to the set of items. Equivalently the <EMPHASIS>Add</EMPHASIS> button
may be used to add executables, and the <EMPHASIS>DEL</EMPHASIS> key
may be used to remove them.</PARA>
<PARA>You can use the <EMPHASIS>Add from Folder</EMPHASIS> button
to add a number of executables in a specified folder (optionally
including subfolders, if you click on <EMPHASIS>Yes</EMPHASIS> when
asked).</PARA>
<FIGURE>
<TITLE>Add files from folder </TITLE>
<GRAPHIC ENTITYREF="graphic28"></GRAPHIC>
</FIGURE>

<!--
<PARA>The &ldquo;Add from subfolders&rdquo; check box should
be checked if you wish the search for executables to descend into
subfolders (in the example above the whole of the C drive would
be searched).</PARA>

<PARA>The &ldquo;Files of type&rdquo; edit box should be used
to specify the extension of those files to be matched &lsqb;for
example, &ldquo;*.exe&rdquo;&rsqb;.</PARA>
-->
</SECT2>
<SECT2>
<TITLE>Output Tab</TITLE>
<PARA>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.</PARA>
</SECT2>
<SECT2>
<TITLE>Summary Tab</TITLE>
<PARA>This tab is used to display a record, in summary form, of
those tests executed. For each execution, the following information
is displayed:</PARA>
<ITEMIZEDLIST>
<LISTITEM>
<PARA>			<EMPHASIS>Time</EMPHASIS> - the date and time of execution</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			<EMPHASIS>Host</EMPHASIS> - the host name of the machine
from which the test was downloaded</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			<EMPHASIS>Platform</EMPHASIS> - the platform on which
the test was executed</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			<EMPHASIS>Executable</EMPHASIS> - the executable (file
name) of the test executed</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			<EMPHASIS>Status</EMPHASIS> - the result of executing
the test. This will be one of the following:</PARA>
</LISTITEM>
<LISTITEM>
<PARA>				Not started</PARA>
</LISTITEM>
<LISTITEM>
<PARA>No result</PARA>
</LISTITEM>
<LISTITEM>
<PARA>Inapplicable</PARA>
</LISTITEM>
<LISTITEM>
<PARA>				Pass</PARA>
</LISTITEM>
<LISTITEM>
<PARA>DTimeout</PARA>
</LISTITEM>
<LISTITEM>
<PARA>Timeout</PARA>
</LISTITEM>
<LISTITEM>
<PARA>Cancelled</PARA>
</LISTITEM>
<LISTITEM>
<PARA>				Fail</PARA>
</LISTITEM>
<LISTITEM>
<PARA>Assert fail</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			<EMPHASIS>Size</EMPHASIS> - the size &lsqb;stripped/unstripped&rsqb; of
the test executed</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			<EMPHASIS>Download</EMPHASIS> - the download time &lsqb;mm:ss/mm:ss&rsqb; used.
The first of the two times displayed represents the actual time
used: the second the limit time.</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			<EMPHASIS>Elapsed</EMPHASIS> - the elapsed time &lsqb;mm:ss&rsqb; used.</PARA>
</LISTITEM>
<LISTITEM>
<PARA>			<EMPHASIS>Execution</EMPHASIS> - the execution time
 &lsqb;mm:ss/mm:ss&rsqb; used. The first of the
two times displayed represents the actual time used: the second
the limit time.</PARA>
</LISTITEM>
</ITEMIZEDLIST>
<PARA>The output can be saved to a file or cleared by means of the
popup menu displayed when you right-click in the window.</PARA>
</SECT2>
</SECT1>
</CHAPTER>

<!-- }}} -->  
<!-- {{{ Creating a Shell               -->

<CHAPTER id="config-tool-creating-a-shell">
<TITLE>Creating a Shell</TITLE>
<PARA>To call up a shell window, select <EMPHASIS>Tools</EMPHASIS>-&gt;<EMPHASIS>Shell</EMPHASIS>.
Under Windows, you will get a Cygwin shell similar to the one below. On Linux, you will
get a standard Linux shell window.</PARA>
<GRAPHIC ENTITYREF="graphic29"></GRAPHIC>
<SECT1 id="config-tool-keyboard-accelerators">
<TITLE>Keyboard Accelerators</TITLE>
<PARA>The following table presents the list of keyboard accelerators
that can be used with the <application>Configuration Tool</application>. </PARA>

<table id="keyboard-accelerators"><title>Keyboard accelerators</title>
<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>Accelerator</entry>
	      <entry>Action</entry>
	      <entry>Remarks</entry>
	    </row>
	  </thead>
<tbody>

<row>
<entry><emphasis>Alt+1</emphasis></entry>
<entry>hide/show properties window</entry>
<entry></entry>
</row>

<row>
<entry><emphasis>Alt+2</emphasis></entry>
<entry>hide/show output window</entry>
<entry></entry></row>

<row>
<entry><emphasis>Alt+3</emphasis></entry>
<entry>hide/show short description window</entry>
<entry></entry></row>

<row>
<entry><emphasis>Alt+4</emphasis></entry>
<entry>hide/show conflicts window</entry>
<entry></entry>
</row>

<row>
<entry><emphasis>Ctrl+A</emphasis></entry>
<entry>select all</entry><entry>output
window and in-cell editing</entry></row>
<row>
<entry><emphasis>Ctrl+C</emphasis></entry>
<entry>copy</entry><entry>output window
and in-cell editing</entry></row>
<row>
<entry><emphasis>Ctrl+F</emphasis></entry>
<entry>Edit-&gt;Find</entry><entry></entry></row>
<row>
<entry><emphasis>Ctrl+N</emphasis></entry>
<entry>File-&gt;New</entry><entry></entry></row>
<row>
<entry><emphasis>Ctrl+O</emphasis></entry>
<entry>File-&gt;Open</entry><entry></entry></row>
<row>
<entry><emphasis>Ctrl+S</emphasis></entry>
<entry>File-&gt;Save</entry><entry></entry></row>
<row>
<entry><emphasis>Ctrl+V</emphasis></entry>
<entry>Paste</entry><entry>in-cell editing
only</entry></row>
<row>
<entry><emphasis>Ctrl+X</emphasis></entry>
<entry>Cut</entry><entry>in-cell-editing
only</entry></row>
<row>
<entry><emphasis>Ctrl+Z</emphasis></entry>
<entry>Undo</entry><entry>in-cell editing
only</entry></row>
<row>
<entry><emphasis>F1</emphasis></entry>
<entry>Context-sensitive help</entry><entry></entry></row>
<row>
<entry><emphasis>F3</emphasis></entry>
<entry>Find next</entry><entry></entry></row>
<row>
<entry><emphasis>F7</emphasis></entry>
<entry>Build-&gt;Library</entry><entry></entry></row>
<row>
<entry><emphasis>Shift+F7</emphasis></entry>
<entry>Build-&gt;Tests</entry><entry></entry></row>
<row>
<entry><emphasis>Alt+F6</emphasis></entry>
<entry>View-&gt;Next window</entry>
<entry></entry></row>
<row>
<entry><emphasis>Shift+Alt+0</emphasis></entry>
<entry>View-&gt;Previous window</entry>
<entry></entry></row>
<row>
<entry><emphasis>Shift+Ins</emphasis></entry>
<entry>Paste</entry><entry>in-cell editing
only</entry></row>
<row>
<entry><emphasis>Shift+F10</emphasis></entry>
<entry>Display context menu</entry><entry>Configuration
window</entry></row>
<row>
<entry><emphasis>Alt+Enter</emphasis></entry>
<entry>Display properties dialog box</entry>
<entry>Configuration window</entry></row>
<row>
<entry><emphasis>&gt;</emphasis></entry>
<entry>Increment item value</entry><entry>Configuration
window</entry></row>
<row>
<entry>&lt;</entry><entry>Decrement
item value</entry><entry>Configuration window</entry></row>
<row>
<entry><emphasis>Space</emphasis></entry>
<entry>Toggle item value</entry><entry>Configuration
window</entry></row>
	  </tbody>
	</tgroup>
      </table>

</SECT1>
</CHAPTER>

<!-- }}} -->  

  
</PART>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:("user-guide.sgml" "book" "part")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->