ARM-software
/
CMSIS_5
同期ミラー https://github-proxy.rt-thread.io/ARM-software/CMSIS_5.git


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260
							<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>/cprj/files</title>
<title>CMSIS-Build: /cprj/files</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="cmsis.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<script type="text/javascript" src="printComponentTabs.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
  $(document).ready(initResizable);
  $(window).load(resizeHeight);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
  $(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 46px;">
  <td id="projectlogo"><img alt="Logo" src="CMSIS_Logo_Final.png"/></td>
  <td style="padding-left: 0.5em;">
   <div id="projectname">CMSIS-Build
   &#160;<span id="projectnumber">Version 0.9.0 (beta)</span>
   </div>
   <div id="projectbrief">Tools, software frameworks, and work flows for productivity with CMSIS based projects</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<div id="CMSISnav" class="tabs1">
    <ul class="tablist">
      <script type="text/javascript">
		<!--
		writeComponentTabs.call(this);
		//-->
      </script>
	  </ul>
</div>
<!-- Generated by Doxygen 1.8.6 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li class="current"><a href="pages.html"><span>Usage&#160;and&#160;Description</span></a></li>
      <li>
        <div id="MSearchBox" class="MSearchBoxInactive">
        <span class="left">
          <img id="MSearchSelect" src="search/mag_sel.png"
               onmouseover="return searchBox.OnSearchSelectShow()"
               onmouseout="return searchBox.OnSearchSelectHide()"
               alt=""/>
          <input type="text" id="MSearchField" value="Search" accesskey="S"
               onfocus="searchBox.OnSearchFieldFocus(true)" 
               onblur="searchBox.OnSearchFieldFocus(false)" 
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
          </span><span class="right">
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
          </span>
        </div>
      </li>
    </ul>
  </div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
      <div id="nav-sync" class="sync"></div>
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('element_files.html','');});
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Pages</a></div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div class="header">
  <div class="headertitle">
