ARM-software
/
CMSIS_5
mirrorاز https://github-proxy.rt-thread.io/ARM-software/CMSIS_5.git


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263
							<!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>cbuildgen: Build Process Manager</title>
<title>CMSIS-Build: cbuildgen: Build Process Manager</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('cbuildgen.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">cbuildgen: Build Process Manager </div>  </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>The <a class="el" href="cbuildgen.html">cbuildgen</a> is the core tool for the build process. It is called from the <b>Bash</b> command line with the following syntax:</p>
<div class="fragment"><div class="line">cbuildgen &lt;command&gt; &lt;ProjectFile&gt;.cprj [options]</div>
</div><!-- fragment --><p><b>Where:</b></p>
<p><code>cbuildgen</code> is the name of tool.</p>
<p>&lt;<code>command&gt;</code> specifies the operation of <code>cbuildgen</code> (see table below). Only one command is permitted per invocation.</p>
<p>&lt;<code>ProjectFile&gt;</code> is the name of the project file. The file extension (.cprj) is mandatory.</p>
<p>[<code>options</code>] are additional parameters that control the operation (see table below). Note: available options are specific for each command.</p>
<p><b>Commands</b> </p>
<table  class="cmtable" summary="cbuildgen commands">
<tr>
<th style="min-width:100px">&lt;command&gt; </th><th style="min-width:185px">Description </th><th style="min-width:175px">Details  </th></tr>
<tr>
<td>packlist </td><td>List missing packs </td><td>Check the current list of installed packs in the directory <code>$CMSIS_PACK_ROOT</code>. The URLs of missing packs are written to &lt;ProjectFile&gt;.cp_install file.  </td></tr>
<tr>
<td>make </td><td>Generate makefile(s) </td><td>Generates &lt;ProjectFile&gt;.mak for <a class="el" href="Make.html">Make</a> required to build the project. When used with option &ndash;merge it generates also &lt;ProjectFile&gt;_cfg.mak for <a class="el" href="Make.html">Make</a> to update configuration files. This command also generates a ASCII log file &lt;ProjectFile&gt;.clog recording location and version of the selected toolchain, packs, components and config files. The option &ndash;output specifies the destination folder of the generated files. The location of the &lt;ProjectFile&gt;.cprj is used if &ndash;output is not specified.   </td></tr>
<tr>
<td>extract </td><td>Extract layer from project </td><td>Creates a sub directory named <code></code>./Layer/&lt;layername&gt;/ for each layer described in &lt;ProjectFile&gt;.cprj. These folders contain a layer description file &lt;layername&gt;.clayer and the project and configuration files belonging to the layer. The option &ndash;layer=&lt;layname&gt; selects a specific layer by name. This option can be specified multiple times to select multiple layers.   </td></tr>
<tr>
<td>remove </td><td>Remove layer from project </td><td>Updates the &lt;ProjectFile&gt;.cprj removing the layer description as well as all associated files and components for the layers specified at the command line. The command deletes the associated files from the respecctive project directory. The option &ndash;layer=&lt;layname&gt; selects a specific layer by name and is mandatory. This option can be specified multiple times to remove multiple layers.   </td></tr>
<tr>
<td>compose </td><td>Create new project </td><td>Create new &lt;ProjectFile&gt;.cprj from layer files ([...]&lt;layername&gt;.clayer) as well as copying associated files. One or more clayer files are required.   </td></tr>
<tr>
<td>add </td><td>Add layer to project </td><td>Updates the &lt;ProjectFile&gt;.cprj adding the layer description as well as all associated files and components for the clayer files specified at the command line. The command copies the associated files from the layer directory into the project directory. One or more clayer files are required.   </td></tr>
</table>
<p><b>Options</b> </p>
<table  class="cmtable" summary="cbuildgen options">
<tr>
<th style="min-width:100px">[option] </th><th style="min-width:175px">Description </th><th style="min-width:175px">Details  </th></tr>
<tr>
<td>--merge </td><td>Update configuration files </td><td>When used with the command <code>make</code>, it generates also &lt;ProjectFile&gt;_cfg.mak for <a class="el" href="Make.html">Make</a> to update configuration files using <a class="el" href="ccmerge.html">ccmerge: Config File Updater</a> (used by command: make).   </td></tr>
<tr>
<td>--toolchain=&lt;compiler&gt; </td><td>Specify toolchain </td><td>For projects that can be build with multiple toolchains, it defines the toolchain for the build (used by command: make).  </td></tr>
<tr>
<td>--output=&lt;directory&gt; </td><td>Specify output directory </td><td>Specifies the directory for the generated files <b>*.mak</b> files and the base directory for intermediate output from build. (used by command: make).  </td></tr>
<tr>
<td>--layer=&lt;layername&gt; </td><td>Specify layer name </td><td>Specifies the name of the layer (used by commands: remove and extract).  </td></tr>
<tr>
<td>&lt;directory&gt;/&lt;layername&gt;.clayer </td><td>Specify layer file </td><td>Specifies the directory and filename of the project layer (used by commands: add and compose). </td></tr>
</table>
<p>The <a class="el" href="cbuildgen.html">cbuildgen: Build Process Manager</a> uses information from the CMSIS project file *.cprj, software packs, and environment variables.</p>
<ul>
<li>The *.cprj file lists all software packs (optionally with version), configuration files, and user files along with toolchain specific options.</li>
<li>The software packs are used to get source and include files of software components. The location of software packs is defined with the environment variable $CMSIS_PACK_ROOT.</li>
<li>The version of configuration files is specified in project file *.cprj and related software packs are used to update it.</li>
<li>Device information is read from the device family pack (DFP) that defines the device.</li>
<li>Command line options for a toolchain is used from the <b>&lt;name&gt;.&lt;version&gt;.mak</b> file, if not present in the project file directory, the $CMSIS_COMPILER_ROOT is used.</li>
</ul>
<p>The &lt;ProjectFile&gt;.mak file includes two additional makefiles:</p>
<ul>
<li>include ${CMSIS_BUILD_ROOT}/etc/Whitespace.mak for handling of white space characters in filenames.</li>
<li>include ${CMSIS_COMPILER_ROOT}/&lt;name&gt;.&lt;version&gt;.mak that specifies default options for the toolchain.</li>
</ul>
<p>Note: cbuildgen does not update the *.cprj for commands packlist, make and extract. The merge tool updates the outdated configuration files with new merged data, keeping a copy of the original file.</p>
<h1><a class="anchor" id="cbuild_example"></a>
Usage Example</h1>
<pre class="fragment">$ cbuildgen packlist Simulation.cprj
(cbuildgen): Build Process Manager 0.9.0 (C) 2020 ARM
M654: URL 'http://www.keil.com/pack/ARM.CMSIS.5.6.0.pack' was added to the list of missing packages.
M654: URL 'http://www.keil.com/pack/Keil.ARM_Compiler.1.6.1.pack' was added to the list of missing packages.
M650: Command completed successfully.

$ cbuildgen make Simulation.cprj
(cbuildgen): Build Process Manager 0.9.0 (C) 2020 ARM
M651: Generated makefile for merging config files: 'Simulation_cfg.mak'
M652: Generated makefile for project build:'Simulation.mak'
</pre><h1><a class="anchor" id="cbuildgen_errors"></a>
Error Messages</h1>
<table  class="cmtable" summary="cbuildgen invocation messages">
<tr>
<th>Message Number </th><th>Type </th><th>Description </th><th>Action  </th></tr>
<tr>
<td>M200 </td><td>ERROR </td><td>Invalid arguments! </td><td>At least one argument is wrong. See usage and correct the argument.  </td></tr>
<tr>
<td>M201 </td><td>ERROR </td><td>Too many arguments! </td><td>There is more arguments passed than allowed. See usage and correct the command line. </td></tr>
<tr>
<td>M202 </td><td>ERROR </td><td>No CPRJ input file was specified </td><td>A *.cprj file is not provided as an argument.   </td></tr>
<tr>
<td>M203 </td><td>ERROR </td><td>Error reading file(s) ...! </td><td>The listed file could not be read. Check file content.  </td></tr>
<tr>
<td>M204 </td><td>ERROR </td><td>File not found: ...! </td><td>The listed file was not found.  </td></tr>
<tr>
<td>M205 </td><td>ERROR </td><td>$CMSIS_PACK_ROOT environment variable is not defined! </td><td>The tool requires the environment variable $CMSIS_PACK_ROOT to locate the CMSIS Packs.  </td></tr>
<tr>
<td>M206 </td><td>ERROR </td><td>No command was specified! </td><td>The tool requires a command. See usage information for available commands (e.g. config, make)  </td></tr>
<tr>
<td>M207 </td><td>ERROR </td><td>Multiple commands were specified! </td><td>More than one command was provided in arguments. A single command is required.  </td></tr>
<tr>
<td>M208 </td><td>ERROR </td><td>Error copying file ...! </td><td>The specified file could not be copied and will be missing during build.  </td></tr>
<tr>
<td>M500 </td><td>ERROR </td><td>RTE Model reports: <em>MSG</em> </td><td>Error while preparing data. See message for more details.  </td></tr>
<tr>
<td>M502 </td><td>ERROR </td><td>RTE Model reports: <em>#error NUM: NAME : MSG</em> </td><td>Additional software components required.  </td></tr>
<tr>
<td>M504 </td><td>ERROR </td><td>RTE Model reports: MISSING: – <em>SPACE NAME</em> </td><td>Add the missing component.  </td></tr>
<tr>
<td>M600 </td><td>ERROR </td><td>Package index was not found in 'PATH/.Web </td><td>Check the package repository.  </td></tr>
<tr>
<td>M601 </td><td>ERROR </td><td>Package 'VENDOR.NAME' was not found in package index! </td><td>Check the package repository.  </td></tr>
<tr>
<td>M602 </td><td>ERROR </td><td>Package 'VENDOR.NAME.VER' was not found! </td><td>Check the package repository.  </td></tr>
<tr>
<td>M603 </td><td>ERROR </td><td>No version of package 'VENDOR.NAME' was found! </td><td>Check the package repository.  </td></tr>
<tr>
<td>M604 </td><td>ERROR </td><td>Unresolved package component: 'CMP' </td><td>Check project description file.  </td></tr>
<tr>
<td>M605 </td><td>ERROR </td><td>Wrong CPRJ specification! </td><td>Check project description file.  </td></tr>
<tr>
<td>M606 </td><td>ERROR </td><td>Device 'DEV (VENDOR)' was not found! </td><td>Check project description file.  </td></tr>
<tr>
<td>M607 </td><td>ERROR </td><td>RTE Model construction failed! </td><td>The CMSIS-Pack engine reports an error message.  </td></tr>
<tr>
<td>M608 </td><td>ERROR </td><td>No toolchain configuration file for 'NAME' version 'VER" was found! </td><td>Check CMSIS_COMPILER_ROOT or add the required toolchain configuration file to the project directory.  </td></tr>
<tr>
<td>M609 </td><td>ERROR </td><td>Missing 'NAME' element in CPRJ file! </td><td>Check project description file.  </td></tr>
<tr>
<td>M610 </td><td>ERROR </td><td>Project supports multiple toolchains. Select one with the option &ndash;toolchain </td><td>See usage and correct the argument.  </td></tr>
<tr>
<td>M611 </td><td>ERROR </td><td>Selected toolchain is not supported by the project </td><td>Check project description file or command line arguments.  </td></tr>
<tr>
<td>M630 </td><td>WARNING </td><td>Device ... is substituted by device variant ... . </td><td>Instead of the device specified by the project a variant found for this device is used.  </td></tr>
<tr>
<td>M650 </td><td>INFO </td><td>Setup run successfully </td><td>For information only./td&gt;  </td></tr>
<tr>
<td>M651 </td><td>INFO </td><td>Generated makefile for merging config files: ...  </td><td>For information only.  </td></tr>
<tr>
<td>M652 </td><td>INFO </td><td>Generated makefile for project build:'NAME%.mak' </td><td>For information only.  </td></tr>
<tr>
<td>M653 </td><td>INFO </td><td>Local config file ... was not found. Copying default file from package. </td><td>Please validate whether the config file is intentionally missing. The default config file may be missing project specific settings.  </td></tr>
<tr>
<td>M654 </td><td>INFO </td><td>URL ... was added to the list of missing packages. </td><td>For information only.  </td></tr>
<tr>
<td>M655 </td><td>INFO </td><td>CMSIS_COMPILER_ROOT environment variable was not set! </td><td>For information only.  </td></tr>
<tr>
<td>M656 </td><td>INFO </td><td>Package 'VENDOR.NAME.VER' was found in local repository 'PATH'! </td><td>For information only.  </td></tr>
</table>
</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="CmdLineBuild.html">Command Line Build</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>