You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mynewt.apache.org by ad...@apache.org on 2017/02/20 16:26:52 UTC

[2/9] incubator-mynewt-site git commit: Updated event queue documentation and tutorial. PR #153 and #154.

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/core_os/event_queue/os_eventq_run/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/event_queue/os_eventq_run/index.html b/latest/os/core_os/event_queue/os_eventq_run/index.html
new file mode 100644
index 0000000..f8518ca
--- /dev/null
+++ b/latest/os/core_os/event_queue/os_eventq_run/index.html
@@ -0,0 +1,866 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="utf-8">
+        <meta http-equiv="X-UA-Compatible" content="IE=edge">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        
+        
+        <!-- This is broken by doc revisioning.
+        <link rel="canonical" href="http://mynewt.apache.org/os/core_os/event_queue/os_eventq_run/"> -->
+        <link rel="shortcut icon" href="../../../../img/favicon.ico">
+
+	    <title>os_eventq_run - Apache Mynewt</title>
+
+        <link href="../../../../css/bootstrap-3.0.3.min.css" rel="stylesheet">
+        <link rel="stylesheet" href="../../../../css/highlight.css">
+        <link href="../../../../css/base.css" rel="stylesheet">
+        <link href="../../../../css/custom.css" rel="stylesheet">
+        <link href="../../../../css/v2.css" rel="stylesheet">
+        <link href="https://fonts.googleapis.com/css?family=Lato" rel="stylesheet">
+        <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
+        <link href="../../../../extra.css" rel="stylesheet">
+
+        <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
+        <!--[if lt IE 9]>
+            <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
+            <script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
+        <![endif]-->
+
+        
+            <script>
+                (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+                (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+                m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+                })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+                ga('create', 'UA-72162311-1', 'auto');
+                ga('send', 'pageview');
+            </script>
+        
+    </head>
+
+
+    <body class="os_eventq_run">
+
+
+        <div class="container">
+    <div class="row v2-main-banner">
+        <a class="logo-cell" href="/">
+            <img class="logo" src="/img/logo.png">
+        </a>
+        <div class="tagline-cell">
+            <h4 class="tagline">An OS to build, deploy and securely manage billions of devices</h4>
+        </div>
+        <div class="news-cell">
+            <div class="well">
+                <h4>Latest News:</h4> <a href="/download">Apache Mynewt 1.0.0-b1</a> released (Dec 13, 2016)
+            </div>
+        </div>
+    </div>
+</div>
+
+        
+
+
+
+
+
+
+<nav id="navbar" class="navbar navbar-inverse affix-top" data-spy="affix" data-offset-top="150" role="navigation">
+    <div class="container">
+        <!-- Collapsed navigation -->
+        <div class="navbar-header">
+            <!-- Expander button -->
+            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+
+        </div>
+
+        <!-- Expanded navigation -->
+        <div class="navbar-collapse collapse">
+            <!-- Main navigation -->
+            <ul class="nav navbar-nav navbar-right">
+                <li 
+  class=""
+>
+                    <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
+                </li>
+                <li 
+  class="important"
+>
+                    <a href="/quick-start/">Quick Start</a>
+                </li>
+                <li 
+  class=""
+>
+                    <a href="/about/">About</a>
+                </li>
+                <li 
+  class=""
+>
+                    <a href="/talks/">Talks</a>
+                </li>
+                <li 
+  class="active"
+>
+                    <a href="/latest/os/introduction">Documentation</a>
+                </li>
+                <li 
+  class=""
+>
+                    <a href="/download/">Download</a>
+                </li>
+                <li 
+  class=""
+>
+                    <a href="/community/">Community</a>
+                </li>
+                <li 
+  class=""
+>
+                    <a href="/events/">Events</a>
+                </li>
+            </ul>
+
+            <!-- Search, Navigation and Repo links -->
+            <ul class="nav navbar-nav navbar-right">
+                
+            </ul>
+        </div>
+    </div>
+</nav>
+
+        
+
+        <div class="container">
+            
+                <div class="row">
+                    <div class="col-md-3 v2-sidebar sidebar-container"><div id="docSidebar" class="hidden-print" role="complementary">
+    <div class="top">
+        <div role="search">
+            <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
+                <div class="form-group">
+                    <input type="text" name="q" class="form-control" placeholder="Search documentation" />
+                </div>
+            </form>
+        </div>
+    </div>
+    <ul class="toc-nav">
+      <li class="doc-version">
+<select class="form-control" onchange="if (this.value) window.location.href=this.value">
+    
+    <option
+      value="/develop/os/introduction"
+      selected="selected"
+    >
+      Version: develop (latest)
+    </option>
+    
+    <option
+      value="/v0_9_0/os/introduction"
+      
+    >
+      Version: 0.9.0
+    </option>
+    
+</select>
+</li>
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+          
+  
+  
+    <li ><a href="../../../introduction/">Mynewt Documentation</a>
+  
+  
+    <ul>
+          
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../get_started/get_started/">Basic Setup</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../../../get_started/vocabulary/">Concepts</a>
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../tutorials/tutorials/">Tutorials</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../os_user_guide/">OS User Guide</a>
+  
+  
+    <ul>
+          
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../mynewt_os/">OS Core</a>
+  
+  
+    <ul>
+          
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ../../os_started/
+">Functions</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../context_switch/context_switch/">Scheduler</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../time/os_time/">Time</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../task/task/">Tasks</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../event_queue/">Event Queues</a>
+  
+  
+    <ul>
+          
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ../os_eventq_init/
+">Functions</a>
+  
+  
+    <ul>
+          
+              
+                
+    <li >
+      <a href="../os_eventq_init/">os_eventq_init</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../os_eventq_inited/">os_eventq_inited</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../os_eventq_get/">os_eventq_get</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../os_eventq_put/">os_eventq_put</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../os_eventq_remove/">os_eventq_remove</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../os_eventq_dflt_get/">os_eventq_dflt_get</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../os_eventq_designate/">os_eventq_designate</a>
+    </li>
+
+              
+          
+              
+                
+    <li class="active">
+      <a href="./">os_eventq_run</a>
+    </li>
+
+              
+          
+    </ul>
+  
+    </li>
+
+              
+          
+    </ul>
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../semaphore/semaphore/">Semaphores</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../mutex/mutex/">Mutexes</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../memory_pool/memory_pool/">Memory Pools</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../heap/heap/">Heap</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  
+  
+  ../../mbuf/mbuf/
+
+">Memory Buffers</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../sanity/sanity/">Sanity</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../callout/callout/">Callouts</a>
+  
+  
+    </li>
+
+              
+          
+    </ul>
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../porting/port_os/">Porting to your Platform</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/console/console/">Console</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/shell/shell/">Shell</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/split/split/">Split Images</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/bootloader/bootloader/">Bootloader</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  
+  
+  ../../../modules/fs/fs/fs/
+
+">File System</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/hal/hal/">Hardware Abstraction Layer</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/drivers/driver/">Drivers</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/testutil/testutil/">Test Utilities</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/devmgmt/newtmgr/">Device Management with Newt Manager</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/imgmgr/imgmgr/">Image Manager</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../../../modules/baselibc/">Baselibc library</a>
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/elua/elua/">Embedded Lua</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/json/json/">JSON</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/fcb/fcb/">Flash Circular Buffer</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/stats/stats/">Stats</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/logs/logs/">Logs</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../modules/sysinitconfig/sysinitconfig/">System Configuration And Initialization</a>
+  
+  
+    </li>
+
+              
+          
+    </ul>
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ../../../../network/ble/ble_intro/
+">BLE User Guide</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../../newt/newt_intro/">Newt Tool Guide</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li ><a href="../../../../newtmgr/overview/">Newt Manager Guide</a>
+  
+  
+    </li>
+
+              
+          
+    </ul>
+  
+    </li>
+
+        
+      
+        
+          
+  
+  
+    <li><a href="
+  ../../../../faq/how_to_edit_docs/
+">Appendix</a>
+  
+  
+    </li>
+
+        
+      
+    </ul>
+</div></div>
+
+                    <div class="col-md-9" role="main">
+                        <div class="doc-header">
+                            <div role="navigation" aria-label="breadcrumbs navigation">
+  <ul class="wy-breadcrumbs pull-right">
+    <li><a href="/latest/os/introduction">Docs</a></li>
+    
+    
+        
+          <li>&raquo; <a href="../event_queue/">Event Queues</a></li>
+        
+      
+        
+          <li>&raquo; <a href="../os_eventq_init/">Functions</a></li>
+        
+      
+      
+        <li>&raquo; os_eventq_run</li>
+      
+    
+    
+  </ul>
+</div>
+                        </div>
+                        
+                            <h2 id="os_eventq_run"><font color="F2853F" style="font-size:24pt"> os_eventq_run</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">   <span style="color: #A90D91">void</span>
+    <span style="color: #000000">os_eventq_run</span>(<span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> <span style="color: #000000">*evq</span>)
+</pre></div>
+
+
+<p>Wrapper function that calls the <code>os_eventq_get()</code> function to dequeue the event from the head of the event queue and then calls the callback function for the event.</p>
+<h4 id="arguments">Arguments</h4>
+<table>
+<thead>
+<tr>
+<th>Arguments</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>evq</code></td>
+<td>Event queue to dequeue the event from</td>
+</tr>
+</tbody>
+</table>
+<h4 id="returned-values">Returned values</h4>
+<p>None</p>
+<h4 id="notes">Notes</h4>
+<h4 id="example">Example</h4>
+<p><Add text to set up the context for the example here>
+This example shows an application <code>main()</code> that calls the <code>os_eventq_run()</code> function to process events from the OS default event queue in an infinite loop.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">int</span>
+<span style="color: #000000">main</span>(<span style="color: #A90D91">int</span> <span style="color: #000000">argc</span>, <span style="color: #A90D91">char</span> <span style="color: #000000">**argv</span>)
+{
+
+     <span style="color: #000000">sysinit</span>();
+       ...
+
+     <span style="color: #A90D91">while</span> (<span style="color: #1C01CE">1</span>) {
+        <span style="color: #000000">os_eventq_run</span>(<span style="color: #000000">os_eventq_dflt_get</span>());
+     }
+}
+</pre></div>
+                        
+                        <div class="row">
+                            
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+    <li>
+    
+    <a href=../os_eventq_designate/>
+        <span class="fa fa-arrow-left"></span>
+        Previous: os_eventq_designate
+    </a>
+    
+    </li>
+    <li class="pull-right">
+    
+    <a href=../../semaphore/semaphore/>
+        Next: Semaphores
+        <span class="fa fa-arrow-right"></span>
+    </a>
+    
+    </li>
+</ul>
+                        </div>
+                        <footer class="row">
+    <div class="col-xs-12">
+        
+            <p class="copyright">Apache Mynewt (incubating) is available under Apache License, version 2.0.</p>
+        
+    </div>
+    <div class="col-xs-12">
+        <div class="logos">
+            <img src="/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
+            <small class="footnote">
+                MyNewt is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
+            </small>
+            <img src="/img/egg-logo2.png" alt="Apache Incubator" title="Apache Incubator">
+        </div>
+    </div>
+</footer>
+                    </div>
+                </div>
+            
+            
+        </div>
+
+        <script src="../../../../js/jquery-1.10.2.min.js"></script>
+        <script src="../../../../js/bootstrap-3.0.3.min.js"></script>
+        <script src="../../../../js/highlight.pack.js"></script>
+        <script src="../../../../js/base.js"></script>
+        <script src="../../../../js/custom.js"></script>
+
+    </body>
+</html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/core_os/semaphore/semaphore/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/semaphore/semaphore/index.html b/latest/os/core_os/semaphore/semaphore/index.html
index ebeb8c6..8a560db 100644
--- a/latest/os/core_os/semaphore/semaphore/index.html
+++ b/latest/os/core_os/semaphore/semaphore/index.html
@@ -771,9 +771,9 @@
 <ul class="nav nav-pills" style="margin-bottom: 10px">
     <li>
     
