201 lines
		
	
	
	
		
			7.5 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
		
		
			
		
	
	
			201 lines
		
	
	
	
		
			7.5 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
| 
								 | 
							
								<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
							 | 
						||
| 
								 | 
							
								<html>
							 | 
						||
| 
								 | 
							
								<!-- Created on November, 7 2008 by texi2html 1.78 -->
							 | 
						||
| 
								 | 
							
								<!--
							 | 
						||
| 
								 | 
							
								Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
							 | 
						||
| 
								 | 
							
								            Karl Berry  <karl@freefriends.org>
							 | 
						||
| 
								 | 
							
								            Olaf Bachmann <obachman@mathematik.uni-kl.de>
							 | 
						||
| 
								 | 
							
								            and many others.
							 | 
						||
| 
								 | 
							
								Maintained by: Many creative people.
							 | 
						||
| 
								 | 
							
								Send bugs and suggestions to <texi2html-bug@nongnu.org>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								-->
							 | 
						||
| 
								 | 
							
								<head>
							 | 
						||
| 
								 | 
							
								<title>Simulavr: 2.2 Options</title>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								<meta name="description" content="Simulavr: 2.2 Options">
							 | 
						||
| 
								 | 
							
								<meta name="keywords" content="Simulavr: 2.2 Options">
							 | 
						||
| 
								 | 
							
								<meta name="resource-type" content="document">
							 | 
						||
| 
								 | 
							
								<meta name="distribution" content="global">
							 | 
						||
| 
								 | 
							
								<meta name="Generator" content="texi2html 1.78">
							 | 
						||
| 
								 | 
							
								<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
							 | 
						||
| 
								 | 
							
								<style type="text/css">
							 | 
						||
| 
								 | 
							
								<!--
							 | 
						||
| 
								 | 
							
								a.summary-letter {text-decoration: none}
							 | 
						||
| 
								 | 
							
								pre.display {font-family: serif}
							 | 
						||
| 
								 | 
							
								pre.format {font-family: serif}
							 | 
						||
| 
								 | 
							
								pre.menu-comment {font-family: serif}
							 | 
						||
| 
								 | 
							
								pre.menu-preformatted {font-family: serif}
							 | 
						||
| 
								 | 
							
								pre.smalldisplay {font-family: serif; font-size: smaller}
							 | 
						||
| 
								 | 
							
								pre.smallexample {font-size: smaller}
							 | 
						||
| 
								 | 
							
								pre.smallformat {font-family: serif; font-size: smaller}
							 | 
						||
| 
								 | 
							
								pre.smalllisp {font-size: smaller}
							 | 
						||
| 
								 | 
							
								span.roman {font-family:serif; font-weight:normal;}
							 | 
						||
| 
								 | 
							
								span.sansserif {font-family:sans-serif; font-weight:normal;}
							 | 
						||
| 
								 | 
							
								ul.toc {list-style: none}
							 | 
						||
| 
								 | 
							
								-->
							 | 
						||
| 
								 | 
							
								</style>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								</head>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								<a name="Options"></a>
							 | 
						||
| 
								 | 
							
								<a name="SEC4"></a>
							 | 
						||
| 
								 | 
							
								<table cellpadding="1" cellspacing="1" border="0">
							 | 
						||
