| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805 |
- <!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>CMSIS-DAP Hardware I/O Pin Access</title>
- <title>CMSIS-DAP: CMSIS-DAP Hardware I/O Pin Access</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-DAP
-  <span id="projectnumber">Version 1.1.0</span>
- </div>
- <div id="projectbrief">Interface Firmware for CoreSight Debug Access Port</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 Page</span></a></li>
- <li><a href="pages.html"><span>Usage and Description</span></a></li>
- <li><a href="modules.html"><span>Reference</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('group__DAP__Config__PortIO__gr.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"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </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="summary">
- <a href="#func-members">Functions</a> </div>
- <div class="headertitle">
- <div class="title">CMSIS-DAP Hardware I/O Pin Access<div class="ingroups"><a class="el" href="group__DAP__ConfigIO__gr.html">Configure I/O Ports and Debug Unit</a></div></div> </div>
- </div><!--header-->
- <div class="contents">
- <p>Standard I/O Pins of the CMSIS-DAP Hardware Debug Port support standard JTAG mode and Serial Wire Debug (SWD) mode.
- <a href="#details">More...</a></p>
- <table class="memberdecls">
- <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
- Functions</h2></td></tr>
- <tr class="memitem:ga33c16f83b54b07e2a62bb3423341537e"><td class="memItemLeft" align="right" valign="top">static __inline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga33c16f83b54b07e2a62bb3423341537e">PORT_JTAG_SETUP</a> (void)</td></tr>
- <tr class="memdesc:ga33c16f83b54b07e2a62bb3423341537e"><td class="mdescLeft"> </td><td class="mdescRight">Setup JTAG I/O pins: TCK, TMS, TDI, TDO, nTRST, and nRESET. <a href="#ga33c16f83b54b07e2a62bb3423341537e">More...</a><br/></td></tr>
- <tr class="separator:ga33c16f83b54b07e2a62bb3423341537e"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gab8876acfd193c31fbe5246ca6ba9249e"><td class="memItemLeft" align="right" valign="top">static __inline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#gab8876acfd193c31fbe5246ca6ba9249e">PORT_SWD_SETUP</a> (void)</td></tr>
- <tr class="memdesc:gab8876acfd193c31fbe5246ca6ba9249e"><td class="mdescLeft"> </td><td class="mdescRight">Setup SWD I/O pins: SWCLK, SWDIO, and nRESET. <a href="#gab8876acfd193c31fbe5246ca6ba9249e">More...</a><br/></td></tr>
- <tr class="separator:gab8876acfd193c31fbe5246ca6ba9249e"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga6522dd62895ffbb299294ec0b7c1b316"><td class="memItemLeft" align="right" valign="top">static __inline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga6522dd62895ffbb299294ec0b7c1b316">PORT_OFF</a> (void)</td></tr>
- <tr class="memdesc:ga6522dd62895ffbb299294ec0b7c1b316"><td class="mdescLeft"> </td><td class="mdescRight">Disable JTAG/SWD I/O Pins. <a href="#ga6522dd62895ffbb299294ec0b7c1b316">More...</a><br/></td></tr>
- <tr class="separator:ga6522dd62895ffbb299294ec0b7c1b316"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gaac4a182db3a1f3a3de04280dccb8d9d3"><td class="memItemLeft" align="right" valign="top">static __forceinline uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#gaac4a182db3a1f3a3de04280dccb8d9d3">PIN_SWCLK_TCK_IN</a> (void)</td></tr>
- <tr class="memdesc:gaac4a182db3a1f3a3de04280dccb8d9d3"><td class="mdescLeft"> </td><td class="mdescRight">SWCLK/TCK I/O pin: Get Input. <a href="#gaac4a182db3a1f3a3de04280dccb8d9d3">More...</a><br/></td></tr>
- <tr class="separator:gaac4a182db3a1f3a3de04280dccb8d9d3"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga197ad2824c91a8ea9ad0132951125217"><td class="memItemLeft" align="right" valign="top">static __forceinline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga197ad2824c91a8ea9ad0132951125217">PIN_SWCLK_TCK_SET</a> (void)</td></tr>
- <tr class="memdesc:ga197ad2824c91a8ea9ad0132951125217"><td class="mdescLeft"> </td><td class="mdescRight">SWCLK/TCK I/O pin: Set Output to High. <a href="#ga197ad2824c91a8ea9ad0132951125217">More...</a><br/></td></tr>
- <tr class="separator:ga197ad2824c91a8ea9ad0132951125217"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gac95e157f51e8073cf740761bf59f09f3"><td class="memItemLeft" align="right" valign="top">static __forceinline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#gac95e157f51e8073cf740761bf59f09f3">PIN_SWCLK_TCK_CLR</a> (void)</td></tr>
- <tr class="memdesc:gac95e157f51e8073cf740761bf59f09f3"><td class="mdescLeft"> </td><td class="mdescRight">SWCLK/TCK I/O pin: Set Output to Low. <a href="#gac95e157f51e8073cf740761bf59f09f3">More...</a><br/></td></tr>
- <tr class="separator:gac95e157f51e8073cf740761bf59f09f3"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gaef0a34cb4eb3882c7ae05b9e1b0b7574"><td class="memItemLeft" align="right" valign="top">static __forceinline uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#gaef0a34cb4eb3882c7ae05b9e1b0b7574">PIN_SWDIO_TMS_IN</a> (void)</td></tr>
- <tr class="memdesc:gaef0a34cb4eb3882c7ae05b9e1b0b7574"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO/TMS I/O pin: Get Input. <a href="#gaef0a34cb4eb3882c7ae05b9e1b0b7574">More...</a><br/></td></tr>
- <tr class="separator:gaef0a34cb4eb3882c7ae05b9e1b0b7574"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gaad5e63cde6ce0b523d66ab4e05f974e7"><td class="memItemLeft" align="right" valign="top">static __forceinline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#gaad5e63cde6ce0b523d66ab4e05f974e7">PIN_SWDIO_TMS_SET</a> (void)</td></tr>
- <tr class="memdesc:gaad5e63cde6ce0b523d66ab4e05f974e7"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO/TMS I/O pin: Set Output to High. <a href="#gaad5e63cde6ce0b523d66ab4e05f974e7">More...</a><br/></td></tr>
- <tr class="separator:gaad5e63cde6ce0b523d66ab4e05f974e7"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gab29c2d8f97388bb6ba336bab41b0ca53"><td class="memItemLeft" align="right" valign="top">static __forceinline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#gab29c2d8f97388bb6ba336bab41b0ca53">PIN_SWDIO_TMS_CLR</a> (void)</td></tr>
- <tr class="memdesc:gab29c2d8f97388bb6ba336bab41b0ca53"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO/TMS I/O pin: Set Output to Low. <a href="#gab29c2d8f97388bb6ba336bab41b0ca53">More...</a><br/></td></tr>
- <tr class="separator:gab29c2d8f97388bb6ba336bab41b0ca53"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga545a6a01ae522683c32e830683511c17"><td class="memItemLeft" align="right" valign="top">static __forceinline uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga545a6a01ae522683c32e830683511c17">PIN_SWDIO_IN</a> (void)</td></tr>
- <tr class="memdesc:ga545a6a01ae522683c32e830683511c17"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO I/O pin: Get Input (used in SWD mode only). <a href="#ga545a6a01ae522683c32e830683511c17">More...</a><br/></td></tr>
- <tr class="separator:ga545a6a01ae522683c32e830683511c17"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga5e163176ee6bc9925f8f702d27d08f96"><td class="memItemLeft" align="right" valign="top">static __forceinline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga5e163176ee6bc9925f8f702d27d08f96">PIN_SWDIO_OUT</a> (uint32_t bit)</td></tr>
- <tr class="memdesc:ga5e163176ee6bc9925f8f702d27d08f96"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO I/O pin: Set Output (used in SWD mode only). <a href="#ga5e163176ee6bc9925f8f702d27d08f96">More...</a><br/></td></tr>
- <tr class="separator:ga5e163176ee6bc9925f8f702d27d08f96"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga3fd30f1eb2feb4bb52d3c7e8c373d4d9"><td class="memItemLeft" align="right" valign="top">static __forceinline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga3fd30f1eb2feb4bb52d3c7e8c373d4d9">PIN_SWDIO_OUT_ENABLE</a> (void)</td></tr>
- <tr class="memdesc:ga3fd30f1eb2feb4bb52d3c7e8c373d4d9"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO I/O pin: Switch to Output mode (used in SWD mode only). <a href="#ga3fd30f1eb2feb4bb52d3c7e8c373d4d9">More...</a><br/></td></tr>
- <tr class="separator:ga3fd30f1eb2feb4bb52d3c7e8c373d4d9"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga1fb4b84b48b39bcc28790cb45abb0c59"><td class="memItemLeft" align="right" valign="top">static __forceinline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga1fb4b84b48b39bcc28790cb45abb0c59">PIN_SWDIO_OUT_DISABLE</a> (void)</td></tr>
- <tr class="memdesc:ga1fb4b84b48b39bcc28790cb45abb0c59"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO I/O pin: Switch to Input mode (used in SWD mode only). <a href="#ga1fb4b84b48b39bcc28790cb45abb0c59">More...</a><br/></td></tr>
- <tr class="separator:ga1fb4b84b48b39bcc28790cb45abb0c59"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gaffb848049cb9da42e55731aa40c35429"><td class="memItemLeft" align="right" valign="top">static __forceinline uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#gaffb848049cb9da42e55731aa40c35429">PIN_TDI_IN</a> (void)</td></tr>
- <tr class="memdesc:gaffb848049cb9da42e55731aa40c35429"><td class="mdescLeft"> </td><td class="mdescRight">TDI I/O pin: Get Input. <a href="#gaffb848049cb9da42e55731aa40c35429">More...</a><br/></td></tr>
- <tr class="separator:gaffb848049cb9da42e55731aa40c35429"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga57bf14c857b0c2d0227f2fd2a588c03b"><td class="memItemLeft" align="right" valign="top">static __forceinline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga57bf14c857b0c2d0227f2fd2a588c03b">PIN_TDI_OUT</a> (uint32_t bit)</td></tr>
- <tr class="memdesc:ga57bf14c857b0c2d0227f2fd2a588c03b"><td class="mdescLeft"> </td><td class="mdescRight">TDI I/O pin: Set Output. <a href="#ga57bf14c857b0c2d0227f2fd2a588c03b">More...</a><br/></td></tr>
- <tr class="separator:ga57bf14c857b0c2d0227f2fd2a588c03b"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga8f34a3b7d1c1ecdf7dbc0c527e16c0e5"><td class="memItemLeft" align="right" valign="top">static __forceinline uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga8f34a3b7d1c1ecdf7dbc0c527e16c0e5">PIN_TDO_IN</a> (void)</td></tr>
- <tr class="memdesc:ga8f34a3b7d1c1ecdf7dbc0c527e16c0e5"><td class="mdescLeft"> </td><td class="mdescRight">TDO I/O pin: Get Input. <a href="#ga8f34a3b7d1c1ecdf7dbc0c527e16c0e5">More...</a><br/></td></tr>
- <tr class="separator:ga8f34a3b7d1c1ecdf7dbc0c527e16c0e5"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gaa3849d1a7cc9945c05578bc4616f3e63"><td class="memItemLeft" align="right" valign="top">static __forceinline uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#gaa3849d1a7cc9945c05578bc4616f3e63">PIN_nTRST_IN</a> (void)</td></tr>
- <tr class="memdesc:gaa3849d1a7cc9945c05578bc4616f3e63"><td class="mdescLeft"> </td><td class="mdescRight">nTRST I/O pin: Get Input. <a href="#gaa3849d1a7cc9945c05578bc4616f3e63">More...</a><br/></td></tr>
- <tr class="separator:gaa3849d1a7cc9945c05578bc4616f3e63"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga4eebf6aa9628de5176632db0458cd234"><td class="memItemLeft" align="right" valign="top">static __forceinline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga4eebf6aa9628de5176632db0458cd234">PIN_nTRST_OUT</a> (uint32_t bit)</td></tr>
- <tr class="memdesc:ga4eebf6aa9628de5176632db0458cd234"><td class="mdescLeft"> </td><td class="mdescRight">nTRST I/O pin: Set Output. <a href="#ga4eebf6aa9628de5176632db0458cd234">More...</a><br/></td></tr>
- <tr class="separator:ga4eebf6aa9628de5176632db0458cd234"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gad0de1a17d02af9a9959e4031d58b1eca"><td class="memItemLeft" align="right" valign="top">static __forceinline uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#gad0de1a17d02af9a9959e4031d58b1eca">PIN_nRESET_IN</a> (void)</td></tr>
- <tr class="memdesc:gad0de1a17d02af9a9959e4031d58b1eca"><td class="mdescLeft"> </td><td class="mdescRight">nRESET I/O pin: Get Input. <a href="#gad0de1a17d02af9a9959e4031d58b1eca">More...</a><br/></td></tr>
- <tr class="separator:gad0de1a17d02af9a9959e4031d58b1eca"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga6764592e610237a3e325ebaecba83760"><td class="memItemLeft" align="right" valign="top">static __forceinline void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DAP__Config__PortIO__gr.html#ga6764592e610237a3e325ebaecba83760">PIN_nRESET_OUT</a> (uint32_t bit)</td></tr>
- <tr class="memdesc:ga6764592e610237a3e325ebaecba83760"><td class="mdescLeft"> </td><td class="mdescRight">nRESET I/O pin: Set Output. <a href="#ga6764592e610237a3e325ebaecba83760">More...</a><br/></td></tr>
- <tr class="separator:ga6764592e610237a3e325ebaecba83760"><td class="memSeparator" colspan="2"> </td></tr>
- </table>
- <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
- <p>Standard I/O Pins of the CMSIS-DAP Hardware Debug Port support standard JTAG mode and Serial Wire Debug (SWD) mode. </p>
- <p>In SWD mode only 2 pins are required to implement the debug interface of a device. The following I/O Pins are provided:</p>
- <table class="doxtable">
- <tr>
- <th>JTAG I/O Pin </th><th>SWD I/O Pin </th><th>CMSIS-DAP Hardware pin mode </th></tr>
- <tr>
- <td>TCK: Test Clock </td><td>SWCLK: Clock </td><td>Output Push/Pull </td></tr>
- <tr>
- <td>TMS: Test Mode Select </td><td>SWDIO: Data I/O </td><td>Output Push/Pull; Input (for receiving data) </td></tr>
- <tr>
- <td>TDI: Test Data Input </td><td></td><td>Output Push/Pull </td></tr>
- <tr>
- <td>TDO: Test Data Output </td><td></td><td>Input </td></tr>
- <tr>
- <td>nTRST: Test Reset (optional) </td><td></td><td>Output Open Drain with pull-up resistor </td></tr>
- <tr>
- <td>nRESET: Device Reset </td><td>nRESET: Device Reset </td><td>Output Open Drain with pull-up resistor </td></tr>
- </table>
- <h2>DAP Hardware I/O Pin Access Functions </h2>
- <p>The various I/O Pins are accessed by functions that implement the Read, Write, Set, or Clear to these I/O Pins.</p>
- <p>For the SWDIO I/O Pin there are additional functions that are called in SWD I/O mode only. This functions are provided to achieve faster I/O that is possible with some advanced GPIO peripherals that can independently write/read a single I/O pin without affecting any other pins of the same I/O port. The following SWDIO I/O Pin functions are provided:</p>
- <ul>
- <li><a class="el" href="group__DAP__Config__PortIO__gr.html#ga3fd30f1eb2feb4bb52d3c7e8c373d4d9">PIN_SWDIO_OUT_ENABLE</a> to enable the output mode from the DAP hardware.</li>
- <li><a class="el" href="group__DAP__Config__PortIO__gr.html#ga1fb4b84b48b39bcc28790cb45abb0c59">PIN_SWDIO_OUT_DISABLE</a> to enable the input mode to the DAP hardware.</li>
- <li><a class="el" href="group__DAP__Config__PortIO__gr.html#ga545a6a01ae522683c32e830683511c17">PIN_SWDIO_IN</a> to read from the SWDIO I/O pin with utmost possible speed.</li>
- <li><a class="el" href="group__DAP__Config__PortIO__gr.html#ga5e163176ee6bc9925f8f702d27d08f96">PIN_SWDIO_OUT</a> to write to the SWDIO I/O pin with utmost possible speed. </li>
- </ul>
- <h2 class="groupheader">Function Documentation</h2>
- <a class="anchor" id="gad0de1a17d02af9a9959e4031d58b1eca"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline uint32_t PIN_nRESET_IN </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>nRESET I/O pin: Get Input. </p>
- <dl class="section return"><dt>Returns</dt><dd>Current status of the nRESET DAP hardware I/O pin. </dd></dl>
- </div>
- </div>
- <a class="anchor" id="ga6764592e610237a3e325ebaecba83760"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline void PIN_nRESET_OUT </td>
- <td>(</td>
- <td class="paramtype">uint32_t </td>
- <td class="paramname"><em>bit</em></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>nRESET I/O pin: Set Output. </p>
- <dl class="params"><dt>Parameters</dt><dd>
- <table class="params">
- <tr><td class="paramname">bit</td><td>target device hardware reset pin status:<ul>
- <li>0: issue a device hardware reset.</li>
- <li>1: release device hardware reset. </li>
- </ul>
- </td></tr>
- </table>
- </dd>
- </dl>
- </div>
- </div>
- <a class="anchor" id="gaa3849d1a7cc9945c05578bc4616f3e63"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline uint32_t PIN_nTRST_IN </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>nTRST I/O pin: Get Input. </p>
- <dl class="section return"><dt>Returns</dt><dd>Current status of the nTRST DAP hardware I/O pin. </dd></dl>
- </div>
- </div>
- <a class="anchor" id="ga4eebf6aa9628de5176632db0458cd234"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline void PIN_nTRST_OUT </td>
- <td>(</td>
- <td class="paramtype">uint32_t </td>
- <td class="paramname"><em>bit</em></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>nTRST I/O pin: Set Output. </p>
- <dl class="params"><dt>Parameters</dt><dd>
- <table class="params">
- <tr><td class="paramname">bit</td><td>JTAG TRST Test Reset pin status:<ul>
- <li>0: issue a JTAG TRST Test Reset.</li>
- <li>1: release JTAG TRST Test Reset. </li>
- </ul>
- </td></tr>
- </table>
- </dd>
- </dl>
- </div>
- </div>
- <a class="anchor" id="gac95e157f51e8073cf740761bf59f09f3"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline void PIN_SWCLK_TCK_CLR </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>SWCLK/TCK I/O pin: Set Output to Low. </p>
- <p>Set the SWCLK/TCK DAP hardware I/O pin to low level. </p>
- </div>
- </div>
- <a class="anchor" id="gaac4a182db3a1f3a3de04280dccb8d9d3"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline uint32_t PIN_SWCLK_TCK_IN </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>SWCLK/TCK I/O pin: Get Input. </p>
- <dl class="section return"><dt>Returns</dt><dd>Current status of the SWCLK/TCK DAP hardware I/O pin. </dd></dl>
- </div>
- </div>
- <a class="anchor" id="ga197ad2824c91a8ea9ad0132951125217"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline void PIN_SWCLK_TCK_SET </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>SWCLK/TCK I/O pin: Set Output to High. </p>
- <p>Set the SWCLK/TCK DAP hardware I/O pin to high level. </p>
- </div>
- </div>
- <a class="anchor" id="ga545a6a01ae522683c32e830683511c17"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline uint32_t PIN_SWDIO_IN </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>SWDIO I/O pin: Get Input (used in SWD mode only). </p>
- <dl class="section return"><dt>Returns</dt><dd>Current status of the SWDIO DAP hardware I/O pin. </dd></dl>
- </div>
- </div>
- <a class="anchor" id="ga5e163176ee6bc9925f8f702d27d08f96"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline void PIN_SWDIO_OUT </td>
- <td>(</td>
- <td class="paramtype">uint32_t </td>
- <td class="paramname"><em>bit</em></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>SWDIO I/O pin: Set Output (used in SWD mode only). </p>
- <dl class="params"><dt>Parameters</dt><dd>
- <table class="params">
- <tr><td class="paramname">bit</td><td>Output value for the SWDIO DAP hardware I/O pin. </td></tr>
- </table>
- </dd>
- </dl>
- </div>
- </div>
- <a class="anchor" id="ga1fb4b84b48b39bcc28790cb45abb0c59"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline void PIN_SWDIO_OUT_DISABLE </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>SWDIO I/O pin: Switch to Input mode (used in SWD mode only). </p>
- <p>Configure the SWDIO DAP hardware I/O pin to input mode. This function is called prior <a class="el" href="group__DAP__Config__PortIO__gr.html#ga545a6a01ae522683c32e830683511c17">PIN_SWDIO_IN</a> function calls. </p>
- </div>
- </div>
- <a class="anchor" id="ga3fd30f1eb2feb4bb52d3c7e8c373d4d9"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline void PIN_SWDIO_OUT_ENABLE </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>SWDIO I/O pin: Switch to Output mode (used in SWD mode only). </p>
- <p>Configure the SWDIO DAP hardware I/O pin to output mode. This function is called prior <a class="el" href="group__DAP__Config__PortIO__gr.html#ga5e163176ee6bc9925f8f702d27d08f96">PIN_SWDIO_OUT</a> function calls. </p>
- </div>
- </div>
- <a class="anchor" id="gab29c2d8f97388bb6ba336bab41b0ca53"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline void PIN_SWDIO_TMS_CLR </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>SWDIO/TMS I/O pin: Set Output to Low. </p>
- <p>Set the SWDIO/TMS DAP hardware I/O pin to low level. </p>
- </div>
- </div>
- <a class="anchor" id="gaef0a34cb4eb3882c7ae05b9e1b0b7574"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline uint32_t PIN_SWDIO_TMS_IN </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>SWDIO/TMS I/O pin: Get Input. </p>
- <dl class="section return"><dt>Returns</dt><dd>Current status of the SWDIO/TMS DAP hardware I/O pin. </dd></dl>
- </div>
- </div>
- <a class="anchor" id="gaad5e63cde6ce0b523d66ab4e05f974e7"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline void PIN_SWDIO_TMS_SET </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>SWDIO/TMS I/O pin: Set Output to High. </p>
- <p>Set the SWDIO/TMS DAP hardware I/O pin to high level. </p>
- </div>
- </div>
- <a class="anchor" id="gaffb848049cb9da42e55731aa40c35429"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline uint32_t PIN_TDI_IN </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>TDI I/O pin: Get Input. </p>
- <dl class="section return"><dt>Returns</dt><dd>Current status of the TDI DAP hardware I/O pin. </dd></dl>
- </div>
- </div>
- <a class="anchor" id="ga57bf14c857b0c2d0227f2fd2a588c03b"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline void PIN_TDI_OUT </td>
- <td>(</td>
- <td class="paramtype">uint32_t </td>
- <td class="paramname"><em>bit</em></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>TDI I/O pin: Set Output. </p>
- <dl class="params"><dt>Parameters</dt><dd>
- <table class="params">
- <tr><td class="paramname">bit</td><td>Output value for the TDI DAP hardware I/O pin. </td></tr>
- </table>
- </dd>
- </dl>
- </div>
- </div>
- <a class="anchor" id="ga8f34a3b7d1c1ecdf7dbc0c527e16c0e5"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __forceinline uint32_t PIN_TDO_IN </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>TDO I/O pin: Get Input. </p>
- <dl class="section return"><dt>Returns</dt><dd>Current status of the TDO DAP hardware I/O pin. </dd></dl>
- </div>
- </div>
- <a class="anchor" id="ga33c16f83b54b07e2a62bb3423341537e"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __inline void PORT_JTAG_SETUP </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>Setup JTAG I/O pins: TCK, TMS, TDI, TDO, nTRST, and nRESET. </p>
- <p>Configures the DAP Hardware I/O pins for JTAG mode:</p>
- <ul>
- <li>TCK, TMS, TDI, nTRST, nRESET to output mode and set to high level.</li>
- <li>TDO to input mode. </li>
- </ul>
- </div>
- </div>
- <a class="anchor" id="ga6522dd62895ffbb299294ec0b7c1b316"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __inline void PORT_OFF </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>Disable JTAG/SWD I/O Pins. </p>
- <p>Disables the DAP Hardware I/O pins which configures:</p>
- <ul>
- <li>TCK/SWCLK, TMS/SWDIO, TDI, TDO, nTRST, nRESET to High-Z mode. </li>
- </ul>
- </div>
- </div>
- <a class="anchor" id="gab8876acfd193c31fbe5246ca6ba9249e"></a>
- <div class="memitem">
- <div class="memproto">
- <table class="mlabels">
- <tr>
- <td class="mlabels-left">
- <table class="memname">
- <tr>
- <td class="memname">static __inline void PORT_SWD_SETUP </td>
- <td>(</td>
- <td class="paramtype">void </td>
- <td class="paramname"></td><td>)</td>
- <td></td>
- </tr>
- </table>
- </td>
- <td class="mlabels-right">
- <span class="mlabels"><span class="mlabel">static</span></span> </td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>Setup SWD I/O pins: SWCLK, SWDIO, and nRESET. </p>
- <p>Configures the DAP Hardware I/O pins for Serial Wire Debug (SWD) mode:</p>
- <ul>
- <li>SWCLK, SWDIO, nRESET to output mode and set to default high level.</li>
- <li>TDI, nTRST to HighZ mode (pins are unused in SWD mode). </li>
- </ul>
- </div>
- </div>
- </div><!-- contents -->
- </div><!-- doc-content -->
- <!-- start footer part -->
- <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
- <ul>
- <li class="footer">Generated on Wed Feb 8 2017 10:20:42 for CMSIS-DAP 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>
|