element_components.html 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=9"/>
  6. <title>/cprj/components</title>
  7. <title>CMSIS-Build: /cprj/components</title>
  8. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  9. <link href="cmsis.css" rel="stylesheet" type="text/css" />
  10. <script type="text/javascript" src="jquery.js"></script>
  11. <script type="text/javascript" src="dynsections.js"></script>
  12. <script type="text/javascript" src="printComponentTabs.js"></script>
  13. <link href="navtree.css" rel="stylesheet" type="text/css"/>
  14. <script type="text/javascript" src="resize.js"></script>
  15. <script type="text/javascript" src="navtree.js"></script>
  16. <script type="text/javascript">
  17. $(document).ready(initResizable);
  18. $(window).load(resizeHeight);
  19. </script>
  20. <link href="search/search.css" rel="stylesheet" type="text/css"/>
  21. <script type="text/javascript" src="search/search.js"></script>
  22. <script type="text/javascript">
  23. $(document).ready(function() { searchBox.OnSelectItem(0); });
  24. </script>
  25. </head>
  26. <body>
  27. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  28. <div id="titlearea">
  29. <table cellspacing="0" cellpadding="0">
  30. <tbody>
  31. <tr style="height: 46px;">
  32. <td id="projectlogo"><img alt="Logo" src="CMSIS_Logo_Final.png"/></td>
  33. <td style="padding-left: 0.5em;">
  34. <div id="projectname">CMSIS-Build
  35. &#160;<span id="projectnumber">Version 0.9.0 (beta)</span>
  36. </div>
  37. <div id="projectbrief">Tools, software frameworks, and work flows for productivity with CMSIS based projects</div>
  38. </td>
  39. </tr>
  40. </tbody>
  41. </table>
  42. </div>
  43. <!-- end header part -->
  44. <div id="CMSISnav" class="tabs1">
  45. <ul class="tablist">
  46. <script type="text/javascript">
  47. <!--
  48. writeComponentTabs.call(this);
  49. //-->
  50. </script>
  51. </ul>
  52. </div>
  53. <!-- Generated by Doxygen 1.8.6 -->
  54. <script type="text/javascript">
  55. var searchBox = new SearchBox("searchBox", "search",false,'Search');
  56. </script>
  57. <div id="navrow1" class="tabs">
  58. <ul class="tablist">
  59. <li><a href="index.html"><span>Main&#160;Page</span></a></li>
  60. <li class="current"><a href="pages.html"><span>Usage&#160;and&#160;Description</span></a></li>
  61. <li>
  62. <div id="MSearchBox" class="MSearchBoxInactive">
  63. <span class="left">
  64. <img id="MSearchSelect" src="search/mag_sel.png"
  65. onmouseover="return searchBox.OnSearchSelectShow()"
  66. onmouseout="return searchBox.OnSearchSelectHide()"
  67. alt=""/>
  68. <input type="text" id="MSearchField" value="Search" accesskey="S"
  69. onfocus="searchBox.OnSearchFieldFocus(true)"
  70. onblur="searchBox.OnSearchFieldFocus(false)"
  71. onkeyup="searchBox.OnSearchFieldChange(event)"/>
  72. </span><span class="right">
  73. <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
  74. </span>
  75. </div>
  76. </li>
  77. </ul>
  78. </div>
  79. </div><!-- top -->
  80. <div id="side-nav" class="ui-resizable side-nav-resizable">
  81. <div id="nav-tree">
  82. <div id="nav-tree-contents">
  83. <div id="nav-sync" class="sync"></div>
  84. </div>
  85. </div>
  86. <div id="splitbar" style="-moz-user-select:none;"
  87. class="ui-resizable-handle">
  88. </div>
  89. </div>
  90. <script type="text/javascript">
  91. $(document).ready(function(){initNavTree('element_components.html','');});
  92. </script>
  93. <div id="doc-content">
  94. <!-- window showing the filter options -->
  95. <div id="MSearchSelectWindow"
  96. onmouseover="return searchBox.OnSearchSelectShow()"
  97. onmouseout="return searchBox.OnSearchSelectHide()"
  98. onkeydown="return searchBox.OnSearchSelectKey(event)">
  99. <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>
  100. <!-- iframe showing the search results (closed by default) -->
  101. <div id="MSearchResultsWindow">
  102. <iframe src="javascript:void(0)" frameborder="0"
  103. name="MSearchResults" id="MSearchResults">
  104. </iframe>
  105. </div>
  106. <div class="header">
  107. <div class="headertitle">
  108. <div class="title">/cprj/components </div> </div>
  109. </div><!--header-->
  110. <div class="contents">
  111. <div class="textblock"><p>This element lists all software components that are selected within the Manage Run-Time Environment.</p>
  112. <p><b>Example</b> <em>components</em> section: </p>
  113. <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>
  114. <div class="line"> ...</div>
  115. <div class="line"> &lt;components&gt;</div>
  116. <div class="line"> &lt;component Cvendor=<span class="stringliteral">&quot;ARM&quot;</span> Cclass=<span class="stringliteral">&quot;CMSIS&quot;</span> Cgroup=<span class="stringliteral">&quot;CORE&quot;</span>/&gt;</div>
  117. <div class="line"> &lt;component Cvendor=<span class="stringliteral">&quot;ARM&quot;</span> Cclass=<span class="stringliteral">&quot;Device&quot;</span> Cgroup=<span class="stringliteral">&quot;Startup&quot;</span> Cvariant=<span class="stringliteral">&quot;C Startup&quot;</span>&gt;</div>
  118. <div class="line"> &lt;file category=<span class="stringliteral">&quot;sourceC&quot;</span> name=<span class="stringliteral">&quot;Device/ARM/ARMCM0/Source/startup_ARMCM0.c&quot;</span> attr=<span class="stringliteral">&quot;config&quot;</span> version=<span class="stringliteral">&quot;2.0.0&quot;</span>/&gt;</div>
  119. <div class="line"> &lt;file category=<span class="stringliteral">&quot;sourceC&quot;</span> name=<span class="stringliteral">&quot;Device/ARM/ARMCM0/Source/system_ARMCM0.c&quot;</span> attr=<span class="stringliteral">&quot;config&quot;</span> version=<span class="stringliteral">&quot;2.0.0&quot;</span>/&gt;</div>
  120. <div class="line"> &lt;file category=<span class="stringliteral">&quot;linkerScript&quot;</span> name=<span class="stringliteral">&quot;Device/ARM/ARMCM0/Source/ARM/ARMCM0_ac6.sct&quot;</span> attr=<span class="stringliteral">&quot;config&quot;</span> version=<span class="stringliteral">&quot;1.0.0&quot;</span>/&gt; &lt;component Cclass=<span class="stringliteral">&quot;CMSIS&quot;</span> Cgroup=<span class="stringliteral">&quot;Core&quot;</span> Cvendor=<span class="stringliteral">&quot;ARM&quot;</span> Cversion=<span class="stringliteral">&quot;5.6.0&quot;</span>/&gt;</div>
  121. <div class="line"> &lt;/component&gt;</div>
  122. <div class="line"> &lt;/components&gt;</div>
  123. <div class="line"> ...</div>
  124. <div class="line">&lt;/cprj&gt;</div>
  125. </div><!-- fragment --> <p>&#160;</p>
  126. <hr/>
  127. <table class="cmtable" summary="Element: components">
  128. <tr>
  129. <th>Parents </th><th colspan="3">Element Chain </th></tr>
  130. <tr>
  131. <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>
  132. <tr>
  133. <th>Child Elements </th><th>Description </th><th>Type </th><th>Occurrence </th></tr>
  134. <tr>
  135. <td><a class="el" href="element_components.html#element_component">component</a> </td><td>identify a selected software component and configuration files as well as commandline options specific to this component. </td><td>ComponentType </td><td>1..* </td></tr>
  136. </table>
  137. <p>&#160;</p>
  138. <hr/>
  139. <h1><a class="anchor" id="element_component"></a>
  140. /cprj/components/component</h1>
  141. <p>Identify a software component.</p>
  142. <p><b>Example</b> <em>component</em> element </p>
  143. <div class="fragment"><div class="line">...</div>
  144. <div class="line"> &lt;components&gt;</div>
  145. <div class="line"> &lt;component Cvendor=<span class="stringliteral">&quot;ARM&quot;</span> Cclass=<span class="stringliteral">&quot;CMSIS&quot;</span> Cgroup=<span class="stringliteral">&quot;CORE&quot;</span>/&gt;</div>
  146. <div class="line"> &lt;component Cvendor=<span class="stringliteral">&quot;ARM&quot;</span> Cclass=<span class="stringliteral">&quot;Device&quot;</span> Cgroup=<span class="stringliteral">&quot;Startup&quot;</span> Cvariant=<span class="stringliteral">&quot;C Startup&quot;</span>&gt;</div>
  147. <div class="line"> &lt;file category=<span class="stringliteral">&quot;sourceC&quot;</span> name=<span class="stringliteral">&quot;Device/ARM/ARMCM0/Source/startup_ARMCM0.c&quot;</span> attr=<span class="stringliteral">&quot;config&quot;</span> version=<span class="stringliteral">&quot;2.0.0&quot;</span>/&gt;</div>
  148. <div class="line"> &lt;file category=<span class="stringliteral">&quot;sourceC&quot;</span> name=<span class="stringliteral">&quot;Device/ARM/ARMCM0/Source/system_ARMCM0.c&quot;</span> attr=<span class="stringliteral">&quot;config&quot;</span> version=<span class="stringliteral">&quot;2.0.0&quot;</span>/&gt;</div>
  149. <div class="line"> &lt;file category=<span class="stringliteral">&quot;linkerScript&quot;</span> name=<span class="stringliteral">&quot;Device/ARM/ARMCM0/Source/ARM/ARMCM0_ac6.sct&quot;</span> attr=<span class="stringliteral">&quot;config&quot;</span> version=<span class="stringliteral">&quot;1.0.0&quot;</span>/&gt; &lt;component Cclass=<span class="stringliteral">&quot;CMSIS&quot;</span> Cgroup=<span class="stringliteral">&quot;Core&quot;</span> Cvendor=<span class="stringliteral">&quot;ARM&quot;</span> Cversion=<span class="stringliteral">&quot;5.6.0&quot;</span>/&gt;</div>
  150. <div class="line"> &lt;/component&gt;</div>
  151. <div class="line"> &lt;/components&gt;</div>
  152. <div class="line">...</div>
  153. </div><!-- fragment --><p> <br/>
  154. </p>
  155. <table class="cmtable" summary="Element: component">
  156. <tr>
  157. <th>Parents </th><th colspan="3">Element Chain </th></tr>
  158. <tr>
  159. <td><a class="el" href="element_components.html">components</a> </td><td colspan="3"><a class="el" href="element_components.html">/cprj/components</a> </td></tr>
  160. <tr>
  161. <th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
  162. <tr>
  163. <td>Cvendor </td><td>Vendor name of the component. </td><td>xs:string </td><td>optional </td></tr>
  164. <tr>
  165. <td>Cbundle </td><td>Name of bundle to which the selected component belongs. </td><td>xs:string </td><td>optional </td></tr>
  166. <tr>
  167. <td>Cclass </td><td>Component class name. </td><td>xs:string </td><td>required </td></tr>
  168. <tr>
  169. <td>Cgroup </td><td>Component group name. </td><td>xs:string </td><td>required </td></tr>
  170. <tr>
  171. <td>Csub </td><td>Component sub group name following the taxonomy (string may be empty) </td><td>CsubType </td><td>optional </td></tr>
  172. <tr>
  173. <td>Cvariant </td><td>Name of the variant of the selected component. </td><td>CvariantType </td><td>optional </td></tr>
  174. <tr>
  175. <td>Cversion </td><td>Version of the selected component. Note, a higher version number can be entered in case the matching version is not available. </td><td>ComponentVersionType </td><td>optional </td></tr>
  176. <tr>
  177. <td>Capiversion </td><td>Implemented api version defined for the corresponding Cclass:Cgroup:Csub. Set the value only for components that have an associated <em>&lt;api&gt;</em>. </td><td>ComponentVersionType </td><td>optional </td></tr>
  178. <tr>
  179. <td>instances </td><td>Number of instances created for the component. Set the value only for components that are multi-instance capable. Defaults to <span class="XML-Token">1</span> if not set. </td><td>InstancesType </td><td>optional </td></tr>
  180. <tr>
  181. <td>layer </td><td>Reference to a layer name as specfied by the <a class="el" href="element_layers.html">layers section</a> indicating that this component belongs to the named layer. </td><td>xs:string </td><td>optional </td></tr>
  182. <tr>
  183. <th>Child Elements </th><th>Description </th><th>Type </th><th>Occurrence </th></tr>
  184. <tr>
  185. <td><a class="el" href="element_components.html#element_cflags">cflags</a> </td><td>Specify compiler flags for C-modules contained in this component </td><td>ToolOptionType </td><td>0..1 </td></tr>
  186. <tr>
  187. <td><a class="el" href="element_components.html#element_cxxflags">cxxflags</a> </td><td>Specify compiler flags for C++-modules contained in this component </td><td>ToolOptionType </td><td>0..1 </td></tr>
  188. <tr>
  189. <td><a class="el" href="element_components.html#element_asflags">asflags</a> </td><td>Specify assembler flags for Assembler-modules contained in this component </td><td>ToolOptionType </td><td>0..1 </td></tr>
  190. <tr>
  191. <td><a class="el" href="element_components.html#element_component_file">file</a> </td><td>Specify configuration files from the selected component including version information. The ID for a configuration file is the relative path in the pack it originates from. </td><td>ComponentFileType </td><td>0..* </td></tr>
  192. </table>
  193. <p>&#160;</p>
  194. <hr/>
  195. <h1><a class="anchor" id="element_component_file"></a>
  196. /cprj/components/component/file</h1>
  197. <p>Specify the configuration files for the selected component. These files must already exist in the project folder structure (RTE/&lt;Cclass&gt;[/&lt;Device&gt;]/...) and contain a configuration setup specifically adopted for the project. Providing the version number of the orignal file is mandatory.</p>
  198. <p><b>Example</b> <em>file</em> element </p>
  199. <div class="fragment"><div class="line">...</div>
  200. <div class="line">&lt;components&gt;</div>
  201. <div class="line"> &lt;component Cvendor=<span class="stringliteral">&quot;ARM&quot;</span> Cclass=<span class="stringliteral">&quot;Device&quot;</span> Cgroup=<span class="stringliteral">&quot;Startup&quot;</span> Cvariant=<span class="stringliteral">&quot;C Startup&quot;</span>&gt;</div>
  202. <div class="line"> &lt;file category=<span class="stringliteral">&quot;sourceC&quot;</span> name=<span class="stringliteral">&quot;Device/ARM/ARMCM0/Source/startup_ARMCM0.c&quot;</span> attr=<span class="stringliteral">&quot;config&quot;</span> version=<span class="stringliteral">&quot;2.0.0&quot;</span>/&gt;</div>
  203. <div class="line"> &lt;file category=<span class="stringliteral">&quot;sourceC&quot;</span> name=<span class="stringliteral">&quot;Device/ARM/ARMCM0/Source/system_ARMCM0.c&quot;</span> attr=<span class="stringliteral">&quot;config&quot;</span> version=<span class="stringliteral">&quot;2.0.0&quot;</span>/&gt;</div>
  204. <div class="line"> &lt;file category=<span class="stringliteral">&quot;linkerScript&quot;</span> name=<span class="stringliteral">&quot;Device/ARM/ARMCM0/Source/ARM/ARMCM0_ac6.sct&quot;</span> attr=<span class="stringliteral">&quot;config&quot;</span> version=<span class="stringliteral">&quot;1.0.0&quot;</span>/&gt;</div>
  205. <div class="line"> &lt;/component&gt;</div>
  206. <div class="line"> &lt;component Cclass=<span class="stringliteral">&quot;CMSIS&quot;</span> Cgroup=<span class="stringliteral">&quot;Core&quot;</span> Cvendor=<span class="stringliteral">&quot;ARM&quot;</span> Cversion=<span class="stringliteral">&quot;5.6.0&quot;</span>/&gt;</div>
  207. <div class="line"> ...</div>
  208. <div class="line">&lt;/components&gt;</div>
  209. <div class="line">...</div>
  210. </div><!-- fragment --> <p>&#160;</p>
  211. <hr/>
  212. <table class="cmtable" summary="Element: file">
  213. <tr>
  214. <th>Parents </th><th colspan="3">Element Chain </th></tr>
  215. <tr>
  216. <td><a class="el" href="element_components.html#element_component">component</a> </td><td colspan="3"><a class="el" href="element_components.html#element_component">/cprj/components/component</a> </td></tr>
  217. <tr>
  218. <th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
  219. <tr>
  220. <td>category </td><td>File type, for example <span class="XML-Token">header</span>. Use predefined values from the table <a class="el" href="cprj_types.html#FileCategoryEnum">File Category</a>. </td><td>FileCategoryType </td><td>required </td></tr>
  221. <tr>
  222. <td>attr </td><td>File action attribute, for example <span class="XML-Token">copy</span>. Use predefined values from the table <a class="el" href="cprj_types.html#FileAttributeEnum">File Attribute</a>. </td><td><a class="el" href="cprj_types.html#FileAttributeEnum">FileAttributeType</a> </td><td>optional </td></tr>
  223. <tr>
  224. <td>name </td><td>File path and name within pack the file originates from (configuration file ID) </td><td>xs:string </td><td>required </td></tr>
  225. <tr>
  226. <td>version </td><td>Version of the configuration file being present in the example. </td><td><a class="el" href="cprj_types.html#VersionType">VersionType</a> </td><td>required </td></tr>
  227. </table>
  228. <p>&#160;</p>
  229. <hr/>
  230. <h1><a class="anchor" id="element_cflags"></a>
  231. /cprj/components/component/cflags</h1>
  232. <p>These compiler options are either added or removed from the inherited command line and affect all C modules that belong to the component. This flag can also be added to file groups and individual files within the description.</p>
  233. <p><b>Example</b> <em>cflags</em> element for component </p>
  234. <div class="fragment"><div class="line">&lt;cprj ...&gt;</div>
  235. <div class="line"> ...</div>
  236. <div class="line"> &lt;components&gt;</div>
  237. <div class="line"> ...</div>
  238. <div class="line"> &lt;component Cbundle=<span class="stringliteral">&quot;ARM Compiler&quot;</span> Cclass=<span class="stringliteral">&quot;Compiler&quot;</span> Cgroup=<span class="stringliteral">&quot;Event Recorder&quot;</span> Cvariant=<span class="stringliteral">&quot;DAP&quot;</span> Cvendor=<span class="stringliteral">&quot;Keil&quot;</span>&gt;</div>
  239. <div class="line"> &lt;file attr=<span class="stringliteral">&quot;config&quot;</span> category=<span class="stringliteral">&quot;header&quot;</span> name=<span class="stringliteral">&quot;Config/EventRecorderConf.h&quot;</span> version=<span class="stringliteral">&quot;1.1.0&quot;</span>/&gt;</div>
  240. <div class="line"> &lt;cflags add=<span class="stringliteral">&quot;-D_DISABLE_EVR_&quot;</span>/&gt;</div>
  241. <div class="line"> &lt;/component&gt;</div>
  242. <div class="line"> ...</div>
  243. <div class="line"> &lt;/components&gt;</div>
  244. <div class="line"> ...</div>
  245. <div class="line">&lt;/cprj&gt;</div>
  246. </div><!-- fragment --><table class="cmtable" summary="Element: cflags">
  247. <tr>
  248. <th>Parents </th><th colspan="3">Element Chain </th></tr>
  249. <tr>
  250. <td><a class="el" href="element_components.html#element_component">component</a> </td><td colspan="3"><a class="el" href="element_components.html#element_component">/cprj/components/component</a> </td></tr>
  251. <tr>
  252. <th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
  253. <tr>
  254. <td>compiler </td><td>selects the compiler the command line option string is targeted at. Choose from available list: GCC, AC5, AC6, IAR, Tasking, GHS, Cosmic, G++ </td><td>CompilerEnumType </td><td>required </td></tr>
  255. <tr>
  256. <td>add </td><td>commandline string to be added to the inherited command line for the compiler invoked for C-modules specific to the tool-chain selected by the 'compiler' attribute. </td><td>xs:string </td><td>required </td></tr>
  257. <tr>
  258. <td>remove </td><td>option tokens to be removed from the inherited command line for the compiler invoked for C-modules specific to the tool-chain selected by the 'compiler' attribute. </td><td>xs:string </td><td>required </td></tr>
  259. </table>
  260. <p>&#160;</p>
  261. <hr/>
  262. <h1><a class="anchor" id="element_cxxflags"></a>
  263. /cprj/components/component/cxxflags</h1>
  264. <p>These compiler options are either added or removed from the inherited command line and affect all C++ modules that belong to the component. This flag can also be added to file groups and individual files within the description.</p>
  265. <p><b>Example</b> <em>cxxflags</em> element for component </p>
  266. <div class="fragment"><div class="line">&lt;cprj ...&gt;</div>
  267. <div class="line"> ...</div>
  268. <div class="line"> &lt;components&gt;</div>
  269. <div class="line"> ...</div>
  270. <div class="line"> &lt;component Cbundle=<span class="stringliteral">&quot;ARM Compiler&quot;</span> Cclass=<span class="stringliteral">&quot;Compiler&quot;</span> Cgroup=<span class="stringliteral">&quot;Event Recorder&quot;</span> Cvariant=<span class="stringliteral">&quot;DAP&quot;</span> Cvendor=<span class="stringliteral">&quot;Keil&quot;</span>&gt;</div>
  271. <div class="line"> &lt;file attr=<span class="stringliteral">&quot;config&quot;</span> category=<span class="stringliteral">&quot;header&quot;</span> name=<span class="stringliteral">&quot;Config/EventRecorderConf.h&quot;</span> version=<span class="stringliteral">&quot;1.1.0&quot;</span>/&gt;</div>
  272. <div class="line"> &lt;cxxflags add=<span class="stringliteral">&quot;-D_DISABLE_EVR_&quot;</span>/&gt;</div>
  273. <div class="line"> &lt;/component&gt;</div>
  274. <div class="line"> ...</div>
  275. <div class="line"> &lt;/components&gt;</div>
  276. <div class="line"> ...</div>
  277. <div class="line">&lt;/cprj&gt;</div>
  278. </div><!-- fragment --><table class="cmtable" summary="Element: cxxflags">
  279. <tr>
  280. <th>Parents </th><th colspan="3">Element Chain </th></tr>
  281. <tr>
  282. <td><a class="el" href="element_components.html#element_component">component</a> </td><td colspan="3"><a class="el" href="element_components.html#element_component">/cprj/components/component</a> </td></tr>
  283. <tr>
  284. <th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
  285. <tr>
  286. <td>compiler </td><td>selects the compiler the command line option string is targeted at. Choose from available list: GCC, AC5, AC6, IAR, Tasking, GHS, Cosmic, G++ </td><td>CompilerEnumType </td><td>required </td></tr>
  287. <tr>
  288. <td>add </td><td>commandline string to be added to the inherited command line for the compiler invoked for C++-modules specific to the tool-chain selected by the 'compiler' attribute. </td><td>xs:string </td><td>required </td></tr>
  289. <tr>
  290. <td>remove </td><td>option tokens to be removed from the inherited command line for the compiler invoked for C++-modules specific to the tool-chain selected by the 'compiler' attribute. </td><td>xs:string </td><td>required </td></tr>
  291. </table>
  292. <p>&#160;</p>
  293. <hr/>
  294. <h1><a class="anchor" id="element_asflags"></a>
  295. /cprj/components/component/asflags</h1>
  296. <p>These assembler options are either added or removed from the inherited command line and affect all Assembler modules that belong to the component. This flag can also be added to file groups and individual files within the description.</p>
  297. <p><b>Example</b> <em>asflags</em> element for component </p>
  298. <div class="fragment"><div class="line">&lt;cprj ...&gt;</div>
  299. <div class="line"> ...</div>
  300. <div class="line"> &lt;components&gt;</div>
  301. <div class="line"> ...</div>
  302. <div class="line"> &lt;component Cbundle=<span class="stringliteral">&quot;ARM Compiler&quot;</span> Cclass=<span class="stringliteral">&quot;Compiler&quot;</span> Cgroup=<span class="stringliteral">&quot;Event Recorder&quot;</span> Cvariant=<span class="stringliteral">&quot;DAP&quot;</span> Cvendor=<span class="stringliteral">&quot;Keil&quot;</span>&gt;</div>
  303. <div class="line"> &lt;file attr=<span class="stringliteral">&quot;config&quot;</span> category=<span class="stringliteral">&quot;header&quot;</span> name=<span class="stringliteral">&quot;Config/EventRecorderConf.h&quot;</span> version=<span class="stringliteral">&quot;1.1.0&quot;</span>/&gt;</div>
  304. <div class="line"> &lt;asflags <span class="keyword">remove</span>=<span class="stringliteral">&quot;-xref&quot;</span>/&gt;</div>
  305. <div class="line"> &lt;/component&gt;</div>
  306. <div class="line"> ...</div>
  307. <div class="line"> &lt;/components&gt;</div>
  308. <div class="line"> ...</div>
  309. <div class="line">&lt;/cprj&gt;</div>
  310. </div><!-- fragment --><table class="cmtable" summary="Element: asflags">
  311. <tr>
  312. <th>Parents </th><th colspan="3">Element Chain </th></tr>
  313. <tr>
  314. <td><a class="el" href="element_components.html#element_component">component</a> </td><td colspan="3"><a class="el" href="element_components.html#element_component">/cprj/components/component</a> </td></tr>
  315. <tr>
  316. <th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
  317. <tr>
  318. <td>compiler </td><td>selects the compiler the command line option string is targeted at. Choose from available list: GCC, AC5, AC6, IAR, Tasking, GHS, Cosmic, G++ </td><td>CompilerEnumType </td><td>required </td></tr>
  319. <tr>
  320. <td>add </td><td>commandline string to be added to the inherited command line for the compiler invoked for C++-modules specific to the tool-chain selected by the 'compiler' attribute. </td><td>xs:string </td><td>required </td></tr>
  321. <tr>
  322. <td>remove </td><td>option tokens to be removed from the inherited command line for the compiler invoked for C++-modules specific to the tool-chain selected by the 'compiler' attribute. </td><td>xs:string </td><td>required </td></tr>
  323. </table>
  324. <p>&#160;</p>
  325. <hr/>
  326. </div></div><!-- contents -->
  327. </div><!-- doc-content -->
  328. <!-- start footer part -->
  329. <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  330. <ul>
  331. <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>
  332. <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.
  333. <!--
  334. <a href="http://www.doxygen.org/index.html">
  335. <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.6
  336. -->
  337. </li>
  338. </ul>
  339. </div>
  340. </body>
  341. </html>