| 
								 | 
							
								<tr><td valign="middle" align="left">[<a href="simulavr_3.html#SEC3" title="Previous section in reading order"> < </a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_5.html#SEC5" title="Next section in reading order"> > </a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">   </td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_2.html#SEC2" title="Beginning of this chapter or previous chapter"> << </a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_2.html#SEC2" title="Up section"> Up </a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_5.html#SEC5" title="Next chapter"> >> </a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">   </td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">   </td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">   </td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">   </td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr.html#Top" title="Cover (top) of document">Top</a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_11.html#SEC11" title="Index">Index</a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
							 | 
						||
| 
								 | 
							
								</tr></table>
							 | 
						||
| 
								 | 
							
								<h2 class="section"> 2.2 Options </h2>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								<p>simulavr supports the following options:
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<dl compact="compact">
							 | 
						||
| 
								 | 
							
								<dd><a name="IDX1"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--help</code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-h</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Print an informative help message describing the options and available
							 | 
						||
| 
								 | 
							
								device types, then exit.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX2"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--debug</code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-D</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Print assembly instruction mnemonics and program counter (‘<samp>PC</samp>’) to
							 | 
						||
| 
								 | 
							
								output as device program is running.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX3"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--version</code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-v</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Print out the version number and exit.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX4"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--gdbserver</code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-g</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Run as a gdbserver process.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX5"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--gdb-debug</code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-G</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Print out messages  for debugging the gdb remote serial protocol interface.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX6"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--port <var><port></var></code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-p</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Listen for gdb connection on TCP port. If not specified, a default will
							 | 
						||
| 
								 | 
							
								be used. Run ‘<samp>simulavr --help</samp>’ to see what the default is. This
							 | 
						||
| 
								 | 
							
								option is ignored if the ‘<samp>--gdbserver</samp>’ is not specified.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX7"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--device <var><dev></var></code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-d</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Specify device type. The device types available for use with a specific
							 | 
						||
| 
								 | 
							
								version of simulavr can be obtained using the ‘<samp>--list-devices</samp>’ option.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX8"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--eeprom-image <var><img></var></code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-e</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Specify an optional eeprom image file to be loaded into the device's
							 | 
						||
| 
								 | 
							
								eeprom memory space.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX9"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--eeprom-type <var><type></var></code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-E</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Specify the type of the eeprom image file. If not specified, the default
							 | 
						||
| 
								 | 
							
								is binary.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX10"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--flash-type <var><type></var></code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-F</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Specify the type of the flash image file. If not specified, the default
							 | 
						||
| 
								 | 
							
								is binary.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX11"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--list-devices</code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-L</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Prints a list of supported devices to stdout and exits.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX12"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--disp-prog <var><prog></var></code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-P</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Specify a program to be used to display register and memory information
							 | 
						||
| 
								 | 
							
								in real time as a child process. The display program can also be
							 | 
						||
| 
								 | 
							
								specified by setting the <code>SIM_DISP_PROG</code> environment variable.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX13"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--without-xterm</code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-X</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Don't start display coprocess program in an xterm.  This is useful if
							 | 
						||
| 
								 | 
							
								the display coprocess supplies it's own window for input and output,
							 | 
						||
| 
								 | 
							
								such as a process which uses a GUI.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX14"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--core-dump</code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-C</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Dump a core memory image to file on exit. This isn't as useful as it
							 | 
						||
| 
								 | 
							
								sounds.  The display coprocess mechanism is much more informative.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX15"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--clock-freq <var><freq></var></code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-c</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Set the simulated mcu clock freqency in Hz.
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								<a name="IDX16"></a>
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								<dt> <code>--breakpoint <var><addr></var></code></dt>
							 | 
						||
| 
								 | 
							
								<dt> <code>-B</code></dt>
							 | 
						||
| 
								 | 
							
								<dd><p>Set a breakpoint at <var><addr></var>.  Note that the break address is
							 | 
						||
| 
								 | 
							
								interpreted as a byte address instead of a word address.  This makes
							 | 
						||
| 
								 | 
							
								it easier on the user since binutils, gcc and gdb all work in terms of
							 | 
						||
| 
								 | 
							
								byte addresses.  The address can be specified in any base (decimal,
							 | 
						||
| 
								 | 
							
								hexidecimal, octal, etc).
							 | 
						||
| 
								 | 
							
								</p> 
							 | 
						||
| 
								 | 
							
								</dd>
							 | 
						||
| 
								 | 
							
								</dl>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								<hr size="6">
							 | 
						||
| 
								 | 
							
								<table cellpadding="1" cellspacing="1" border="0">
							 | 
						||
| 
								 | 
							
								<tr><td valign="middle" align="left">[<a href="simulavr_3.html#SEC3" title="Previous section in reading order"> < </a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_5.html#SEC5" title="Next section in reading order"> > </a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">   </td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_2.html#SEC2" title="Beginning of this chapter or previous chapter"> << </a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_2.html#SEC2" title="Up section"> Up </a>]</td>
							 | 
						||
| 
								 | 
							
								<td valign="middle" align="left">[<a href="simulavr_5.html#SEC5" title="Next chapter"> >> </a>]</td>
							 | 
						||
| 
								 | 
							
								</tr></table>
							 | 
						||
| 
								 | 
							
								<p>
							 | 
						||
| 
								 | 
							
								 <font size="-1">
							 | 
						||
| 
								 | 
							
								  This document was generated by <em>eweddington</em> on <em>November, 7 2008</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.78</em></a>.
							 | 
						||
| 
								 | 
							
								 </font>
							 | 
						||
| 
								 | 
							
								 <br>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								</p>
							 | 
						||
| 
								 | 
							
								</body>
							 | 
						||
| 
								 | 
							
								</html>
							 |