begriffs open source - cmsis/blob - main/Toolbox/html/index.html

   1 <!-- HTML header for doxygen 1.9.6-->
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
   4 <head>
   5 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
   6 <meta http-equiv="X-UA-Compatible" content="IE=11"/>
   7 <meta name="viewport" content="width=device-width, initial-scale=1"/>
   8 <title>CMSIS-Toolbox: CMSIS-Toolbox</title>
   9 <link href="doxygen.css" rel="stylesheet" type="text/css"/>
  10 <link href="tabs.css" rel="stylesheet" type="text/css"/>
  11 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
  12 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
  13 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
  14 <script type="text/javascript" src="jquery.js"></script>
  15 <script type="text/javascript" src="dynsections.js"></script>
  16 <script type="text/javascript" src="printComponentTabs.js"></script>
  17 <script type="text/javascript" src="footer.js"></script>
  18 <script type="text/javascript" src="navtree.js"></script>
  19 <link href="navtree.css" rel="stylesheet" type="text/css"/>
  20 <script type="text/javascript" src="resize.js"></script>
  21 <script type="text/javascript" src="navtreedata.js"></script>
  22 <script type="text/javascript" src="navtree.js"></script>
  23 <link href="search/search.css" rel="stylesheet" type="text/css"/>
  24 <script type="text/javascript" src="search/searchdata.js"></script>
  25 <script type="text/javascript" src="search/search.js"></script>
  26 <script type="text/javascript">
  27 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  28   $(document).ready(function() { init_search(); });
  29 /* @license-end */
  30 </script>
  31 <script type="text/javascript" src="darkmode_toggle.js"></script>
  32 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
  33 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
  34 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
  35 <link href="version.css" rel="stylesheet" type="text/css" />
  36 <script type="text/javascript" src="../../version.js"></script>
  37 </head>
  38 <body>
  39 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  40 <div id="titlearea">
  41 <table cellspacing="0" cellpadding="0">
  42  <tbody>
  43  <tr style="height: 55px;">
  44   <td id="projectlogo" style="padding: 1.5em;"><img alt="Logo" src="cmsis_logo_white_small.png"/></td>
  45   <td style="padding-left: 1em; padding-bottom: 1em;padding-top: 1em;">
  46    <div id="projectname">CMSIS-Toolbox
  47    </div>
  48    <div id="projectbrief">Command line tools for project build with packs</div>
  49   </td>
  50    <td>        <div id="MSearchBox" class="MSearchBoxInactive">
  51         <span class="left">
  52           <span id="MSearchSelect"                onmouseover="return searchBox.OnSearchSelectShow()"                onmouseout="return searchBox.OnSearchSelectHide()">&#160;</span>
  53           <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
  54                onfocus="searchBox.OnSearchFieldFocus(true)"
  55                onblur="searchBox.OnSearchFieldFocus(false)"
  56                onkeyup="searchBox.OnSearchFieldChange(event)"/>
  57           </span><span class="right">
  58             <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
  59           </span>
  60         </div>
  61 </td>
  62   <!--END !PROJECT_NAME-->
  63  </tr>
  64  </tbody>
  65 </table>
  66 </div>
  67 <!-- end header part -->
  68 <div id="CMSISnav" class="tabs1">
  69   <ul class="tablist">
  70     <script type="text/javascript">
  71       writeComponentTabs.call(this);
  72     </script>
  73   </ul>
  74 </div>
  75 <!-- Generated by Doxygen 1.9.6 -->
  76 <script type="text/javascript">
  77 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  78 var searchBox = new SearchBox("searchBox", "search/",'.html');
  79 /* @license-end */
  80 </script>
  81 </div><!-- top -->
  82 <div id="side-nav" class="ui-resizable side-nav-resizable">
  83   <div id="nav-tree">
  84     <div id="nav-tree-contents">
  85       <div id="nav-sync" class="sync"></div>
  86     </div>
  87   </div>
  88   <div id="splitbar" style="-moz-user-select:none;"
  89        class="ui-resizable-handle">
  90   </div>
  91 </div>
  92 <script type="text/javascript">
  93 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  94 $(document).ready(function(){initNavTree('index.html',''); initResizable(); });
  95 /* @license-end */
  96 </script>
  97 <div id="doc-content">
  98 <!-- window showing the filter options -->
  99 <div id="MSearchSelectWindow"
 100      onmouseover="return searchBox.OnSearchSelectShow()"
 101      onmouseout="return searchBox.OnSearchSelectHide()"
 102      onkeydown="return searchBox.OnSearchSelectKey(event)">
 103 </div>
 104
 105 <!-- iframe showing the search results (closed by default) -->
 106 <div id="MSearchResultsWindow">
 107 <div id="MSearchResults">
 108 <div class="SRPage">
 109 <div id="SRIndex">
 110 <div id="SRResults"></div>
 111 <div class="SRStatus" id="Loading">Loading...</div>
 112 <div class="SRStatus" id="Searching">Searching...</div>
 113 <div class="SRStatus" id="NoMatches">No Matches</div>
 114 </div>
 115 </div>
 116 </div>
 117 </div>
 118
 119 <div><div class="header">
 120   <div class="headertitle"><div class="title">CMSIS-Toolbox </div></div>
 121 </div><!--header-->
 122 <div class="contents">
 123 <div class="textblock"><p><a class="anchor" id="mainpage"></a> The <b>CMSIS-Toolbox</b> provides command-line tools for:</p>
 124 <ul>
 125 <li>Project creation and build of embedded applications utilizing <a href="https://www.keil.arm.com/packs/">Software Packs</a> with support for multiple compilation tools.</li>
 126 <li>Software Pack creation, maintenance, and distribution utilizing the <a href="https://open-cmsis-pack.github.io/Open-CMSIS-Pack-Spec/main/html/index.html">CMSIS-Pack format</a>.</li>
 127 </ul>
 128 <h1><a class="anchor" id="autotoc_md0"></a>
 129 Access to CMSIS-Toolbox</h1>
 130 <ul>
 131 <li><a href="https://github.com/Open-CMSIS-Pack/cmsis-toolbox/releases"><b>CMSIS-Toolbox GitHub Repo</b></a> - direct access to the release versions for the tools.</li>
 132 <li>[<b>vcpkg</b>](todo) - uses the Arm tools artifactory for consistent installation of development tools.</li>
 133 </ul>
 134 <h1><a class="anchor" id="autotoc_md1"></a>
 135 Project Creation</h1>
 136 <p>The following tools support the creation of build information for embedded applications:</p>
 137 <table class="markdownTable">
 138 <tr class="markdownTableHead">
 139 <th class="markdownTableHeadLeft">Tool   </th><th class="markdownTableHeadLeft">Description    </th></tr>
 140 <tr class="markdownTableRowOdd">
 141 <td class="markdownTableBodyLeft"><b>cpackget</b>   </td><td class="markdownTableBodyLeft"><b>Pack Manager:</b> install and manage software packs in the development environment.    </td></tr>
 142 <tr class="markdownTableRowEven">
 143 <td class="markdownTableBodyLeft"><b>csolution</b>   </td><td class="markdownTableBodyLeft"><b>Project Manager:</b> create build information for embedded applications that consist of one or more related projects.    </td></tr>
 144 <tr class="markdownTableRowOdd">
 145 <td class="markdownTableBodyLeft"><b>cbuild</b>   </td><td class="markdownTableBodyLeft"><b>Build Invocation:</b> orchestrate the build steps utilizing CMSIS tools and a CMake compilation process.   </td></tr>
 146 </table>
 147 <p>The build information is defined with <b>User Input Files</b> in YAML format. It starts with a <code>*.csolution.yml</code> file that refers related, but independent projects defined with <code>*.cproject.yml</code> files. A <code>*.cproject.yml</code> may refer one or more <code>*.clayer.yml</code> files that define re-usable project parts that may be shared across projects.</p>
 148 <p>The build information can refer to <b>Software Packs</b> that define Device and Board information and provide access to re-usable software components such as drivers and middleware. A <code>cdefault.yml</code> file provides a common setup for various compilers and generic translation controls enable compiler agonistic projects; compiler toolchain specific controls may be used when required.</p>
 149 <p>The <b>Output Files</b> contain detailed build information and manage the configuration files for software components.</p>
 150 <p>The diagram below provides an overview of the <b>build information</b> used by the CMSIS-Toolbox.</p>
 151 <div class="image">
 152 <img src="csolution-overview.png" alt=""/>
 153 <div class="caption">
 154 Overview of Project Definition</div></div>
 155     <h2><a class="anchor" id="autotoc_md2"></a>
 156 Benefits</h2>
 157 <ul>
 158 <li>Flexible CLI tools that can be used stand-alone or integrated into <a href="https://marketplace.visualstudio.com/items?itemName=Arm.keil-studio-pack">VS Code</a> or DevOps systems for Continuous Integration (CI).</li>
 159 <li>Stand-alone tools that are available for all host platforms (Windows, Mac, Linux) and flexible deployable.</li>
 160 <li><a href="https://www.keil.arm.com/packs/">Software Packs</a> simplify tool setup with <code>device:</code> or <code>board:</code> selection and project creation with access to reusable software components.</li>
 161 <li>Organize solutions with projects that are independently managed simplifies a wide range of use cases including multi-processor applications or unit testing.</li>
 162 <li>Provisions for product lifecycle management (PLM) with versioned software packs that are easy to update and management for configuration files.</li>
 163 <li>Software layers enable code reuse across similar applications with a pre-configured set of source files and software components.</li>
 164 <li>Multiple hardware targets allow application deployment to different hardware (test board, production hardware, virtual hardware, etc.).</li>
 165 <li>Multiple build types support software testing and verification (debug build, test build, release build, ect.).</li>
 166 </ul>
 167 <h1><a class="anchor" id="autotoc_md3"></a>
 168 Software Pack Creation</h1>
 169 <p>The following tools support the creation of Software Packs in <a href="https://open-cmsis-pack.github.io/Open-CMSIS-Pack-Spec/main/html/index.html">CMSIS-Pack format</a>:</p>
 170 <table class="markdownTable">
 171 <tr class="markdownTableHead">
 172 <th class="markdownTableHeadLeft">Tool   </th><th class="markdownTableHeadLeft">Description    </th></tr>
 173 <tr class="markdownTableRowOdd">
 174 <td class="markdownTableBodyLeft"><b>packchk</b>   </td><td class="markdownTableBodyLeft"><b>Pack Validation:</b> installs and manages software packs in the local development environment.    </td></tr>
 175 <tr class="markdownTableRowEven">
 176 <td class="markdownTableBodyLeft"><b>svdconv</b>   </td><td class="markdownTableBodyLeft"><b>SVD Check / Convert:</b> validate and/or convert System View Description (SVD) files.   </td></tr>
 177 </table>
 178 <p>In addition several scripts are provided that simplify pack creation with desktop or cloud workflows. This is described in several hands-on tutorials:</p>
 179 <table class="markdownTable">
 180 <tr class="markdownTableHead">
 181 <th class="markdownTableHeadLeft">Hands-on Tutorial   </th><th class="markdownTableHeadLeft">Description    </th></tr>
 182 <tr class="markdownTableRowOdd">
 183 <td class="markdownTableBodyLeft"><a href="https://github.com/Open-CMSIS-Pack/SW-Pack-HandsOn"><b>SW-Pack-HandsOn</b></a>   </td><td class="markdownTableBodyLeft">Explains the steps to create a simple software pack using the Open-CMSIS-Pack technology.    </td></tr>
 184 <tr class="markdownTableRowEven">
 185 <td class="markdownTableBodyLeft"><a href="https://github.com/Open-CMSIS-Pack/DFP-Pack-HandsOn"><b>DFP-Pack-HandsOn</b></a>   </td><td class="markdownTableBodyLeft">Explains the structure and creation of a Device Family Pack (DFP).    </td></tr>
 186 <tr class="markdownTableRowOdd">
 187 <td class="markdownTableBodyLeft"><a href="https://github.com/Open-CMSIS-Pack/DFP-Pack-HandsOn"><b>BSP-Pack-HandsOn</b></a>   </td><td class="markdownTableBodyLeft">Explains the structure and creation of a Board Support Pack (BSP).   </td></tr>
 188 </table>
 189 </div></div><!-- PageDoc -->
 190 </div><!-- contents -->
 191 </div><!-- doc-content -->
 192 <!-- start footer part -->
 193 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
 194   <ul>
 195     <li class="footer">
 196       <script type="text/javascript">
 197         <!--
 198         writeFooter.call(this);
 199         //-->
 200       </script>
 201     </li>
 202   </ul>
 203 </div>
 204 </body>
 205 </html>