1 <!-- HTML header for doxygen 1.9.6-->
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
5 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
6 <meta http-equiv="X-UA-Compatible" content="IE=11"/>
7 <meta name="viewport" content="width=device-width, initial-scale=1"/>
8 <title>CMSIS-Core (Cortex-M): PMU Functions for Armv8.1-M</title>
9 <link href="doxygen.css" rel="stylesheet" type="text/css"/>
10 <link href="tabs.css" rel="stylesheet" type="text/css"/>
11 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
12 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
13 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
14 <script type="text/javascript" src="jquery.js"></script>
15 <script type="text/javascript" src="dynsections.js"></script>
16 <script type="text/javascript" src="printComponentTabs.js"></script>
17 <script type="text/javascript" src="footer.js"></script>
18 <script type="text/javascript" src="navtree.js"></script>
19 <link href="navtree.css" rel="stylesheet" type="text/css"/>
20 <script type="text/javascript" src="resize.js"></script>
21 <script type="text/javascript" src="navtreedata.js"></script>
22 <script type="text/javascript" src="navtree.js"></script>
23 <link href="search/search.css" rel="stylesheet" type="text/css"/>
24 <script type="text/javascript" src="search/searchdata.js"></script>
25 <script type="text/javascript" src="search/search.js"></script>
26 <script type="text/javascript">
27 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
28 $(document).ready(function() { init_search(); });
31 <script type="text/javascript" src="darkmode_toggle.js"></script>
32 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
33 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
34 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
35 <link href="version.css" rel="stylesheet" type="text/css" />
36 <script type="text/javascript" src="../../../version.js"></script>
39 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
41 <table cellspacing="0" cellpadding="0">
43 <tr style="height: 55px;">
44 <td id="projectlogo" style="padding: 1.5em;"><img alt="Logo" src="cmsis_logo_white_small.png"/></td>
45 <td style="padding-left: 1em; padding-bottom: 1em;padding-top: 1em;">
46 <div id="projectname">CMSIS-Core (Cortex-M)
47  <span id="projectnumber"><script type="text/javascript">
49 writeHeader.call(this);
50 writeVersionDropdown.call(this);
55 <div id="projectbrief">CMSIS-Core support for Cortex-M processor-based devices</div>
57 <td> <div id="MSearchBox" class="MSearchBoxInactive">
59 <span id="MSearchSelect" onmouseover="return searchBox.OnSearchSelectShow()" onmouseout="return searchBox.OnSearchSelectHide()"> </span>
60 <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
61 onfocus="searchBox.OnSearchFieldFocus(true)"
62 onblur="searchBox.OnSearchFieldFocus(false)"
63 onkeyup="searchBox.OnSearchFieldChange(event)"/>
64 </span><span class="right">
65 <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
69 <!--END !PROJECT_NAME-->
74 <!-- end header part -->
75 <div id="CMSISnav" class="tabs1">
77 <script type="text/javascript">
78 writeComponentTabs.call(this);
82 <script type="text/javascript">
83 writeSubComponentTabs.call(this);
85 <!-- Generated by Doxygen 1.9.6 -->
86 <script type="text/javascript">
87 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
88 var searchBox = new SearchBox("searchBox", "search/",'.html');
92 <div id="side-nav" class="ui-resizable side-nav-resizable">
94 <div id="nav-tree-contents">
95 <div id="nav-sync" class="sync"></div>
98 <div id="splitbar" style="-moz-user-select:none;"
99 class="ui-resizable-handle">
102 <script type="text/javascript">
103 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
104 $(document).ready(function(){initNavTree('group__pmu8__functions.html',''); initResizable(); });
107 <div id="doc-content">
108 <!-- window showing the filter options -->
109 <div id="MSearchSelectWindow"
110 onmouseover="return searchBox.OnSearchSelectShow()"
111 onmouseout="return searchBox.OnSearchSelectHide()"
112 onkeydown="return searchBox.OnSearchSelectKey(event)">
115 <!-- iframe showing the search results (closed by default) -->
116 <div id="MSearchResultsWindow">
117 <div id="MSearchResults">
120 <div id="SRResults"></div>
121 <div class="SRStatus" id="Loading">Loading...</div>
122 <div class="SRStatus" id="Searching">Searching...</div>
123 <div class="SRStatus" id="NoMatches">No Matches</div>
130 <div class="summary">
131 <a href="#groups">Content</a> |
132 <a href="#nested-classes">Data Structures</a> |
133 <a href="#define-members">Macros</a> |
134 <a href="#func-members">Functions</a> </div>
135 <div class="headertitle"><div class="title">PMU Functions for Armv8.1-M</div></div>
137 <div class="contents">
139 <p>Functions that relate to the Performance Monitoring Unit.
140 <a href="#details">More...</a></p>
141 <table class="memberdecls">
142 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="groups" name="groups"></a>
143 Content</h2></td></tr>
144 <tr class="memitem:group__pmu8__events__armv81"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__events__armv81.html">PMU Events for Armv8.1-M</a></td></tr>
145 <tr class="memdesc:group__pmu8__events__armv81"><td class="mdescLeft"> </td><td class="mdescRight">IDs for Armv8.1-M architecture defined events. <br /></td></tr>
146 <tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
147 <tr class="memitem:group__pmu8__events__armcm55"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__events__armcm55.html">PMU Events for Cortex-M55</a></td></tr>
148 <tr class="memdesc:group__pmu8__events__armcm55"><td class="mdescLeft"> </td><td class="mdescRight">IDs for additional events defined for Cortex-M55. <br /></td></tr>
149 <tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
150 <tr class="memitem:group__pmu8__events__armcm85"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__events__armcm85.html">PMU Events for Cortex-M85</a></td></tr>
151 <tr class="memdesc:group__pmu8__events__armcm85"><td class="mdescLeft"> </td><td class="mdescRight">IDs for additional events defined for Cortex-M85. <br /></td></tr>
152 <tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
153 </table><table class="memberdecls">
154 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="nested-classes" name="nested-classes"></a>
155 Data Structures</h2></td></tr>
156 <tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structPMU__Type.html">PMU_Type</a></td></tr>
157 <tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Structure type to access the Performance Monitoring Unit (PMU). <a href="structPMU__Type.html#details">More...</a><br /></td></tr>
158 <tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
159 </table><table class="memberdecls">
160 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="define-members" name="define-members"></a>
161 Macros</h2></td></tr>
162 <tr class="memitem:gad19c25be8565f2791aca1a96d1847516"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#gad19c25be8565f2791aca1a96d1847516">PMU</a></td></tr>
163 <tr class="memdesc:gad19c25be8565f2791aca1a96d1847516"><td class="mdescLeft"> </td><td class="mdescRight">PMU configuration struct. <br /></td></tr>
164 <tr class="separator:gad19c25be8565f2791aca1a96d1847516"><td class="memSeparator" colspan="2"> </td></tr>
165 </table><table class="memberdecls">
166 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
167 Functions</h2></td></tr>
168 <tr class="memitem:ga618e7140a774ac2a31a59db4b7d13abc"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga618e7140a774ac2a31a59db4b7d13abc">ARM_PMU_Enable</a> (void)</td></tr>
169 <tr class="memdesc:ga618e7140a774ac2a31a59db4b7d13abc"><td class="mdescLeft"> </td><td class="mdescRight">Enable the PMU. <br /></td></tr>
170 <tr class="separator:ga618e7140a774ac2a31a59db4b7d13abc"><td class="memSeparator" colspan="2"> </td></tr>
171 <tr class="memitem:ga74273d4a47cf1a5e99d857a3e8896f10"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga74273d4a47cf1a5e99d857a3e8896f10">ARM_PMU_Disable</a> (void)</td></tr>
172 <tr class="memdesc:ga74273d4a47cf1a5e99d857a3e8896f10"><td class="mdescLeft"> </td><td class="mdescRight">Disable the PMU. <br /></td></tr>
173 <tr class="separator:ga74273d4a47cf1a5e99d857a3e8896f10"><td class="memSeparator" colspan="2"> </td></tr>
174 <tr class="memitem:ga77ee08f0b3e77d4559cb79fde30d89e9"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga77ee08f0b3e77d4559cb79fde30d89e9">ARM_PMU_Set_EVTYPER</a> (uint32_t num, uint32_t type)</td></tr>
175 <tr class="memdesc:ga77ee08f0b3e77d4559cb79fde30d89e9"><td class="mdescLeft"> </td><td class="mdescRight">Set event to count for PMU event counter. <br /></td></tr>
176 <tr class="separator:ga77ee08f0b3e77d4559cb79fde30d89e9"><td class="memSeparator" colspan="2"> </td></tr>
177 <tr class="memitem:ga4288c08039886cd24eb2dd4e743fb97e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga4288c08039886cd24eb2dd4e743fb97e">ARM_PMU_CYCCNT_Reset</a> (void)</td></tr>
178 <tr class="memdesc:ga4288c08039886cd24eb2dd4e743fb97e"><td class="mdescLeft"> </td><td class="mdescRight">Reset cycle counter. <br /></td></tr>
179 <tr class="separator:ga4288c08039886cd24eb2dd4e743fb97e"><td class="memSeparator" colspan="2"> </td></tr>
180 <tr class="memitem:ga90527859e6f0ef980300c86c2916ee79"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga90527859e6f0ef980300c86c2916ee79">ARM_PMU_EVCNTR_ALL_Reset</a> (void)</td></tr>
181 <tr class="memdesc:ga90527859e6f0ef980300c86c2916ee79"><td class="mdescLeft"> </td><td class="mdescRight">Reset all event counters. <br /></td></tr>
182 <tr class="separator:ga90527859e6f0ef980300c86c2916ee79"><td class="memSeparator" colspan="2"> </td></tr>
183 <tr class="memitem:ga22e481855ab257180e24f01a38623887"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga22e481855ab257180e24f01a38623887">ARM_PMU_CNTR_Enable</a> (uint32_t mask)</td></tr>
184 <tr class="memdesc:ga22e481855ab257180e24f01a38623887"><td class="mdescLeft"> </td><td class="mdescRight">Enable counters. <br /></td></tr>
185 <tr class="separator:ga22e481855ab257180e24f01a38623887"><td class="memSeparator" colspan="2"> </td></tr>
186 <tr class="memitem:ga76c6f266544c53d93801cfb614155420"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga76c6f266544c53d93801cfb614155420">ARM_PMU_CNTR_Disable</a> (uint32_t mask)</td></tr>
187 <tr class="memdesc:ga76c6f266544c53d93801cfb614155420"><td class="mdescLeft"> </td><td class="mdescRight">Disable counters. <br /></td></tr>
188 <tr class="separator:ga76c6f266544c53d93801cfb614155420"><td class="memSeparator" colspan="2"> </td></tr>
189 <tr class="memitem:gaaa18c27d39f5a55c1b621f5296b88112"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#gaaa18c27d39f5a55c1b621f5296b88112">ARM_PMU_Get_CCNTR</a> (void)</td></tr>
190 <tr class="memdesc:gaaa18c27d39f5a55c1b621f5296b88112"><td class="mdescLeft"> </td><td class="mdescRight">Read cycle counter. <br /></td></tr>
191 <tr class="separator:gaaa18c27d39f5a55c1b621f5296b88112"><td class="memSeparator" colspan="2"> </td></tr>
192 <tr class="memitem:ga9768cbaffcf2c0b31febe96db91a85d8"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga9768cbaffcf2c0b31febe96db91a85d8">ARM_PMU_Get_EVCNTR</a> (uint32_t num)</td></tr>
193 <tr class="memdesc:ga9768cbaffcf2c0b31febe96db91a85d8"><td class="mdescLeft"> </td><td class="mdescRight">Read event counter. <br /></td></tr>
194 <tr class="separator:ga9768cbaffcf2c0b31febe96db91a85d8"><td class="memSeparator" colspan="2"> </td></tr>
195 <tr class="memitem:ga70436b378b75bdfe3fcb47697d309a96"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga70436b378b75bdfe3fcb47697d309a96">ARM_PMU_Get_CNTR_OVS</a> (void)</td></tr>
196 <tr class="memdesc:ga70436b378b75bdfe3fcb47697d309a96"><td class="mdescLeft"> </td><td class="mdescRight">Read counter overflow status. <br /></td></tr>
197 <tr class="separator:ga70436b378b75bdfe3fcb47697d309a96"><td class="memSeparator" colspan="2"> </td></tr>
198 <tr class="memitem:ga18376f0e3829e93e99149847667e5864"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga18376f0e3829e93e99149847667e5864">ARM_PMU_Set_CNTR_OVS</a> (uint32_t mask)</td></tr>
199 <tr class="memdesc:ga18376f0e3829e93e99149847667e5864"><td class="mdescLeft"> </td><td class="mdescRight">Clear counter overflow status. <br /></td></tr>
200 <tr class="separator:ga18376f0e3829e93e99149847667e5864"><td class="memSeparator" colspan="2"> </td></tr>
201 <tr class="memitem:ga133168437a20566d319c78b751425c44"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga133168437a20566d319c78b751425c44">ARM_PMU_Set_CNTR_IRQ_Enable</a> (uint32_t mask)</td></tr>
202 <tr class="memdesc:ga133168437a20566d319c78b751425c44"><td class="mdescLeft"> </td><td class="mdescRight">Enable counter overflow interrupt request. <br /></td></tr>
203 <tr class="separator:ga133168437a20566d319c78b751425c44"><td class="memSeparator" colspan="2"> </td></tr>
204 <tr class="memitem:ga731b6cd01c6eaa6f909164602f19d0bc"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga731b6cd01c6eaa6f909164602f19d0bc">ARM_PMU_Set_CNTR_IRQ_Disable</a> (uint32_t mask)</td></tr>
205 <tr class="memdesc:ga731b6cd01c6eaa6f909164602f19d0bc"><td class="mdescLeft"> </td><td class="mdescRight">Disable counter overflow interrupt request. <br /></td></tr>
206 <tr class="separator:ga731b6cd01c6eaa6f909164602f19d0bc"><td class="memSeparator" colspan="2"> </td></tr>
207 <tr class="memitem:ga27b07d38050a16ce416bfaf151a24944"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__pmu8__functions.html#ga27b07d38050a16ce416bfaf151a24944">ARM_PMU_CNTR_Increment</a> (uint32_t mask)</td></tr>
208 <tr class="memdesc:ga27b07d38050a16ce416bfaf151a24944"><td class="mdescLeft"> </td><td class="mdescRight">Software increment event counter. <br /></td></tr>
209 <tr class="separator:ga27b07d38050a16ce416bfaf151a24944"><td class="memSeparator" colspan="2"> </td></tr>
211 <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
212 <p>Functions that relate to the Performance Monitoring Unit. </p>
213 <p>The following functions support the Performance Monitoring Unit (PMU) that is available on the Cortex-M55/M85 processors.</p>
214 <p>The PMU is used to monitor events that occur during run-time of an application.</p>
215 <p><b>Example:</b> </p><div class="fragment"><div class="line"><span class="comment">// Initialize counter variables</span></div>
216 <div class="line"> </div>
217 <div class="line"><span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> cycle_count = 0;</div>
218 <div class="line"><span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> l1_dcache_miss_count = 0;</div>
219 <div class="line"><span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> instructions_retired_count = 0;</div>
220 <div class="line"> </div>
221 <div class="line"><span class="comment">// Enable the PMU</span></div>
222 <div class="line"><span class="comment">// Note: Before using the PMU, software needs to ensure </span></div>
223 <div class="line"><span class="comment">// that trace is enabled via the Debug Exception Monitor Control Register, DEMCR:</span></div>
224 <div class="line"><span class="comment">// CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;</span></div>
225 <div class="line"> </div>
226 <div class="line"><a class="code hl_function" href="group__pmu8__functions.html#ga618e7140a774ac2a31a59db4b7d13abc">ARM_PMU_Enable</a>();</div>
227 <div class="line"> </div>
228 <div class="line"><span class="comment">// Configure Event Counter Register 0 to count instructions retired</span></div>
229 <div class="line"><span class="comment">// Configure Event Counter Register 1 to count L1 D-Cache misses</span></div>
230 <div class="line"> </div>
231 <div class="line"><a class="code hl_function" href="group__pmu8__functions.html#ga77ee08f0b3e77d4559cb79fde30d89e9">ARM_PMU_Set_EVTYPER</a>(0, <a class="code hl_define" href="group__pmu8__events__armv81.html#ga8a5e60eee460addfc66e275a2c4c4800">ARM_PMU_INST_RETIRED</a>);</div>
232 <div class="line"><a class="code hl_function" href="group__pmu8__functions.html#ga77ee08f0b3e77d4559cb79fde30d89e9">ARM_PMU_Set_EVTYPER</a>(1, <a class="code hl_define" href="group__pmu8__events__armv81.html#ga4687d5d7efc6f49db2db9acc25b590f6">ARM_PMU_L1D_CACHE_MISS_RD</a>);</div>
233 <div class="line"> </div>
234 <div class="line"><span class="comment">// Reset Event Counters and Cycle Counter</span></div>
235 <div class="line"> </div>
236 <div class="line"><a class="code hl_function" href="group__pmu8__functions.html#ga90527859e6f0ef980300c86c2916ee79">ARM_PMU_EVCNTR_ALL_Reset</a>();</div>
237 <div class="line"><a class="code hl_function" href="group__pmu8__functions.html#ga4288c08039886cd24eb2dd4e743fb97e">ARM_PMU_CYCCNT_Reset</a>();</div>
238 <div class="line"> </div>
239 <div class="line"><span class="comment">// Start incrementing Cycle Count Register and Event Counter Registers 0 & 1</span></div>
240 <div class="line"> </div>
241 <div class="line"><a class="code hl_function" href="group__pmu8__functions.html#ga22e481855ab257180e24f01a38623887">ARM_PMU_CNTR_Enable</a>(PMU_CNTENSET_CCNTR_ENABLE_Msk|PMU_CNTENSET_CNT0_ENABLE_Msk|PMU_CNTENSET_CNT1_ENABLE_Msk);</div>
242 <div class="line"> </div>
243 <div class="line"><span class="comment">// Code you want to measure here</span></div>
244 <div class="line"> </div>
245 <div class="line"><span class="comment">// Stop incrementing Cycle Count Register and Event Counter Registers 0 & 1</span></div>
246 <div class="line"> </div>
247 <div class="line"><a class="code hl_function" href="group__pmu8__functions.html#ga76c6f266544c53d93801cfb614155420">ARM_PMU_CNTR_Disable</a>(PMU_CNTENCLR_CCNTR_ENABLE_Msk|PMU_CNTENCLR_CNT0_ENABLE_Msk|PMU_CNTENCLR_CNT1_ENABLE_Msk);</div>
248 <div class="line"> </div>
249 <div class="line"><span class="comment">// Get cycle count, number of instructions retired and number of L1 D-Cache misses (on read)</span></div>
250 <div class="line"> </div>
251 <div class="line">cycle_count = cycle_count + <a class="code hl_function" href="group__pmu8__functions.html#gaaa18c27d39f5a55c1b621f5296b88112">ARM_PMU_Get_CCNTR</a>();</div>
252 <div class="line">instructions_retired_count = instructions_retired_count + <a class="code hl_function" href="group__pmu8__functions.html#ga9768cbaffcf2c0b31febe96db91a85d8">ARM_PMU_Get_EVCNTR</a>(0);</div>
253 <div class="line">l1_dcache_miss_count = l1_dcache_miss_count + <a class="code hl_function" href="group__pmu8__functions.html#ga9768cbaffcf2c0b31febe96db91a85d8">ARM_PMU_Get_EVCNTR</a>(1); <span class="comment">// Note: D-Cache must be enabled using</span></div>
254 <div class="line"> <span class="comment">// SCB_EnableDCache() for meaningful result.</span></div>
255 <div class="ttc" id="agroup__pmu8__events__armv81_html_ga4687d5d7efc6f49db2db9acc25b590f6"><div class="ttname"><a href="group__pmu8__events__armv81.html#ga4687d5d7efc6f49db2db9acc25b590f6">ARM_PMU_L1D_CACHE_MISS_RD</a></div><div class="ttdeci">#define ARM_PMU_L1D_CACHE_MISS_RD</div><div class="ttdoc">Level 1 data cache read miss.</div><div class="ttdef"><b>Definition:</b> Ref_PMU8.txt:106</div></div>
256 <div class="ttc" id="agroup__pmu8__events__armv81_html_ga8a5e60eee460addfc66e275a2c4c4800"><div class="ttname"><a href="group__pmu8__events__armv81.html#ga8a5e60eee460addfc66e275a2c4c4800">ARM_PMU_INST_RETIRED</a></div><div class="ttdeci">#define ARM_PMU_INST_RETIRED</div><div class="ttdoc">Instruction architecturally executed.</div><div class="ttdef"><b>Definition:</b> Ref_PMU8.txt:71</div></div>
257 <div class="ttc" id="agroup__pmu8__functions_html_ga22e481855ab257180e24f01a38623887"><div class="ttname"><a href="group__pmu8__functions.html#ga22e481855ab257180e24f01a38623887">ARM_PMU_CNTR_Enable</a></div><div class="ttdeci">__STATIC_INLINE void ARM_PMU_CNTR_Enable(uint32_t mask)</div><div class="ttdoc">Enable counters.</div></div>
258 <div class="ttc" id="agroup__pmu8__functions_html_ga4288c08039886cd24eb2dd4e743fb97e"><div class="ttname"><a href="group__pmu8__functions.html#ga4288c08039886cd24eb2dd4e743fb97e">ARM_PMU_CYCCNT_Reset</a></div><div class="ttdeci">__STATIC_INLINE void ARM_PMU_CYCCNT_Reset(void)</div><div class="ttdoc">Reset cycle counter.</div></div>
259 <div class="ttc" id="agroup__pmu8__functions_html_ga618e7140a774ac2a31a59db4b7d13abc"><div class="ttname"><a href="group__pmu8__functions.html#ga618e7140a774ac2a31a59db4b7d13abc">ARM_PMU_Enable</a></div><div class="ttdeci">__STATIC_INLINE void ARM_PMU_Enable(void)</div><div class="ttdoc">Enable the PMU.</div></div>
260 <div class="ttc" id="agroup__pmu8__functions_html_ga76c6f266544c53d93801cfb614155420"><div class="ttname"><a href="group__pmu8__functions.html#ga76c6f266544c53d93801cfb614155420">ARM_PMU_CNTR_Disable</a></div><div class="ttdeci">__STATIC_INLINE void ARM_PMU_CNTR_Disable(uint32_t mask)</div><div class="ttdoc">Disable counters.</div></div>
261 <div class="ttc" id="agroup__pmu8__functions_html_ga77ee08f0b3e77d4559cb79fde30d89e9"><div class="ttname"><a href="group__pmu8__functions.html#ga77ee08f0b3e77d4559cb79fde30d89e9">ARM_PMU_Set_EVTYPER</a></div><div class="ttdeci">__STATIC_INLINE void ARM_PMU_Set_EVTYPER(uint32_t num, uint32_t type)</div><div class="ttdoc">Set event to count for PMU event counter.</div></div>
262 <div class="ttc" id="agroup__pmu8__functions_html_ga90527859e6f0ef980300c86c2916ee79"><div class="ttname"><a href="group__pmu8__functions.html#ga90527859e6f0ef980300c86c2916ee79">ARM_PMU_EVCNTR_ALL_Reset</a></div><div class="ttdeci">__STATIC_INLINE void ARM_PMU_EVCNTR_ALL_Reset(void)</div><div class="ttdoc">Reset all event counters.</div></div>
263 <div class="ttc" id="agroup__pmu8__functions_html_ga9768cbaffcf2c0b31febe96db91a85d8"><div class="ttname"><a href="group__pmu8__functions.html#ga9768cbaffcf2c0b31febe96db91a85d8">ARM_PMU_Get_EVCNTR</a></div><div class="ttdeci">__STATIC_INLINE uint32_t ARM_PMU_Get_EVCNTR(uint32_t num)</div><div class="ttdoc">Read event counter.</div></div>
264 <div class="ttc" id="agroup__pmu8__functions_html_gaaa18c27d39f5a55c1b621f5296b88112"><div class="ttname"><a href="group__pmu8__functions.html#gaaa18c27d39f5a55c1b621f5296b88112">ARM_PMU_Get_CCNTR</a></div><div class="ttdeci">__STATIC_INLINE uint32_t ARM_PMU_Get_CCNTR(void)</div><div class="ttdoc">Read cycle counter.</div></div>
265 </div><!-- fragment --> <h2 class="groupheader">Macro Definition Documentation</h2>
266 <a id="gad19c25be8565f2791aca1a96d1847516" name="gad19c25be8565f2791aca1a96d1847516"></a>
267 <h2 class="memtitle"><span class="permalink"><a href="#gad19c25be8565f2791aca1a96d1847516">◆ </a></span>PMU</h2>
269 <div class="memitem">
270 <div class="memproto">
271 <table class="memname">
273 <td class="memname">#define PMU</td>
276 </div><div class="memdoc">
278 <p>PMU configuration struct. </p>
279 <p>This macro can be used to access the PMU registers, directly. For the common tasks one should prefer using the control functions.</p>
280 <p>Example: <b>Example:</b> </p><div class="fragment"><div class="line"><a class="code hl_define" href="group__pmu8__functions.html#gad19c25be8565f2791aca1a96d1847516">PMU</a>->CTRL |= PMU_CTRL_ENABLE_Msk; <span class="comment">// Enable PMU</span></div>
281 <div class="ttc" id="agroup__pmu8__functions_html_gad19c25be8565f2791aca1a96d1847516"><div class="ttname"><a href="group__pmu8__functions.html#gad19c25be8565f2791aca1a96d1847516">PMU</a></div><div class="ttdeci">#define PMU</div><div class="ttdoc">PMU configuration struct.</div><div class="ttdef"><b>Definition:</b> Ref_PMU8.txt:326</div></div>
282 </div><!-- fragment -->
285 <h2 class="groupheader">Function Documentation</h2>
286 <a id="ga76c6f266544c53d93801cfb614155420" name="ga76c6f266544c53d93801cfb614155420"></a>
287 <h2 class="memtitle"><span class="permalink"><a href="#ga76c6f266544c53d93801cfb614155420">◆ </a></span>ARM_PMU_CNTR_Disable()</h2>
289 <div class="memitem">
290 <div class="memproto">
291 <table class="memname">
293 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_CNTR_Disable </td>
295 <td class="paramtype">uint32_t </td>
296 <td class="paramname"><em>mask</em></td><td>)</td>
300 </div><div class="memdoc">
302 <p>Disable counters. </p>
303 <dl class="params"><dt>Parameters</dt><dd>
304 <table class="params">
305 <tr><td class="paramdir">[in]</td><td class="paramname">mask</td><td>Counters to enable </td></tr>
309 <dl class="section note"><dt>Note</dt><dd>Disables one or more of the following:<ul>
310 <li>event counters (0-30)</li>
311 <li>cycle counter </li>
317 <a id="ga22e481855ab257180e24f01a38623887" name="ga22e481855ab257180e24f01a38623887"></a>
318 <h2 class="memtitle"><span class="permalink"><a href="#ga22e481855ab257180e24f01a38623887">◆ </a></span>ARM_PMU_CNTR_Enable()</h2>
320 <div class="memitem">
321 <div class="memproto">
322 <table class="memname">
324 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_CNTR_Enable </td>
326 <td class="paramtype">uint32_t </td>
327 <td class="paramname"><em>mask</em></td><td>)</td>
331 </div><div class="memdoc">
333 <p>Enable counters. </p>
334 <dl class="params"><dt>Parameters</dt><dd>
335 <table class="params">
336 <tr><td class="paramdir">[in]</td><td class="paramname">mask</td><td>Counters to enable </td></tr>
340 <dl class="section note"><dt>Note</dt><dd>Enables one or more of the following:<ul>
341 <li>event counters (0-30)</li>
342 <li>cycle counter </li>
348 <a id="ga27b07d38050a16ce416bfaf151a24944" name="ga27b07d38050a16ce416bfaf151a24944"></a>
349 <h2 class="memtitle"><span class="permalink"><a href="#ga27b07d38050a16ce416bfaf151a24944">◆ </a></span>ARM_PMU_CNTR_Increment()</h2>
351 <div class="memitem">
352 <div class="memproto">
353 <table class="memname">
355 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_CNTR_Increment </td>
357 <td class="paramtype">uint32_t </td>
358 <td class="paramname"><em>mask</em></td><td>)</td>
362 </div><div class="memdoc">
364 <p>Software increment event counter. </p>
365 <dl class="params"><dt>Parameters</dt><dd>
366 <table class="params">
367 <tr><td class="paramdir">[in]</td><td class="paramname">mask</td><td>Counters to increment </td></tr>
371 <dl class="section note"><dt>Note</dt><dd>Software increment bits for one or more event counters (0-30) </dd></dl>
375 <a id="ga4288c08039886cd24eb2dd4e743fb97e" name="ga4288c08039886cd24eb2dd4e743fb97e"></a>
376 <h2 class="memtitle"><span class="permalink"><a href="#ga4288c08039886cd24eb2dd4e743fb97e">◆ </a></span>ARM_PMU_CYCCNT_Reset()</h2>
378 <div class="memitem">
379 <div class="memproto">
380 <table class="memname">
382 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_CYCCNT_Reset </td>
384 <td class="paramtype">void </td>
385 <td class="paramname"></td><td>)</td>
389 </div><div class="memdoc">
391 <p>Reset cycle counter. </p>
395 <a id="ga74273d4a47cf1a5e99d857a3e8896f10" name="ga74273d4a47cf1a5e99d857a3e8896f10"></a>
396 <h2 class="memtitle"><span class="permalink"><a href="#ga74273d4a47cf1a5e99d857a3e8896f10">◆ </a></span>ARM_PMU_Disable()</h2>
398 <div class="memitem">
399 <div class="memproto">
400 <table class="memname">
402 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_Disable </td>
404 <td class="paramtype">void </td>
405 <td class="paramname"></td><td>)</td>
409 </div><div class="memdoc">
411 <p>Disable the PMU. </p>
415 <a id="ga618e7140a774ac2a31a59db4b7d13abc" name="ga618e7140a774ac2a31a59db4b7d13abc"></a>
416 <h2 class="memtitle"><span class="permalink"><a href="#ga618e7140a774ac2a31a59db4b7d13abc">◆ </a></span>ARM_PMU_Enable()</h2>
418 <div class="memitem">
419 <div class="memproto">
420 <table class="memname">
422 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_Enable </td>
424 <td class="paramtype">void </td>
425 <td class="paramname"></td><td>)</td>
429 </div><div class="memdoc">
431 <p>Enable the PMU. </p>
435 <a id="ga90527859e6f0ef980300c86c2916ee79" name="ga90527859e6f0ef980300c86c2916ee79"></a>
436 <h2 class="memtitle"><span class="permalink"><a href="#ga90527859e6f0ef980300c86c2916ee79">◆ </a></span>ARM_PMU_EVCNTR_ALL_Reset()</h2>
438 <div class="memitem">
439 <div class="memproto">
440 <table class="memname">
442 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_EVCNTR_ALL_Reset </td>
444 <td class="paramtype">void </td>
445 <td class="paramname"></td><td>)</td>
449 </div><div class="memdoc">
451 <p>Reset all event counters. </p>
455 <a id="gaaa18c27d39f5a55c1b621f5296b88112" name="gaaa18c27d39f5a55c1b621f5296b88112"></a>
456 <h2 class="memtitle"><span class="permalink"><a href="#gaaa18c27d39f5a55c1b621f5296b88112">◆ </a></span>ARM_PMU_Get_CCNTR()</h2>
458 <div class="memitem">
459 <div class="memproto">
460 <table class="memname">
462 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> uint32_t ARM_PMU_Get_CCNTR </td>
464 <td class="paramtype">void </td>
465 <td class="paramname"></td><td>)</td>
469 </div><div class="memdoc">
471 <p>Read cycle counter. </p>
472 <dl class="section return"><dt>Returns</dt><dd>Cycle count </dd></dl>
476 <a id="ga70436b378b75bdfe3fcb47697d309a96" name="ga70436b378b75bdfe3fcb47697d309a96"></a>
477 <h2 class="memtitle"><span class="permalink"><a href="#ga70436b378b75bdfe3fcb47697d309a96">◆ </a></span>ARM_PMU_Get_CNTR_OVS()</h2>
479 <div class="memitem">
480 <div class="memproto">
481 <table class="memname">
483 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> uint32_t ARM_PMU_Get_CNTR_OVS </td>
485 <td class="paramtype">void </td>
486 <td class="paramname"></td><td>)</td>
490 </div><div class="memdoc">
492 <p>Read counter overflow status. </p>
493 <dl class="section return"><dt>Returns</dt><dd>Counter overflow status bits for the following:<ul>
494 <li>event counters (0-30)</li>
495 <li>cycle counter </li>
501 <a id="ga9768cbaffcf2c0b31febe96db91a85d8" name="ga9768cbaffcf2c0b31febe96db91a85d8"></a>
502 <h2 class="memtitle"><span class="permalink"><a href="#ga9768cbaffcf2c0b31febe96db91a85d8">◆ </a></span>ARM_PMU_Get_EVCNTR()</h2>
504 <div class="memitem">
505 <div class="memproto">
506 <table class="memname">
508 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> uint32_t ARM_PMU_Get_EVCNTR </td>
510 <td class="paramtype">uint32_t </td>
511 <td class="paramname"><em>num</em></td><td>)</td>
515 </div><div class="memdoc">
517 <p>Read event counter. </p>
518 <dl class="params"><dt>Parameters</dt><dd>
519 <table class="params">
520 <tr><td class="paramdir">[in]</td><td class="paramname">num</td><td>Event counter (0-30) to read </td></tr>
524 <dl class="section return"><dt>Returns</dt><dd>Event count </dd></dl>
528 <a id="ga731b6cd01c6eaa6f909164602f19d0bc" name="ga731b6cd01c6eaa6f909164602f19d0bc"></a>
529 <h2 class="memtitle"><span class="permalink"><a href="#ga731b6cd01c6eaa6f909164602f19d0bc">◆ </a></span>ARM_PMU_Set_CNTR_IRQ_Disable()</h2>
531 <div class="memitem">
532 <div class="memproto">
533 <table class="memname">
535 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_Set_CNTR_IRQ_Disable </td>
537 <td class="paramtype">uint32_t </td>
538 <td class="paramname"><em>mask</em></td><td>)</td>
542 </div><div class="memdoc">
544 <p>Disable counter overflow interrupt request. </p>
545 <dl class="params"><dt>Parameters</dt><dd>
546 <table class="params">
547 <tr><td class="paramdir">[in]</td><td class="paramname">mask</td><td>Counter overflow interrupt request bits to clear </td></tr>
551 <dl class="section note"><dt>Note</dt><dd>Clears overflow interrupt request bits for one or more of the following:<ul>
552 <li>event counters (0-30)</li>
553 <li>cycle counter </li>
559 <a id="ga133168437a20566d319c78b751425c44" name="ga133168437a20566d319c78b751425c44"></a>
560 <h2 class="memtitle"><span class="permalink"><a href="#ga133168437a20566d319c78b751425c44">◆ </a></span>ARM_PMU_Set_CNTR_IRQ_Enable()</h2>
562 <div class="memitem">
563 <div class="memproto">
564 <table class="memname">
566 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_Set_CNTR_IRQ_Enable </td>
568 <td class="paramtype">uint32_t </td>
569 <td class="paramname"><em>mask</em></td><td>)</td>
573 </div><div class="memdoc">
575 <p>Enable counter overflow interrupt request. </p>
576 <dl class="params"><dt>Parameters</dt><dd>
577 <table class="params">
578 <tr><td class="paramdir">[in]</td><td class="paramname">mask</td><td>Counter overflow interrupt request bits to set </td></tr>
582 <dl class="section note"><dt>Note</dt><dd>Sets overflow interrupt request bits for one or more of the following:<ul>
583 <li>event counters (0-30)</li>
584 <li>cycle counter </li>
590 <a id="ga18376f0e3829e93e99149847667e5864" name="ga18376f0e3829e93e99149847667e5864"></a>
591 <h2 class="memtitle"><span class="permalink"><a href="#ga18376f0e3829e93e99149847667e5864">◆ </a></span>ARM_PMU_Set_CNTR_OVS()</h2>
593 <div class="memitem">
594 <div class="memproto">
595 <table class="memname">
597 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_Set_CNTR_OVS </td>
599 <td class="paramtype">uint32_t </td>
600 <td class="paramname"><em>mask</em></td><td>)</td>
604 </div><div class="memdoc">
606 <p>Clear counter overflow status. </p>
607 <dl class="params"><dt>Parameters</dt><dd>
608 <table class="params">
609 <tr><td class="paramdir">[in]</td><td class="paramname">mask</td><td>Counter overflow status bits to clear </td></tr>
613 <dl class="section note"><dt>Note</dt><dd>Clears overflow status bits for one or more of the following:<ul>
614 <li>event counters (0-30)</li>
615 <li>cycle counter </li>
621 <a id="ga77ee08f0b3e77d4559cb79fde30d89e9" name="ga77ee08f0b3e77d4559cb79fde30d89e9"></a>
622 <h2 class="memtitle"><span class="permalink"><a href="#ga77ee08f0b3e77d4559cb79fde30d89e9">◆ </a></span>ARM_PMU_Set_EVTYPER()</h2>
624 <div class="memitem">
625 <div class="memproto">
626 <table class="memname">
628 <td class="memname"><a class="el" href="group__compiler__conntrol__gr.html#gaba87361bfad2ae52cfe2f40c1a1dbf9c">__STATIC_INLINE</a> void ARM_PMU_Set_EVTYPER </td>
630 <td class="paramtype">uint32_t </td>
631 <td class="paramname"><em>num</em>, </td>
634 <td class="paramkey"></td>
636 <td class="paramtype">uint32_t </td>
637 <td class="paramname"><em>type</em> </td>
645 </div><div class="memdoc">
647 <p>Set event to count for PMU event counter. </p>
648 <dl class="params"><dt>Parameters</dt><dd>
649 <table class="params">
650 <tr><td class="paramdir">[in]</td><td class="paramname">num</td><td>Event counter (0-30) to configure </td></tr>
651 <tr><td class="paramdir">[in]</td><td class="paramname">type</td><td>Event to count </td></tr>
658 </div><!-- contents -->
659 </div><!-- doc-content -->
660 <!-- start footer part -->
661 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
664 <script type="text/javascript">
666 writeFooter.call(this);