-    <a href=../../event_queue/os_eventq_dflt_get/>
+    <a href=../../event_queue/os_eventq_run/>
         <span class="fa fa-arrow-left"></span>
-        Previous: os_eventq_dflt_get
+        Previous: os_eventq_run
     </a>
     
     </li>

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/STM32F303/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/STM32F303/index.html b/latest/os/tutorials/STM32F303/index.html
index a5a0b60..81a0782 100644
--- a/latest/os/tutorials/STM32F303/index.html
+++ b/latest/os/tutorials/STM32F303/index.html
@@ -355,8 +355,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/add_newtmgr/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/add_newtmgr/index.html b/latest/os/tutorials/add_newtmgr/index.html
index e71832a..a31fe8f 100644
--- a/latest/os/tutorials/add_newtmgr/index.html
+++ b/latest/os/tutorials/add_newtmgr/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               
@@ -494,10 +507,10 @@ to customize your application.</p>
 <h3 id="prerequisites">Prerequisites</h3>
 <p>Ensure that you have met the following prerequisites before continuing with this tutorial:</p>
 <ul>
-<li>Installed the <a href="../../../newt/install/newt_mac/">newt tool</a>. </li>
-<li>Installed the <a href="../../../newtmgr/installing/">newtmgr tool</a>.</li>
+<li>Install the <a href="../../../newt/install/newt_mac/">newt tool</a>. </li>
+<li>Install the <a href="../../../newtmgr/installing/">newtmgr tool</a>.</li>
 <li>Have Internet connectivity to fetch remote Mynewt components.</li>