<div class="title">/cprj/files </div>  </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>The files section specifies files to be included into the project build that are not managed through software components. Files can be associated with a named group. Grouping is mainly for better visualization in a graphical tool, however commandline flags can also be applied on a group level.</p>
<p><b>Example</b> <em>files</em> section: </p>
<div class="fragment"><div class="line">&lt;cprj xmlns:xsi=<span class="stringliteral">&quot;http://www.w3.org/2001/XMLSchema-instance&quot;</span> xsi:noNamespaceSchemaLocation=<span class="stringliteral">&quot;CPRJ.xsd&quot;</span>/&gt;</div>
<div class="line">  ...</div>
<div class="line">  &lt;components&gt;</div>
<div class="line">    ...</div>
<div class="line">  &lt;/components&gt;</div>
<div class="line">  &lt;files&gt;</div>
<div class="line">    &lt;group name=<span class="stringliteral">&quot;Source Files&quot;</span>&gt;</div>
<div class="line">      &lt;file category=<span class="stringliteral">&quot;sourceC&quot;</span> name=<span class="stringliteral">&quot;./Blinky.c&quot;</span>/&gt;</div>
<div class="line">      &lt;file category=<span class="stringliteral">&quot;sourceC&quot;</span> name=<span class="stringliteral">&quot;./Thread_LED.c&quot;</span>/&gt;</div>
<div class="line">    &lt;/group&gt;</div>
<div class="line">    &lt;group name=<span class="stringliteral">&quot;Documentation&quot;</span>&gt;</div>
<div class="line">      &lt;file category=<span class="stringliteral">&quot;doc&quot;</span> name=<span class="stringliteral">&quot;./Abstract.txt&quot;</span>/&gt;</div>
<div class="line">    &lt;/group&gt;</div>
<div class="line">  &lt;/files&gt;</div>
<div class="line">&lt;/cprj&gt;</div>
</div><!-- fragment --><p> <br/>
</p>
<table  class="cmtable" summary="Element: files">
<tr>
<th>Parents </th><th colspan="3">Element Chain  </th></tr>
<tr>
<td><a class="el" href="element_cprj.html">cprj</a> </td><td colspan="3"><a class="el" href="element_cprj.html">/cprj</a>  </td></tr>
<tr>
<th>Child Elements </th><th>Description </th><th>Type </th><th>Occurrence  </th></tr>
<tr>
<td><a class="el" href="element_files.html#element_project_file">file</a> </td><td>Specify a file. </td><td>FileType </td><td>0..*  </td></tr>
<tr>
<td><a class="el" href="element_files.html#element_group">group</a> </td><td>Specify a group name and list member files in subelements. </td><td>GroupType </td><td>0..*  </td></tr>
</table>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_group"></a>
/cprj/files/.../group</h1>
<p>The description format allows the nesting of groups. It is up to the tool's implementation how grouping is represented in the user interface. The grouping of files only impacts the build, if the assignment of command line options on a group level is supported.</p>
<p><b>Example</b> <em>files</em> section: </p>
<div class="fragment"><div class="line">&lt;cprj xmlns:xsi=<span class="stringliteral">&quot;http://www.w3.org/2001/XMLSchema-instance&quot;</span> xsi:noNamespaceSchemaLocation=<span class="stringliteral">&quot;CPRJ.xsd&quot;</span>/&gt;</div>
<div class="line">  ...</div>
<div class="line">  &lt;files&gt;</div>
<div class="line">    &lt;group name=<span class="stringliteral">&quot;Source&quot;</span>&gt;</div>
<div class="line">      &lt;group name=<span class="stringliteral">&quot;C&quot;</span>&gt;</div>
<div class="line">        &lt;cflags add=<span class="stringliteral">&quot;-D_MY_DEFINE&quot;</span>/&gt;</div>
<div class="line">        &lt;file category=<span class="stringliteral">&quot;sourceC&quot;</span> name=<span class="stringliteral">&quot;./Blinky.c&quot;</span>/&gt;</div>
<div class="line">        &lt;file category=<span class="stringliteral">&quot;sourceC&quot;</span> name=<span class="stringliteral">&quot;./Thread_LED.c&quot;</span>/&gt;</div>
<div class="line">      &lt;/group&gt;</div>
<div class="line">      &lt;group name=<span class="stringliteral">&quot;ASM&quot;</span>&gt;</div>
<div class="line">        &lt;file category=<span class="stringliteral">&quot;sourceAsm&quot;</span> name=<span class="stringliteral">&quot;./startup_add.s&quot;</span>/&gt;</div>
<div class="line">      &lt;/group&gt;</div>
<div class="line">    &lt;/group&gt;</div>
<div class="line">    &lt;group name=<span class="stringliteral">&quot;Documentation&quot;</span>&gt;</div>
<div class="line">      &lt;file category=<span class="stringliteral">&quot;doc&quot;</span> name=<span class="stringliteral">&quot;./Abstract.txt&quot;</span>/&gt;</div>
<div class="line">    &lt;/group&gt;</div>
<div class="line">  &lt;/files&gt;</div>
<div class="line">&lt;/cprj&gt;</div>
</div><!-- fragment --><p> <br/>
</p>
<table  class="cmtable" summary="Element: group">
<tr>
<th>Parents </th><th colspan="3">Element Chain  </th></tr>
<tr>
<td><a class="el" href="element_files.html">files</a> </td><td colspan="3"><a class="el" href="element_files.html">/cprj/files</a>  </td></tr>
<tr>
<th>Attributes </th><th>Description </th><th>Type </th><th>Use  </th></tr>
<tr>
<td>name </td><td>name of the group of files </td><td><a class="el" href="cprj_types.html#type_restrictedStringType">RestrictedString</a> </td><td>required  </td></tr>
<tr>
<th>Child Elements </th><th>Description </th><th>Type </th><th>Occurrence  </th></tr>
<tr>
<td><a class="el" href="element_files.html#element_project_file">file</a> </td><td>Specify a file. </td><td>FileType </td><td>0..*  </td></tr>
<tr>
<td><a class="el" href="element_files.html#element_group">group</a> </td><td>Specify a group (nesting). </td><td>GroupType </td><td>0..*  </td></tr>
</table>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_group_cflags"></a>
/cprj/files/group/.../cflags</h1>
<p>These compiler options are either added or removed from the inherited command line and affect all C-modules that belong to the file group. This flag can also be added to components and individual files within the description.</p>
<p>See: <a class="el" href="element_components.html#element_cflags">/cprj/components/component/cflags</a></p>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_group_cxxflags"></a>
/cprj/files/group/.../cxxflags</h1>
<p>These compiler options are either added or removed from the inherited command line and affect all C++-modules that belong to the file group. This flag can also be added to components and individual files within the description.</p>
<p>See: <a class="el" href="element_components.html#element_cxxflags">/cprj/components/component/cxxflags</a></p>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_group_asflags"></a>
/cprj/files/group/.../asflags</h1>
<p>These assembler options are either added or removed from the inherited command line and affect all Assembler modules that belong to the file group. This flag can also be added to components and individual files within the description.</p>
<p>See: <a class="el" href="element_components.html#element_asflags">/cprj/components/component/asflags</a></p>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_project_file"></a>
/cprj/files/.../file</h1>
<p>Specify files that are not included through software components.</p>
<table  class="cmtable" summary="Element: file">
<tr>
<th>Parents </th><th colspan="3">Element Chain  </th></tr>
<tr>
<td><a class="el" href="element_files.html">files</a> </td><td colspan="3"><a class="el" href="element_files.html">/cprj/files</a>  </td></tr>
<tr>
<td><a class="el" href="element_files.html#element_group">group</a> </td><td colspan="3"><a class="el" href="element_files.html#element_group">/cprj/files/.../group</a>  </td></tr>
<tr>
<th>Attributes </th><th>Description </th><th>Type </th><th>Use  </th></tr>
<tr>
<td>name </td><td>Path and name of the file, relative to location of the project file. </td><td>xs:string </td><td>required  </td></tr>
<tr>
<td>category </td><td>Type of file, for example, whether the file is a C or assembler file. Use the predefined values from the table <a class="el" href="cprj_types.html#FileCategoryEnum">File Categories</a>. </td><td>FileCategoryType </td><td>required  </td></tr>
<tr>
<td>src </td><td>Folder specifying the source code location for a library if included in a subdirectory. </td><td>xs:string </td><td>optional  </td></tr>
</table>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_file_cflags"></a>
/cprj/files/.../file/cflags</h1>
<p>These compiler options are either added or removed from the inherited command line and affect the C-modules that is referenced by the file. This flag can also be added to components and file groups within the description. Note: if the file category attribute is anything but 'sourceC' or 'source' and the file's extension is *.c, the element will be ignored.</p>
<p>See: <a class="el" href="element_components.html#element_cflags">/cprj/components/component/cflags</a></p>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_file_cxxflags"></a>
/cprj/files/.../file/cxxflags</h1>
<p>These compiler options are either added or removed from the inherited command line and affect the C++-modules that is referenced by the file. This flag can also be added to components and file groups within the description. Note: if the file category attribute is anything but 'sourceCpp' or 'source' and the file extension is *.cpp, the flag will be ignored.</p>
<p>See: <a class="el" href="element_components.html#element_cxxflags">/cprj/components/component/cxxflags</a></p>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_file_asflags"></a>
/cprj/files/.../file/asflags</h1>
<p>These assembler options are either added or removed from the inherited command line and affect the Assembler module that is referenced by the file. This flag can also be added to components and file groups within the description. Note: if the file category attribute is anything but 'sourceAsm' or 'source' and the file extension is *.s, the flag will be ignored.</p>
<p>See: <a class="el" href="element_components.html#element_asflags">/cprj/components/component/asflags</a></p>
<p>&#160;</p>
<hr/>
 </div></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  <ul>
    <li class="navelem"><a class="el" href="cprjFormat_pg.html">Project Description (*.cprj) Format</a></li><li class="navelem"><a class="el" href="element_cprj.html">/cprj</a></li>
    <li class="footer">Generated on Thu Apr 9 2020 15:49:55 for CMSIS-Build Version 0.9.0 (beta) by Arm Ltd. All rights reserved.
	<!--
    <a href="http://www.doxygen.org/index.html">
    <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.6 
	-->
	</li>
  </ul>
</div>
</body>
</html>