pdsc_devices_pg.html 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254
  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>/package/devices element</title>
  7. <title>CMSIS-Pack: /package/devices element</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-Pack
  35. &#160;<span id="projectnumber">Version 1.6.3</span>
  36. </div>
  37. <div id="projectbrief">Delivery Mechanism for Software Packs</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('pdsc_devices_pg.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">/package/devices element </div> </div>
  109. </div><!--header-->
  110. <div class="contents">
  111. <div class="textblock"><p>The level <b>&lt;devices&gt;</b> contains all devices for which support is provided by the <a class="el" href="cp_SWComponents.html">Software Pack</a>.</p>
  112. <p>Devices can be organized in hierarchy groups to limit redundancy. The hierarchy levels are:</p>
  113. <ul>
  114. <li><a class="el" href="pdsc_family_pg.html#element_family">family</a>: the attributes of a device family which includes also the processor.</li>
  115. <li><a class="el" href="pdsc_family_pg.html#element_subFamily">subFamily</a>: attributes of an optional sub-family; this adds or modifies features of a family.</li>
  116. </ul>
  117. <p>Device characteristics can be defined in:</p>
  118. <ul>
  119. <li><a class="el" href="pdsc_family_pg.html#element_device">device</a>: attributes of a specific silicon device</li>
  120. <li><a class="el" href="pdsc_family_pg.html#element_variant">variant</a>: attributes of a device variant (for example, with different package or temperature range) or an OEM device or board that integrates the device.</li>
  121. </ul>
  122. <p>A device is described by the following properties:</p>
  123. <ul>
  124. <li><a class="el" href="pdsc_family_pg.html#element_description">description</a>: textual device description</li>
  125. <li><a class="el" href="pdsc_family_pg.html#element_feature">feature</a>: categorized list of device peripherals and features</li>
  126. <li><a class="el" href="pdsc_family_pg.html#element_book">book</a>: documentation about the device and its processor(s)</li>
  127. <li><a class="el" href="pdsc_family_pg.html#element_processor">processor</a>: processor and processor features embedded in the device</li>
  128. <li><a class="el" href="pdsc_family_pg.html#element_compile">compile</a>: device specific general settings for the build tools</li>
  129. <li><a class="el" href="pdsc_family_pg.html#element_debugconfig">debugconfig</a>: default settings for a debug connection</li>
  130. <li><a class="el" href="pdsc_family_pg.html#element_debugvars">debugvars</a>: global debug access variables for use in sequences.</li>
  131. <li><a class="el" href="pdsc_family_pg.html#element_sequences">sequences</a>: debug access sequences.</li>
  132. <li><a class="el" href="pdsc_family_pg.html#element_debugport">debugport</a>: debug port description of the device for the debugger to configure a debug connection.</li>
  133. <li><a class="el" href="pdsc_family_pg.html#element_accessportV1">accessportV1</a>: access port (APv1) description of the device for the debugger to configure a debug connection.</li>
  134. <li><a class="el" href="pdsc_family_pg.html#element_accessportV2">accessportV2</a>: access port (APv2) description of the device for the debugger to configure a debug connection.</li>
  135. <li><a class="el" href="pdsc_family_pg.html#element_debug">debug</a>: device specific information for the debugger to configure a debug connection including System View Description files.</li>
  136. <li><a class="el" href="pdsc_family_pg.html#element_trace">trace</a>: device specific information for the debugger to configure trace.</li>
  137. <li><a class="el" href="pdsc_family_pg.html#element_memory">memory</a>: memory layout of the device for internal and external RAM and ROM regions</li>
  138. <li><a class="el" href="pdsc_family_pg.html#element_algorithm">algorithm</a>: device specific Flash programming algorithms</li>
  139. </ul>
  140. <p>A device will inherit the specifications from both the family and sub-family levels. Some properties are required to be unique. For example, the name of the svd file attribute of the <b>&lt;debug&gt;</b> property. Therefore, the svd file specified on the family level can be redefined by the attribute on the sub-family or device level. Information like the description and feature entries are concatenated, starting with the information from the family and sub-family level and finalizing with the information on the device level.</p>
  141. <p><b>Example</b> </p>
  142. <div class="fragment"><div class="line">&lt;package&gt;</div>
  143. <div class="line"> ...</div>
  144. <div class="line"> &lt;devices&gt;</div>
  145. <div class="line"> &lt;!-- family level --&gt;</div>
  146. <div class="line"> &lt;family Dfamily=<span class="stringliteral">&quot;STM32F2&quot;</span> Dvendor=<span class="stringliteral">&quot;STMicroelectronics:13&quot;</span>&gt;</div>
  147. <div class="line"> &lt;processor Dcore=<span class="stringliteral">&quot;Cortex-M3&quot;</span> DcoreVersion=<span class="stringliteral">&quot;r2p1&quot;</span></div>
  148. <div class="line"> Dfpu=<span class="stringliteral">&quot;NO_FPU&quot;</span> Dmpu=<span class="stringliteral">&quot;MPU&quot;</span> Dendian=<span class="stringliteral">&quot;Little-endian&quot;</span> Dclock=<span class="stringliteral">&quot;120000000&quot;</span>/&gt;</div>
  149. <div class="line"></div>
  150. <div class="line"> &lt;compile header=<span class="stringliteral">&quot;Device/Include/stm32f2xx.h&quot;</span> define=<span class="stringliteral">&quot;STM32F2XX&quot;</span>/&gt;</div>
  151. <div class="line"> &lt;debug svd=<span class="stringliteral">&quot;SVD/STM32F20x.svd&quot;</span>/&gt;</div>
  152. <div class="line"> &lt;algorithm name=<span class="stringliteral">&quot;Flash/STM32F2xx_OPT.flm&quot;</span> start=<span class="stringliteral">&quot;0x1FFFC000&quot;</span> size=<span class="stringliteral">&quot;0x00000010&quot;</span> style=<span class="stringliteral">&quot;Keil&quot;</span>/&gt;</div>
  153. <div class="line"> &lt;book name=<span class="stringliteral">&quot;doc/STM32F2.PDF&quot;</span> title=<span class="stringliteral">&quot;STM32F2 Reference Manual&quot;</span>/&gt;</div>
  154. <div class="line"></div>
  155. <div class="line"> &lt;description&gt;</div>
  156. <div class="line"> Arm 32-bit Cortex-M3 CPU based Microcontroller</div>
  157. <div class="line"> - 120 MHz maximum frequency producing 150 DMIPS/1.25 DMIPS/MHz</div>
  158. <div class="line"> - Memory Protection Unit</div>
  159. <div class="line"> - Flexible <span class="keyword">static</span> memory controller (supports Compact Flash, SRAM, PSRAM, NOR, NAND memories)</div>
  160. <div class="line"> - LCD parallel interface, 8080/6800 modes</div>
  161. <div class="line"> - Clock, reset and supply management</div>
  162. <div class="line"> &lt;/description&gt;</div>
  163. <div class="line"></div>
  164. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;Timer&quot;</span> n=<span class="stringliteral">&quot;10&quot;</span> m=<span class="stringliteral">&quot;32&quot;</span> name=<span class="stringliteral">&quot;General Purpose Timer with 60 MHz&quot;</span>/&gt;</div>
  165. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;Timer&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span> m=<span class="stringliteral">&quot;16&quot;</span> name=<span class="stringliteral">&quot;Advanced Control Timer with 120 MHz&quot;</span>/&gt;</div>
  166. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;Timer&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span> m=<span class="stringliteral">&quot;16&quot;</span> name=<span class="stringliteral">&quot;Basic Timer with 60 MHz&quot;</span>/&gt;</div>
  167. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;TimerOther&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;Independent Watchdog Timer&quot;</span>/&gt;</div>
  168. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;TimerOther&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;Window Watchdog Timer&quot;</span>/&gt;</div>
  169. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;DAC&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span> m=<span class="stringliteral">&quot;12&quot;</span>/&gt;</div>
  170. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;SPI&quot;</span> n=<span class="stringliteral">&quot;3&quot;</span> name=<span class="stringliteral">&quot;SPI Interface (two of them can be used as I2S)&quot;</span>/&gt;</div>
  171. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;I2C&quot;</span> n=<span class="stringliteral">&quot;3&quot;</span>/&gt;</div>
  172. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;USART&quot;</span> n=<span class="stringliteral">&quot;4&quot;</span> name=<span class="stringliteral">&quot;USART Interface up to 7.5 Mbit/s&quot;</span>/&gt;</div>
  173. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;UART&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span> name=<span class="stringliteral">&quot;UART Interface up to 3.75 Mbit/s&quot;</span>/&gt;</div>
  174. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;USBOTG&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;USB OTG (Full-Speed) with PHY and ULPI&quot;</span>/&gt;</div>
  175. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;USBOTG&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;USB OTG (High-Speed) with PHY and ULPI&quot;</span>/&gt;</div>
  176. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;CAN&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span> name=<span class="stringliteral">&quot;CAN Interface (2.0b Active)&quot;</span>/&gt;</div>
  177. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;SDIO&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> m=<span class="stringliteral">&quot;8&quot;</span> name=<span class="stringliteral">&quot;Supporting SD/MicroSD/MMC&quot;</span>/&gt;</div>
  178. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;VCC&quot;</span> n=<span class="stringliteral">&quot;1.8&quot;</span> m=<span class="stringliteral">&quot;3.6&quot;</span>/&gt;</div>
  179. <div class="line"></div>
  180. <div class="line"> &lt;!-- sub family level --&gt;</div>
  181. <div class="line"> &lt;subFamily DsubFamily=<span class="stringliteral">&quot;128 Flash&quot;</span>&gt;</div>
  182. <div class="line"> &lt;memory name=<span class="stringliteral">&quot;SRAM&quot;</span> access=<span class="stringliteral">&quot;rwx&quot;</span> start=<span class="stringliteral">&quot;0x20000000&quot;</span> size=<span class="stringliteral">&quot;0x10000&quot;</span> <span class="keywordflow">default</span>=<span class="stringliteral">&quot;1&quot;</span>/&gt;</div>
  183. <div class="line"> &lt;memory name=<span class="stringliteral">&quot;Flash&quot;</span> access=<span class="stringliteral">&quot;rx&quot;</span> start=<span class="stringliteral">&quot;0x08000000&quot;</span> size=<span class="stringliteral">&quot;0x20000&quot;</span> startup=<span class="stringliteral">&quot;1&quot;</span> <span class="keywordflow">default</span>=<span class="stringliteral">&quot;1&quot;</span>/&gt;</div>
  184. <div class="line"></div>
  185. <div class="line"> &lt;!-- device level --&gt;</div>
  186. <div class="line"> &lt;device Dname=<span class="stringliteral">&quot;STM32F205RB&quot;</span>&gt;</div>
  187. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;IOs&quot;</span> n=<span class="stringliteral">&quot;51&quot;</span> name=<span class="stringliteral">&quot;Input and Output Ports&quot;</span>/&gt;</div>
  188. <div class="line"> &lt;variant Dvariant=<span class="stringliteral">&quot;STM32F205RBT6&quot;</span>&gt;</div>
  189. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;QFP&quot;</span> count=<span class="stringliteral">&quot;64&quot;</span> name=<span class="stringliteral">&quot;LQFP 64 10x10x1.4&quot;</span> /&gt;</div>
  190. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;Temp&quot;</span> n=<span class="stringliteral">&quot;-40&quot;</span> m=<span class="stringliteral">&quot;85&quot;</span> name=<span class="stringliteral">&quot;Industrial Temperature Range&quot;</span>/&gt;</div>
  191. <div class="line"> &lt;/variant&gt;</div>
  192. <div class="line"> &lt;variant Dvariant=<span class="stringliteral">&quot;STM32F205RBT7&quot;</span>&gt;</div>
  193. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;QFP&quot;</span> count=<span class="stringliteral">&quot;64&quot;</span> name=<span class="stringliteral">&quot;LQFP 64 10x10x1.4&quot;</span> /&gt;</div>
  194. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;Temp&quot;</span> n=<span class="stringliteral">&quot;-40&quot;</span> m=<span class="stringliteral">&quot;105&quot;</span> name=<span class="stringliteral">&quot;Extended Temperature Range&quot;</span>/&gt;</div>
  195. <div class="line"> &lt;/variant&gt;</div>
  196. <div class="line"> &lt;/device&gt;</div>
  197. <div class="line"></div>
  198. <div class="line"> &lt;device Dname=<span class="stringliteral">&quot;STM32F205VB&quot;</span>&gt;</div>
  199. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;IOs&quot;</span> n=<span class="stringliteral">&quot;82&quot;</span> name=<span class="stringliteral">&quot;Input and Output Ports&quot;</span>/&gt;</div>
  200. <div class="line"> &lt;variant Dvariant=<span class="stringliteral">&quot;STM32F205VBT6&quot;</span>&gt;</div>
  201. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;QFP&quot;</span> count=<span class="stringliteral">&quot;100&quot;</span> name=<span class="stringliteral">&quot;LQFP 100 14x14x1.4&quot;</span> /&gt;</div>
  202. <div class="line"> &lt;feature type=<span class="stringliteral">&quot;Temp&quot;</span> n=<span class="stringliteral">&quot;-40&quot;</span> m=<span class="stringliteral">&quot;85&quot;</span> name=<span class="stringliteral">&quot;Industrial Temperature Range&quot;</span>/&gt;</div>
  203. <div class="line"> &lt;/variant&gt;</div>
  204. <div class="line"> &lt;/device&gt;</div>
  205. <div class="line"> &lt;/subFamily&gt;</div>
  206. <div class="line"></div>
  207. <div class="line"> &lt;/family&gt;</div>
  208. <div class="line"> &lt;/devices&gt;</div>
  209. <div class="line">&lt;/package&gt;</div>
  210. </div><!-- fragment --><p>&#160;</p>
  211. <hr/>
  212. <h1><a class="anchor" id="element_devices"></a>
  213. /package/devices</h1>
  214. <p>Group level containing device <a class="el" href="pdsc_family_pg.html">family</a> descriptions. A package can contain only one element <b>&lt;devices&gt;</b>. The group is not mandatory.</p>
  215. <p><b>Example</b> </p>
  216. <div class="fragment"><div class="line">&lt;package&gt;</div>
  217. <div class="line"> ...</div>
  218. <div class="line"> &lt;devices&gt;</div>
  219. <div class="line"> ...</div>
  220. <div class="line"> &lt;/devices&gt;</div>
  221. <div class="line"> ...</div>
  222. <div class="line">&lt;/package&gt;</div>
  223. </div><!-- fragment --><p><br/>
  224. </p>
  225. <table class="cmtable" summary="Element: devices">
  226. <tr>
  227. <th>Parents </th><th colspan="3">Element Chain </th></tr>
  228. <tr>
  229. <td><a class="el" href="pdsc_package_pg.html#element_package">package</a> </td><td colspan="3"><a class="el" href="pdsc_package_pg.html#element_package">/package</a> </td></tr>
  230. <tr>
  231. <th>Child&#160;Elements </th><th>Description </th><th>Type </th><th>Occurrence </th></tr>
  232. <tr>
  233. <td><a class="el" href="pdsc_family_pg.html#element_family">family</a> </td><td>Device family group. Define all properties that are in common to devices of a family. </td><td>complexType </td><td>1..* </td></tr>
  234. </table>
  235. <p>&#160;</p>
  236. <hr/>
  237. </div></div><!-- contents -->
  238. </div><!-- doc-content -->
  239. <!-- start footer part -->
  240. <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  241. <ul>
  242. <li class="navelem"><a class="el" href="packFormat.html">Pack Description (*.pdsc) Format</a></li>
  243. <li class="footer">Generated on Thu Apr 9 2020 15:49:54 for CMSIS-Pack Version 1.6.3 by Arm Ltd. All rights reserved.
  244. <!--
  245. <a href="http://www.doxygen.org/index.html">
  246. <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.6
  247. -->
  248. </li>
  249. </ul>
  250. </div>
  251. </body>
  252. </html>