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 2016/11/18 01:14:45 UTC
[5/7] incubator-mynewt-site git commit: Updated events. Updated event
queue documentation. This closes #126
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/db7dea53/develop/os/core_os/event_queue/event_queue/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/event_queue/event_queue/index.html b/develop/os/core_os/event_queue/event_queue/index.html
index 8302e06..8a6b3f2 100644
--- a/develop/os/core_os/event_queue/event_queue/index.html
+++ b/develop/os/core_os/event_queue/event_queue/index.html
@@ -306,7 +306,7 @@
<li><a href="
- ../os_eventq_get/
+ ../os_eventq_init/
">Functions</a>
@@ -661,21 +661,25 @@
</div>
<h1 id="event-queues">Event Queues</h1>
-<p>Event queue is a way of serializing events arring to a task. This makes it easy to queue processing to happen inside task's context. This would be done either from an interrupt handler, or from another task.</p>
-<p>Events arrive in a form of a data structure <code>struct os_event</code>.</p>
+<p>Event queue is a way for a task to serialize events sent to it. This makes it easy to process events required to happen inside the task's context. Events may arrive either from an interrupt handler, or from another task.</p>
<h3 id="description">Description</h3>
-<p>Events are in form of a data structure <code>struct os_event</code>, and they are queued to data structure <code>struct os_eventq</code>.</p>
-<p>Queue must be initialized before trying to add events to it. This is done using <code>os_eventq_init()</code>.</p>
-<p>Common way of using event queues is to have a task loop while calling <code>os_eventq_get()</code>, waiting for work to do.
-Other tasks (or interrupts) then call <code>os_eventq_put()</code> to wake it up. Once event has been queued task waiting on that queue is woken up, and will get a pointer to queued event structure.
-Processing task would then act according to event type.</p>
+<p>Events arrive in form the of a data structure <code>struct os_event</code> and
+they are queued to another data structure <code>struct os_eventq</code>.</p>
+<p>The Event Queue must be initialized before trying to add events to
+it. This is done using <code>os_eventq_init()</code>.</p>
+<p>A common way of using event queues is to have a task loop while calling <code>os_eventq_get()</code>,
+waiting for work to do. Other tasks (or interrupts) then call <code>os_eventq_put()</code>
+to wake it up. Once an event has been queued, the task waiting on that queue is woken up. The event dispatching logic is built into each event via a callback function pointer. The task handler can simply pull events
+off the queue and call its callback handler. The processing task would then act according to the event type. </p>
<p>When <code>os_event</code> is queued, it should not be freed until processing task is done with it.</p>
<p>It is assumed that there is only one task consuming events from an event queue. Only one task should be sleeping on a particular <code>os_eventq</code> at a time.</p>
<p>Note that <a href="../../callout/callout/">os_callout</a> subsystem assumes that event queue is used as the wakeup mechanism.</p>
<h3 id="data-structures">Data structures</h3>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">struct</span> <span style="color: #000000">os_event</span> {
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">typedef</span> <span style="color: #A90D91">void</span> <span style="color: #000000">os_event_fn</span>(<span style="color: #A90D91">struct</span> <span style="color: #000000">os_event</span> <span style="color: #000000">*ev</span>);
+
+<span style="color: #A90D91">struct</span> <span style="color: #000000">os_event</span> {
<span style="color: #A90D91">uint8_t</span> <span style="color: #000000">ev_queued</span>;
- <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">ev_type</span>;
+ <span style="color: #000000">os_event_fn</span> <span style="color: #000000">*ev_cb</span>;
<span style="color: #A90D91">void</span> <span style="color: #000000">*ev_arg</span>;
<span style="color: #000000">STAILQ_ENTRY</span>(<span style="color: #000000">os_event</span>) <span style="color: #000000">ev_next</span>;
};
@@ -691,23 +695,56 @@ Processing task would then act according to event type.</p>
</thead>
<tbody>
<tr>
-<td>ev_queued</td>
+<td><code>ev_queued</code></td>
<td>Internal field, which tells whether event is linked into an <em>os_eventq</em> already</td>
</tr>
<tr>
-<td>ev_type</td>
-<td>Type of an event. This should be unique, as it should be used by processing task to figure out what the event means</td>
+<td><code>ev_cb</code></td>
+<td>A callback function pointer that is called when a new event arrives on the queue</td>
</tr>
<tr>
-<td>ev_arg</td>
+<td><code>ev_arg</code></td>
<td>Can be used further as input to task processing this event</td>
</tr>
<tr>
-<td>ev_next</td>
+<td><code>ev_next</code></td>
<td>Linkage attaching this event to an event queue</td>
</tr>
</tbody>
</table>
+<p>With the callback function pointer, the dispatch logic gets built into each event. The task handler simply pulls an event off its queue and blindly calls its callback function. A helper function was added to do just this:
+<code>os_eventq_run()</code>. As an example, the task handler for the bleprph application is below:</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">static</span> <span style="color: #A90D91">void</span>
+<span style="color: #000000">bleprph_task_handler</span>(<span style="color: #A90D91">void</span> <span style="color: #000000">*unused</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">&bleprph_evq</span>);
+ }
+}
+</pre></div>
+
+
+<p>The callback associated with an event is specified when the event gets
+initialized. For example, here are some statically-initialized events
+in the NimBLE host:</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">static</span> <span style="color: #A90D91">void</span> <span style="color: #000000">ble_hs_event_tx_notify</span>(<span style="color: #A90D91">struct</span> <span style="color: #000000">os_event</span> <span style="color: #000000">*ev</span>);
+<span style="color: #A90D91">static</span> <span style="color: #A90D91">void</span> <span style="color: #000000">ble_hs_event_reset</span>(<span style="color: #A90D91">struct</span> <span style="color: #000000">os_event</span> <span style="color: #000000">*ev</span>);
+
+<span style="color: #177500">/** OS event - triggers tx of pending notifications and indications. */</span>
+<span style="color: #A90D91">static</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">os_event</span> <span style="color: #000000">ble_hs_ev_tx_notifications</span> <span style="color: #000000">=</span> {
+ .<span style="color: #000000">ev_cb</span> <span style="color: #000000">=</span> <span style="color: #000000">ble_hs_event_tx_notify</span>,
+};
+
+<span style="color: #177500">/** OS event - triggers a full reset. */</span>
+<span style="color: #A90D91">static</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">os_event</span> <span style="color: #000000">ble_hs_ev_reset</span> <span style="color: #000000">=</span> {
+ .<span style="color: #000000">ev_cb</span> <span style="color: #000000">=</span> <span style="color: #000000">ble_hs_event_reset</span>,
+};
+</pre></div>
+
+
+<p>The callback function receives a single parameter: a
+pointer to the event being processed. If the event is allocated
+dynamically, the callback function should free the event. </p>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> {
<span style="color: #A90D91">struct</span> <span style="color: #000000">os_task</span> <span style="color: #000000">*evq_task</span>;
<span style="color: #000000">STAILQ_HEAD</span>(, <span style="color: #000000">os_event</span>) <span style="color: #000000">evq_list</span>;
@@ -724,11 +761,11 @@ Processing task would then act according to event type.</p>
</thead>
<tbody>
<tr>
-<td>evq_task</td>
+<td><code>evq_task</code></td>
<td>Pointer to task if there is task sleeping on <em>os_eventq_get()</em></td>
</tr>
<tr>
-<td>evq_list</td>
+<td><code>evq_list</code></td>
<td>Queue head for list of events in this queue</td>
</tr>
</tbody>
@@ -744,21 +781,33 @@ Processing task would then act according to event type.</p>
</thead>
<tbody>
<tr>
-<td><a href="../os_eventq_get/">os_eventq_get</a></td>
-<td>Fetches the first event from a queue. Task will sleep until something gets queued.</td>
+<td><a href="../os_eventq_init/"><code>os_eventq_init</code></a></td>
+<td>Initializes the given event queue, making it ready for use.</td>
</tr>
<tr>
-<td><a href="../os_eventq_init/">os_eventq_init</a></td>
-<td>Initializes the given event queue, making it ready for use.</td>
+<td><a href="../os_eventq_inited/"><code>os_eventq_inited</code></a></td>
+<td>Has the event queue been initialized.</td>
+</tr>
+<tr>
+<td><a href="../os_eventq_get/"><code>os_eventq_get</code></a></td>
+<td>Fetches the first event from a queue. Task will sleep until something gets queued.</td>
</tr>
<tr>
-<td><a href="../os_eventq_put/">os_eventq_put</a></td>
+<td><a href="../os_eventq_put/"><code>os_eventq_put</code></a></td>
<td>Queues an event to tail of the event queue.</td>
</tr>
<tr>
-<td><a href="../os_eventq_remove/">os_eventq_remove</a></td>
+<td><a href="../os_eventq_remove/"><code>os_eventq_remove</code></a></td>
<td>Removes an event which has been placed in a queue.</td>
</tr>
+<tr>
+<td><a href="../os_eventq_dflt_set/"><code>os_eventq_dflt_set</code></a></td>
+<td>Set the default event queue.</td>
+</tr>
+<tr>
+<td><a href="../os_eventq_dflt_get/"><code>os_eventq_dflt_get</code></a></td>
+<td>Get the default event queue.</td>
+</tr>
</tbody>
</table>
@@ -778,8 +827,8 @@ Processing task would then act according to event type.</p>
</li>
<li class="pull-right">
- <a href=../os_eventq_get/>
- Next: os_eventq_get
+ <a href=../os_eventq_init/>
+ Next: os_eventq_init
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/db7dea53/develop/os/core_os/event_queue/os_eventq_dflt_get/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/event_queue/os_eventq_dflt_get/index.html b/develop/os/core_os/event_queue/os_eventq_dflt_get/index.html
new file mode 100644
index 0000000..c8c574e
--- /dev/null
+++ b/develop/os/core_os/event_queue/os_eventq_dflt_get/index.html
@@ -0,0 +1,807 @@
+<!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_dflt_get/"> -->
+ <link rel="shortcut icon" href="../../../../img/favicon.ico">
+
+ <title>os_eventq_dflt_get - 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_dflt_get">
+
+
+ <div class="container">
+ <div class="row v2-main-banner">
+ <div class="col-xs-12 v2-vcenter">
+ <a href="/"><img class="logo" src="/img/logo.png"></a>
+
+ <h4 class="tagline">An OS to build, deploy and securely manage billions of devices</h4>
+ </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_init/
+">System-level 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_set/">os_eventq_dflt_set</a>
+ </li>
+
+
+
+
+
+ <li class="active">
+ <a href="./">os_eventq_dflt_get</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/testutil/testutil/">Test Utilities</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>
+
+
+
+ </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="/develop/os/introduction">Docs</a></li>
+
+
+
+ <li>» <a href="../event_queue/">Event Queues</a></li>
+
+
+
+ <li>» <a href="../os_eventq_init/">Functions</a></li>
+
+
+
+ <li>» os_eventq_dflt_get</li>
+
+
+
+ </ul>
+</div>
+ </div>
+
+ <h2 id="os_eventq_dflt_get"><font color="F2853F" style="font-size:24pt"> os_eventq_dflt_get</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> <span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span>
+ <span style="color: #000000">*os_eventq_dflt_get</span>(<span style="color: #A90D91">void</span>)
+</pre></div>
+
+
+<p>Get the default event queue that was set</p>
+<h4 id="arguments">Arguments</h4>
+<p>None</p>
+<h4 id="returned-values">Returned values</h4>
+<p><code>struct os_eventq *</code> A pointer to the default event queue, if set. </p>
+<h4 id="notes">Notes</h4>
+<p>None</p>
+<h4 id="example">Example</h4>
+<p><Add text to set up the context for the example here>
+This checks the default event queue and sets it if not already set.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> <span style="color: #000000">g_my_evq</span>;
+
+<span style="color: #A90D91">int</span>
+<span style="color: #000000">event_q_check</span>()
+{
+ <span style="color: #A90D91">if</span>(<span style="color: #000000">os_eventq_dflt_get</span>() <span style="color: #000000">==</span> <span style="color: #A90D91">NULL</span>)
+ {
+ <span style="color: #000000">os_eventq_dflt_set</span>(<span style="color: #000000">g_my_evq</span>);
+ }
+
+}
+</pre></div>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../os_eventq_dflt_set/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: os_eventq_dflt_set
+ </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">Copyright © 2015 The Apache Software Foundation, Licensed under the Apache License, Version 2.0 Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</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/db7dea53/develop/os/core_os/event_queue/os_eventq_dflt_set/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/event_queue/os_eventq_dflt_set/index.html b/develop/os/core_os/event_queue/os_eventq_dflt_set/index.html
new file mode 100644
index 0000000..54e026b
--- /dev/null
+++ b/develop/os/core_os/event_queue/os_eventq_dflt_set/index.html
@@ -0,0 +1,821 @@
+<!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_dflt_set/"> -->
+ <link rel="shortcut icon" href="../../../../img/favicon.ico">
+
+ <title>os_eventq_dflt_set - 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_dflt_set">
+
+
+ <div class="container">
+ <div class="row v2-main-banner">
+ <div class="col-xs-12 v2-vcenter">
+ <a href="/"><img class="logo" src="/img/logo.png"></a>
+
+ <h4 class="tagline">An OS to build, deploy and securely manage billions of devices</h4>
+ </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_init/
+">System-level 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 class="active">
+ <a href="./">os_eventq_dflt_set</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../os_eventq_dflt_get/">os_eventq_dflt_get</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/testutil/testutil/">Test Utilities</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>
+
+
+
+ </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="/develop/os/introduction">Docs</a></li>
+
+
+
+ <li>» <a href="../event_queue/">Event Queues</a></li>
+
+
+
+ <li>» <a href="../os_eventq_init/">Functions</a></li>
+
+
+
+ <li>» os_eventq_dflt_set</li>
+
+
+
+ </ul>
+</div>
+ </div>
+
+ <h2 id="os_eventq_dflt_set"><font color="F2853F" style="font-size:24pt"> os_eventq_dflt_set</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_dflt_set</span>(<span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> <span style="color: #000000">*evq</span>)
+</pre></div>
+
+
+<p>Sets <code>struct os_eventq</code> as the default event queue</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>Pointer to default event queue to use</td>
+</tr>
+</tbody>
+</table>
+<h4 id="returned-values">Returned values</h4>
+<p>None</p>
+<h4 id="notes">Notes</h4>
+<p>Usually done at subsystem init time; before OS has been started, and before interrupts generating events have been enabled.</p>
+<h4 id="example">Example</h4>
+<p><Add text to set up the context for the example here>
+This sets the default event queue used by newtmgr task.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> <span style="color: #000000">g_nmgr_evq</span>;
+
+<span style="color: #A90D91">int</span>
+<span style="color: #000000">nmgr_task_init</span>(<span style="color: #A90D91">uint8_t</span> <span style="color: #000000">prio</span>, <span style="color: #A90D91">os_stack_t</span> <span style="color: #000000">*stack_ptr</span>, <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">stack_len</span>)
+{
+ <span style="color: #177500">/* variable declarations here */</span>
+
+ <span style="color: #000000">os_eventq_init</span>(<span style="color: #000000">&g_nmgr_evq</span>);
+ <span style="color: #000000">os_eventq_dflt_set</span>(<span style="color: #000000">&g_nmgr_evq</span>);
+
+ <span style="color: #177500">/* initialization continues here */</span>
+}
+</pre></div>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../os_eventq_remove/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: os_eventq_remove
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../os_eventq_dflt_get/>
+ Next: os_eventq_dflt_get
+ <span class="fa fa-arrow-right"></span>
+ </a>
+
+ </li>
+</ul>
+ </div>
+ <footer class="row">
+ <div class="col-xs-12">
+
+ <p class="copyright">Copyright © 2015 The Apache Software Foundation, Licensed under the Apache License, Version 2.0 Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</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/db7dea53/develop/os/core_os/event_queue/os_eventq_get/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/event_queue/os_eventq_get/index.html b/develop/os/core_os/event_queue/os_eventq_get/index.html
index ebc2feb..8e3e69c 100644
--- a/develop/os/core_os/event_queue/os_eventq_get/index.html
+++ b/develop/os/core_os/event_queue/os_eventq_get/index.html
@@ -306,7 +306,7 @@
<li><a href="
- ./
+ ../os_eventq_init/
">Functions</a>
@@ -314,8 +314,8 @@
- <li class="active">
- <a href="./">os_eventq_get</a>
+ <li >
+ <a href="../os_eventq_init/">os_eventq_init</a>
</li>
@@ -323,7 +323,15 @@
<li >
- <a href="../os_eventq_init/">os_eventq_init</a>
+ <a href="../os_eventq_inited/">os_eventq_inited</a>
+ </li>
+
+
+
+
+
+ <li class="active">
+ <a href="./">os_eventq_get</a>
</li>
@@ -344,6 +352,22 @@
+
+
+ <li >
+ <a href="../os_eventq_dflt_set/">os_eventq_dflt_set</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../os_eventq_dflt_get/">os_eventq_dflt_get</a>
+ </li>
+
+
+
</ul>
</li>
@@ -686,7 +710,7 @@
- <li>» Functions</li>
+ <li>» <a href="../os_eventq_init/">Functions</a></li>
@@ -742,16 +766,16 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../event_queue/>
+ <a href=../os_eventq_inited/>
<span class="fa fa-arrow-left"></span>
- Previous: Event Queues
+ Previous: os_eventq_inited
</a>
</li>
<li class="pull-right">
- <a href=../os_eventq_init/>
- Next: os_eventq_init
+ <a href=../os_eventq_put/>
+ Next: os_eventq_put
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/db7dea53/develop/os/core_os/event_queue/os_eventq_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/event_queue/os_eventq_init/index.html b/develop/os/core_os/event_queue/os_eventq_init/index.html
index fefebab..b66541d 100644
--- a/develop/os/core_os/event_queue/os_eventq_init/index.html
+++ b/develop/os/core_os/event_queue/os_eventq_init/index.html
@@ -306,7 +306,7 @@
<li><a href="
- ../os_eventq_get/
+ ./
">Functions</a>
@@ -314,16 +314,24 @@
+ <li class="active">
+ <a href="./">os_eventq_init</a>
+ </li>
+
+
+
+
+
<li >
- <a href="../os_eventq_get/">os_eventq_get</a>
+ <a href="../os_eventq_inited/">os_eventq_inited</a>
</li>
- <li class="active">
- <a href="./">os_eventq_init</a>
+ <li >
+ <a href="../os_eventq_get/">os_eventq_get</a>
</li>
@@ -344,6 +352,22 @@
+
+
+ <li >
+ <a href="../os_eventq_dflt_set/">os_eventq_dflt_set</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../os_eventq_dflt_get/">os_eventq_dflt_get</a>
+ </li>
+
+
+
</ul>
</li>
@@ -686,7 +710,7 @@
- <li>» <a href="../os_eventq_get/">Functions</a></li>
+ <li>» Functions</li>
@@ -748,16 +772,16 @@ This initializes event queue used by newtmgr task.</p>
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../os_eventq_get/>
+ <a href=../event_queue/>
<span class="fa fa-arrow-left"></span>
- Previous: os_eventq_get
+ Previous: Event Queues
</a>
</li>
<li class="pull-right">
- <a href=../os_eventq_put/>
- Next: os_eventq_put
+ <a href=../os_eventq_inited/>
+ Next: os_eventq_inited
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/db7dea53/develop/os/core_os/event_queue/os_eventq_inited/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/event_queue/os_eventq_inited/index.html b/develop/os/core_os/event_queue/os_eventq_inited/index.html
new file mode 100644
index 0000000..237d975
--- /dev/null
+++ b/develop/os/core_os/event_queue/os_eventq_inited/index.html
@@ -0,0 +1,823 @@
+<!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_inited/"> -->
+ <link rel="shortcut icon" href="../../../../img/favicon.ico">
+
+ <title>os_eventq_inited - 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_inited">
+
+
+ <div class="container">
+ <div class="row v2-main-banner">
+ <div class="col-xs-12 v2-vcenter">
+ <a href="/"><img class="logo" src="/img/logo.png"></a>
+
+ <h4 class="tagline">An OS to build, deploy and securely manage billions of devices</h4>
+ </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_init/
+">System-level 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 class="active">
+ <a href="./">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_set/">os_eventq_dflt_set</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../os_eventq_dflt_get/">os_eventq_dflt_get</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/testutil/testutil/">Test Utilities</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>
+
+
+
+ </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="/develop/os/introduction">Docs</a></li>
+
+
+
+ <li>» <a href="../event_queue/">Event Queues</a></li>
+
+
+
+ <li>» <a href="../os_eventq_init/">Functions</a></li>
+
+
+
+ <li>» os_eventq_inited</li>
+
+
+
+ </ul>
+</div>
+ </div>
+
+ <h2 id="os_eventq_inited"><font color="F2853F" style="font-size:24pt"> os_eventq_inited</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> <span style="color: #A90D91">int</span>
+ <span style="color: #000000">os_eventq_inited</span>(<span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> <span style="color: #000000">*evq</span>)
+</pre></div>
+
+
+<p>Check if event queue <code>const struct os_eventq</code> is ready for use.</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>Pointer to event queue to check</td>
+</tr>
+</tbody>
+</table>
+<h4 id="returned-values">Returned values</h4>
+<p><code>0</code> if event queue is ready</p>
+<h4 id="notes">Notes</h4>
+<p>If an event queue was properly initialized (and the proper checks were done at initialization)
+this check is not needed prior to using an event queue.</p>
+<h4 id="example">Example</h4>
+<p><Add text to set up the context for the example here>
+This checks an event queue before using it.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> <span style="color: #000000">g_my_evq</span>;
+
+<span style="color: #A90D91">int</span>
+<span style="color: #000000">my_task_init</span>(<span style="color: #A90D91">uint8_t</span> <span style="color: #000000">prio</span>, <span style="color: #A90D91">os_stack_t</span> <span style="color: #000000">*stack_ptr</span>, <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">stack_len</span>)
+{
+ <span style="color: #177500">/* variable declarations here */</span>
+
+ <span style="color: #A90D91">if</span>(<span style="color: #000000">os_eventq_inited</span>(<span style="color: #000000">&g_my_evq</span>))
+ {
+ <span style="color: #177500">/* deal with the event queue */</span>
+ };
+
+}
+</pre></div>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../os_eventq_init/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: os_eventq_init
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../os_eventq_get/>
+ Next: os_eventq_get
+ <span class="fa fa-arrow-right"></span>
+ </a>
+
+ </li>
+</ul>
+ </div>
+ <footer class="row">
+ <div class="col-xs-12">
+
+ <p class="copyright">Copyright © 2015 The Apache Software Foundation, Licensed under the Apache License, Version 2.0 Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</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/db7dea53/develop/os/core_os/event_queue/os_eventq_put/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/event_queue/os_eventq_put/index.html b/develop/os/core_os/event_queue/os_eventq_put/index.html
index caba04d..3252b29 100644
--- a/develop/os/core_os/event_queue/os_eventq_put/index.html
+++ b/develop/os/core_os/event_queue/os_eventq_put/index.html
@@ -306,7 +306,7 @@
<li><a href="
- ../os_eventq_get/
+ ../os_eventq_init/
">Functions</a>
@@ -315,7 +315,7 @@
<li >
- <a href="../os_eventq_get/">os_eventq_get</a>
+ <a href="../os_eventq_init/">os_eventq_init</a>
</li>
@@ -323,7 +323,15 @@
<li >
- <a href="../os_eventq_init/">os_eventq_init</a>
+ <a href="../os_eventq_inited/">os_eventq_inited</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../os_eventq_get/">os_eventq_get</a>
</li>
@@ -344,6 +352,22 @@
+
+
+ <li >
+ <a href="../os_eventq_dflt_set/">os_eventq_dflt_set</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../os_eventq_dflt_get/">os_eventq_dflt_get</a>
+ </li>
+
+
+
</ul>
</li>
@@ -686,7 +710,7 @@
- <li>» <a href="../os_eventq_get/">Functions</a></li>
+ <li>» <a href="../os_eventq_init/">Functions</a></li>
@@ -752,9 +776,9 @@ This is used to pass info about an event to a task handling it.</p>
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../os_eventq_init/>
+ <a href=../os_eventq_get/>
<span class="fa fa-arrow-left"></span>
- Previous: os_eventq_init
+ Previous: os_eventq_get
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/db7dea53/develop/os/core_os/event_queue/os_eventq_remove/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/event_queue/os_eventq_remove/index.html b/develop/os/core_os/event_queue/os_eventq_remove/index.html
index 3d2f421..bb3cf4e 100644
--- a/develop/os/core_os/event_queue/os_eventq_remove/index.html
+++ b/develop/os/core_os/event_queue/os_eventq_remove/index.html
@@ -306,7 +306,7 @@
<li><a href="
- ../os_eventq_get/
+ ../os_eventq_init/
">Functions</a>
@@ -315,7 +315,7 @@
<li >
- <a href="../os_eventq_get/">os_eventq_get</a>
+ <a href="../os_eventq_init/">os_eventq_init</a>
</li>
@@ -323,7 +323,15 @@
<li >
- <a href="../os_eventq_init/">os_eventq_init</a>
+ <a href="../os_eventq_inited/">os_eventq_inited</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../os_eventq_get/">os_eventq_get</a>
</li>
@@ -344,6 +352,22 @@
+
+
+ <li >
+ <a href="../os_eventq_dflt_set/">os_eventq_dflt_set</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../os_eventq_dflt_get/">os_eventq_dflt_get</a>
+ </li>
+
+
+
</ul>
</li>
@@ -686,7 +710,7 @@
- <li>» <a href="../os_eventq_get/">Functions</a></li>
+ <li>» <a href="../os_eventq_init/">Functions</a></li>
@@ -751,8 +775,8 @@ This is from <code>os_callout_stop()</code>. User wants to stop a callout from g
</li>
<li class="pull-right">
- <a href=../../semaphore/semaphore/>
- Next: Semaphores
+ <a href=../os_eventq_dflt_set/>
+ Next: os_eventq_dflt_set
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/db7dea53/develop/os/core_os/semaphore/semaphore/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/semaphore/semaphore/index.html b/develop/os/core_os/semaphore/semaphore/index.html
index cd31e62..cd672b7 100644
--- a/develop/os/core_os/semaphore/semaphore/index.html
+++ b/develop/os/core_os/semaphore/semaphore/index.html
@@ -732,9 +732,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../event_queue/os_eventq_remove/>
+ <a href=../../event_queue/os_eventq_dflt_get/>
<span class="fa fa-arrow-left"></span>
- Previous: os_eventq_remove
+ Previous: os_eventq_dflt_get
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/db7dea53/develop/os/tutorials/repo/create_repo/index.html
----------------------------------------------------------------------
diff --git a/develop/os/tutorials/repo/create_repo/index.html b/develop/os/tutorials/repo/create_repo/index.html
index 15f679a..cbed4e4 100644
--- a/develop/os/tutorials/repo/create_repo/index.html
+++ b/develop/os/tutorials/repo/create_repo/index.html
@@ -503,7 +503,7 @@ repo.versions:
<p>It contains the following:</p>
<ul>
<li><strong>repo.name</strong> The external name that is used to include the library in
-your <code>project.yml</code> file. This is the name you in include in the <code>project.repositories</code>
+your <code>project.yml</code> file. This is the name you include in the <code>project.repositories</code>
variable when adding this repository to your project.</li>
<li><strong>repo.versions</strong> A description of what versions to give the user depending
on the settings in their <code>project.yml</code> file. See below for a thorough description