blob: 02a7ab7921bb4d5367d989b6fe0acbaca270c1a8 [file] [log] [blame]
<!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>/package/devices element</title>
<title>CMSIS-Pack: /package/devices element</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-Pack
&#160;<span id="projectnumber">Version 1.6.0</span>
</div>
<div id="projectbrief">Delivery Mechanism for Software Packs</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('pdsc_devices_pg.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">/package/devices element </div> </div>
</div><!--header-->
<div class="contents">
<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>
<p>Devices can be organized in hierarchy groups to limit redundancy. The hierarchy levels are:</p>
<ul>
<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>
<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>
</ul>
<p>Device characteristics can be defined in:</p>
<ul>
<li><a class="el" href="pdsc_family_pg.html#element_device">device</a>: attributes of a specific silicon device</li>
<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>
</ul>
<p>A device is described by the following properties:</p>
<ul>
<li><a class="el" href="pdsc_family_pg.html#element_description">description</a>: textual device description</li>
<li><a class="el" href="pdsc_family_pg.html#element_feature">feature</a>: categorized list of device peripherals and features</li>
<li><a class="el" href="pdsc_family_pg.html#element_book">book</a>: documentation about the device and its processor(s)</li>
<li><a class="el" href="pdsc_family_pg.html#element_processor">processor</a>: processor and processor features embedded in the device</li>
<li><a class="el" href="pdsc_family_pg.html#element_compile">compile</a>: device specific general settings for the build tools</li>
<li><a class="el" href="pdsc_family_pg.html#element_debugconfig">debugconfig</a>: default settings for a debug connection</li>
<li><a class="el" href="pdsc_family_pg.html#element_debugvars">debugvars</a>: global debug access variables for use in sequences.</li>
<li><a class="el" href="pdsc_family_pg.html#element_sequences">sequences</a>: debug access sequences.</li>
<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>
<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>
<li><a class="el" href="pdsc_family_pg.html#element_trace">trace</a>: device specific information for the debugger to configure trace.</li>
<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>
<li><a class="el" href="pdsc_family_pg.html#element_algorithm">algorithm</a>: device specific Flash programming algorithms</li>
</ul>
<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>
<p><b>Example</b> </p>
<div class="fragment"><div class="line">&lt;package&gt;</div>
<div class="line"> ...</div>
<div class="line"> &lt;devices&gt;</div>
<div class="line"> &lt;!-- family level --&gt;</div>
<div class="line"> &lt;family Dfamily=<span class="stringliteral">&quot;STM32F2&quot;</span> Dvendor=<span class="stringliteral">&quot;STMicroelectronics:13&quot;</span>&gt;</div>
<div class="line"> &lt;processor Dcore=<span class="stringliteral">&quot;Cortex-M3&quot;</span> DcoreVersion=<span class="stringliteral">&quot;r2p1&quot;</span></div>
<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>
<div class="line"></div>
<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>
<div class="line"> &lt;debug svd=<span class="stringliteral">&quot;SVD/STM32F20x.svd&quot;</span>/&gt;</div>
<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>
<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>
<div class="line"></div>
<div class="line"> &lt;description&gt;</div>
<div class="line"> Arm 32-bit Cortex-M3 CPU based Microcontroller</div>
<div class="line"> - 120 MHz maximum frequency producing 150 DMIPS/1.25 DMIPS/MHz</div>
<div class="line"> - Memory Protection Unit</div>
<div class="line"> - Flexible <span class="keyword">static</span> memory controller (supports Compact Flash, SRAM, PSRAM, NOR, NAND memories)</div>
<div class="line"> - LCD parallel interface, 8080/6800 modes</div>
<div class="line"> - Clock, reset and supply management</div>
<div class="line"> &lt;/description&gt;</div>
<div class="line"></div>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;I2C&quot;</span> n=<span class="stringliteral">&quot;3&quot;</span>/&gt;</div>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<div class="line"></div>
<div class="line"> &lt;!-- sub family level --&gt;</div>
<div class="line"> &lt;subFamily DsubFamily=<span class="stringliteral">&quot;128 Flash&quot;</span>&gt;</div>
<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>
<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>
<div class="line"> </div>
<div class="line"> &lt;!-- device level --&gt;</div>
<div class="line"> &lt;device Dname=<span class="stringliteral">&quot;STM32F205RB&quot;</span>&gt;</div>
<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>
<div class="line"> &lt;variant Dvariant=<span class="stringliteral">&quot;STM32F205RBT6&quot;</span>&gt;</div>
<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>
<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>
<div class="line"> &lt;/variant&gt;</div>
<div class="line"> &lt;variant Dvariant=<span class="stringliteral">&quot;STM32F205RBT7&quot;</span>&gt;</div>
<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>
<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>
<div class="line"> &lt;/variant&gt;</div>
<div class="line"> &lt;/device&gt;</div>
<div class="line"> </div>
<div class="line"> &lt;device Dname=<span class="stringliteral">&quot;STM32F205VB&quot;</span>&gt;</div>
<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>
<div class="line"> &lt;variant Dvariant=<span class="stringliteral">&quot;STM32F205VBT6&quot;</span>&gt;</div>
<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>
<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>
<div class="line"> &lt;/variant&gt;</div>
<div class="line"> &lt;/device&gt;</div>
<div class="line"> &lt;/subFamily&gt;</div>
<div class="line"> </div>
<div class="line"> &lt;/family&gt;</div>
<div class="line"> &lt;/devices&gt;</div>
<div class="line">&lt;/package&gt;</div>
</div><!-- fragment --><p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_devices"></a>
/package/devices</h1>
<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>
<p><b>Example</b> </p>
<div class="fragment"><div class="line">&lt;package&gt;</div>
<div class="line"> ...</div>
<div class="line"> &lt;devices&gt;</div>
<div class="line"> ...</div>
<div class="line"> &lt;/devices&gt;</div>
<div class="line"> ...</div>
<div class="line">&lt;/package&gt;</div>
</div><!-- fragment --><p><br/>
</p>
<table class="cmtable" summary="Element: devices">
<tr>
<th>Parents </th><th colspan="3">Element Chain </th></tr>
<tr>
<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>
<tr>
<th>Child&#160;Elements </th><th>Description </th><th>Type </th><th>Occurrence </th></tr>
<tr>
<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>
</table>
<p>&#160;</p>
<hr/>
</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="packFormat.html">Pack Description (*.pdsc) Format</a></li>
<li class="footer">Generated on Wed Jul 10 2019 15:21:00 for CMSIS-Pack Version 1.6.0 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>