| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645 |
- <!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 2.0.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:ga037d02e221d71916a83349d6572bf91d"><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#ga037d02e221d71916a83349d6572bf91d">PORT_JTAG_SETUP</a> (void)</td></tr>
- <tr class="memdesc:ga037d02e221d71916a83349d6572bf91d"><td class="mdescLeft"> </td><td class="mdescRight">Setup JTAG I/O pins: TCK, TMS, TDI, TDO, nTRST, and nRESET. <a href="#ga037d02e221d71916a83349d6572bf91d">More...</a><br/></td></tr>
- <tr class="separator:ga037d02e221d71916a83349d6572bf91d"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga08369d48fb874acdfb40726edaa3d147"><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#ga08369d48fb874acdfb40726edaa3d147">PORT_SWD_SETUP</a> (void)</td></tr>
- <tr class="memdesc:ga08369d48fb874acdfb40726edaa3d147"><td class="mdescLeft"> </td><td class="mdescRight">Setup SWD I/O pins: SWCLK, SWDIO, and nRESET. <a href="#ga08369d48fb874acdfb40726edaa3d147">More...</a><br/></td></tr>
- <tr class="separator:ga08369d48fb874acdfb40726edaa3d147"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gaf31b342bc0fc5ad3669f43888466db61"><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#gaf31b342bc0fc5ad3669f43888466db61">PORT_OFF</a> (void)</td></tr>
- <tr class="memdesc:gaf31b342bc0fc5ad3669f43888466db61"><td class="mdescLeft"> </td><td class="mdescRight">Disable JTAG/SWD I/O Pins. <a href="#gaf31b342bc0fc5ad3669f43888466db61">More...</a><br/></td></tr>
- <tr class="separator:gaf31b342bc0fc5ad3669f43888466db61"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gafc133887a94442c3bc4424909dff8512"><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#gafc133887a94442c3bc4424909dff8512">PIN_SWCLK_TCK_IN</a> (void)</td></tr>
- <tr class="memdesc:gafc133887a94442c3bc4424909dff8512"><td class="mdescLeft"> </td><td class="mdescRight">SWCLK/TCK I/O pin: Get Input. <a href="#gafc133887a94442c3bc4424909dff8512">More...</a><br/></td></tr>
- <tr class="separator:gafc133887a94442c3bc4424909dff8512"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga43481ea1fcc2e389761ccb78bf76b891"><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#ga43481ea1fcc2e389761ccb78bf76b891">PIN_SWCLK_TCK_SET</a> (void)</td></tr>
- <tr class="memdesc:ga43481ea1fcc2e389761ccb78bf76b891"><td class="mdescLeft"> </td><td class="mdescRight">SWCLK/TCK I/O pin: Set Output to High. <a href="#ga43481ea1fcc2e389761ccb78bf76b891">More...</a><br/></td></tr>
- <tr class="separator:ga43481ea1fcc2e389761ccb78bf76b891"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga9dcba97c6779b70dca02e51a36696a61"><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#ga9dcba97c6779b70dca02e51a36696a61">PIN_SWCLK_TCK_CLR</a> (void)</td></tr>
- <tr class="memdesc:ga9dcba97c6779b70dca02e51a36696a61"><td class="mdescLeft"> </td><td class="mdescRight">SWCLK/TCK I/O pin: Set Output to Low. <a href="#ga9dcba97c6779b70dca02e51a36696a61">More...</a><br/></td></tr>
- <tr class="separator:ga9dcba97c6779b70dca02e51a36696a61"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gaf127becf6c639beff822f83fbdef7761"><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#gaf127becf6c639beff822f83fbdef7761">PIN_SWDIO_TMS_IN</a> (void)</td></tr>
- <tr class="memdesc:gaf127becf6c639beff822f83fbdef7761"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO/TMS I/O pin: Get Input. <a href="#gaf127becf6c639beff822f83fbdef7761">More...</a><br/></td></tr>
- <tr class="separator:gaf127becf6c639beff822f83fbdef7761"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gaac7a2af102cc9fa9358d507c11cf9241"><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#gaac7a2af102cc9fa9358d507c11cf9241">PIN_SWDIO_TMS_SET</a> (void)</td></tr>
- <tr class="memdesc:gaac7a2af102cc9fa9358d507c11cf9241"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO/TMS I/O pin: Set Output to High. <a href="#gaac7a2af102cc9fa9358d507c11cf9241">More...</a><br/></td></tr>
- <tr class="separator:gaac7a2af102cc9fa9358d507c11cf9241"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga04aa6eb6186f50bb1ea7d991870f8670"><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#ga04aa6eb6186f50bb1ea7d991870f8670">PIN_SWDIO_TMS_CLR</a> (void)</td></tr>
- <tr class="memdesc:ga04aa6eb6186f50bb1ea7d991870f8670"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO/TMS I/O pin: Set Output to Low. <a href="#ga04aa6eb6186f50bb1ea7d991870f8670">More...</a><br/></td></tr>
- <tr class="separator:ga04aa6eb6186f50bb1ea7d991870f8670"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga6873b9000f9ec322626ecc06664fb229"><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#ga6873b9000f9ec322626ecc06664fb229">PIN_SWDIO_IN</a> (void)</td></tr>
- <tr class="memdesc:ga6873b9000f9ec322626ecc06664fb229"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO I/O pin: Get Input (used in SWD mode only). <a href="#ga6873b9000f9ec322626ecc06664fb229">More...</a><br/></td></tr>
- <tr class="separator:ga6873b9000f9ec322626ecc06664fb229"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga0c100894fc532bc05fc81f4128e06e23"><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#ga0c100894fc532bc05fc81f4128e06e23">PIN_SWDIO_OUT</a> (uint32_t bit)</td></tr>
- <tr class="memdesc:ga0c100894fc532bc05fc81f4128e06e23"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO I/O pin: Set Output (used in SWD mode only). <a href="#ga0c100894fc532bc05fc81f4128e06e23">More...</a><br/></td></tr>
- <tr class="separator:ga0c100894fc532bc05fc81f4128e06e23"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga130df1a24eef09b9e250e7e328f06e50"><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#ga130df1a24eef09b9e250e7e328f06e50">PIN_SWDIO_OUT_ENABLE</a> (void)</td></tr>
- <tr class="memdesc:ga130df1a24eef09b9e250e7e328f06e50"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO I/O pin: Switch to Output mode (used in SWD mode only). <a href="#ga130df1a24eef09b9e250e7e328f06e50">More...</a><br/></td></tr>
- <tr class="separator:ga130df1a24eef09b9e250e7e328f06e50"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga4873c485ca5e49efbb218f4f80a59a17"><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#ga4873c485ca5e49efbb218f4f80a59a17">PIN_SWDIO_OUT_DISABLE</a> (void)</td></tr>
- <tr class="memdesc:ga4873c485ca5e49efbb218f4f80a59a17"><td class="mdescLeft"> </td><td class="mdescRight">SWDIO I/O pin: Switch to Input mode (used in SWD mode only). <a href="#ga4873c485ca5e49efbb218f4f80a59a17">More...</a><br/></td></tr>
- <tr class="separator:ga4873c485ca5e49efbb218f4f80a59a17"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga2cea243a2dbbece100f15a7f1fb04e5c"><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#ga2cea243a2dbbece100f15a7f1fb04e5c">PIN_TDI_IN</a> (void)</td></tr>
- <tr class="memdesc:ga2cea243a2dbbece100f15a7f1fb04e5c"><td class="mdescLeft"> </td><td class="mdescRight">TDI I/O pin: Get Input. <a href="#ga2cea243a2dbbece100f15a7f1fb04e5c">More...</a><br/></td></tr>
- <tr class="separator:ga2cea243a2dbbece100f15a7f1fb04e5c"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gad40bb9c760000dfda7c533d63af3b4fa"><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#gad40bb9c760000dfda7c533d63af3b4fa">PIN_TDI_OUT</a> (uint32_t bit)</td></tr>
- <tr class="memdesc:gad40bb9c760000dfda7c533d63af3b4fa"><td class="mdescLeft"> </td><td class="mdescRight">TDI I/O pin: Set Output. <a href="#gad40bb9c760000dfda7c533d63af3b4fa">More...</a><br/></td></tr>
- <tr class="separator:gad40bb9c760000dfda7c533d63af3b4fa"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gace11527334bc4453e8407e44fc58f619"><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#gace11527334bc4453e8407e44fc58f619">PIN_TDO_IN</a> (void)</td></tr>
- <tr class="memdesc:gace11527334bc4453e8407e44fc58f619"><td class="mdescLeft"> </td><td class="mdescRight">TDO I/O pin: Get Input. <a href="#gace11527334bc4453e8407e44fc58f619">More...</a><br/></td></tr>
- <tr class="separator:gace11527334bc4453e8407e44fc58f619"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gabdce264d0e78ce31bcb2e91f97e49b2a"><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#gabdce264d0e78ce31bcb2e91f97e49b2a">PIN_nTRST_IN</a> (void)</td></tr>
- <tr class="memdesc:gabdce264d0e78ce31bcb2e91f97e49b2a"><td class="mdescLeft"> </td><td class="mdescRight">nTRST I/O pin: Get Input. <a href="#gabdce264d0e78ce31bcb2e91f97e49b2a">More...</a><br/></td></tr>
- <tr class="separator:gabdce264d0e78ce31bcb2e91f97e49b2a"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga190b2403a1bc0dc9a94b70622ed9de41"><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#ga190b2403a1bc0dc9a94b70622ed9de41">PIN_nTRST_OUT</a> (uint32_t bit)</td></tr>
- <tr class="memdesc:ga190b2403a1bc0dc9a94b70622ed9de41"><td class="mdescLeft"> </td><td class="mdescRight">nTRST I/O pin: Set Output. <a href="#ga190b2403a1bc0dc9a94b70622ed9de41">More...</a><br/></td></tr>
- <tr class="separator:ga190b2403a1bc0dc9a94b70622ed9de41"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ga401f5879824966071ba05fb1b4102626"><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#ga401f5879824966071ba05fb1b4102626">PIN_nRESET_IN</a> (void)</td></tr>
- <tr class="memdesc:ga401f5879824966071ba05fb1b4102626"><td class="mdescLeft"> </td><td class="mdescRight">nRESET I/O pin: Get Input. <a href="#ga401f5879824966071ba05fb1b4102626">More...</a><br/></td></tr>
- <tr class="separator:ga401f5879824966071ba05fb1b4102626"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:gacfe405b75aefcdf7c06b2b426595ea0a"><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#gacfe405b75aefcdf7c06b2b426595ea0a">PIN_nRESET_OUT</a> (uint32_t bit)</td></tr>
- <tr class="memdesc:gacfe405b75aefcdf7c06b2b426595ea0a"><td class="mdescLeft"> </td><td class="mdescRight">nRESET I/O pin: Set Output. <a href="#gacfe405b75aefcdf7c06b2b426595ea0a">More...</a><br/></td></tr>
- <tr class="separator:gacfe405b75aefcdf7c06b2b426595ea0a"><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#ga130df1a24eef09b9e250e7e328f06e50">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#ga4873c485ca5e49efbb218f4f80a59a17">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#ga6873b9000f9ec322626ecc06664fb229">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#ga0c100894fc532bc05fc81f4128e06e23">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="ga401f5879824966071ba05fb1b4102626"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="gacfe405b75aefcdf7c06b2b426595ea0a"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="gabdce264d0e78ce31bcb2e91f97e49b2a"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="ga190b2403a1bc0dc9a94b70622ed9de41"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="ga9dcba97c6779b70dca02e51a36696a61"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="gafc133887a94442c3bc4424909dff8512"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="ga43481ea1fcc2e389761ccb78bf76b891"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="ga6873b9000f9ec322626ecc06664fb229"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="ga0c100894fc532bc05fc81f4128e06e23"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="ga4873c485ca5e49efbb218f4f80a59a17"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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#ga6873b9000f9ec322626ecc06664fb229">PIN_SWDIO_IN</a> function calls. </p>
- </div>
- </div>
- <a class="anchor" id="ga130df1a24eef09b9e250e7e328f06e50"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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#ga0c100894fc532bc05fc81f4128e06e23">PIN_SWDIO_OUT</a> function calls. </p>
- </div>
- </div>
- <a class="anchor" id="ga04aa6eb6186f50bb1ea7d991870f8670"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="gaf127becf6c639beff822f83fbdef7761"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="gaac7a2af102cc9fa9358d507c11cf9241"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="ga2cea243a2dbbece100f15a7f1fb04e5c"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="gad40bb9c760000dfda7c533d63af3b4fa"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="gace11527334bc4453e8407e44fc58f619"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="ga037d02e221d71916a83349d6572bf91d"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="gaf31b342bc0fc5ad3669f43888466db61"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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="ga08369d48fb874acdfb40726edaa3d147"></a>
- <div class="memitem">
- <div class="memproto">
- <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>
- </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 Thu Apr 9 2020 15:49:12 for CMSIS-DAP Version 2.0.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>
|