begriffs open source - cmsis/blob - main/RTOS2/group__CMSIS__RTOS__EventFlags.html

   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">
   4 <head>
   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-RTOS2: Event Flags</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&amp;dn=expat.txt MIT */
  28   $(document).ready(function() { init_search(); });
  29 /* @license-end */
  30 </script>
  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>
  37 </head>
  38 <body>
  39 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  40 <div id="titlearea">
  41 <table cellspacing="0" cellpadding="0">
  42  <tbody>
  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-RTOS2
  47    &#160;<span id="projectnumber"><script type="text/javascript">
  48      <!--
  49      writeHeader.call(this);
  50      writeVersionDropdown.call(this);
  51      //-->
  52     </script>
  53    </span>
  54    </div>
  55    <div id="projectbrief">Real-Time Operating System API</div>
  56   </td>
  57    <td>        <div id="MSearchBox" class="MSearchBoxInactive">
  58         <span class="left">
  59           <span id="MSearchSelect"                onmouseover="return searchBox.OnSearchSelectShow()"                onmouseout="return searchBox.OnSearchSelectHide()">&#160;</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>
  66           </span>
  67         </div>
  68 </td>
  69   <!--END !PROJECT_NAME-->
  70  </tr>
  71  </tbody>
  72 </table>
  73 </div>
  74 <!-- end header part -->
  75 <div id="CMSISnav" class="tabs1">
  76   <ul class="tablist">
  77     <script type="text/javascript">
  78       writeComponentTabs.call(this);
  79     </script>
  80   </ul>
  81 </div>
  82 <script type="text/javascript">
  83   writeSubComponentTabs.call(this);
  84 </script>
  85 <!-- Generated by Doxygen 1.9.6 -->
  86 <script type="text/javascript">
  87 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  88 var searchBox = new SearchBox("searchBox", "search/",'.html');
  89 /* @license-end */
  90 </script>
  91 </div><!-- top -->
  92 <div id="side-nav" class="ui-resizable side-nav-resizable">
  93   <div id="nav-tree">
  94     <div id="nav-tree-contents">
  95       <div id="nav-sync" class="sync"></div>
  96     </div>
  97   </div>
  98   <div id="splitbar" style="-moz-user-select:none;"
  99        class="ui-resizable-handle">
 100   </div>
 101 </div>
 102 <script type="text/javascript">
 103 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
 104 $(document).ready(function(){initNavTree('group__CMSIS__RTOS__EventFlags.html',''); initResizable(); });
 105 /* @license-end */
 106 </script>
 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)">
 113 </div>
 114
 115 <!-- iframe showing the search results (closed by default) -->
 116 <div id="MSearchResultsWindow">
 117 <div id="MSearchResults">
 118 <div class="SRPage">
 119 <div id="SRIndex">
 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>
 124 </div>
 125 </div>
 126 </div>
 127 </div>
 128
 129 <div class="header">
 130   <div class="summary">
 131 <a href="#nested-classes">Data Structures</a> &#124;
 132 <a href="#typedef-members">Typedefs</a> &#124;
 133 <a href="#func-members">Functions</a>  </div>
 134   <div class="headertitle"><div class="title">Event Flags<div class="ingroups"><a class="el" href="group__CMSIS__RTOS.html">CMSIS-RTOS2 API</a></div></div></div>
 135 </div><!--header-->
 136 <div class="contents">
 137
 138 <p>Synchronize threads using event flags.
 139 <a href="#details">More...</a></p>
 140 <table class="memberdecls">
 141 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="nested-classes" name="nested-classes"></a>
 142 Data Structures</h2></td></tr>
 143 <tr class="memitem:structosEventFlagsAttr__t"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#structosEventFlagsAttr__t">osEventFlagsAttr_t</a></td></tr>
 144 <tr class="memdesc:structosEventFlagsAttr__t"><td class="mdescLeft">&#160;</td><td class="mdescRight">Attributes structure for event flags.  <a href="group__CMSIS__RTOS__EventFlags.html#structosEventFlagsAttr__t">More...</a><br /></td></tr>
 145 <tr class="separator:structosEventFlagsAttr__t"><td class="memSeparator" colspan="2">&#160;</td></tr>
 146 </table><table class="memberdecls">
 147 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="typedef-members" name="typedef-members"></a>
 148 Typedefs</h2></td></tr>
 149 <tr class="memitem:gafdbab933146d6d81d7cca7287e267a50"><td class="memItemLeft" align="right" valign="top">typedef void *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a></td></tr>
 150 <tr class="separator:gafdbab933146d6d81d7cca7287e267a50"><td class="memSeparator" colspan="2">&#160;</td></tr>
 151 </table><table class="memberdecls">
 152 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
 153 Functions</h2></td></tr>
 154 <tr class="memitem:gab14b1caeb12ffa42cce1bfe889cd07df"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df">osEventFlagsNew</a> (const <a class="el" href="group__CMSIS__RTOS__EventFlags.html#structosEventFlagsAttr__t">osEventFlagsAttr_t</a> *attr)</td></tr>
 155 <tr class="memdesc:gab14b1caeb12ffa42cce1bfe889cd07df"><td class="mdescLeft">&#160;</td><td class="mdescRight">Create and Initialize an Event Flags object.  <br /></td></tr>
 156 <tr class="separator:gab14b1caeb12ffa42cce1bfe889cd07df"><td class="memSeparator" colspan="2">&#160;</td></tr>
 157 <tr class="memitem:ga33b71d14cecf90b4e72639dd19f23a5e"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga33b71d14cecf90b4e72639dd19f23a5e">osEventFlagsSet</a> (<a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> ef_id, uint32_t flags)</td></tr>
 158 <tr class="memdesc:ga33b71d14cecf90b4e72639dd19f23a5e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set the specified Event Flags.  <br /></td></tr>
 159 <tr class="separator:ga33b71d14cecf90b4e72639dd19f23a5e"><td class="memSeparator" colspan="2">&#160;</td></tr>
 160 <tr class="memitem:ga93bf258ca0007c6641fbe8e4f2b8a1e5"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga93bf258ca0007c6641fbe8e4f2b8a1e5">osEventFlagsClear</a> (<a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> ef_id, uint32_t flags)</td></tr>
 161 <tr class="memdesc:ga93bf258ca0007c6641fbe8e4f2b8a1e5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Clear the specified Event Flags.  <br /></td></tr>
 162 <tr class="separator:ga93bf258ca0007c6641fbe8e4f2b8a1e5"><td class="memSeparator" colspan="2">&#160;</td></tr>
 163 <tr class="memitem:ga8bda3185f46bfd278cea8a6cf357677d"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga8bda3185f46bfd278cea8a6cf357677d">osEventFlagsGet</a> (<a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> ef_id)</td></tr>
 164 <tr class="memdesc:ga8bda3185f46bfd278cea8a6cf357677d"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the current Event Flags.  <br /></td></tr>
 165 <tr class="separator:ga8bda3185f46bfd278cea8a6cf357677d"><td class="memSeparator" colspan="2">&#160;</td></tr>
 166 <tr class="memitem:ga52acb34a8322e58020227344fe662b4e"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga52acb34a8322e58020227344fe662b4e">osEventFlagsWait</a> (<a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> ef_id, uint32_t flags, uint32_t options, uint32_t timeout)</td></tr>
 167 <tr class="memdesc:ga52acb34a8322e58020227344fe662b4e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Wait for one or more Event Flags to become signaled.  <br /></td></tr>
 168 <tr class="separator:ga52acb34a8322e58020227344fe662b4e"><td class="memSeparator" colspan="2">&#160;</td></tr>
 169 <tr class="memitem:ga7c4acf2fb0d506ec82905dee53fb5435"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__CMSIS__RTOS__Definitions.html#ga6c0dbe6069e4e7f47bb4cd32ae2b813e">osStatus_t</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga7c4acf2fb0d506ec82905dee53fb5435">osEventFlagsDelete</a> (<a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> ef_id)</td></tr>
 170 <tr class="memdesc:ga7c4acf2fb0d506ec82905dee53fb5435"><td class="mdescLeft">&#160;</td><td class="mdescRight">Delete an Event Flags object.  <br /></td></tr>
 171 <tr class="separator:ga7c4acf2fb0d506ec82905dee53fb5435"><td class="memSeparator" colspan="2">&#160;</td></tr>
 172 <tr class="memitem:ga59f4ddf0ee8c395b1672bb978d1cfc88"><td class="memItemLeft" align="right" valign="top">const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga59f4ddf0ee8c395b1672bb978d1cfc88">osEventFlagsGetName</a> (<a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> ef_id)</td></tr>
 173 <tr class="memdesc:ga59f4ddf0ee8c395b1672bb978d1cfc88"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get name of an Event Flags object.  <br /></td></tr>
 174 <tr class="separator:ga59f4ddf0ee8c395b1672bb978d1cfc88"><td class="memSeparator" colspan="2">&#160;</td></tr>
 175 </table>
 176 <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
 177 <p>Synchronize threads using event flags. </p>
 178 <p>The event flags management functions in CMSIS-RTOS allow you to control or wait for event flags. Each signal has up to 31 event flags.</p>
 179 <p>A thread</p><ul>
 180 <li>can wait for event flags to be set (using <a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga52acb34a8322e58020227344fe662b4e">osEventFlagsWait</a>). Using this function, it enters the <a class="el" href="group__CMSIS__RTOS__ThreadMgmt.html#ThreadStates">BLOCKED</a> state.</li>
 181 <li>may set one or more flags in any other given thread (using <a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga33b71d14cecf90b4e72639dd19f23a5e">osEventFlagsSet</a>).</li>
 182 <li>may clear its own signals or the signals of other threads (using <a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga93bf258ca0007c6641fbe8e4f2b8a1e5">osEventFlagsClear</a>).</li>
 183 </ul>
 184 <p>When a thread wakes up and resumes execution, its signal flags are automatically cleared (unless event flags option <a class="el" href="group__CMSIS__RTOS__Definitions.html#gaade844a42237d8c37569d4d9b16b9f1c">osFlagsNoClear</a> is specified).</p>
 185 <dl class="section note"><dt>Note</dt><dd>The functions <a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga33b71d14cecf90b4e72639dd19f23a5e">osEventFlagsSet</a>, <a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga93bf258ca0007c6641fbe8e4f2b8a1e5">osEventFlagsClear</a>, <a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga8bda3185f46bfd278cea8a6cf357677d">osEventFlagsGet</a>, and <a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga52acb34a8322e58020227344fe662b4e">osEventFlagsWait</a> can be called from <a class="el" href="usingOS2.html#CMSIS_RTOS_ISR_Calls">Interrupt Service Routines</a>.</dd></dl>
 186 <h2><a class="anchor" id="autotoc_md3"></a>
 187 Working with Events</h2>
 188 <p>Here is a simple example that shows how two thread can communicate with each others using event flags:</p>
 189 <div class="image">
 190 <img src="simple_signal.png" alt=""/>
 191 <div class="caption">
 192 Simple event communication</div></div>
 193 <p>The following steps are required to use event flags:</p><ol type="1">
 194 <li>In the thread that is supposed to send a event with id sig1_id, call the set function: <div class="fragment"><div class="line"><a class="code hl_function" href="group__CMSIS__RTOS__Wait.html#gaf6055a51390ef65b6b6edc28bf47322e" title="Wait for Timeout (Time Delay).">osDelay</a>(1000U);                                           <span class="comment">// wait for 1 second</span></div>
 195 <div class="line"><a class="code hl_function" href="group__CMSIS__RTOS__EventFlags.html#ga33b71d14cecf90b4e72639dd19f23a5e" title="Set the specified Event Flags.">osEventFlagsSet</a>(sig1_id, 0x0001U);                        <span class="comment">// set the flag 0x0001U for event sig1_id</span></div>
 196 </div><!-- fragment --></li>
 197 <li>In another thread (or threads) that are supposed to wait for the event, call the wait function: <div class="fragment"><div class="line"><a class="code hl_function" href="group__CMSIS__RTOS__EventFlags.html#ga52acb34a8322e58020227344fe662b4e" title="Wait for one or more Event Flags to become signaled.">osEventFlagsWait</a>(sig1_id, 0x0001U, NULL, <a class="code hl_define" href="group__CMSIS__RTOS__Definitions.html#ga9eb9a7a797a42e4b55eb171ecc609ddb" title="Wait forever timeout value.">osWaitForever</a>);  <span class="comment">// wait forever for any flag</span></div>
 198 </div><!-- fragment --></li>
 199 </ol>
 200 <p><b>Code Example</b> </p><div class="fragment"><div class="line"><span class="preprocessor">#include &quot;cmsis_os2.h&quot;</span>                          <span class="comment">// CMSIS RTOS header file</span></div>
 201 <div class="line"> </div>
 202 <div class="line"><span class="comment">/*----------------------------------------------------------------------------</span></div>
 203 <div class="line"><span class="comment"> *  Event Flags creation &amp; usage</span></div>
 204 <div class="line"><span class="comment"> *---------------------------------------------------------------------------*/</span></div>
 205 <div class="line"> </div>
 206 <div class="line"><span class="preprocessor">#define FLAGS_MSK1 0x00000001U</span></div>
 207 <div class="line"> </div>
 208 <div class="line"><a class="code hl_typedef" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> evt_id;                        <span class="comment">// event flags id</span></div>
 209 <div class="line"> </div>
 210 <div class="line"><a class="code hl_typedef" href="group__CMSIS__RTOS__ThreadMgmt.html#gaa6c32fe2a3e0a2e01f212d55b02e51c7">osThreadId_t</a> tid_Thread_EventSender;            <span class="comment">// thread id 1</span></div>
 211 <div class="line"><a class="code hl_typedef" href="group__CMSIS__RTOS__ThreadMgmt.html#gaa6c32fe2a3e0a2e01f212d55b02e51c7">osThreadId_t</a> tid_Thread_EventReceiver;          <span class="comment">// thread id 2</span></div>
 212 <div class="line"> </div>
 213 <div class="line"><span class="keywordtype">void</span> Thread_EventSender   (<span class="keywordtype">void</span> *argument);     <span class="comment">// thread function 1</span></div>
 214 <div class="line"><span class="keywordtype">void</span> Thread_EventReceiver (<span class="keywordtype">void</span> *argument);     <span class="comment">// thread function 2</span></div>
 215 <div class="line"> </div>
 216 <div class="line"><span class="keywordtype">int</span> Init_Events (<span class="keywordtype">void</span>) {</div>
 217 <div class="line"> </div>
 218 <div class="line">  evt_id = <a class="code hl_function" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df" title="Create and Initialize an Event Flags object.">osEventFlagsNew</a>(NULL);</div>
 219 <div class="line">  <span class="keywordflow">if</span> (evt_id == NULL) {</div>
 220 <div class="line">    ; <span class="comment">// Event Flags object not created, handle failure</span></div>
 221 <div class="line">  }</div>
 222 <div class="line"> </div>
 223 <div class="line">  tid_Thread_EventSender = <a class="code hl_function" href="group__CMSIS__RTOS__ThreadMgmt.html#ga48d68b8666d99d28fa646ee1d2182b8f" title="Create a thread and add it to Active Threads.">osThreadNew</a>(Thread_EventSender, NULL, NULL);</div>
 224 <div class="line">  <span class="keywordflow">if</span> (tid_Thread_EventSender == NULL) {</div>
 225 <div class="line">    <span class="keywordflow">return</span>(-1);</div>
 226 <div class="line">  }</div>
 227 <div class="line">  tid_Thread_EventReceiver = <a class="code hl_function" href="group__CMSIS__RTOS__ThreadMgmt.html#ga48d68b8666d99d28fa646ee1d2182b8f" title="Create a thread and add it to Active Threads.">osThreadNew</a>(Thread_EventReceiver, NULL, NULL);</div>
 228 <div class="line">  <span class="keywordflow">if</span> (tid_Thread_EventReceiver == NULL) {</div>
 229 <div class="line">    <span class="keywordflow">return</span>(-1);</div>
 230 <div class="line">  }</div>
 231 <div class="line"> </div>
 232 <div class="line">  <span class="keywordflow">return</span>(0);</div>
 233 <div class="line">}</div>
 234 <div class="line"> </div>
 235 <div class="line"><span class="keywordtype">void</span> Thread_EventSender (<span class="keywordtype">void</span> *argument) {</div>
 236 <div class="line"> </div>
 237 <div class="line">  <span class="keywordflow">while</span> (1) {    </div>
 238 <div class="line">    <a class="code hl_function" href="group__CMSIS__RTOS__EventFlags.html#ga33b71d14cecf90b4e72639dd19f23a5e" title="Set the specified Event Flags.">osEventFlagsSet</a>(evt_id, FLAGS_MSK1);</div>
 239 <div class="line">    <a class="code hl_function" href="group__CMSIS__RTOS__ThreadMgmt.html#gad01c7ec26535b1de6b018bb9466720e2" title="Pass control to next thread that is in state READY.">osThreadYield</a>();                            <span class="comment">// suspend thread</span></div>
 240 <div class="line">  }</div>
 241 <div class="line">}</div>
 242 <div class="line"> </div>
 243 <div class="line"><span class="keywordtype">void</span> Thread_EventReceiver (<span class="keywordtype">void</span> *argument) {</div>
 244 <div class="line">  uint32_t flags;</div>
 245 <div class="line"> </div>
 246 <div class="line">  <span class="keywordflow">while</span> (1) {</div>
 247 <div class="line">    flags = <a class="code hl_function" href="group__CMSIS__RTOS__EventFlags.html#ga52acb34a8322e58020227344fe662b4e" title="Wait for one or more Event Flags to become signaled.">osEventFlagsWait</a>(evt_id, FLAGS_MSK1, <a class="code hl_define" href="group__CMSIS__RTOS__Definitions.html#ga18e63587b8450d5b8798b6f6ec04e012" title="Wait for any flag (default).">osFlagsWaitAny</a>, <a class="code hl_define" href="group__CMSIS__RTOS__Definitions.html#ga9eb9a7a797a42e4b55eb171ecc609ddb" title="Wait forever timeout value.">osWaitForever</a>);</div>
 248 <div class="line">    <span class="comment">//handle event</span></div>
 249 <div class="line">  }</div>
 250 <div class="line">}</div>
 251 </div><!-- fragment --> <hr/><h2 class="groupheader">Data Structure Documentation</h2>
 252 <a name="structosEventFlagsAttr__t" id="structosEventFlagsAttr__t"></a>
 253 <h2 class="memtitle"><span class="permalink"><a href="#structosEventFlagsAttr__t">&#9670;&#160;</a></span>osEventFlagsAttr_t</h2>
 254
 255 <div class="memitem">
 256 <div class="memproto">
 257       <table class="memname">
 258         <tr>
 259           <td class="memname">struct osEventFlagsAttr_t</td>
 260         </tr>
 261       </table>
 262 </div><div class="memdoc">
 263 <div class="textblock"><p>Attributes structure for event flags. </p>
 264 <p>Attributes to configure an event flag set.</p>
 265 <p>Refer to <a class="el" href="usingOS2.html#CMSIS_RTOS_MemoryMgmt">Memory Management</a> for details about usage of</p><ul>
 266 <li><a class="el" href="group__CMSIS__RTOS__EventFlags.html#a1e100dc33d403841ed3c344e3397868e" title="memory for control block">osEventFlagsAttr_t::cb_mem</a></li>
 267 <li><a class="el" href="group__CMSIS__RTOS__EventFlags.html#aa55a4335d12dc2785dc00fdc292d1159" title="size of provided memory for control block">osEventFlagsAttr_t::cb_size</a> </li>
 268 </ul>
 269 </div><table class="fieldtable">
 270 <tr><th colspan="3">Data Fields</th></tr>
 271 <tr><td class="fieldtype">
 272 <a id="ab74e6bf80237ddc4109968cedc58c151" name="ab74e6bf80237ddc4109968cedc58c151"></a>const char *</td>
 273 <td class="fieldname">
 274 name</td>
 275 <td class="fielddoc">
 276 name of the event flags <p>Pointer to a constant string with a human readable name (displayed during debugging) of the event flag object.</p>
 277 <p>Default: <span class="XML-Token">NULL</span> no name specified. </p>
 278 </td></tr>
 279 <tr><td class="fieldtype">
 280 <a id="a6e93b49cb79c12f768d72580c7731f30" name="a6e93b49cb79c12f768d72580c7731f30"></a>uint32_t</td>
 281 <td class="fieldname">
 282 attr_bits</td>
 283 <td class="fielddoc">
 284 attribute bits <p>Reserved for future use (must be set to '0' for future compatibility). </p>
 285 </td></tr>
 286 <tr><td class="fieldtype">
 287 <a id="a1e100dc33d403841ed3c344e3397868e" name="a1e100dc33d403841ed3c344e3397868e"></a>void *</td>
 288 <td class="fieldname">
 289 cb_mem</td>
 290 <td class="fielddoc">
 291 memory for control block <p>Pointer to a memory for the event flag control block object. Refer to <a class="el" href="usingOS2.html#CMSIS_RTOS_MemoryMgmt_Manual">Manual User-defined Allocation</a> for more information.</p>
 292 <p>Default: <span class="XML-Token">NULL</span> to use <a class="el" href="usingOS2.html#CMSIS_RTOS_MemoryMgmt_Automatic">Automatic Dynamic Allocation</a> for the event flag control block. </p>
 293 </td></tr>
 294 <tr><td class="fieldtype">
 295 <a id="aa55a4335d12dc2785dc00fdc292d1159" name="aa55a4335d12dc2785dc00fdc292d1159"></a>uint32_t</td>
 296 <td class="fieldname">
 297 cb_size</td>
 298 <td class="fielddoc">
 299 size of provided memory for control block <p>The size (in bytes) of memory block passed with <a class="el" href="group__CMSIS__RTOS__EventFlags.html#a1e100dc33d403841ed3c344e3397868e">cb_mem</a>. Required value depends on the underlying kernel implementation.</p>
 300 <p>Default: <span class="XML-Token">0</span> as the default is no memory provided with <a class="el" href="group__CMSIS__RTOS__EventFlags.html#a1e100dc33d403841ed3c344e3397868e">cb_mem</a>. </p>
 301 </td></tr>
 302 </table>
 303
 304 </div>
 305 </div>
 306 <h2 class="groupheader">Typedef Documentation</h2>
 307 <a id="gafdbab933146d6d81d7cca7287e267a50" name="gafdbab933146d6d81d7cca7287e267a50"></a>
 308 <h2 class="memtitle"><span class="permalink"><a href="#gafdbab933146d6d81d7cca7287e267a50">&#9670;&#160;</a></span>osEventFlagsId_t</h2>
 309
 310 <div class="memitem">
 311 <div class="memproto">
 312       <table class="memname">
 313         <tr>
 314           <td class="memname"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a></td>
 315         </tr>
 316       </table>
 317 </div><div class="memdoc">
 318 <p>Event Flags ID identifies the event flags.</p>
 319 <p>Returned by:</p><ul>
 320 <li><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df">osEventFlagsNew</a> </li>
 321 </ul>
 322
 323 </div>
 324 </div>
 325 <h2 class="groupheader">Function Documentation</h2>
 326 <a id="gab14b1caeb12ffa42cce1bfe889cd07df" name="gab14b1caeb12ffa42cce1bfe889cd07df"></a>
 327 <h2 class="memtitle"><span class="permalink"><a href="#gab14b1caeb12ffa42cce1bfe889cd07df">&#9670;&#160;</a></span>osEventFlagsNew()</h2>
 328
 329 <div class="memitem">
 330 <div class="memproto">
 331       <table class="memname">
 332         <tr>
 333           <td class="memname"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> osEventFlagsNew </td>
 334           <td>(</td>
 335           <td class="paramtype">const <a class="el" href="group__CMSIS__RTOS__EventFlags.html#structosEventFlagsAttr__t">osEventFlagsAttr_t</a> *&#160;</td>
 336           <td class="paramname"><em>attr</em></td><td>)</td>
 337           <td></td>
 338         </tr>
 339       </table>
 340 </div><div class="memdoc">
 341
 342 <p>Create and Initialize an Event Flags object. </p>
 343 <dl class="params"><dt>Parameters</dt><dd>
 344   <table class="params">
 345     <tr><td class="paramdir">[in]</td><td class="paramname">attr</td><td>event flags attributes; NULL: default values. </td></tr>
 346   </table>
 347   </dd>
 348 </dl>
 349 <dl class="section return"><dt>Returns</dt><dd>event flags ID for reference by other functions or NULL in case of error.</dd></dl>
 350 <p>The function <b>osEventFlagsNew</b> creates a new event flags object that is used to send events across threads and returns the pointer to the event flags object identifier or <span class="XML-Token">NULL</span> in case of an error. It can be safely called before the RTOS is started (call to <a class="el" href="group__CMSIS__RTOS__KernelCtrl.html#ga9ae2cc00f0d89d7b6a307bba942b5221">osKernelStart</a>), but not before it is initialized (call to <a class="el" href="group__CMSIS__RTOS__KernelCtrl.html#gae818f6611d25ba3140bede410a52d659">osKernelInitialize</a>).</p>
 351 <p>The parameter <em>attr</em> sets the event flags attributes (refer to <a class="el" href="group__CMSIS__RTOS__EventFlags.html#structosEventFlagsAttr__t">osEventFlagsAttr_t</a>). Default attributes will be used if set to <span class="XML-Token">NULL</span>, i.e. kernel memory allocation is used for the event control block.</p>
 352 <dl class="section note"><dt>Note</dt><dd>Cannot be called from <a class="el" href="usingOS2.html#CMSIS_RTOS_ISR_Calls">Interrupt Service Routines</a>.</dd></dl>
 353 <p><b>Code Example</b> </p><div class="fragment"><div class="line"><span class="preprocessor">#include &quot;cmsis_os2.h&quot;</span>                          <span class="comment">// CMSIS RTOS header file</span></div>
 354 <div class="line"> </div>
 355 <div class="line"><a class="code hl_typedef" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> evt_id;                        <span class="comment">// message queue id</span></div>
 356 <div class="line"> </div>
 357 <div class="line"><span class="keywordtype">int</span> Init_Events (<span class="keywordtype">void</span>) {</div>
 358 <div class="line"> </div>
 359 <div class="line">  evt_id = <a class="code hl_function" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df" title="Create and Initialize an Event Flags object.">osEventFlagsNew</a>(NULL);</div>
 360 <div class="line">  <span class="keywordflow">if</span> (evt_id == NULL) {</div>
 361 <div class="line">    ; <span class="comment">// Event Flags object not created, handle failure</span></div>
 362 <div class="line">    <span class="keywordflow">return</span>(-1);</div>
 363 <div class="line">  }</div>
 364 <div class="line"> </div>
 365 <div class="line">  <span class="keywordflow">return</span>(0);</div>
 366 <div class="line">}</div>
 367 </div><!-- fragment -->
 368 </div>
 369 </div>
 370 <a id="ga33b71d14cecf90b4e72639dd19f23a5e" name="ga33b71d14cecf90b4e72639dd19f23a5e"></a>
 371 <h2 class="memtitle"><span class="permalink"><a href="#ga33b71d14cecf90b4e72639dd19f23a5e">&#9670;&#160;</a></span>osEventFlagsSet()</h2>
 372
 373 <div class="memitem">
 374 <div class="memproto">
 375       <table class="memname">
 376         <tr>
 377           <td class="memname">uint32_t osEventFlagsSet </td>
 378           <td>(</td>
 379           <td class="paramtype"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a>&#160;</td>
 380           <td class="paramname"><em>ef_id</em>, </td>
 381         </tr>
 382         <tr>
 383           <td class="paramkey"></td>
 384           <td></td>
 385           <td class="paramtype">uint32_t&#160;</td>
 386           <td class="paramname"><em>flags</em>&#160;</td>
 387         </tr>
 388         <tr>
 389           <td></td>
 390           <td>)</td>
 391           <td></td><td></td>
 392         </tr>
 393       </table>
 394 </div><div class="memdoc">
 395
 396 <p>Set the specified Event Flags. </p>
 397 <dl class="params"><dt>Parameters</dt><dd>
 398   <table class="params">
 399     <tr><td class="paramdir">[in]</td><td class="paramname">ef_id</td><td>event flags ID obtained by <a class="el" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df">osEventFlagsNew</a>. </td></tr>
 400     <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>specifies the flags that shall be set. </td></tr>
 401   </table>
 402   </dd>
 403 </dl>
 404 <dl class="section return"><dt>Returns</dt><dd>event flags after setting or error code if highest bit set.</dd></dl>
 405 <p>The function <b>osEventFlagsSet</b> sets the event flags specified by the parameter <em>flags</em> in an event flags object specified by parameter <em>ef_id</em>.</p>
 406 <p>The threads with highest priority waiting for the flag(s) set will be notified to resume from <a class="el" href="group__CMSIS__RTOS__ThreadMgmt.html#ThreadStates">BLOCKED</a> state. The function returns the event flags stored in the event control block or an error code (highest bit is set, refer to <a class="el" href="group__flags__error__codes.html">Flags Functions Error Codes</a>). Further threads may be wakened in priority order when the option <b>osFlagsNoClear</b> is given to the <a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga52acb34a8322e58020227344fe662b4e">osEventFlagsWait</a> call.</p>
 407 <p>Possible <a class="el" href="group__flags__error__codes.html">Flags Functions Error Codes</a> return values:</p><ul>
 408 <li><em>osFlagsErrorUnknown:</em> unspecified error.</li>
 409 <li><em>osFlagsErrorParameter:</em> parameter <em>ef_id</em> does not identify a valid event flags object or <em>flags</em> has highest bit set.</li>
 410 <li><em>osFlagsErrorResource:</em> the event flags object is in an invalid state.</li>
 411 <li><em>osFlagsErrorSafetyClass:</em> the calling thread safety class is lower than the safety class of the specified event flags object.</li>
 412 </ul>
 413 <dl class="section note"><dt>Note</dt><dd>This function may be called from <a class="el" href="usingOS2.html#CMSIS_RTOS_ISR_Calls">Interrupt Service Routines</a>.</dd></dl>
 414 <p><b>Code Example</b> </p><div class="fragment"><div class="line"><span class="preprocessor">#include &quot;cmsis_os2.h&quot;</span>                          <span class="comment">// CMSIS RTOS header file</span></div>
 415 <div class="line"> </div>
 416 <div class="line"><a class="code hl_typedef" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> evt_id;                        <span class="comment">// event flags id</span></div>
 417 <div class="line"> </div>
 418 <div class="line"><span class="keywordtype">void</span> Thread_EventSender (<span class="keywordtype">void</span> *argument) {</div>
 419 <div class="line"> </div>
 420 <div class="line">  <span class="keywordflow">while</span> (1) {    </div>
 421 <div class="line">    <a class="code hl_function" href="group__CMSIS__RTOS__EventFlags.html#ga33b71d14cecf90b4e72639dd19f23a5e" title="Set the specified Event Flags.">osEventFlagsSet</a>(evt_id, 0x00000001U);</div>
 422 <div class="line">    <a class="code hl_function" href="group__CMSIS__RTOS__ThreadMgmt.html#gad01c7ec26535b1de6b018bb9466720e2" title="Pass control to next thread that is in state READY.">osThreadYield</a>();                            <span class="comment">// suspend thread</span></div>
 423 <div class="line">  }</div>
 424 <div class="line">}</div>
 425 </div><!-- fragment -->
 426 </div>
 427 </div>
 428 <a id="ga93bf258ca0007c6641fbe8e4f2b8a1e5" name="ga93bf258ca0007c6641fbe8e4f2b8a1e5"></a>
 429 <h2 class="memtitle"><span class="permalink"><a href="#ga93bf258ca0007c6641fbe8e4f2b8a1e5">&#9670;&#160;</a></span>osEventFlagsClear()</h2>
 430
 431 <div class="memitem">
 432 <div class="memproto">
 433       <table class="memname">
 434         <tr>
 435           <td class="memname">uint32_t osEventFlagsClear </td>
 436           <td>(</td>
 437           <td class="paramtype"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a>&#160;</td>
 438           <td class="paramname"><em>ef_id</em>, </td>
 439         </tr>
 440         <tr>
 441           <td class="paramkey"></td>
 442           <td></td>
 443           <td class="paramtype">uint32_t&#160;</td>
 444           <td class="paramname"><em>flags</em>&#160;</td>
 445         </tr>
 446         <tr>
 447           <td></td>
 448           <td>)</td>
 449           <td></td><td></td>
 450         </tr>
 451       </table>
 452 </div><div class="memdoc">
 453
 454 <p>Clear the specified Event Flags. </p>
 455 <dl class="params"><dt>Parameters</dt><dd>
 456   <table class="params">
 457     <tr><td class="paramdir">[in]</td><td class="paramname">ef_id</td><td>event flags ID obtained by <a class="el" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df">osEventFlagsNew</a>. </td></tr>
 458     <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>specifies the flags that shall be cleared. </td></tr>
 459   </table>
 460   </dd>
 461 </dl>
 462 <dl class="section return"><dt>Returns</dt><dd>event flags before clearing or error code if highest bit set.</dd></dl>
 463 <p>The function <b>osEventFlagsClear</b> clears the event flags specified by the parameter <em>flags</em> in an event flags object specified by parameter <em>ef_id</em>. The function returns the event flags before clearing or an error code (highest bit is set, refer to <a class="el" href="group__flags__error__codes.html">Flags Functions Error Codes</a>).</p>
 464 <p>Possible <a class="el" href="group__flags__error__codes.html">Flags Functions Error Codes</a> return values:</p><ul>
 465 <li><em>osFlagsErrorUnknown:</em> unspecified error.</li>
 466 <li><em>osFlagsErrorParameter:</em> parameter <em>ef_id</em> does not identify a valid event flags object or <em>flags</em> has highest bit set.</li>
 467 <li><em>osFlagsErrorResource:</em> the event flags object is in an invalid state.</li>
 468 <li><em>osFlagsErrorSafetyClass:</em> the calling thread safety class is lower than the safety class of the specified event flags object.</li>
 469 </ul>
 470 <dl class="section note"><dt>Note</dt><dd>This function may be called from <a class="el" href="usingOS2.html#CMSIS_RTOS_ISR_Calls">Interrupt Service Routines</a>. </dd></dl>
 471
 472 </div>
 473 </div>
 474 <a id="ga8bda3185f46bfd278cea8a6cf357677d" name="ga8bda3185f46bfd278cea8a6cf357677d"></a>
 475 <h2 class="memtitle"><span class="permalink"><a href="#ga8bda3185f46bfd278cea8a6cf357677d">&#9670;&#160;</a></span>osEventFlagsGet()</h2>
 476
 477 <div class="memitem">
 478 <div class="memproto">
 479       <table class="memname">
 480         <tr>
 481           <td class="memname">uint32_t osEventFlagsGet </td>
 482           <td>(</td>
 483           <td class="paramtype"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a>&#160;</td>
 484           <td class="paramname"><em>ef_id</em></td><td>)</td>
 485           <td></td>
 486         </tr>
 487       </table>
 488 </div><div class="memdoc">
 489
 490 <p>Get the current Event Flags. </p>
 491 <dl class="params"><dt>Parameters</dt><dd>
 492   <table class="params">
 493     <tr><td class="paramdir">[in]</td><td class="paramname">ef_id</td><td>event flags ID obtained by <a class="el" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df">osEventFlagsNew</a>. </td></tr>
 494   </table>
 495   </dd>
 496 </dl>
 497 <dl class="section return"><dt>Returns</dt><dd>current event flags.</dd></dl>
 498 <p>The function <b>osEventFlagsGet</b> returns the event flags currently set in an event flags object specified by parameter <em>ef_id</em> or <span class="XML-Token">0</span> in case of an error.</p>
 499 <dl class="section note"><dt>Note</dt><dd>This function may be called from <a class="el" href="usingOS2.html#CMSIS_RTOS_ISR_Calls">Interrupt Service Routines</a>. </dd></dl>
 500
 501 </div>
 502 </div>
 503 <a id="ga52acb34a8322e58020227344fe662b4e" name="ga52acb34a8322e58020227344fe662b4e"></a>
 504 <h2 class="memtitle"><span class="permalink"><a href="#ga52acb34a8322e58020227344fe662b4e">&#9670;&#160;</a></span>osEventFlagsWait()</h2>
 505
 506 <div class="memitem">
 507 <div class="memproto">
 508       <table class="memname">
 509         <tr>
 510           <td class="memname">uint32_t osEventFlagsWait </td>
 511           <td>(</td>
 512           <td class="paramtype"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a>&#160;</td>
 513           <td class="paramname"><em>ef_id</em>, </td>
 514         </tr>
 515         <tr>
 516           <td class="paramkey"></td>
 517           <td></td>
 518           <td class="paramtype">uint32_t&#160;</td>
 519           <td class="paramname"><em>flags</em>, </td>
 520         </tr>
 521         <tr>
 522           <td class="paramkey"></td>
 523           <td></td>
 524           <td class="paramtype">uint32_t&#160;</td>
 525           <td class="paramname"><em>options</em>, </td>
 526         </tr>
 527         <tr>
 528           <td class="paramkey"></td>
 529           <td></td>
 530           <td class="paramtype">uint32_t&#160;</td>
 531           <td class="paramname"><em>timeout</em>&#160;</td>
 532         </tr>
 533         <tr>
 534           <td></td>
 535           <td>)</td>
 536           <td></td><td></td>
 537         </tr>
 538       </table>
 539 </div><div class="memdoc">
 540
 541 <p>Wait for one or more Event Flags to become signaled. </p>
 542 <dl class="params"><dt>Parameters</dt><dd>
 543   <table class="params">
 544     <tr><td class="paramdir">[in]</td><td class="paramname">ef_id</td><td>event flags ID obtained by <a class="el" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df">osEventFlagsNew</a>. </td></tr>
 545     <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>specifies the flags to wait for. </td></tr>
 546     <tr><td class="paramdir">[in]</td><td class="paramname">options</td><td>specifies flags options (osFlagsXxxx). </td></tr>
 547     <tr><td class="paramdir">[in]</td><td class="paramname">timeout</td><td><a class="el" href="usingOS2.html#CMSIS_RTOS_TimeOutValue">Timeout Values</a> or 0 in case of no time-out. </td></tr>
 548   </table>
 549   </dd>
 550 </dl>
 551 <dl class="section return"><dt>Returns</dt><dd>event flags before clearing or error code if highest bit set.</dd></dl>
 552 <p>The function <b>osEventFlagsWait</b> suspends the execution of the currently <a class="el" href="group__CMSIS__RTOS__ThreadMgmt.html#ThreadStates">RUNNING</a> thread until any or all event flags specified by the parameter <em>flags</em> in the event object specified by parameter <em>ef_id</em> are set. When these event flags are already set, the function returns instantly. Otherwise, the thread is put into the state <a class="el" href="group__CMSIS__RTOS__ThreadMgmt.html#ThreadStates">BLOCKED</a>.</p>
 553 <p>The <em>options</em> parameter specifies the wait condition: </p><table class="markdownTable">
 554 <tr class="markdownTableHead">
 555 <th class="markdownTableHeadNone">Option   </th><th class="markdownTableHeadNone"></th></tr>
 556 <tr class="markdownTableRowOdd">
 557 <td class="markdownTableBodyNone"><b>osFlagsWaitAny</b>   </td><td class="markdownTableBodyNone">Wait for any flag (default).    </td></tr>
 558 <tr class="markdownTableRowEven">
 559 <td class="markdownTableBodyNone"><b>osFlagsWaitAll</b>   </td><td class="markdownTableBodyNone">Wait for all flags.    </td></tr>
 560 <tr class="markdownTableRowOdd">
 561 <td class="markdownTableBodyNone"><b>osFlagsNoClear</b>   </td><td class="markdownTableBodyNone">Do not clear flags which have been specified to wait for.   </td></tr>
 562 </table>
 563 <p>If <code>osFlagsNoClear</code> is set in the options <a class="el" href="group__CMSIS__RTOS__EventFlags.html#ga93bf258ca0007c6641fbe8e4f2b8a1e5">osEventFlagsClear</a> can be used to clear flags manually.</p>
 564 <p>The parameter <em>timeout</em> specifies how long the system waits for event flags. While the system waits, the thread that is calling this function is put into the <a class="el" href="group__CMSIS__RTOS__ThreadMgmt.html#ThreadStates">BLOCKED</a> state. The parameter <a class="el" href="usingOS2.html#CMSIS_RTOS_TimeOutValue">timeout</a> can have the following values:</p><ul>
 565 <li>when <em>timeout</em> is <span class="XML-Token">0</span>, the function returns instantly (i.e. try semantics).</li>
 566 <li>when <em>timeout</em> is set to <b>osWaitForever</b> the function will wait for an infinite time until the event flags become available (i.e. wait semantics).</li>
 567 <li>all other values specify a time in kernel ticks for a timeout (i.e. timed-wait semantics).</li>
 568 </ul>
 569 <p>The function returns the event flags before clearing or an error code (highest bit is set, refer to <a class="el" href="group__flags__error__codes.html">Flags Functions Error Codes</a>).</p>
 570 <p>Possible <a class="el" href="group__flags__error__codes.html">Flags Functions Error Codes</a> return values:</p><ul>
 571 <li><em>osFlagsErrorUnknown:</em> unspecified error.</li>
 572 <li><em>osFlagsErrorTimeout:</em> awaited flags have not been set in the given time.</li>
 573 <li><em>osFlagsErrorResource:</em> awaited flags have not been set when no <em>timeout</em> was specified.</li>
 574 <li><em>osFlagsErrorParameter:</em> parameter <em>ef_id</em> does not identify a valid event flags object or <em>flags</em> has highest bit set.</li>
 575 <li><em>osFlagsErrorSafetyClass:</em> the calling thread safety class is lower than the safety class of the specified event flags object.</li>
 576 </ul>
 577 <dl class="section note"><dt>Note</dt><dd>May be called from <a class="el" href="usingOS2.html#CMSIS_RTOS_ISR_Calls">Interrupt Service Routines</a> if the parameter <em>timeout</em> is set to <span class="XML-Token">0</span>.</dd></dl>
 578 <p><b>Code</b> <b>Example</b> </p><div class="fragment"><div class="line"><span class="preprocessor">#include &quot;cmsis_os2.h&quot;</span>                          <span class="comment">// CMSIS RTOS header file</span></div>
 579 <div class="line"> </div>
 580 <div class="line"><a class="code hl_typedef" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> evt_id;                        <span class="comment">// event flags id</span></div>
 581 <div class="line"> </div>
 582 <div class="line"><span class="keywordtype">void</span> Thread_EventReceiver (<span class="keywordtype">void</span> *argument) {</div>
 583 <div class="line">  uint32_t flags;</div>
 584 <div class="line"> </div>
 585 <div class="line">  <span class="keywordflow">while</span> (1) {</div>
 586 <div class="line">    flags = <a class="code hl_function" href="group__CMSIS__RTOS__EventFlags.html#ga52acb34a8322e58020227344fe662b4e" title="Wait for one or more Event Flags to become signaled.">osEventFlagsWait</a>(evt_id, 0x00000001U, <a class="code hl_define" href="group__CMSIS__RTOS__Definitions.html#ga18e63587b8450d5b8798b6f6ec04e012" title="Wait for any flag (default).">osFlagsWaitAny</a>, <a class="code hl_define" href="group__CMSIS__RTOS__Definitions.html#ga9eb9a7a797a42e4b55eb171ecc609ddb" title="Wait forever timeout value.">osWaitForever</a>);</div>
 587 <div class="line">    <span class="comment">//handle event</span></div>
 588 <div class="line">  }</div>
 589 <div class="line">}</div>
 590 </div><!-- fragment -->
 591 </div>
 592 </div>
 593 <a id="ga7c4acf2fb0d506ec82905dee53fb5435" name="ga7c4acf2fb0d506ec82905dee53fb5435"></a>
 594 <h2 class="memtitle"><span class="permalink"><a href="#ga7c4acf2fb0d506ec82905dee53fb5435">&#9670;&#160;</a></span>osEventFlagsDelete()</h2>
 595
 596 <div class="memitem">
 597 <div class="memproto">
 598       <table class="memname">
 599         <tr>
 600           <td class="memname"><a class="el" href="group__CMSIS__RTOS__Definitions.html#ga6c0dbe6069e4e7f47bb4cd32ae2b813e">osStatus_t</a> osEventFlagsDelete </td>
 601           <td>(</td>
 602           <td class="paramtype"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a>&#160;</td>
 603           <td class="paramname"><em>ef_id</em></td><td>)</td>
 604           <td></td>
 605         </tr>
 606       </table>
 607 </div><div class="memdoc">
 608
 609 <p>Delete an Event Flags object. </p>
 610 <dl class="params"><dt>Parameters</dt><dd>
 611   <table class="params">
 612     <tr><td class="paramdir">[in]</td><td class="paramname">ef_id</td><td>event flags ID obtained by <a class="el" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df">osEventFlagsNew</a>. </td></tr>
 613   </table>
 614   </dd>
 615 </dl>
 616 <dl class="section return"><dt>Returns</dt><dd>status code that indicates the execution status of the function.</dd></dl>
 617 <p>The function <b>osEventFlagsDelete</b> deletes the event flags object specified by parameter <em>ef_id</em> and releases the internal memory obtained for the event flags handling. After this call, the <em>ef_id</em> is no longer valid and cannot be used. This can cause starvation of threads that are waiting for flags of this event object. The <em>ef_id</em> may be created again using the function <a class="el" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df">osEventFlagsNew</a>.</p>
 618 <p>Possible <a class="el" href="group__CMSIS__RTOS__Definitions.html#ga6c0dbe6069e4e7f47bb4cd32ae2b813e">osStatus_t</a> return values:</p><ul>
 619 <li><em>osOK:</em> the specified event flags object has been deleted.</li>
 620 <li><em>osErrorISR:</em> <b>osEventFlagsDelete</b> cannot be called from interrupt service routines.</li>
 621 <li><em>osErrorParameter:</em> parameter <em>ef_id</em> is <span class="XML-Token">NULL</span> or invalid.</li>
 622 <li><em>osErrorResource:</em> the event flags object is in an invalid state.</li>
 623 <li><em>osFlagsErrorSafetyClass:</em> the calling thread safety class is lower than the safety class of the specified event flags object.</li>
 624 </ul>
 625 <dl class="section note"><dt>Note</dt><dd>This function <b>cannot</b> be called from <a class="el" href="usingOS2.html#CMSIS_RTOS_ISR_Calls">Interrupt Service Routines</a>. </dd></dl>
 626
 627 </div>
 628 </div>
 629 <a id="ga59f4ddf0ee8c395b1672bb978d1cfc88" name="ga59f4ddf0ee8c395b1672bb978d1cfc88"></a>
 630 <h2 class="memtitle"><span class="permalink"><a href="#ga59f4ddf0ee8c395b1672bb978d1cfc88">&#9670;&#160;</a></span>osEventFlagsGetName()</h2>
 631
 632 <div class="memitem">
 633 <div class="memproto">
 634       <table class="memname">
 635         <tr>
 636           <td class="memname">const char * osEventFlagsGetName </td>
 637           <td>(</td>
 638           <td class="paramtype"><a class="el" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a>&#160;</td>
 639           <td class="paramname"><em>ef_id</em></td><td>)</td>
 640           <td></td>
 641         </tr>
 642       </table>
 643 </div><div class="memdoc">
 644
 645 <p>Get name of an Event Flags object. </p>
 646 <dl class="params"><dt>Parameters</dt><dd>
 647   <table class="params">
 648     <tr><td class="paramdir">[in]</td><td class="paramname">ef_id</td><td>event flags ID obtained by <a class="el" href="group__CMSIS__RTOS__EventFlags.html#gab14b1caeb12ffa42cce1bfe889cd07df">osEventFlagsNew</a>. </td></tr>
 649   </table>
 650   </dd>
 651 </dl>
 652 <dl class="section return"><dt>Returns</dt><dd>name as null-terminated string.</dd></dl>
 653 <p>The function <b>osEventFlagsGetName</b> returns the pointer to the name string of the event flags object identified by parameter <em>ef_id</em> or <span class="XML-Token">NULL</span> in case of an error.</p>
 654 <dl class="section note"><dt>Note</dt><dd>This function may be called from <a class="el" href="usingOS2.html#CMSIS_RTOS_ISR_Calls">Interrupt Service Routines</a>.</dd></dl>
 655 <p><b>Code Example</b> </p><div class="fragment"><div class="line"><span class="preprocessor">#include &quot;cmsis_os2.h&quot;</span>                          <span class="comment">// CMSIS RTOS header file</span></div>
 656 <div class="line"> </div>
 657 <div class="line"><a class="code hl_typedef" href="group__CMSIS__RTOS__EventFlags.html#gafdbab933146d6d81d7cca7287e267a50">osEventFlagsId_t</a> evt_id;                        <span class="comment">// event flasg id</span></div>
 658 <div class="line"> </div>
 659 <div class="line"><span class="keywordtype">void</span> EvtFlagsGetName_example (<span class="keywordtype">void</span>)  {</div>
 660 <div class="line">  <span class="keywordtype">char</span> *name;</div>
 661 <div class="line">   </div>
 662 <div class="line">  name = <a class="code hl_function" href="group__CMSIS__RTOS__EventFlags.html#ga59f4ddf0ee8c395b1672bb978d1cfc88" title="Get name of an Event Flags object.">osEventFlagsGetName</a>(evt_id);</div>
 663 <div class="line">  <span class="keywordflow">if</span> (name == NULL) {</div>
 664 <div class="line">    <span class="comment">// Failed to get the event flags object name</span></div>
 665 <div class="line">  }</div>
 666 <div class="line">}</div>
 667 </div><!-- fragment -->
 668 </div>
 669 </div>
 670 </div><!-- contents -->
 671 </div><!-- doc-content -->
 672 <!-- start footer part -->
 673 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
 674   <ul>
 675     <li class="footer">
 676       <script type="text/javascript">
 677         <!--
 678         writeFooter.call(this);
 679         //-->
 680       </script>
 681     </li>
 682   </ul>
 683 </div>
 684 </body>
 685 </html>