-<li>Installed the <a href="../../get_started/native_tools/">compiler tools</a> to 
+<li>Install the <a href="../../get_started/native_tools/">compiler tools</a> to 
 support native compiling to build the project this tutorial creates.  </li>
 <li>Have a cable to establish a serial USB connection between the board and the laptop.</li>
 </ul>
@@ -550,29 +563,22 @@ and <code>run</code> commands. The <code>SHELL_TASK</code> setting enables the s
 package functionality.</p>
 <p><br></p>
 <h3 id="modify-the-source">Modify the Source</h3>
-<p>Your application must designate an event queue that the <code>mgmt</code> package uses to receive request events from 
-the newtmgr tool.  The <code>mgmt</code> package executes and handles newtmgr request events in the context of the task that
-processes events from this event queue.  You can designate the default event queue that Mynewt 
-creates.  If you choose to create and use a dedicated event queue, you must also 
-initialize a task and implement the task handler to dispatch events from this queue.  This example 
-uses the default event queue that Mynewt creates. </p>
-<p>The <code>mgmt</code> package exports the <code>void mgmt_evq_set(struct os_eventq *evq)</code> 
-function that an application must call to designate the event queue.
-Modify <code>main.c</code> to add this call as follows:</p>
+<p>By default, the <code>mgmt</code> package uses the Mynewt default event queue to receive request events from the newtmgr tool. These events are processed in the context of the application main task. </p>
+<p>You can specify a different event queue for the package to use.  If you choose to use a dedicated event queue, you must create a task to process events from this event queue.  The <code>mgmt</code> package executes and handles newtmgr request events in the context of this task.  The <code>mgmt</code> package exports the <code>mgmt_evq_set()</code> function that allows you to specify an event queue. </p>
+<p>This example uses the Mynewt default event queue and you do not need to modify your application source.  </p>
+<p>If you choose to use a different event queue, see <a href="../event_queue/">Events and Event Queues</a> for details on how to initialize an event queue and create a task to process the events. You will also need to modify your <code>main.c</code> to add the call to the <code>mgmt_evq_set()</code> function as follows:</p>
 <p>Add the <code>mgmt/mgmt.h</code> header file: </p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">#include &lt;mgmt/mgmt.h&gt;
 </pre></div>
 
 
