blob: 47dd9ad67ea191f2d4db144311396b8d629d7620 [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/boards element</title>
<title>CMSIS-Pack: /package/boards 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_boards_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/boards element </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>The level <b>&lt;boards&gt;</b> describes a development board that is the subject of a Board Support Pack (BSP). It contains information about the board vendor and name, a brief description, images to be displayed on web pages, and different types of documentation. The microcontroller devices that are mounted on the board or that are compatible with the ones mounted are also specified. A list of features concludes the &lt;boards&gt; section.</p>
<p>A development board is described by the following properties:</p>
<ul>
<li>description: a brief description of the development board</li>
<li><a class="el" href="pdsc_boards_pg.html#element_board_book">book</a>: documentation about the board (user manuals, schematics, etc.)</li>
<li><a class="el" href="pdsc_boards_pg.html#element_board_mountedDevice">mountedDevice</a>: the microcontroller device mounted on the development board.</li>
<li><a class="el" href="pdsc_boards_pg.html#element_board_compatibleDevice">compatibleDevice</a>: compatible microcontroller devices.</li>
<li><a class="el" href="pdsc_boards_pg.html#element_board_image">image</a>: pictures of the board to be displayed on web pages.</li>
<li><a class="el" href="pdsc_boards_pg.html#element_board_feature">feature</a>: categorized list of the development board's features and peripherals.</li>
<li><a class="el" href="pdsc_boards_pg.html#element_board_debugInterface">debugInterface</a>: describing the debug capabilities.</li>
</ul>
<p><b>Example</b> </p>
<div class="fragment"><div class="line">&lt;boards&gt;</div>
<div class="line"> &lt;board vendor=<span class="stringliteral">&quot;STMicroelectronics&quot;</span> name=<span class="stringliteral">&quot;32F429IDISCOVERY&quot;</span> revision=<span class="stringliteral">&quot;Rev.1&quot;</span> salesContact=<span class="stringliteral">&quot;http://www.st.com/stonline/contactus/contacts/index.php&quot;</span> orderForm=<span class="stringliteral">&quot;https://my.st.com/esample/app?page=basket&amp;amp;pn=STM32F429I-DISCO&quot;</span>&gt;</div>
<div class="line"> </div>
<div class="line"> &lt;description&gt;STMicroelectronics STM32F429I Discovery Board Support and Examples&lt;/description&gt;</div>
<div class="line"> </div>
<div class="line"> &lt;image small=<span class="stringliteral">&quot;Images/stm32f429i-disco_small.png&quot;</span> large=<span class="stringliteral">&quot;Images/stm32f429i-disco.png&quot;</span>/&gt;</div>
<div class="line"> </div>
<div class="line"> &lt;book category=<span class="stringliteral">&quot;overview&quot;</span> name=<span class="stringliteral">&quot;http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1199/PF259090&quot;</span> title=<span class="stringliteral">&quot;32F429IDISCOVERY Web Page&quot;</span>/&gt;</div>
<div class="line"> &lt;book category=<span class="stringliteral">&quot;setup&quot;</span> name=<span class="stringliteral">&quot;Documents/UM1662.pdf&quot;</span> title=<span class="stringliteral">&quot;Getting Started&quot;</span>/&gt;</div>
<div class="line"> &lt;book category=<span class="stringliteral">&quot;schematic&quot;</span> name=<span class="stringliteral">&quot;Documents/UM1670.pdf&quot;</span> title=<span class="stringliteral">&quot;Schematics&quot;</span>/&gt;</div>
<div class="line"> &lt;book category=<span class="stringliteral">&quot;manual&quot;</span> name=<span class="stringliteral">&quot;Documents/UM1670.pdf&quot;</span> title=<span class="stringliteral">&quot;User Manual&quot;</span>/&gt;</div>
<div class="line"> </div>
<div class="line"> &lt;mountedDevice deviceIndex=<span class="stringliteral">&quot;0&quot;</span> Dvendor=<span class="stringliteral">&quot;STMicroelectronics:13&quot;</span> Dname=<span class="stringliteral">&quot;STM32F429ZI&quot;</span>/&gt;</div>
<div class="line"> </div>
<div class="line"> &lt;compatibleDevice deviceIndex=<span class="stringliteral">&quot;0&quot;</span> Dvendor=<span class="stringliteral">&quot;STMicroelectronics:13&quot;</span> Dfamily=<span class="stringliteral">&quot;STM32F4 Series&quot;</span> DsubFamily=<span class="stringliteral">&quot;STM32F429 Line&quot;</span>/&gt;</div>
<div class="line"> </div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;ODbg&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;On-board ST-LINK/V2 with selection mode switch to use the kit as a standalone&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;XTAL&quot;</span> n=<span class="stringliteral">&quot;80000000&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;PWR&quot;</span> n=<span class="stringliteral">&quot;5&quot;</span> name=<span class="stringliteral">&quot;USB Powered&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;PWR&quot;</span> n=<span class="stringliteral">&quot;3&quot;</span> m=<span class="stringliteral">&quot;5&quot;</span> name=<span class="stringliteral">&quot;External Supply&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;RAM&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;64 MBit SDRAM&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;DIO&quot;</span> n=<span class="stringliteral">&quot;4&quot;</span> m=<span class="stringliteral">&quot;32&quot;</span> name=<span class="stringliteral">&quot;Extension header for LQFP144 with 2.54 mm Pitch&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;USB&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;High-Speed USB OTG with micro-AB Connector&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;ConnOther&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;JP3 (Idd) for current measurement&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;Button&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span> name=<span class="stringliteral">&quot;Push-buttons: User and Reset&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;Gyro&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;L3GD20, ST MEMS motion sensor, 3-axis digital output gyroscope&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;LED&quot;</span> n=<span class="stringliteral">&quot;6&quot;</span> name=<span class="stringliteral">&quot;Com, 3.3 V Power, Two user, Two USB OTG LEDs&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;CustomFF&quot;</span> n=<span class="stringliteral">&quot;66&quot;</span> m=<span class="stringliteral">&quot;119.3&quot;</span> name=<span class="stringliteral">&quot;Discovery Board Formfactor&quot;</span>/&gt;</div>
<div class="line"> &lt;feature type=<span class="stringliteral">&quot;GLCD&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> m=<span class="stringliteral">&quot;240.320&quot;</span> name=<span class="stringliteral">&quot;2.4 inch QVGA TFT LCD&quot;</span>/&gt;</div>
<div class="line"> </div>
<div class="line"> &lt;debugInterface adapter=<span class="stringliteral">&quot;ST-Link&quot;</span> connector=<span class="stringliteral">&quot;Mini-USB&quot;</span>/&gt;</div>
<div class="line"> </div>
<div class="line"> &lt;/board&gt;</div>
<div class="line">&lt;/boards&gt;</div>
</div><!-- fragment --><p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_boards"></a>
/package/boards</h1>
<p>Grouping element for boards. No more than one such group can exist in a Pack. None is required.</p>
<table class="cmtable" summary="Element: Boards">
<tr>
<th>Parent </th><th colspan="3">Chain </th></tr>
<tr>
<td><a class="el" href="pdsc_package_pg.html">package</a> </td><td colspan="3"><a class="el" href="pdsc_package_pg.html">/package</a> </td></tr>
<tr>
<th>Child Elements </th><th>Description </th><th>Type </th><th>Occurrence </th></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board">board</a> </td><td>Description of the board </td><td>BoardType </td><td>1..* </td></tr>
</table>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_board"></a>
/package/boards/board</h1>
<p>This element provides information to specify the <a class="el" href="createPackBoard.html">Board Support Package (BSP)</a>. At least one board must be defined.</p>
<table class="cmtable" summary="Element: Board">
<tr>
<th>Parent </th><th colspan="3">Chain </th></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_boards">boards</a> </td><td colspan="3"><a class="el" href="pdsc_boards_pg.html#element_boards">/package/boards</a> </td></tr>
<tr>
<th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
<tr>
<td>vendor </td><td>name of the board vendor </td><td>xs:string </td><td>required </td></tr>
<tr>
<td>name </td><td>name of the development board </td><td>xs:string </td><td>required </td></tr>
<tr>
<td>revision </td><td>Revision of the board that is suited to be used with the <a class="el" href="createPackBoard.html">BSP</a>. </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>salesContact </td><td>Either an email address or web page to contact the sales department. </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>orderForm </td><td>Link to a web page for ordering the development board. </td><td>xs:anyURI </td><td>optional </td></tr>
<tr>
<th>Child Elements </th><th>Description </th><th>Type </th><th>Occurrence </th></tr>
<tr>
<td>description </td><td>Brief summary of the board </td><td>xs:string </td><td>1 </td></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board_feature">feature</a> </td><td>Describes the features of the development board. </td><td>BoardsFeatureType </td><td>1..* </td></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board_mountedDevice">mountedDevice</a> </td><td>Specifies the microcontroller device mounted on the development board. </td><td>BoardsDeviceType </td><td>1..* </td></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board_compatibleDevice">compatibleDevice</a> </td><td>Specifies compatible microcontroller devices. </td><td>CompatibleDeviceType </td><td>1..* </td></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board_image">image</a> </td><td>Carries pictures of the boards to be displayed on web pages. Directory and file names are case-sensitive. </td><td>ComplexType </td><td>0..1 </td></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board_debugInterface">debugInterface</a> </td><td>Describes the debug interface of the development board. </td><td>DebugInterfaceType </td><td>1..* </td></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board_book">book</a> </td><td>Describes the documentation files (user manuals, schematics, etc.). Directory and file names are case-sensitive. </td><td>BoardsBookType </td><td>1..* </td></tr>
</table>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_board_feature"></a>
/package/boards/board/feature</h1>
<p>This element contains information about the features and capabilities of a board. A list of pre-defined features exists.</p>
<p><b>Example</b> </p>
<div class="fragment"><div class="line">&lt;feature type=<span class="stringliteral">&quot;PWR&quot;</span> n=<span class="stringliteral">&quot;3&quot;</span> m=<span class="stringliteral">&quot;5&quot;</span> name=<span class="stringliteral">&quot;Element: Board feature&quot;</span>/&gt;</div>
</div><!-- fragment --> <p>&#160;</p>
<table class="cmtable" summary="BoardFeature">
<tr>
<th>Parent </th><th colspan="3">Chain </th></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board">board</a> </td><td colspan="3"><a class="el" href="pdsc_boards_pg.html#element_board">/package/boards/board</a> </td></tr>
<tr>
<th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
<tr>
<td>type </td><td>Defines board features. Select predefined values from the table <a class="el" href="pdsc_boards_pg.html#BoardFeatureTypeEnum">Board Features</a>. </td><td>BoardFeatureTypeEnum </td><td>required </td></tr>
<tr>
<td>n </td><td>Depends on attribute <em><b>type</b>.</em> Check table <a class="el" href="pdsc_boards_pg.html#BoardFeatureTypeEnum">Board Features</a> for details. </td><td>xs:decimal </td><td>optional </td></tr>
<tr>
<td>m </td><td>Depends on attribute <em><b>type</b>.</em> Check table <a class="el" href="pdsc_boards_pg.html#BoardFeatureTypeEnum">Board Features</a> for details. </td><td>xs:decimal </td><td>optional </td></tr>
<tr>
<td>name </td><td>Descriptive name of the feature. If omitted, a <b>Default Name</b> is used (refer to table <a class="el" href="pdsc_boards_pg.html#BoardFeatureTypeEnum">Board Feature Types</a>). <b>Do not repeat</b> the <span class="XML-Token">n</span> or <span class="XML-Token">m</span> values in the name. This will lead to duplicate entries on web sites (they show <span class="XML-Token">n</span> x <span class="XML-Token">name</span>). </td><td>xs:string </td><td>optional </td></tr>
</table>
<p>&#160;</p>
<p><a class="anchor" id="BoardFeatureTypeEnum"></a><b>Table: Board Features</b></p>
<p>The table below lists predefined board features.</p>
<dl class="section note"><dt>Note</dt><dd><ul>
<li>The attribute <em>name</em> of the element <a class="el" href="pdsc_boards_pg.html#element_board_feature">/package/boards/board/feature</a> is a descriptive text for a feature. If <em>name</em> is omitted, the <b>Default Name</b> (listed below) is used.</li>
<li><b>Do not repeat</b> the <em>n</em> or <em>m</em> values in the <em>name</em>. Display on websites follows the rule to show <em>n</em> x <em>name</em>.</li>
</ul>
</dd></dl>
<table class="doxtable">
<tr>
<th>type=</th><th>n=</th><th>m=</th><th>Default Name</th><th>Example</th><th>Example shown as </th></tr>
<tr>
<td>ODbg</td><td>Number of Debug Adapters</td><td>N/A</td><td>Integrated Debug Adapter</td><td>&lt;feature type="ODbg" n="1" name="Integrated ST-Link on USB Connector J13"/&gt;</td><td>1 x Integrated ST-Link on USB Connector J13 </td></tr>
<tr>
<td>XTAL</td><td>Oscillator Frequency</td><td>N/A</td><td>Crystal Oscillator</td><td>&lt;feature type="XTAL" n="8000000"/&gt;</td><td>8 MHz Crystal Oscillator </td></tr>
<tr>
<td>PWR</td><td>Minimum Input Voltage</td><td>Maximum Input Voltage</td><td>Power Supply</td><td>&lt;feature type="PWR" n="8" m="12"/&gt;</td><td>8 V - 12 V Power Supply </td></tr>
<tr>
<td>PWRSock</td><td>Number of Power Sockets</td><td>N/A</td><td>Power Socket</td><td>&lt;feature type="PWRSock" n="1" name="Coaxial Power Receptacle"/&gt;</td><td>1 x Coaxial Power Receptacle </td></tr>
<tr>
<td>Batt</td><td>Number of Batteries</td><td>N/A</td><td>Battery</td><td>&lt;feature type="Batt" n="1" name="CR2032 Battery for RTC"/&gt;</td><td>1 x CR2032 Battery for RTC </td></tr>
<tr>
<td>Curr</td><td>Typical Current</td><td>Maximum Current</td><td>Current</td><td>&lt;feature type="Curr" n="0.320" m="0.375"/&gt;</td><td>320 mA (typ), 375 mA (max) Current </td></tr>
<tr>
<td>CoreOther</td><td>Number of Features</td><td>N/A</td><td>Other Core Feature</td><td>&lt;feature type="CoreOther" n=1 name="My Other Core Feature"/&gt;</td><td>1 x My Other Core Feature </td></tr>
<tr>
<td>RAM</td><td>Number of RAMs</td><td>N/A</td><td>RAM</td><td>&lt;feature type="RAM" n="1" name="512 kB Static RAM"/&gt;</td><td>1 x 512 kB Static RAM </td></tr>
<tr>
<td>ROM</td><td>Number of ROMs</td><td>N/A</td><td>Flash</td><td>&lt;feature type="ROM" n="1" name="4 MB NAND-Flash"/&gt;</td><td>1 x 4 MB NAND-Flash </td></tr>
<tr>
<td>Memory</td><td>Number of Additional Memory</td><td>N/A</td><td>Memory</td><td>&lt;feature type="Memory" n="128" name="EEPROM"/&gt;</td><td>128 byte EEPROM </td></tr>
<tr>
<td>MemCard</td><td>Number of Card Holders</td><td>N/A</td><td>SD/microSD/MMC Card Holder</td><td>&lt;feature type="MemCard" n="2" name="SD Card Holder"/&gt;</td><td>2 x SD Card Holder </td></tr>
<tr>
<td>MemoryOther</td><td>Number of Other Memory</td><td>N/A</td><td>Other Memory Type</td><td>&lt;feature type="MemoryOther" n="1" name="1 kB MRAM"/&gt;</td><td>1 x 1 kB MRAM </td></tr>
<tr>
<td>DIO</td><td>Number of Digital I/Os</td><td>N/A</td><td>Digital I/Os</td><td>&lt;feature type="DIO" n="26" name="Digital IOs on 2 x 13 pin header (1.27 mm pitch)"/&gt;</td><td>26 x Digital IOs on 2 x 13 pin header (1.27 mm pitch) </td></tr>
<tr>
<td>AIO</td><td>Number of Analog I/Os</td><td>N/A</td><td>Analog I/Os</td><td>&lt;feature type="AIO" n="4" name="Analog Inputs on 4 pin header (1.27 mm pitch)"/&gt;</td><td>4 x Analog Inputs on 4 pin header (1.27 mm pitch) </td></tr>
<tr>
<td>Proto</td><td>n Rows</td><td>m Columns</td><td>Prototyping Area</td><td>&lt;feature type="Proto" n="4" m="7" name="Prototyping Area with 1.00 mm pitch"/&gt;</td><td>4 x 7 Prototyping Area with 1.00 mm pitch </td></tr>
<tr>
<td>USB</td><td>Number of USB Connectors</td><td>N/A</td><td>USB</td><td>&lt;feature type="USB" n="2" name="Full-Speed USB Device, Micro-B receptacle"/&gt;</td><td>2 x Full-Speed USB Device, Micro-B receptacle </td></tr>
<tr>
<td>ETH</td><td>Number of Ethernet Connectors</td><td>Data Rate in Bit/s</td><td>Ethernet</td><td>&lt;feature type="ETH" n="1" m="10000000" name="RJ45 Receptacle"/&gt;</td><td>1 x 10 Mbit/s RJ45 Receptacle </td></tr>
<tr>
<td>SPI</td><td>Number of SPI Connectors</td><td>N/A</td><td>SPI</td><td>&lt;feature type="SPI" n="1" name="4-Pin Header, 1.27 mm Pitch"/&gt;</td><td>1 x 4-Pin Header, 1.27 mm Pitch </td></tr>
<tr>
<td>I2C</td><td>Number of I2C Connectors</td><td>N/A</td><td>I2C</td><td>&lt;feature type="I2C" n="1" name="2-Pin Header, 1.27 mm Pitch"/&gt;</td><td>1 x 2-Pin Header, 1.27 mm Pitch </td></tr>
<tr>
<td>RS232</td><td>Number of RS232 Connectors</td><td>N/A</td><td>RS232</td><td>&lt;feature type="RS232" n="1" name="DB9 Male Connector"/&gt;</td><td>1 x DB9 Male Connector </td></tr>
<tr>
<td>RS422</td><td>Number of RS422 Connectors</td><td>N/A</td><td>RS422</td><td>&lt;feature type="RS422" n="1" name="4-Pin Header, 1.27 mm Pitch"/&gt;</td><td>1 x 4-Pin Header, 1.27 mm Pitch </td></tr>
<tr>
<td>RS485</td><td>Number of RS485 Connectors</td><td>N/A</td><td>RS485</td><td>&lt;feature type="RS485" n="1" name="DB9 Male Connector"/&gt;</td><td>1 x DB9 Male Connector </td></tr>
<tr>
<td>CAN</td><td>Number of CAN Connectors</td><td>N/A</td><td>CAN</td><td>&lt;feature type="CAN" n="1" name="DB9 Male Connector"/&gt;</td><td>1 x DB9 Male Connector </td></tr>
<tr>
<td>IrDA</td><td>Number of IrDA Diodes</td><td>N/A</td><td>Diode</td><td>&lt;feature type="IrDA" n="1" name="Diode Transceiver"/&gt;</td><td>1 x Diode Transceiver </td></tr>
<tr>
<td>LineIn</td><td>Number of Line In Jacks</td><td>N/A</td><td>Line In</td><td>&lt;feature type="LineIn" n="1" name="TRS Audio Jack"/&gt;</td><td>1 x TRS Audio Jack </td></tr>
<tr>
<td>LineOut</td><td>Number of Line Out Jacks</td><td>N/A</td><td>Line Out</td><td>&lt;feature type="LineOut" n="1" name="TRS Audio Jack"/&gt;</td><td>1 x TRS Audio Jack </td></tr>
<tr>
<td>MIC</td><td>Number of Microphone Jacks</td><td>N/A</td><td>Microphone</td><td>&lt;feature type="MIC" n="1" name="TS Audio Jack (Mono)"/&gt;</td><td>1 x TS Audio Jack (Mono) </td></tr>
<tr>
<td>Edge</td><td>n Rows</td><td>m Columns</td><td>Edge</td><td>&lt;feature type="Edge" n="2" m="24"/&gt;</td><td>2 x 24 Pin Edge </td></tr>
<tr>
<td>ConnOther</td><td>Number of Other Connectors</td><td>N/A</td><td>Other Connector Type</td><td>&lt;feature type="ConnOther" n="1" name="My Other Connector"/&gt;</td><td>1 x My Other Connector </td></tr>
<tr>
<td>Button</td><td>Number of Push-Buttons</td><td>N/A</td><td>Push-buttons</td><td>&lt;feature type="Button" n="3" name="Push-buttons: Reset, Wake Up, User"/&gt;</td><td>3 Push-buttons: Reset, Wake Up, User </td></tr>
<tr>
<td>Poti</td><td>Number of Potentiometer</td><td>N/A</td><td>Potentiometer</td><td>&lt;feature type="Poti" n="1"/&gt;</td><td>1 x Potentiometer </td></tr>
<tr>
<td>Joystick</td><td>Number of Joysticks</td><td>N/A</td><td>Joystick</td><td>&lt;feature type="Joystick" n="1" name="5-position Joystick"/&gt;</td><td>1 x 5-position Joystick </td></tr>
<tr>
<td>Touch</td><td>Number of Touch Keys</td><td>N/A</td><td>Touch Keys/Area</td><td>&lt;feature type="Touch" n="1"/&gt;</td><td>1 x Touch Keys/Area </td></tr>
<tr>
<td>ContOther</td><td>Number of Other Controls</td><td>N/A</td><td>Other Control</td><td>&lt;feature type="ContOther" n=1 name="My Other Control Feature"/&gt;</td><td>1 x My Other Control Feature </td></tr>
<tr>
<td>Accelerometer</td><td>Number of Accelerometer</td><td>N/A</td><td>Accelerometer</td><td>&lt;feature type="Accelerometer" n="1" name="3-axis digital Accelerometer"/&gt;</td><td>1 x 3-axis digital Accelerometer </td></tr>
<tr>
<td>Gyro</td><td>Number of Gyroscopes</td><td>N/A</td><td>Gyroscope</td><td>&lt;feature type="Gyro" n="1" name="3-axis digital Gyroscope"/&gt;</td><td>1 x 3-axis digital Gyroscope </td></tr>
<tr>
<td>Compass</td><td>Number of Compass</td><td>N/A</td><td>Digital Compass</td><td>&lt;feature type="Compass" n="1" name="High-Precision Digital Compass"/&gt;</td><td>1 x High-Precision Digital Compass </td></tr>
<tr>
<td>TempSens</td><td>Number of Temperature Sensors</td><td>N/A</td><td>Temperature Sensor</td><td>&lt;feature type="TempSens" n="1"/&gt;</td><td>1 x Temperature Sensor </td></tr>
<tr>
<td>PressSens</td><td>Number of Pressure Sensors</td><td>N/A</td><td>Pressure Sensor</td><td>&lt;feature type="PressSens" n="1"/&gt;</td><td>1 x Pressure Sensor </td></tr>
<tr>
<td>LightSens</td><td>Number of Light Sensors</td><td>N/A</td><td>Ambient Light Sensor</td><td>&lt;feature type="LightSens" n="1"/&gt;</td><td>1 x Ambient Light Sensor </td></tr>
<tr>
<td>SensOther</td><td>Number of Other Sensors</td><td>N/A</td><td>Other Sensor</td><td>&lt;feature type="SensOther" n=1 name="My Other Sensor Feature"/&gt;</td><td>1 x My Other Sensor Feature </td></tr>
<tr>
<td>CustomFF</td><td>x [mm]</td><td>y [mm]</td><td>Custom Formfactor</td><td>&lt;feature type="CustomFF" n="54" m="26" name="40-Pin DIP with 0.1-inch Pitch"/&gt;</td><td>54 mm x 26 mm, 40-Pin DIP with 0.1-inch Pitch </td></tr>
<tr>
<td>ArduinoFF</td><td>1</td><td>N/A</td><td>Arduino Formfactor</td><td>&lt;feature type="ArduinoFF" n="1"/&gt;</td><td>Arduino Formfactor </td></tr>
<tr>
<td>FreedomFF</td><td>1</td><td>N/A</td><td>Freedom Formfactor</td><td>&lt;feature type="FreedomFF" n="1"/&gt;</td><td>Freedom Formfactor </td></tr>
<tr>
<td>TowerFF</td><td>1</td><td>N/A</td><td>Tower Formfactor</td><td>&lt;feature type="TowerFF" n="1"/&gt;</td><td>Tower Formfactor </td></tr>
<tr>
<td>LED</td><td>Number of LEDs</td><td>N/A</td><td>LEDs</td><td>&lt;feature type="LED" n="3" name="Multicolor LEDs"/&gt;</td><td>3 x Multicolor LEDs </td></tr>
<tr>
<td>Camera</td><td>Number of Camera Interfaces</td><td>N/A</td><td>Camera</td><td>&lt;feature type="Camera" n="1" name="Digital VGA Camera"/&gt;</td><td>1 x Digital VGA Camera </td></tr>
<tr>
<td>LCD</td><td>Number of Segment LCD Controller</td><td>Com.Seg as a decimal number (see example)</td><td>LCD</td><td>&lt;feature type="LCD" n="1" m="16.40" name="Segment LCD Controller"/&gt;</td><td>1 x 16 x 40 Segment LCD Controller </td></tr>
<tr>
<td>GLCD</td><td>Number of Graphic LCD Controller</td><td>Maximum Resolution as a decimal number (see example)</td><td>GLCD</td><td>&lt;feature type="GLCD" n="1" m="320.240" name="2.4 inch Color TFT LCD with resistive touchscreen"/&gt;</td><td>320 x 240 Pixel 2.4 inch Color TFT LCD with resistive touchscreen </td></tr>
<tr>
<td>Speaker</td><td>Number of Speakers</td><td>N/A</td><td>Speaker</td><td>&lt;feature type="Speaker" n="1"/&gt;</td><td>1 x Speaker </td></tr>
<tr>
<td>Other</td><td>Number of Other Features</td><td>N/A</td><td>Other Feature</td><td>&lt;feature type="Other" n=1 name="My Other Feature"/&gt;</td><td>1 x My Other Feature </td></tr>
</table>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_board_mountedDevice"></a>
/package/boards/board/mountedDevice</h1>
<p>The element specifies the devices mounted on the board. At least one device must be specified.</p>
<p><b>Example</b> </p>
<div class="fragment"><div class="line">&lt;mountedDevice deviceIndex=<span class="stringliteral">&quot;0&quot;</span> Dvendor=<span class="stringliteral">&quot;STMicroelectronics:13&quot;</span> Dname=<span class="stringliteral">&quot;STM32F429ZI&quot;</span>/&gt;</div>
</div><!-- fragment --> <p>&#160;</p>
<table class="cmtable" summary="Element: Boards mountedDevice">
<tr>
<th>Parent </th><th colspan="3">Chain </th></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board">board</a> </td><td colspan="3"><a class="el" href="pdsc_boards_pg.html#element_board">/package/boards/board</a> </td></tr>
<tr>
<th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
<tr>
<td>deviceIndex </td><td>Index number of the device (in case more than one device is present on the board). </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>Dvendor </td><td>Is the name of vendor of the device specified by <span class="XML-Token">Dname</span>. Use predefined values as listed in the table <a class="el" href="pdsc_family_pg.html#DeviceVendorEnum">Device Vendor</a>. </td><td>DeviceVendorEnum </td><td>required </td></tr>
<tr>
<td>Dfamily </td><td>Is the name of the target device family used on the board. </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>DsubFamily </td><td>Is the name of the target device sub family used on the board. </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>Dname </td><td>Is the name of the target device used on the board. </td><td>xs:string </td><td>optional </td></tr>
</table>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_board_compatibleDevice"></a>
/package/boards/board/compatibleDevice</h1>
<p>This element contains information about devices that are compatible to the device used on the board. Compatible means that the user is able to generate code for compatible devices and test it on the development board. At least one compatible device must be specified.</p>
<p><b>Example</b> </p>
<div class="fragment"><div class="line">&lt;compatibleDevice deviceIndex=<span class="stringliteral">&quot;0&quot;</span> Dvendor=<span class="stringliteral">&quot;STMicroelectronics:13&quot;</span> Dfamily=<span class="stringliteral">&quot;STM32F4 Series&quot;</span> DsubFamily=<span class="stringliteral">&quot;STM32F429 Line&quot;</span>/&gt;</div>
</div><!-- fragment --> <p>&#160;</p>
<table class="cmtable" summary="Element: Board compatibleDevice">
<tr>
<th>Parent </th><th colspan="3">Chain </th></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board">board</a> </td><td colspan="3"><a class="el" href="pdsc_boards_pg.html#element_board">/package/boards/board</a> </td></tr>
<tr>
<th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
<tr>
<td>deviceIndex </td><td>Index number of the device (in case more than one device is present on the board). </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>Dvendor </td><td>Vendor name of the target device specified by <b>Dname</b>. Use predefined values as listed in the table <a class="el" href="pdsc_family_pg.html#DeviceVendorEnum">Device Vendor</a>. This element is required if at least one of the following attributs is defined: <b>Dname</b>, <b>DsubFamily</b>, <b>Dfamily</b>. </td><td>DeviceVendorEnum </td><td>optional </td></tr>
<tr>
<td>Dfamily </td><td>Name of the target device family used on the board. Requires <b>Dvendor</b> to be specified. </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>DsubFamily </td><td>Name of the target device sub-family used on the board. Requires <b>Dvendor</b> to be specified. </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>Dname </td><td>Name of the target device used on the board. Requires <b>Dvendor</b> to be specified. </td><td>xs:string </td><td>optional </td></tr>
</table>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_board_image"></a>
/package/boards/board/image</h1>
<p>This element specifies the picture of a development board. Maximum one image element can be specified. None must be specified. Two different picture types (<span class="XML-Token">small</span> and <span class="XML-Token">large</span>) can be specified for the same image element at the same time.</p>
<p><b>Example:</b> </p>
<div class="fragment"><div class="line">&lt;image small=<span class="stringliteral">&quot;Images\board_image_small.png&quot;</span> large=<span class="stringliteral">&quot;Images\board_image.png&quot;</span>/&gt;</div>
</div><!-- fragment --> <p>&#160;</p>
<table class="cmtable" summary="Element: Board Image">
<tr>
<th>Parent </th><th colspan="3">Chain </th></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board">board</a> </td><td colspan="3"><a class="el" href="pdsc_boards_pg.html#element_board">/package/boards/board</a> </td></tr>
<tr>
<th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
<tr>
<td>small </td><td>Specifies the path to a small image. The path is relative to the Pack base directory. </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>large </td><td>Specifies the path to a large image. The path is relative to the Pack base directory. </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>public </td><td>Set publishing permissions for the documentation. If <em>&lt;public&gt;</em> is <span class="XML-Token">true</span>, then the vendor gives permission to extract the documentation from the Pack and publish it on a web-page. Links to web pages are assumed to be public. The default value is <span class="XML-Token">false</span>. </td><td>xs:boolean </td><td>optional </td></tr>
</table>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_board_debugInterface"></a>
/package/boards/board/debugInterface</h1>
<p>This element describes the debug interface of a board. At least debug interface must be specified.</p>
<p><b>Example</b> </p>
<div class="fragment"><div class="line">&lt;debugInterface adapter=<span class="stringliteral">&quot;JTAG/SW&quot;</span> connector=<span class="stringliteral">&quot;20-pin Arm Standard JTAG Connector (0.1 inch connector)&quot;</span>/&gt;</div>
<div class="line">&lt;debugInterface adapter=<span class="stringliteral">&quot;JTAG/SW&quot;</span> connector=<span class="stringliteral">&quot;10-pin Cortex Debug Connector (0.05 inch connector)&quot;</span>/&gt;</div>
<div class="line">&lt;debugInterface adapter=<span class="stringliteral">&quot;JTAG/SW&quot;</span> connector=<span class="stringliteral">&quot;20-pin Cortex Debug + ETM Connector (0.05 inch connector)&quot;</span>/&gt;</div>
<div class="line">&lt;debugInterface adapter=<span class="stringliteral">&quot;ST-Link&quot;</span> connector=<span class="stringliteral">&quot;Mini-USB&quot;</span>/&gt;</div>
</div><!-- fragment --> <p>&#160;</p>
<table class="cmtable" summary="Element: BoardDebugInterface">
<tr>
<th>Parent </th><th colspan="3">Chain </th></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board">board</a> </td><td colspan="3"><a class="el" href="pdsc_boards_pg.html#element_board">/package/boards/board</a> </td></tr>
<tr>
<th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
<tr>
<td>adapter </td><td>String describing the debug adapter. Common adapters are: <span class="XML-Token">JTAG/SW</span> (for all adapters supporting JTAG and Serial-Wire Debug), <span class="XML-Token">CMSIS-DAP</span>, <span class="XML-Token">OpenSDA</span>, <span class="XML-Token">J-Link</span>, <span class="XML-Token">ST-Link</span>, <span class="XML-Token">Nu-Link</span>. </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>connector </td><td>String describing the debug connector. Usually one of these: <span class="XML-Token">10-pin Cortex Debug Connector</span>, <span class="XML-Token">20-pin Arm Standard JTAG Connector</span>, <span class="XML-Token">20-pin Cortex Debug + ETM Connector</span>, <span class="XML-Token">Mini-USB</span>, <span class="XML-Token">Micro-USB</span>. </td><td>xs:string </td><td>optional </td></tr>
</table>
<p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_board_book"></a>
/package/boards/board/book</h1>
<p>The element provides information about documentation parts related to a development board. At least one book must be defined.</p>
<p><b>Example</b> </p>
<div class="fragment"><div class="line">&lt;book category=<span class="stringliteral">&quot;setup&quot;</span> name=<span class="stringliteral">&quot;Documents/UM1662.pdf&quot;</span> title=<span class="stringliteral">&quot;Getting Started&quot;</span>/&gt;</div>
</div><!-- fragment --> <p>&#160;</p>
<table class="cmtable" summary="Element: Books">
<tr>
<th>Parent </th><th colspan="3">Chain </th></tr>
<tr>
<td><a class="el" href="pdsc_boards_pg.html#element_board">board</a> </td><td colspan="3"><a class="el" href="pdsc_boards_pg.html#element_board">/package/boards/board</a> </td></tr>
<tr>
<th>Attributes </th><th>Description </th><th>Type </th><th>Use </th></tr>
<tr>
<td>category </td><td>Describes the type of documentation. Use predefined values as defined in the table <a class="el" href="pdsc_boards_pg.html#BoardBookCategoryEnum">Board Book Categories</a>. </td><td>BoardBookCategoryEnum </td><td>optional </td></tr>
<tr>
<td>name </td><td>Is the name of the document (including the path within the Pack). </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>title </td><td>Is the title of the document to be displayed in the <b>Books</b> window of uVision. </td><td>xs:string </td><td>optional </td></tr>
<tr>
<td>public </td><td>Set publishing permissions for the documentation. If <em>&lt;public&gt;</em> is <span class="XML-Token">true</span>, then the vendor gives permission to extract the documentation from the pack and publish it on a web-page. Links to web pages are assumed to be public. The default value is <span class="XML-Token">false</span>. </td><td>xs:boolean </td><td>optional </td></tr>
</table>
<p>&#160;</p>
<p><a class="anchor" id="BoardBookCategoryEnum"></a><b>Table: Board Book Categories</b></p>
<p>The table lists values to identify a specific type of documentation for development boards. </p>
<table class="cmtable" summary="Type: BoardBookCategoryEnum">
<tr>
<th>category= </th><th>Description </th></tr>
<tr>
<td class="XML-Token">setup </td><td>Documentation about how to setup the development board. </td></tr>
<tr>
<td class="XML-Token">schematic </td><td>Schematics of the development board. </td></tr>
<tr>
<td class="XML-Token">overview </td><td>Overview/data sheet of the development board. </td></tr>
<tr>
<td class="XML-Token">manual </td><td>User manual of the development board </td></tr>
<tr>
<td class="XML-Token">layout </td><td>PCB layout file of the board (e.g. in Gerber format) </td></tr>
<tr>
<td class="XML-Token">other </td><td>All other documentation. </td></tr>
</table>
<p>&#160;</p>
</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:01 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>