begriffs open source - cmsis/blob - main/General/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: Introduction</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
  47    &#160;<span id="projectnumber"><script type="text/javascript">
  48      <!--
  49      writeHeader.call(this);
  50      writeVersionDropdown.call(this, "CMSIS");
  51      //-->
  52     </script>
  53    </span>
  54    </div>
  55    <div id="projectbrief">Common Microcontroller Software Interface Standard</div>
  56   </td>
  57    <td>        <div id="MSearchBox" class="MSearchBoxInactive">
  58         <span class="left">
  59           <span id="MSearchSelect"                onmouseover="return searchBox.OnSearchSelectShow()"                onmouseout="return searchBox.OnSearchSelectHide()">&#160;</span>
  60           <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
  61                onfocus="searchBox.OnSearchFieldFocus(true)"
  62                onblur="searchBox.OnSearchFieldFocus(false)"
  63                onkeyup="searchBox.OnSearchFieldChange(event)"/>
  64           </span><span class="right">
  65             <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
  66           </span>
  67         </div>
  68 </td>
  69   <!--END !PROJECT_NAME-->
  70  </tr>
  71  </tbody>
  72 </table>
  73 </div>
  74 <!-- end header part -->
  75 <div id="CMSISnav" class="tabs1">
  76   <ul class="tablist">
  77     <script type="text/javascript">
  78       writeComponentTabs.call(this);
  79     </script>
  80   </ul>
  81 </div>
  82 <!-- Generated by Doxygen 1.9.6 -->
  83 <script type="text/javascript">
  84 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  85 var searchBox = new SearchBox("searchBox", "search/",'.html');
  86 /* @license-end */
  87 </script>
  88 </div><!-- top -->
  89 <div id="side-nav" class="ui-resizable side-nav-resizable">
  90   <div id="nav-tree">
  91     <div id="nav-tree-contents">
  92       <div id="nav-sync" class="sync"></div>
  93     </div>
  94   </div>
  95   <div id="splitbar" style="-moz-user-select:none;"
  96        class="ui-resizable-handle">
  97   </div>
  98 </div>
  99 <script type="text/javascript">
 100 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
 101 $(document).ready(function(){initNavTree('index.html',''); initResizable(); });
 102 /* @license-end */
 103 </script>
 104 <div id="doc-content">
 105 <!-- window showing the filter options -->
 106 <div id="MSearchSelectWindow"
 107      onmouseover="return searchBox.OnSearchSelectShow()"
 108      onmouseout="return searchBox.OnSearchSelectHide()"
 109      onkeydown="return searchBox.OnSearchSelectKey(event)">
 110 </div>
 111
 112 <!-- iframe showing the search results (closed by default) -->
 113 <div id="MSearchResultsWindow">
 114 <div id="MSearchResults">
 115 <div class="SRPage">
 116 <div id="SRIndex">
 117 <div id="SRResults"></div>
 118 <div class="SRStatus" id="Loading">Loading...</div>
 119 <div class="SRStatus" id="Searching">Searching...</div>
 120 <div class="SRStatus" id="NoMatches">No Matches</div>
 121 </div>
 122 </div>
 123 </div>
 124 </div>
 125
 126 <div><div class="header">
 127   <div class="headertitle"><div class="title">Introduction </div></div>
 128 </div><!--header-->
 129 <div class="contents">
 130 <div class="textblock"><p><a class="anchor" id="mainpage"></a> The <b>CMSIS</b> (Common Microcontroller Software Interface Standard) is a set of APIs, software components, tools, and workflows that help to simplify software re-use, reduce the learning curve for microcontroller developers, speed-up project build and debug, and thus reduce the time to market for new applications.</p>
 131 <p>CMSIS started as a vendor-independent hardware abstraction layer Arm&reg; Cortex&reg;-M based processors and was later extended to support entry-level Arm Cortex-A based processors. To simplify access, CMSIS defines generic tool interfaces and enables consistent device support by providing simple software interfaces to the processor and the peripherals.</p>
 132 <p>CMSIS has been created to help the industry in standardization. It enables consistent software layers and device support across a wide range of development tools and microcontrollers. CMSIS is not a huge software layer that introduces overhead and does not define standard peripherals. The silicon industry can therefore support the wide variations of Arm Cortex processor-based devices with this common standard.</p>
 133 <h1><a class="anchor" id="cmsis_components"></a>
 134 CMSIS Components</h1>
 135 <div class="image">
 136 <img src="Overview.png" alt=""/>
 137 <div class="caption">
 138 CMSIS Structure</div></div>
 139     <h2>CMSIS Base Software Components</h2>
 140 <ul>
 141 <li>Provide software abstractions for basic level functionalities of a device.</li>
 142 <li>Maintained in the same GitHub repository and delivered as a bundle in <a class="el" href="cmsis_pack.html">CMSIS Software Pack</a>. <div class="tiles"> <div class="tile"> <span class="tileh h2">CMSIS-Core (M)</span><span class="tiletxt">Standardized API for Cortex-M processor cores</span><span class="tilelinks"><a href="https://arm-software.github.io/CMSIS_6/latest/Core/html/index.html">Guide</a> | <a href="https://github.com/ARM-software/CMSIS_6">GitHub</a></span> </div> <div class="tile"> <span class="tileh h2">CMSIS-Core (A)</span><span class="tiletxt">Standardized API for Cortex-A5/A7/A9 cores</span><span class="tilelinks"><a href="https://arm-software.github.io/CMSIS_6/latest/Core_A/html/index.html">Guide</a> | <a href="https://github.com/ARM-software/CMSIS_6">GitHub</a></span> </div> <div class="tile"> <span class="tileh h2">CMSIS-Driver</span><span class="tiletxt">Generic peripheral driver interfaces for middleware</span><span class="tilelinks"><a href="https://arm-software.github.io/CMSIS_6/latest/Driver/html/index.html">Guide</a> | <a href="https://github.com/ARM-software/CMSIS_6">GitHub</a></span> </div> <div class="tile"> <span class="tileh h2">CMSIS-RTOS2</span><span class="tiletxt">Common API for real-time operating systems</span><span class="tilelinks"><a href="https://arm-software.github.io/CMSIS_6/latest/RTOS2/html/index.html">Guide</a> | <a href="https://github.com/ARM-software/CMSIS_6">GitHub</a></span> </div> </div></li>
 143 </ul>
 144 <h2>CMSIS Extended Software Components</h2>
 145 <ul>
 146 <li>Implement specific functionalities optimized for execution on Arm processors.</li>
 147 <li>Maintained in separate GitHub repositories and delivered in standalone CMSIS-Packs. <div class="tiles"> <div class="tile"> <span class="tileh h2">CMSIS-DSP</span><span class="tiletxt">Collection of optimized compute library for embedded systems</span><span class="tilelinks"><a href="https://arm-software.github.io/CMSIS-DSP/latest/">Guide</a> | <a href="https://github.com/ARM-software/CMSIS-DSP">GitHub</a></span> </div> <div class="tile"> <span class="tileh h2">CMSIS-NN</span><span class="tiletxt">Collection of efficient and optimized neural network kernels</span><span class="tilelinks"><a href="https://arm-software.github.io/CMSIS-NN/latest/">Guide</a> | <a href="https://github.com/ARM-software/CMSIS-NN">GitHub</a></span> </div> <div class="tile"> <span class="tileh h2">CMSIS-View</span><span class="tiletxt">Event Recorder and Component Viewer technology</span><span class="tilelinks"><a href="https://arm-software.github.io/CMSIS-View/latest/">Guide</a> | <a href="https://github.com/ARM-software/CMSIS-View">GitHub</a></span> </div> <div class="tile"> <span class="tileh h2">CMSIS-Compiler</span><span class="tiletxt">Retarget I/O functions of the standard C run-time library</span><span class="tilelinks"><a href="https://arm-software.github.io/CMSIS-Compiler/latest/">Guide</a> | <a href="https://github.com/ARM-software/CMSIS-Compiler">GitHub</a></span> </div> </div></li>
 148 </ul>
 149 <h2>CMSIS Tools</h2>
 150 <ul>
 151 <li>Provide useful utilities for software development workflows with CMSIS-based components.</li>
 152 <li>Maintained in separate GitHub repositories. <div class="tiles"> <div class="tile"> <span class="tileh h2">CMSIS-Toolbox</span><span class="tiletxt">A set of command-line tools to work with software packs</span><span class="tilelinks"><a href="https://github.com/Open-CMSIS-Pack/cmsis-toolbox/blob/main/README.md">Guide</a> | <a href="https://github.com/Open-CMSIS-Pack/cmsis-toolbox">GitHub</a></span> </div> <div class="tile"> <span class="tileh h2">CMSIS-Stream</span><span class="tiletxt">Peripheral description of a device for debug view</span><span class="tilelinks"><a href="https://arm-software.github.io/CMSIS-Stream/latest/">Guide</a> | <a href="https://github.com/ARM-software/cmsis-stream">GitHub</a></span> </div> <div class="tile"> <span class="tileh h2">CMSIS-DAP</span><span class="tiletxt">Firmware for debug units interfacing to CoreSight Debug Access Port</span><span class="tilelinks"><a href="https://arm-software.github.io/CMSIS-DAP/latest/">Guide</a> | <a href="https://github.com/ARM-software/CMSIS-DAP">GitHub</a></span> </div> <div class="tile"> <span class="tileh h2">CMSIS-Zone</span><span class="tiletxt">Defines methods to describe system resources and to partition them</span><span class="tilelinks"><a href="">Guide</a> | <a href="https://github.com/ARM-software/CMSIS-Zone">GitHub</a></span> </div> </div></li>
 153 </ul>
 154 <h2>CMSIS Specifications</h2>
 155 <ul>
 156 <li>Define methodologies and workflows for embedded software development. <div class="tiles"> <div class="tile"> <span class="tileh h2">CMSIS-Pack</span><span class="tiletxt">Delivery mechanism for software components and device/board support</span><span class="tilelinks"><a href="https://open-cmsis-pack.github.io/Open-CMSIS-Pack-Spec/main/html/index.html">Guide</a> | <a href="https://github.com/Open-CMSIS-Pack/Open-CMSIS-Pack-Spec">GitHub</a></span> </div> <div class="tile"> <span class="tileh h2">CMSIS-SVD</span><span class="tiletxt">Peripheral description of a device for debug view</span><span class="tilelinks"><a href="">Guide</a> | <a href="">GitHub</a></span> </div> </div></li>
 157 </ul>
 158 <h1><a class="anchor" id="benefits"></a>
 159 Benefits</h1>
 160 <p>The benefits of the CMSIS are:</p>
 161 <ul>
 162 <li>CMSIS reduces the learning curve, development costs, and time-to-market. Developers can write software quicker through a variety of easy-to-use, standardized software interfaces.</li>
 163 <li>Consistent software interfaces improve the software portability and re-usability. Generic software libraries and interfaces provide consistent software framework.</li>
 164 <li>It provides interfaces for debug connectivity, debug peripheral views, software delivery, and device support to reduce time-to-market for new microcontroller deployment.</li>
 165 <li>It allows to use the compiler of your choice, as it is compiler independent and thus supported by mainstream compilers.</li>
 166 <li>It enhances program debugging with peripheral information for debuggers and ITM channels for printf-style output.</li>
 167 <li>CMSIS is delivered in CMSIS-Pack format which enables fast software delivery, simplifies updates, and enables consistent integration into development tools.</li>
 168 <li>CMSIS-Zone will simplify system resource and partitioning as it manages the configuration of multiple processors, memory areas, and peripherals.</li>
 169 <li>Continuous integration is common practice for most software developers nowadays. CMSIS-Build supports these workflows and makes continuous testing and validation easier.</li>
 170 </ul>
 171 <h1><a class="anchor" id="development"></a>
 172 Development</h1>
 173 <p>CMSIS is defined in close cooperation with various silicon and software vendors and provides a common approach to interface to peripherals, real-time operating systems, and middleware components. It is intended to enable the combination of software components from multiple vendors.</p>
 174 <p>CMSIS is open-source and collaboratively developed. The repository for the base components is <a href="https://github.com/ARM-software/CMSIS_6">github.com/Arm-software/CMSIS_6</a>.</p>
 175 <h1><a class="anchor" id="coding_rules"></a>
 176 CodingRules</h1>
 177 <p>The CMSIS uses the following essential coding rules and conventions:</p>
 178 <ul>
 179 <li>Compliant with ANSI C (C99) and C++ (C++03).</li>
 180 <li>Uses ANSI C standard data types defined in <b>&lt;stdint.h&gt;</b>.</li>
 181 <li>Variables and parameters have a complete data type.</li>
 182 <li>Expressions for <code>#define</code> constants are enclosed in parenthesis.</li>
 183 <li>Conforms to MISRA 2012 (but does not claim MISRA compliance). MISRA rule violations are documented.</li>
 184 </ul>
 185 <p>In addition, the CMSIS recommends the following conventions for identifiers:</p>
 186 <ul>
 187 <li><b>CAPITAL</b> names to identify Core Registers, Peripheral Registers, and CPU Instructions.</li>
 188 <li><b>CamelCase</b> names to identify function names and interrupt functions.</li>
 189 <li><b>Namespace_</b> prefixes avoid clashes with user identifiers and provide functional groups (i.e. for peripherals, RTOS, or DSP Library).</li>
 190 </ul>
 191 <p>The CMSIS is documented within the source files with: </p><ul>
 192 <li>Comments that use the C or C++ style. </li>
 193 <li><a href="https://www.doxygen.nl/" target="_blank">Doxygen</a> compliant <b>function comments</b> that provide:<ul>
 194 <li>brief function overview.</li>
 195 <li>detailed description of the function.</li>
 196 <li>detailed parameter explanation.</li>
 197 <li>detailed information about return values.</li>
 198 </ul>
 199 </li>
 200 </ul>
 201 <p>Doxygen comment example:</p>
 202 <div class="fragment"><div class="line">/**</div>
 203 <div class="line"> * @brief  Enable Interrupt in NVIC Interrupt Controller</div>
 204 <div class="line"> * @param  IRQn  interrupt number that specifies the interrupt</div>
 205 <div class="line"> * @return none.</div>
 206 <div class="line"> * Enable the specified interrupt in the NVIC Interrupt Controller.</div>
 207 <div class="line"> * Other settings of the interrupt such as priority are not affected.</div>
 208 <div class="line"> */</div>
 209 </div><!-- fragment --><h1><a class="anchor" id="validation"></a>
 210 Validation</h1>
 211 <p>The various components of CMSIS are validated using mainstream compilers. To get a diverse coverage, <br  />
 212  Arm Compiler v6 (based on LLVM front-end) and GCC are used in the various tests. For each component, the section <b>Validation</b> describes the scope of the various verification steps.</p>
 213 <p>CMSIS components are compatible with a range of C and C++ language standards. The CMSIS components comply with the <a href="https://github.com/ARM-software/abi-aa">Application Binary Interface (ABI) for the Arm Architecture</a>. This ensures C API interfaces that support inter-operation between various toolchains.</p>
 214 <p>As CMSIS defines API interfaces and functions that scale to a wide range of processors and devices, the scope of the run-time test coverage is limited. However, several components are validated using dedicated test suites (<a href="../../Driver/html/driverValidation.html">CMSIS-Driver</a>, and <a href="../../RTOS2/html/rtosValidation.html">CMSIS-RTOS v2</a>).</p>
 215 <p>The CMSIS source code is checked for MISRA C:2012 conformance. MISRA deviations are documented with reasonable effort, however Arm does not claim MISRA compliance as there is today for example no guideline enforcement plan. The CMSIS source code is not checked for MISRA C++:2008 conformance as there is a risk that it is incompatible with C language standards, specifically warnings that may be generated by the various C compilers.</p>
 216 <h1><a class="anchor" id="License"></a>
 217 License</h1>
 218 <p>CMSIS is provided free of charge by Arm under the <a href="https://raw.githubusercontent.com/ARM-software/CMSIS_6/main/LICENSE">Apache 2.0 License</a>. </p>
 219 </div></div><!-- PageDoc -->
 220 </div><!-- contents -->
 221 </div><!-- doc-content -->
 222 <!-- start footer part -->
 223 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
 224   <ul>
 225     <li class="footer">
 226       <script type="text/javascript">
 227         <!--
 228         writeFooter.call(this);
 229         //-->
 230       </script>
 231     </li>
 232   </ul>
 233 </div>
 234 </body>
 235 </html>