-<p>Add the call to designate the event queue. In the <code>main()</code> function,<br />
-scroll down to the  <code>while (1)</code> loop and add the 
-following statement above the loop: </p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">mgmt_evq_set(os_eventq_dflt_get())
+<p><br>
+Add the call to specify the event queue. In the <code>main()</code> function, scroll down to the  <code>while (1)</code> loop and add the following statement above the loop: </p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">mgmt_evq_set(&amp;my_eventq)
 </pre></div>
 
 
-<p><strong>Note:</strong> If you choose to create and use a dedicated event queue, you must initialize the event queue and 
-the task before calling the <code>mgmt_evq_set()</code> function. </p>
+<p>where <code>my_eventq</code> is an event queue that you have initialized.</p>
 <h3 id="build-the-targets">Build the Targets</h3>
 <p>Build the two targets as follows:</p>
 <div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt build nrf52_boot

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/add_shell/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/add_shell/index.html b/latest/os/tutorials/add_shell/index.html
index a9bf018..7ab6d97 100644
--- a/latest/os/tutorials/add_shell/index.html
+++ b/latest/os/tutorials/add_shell/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/air_quality_ble/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/air_quality_ble/index.html b/latest/os/tutorials/air_quality_ble/index.html
index f4c8a90..8250911 100644
--- a/latest/os/tutorials/air_quality_ble/index.html
+++ b/latest/os/tutorials/air_quality_ble/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/air_quality_sensor/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/air_quality_sensor/index.html b/latest/os/tutorials/air_quality_sensor/index.html
index eea6eaa..5b2eadc 100644
--- a/latest/os/tutorials/air_quality_sensor/index.html
+++ b/latest/os/tutorials/air_quality_sensor/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ./
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/arduino_zero/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/arduino_zero/index.html b/latest/os/tutorials/arduino_zero/index.html
index 77ba88d..f22e2c4 100644
--- a/latest/os/tutorials/arduino_zero/index.html
+++ b/latest/os/tutorials/arduino_zero/index.html
@@ -341,8 +341,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/blehci_project/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/blehci_project/index.html b/latest/os/tutorials/blehci_project/index.html
index 84d1f95..33d13c1 100644
--- a/latest/os/tutorials/blehci_project/index.html
+++ b/latest/os/tutorials/blehci_project/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/bleprph/bleprph-adv/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/bleprph/bleprph-adv/index.html b/latest/os/tutorials/bleprph/bleprph-adv/index.html
index 3c973bc..a976ada 100644
--- a/latest/os/tutorials/bleprph/bleprph-adv/index.html
+++ b/latest/os/tutorials/bleprph/bleprph-adv/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../../event_queue/">Add task to manage multiple events</a>
+      <a href="../../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/bleprph/bleprph-app/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/bleprph/bleprph-app/index.html b/latest/os/tutorials/bleprph/bleprph-app/index.html
index b178a49..bba1968 100644
--- a/latest/os/tutorials/bleprph/bleprph-app/index.html
+++ b/latest/os/tutorials/bleprph/bleprph-app/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../../event_queue/">Add task to manage multiple events</a>
+      <a href="../../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/bleprph/bleprph-chr-access/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/bleprph/bleprph-chr-access/index.html b/latest/os/tutorials/bleprph/bleprph-chr-access/index.html
index c90db21..a3c5711 100644
--- a/latest/os/tutorials/bleprph/bleprph-chr-access/index.html
+++ b/latest/os/tutorials/bleprph/bleprph-chr-access/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../../event_queue/">Add task to manage multiple events</a>
+      <a href="../../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/bleprph/bleprph-gap-event/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/bleprph/bleprph-gap-event/index.html b/latest/os/tutorials/bleprph/bleprph-gap-event/index.html
index fead055..0d76c77 100644
--- a/latest/os/tutorials/bleprph/bleprph-gap-event/index.html
+++ b/latest/os/tutorials/bleprph/bleprph-gap-event/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../../event_queue/">Add task to manage multiple events</a>
+      <a href="../../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/bleprph/bleprph-intro/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/bleprph/bleprph-intro/index.html b/latest/os/tutorials/bleprph/bleprph-intro/index.html
index 1eead55..7dc8020 100644
--- a/latest/os/tutorials/bleprph/bleprph-intro/index.html
+++ b/latest/os/tutorials/bleprph/bleprph-intro/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../../event_queue/">Add task to manage multiple events</a>
+      <a href="../../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/bleprph/bleprph-svc-reg/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/bleprph/bleprph-svc-reg/index.html b/latest/os/tutorials/bleprph/bleprph-svc-reg/index.html
index 44fd0e8..1ebed0b 100644
--- a/latest/os/tutorials/bleprph/bleprph-svc-reg/index.html
+++ b/latest/os/tutorials/bleprph/bleprph-svc-reg/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../../event_queue/">Add task to manage multiple events</a>
+      <a href="../../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/bletiny_project/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/bletiny_project/index.html b/latest/os/tutorials/bletiny_project/index.html
index b05811d..358558c 100644
--- a/latest/os/tutorials/bletiny_project/index.html
+++ b/latest/os/tutorials/bletiny_project/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/blinky_console/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/blinky_console/index.html b/latest/os/tutorials/blinky_console/index.html
index 88476ef..6459ab6 100644
--- a/latest/os/tutorials/blinky_console/index.html
+++ b/latest/os/tutorials/blinky_console/index.html
@@ -341,8 +341,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/blinky_primo/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/blinky_primo/index.html b/latest/os/tutorials/blinky_primo/index.html
index edde0a4..4750433 100644
--- a/latest/os/tutorials/blinky_primo/index.html
+++ b/latest/os/tutorials/blinky_primo/index.html
@@ -341,8 +341,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/blinky_sram_olimex/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/blinky_sram_olimex/index.html b/latest/os/tutorials/blinky_sram_olimex/index.html
index e5c2def..51a00f3 100644
--- a/latest/os/tutorials/blinky_sram_olimex/index.html
+++ b/latest/os/tutorials/blinky_sram_olimex/index.html
@@ -341,8 +341,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>
 
               

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/f245f6aa/latest/os/tutorials/eddystone/index.html
----------------------------------------------------------------------
diff --git a/latest/os/tutorials/eddystone/index.html b/latest/os/tutorials/eddystone/index.html
index bf259a8..eae796c 100644
--- a/latest/os/tutorials/eddystone/index.html
+++ b/latest/os/tutorials/eddystone/index.html
@@ -278,8 +278,21 @@
           
               
                 
+  
+  
+    <li><a href="
+  ../air_quality_sensor/
+">Air-quality Sensor project</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
     <li >
-      <a href="../event_queue/">Add task to manage multiple events</a>
+      <a href="../event_queue/">Events and Event Queues</a>
     </li>