📄 comman69.htm
字号:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<meta name="GENERATOR" content="Quadralay WebWorks Publisher Professional Edition 6.0.5">
<meta name="TEMPLATEBASE" content="book_html">
<meta name="LASTUPDATED" content="12/04/03 16:07:46">
<title>place</title>
<STYLE TYPE="text/css">
<!--
span.Signal { text-transform: uppercase; font-family: Verdana }
-->
</STYLE>
</head>
<body link="#3366CC" vlink="#9999CC" text="#000000" alink="#0000CC" bgcolor="#FFFFFF"
background="images/backgrnd.gif">
<p><img src="images/stlogo.gif" width="106" height="83" align="left"
alt="logo here!"> </p>
<table width="331" border="0" align="right" cellpadding="0" cellspacing="0">
<tr>
<td><a href="a_refman.htm"><img src="images/navtoc.gif" width="84" height="23"
border="0" alt="TOC"> </a></td>
<td><a href="comman68.htm"><img src="images/navprev.gif" width="80" height="23"
border="0" alt="PREV"> </a></td>
<td><a href="comman70.htm"><img src="images/navnext.gif" width="83" height="23"
border="0" alt="NEXT"> </a></td>
<td><a href="a_refmaa.htm"><img src="images/navidx.gif" width="84" height="23"
border="0" alt="INDEX"> </a></td>
</tr>
</table>
<p><br clear="all">
</p>
<hr align="left">
<blockquote>
<h2>
<a name="1207097"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">place</font>
</h2><hr>
<p>
<a name="1267286"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Place code or data section in a specified memory segment</font>
</p>
<h3>
<a name="1207099"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Command type</font>
</h3>
<p>
<a name="1226981"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Code and data placement</font>
</p>
<h3>
<a name="1207101"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Tool environment</font>
</h3>
<p>
<a name="1228081"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><strong>st20cc</strong></font>
</p>
<h3>
<a name="1207102"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Synopsis</font>
</h3>
<a name="1207103"> </a><font size=2 face=Courier><strong>place <font size=2 face=Courier><strong><em>section_name</em></strong></font> <font size=2 face=Courier><strong><em>segment_name</em></strong></font> [<font size=2 face=Courier><strong><em>options</em></strong></font>]<br></strong></font>
<h3>
<a name="1207104"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Arguments</font>
</h3>
<p>
<a name="1224819"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong><em>section_name</em></strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1224821"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">A section to be placed in memory</font>
</dl>
</dl></dl>
<p>
<a name="1224823"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong><em>segment_name</em></strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1224825"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The name of the segment where the section is to be placed</font>
</dl>
</dl></dl>
<h3>
<a name="1207109"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Options</font>
</h3>
<p>
<a name="1236291"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-a[lignment]</strong></font><font size=2 face=Courier><em> </em></font><font size=2 face=Courier><strong><em>num_bytes</em></strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1236310"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Align the section being placed to be <font size=2 face=Courier><strong><em>num_bytes</em></strong></font> aligned within the segment, that is, the section is placed at the next available address divisible by <font size=2 face=Courier><strong><em>num_bytes</em></strong></font>. <font size=2 face=Courier><strong><em>num_bytes</em></strong></font> must be a multiple of four. By default, the section is word aligned.</font>
</dl>
</dl></dl>
<p>
<a name="1230041"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-n[oinit]</strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1230043"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Do not initialize to zero during the boot process. This option is only valid when used in conjunction with a BSS section.</font>
</dl>
</dl></dl>
<p>
<a name="1230045"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-s[egmenttype]</strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1236322"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Place the section in a segment of type <font size=2 face=Courier><strong><em>segment_name</em></strong></font> as defined by the <font size=2 face=Courier><strong>memory</strong></font> command.</font>
</dl>
</dl></dl>
<h3>
<a name="1207116"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Description</font>
</h3>
<p>
<a name="1207117"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The <font size=2 face=Courier><strong>place</strong></font> command is used to place a section in a specified segment. The section is loaded starting at the next available address in the memory segment. The section name can either have been specified in the source code using the <font size=2 face=Courier><strong>ST_section</strong></font> pragma or can be a default section name provided by <strong>st20cc</strong>.</font>
</p>
<p>
<a name="1262676"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><em>Note: <font face="Verdana, Arial, Helvetica, sans-serif"><b>st20cc</b></font> may also create certain additional sections as well as the default and user defined ones in order to implement some functionality.</em></font>
</p>
<p>
<a name="1262720"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><font size=2 face=Courier><strong>place</strong></font> defines the final location of code and data in an application. If code is to be loaded from ROM and executed in RAM then <font size=2 face=Courier><strong>place</strong></font> defines its resting place in RAM. If it is necessary to specify the particular ROM segment from where the code is moved then the <font size=2 face=Courier><strong>store</strong></font> command can be used.</font>
</p>
<p>
<a name="1262722"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><font size=2 face=Courier><strong><em>section_name</em></strong></font> can also be a restricted regular expression. Legal regular expressions in this context:</font>
</p>
<ul>
<p> <font size=2 face="Verdana, Arial, Helvetica, sans-serif"><li ><a name="1262456"> </a>are a subset of standard UNIX regular expressions,</font></p>
<p> <font size=2 face="Verdana, Arial, Helvetica, sans-serif"><li ><a name="1262460"> </a>must match the whole name of the actual section being placed,</font></p>
<p> <font size=2 face="Verdana, Arial, Helvetica, sans-serif"><li ><a name="1262461"> </a>may use the following special characters only:</font></p>
<dl>
<dt> <a name="1262462"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">"<font size=2 face=Courier><strong>( ) | [ ] ^ - . * ? + \</strong></font>".</font>
</dl>
</ul>
<p>
<a name="1262393"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">To place a section name which actually contains any of these characters without doing a regular expression search, escape (backslash) the special characters (so for example "<font size=2 face=Courier><strong>-</strong></font>" would become "<font size=2 face=Courier><strong>\-</strong></font>"). If backslashes are not used, <font size=2 face=Courier><strong>place</strong></font> still places the section correctly, but may also place other sections that match the regular expression. Using regular expression characters in section names is therefore not recommended, as it may cause confusion.</font>
</p>
<p>
<a name="1207119"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The <font face="Verdana, Arial, Helvetica, sans-serif"><b>a[lignment]</b></font> option allows an alignment to be specified when placing a section into a memory segment. The <font face="Verdana, Arial, Helvetica, sans-serif"><b>segmenttype</b></font> option allows a section to be placed in any segment of a given type, as defined by the <font size=2 face=Courier><strong>memory</strong></font> command. A subsequent <font size=2 face=Courier><strong>place</strong></font> command can optionally place the section in a named segment and this overrides the previous placement. If the named segment is of a different type to that specified by the previous <font size=2 face=Courier><strong>place</strong></font> command an error is generated.</font>
</p>
<p>
<a name="1207120"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The <font face="Verdana, Arial, Helvetica, sans-serif"><b>noinit</b></font> option allows the user to override the initialization of a BSS section to all-zero, which occurs at boot time. For example, it may be required to map this data to a peripheral which should not be written to at boot time.</font>
</p>
<h3>
<a name="1207121"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Examples</font>
</h3>
<a name="1207122"> </a><font size=2 face=Courier><strong>place fast_ram DRAM<br></strong></font>
<p>
<a name="1207123"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Places the section <font size=2 face=Courier><strong>fast_ram</strong></font> at the next available slot in the DRAM memory segment.</font>
</p>
<a name="1216600"> </a><font size=2 face=Courier><strong>place fred DRAM -a 64<br></strong></font>
<p>
<a name="1207126"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Places the section called <font size=2 face=Courier><strong>fred</strong></font> into the DRAM memory segment and ensures that the start of the section is aligned on a 64-byte boundary.</font>
</p>
<a name="1207128"> </a><font size=2 face=Courier><strong>place fred_bss SEGNAME -noinit<br></strong></font>
<p>
<a name="1207129"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Places <font size=2 face=Courier><strong>fred_bss</strong></font> into the segment called <font size=2 face=Courier><strong>SEGNAME</strong></font> and ensures that <font size=2 face=Courier><strong>fred_bss</strong></font> is not initialized at boot time.</font>
</p>
<h3>
<a name="1207130"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">See also</font>
</h3>
<p>
<a name="1207134"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><a href="comman59.htm#1206543"><font color="#0000ff" face="Verdana, Arial, Helvetica, sans-serif"><i>memory</i></font></a>, <a href="codedata.htm#1205500"><font color="#0000ff" face="Verdana, Arial, Helvetica, sans-serif"><i>Chapter⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -