📄 synth-running.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>Running a Synthetic Target Application</TITLE><meta name="MSSmartTagsPreventParsing" content="TRUE"><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+"><LINKREL="HOME"TITLE="eCos Reference Manual"HREF="ecos-ref.html"><LINKREL="UP"TITLE="eCos Synthetic Target"HREF="hal-synth-arch.html"><LINKREL="PREVIOUS"TITLE="Installation"HREF="synth-install.html"><LINKREL="NEXT"TITLE="The I/O Auxiliary's User Interface"HREF="synth-gui.html"></HEAD><BODYCLASS="REFENTRY"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 Reference Manual</TH></TR><TR><TDWIDTH="10%"ALIGN="left"VALIGN="bottom"><AHREF="synth-install.html"ACCESSKEY="P">Prev</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom"></TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="synth-gui.html"ACCESSKEY="N">Next</A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><H1><ANAME="SYNTH-RUNNING">Running a Synthetic Target Application</H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN17751"></A><H2>Name</H2>Execution -- Arguments and configuration files</DIV><DIVCLASS="REFSECT1"><ANAME="SYNTH-RUNNING-DESCRIPTION"></A><H2>Description</H2><P>The procedure for configuring and building eCos and an application forthe synthetic target is the same as for any other eCos target. Once anexecutable has been built it can be run like any Linux program, forexample from a shell prompt, </P><TABLEBORDER="5"BGCOLOR="#E0E0F0"WIDTH="70%"><TR><TD><PRECLASS="SCREEN">$ ecos_hello <options></PRE></TD></TR></TABLE><P>or using gdb: </P><TABLEBORDER="5"BGCOLOR="#E0E0F0"WIDTH="70%"><TR><TD><PRECLASS="SCREEN">$ gdb --nw --quiet --args ecos_hello <options>(gdb) runStarting program: ecos_hello <options></PRE></TD></TR></TABLE><P>By default use of the I/O auxiliary is disabled. If its I/O facilitiesare required then the option <TTCLASS="OPTION">--io</TT> must be used. </P><DIVCLASS="NOTE"><BLOCKQUOTECLASS="NOTE"><P><B>Note: </B>In future the default behaviour may change, with the I/O auxiliarybeing started by default. The option <TTCLASS="OPTION">--nio</TT> can beused to prevent the auxiliary from being run. </P></BLOCKQUOTE></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="SYNTH-RUNNING-ARGUMENTS"></A><H2>Command-line Arguments</H2><P>The syntax for running a synthetic target application is: </P><TABLEBORDER="5"BGCOLOR="#E0E0F0"WIDTH="70%"><TR><TD><PRECLASS="SCREEN">$ <ecos_app> [options] [-- [app_options]]</PRE></TD></TR></TABLE><P>Command line options up to the <TTCLASS="OPTION">--</TT> are passed on tothe I/O auxiliary. Subsequent arguments are not passed on to theauxiliary, and hence can be used by the eCos application itself. Thefull set of arguments can be accessed through the variables<TTCLASS="VARNAME">cyg_hal_sys_argc</TT> and<TTCLASS="VARNAME">cyg_hal_sys_argv</TT>. </P><P>The following options are accepted as standard: </P><P></P><DIVCLASS="VARIABLELIST"><DL><DT><TTCLASS="OPTION">--io</TT></DT><DD><P>This option causes the eCos application to spawn the I/O auxiliaryduring HAL initialization. Without this option only limited I/O willbe available. </P></DD><DT><TTCLASS="OPTION">--nio</TT></DT><DD><P>This option prevents the eCos application from spawning the I/Oauxiliary. In the current version of the software this is the default. </P></DD><DT><TTCLASS="OPTION">-nw</TT>, <TTCLASS="OPTION">--no-windows</TT></DT><DD><P>The I/O auxiliary can either provide a graphical user interface, or itcan run in a text-only mode. The default is to provide the graphicalinterface, but this can be disabled with <TTCLASS="OPTION">-nw</TT>.Emulation of some devices, for example buttons connected to digitalinputs, requires the graphical interface. </P></DD><DT><TTCLASS="OPTION">-w</TT>, <TTCLASS="OPTION">--windows</TT></DT><DD><P>The <TTCLASS="OPTION">-w</TT> causes the I/O auxiliary to provide agraphical user interface. This is the default. </P></DD><DT><TTCLASS="OPTION">-v</TT>, <TTCLASS="OPTION">--version</TT></DT><DD><P>The <TTCLASS="OPTION">-v</TT> option can be used to determine the version ofthe I/O auxiliary being used and where it has been installed. Both theauxiliary and the eCos application will exit immediately. </P></DD><DT><TTCLASS="OPTION">-h</TT>, <TTCLASS="OPTION">--help</TT></DT><DD><P><TTCLASS="OPTION">-h</TT> causes the I/O auxiliary to list all acceptedcommand-line arguments. This happens after all devices have beeninitialized, since the host-side support for some of the devices mayextend the list of recognised options. After this both the auxiliaryand the eCos application will exit immediately. This option implies<TTCLASS="OPTION">-nw</TT>. </P></DD><DT><TTCLASS="OPTION">-k</TT>, <TTCLASS="OPTION">--keep-going</TT></DT><DD><P>If an error occurs in the I/O auxiliary while reading in any of theconfiguration files or initializing devices, by default both the auxiliary and the eCos application will exit. The <TTCLASS="OPTION">-k</TT>option can be used to make the auxiliary continue in spite of errors,although obviously it may not be fully functional. </P></DD><DT><TTCLASS="OPTION">-nr</TT>, <TTCLASS="OPTION">--no-rc</TT></DT><DD><P>Normally the auxiliary processes two <AHREF="synth-running.html#SYNTH-RUNNING-USER-CONFIG">user configuration files</A>during startup: <TTCLASS="FILENAME">initrc.tcl</TT> and<TTCLASS="FILENAME">mainrc.tcl</TT>. This can be suppressed using the<TTCLASS="OPTION">-nr</TT> option. </P></DD><DT><TTCLASS="OPTION">-x</TT>, <TTCLASS="OPTION">--exit</TT></DT><DD><P>When providing a graphical user interface the I/O auxiliary willnormally continue running even after the eCos application has exited.This allows the user to take actions such as saving the currentcontents of the main text window. If run with <TTCLASS="OPTION">-x</TT> thenthe auxiliary will exit as soon the application exits. </P></DD><DT><TTCLASS="OPTION">-nx</TT>, <TTCLASS="OPTION">--no-exit</TT></DT><DD><P>When the graphical user interface is disabled with<TTCLASS="OPTION">-nw</TT> the I/O auxiliary will normally exit immediatelywhen the eCos application exits. Without the graphical frontend thereis usually no way for the user to interact directly with theauxiliary, so there is no point in continuing to run once the eCosapplication will no longer request any I/O operations. Specifying the<TTCLASS="OPTION">-nx</TT> option causes the auxiliary to continue runningeven after the application has exited. </P></DD><DT><TTCLASS="OPTION">-V</TT>, <TTCLASS="OPTION">--verbose</TT></DT><DD><P>This option causes the I/O auxiliary to output some additionalinformation, especially during initialization. </P></DD><DT><TTCLASS="OPTION">-l <file></TT>, <TTCLASS="OPTION">--logfile <file></TT></DT><DD><P>Much of the output of the eCos application and the I/O auxiliary issimple text, for example resulting from eCos<TTCLASS="FUNCTION">printf</TT> or <TTCLASS="FUNCTION">diag_printf</TT> calls.When running in graphical mode this output goes to a central textwindow, and can be saved to a file or edited via menus. The<TTCLASS="OPTION">-l</TT> can be used to automatically generate anadditional logfile containing all the text. If graphicalmode is disabled then by default all the text just goes to the currentstandard output. Specifying <TTCLASS="OPTION">-l</TT> causes most of thetext to go into a logfile instead, although some messages such aserrors generated by the auxiliary itself will still go to stdout aswell. </P></DD><DT><TTCLASS="OPTION">-t <file></TT>, <TTCLASS="OPTION">--target <file></TT></DT><DD><P>During initialization the I/O auxiliary reads in a target definitionfile. This file holds information such as which Linux devices shouldbe used to emulate the various eCos devices. The <TTCLASS="OPTION">-t</TT>option can be used to specify which target definition should be usedfor the current run, defaulting to <TTCLASS="FILENAME">default.tdf</TT>.It is not necessary to include the <TTCLASS="FILENAME">.tdf</TT> suffix,this will be appended automatically if necessary. </P></DD><DT><TTCLASS="OPTION">-geometry <geometry></TT></DT><DD><P>This option can be used to control the size and position of the mainwindow, as per X conventions.⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -