1 <!-- HTML header for doxygen 1.9.2-->
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">
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-FreeRTOS: Event Recorder Setup</title>
9 <link href="tabs.css" rel="stylesheet" type="text/css"/>
10 <script type="text/javascript" src="jquery.js"></script>
11 <script type="text/javascript" src="dynsections.js"></script>
12 <script type="text/javascript" src="footer.js"></script>
13 <link href="navtree.css" rel="stylesheet" type="text/css"/>
14 <script type="text/javascript" src="resize.js"></script>
15 <script type="text/javascript" src="navtreedata.js"></script>
16 <script type="text/javascript" src="navtree.js"></script>
17 <link href="search/search.css" rel="stylesheet" type="text/css"/>
18 <script type="text/javascript" src="search/searchdata.js"></script>
19 <script type="text/javascript" src="search/search.js"></script>
20 <script type="text/javascript">
21 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
22 $(document).ready(function() { init_search(); });
25 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
26 <link href="version.css" rel="stylesheet" type="text/css" />
27 <script type="text/javascript" src="../version.js"></script>
30 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
32 <table cellspacing="0" cellpadding="0">
34 <tr style="height: 55px;">
35 <td id="projectlogo" style="padding: 1.5em;"><img alt="Logo" src="cmsis_logo_white_small.png"/></td>
36 <td style="padding-left: 1em; padding-bottom: 1em;padding-top: 1em;">
37 <div id="projectname">CMSIS-FreeRTOS
38  <span id="projectnumber"><script type="text/javascript">
40 writeHeader.call(this);
41 writeVersionDropdown(this);
46 <div id="projectbrief">CMSIS-RTOS2 compliant FreeRTOS Implementation</div>
48 <!--END !PROJECT_NAME-->
49 <td> <div id="MSearchBox" class="MSearchBoxInactive">
51 <img id="MSearchSelect" src="search/mag_sel.svg"
52 onmouseover="return searchBox.OnSearchSelectShow()"
53 onmouseout="return searchBox.OnSearchSelectHide()"
55 <input type="text" id="MSearchField" value="Search" accesskey="S"
56 onfocus="searchBox.OnSearchFieldFocus(true)"
57 onblur="searchBox.OnSearchFieldFocus(false)"
58 onkeyup="searchBox.OnSearchFieldChange(event)"/>
59 </span><span class="right">
60 <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
68 <!-- end header part -->
69 <!-- Generated by Doxygen 1.9.2 -->
70 <script type="text/javascript">
71 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
72 var searchBox = new SearchBox("searchBox", "search",'Search','.html');
76 <div id="side-nav" class="ui-resizable side-nav-resizable">
78 <div id="nav-tree-contents">
79 <div id="nav-sync" class="sync"></div>
82 <div id="splitbar" style="-moz-user-select:none;"
83 class="ui-resizable-handle">
86 <script type="text/javascript">
87 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
88 $(document).ready(function(){initNavTree('group__freertos__setup.html',''); initResizable(); });
91 <div id="doc-content">
92 <!-- window showing the filter options -->
93 <div id="MSearchSelectWindow"
94 onmouseover="return searchBox.OnSearchSelectShow()"
95 onmouseout="return searchBox.OnSearchSelectHide()"
96 onkeydown="return searchBox.OnSearchSelectKey(event)">
99 <!-- iframe showing the search results (closed by default) -->
100 <div id="MSearchResultsWindow">
101 <iframe src="javascript:void(0)" frameborder="0"
102 name="MSearchResults" id="MSearchResults">
107 <div class="summary">
108 <a href="#func-members">Functions</a> </div>
109 <div class="headertitle"><div class="title">Event Recorder Setup<div class="ingroups"><a class="el" href="group__freertos__specific.html">CMSIS-FreeRTOS Specifics</a></div></div></div>
111 <div class="contents">
113 <p>Information about Event Recorder configuration and setup.
114 <a href="#details">More...</a></p>
115 <table class="memberdecls">
116 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
117 Functions</h2></td></tr>
118 <tr class="memitem:ga943f40b05c79f40c73d67b1adcbe3dbe"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__freertos__setup.html#ga943f40b05c79f40c73d67b1adcbe3dbe">EvrFreeRTOSSetup</a> (uint32_t reset)</td></tr>
119 <tr class="memdesc:ga943f40b05c79f40c73d67b1adcbe3dbe"><td class="mdescLeft"> </td><td class="mdescRight">Setup Event Recorder configuration. <a href="group__freertos__setup.html#ga943f40b05c79f40c73d67b1adcbe3dbe">More...</a><br /></td></tr>
120 <tr class="separator:ga943f40b05c79f40c73d67b1adcbe3dbe"><td class="memSeparator" colspan="2"> </td></tr>
122 <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
123 <p >Information about Event Recorder configuration and setup. </p>
124 <p >CMSIS-FreeRTOS interfaces to the <a href="https://arm-software.github.io/CMSIS-View/latest/evr.html" target="_blank"><b>Event Recorder</b></a> to provide event information which helps you to understand and analyze the operation.</p>
125 <p >To use the Event Recorder together with CMSIS-FreeRTOS, it is required to create an image that generates event information. The steps are described under <a class="el" href="cre_freertos_proj.html">Create a FreeRTOS project</a>. </p>
126 <h2 class="groupheader">Function Documentation</h2>
127 <a id="ga943f40b05c79f40c73d67b1adcbe3dbe" name="ga943f40b05c79f40c73d67b1adcbe3dbe"></a>
128 <h2 class="memtitle"><span class="permalink"><a href="#ga943f40b05c79f40c73d67b1adcbe3dbe">◆ </a></span>EvrFreeRTOSSetup()</h2>
130 <div class="memitem">
131 <div class="memproto">
132 <table class="memname">
134 <td class="memname">void EvrFreeRTOSSetup </td>
136 <td class="paramtype">uint32_t </td>
137 <td class="paramname"><em>reset</em></td><td>)</td>
141 </div><div class="memdoc">
143 <p>Setup Event Recorder configuration. </p>
144 <dl class="params"><dt>Parameters</dt><dd>
145 <table class="params">
146 <tr><td class="paramdir">[in]</td><td class="paramname">reset</td><td>reset if already configured (0:no reset, 1:reset)</td></tr>
150 <p>The function <b>EvrFreeRTOSSetup</b> initializes Event Recorder and configures recording level filter. It must be called before any event is sent to the Event Recorder.</p>
151 <p >The argument <em>reset</em> specifies if reset of previously applied configuration is performed in case if EvrFreeRTOSSetup was already called.</p>
152 <p >Behavior of this function execution is defined with Event Recorder Configuration (<a class="el" href="cre_freertos_proj.html#cmsis_freertos_evr_config">Configure Event Recorder</a>). Calling this function has no effect when Event Recorder component is not selected.</p>
153 <dl class="section note"><dt>Note</dt><dd><b>EvrFreeRTOSSetup</b> is called by function <b>osKernelInitialize</b> when CMSIS-RTOS2 API is in use and should not be called explicitly. </dd></dl>
157 </div><!-- contents -->
158 </div><!-- doc-content -->
159 <!-- start footer part -->
160 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
163 <script type="text/javascript">
165 writeFooter.call(this);