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/08 15:23:33 UTC
[01/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Repository: incubator-mynewt-site
Updated Branches:
refs/heads/asf-site 637e3d812 -> 8e70b507d
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/modules/shell/shell_task_init/index.html
----------------------------------------------------------------------
diff --git a/os/modules/shell/shell_task_init/index.html b/os/modules/shell/shell_task_init/index.html
deleted file mode 100644
index c5a51f4..0000000
--- a/os/modules/shell/shell_task_init/index.html
+++ /dev/null
@@ -1,670 +0,0 @@
-<!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/modules/shell/shell_task_init/"> -->
- <link rel="shortcut icon" href="../../../../img/favicon.ico">
-
- <title>shell_task_init - 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="shell_task_init">
-
-
- <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="../../../core_os/mynewt_os/">OS Core</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../core_os/porting/port_os/">Porting to your Platform</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../console/console/">Console</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../shell/">Shell</a>
-
-
- <ul>
-
-
-
-
-
-
-
- <li><a href="
- ./
-">Functions</a>
-
-
- <ul>
-
-
-
- <li class="active">
- <a href="./">shell_task_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../shell_cmd_register/">shell_cmd_register</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../shell_nlip_output/">shell_nlip_output</a>
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../bootloader/bootloader/">Bootloader</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li><a href="
-
-
- ../../fs/fs/fs/
-
-">File System</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../hal/hal/">Hardware Abstraction Layer</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../testutil/testutil/">Test Utilities</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../devmgmt/newtmgr/">Device Management with Newt Manager</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../imgmgr/imgmgr/">Image Manager</a>
-
-
- </li>
-
-
-
-
-
- <li >
- <a href="../../baselibc/">Baselibc library</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../elua/elua/">Embedded Lua</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../json/json/">JSON</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../stats/stats/">Stats</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../logs/logs/">Logs</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../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="/develop/os/introduction">Docs</a></li>
-
-
-
- <li>» <a href="../shell/">Shell</a></li>
-
-
-
- <li>» Functions</li>
-
-
-
- <li>» shell_task_init</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="shell_task_init"><font color="F2853F" style="font-size:24pt"> shell_task_init</font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">int shell_task_init(uint8_t prio, os_stack_t *stack, uint16_t stack_size,
- int max_input_length);
-</pre></div>
-
-
-<p>Initializes the shell package. This creates a task for shell, and registers few commands on its own (<em>echo</em>, <em>?</em>, for example). It also allocates memory for buffering console input.</p>
-<h4 id="arguments">Arguments</h4>
-<table>
-<thead>
-<tr>
-<th>Arguments</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>prio</td>
-<td>Priority of the shell task</td>
-</tr>
-<tr>
-<td>stack</td>
-<td>Pointer to shell tasks's stack</td>
-</tr>
-<tr>
-<td>stack_size</td>
-<td>Size of the aforementioned stack (in units of os_stack_t)</td>
-</tr>
-<tr>
-<td>max_input_length</td>
-<td>the maximum expected length of line for input</td>
-</tr>
-</tbody>
-</table>
-<h4 id="returned-values">Returned values</h4>
-<p>Returns 0 on success; nonzero on failure.</p>
-<h4 id="notes">Notes</h4>
-<p>You can register commands before calling this, but only if OS has not been started.</p>
-<h4 id="example">Example</h4>
-<p>Here's an example of stand-alone code which allows the user to execute regression tests for sys/config package only.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">#define SHELL_TASK_PRIO (3)
-#define SHELL_MAX_INPUT_LEN (256)
-#define SHELL_TASK_STACK_SIZE (OS_STACK_ALIGN(384))
-os_stack_t shell_stack[SHELL_TASK_STACK_SIZE];
-
-int
-main(int argc, char **argv)
-{
- ....
- shell_task_init(SHELL_TASK_PRIO, shell_stack, SHELL_TASK_STACK_SIZE,
- SHELL_MAX_INPUT_LEN);
- ....
-}
-</pre></div>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../shell/>
- <span class="fa fa-arrow-left"></span>
- Previous: Shell
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../shell_cmd_register/>
- Next: shell_cmd_register
- <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/8e70b507/sitemap.xml
----------------------------------------------------------------------
diff --git a/sitemap.xml b/sitemap.xml
index 807cbef..5b80c93 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -4,7 +4,7 @@
<url>
<loc>http://mynewt.apache.org/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -13,13 +13,13 @@
<url>
<loc>http://mynewt.apache.org/pages/ble/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>http://mynewt.apache.org/pages/securitybullets/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -28,7 +28,7 @@
<url>
<loc>http://mynewt.apache.org/quick-start/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -36,7 +36,7 @@
<url>
<loc>http://mynewt.apache.org/about/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -44,7 +44,7 @@
<url>
<loc>http://mynewt.apache.org/talks/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -52,7 +52,7 @@
<url>
<loc>http://mynewt.apache.org/download/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -60,7 +60,7 @@
<url>
<loc>http://mynewt.apache.org/community/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -68,7 +68,7 @@
<url>
<loc>http://mynewt.apache.org/events/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -77,7 +77,7 @@
<url>
<loc>http://mynewt.apache.org/os/introduction/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -89,7 +89,7 @@
<url>
<loc>http://mynewt.apache.org/os/get_started/vocabulary/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -129,13 +129,13 @@
<url>
<loc>http://mynewt.apache.org/faq/how_to_edit_docs/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>http://mynewt.apache.org/faq/answers/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/v0_9_0/sitemap.xml
----------------------------------------------------------------------
diff --git a/v0_9_0/sitemap.xml b/v0_9_0/sitemap.xml
index 807cbef..5b80c93 100644
--- a/v0_9_0/sitemap.xml
+++ b/v0_9_0/sitemap.xml
@@ -4,7 +4,7 @@
<url>
<loc>http://mynewt.apache.org/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -13,13 +13,13 @@
<url>
<loc>http://mynewt.apache.org/pages/ble/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>http://mynewt.apache.org/pages/securitybullets/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -28,7 +28,7 @@
<url>
<loc>http://mynewt.apache.org/quick-start/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -36,7 +36,7 @@
<url>
<loc>http://mynewt.apache.org/about/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -44,7 +44,7 @@
<url>
<loc>http://mynewt.apache.org/talks/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -52,7 +52,7 @@
<url>
<loc>http://mynewt.apache.org/download/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -60,7 +60,7 @@
<url>
<loc>http://mynewt.apache.org/community/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -68,7 +68,7 @@
<url>
<loc>http://mynewt.apache.org/events/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -77,7 +77,7 @@
<url>
<loc>http://mynewt.apache.org/os/introduction/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -89,7 +89,7 @@
<url>
<loc>http://mynewt.apache.org/os/get_started/vocabulary/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -129,13 +129,13 @@
<url>
<loc>http://mynewt.apache.org/faq/how_to_edit_docs/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>http://mynewt.apache.org/faq/answers/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
[04/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Posted by ad...@apache.org.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/os_start/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/os_start/index.html b/latest/os/core_os/os_start/index.html
deleted file mode 100644
index ccf78aa..0000000
--- a/latest/os/core_os/os_start/index.html
+++ /dev/null
@@ -1,783 +0,0 @@
-<!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/os_start/"> -->
- <link rel="shortcut icon" href="../../../img/favicon.ico">
-
- <title>os_start - 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_start">
-
-
- <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_init/
-">System-level Functions</a>
-
-
- <ul>
-
-
-
- <li >
- <a href="../os_init/">os_init</a>
- </li>
-
-
-
-
-
- <li class="active">
- <a href="./">os_start</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_started/">os_started</a>
- </li>
-
-
-
- </ul>
-
- </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_queue/">Event Queues</a>
-
-
- </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>» <a href="../mynewt_os/">OS Core</a></li>
-
-
-
- <li>» <a href="../os_init/">System-level Functions</a></li>
-
-
-
- <li>» os_start</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="os_start"><font color="#F2853F" style="font-size:24pt">os_start</font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">void</span> <span style="color: #000000">os_start</span>(<span style="color: #A90D91">void</span>)
-</pre></div>
-
-
-<p>Starts the OS by initializing and enabling the OS time tick and starting the scheduler.</p>
-<p>This function does not return.</p>
-<p><br></p>
-<h4 id="arguments">Arguments</h4>
-<p>None</p>
-<p><br></p>
-<h4 id="returned-values">Returned values</h4>
-<p>None (does not return).</p>
-<p><br></p>
-<h4 id="notes">Notes</h4>
-<p>Once <code>os_start()</code> has been called, context is switched to the highest priority task that was initialized prior to calling <code>os_start()</code>.</p>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../os_init/>
- <span class="fa fa-arrow-left"></span>
- Previous: os_init
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../os_started/>
- Next: os_started
- <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/8e70b507/latest/os/core_os/os_started/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/os_started/index.html b/latest/os/core_os/os_started/index.html
index 2c5488f..2ed979a 100644
--- a/latest/os/core_os/os_started/index.html
+++ b/latest/os/core_os/os_started/index.html
@@ -255,30 +255,14 @@
<li><a href="
- ../os_init/
-">System-level Functions</a>
+ ./
+">Functions</a>
<ul>
- <li >
- <a href="../os_init/">os_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_start/">os_start</a>
- </li>
-
-
-
-
-
<li class="active">
<a href="./">os_started</a>
</li>
@@ -698,7 +682,7 @@
- <li>» <a href="../os_init/">System-level Functions</a></li>
+ <li>» Functions</li>
@@ -731,9 +715,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../os_start/>
+ <a href=../mynewt_os/>
<span class="fa fa-arrow-left"></span>
- Previous: os_start
+ Previous: OS Core
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/sanity/os_sanity_check_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/sanity/os_sanity_check_init/index.html b/latest/os/core_os/sanity/os_sanity_check_init/index.html
index 9e9ff90..82a0c74 100644
--- a/latest/os/core_os/sanity/os_sanity_check_init/index.html
+++ b/latest/os/core_os/sanity/os_sanity_check_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/sanity/os_sanity_check_register/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/sanity/os_sanity_check_register/index.html b/latest/os/core_os/sanity/os_sanity_check_register/index.html
index fce625c..15bc704 100644
--- a/latest/os/core_os/sanity/os_sanity_check_register/index.html
+++ b/latest/os/core_os/sanity/os_sanity_check_register/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/sanity/os_sanity_check_reset/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/sanity/os_sanity_check_reset/index.html b/latest/os/core_os/sanity/os_sanity_check_reset/index.html
index 9694c56..6d37ea7 100644
--- a/latest/os/core_os/sanity/os_sanity_check_reset/index.html
+++ b/latest/os/core_os/sanity/os_sanity_check_reset/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/sanity/os_sanity_task_checkin/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/sanity/os_sanity_task_checkin/index.html b/latest/os/core_os/sanity/os_sanity_task_checkin/index.html
index 6ad2409..cebba9e 100644
--- a/latest/os/core_os/sanity/os_sanity_task_checkin/index.html
+++ b/latest/os/core_os/sanity/os_sanity_task_checkin/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/sanity/os_sanity_task_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/sanity/os_sanity_task_init/index.html b/latest/os/core_os/sanity/os_sanity_task_init/index.html
index 6da2021..1ff4cec 100644
--- a/latest/os/core_os/sanity/os_sanity_task_init/index.html
+++ b/latest/os/core_os/sanity/os_sanity_task_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/sanity/sanity/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/sanity/sanity/index.html b/latest/os/core_os/sanity/sanity/index.html
index a28c927..929e517 100644
--- a/latest/os/core_os/sanity/sanity/index.html
+++ b/latest/os/core_os/sanity/sanity/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/semaphore/os_sem_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/semaphore/os_sem_init/index.html b/latest/os/core_os/semaphore/os_sem_init/index.html
index b13cbf5..bac433d 100644
--- a/latest/os/core_os/semaphore/os_sem_init/index.html
+++ b/latest/os/core_os/semaphore/os_sem_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/semaphore/os_sem_pend/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/semaphore/os_sem_pend/index.html b/latest/os/core_os/semaphore/os_sem_pend/index.html
index db7ea8b..8587672 100644
--- a/latest/os/core_os/semaphore/os_sem_pend/index.html
+++ b/latest/os/core_os/semaphore/os_sem_pend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/semaphore/os_sem_release/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/semaphore/os_sem_release/index.html b/latest/os/core_os/semaphore/os_sem_release/index.html
index ebe25c9..f5d2c09 100644
--- a/latest/os/core_os/semaphore/os_sem_release/index.html
+++ b/latest/os/core_os/semaphore/os_sem_release/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/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 955cc8a..ebeb8c6 100644
--- a/latest/os/core_os/semaphore/semaphore/index.html
+++ b/latest/os/core_os/semaphore/semaphore/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/task/os_task_count/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/task/os_task_count/index.html b/latest/os/core_os/task/os_task_count/index.html
index dc76b5c..aeaa534 100644
--- a/latest/os/core_os/task/os_task_count/index.html
+++ b/latest/os/core_os/task/os_task_count/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/task/os_task_info_get_next/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/task/os_task_info_get_next/index.html b/latest/os/core_os/task/os_task_info_get_next/index.html
index 509dd19..dcbb7a9 100644
--- a/latest/os/core_os/task/os_task_info_get_next/index.html
+++ b/latest/os/core_os/task/os_task_info_get_next/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/task/os_task_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/task/os_task_init/index.html b/latest/os/core_os/task/os_task_init/index.html
index fee0ee3..6246c4c 100644
--- a/latest/os/core_os/task/os_task_init/index.html
+++ b/latest/os/core_os/task/os_task_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/task/task/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/task/task/index.html b/latest/os/core_os/task/task/index.html
index b9d86d3..103d863 100644
--- a/latest/os/core_os/task/task/index.html
+++ b/latest/os/core_os/task/task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
@@ -772,23 +772,21 @@ task simply toggles an LED at a one second interval.</p>
}
<span style="color: #177500">/* This is the main function for the project */</span>
-<span style="color: #A90D91">int</span> <span style="color: #000000">main</span>(<span style="color: #A90D91">void</span>) {
- <span style="color: #A90D91">int</span> <span style="color: #000000">rc</span>;
+<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: #177500">/* Initialize OS */</span>
- <span style="color: #000000">os_init</span>();
+ <span style="color: #177500">/* Perform system and package initialization */</span>
+ <span style="color: #000000">sysinit</span>();
<span style="color: #177500">/* Initialize the task */</span>
<span style="color: #000000">os_task_init</span>(<span style="color: #000000">&my_task</span>, <span style="color: #C41A16">"my_task"</span>, <span style="color: #000000">my_task_func</span>, <span style="color: #A90D91">NULL</span>, <span style="color: #000000">MY_TASK_PRIO</span>,
<span style="color: #000000">OS_WAIT_FOREVER</span>, <span style="color: #000000">my_task_stack</span>, <span style="color: #000000">MY_STACK_SIZE</span>);
- <span style="color: #177500">/* Start the OS */</span>
- <span style="color: #000000">os_start</span>();
-
- <span style="color: #177500">/* os start should never return. If it does, this should be an error */</span>
- <span style="color: #000000">assert</span>(<span style="color: #1C01CE">0</span>);
-
- <span style="color: #A90D91">return</span> <span style="color: #000000">rc</span>;
+ <span style="color: #177500">/* Process events from the default event queue. */</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>());
+ }
+ <span style="color: #177500">/* main never returns */</span>
}
</pre></div>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/time/os_gettimeofday/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/time/os_gettimeofday/index.html b/latest/os/core_os/time/os_gettimeofday/index.html
index 600db2d..75108f7 100644
--- a/latest/os/core_os/time/os_gettimeofday/index.html
+++ b/latest/os/core_os/time/os_gettimeofday/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/time/os_settimeofday/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/time/os_settimeofday/index.html b/latest/os/core_os/time/os_settimeofday/index.html
index 6a8445f..b9ab9c4 100644
--- a/latest/os/core_os/time/os_settimeofday/index.html
+++ b/latest/os/core_os/time/os_settimeofday/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/time/os_time/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/time/os_time/index.html b/latest/os/core_os/time/os_time/index.html
index 374ce60..0b3684f 100644
--- a/latest/os/core_os/time/os_time/index.html
+++ b/latest/os/core_os/time/os_time/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/time/os_time_delay/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/time/os_time_delay/index.html b/latest/os/core_os/time/os_time_delay/index.html
index 9a11eb8..3d3c99d 100644
--- a/latest/os/core_os/time/os_time_delay/index.html
+++ b/latest/os/core_os/time/os_time_delay/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/time/os_time_get/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/time/os_time_get/index.html b/latest/os/core_os/time/os_time_get/index.html
index cfa25b4..dcf9ca7 100644
--- a/latest/os/core_os/time/os_time_get/index.html
+++ b/latest/os/core_os/time/os_time_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/time/os_time_tick/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/time/os_time_tick/index.html b/latest/os/core_os/time/os_time_tick/index.html
index dbe3277..38056a5 100644
--- a/latest/os/core_os/time/os_time_tick/index.html
+++ b/latest/os/core_os/time/os_time_tick/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/modules/console/console/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/console/console/index.html b/latest/os/modules/console/console/index.html
index a47ef30..da737d7 100644
--- a/latest/os/modules/console/console/index.html
+++ b/latest/os/modules/console/console/index.html
@@ -555,49 +555,66 @@
</div>
<h1 id="console">Console</h1>
-<p>The console is an operating system window where users interact with system programs of the operating system
-or a console application by entering text input (typically from a keyboard) and reading text output
-(typically on the computer terminal or monitor). The text written on the console brings some information
-and is a sequence of characters sent by the OS or programs running on the OS. </p>
+<p>The console is an operating system window where users interact with the OS subsystems or a console
+application. A user typically inputs text from a keyboard and reads the OS output text on a computer
+monitor. The text are sent as a sequence of characters between the user and the OS. </p>
<p>Support is currently available for console access via the serial port on the hardware board.</p>
<h3 id="description">Description</h3>
<p>In the Mynewt OS, the console library comes in two versions:</p>
<ul>
-<li>full - containing the full implementation</li>
-<li>stub - containing stubs for the API</li>
+<li>
+<p>The <code>sys/console/full</code> package implements the complete console functionality and API.</p>
+</li>
+<li>
+<p>The <code>sys/console/stub</code> package implements stubs for the API.</p>
+</li>
</ul>
-<p>Both of these have a <code>pkg.yml</code> file which states that they provide the <code>console</code> API. If a pkg uses
-this API, it should list <code>console</code> as a requirement. For example, the shell pkg is defined by the
-following pkg.yml file:</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> pkg.name: libs/shell
- pkg.vers: 0.1
- pkg.deps:
- - libs/os
- - libs/util
- pkg.reqs:
- - console
- pkg.identities:
- - SHELL
+<p>Both packages export the <code>console</code> API, and any package that uses
+the console API must list <code>console</code> as a requirement. For example, the shell package defines the following <code>pkg.yml</code>
+file:</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">pkg.name: sys/shell
+pkg.deps:
+ - kernel/os
+ - encoding/base64
+ - time/datetime
+ - util/crc
+pkg.req_apis:
+ - console
+</pre></div>
+
+
+<p>The project <code>pkg.yml</code> file specifies the version of the console package to use.
+A project that requires the full console capability must list the <code>sys/console/full</code> package as a dependency
+in its <code>pkg.yml</code> file.</p>
+<p>An example is the <code>slinky</code> application. It requires the full console capability and has the following
+<code>pkg.yml</code> file: </p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">pkg.name: apps/slinky
+pkg.deps:
+ - test/flash_test
+ - mgmt/imgmgr
+ - mgmt/newtmgr
+ - mgmt/newtmgr/transport/nmgr_shell
+ - kernel/os
+ - boot/bootutil
+ - sys/shell
+ - sys/console/full
+ ...
+ - sys/id
</pre></div>
-<p>The project .yml file decides which version of the console pkg should be included.
-If a project requires the full console capability it lists dependency <code>libs/console/full</code> in its pkg.yml
-file. On the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to)
-but may have a dependency on a pkg that has console capability. In that case you would use a console stub. </p>
-<p>Another example would be the bootloader project where we want to keep the size of the image small. It includes
-the <code>libs/os</code> pkg that can print out messages on a console (e.g. if there is a hard fault) and the <code>libs/util</code>
-pkg that uses the full console (but only if SHELL is present to provide a CLI). However, we do not want to use
-any console I/O capability in this particular bootloader project to keep the size small. We simply use the console
-stub instead, and the pkg.yml file for the project boot pkg looks like the following:</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> project.name: boot
- project.identities: bootloader
- project.pkgs:
- - libs/os
- - libs/bootutil
- - libs/nffs
- - libs/console/stub
- - libs/util
+<p>On the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to)
+but may have a dependency on a package that has console capability. In this case, you use
+the console stub API and list the <code>sys/console/stub</code> package as a dependency in its <code>pkg.yml</code> file. </p>
+<p>An example is the bootloader project where we want to keep the size of the image small. It includes
+the <code>kernel/os</code> package that can print out messages on a console (e.g. if there is a hard fault).
+However, we do not want to use any console I/O capability in this particular bootloader project to
+keep the size small. The project uses the console stub API and has the following <code>pkg.yml</code> file: </p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">pkg.name: apps/boot
+pkg.deps:
+ - boot/bootutil
+ - kernel/os
+ - sys/console/stub
</pre></div>
@@ -608,8 +625,8 @@ based on these interrupts.</p>
want to output info related to that crash.</p>
<p>Console, by default, echoes everything it receives back. Terminal programs expect this, and is a way for the user to
know that the console is connected and responsive. Whether echoing happens or not can be controlled programmatically.</p>
-<p>The Console also has a prompt that is configurable. It is off by default but can be turned on programatically. The
-prompt cahracter can also be changed by the user.</p>
+<p>The Console also has a prompt that is configurable. It is off by default but can be turned on programmatically. The
+prompt character can also be changed by the user.</p>
<h3 id="data-structures">Data structures</h3>
<p>N/A</p>
<h3 id="list-of-functions">List of Functions</h3>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/modules/imgmgr/imgmgr/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/imgmgr/imgmgr/index.html b/latest/os/modules/imgmgr/imgmgr/index.html
index 76982a0..97676dc 100644
--- a/latest/os/modules/imgmgr/imgmgr/index.html
+++ b/latest/os/modules/imgmgr/imgmgr/index.html
@@ -381,7 +381,7 @@
<li><a href="
- ../imgmgr_module_init/
+ ../imgr_ver_parse/
">Functions</a>
@@ -576,10 +576,6 @@
</thead>
<tbody>
<tr>
-<td><a href="../imgmgr_module_init/">imgmgr_module_init</a></td>
-<td>Registers image manager commands with newtmgr.</td>
-</tr>
-<tr>
<td><a href="../imgr_ver_parse/">imgr_ver_parse</a></td>
<td>Parses character string containing specified image version number and writes that to given image_version struct.</td>
</tr>
@@ -606,8 +602,8 @@
</li>
<li class="pull-right">
- <a href=../imgmgr_module_init/>
- Next: imgmgr_module_init
+ <a href=../imgr_ver_parse/>
+ Next: imgr_ver_parse
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/modules/imgmgr/imgmgr_module_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/imgmgr/imgmgr_module_init/index.html b/latest/os/modules/imgmgr/imgmgr_module_init/index.html
deleted file mode 100644
index 31a003a..0000000
--- a/latest/os/modules/imgmgr/imgmgr_module_init/index.html
+++ /dev/null
@@ -1,654 +0,0 @@
-<!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/modules/imgmgr/imgmgr_module_init/"> -->
- <link rel="shortcut icon" href="../../../../img/favicon.ico">
-
- <title>imgmgr_module_init - 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="imgmgr_module_init">
-
-
- <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="../../../core_os/mynewt_os/">OS Core</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../core_os/porting/port_os/">Porting to your Platform</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../console/console/">Console</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../shell/shell/">Shell</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../split/split/">Split Images</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../bootloader/bootloader/">Bootloader</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li><a href="
-
-
- ../../fs/fs/fs/
-
-">File System</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../hal/hal/">Hardware Abstraction Layer</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../drivers/driver/">Drivers</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../testutil/testutil/">Test Utilities</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../devmgmt/newtmgr/">Device Management with Newt Manager</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../imgmgr/">Image Manager</a>
-
-
- <ul>
-
-
-
-
-
-
-
- <li><a href="
- ./
-">Functions</a>
-
-
- <ul>
-
-
-
- <li class="active">
- <a href="./">imgmgr_module_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../imgr_ver_parse/">imgr_ver_parse</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../imgr_ver_str/">imgr_ver_str</a>
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
-
-
- <li >
- <a href="../../baselibc/">Baselibc library</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../elua/elua/">Embedded Lua</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../json/json/">JSON</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../fcb/fcb/">Flash Circular Buffer</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../stats/stats/">Stats</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../logs/logs/">Logs</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../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>» <a href="../imgmgr/">Image Manager</a></li>
-
-
-
- <li>» Functions</li>
-
-
-
- <li>» imgmgr_module_init</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="imgmgr_module_init"><font color="#F2853F" style="font-size:24pt"> imgmgr_module_init </font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> void
- imgmgr_module_init(void)
-</pre></div>
-
-
-<p>Registers the image manager commands with the <code>mgmt</code> package. <code>sysinit()</code> automatically calls this function during
-system initialization.</p>
-<h4 id="arguments">Arguments</h4>
-<p>N/A</p>
-<h4 id="returned-values">Returned values</h4>
-<p>N/A</p>
-<h4 id="notes">Notes</h4>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../imgmgr/>
- <span class="fa fa-arrow-left"></span>
- Previous: Image Manager
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../imgr_ver_parse/>
- Next: imgr_ver_parse
- <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/8e70b507/latest/os/modules/imgmgr/imgr_ver_parse/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/imgmgr/imgr_ver_parse/index.html b/latest/os/modules/imgmgr/imgr_ver_parse/index.html
index 0ffde04..6625913 100644
--- a/latest/os/modules/imgmgr/imgr_ver_parse/index.html
+++ b/latest/os/modules/imgmgr/imgr_ver_parse/index.html
@@ -381,7 +381,7 @@
<li><a href="
- ../imgmgr_module_init/
+ ./
">Functions</a>
@@ -389,14 +389,6 @@
- <li >
- <a href="../imgmgr_module_init/">imgmgr_module_init</a>
- </li>
-
-
-
-
-
<li class="active">
<a href="./">imgr_ver_parse</a>
</li>
@@ -572,7 +564,7 @@
- <li>» <a href="../imgmgr_module_init/">Functions</a></li>
+ <li>» Functions</li>
@@ -638,9 +630,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../imgmgr_module_init/>
+ <a href=../imgmgr/>
<span class="fa fa-arrow-left"></span>
- Previous: imgmgr_module_init
+ Previous: Image Manager
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/modules/imgmgr/imgr_ver_str/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/imgmgr/imgr_ver_str/index.html b/latest/os/modules/imgmgr/imgr_ver_str/index.html
index 561d077..00ea43a 100644
--- a/latest/os/modules/imgmgr/imgr_ver_str/index.html
+++ b/latest/os/modules/imgmgr/imgr_ver_str/index.html
@@ -381,7 +381,7 @@
<li><a href="
- ../imgmgr_module_init/
+ ../imgr_ver_parse/
">Functions</a>
@@ -390,14 +390,6 @@
<li >
- <a href="../imgmgr_module_init/">imgmgr_module_init</a>
- </li>
-
-
-
-
-
- <li >
<a href="../imgr_ver_parse/">imgr_ver_parse</a>
</li>
@@ -572,7 +564,7 @@
- <li>» <a href="../imgmgr_module_init/">Functions</a></li>
+ <li>» <a href="../imgr_ver_parse/">Functions</a></li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/modules/shell/shell/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/shell/shell/index.html b/latest/os/modules/shell/shell/index.html
index fb9b53a..1163e43 100644
--- a/latest/os/modules/shell/shell/index.html
+++ b/latest/os/modules/shell/shell/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ../shell_cmd_register/
">Functions</a>
@@ -555,16 +555,23 @@
</div>
<h1 id="shell">Shell</h1>
-<p>The shell is package sitting on top of console, handling 2 jobs: processing console input and implementing
-<a href="../../../../newtmgr/overview/">newtmgr</a> line protocol over serial line. Shell runs in its own task.</p>
+<p>The shell runs above the console and provides two functionalities:</p>
+<ul>
+<li>Processes console input. </li>
+<li>Implements the <a href="../../../../newtmgr/overview/">newtmgr</a> line protocol over serial transport. </li>
+</ul>
+<p>The <code>sys/shell</code> package implements the shell. The shell uses the OS default event queue
+for shell events and runs in the context of the main task. An application can, optionally,
+specify a dedicated event queue for the shell to use.</p>
<h3 id="description">Description</h3>
<ul>
<li>
-<p>Shell's first job is directing incoming commands to other subsystems. It parses the incoming character string
-and splits it into tokens. Then it looks for the subsystem to handle this command based on the first token of input.</p>
+<p>The shell's first job is to direct incoming commands to other subsystems. It parses the incoming character string
+into tokens and uses the first token to determine the subsystem command handler to call to process the command.</p>
<ul>
<li>
-<p>Subsystems register their command handlers using <code>shell_cmd_register()</code>. When shell calls the command handler, it passes the other tokens as arguments.</p>
+<p>Subsystems register their command handlers using the <code>shell_cmd_register()</code>
+ function. When shell calls the command handler, it passes the other tokens as arguments.</p>
</li>
<li>
<p>A few commands are currently available in the shell - <code>tasks</code>, <code>log</code>, <code>echo</code>, <code>date</code> and <code>prompt</code>.</p>
@@ -572,9 +579,10 @@ and splits it into tokens. Then it looks for the subsystem to handle this comman
</ul>
</li>
<li>
-<p>Shell's second job is doing framing, encoding and decoding newtmgr protocol when it's carried over the console.
-Protocol handler (libs/newtmgr) registers itself using <code>shell_nlip_input_register()</code>, and shell calls the registered
-handler for every frame. Outgoing frames for the protocol are sent using <code>shell_nlip_output()</code>.</p>
+<p>The shell's second job is to handle packet framing, encoding, and decoding of newtmgr protocol messages that are
+sent over the console. The Newtmgr serial transport package (<code>mgmt/newtmgr/transport/newtmgr_shell</code>)
+calls the <code>shell_nlip_input_register()</code> function to register a handler that the shell calls when it
+receives newtmgr request messages.</p>
</li>
</ul>
<p><br></p>
@@ -694,10 +702,6 @@ Prompt set to: >
</thead>
<tbody>
<tr>
-<td><a href="../shell_task_init/">shell_task_init</a></td>
-<td>Initializes the shell package. This creates a task for shell, and registers few commands on its own.</td>
-</tr>
-<tr>
<td><a href="../shell_cmd_register/">shell_cmd_register</a></td>
<td>Registers a handler for incoming console commands.</td>
</tr>
@@ -709,6 +713,10 @@ Prompt set to: >
<td><a href="../shell_nlip_output/">shell_nlip_output</a></td>
<td>Queue outgoing newtmgr message for transmission.</td>
</tr>
+<tr>
+<td><a href="../shell_evq_set/">shell_evq_set</a></td>
+<td>Specifies a dedicated event queue for shell events.</td>
+</tr>
</tbody>
</table>
@@ -728,8 +736,8 @@ Prompt set to: >
</li>
<li class="pull-right">
- <a href=../shell_task_init/>
- Next: shell_task_init
+ <a href=../shell_cmd_register/>
+ Next: shell_cmd_register
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/modules/shell/shell_cmd_register/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/shell/shell_cmd_register/index.html b/latest/os/modules/shell/shell_cmd_register/index.html
index 27ec760..d35fdf9 100644
--- a/latest/os/modules/shell/shell_cmd_register/index.html
+++ b/latest/os/modules/shell/shell_cmd_register/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ./
">Functions</a>
@@ -296,16 +296,16 @@
- <li >
- <a href="../shell_task_init/">shell_task_init</a>
+ <li class="active">
+ <a href="./">shell_cmd_register</a>
</li>
- <li class="active">
- <a href="./">shell_cmd_register</a>
+ <li >
+ <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
</li>
@@ -313,7 +313,7 @@
<li >
- <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
+ <a href="../shell_nlip_output/">shell_nlip_output</a>
</li>
@@ -321,7 +321,7 @@
<li >
- <a href="../shell_nlip_output/">shell_nlip_output</a>
+ <a href="../shell_evq_set/">shell_evq_set</a>
</li>
@@ -580,7 +580,7 @@
- <li>» <a href="../shell_task_init/">Functions</a></li>
+ <li>» Functions</li>
@@ -644,9 +644,9 @@ Non-zero on failure.</p>
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../shell_task_init/>
+ <a href=../shell/>
<span class="fa fa-arrow-left"></span>
- Previous: shell_task_init
+ Previous: Shell
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/modules/shell/shell_evq_set/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/shell/shell_evq_set/index.html b/latest/os/modules/shell/shell_evq_set/index.html
new file mode 100644
index 0000000..5a4adfb
--- /dev/null
+++ b/latest/os/modules/shell/shell_evq_set/index.html
@@ -0,0 +1,676 @@
+<!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/modules/shell/shell_evq_set/"> -->
+ <link rel="shortcut icon" href="../../../../img/favicon.ico">
+
+ <title>shell_evq_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="shell_evq_set">
+
+
+ <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="../../../core_os/mynewt_os/">OS Core</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../core_os/porting/port_os/">Porting to your Platform</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../console/console/">Console</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../shell/">Shell</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="
+ ../shell_cmd_register/
+">Functions</a>
+
+
+ <ul>
+
+
+
+ <li >
+ <a href="../shell_cmd_register/">shell_cmd_register</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../shell_nlip_output/">shell_nlip_output</a>
+ </li>
+
+
+
+
+
+ <li class="active">
+ <a href="./">shell_evq_set</a>
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../split/split/">Split Images</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../bootloader/bootloader/">Bootloader</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+
+
+ ../../fs/fs/fs/
+
+">File System</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../hal/hal/">Hardware Abstraction Layer</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../drivers/driver/">Drivers</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../testutil/testutil/">Test Utilities</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../devmgmt/newtmgr/">Device Management with Newt Manager</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../imgmgr/imgmgr/">Image Manager</a>
+
+
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../../baselibc/">Baselibc library</a>
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../elua/elua/">Embedded Lua</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../json/json/">JSON</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../fcb/fcb/">Flash Circular Buffer</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../stats/stats/">Stats</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../logs/logs/">Logs</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../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>» <a href="../shell/">Shell</a></li>
+
+
+
+ <li>» <a href="../shell_cmd_register/">Functions</a></li>
+
+
+
+ <li>» shell_evq_set</li>
+
+
+
+ </ul>
+</div>
+ </div>
+
+ <h2 id="shell_evq_set"><font color="F2853F" style="font-size:24pt"> shell_evq_set</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">void</span> <span style="color: #000000">shell_evq_set</span>(<span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> <span style="color: #000000">*evq</span>)
+</pre></div>
+
+
+<p>Specifies an event queue to use for shell events. You must create the event queue
+and the task to process events from the queue before calling this function. </p>
+<p>By default, shell uses the OS default event queue and executes in the context
+of the main task that Mynewt creates.</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 the event queue to use for shell events.</td>
+</tr>
+</tbody>
+</table>
+<h4 id="returned-values">Returned values</h4>
+<p>None</p>
+<h4 id="notes">Notes</h4>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../shell_nlip_output/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: shell_nlip_output
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../../split/split/>
+ Next: Split Images
+ <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/8e70b507/latest/os/modules/shell/shell_nlip_input_register/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/shell/shell_nlip_input_register/index.html b/latest/os/modules/shell/shell_nlip_input_register/index.html
index 48351de..df5c507 100644
--- a/latest/os/modules/shell/shell_nlip_input_register/index.html
+++ b/latest/os/modules/shell/shell_nlip_input_register/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ../shell_cmd_register/
">Functions</a>
@@ -297,23 +297,23 @@
<li >
- <a href="../shell_task_init/">shell_task_init</a>
+ <a href="../shell_cmd_register/">shell_cmd_register</a>
</li>
- <li >
- <a href="../shell_cmd_register/">shell_cmd_register</a>
+ <li class="active">
+ <a href="./">shell_nlip_input_register</a>
</li>
- <li class="active">
- <a href="./">shell_nlip_input_register</a>
+ <li >
+ <a href="../shell_nlip_output/">shell_nlip_output</a>
</li>
@@ -321,7 +321,7 @@
<li >
- <a href="../shell_nlip_output/">shell_nlip_output</a>
+ <a href="../shell_evq_set/">shell_evq_set</a>
</li>
@@ -580,7 +580,7 @@
- <li>» <a href="../shell_task_init/">Functions</a></li>
+ <li>» <a href="../shell_cmd_register/">Functions</a></li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/modules/shell/shell_nlip_output/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/shell/shell_nlip_output/index.html b/latest/os/modules/shell/shell_nlip_output/index.html
index 86e42ef..993ee48 100644
--- a/latest/os/modules/shell/shell_nlip_output/index.html
+++ b/latest/os/modules/shell/shell_nlip_output/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ../shell_cmd_register/
">Functions</a>
@@ -297,7 +297,7 @@
<li >
- <a href="../shell_task_init/">shell_task_init</a>
+ <a href="../shell_cmd_register/">shell_cmd_register</a>
</li>
@@ -305,23 +305,23 @@
<li >
- <a href="../shell_cmd_register/">shell_cmd_register</a>
+ <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
</li>
- <li >
- <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
+ <li class="active">
+ <a href="./">shell_nlip_output</a>
</li>
- <li class="active">
- <a href="./">shell_nlip_output</a>
+ <li >
+ <a href="../shell_evq_set/">shell_evq_set</a>
</li>
@@ -580,7 +580,7 @@
- <li>» <a href="../shell_task_init/">Functions</a></li>
+ <li>» <a href="../shell_cmd_register/">Functions</a></li>
@@ -648,8 +648,8 @@
</li>
<li class="pull-right">
- <a href=../../split/split/>
- Next: Split Images
+ <a href=../shell_evq_set/>
+ Next: shell_evq_set
<span class="fa fa-arrow-right"></span>
</a>
[06/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Posted by ad...@apache.org.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/mkdocs/search_index.json
----------------------------------------------------------------------
diff --git a/latest/mkdocs/search_index.json b/latest/mkdocs/search_index.json
index 240c0f7..779e2f4 100644
--- a/latest/mkdocs/search_index.json
+++ b/latest/mkdocs/search_index.json
@@ -1942,7 +1942,7 @@
},
{
"location": "/os/core_os/mynewt_os/",
- "text": "Mynewt Core OS\n\n\nThe Mynewt Core OS is a multitasking, preemptive real-time operating system combining a scheduler with typical RTOS features such as mutexes, semaphores, memory pools, etc. The Mynewt Core OS also provides a number of useful utilities such as a task watchdog, networking stack, memory buffers and time management API. Each of these features is described in detail in its own section of the manual.\n\n\nA multitasking, preemptive operating system is one in which a number of different tasks can be instantiated and assigned a priority, with higher priority tasks running before lower priority tasks. Furthermore, if a lower priority task is running and a higher priority task wants to run, the lower priority task is halted and the higher priority task is allowed to run. In other words, the lower priority task is preempted by the higher priority task.\n\n\nWhy use an OS?\n\n\nYou may ask yourself \"why do I need a multitasking preemptive OS\"? The answ
er may indeed be that you do not. Some applications are simple and only require a polling loop. Others are more complex and may require that certain jobs are executed in a timely manner or before other jobs are executed. If you have a simple polling loop, you cannot move on to service a job until the current job is done being serviced. With the Mynewt OS, the application developer need not worry about certain jobs taking too long or not executing in a timely fashion; the OS provides mechanisms to deal with these situations. Another benefit of using an OS is that it helps shield application developers from other application code being written; the developer does not have to worry (or has to worry less) about other application code behaving badly and causing undesirable behavior or preventing their code from executing properly. Other benefits of using an OS (and the Mynewt OS in particular) is that it also provides features that the developer would otherwise need to create on his/her
own. \n\n\nCore OS Features\n\n\n\n\n\n\nScheduler/context switching\n\n\nTime\n\n\nTasks\n\n\nEvent queues/callouts\n\n\nSemaphores\n\n\nMutexes\n\n\nMemory pools\n\n\nHeap\n\n\nMbufs\n\n\nSanity\n\n\nCallouts\n\n\nPorting OS to other platforms\n\n\n\n\nBasic OS Application Creation\n\n\nCreating an application using the Mynewt Core OS is a relatively simple task: once you have installed the basic Newt Tool structure (build structure) for your application and created your BSP (Board Support Package), the developer initializes the OS by calling \nos_init()\n, performs application specific initializations, and then starts the os by calling \nos_start()\n. \n\n\nThe \nos_init()\n API performs two basic functions: calls architecture and bsp specific setup and initializes the idle task of the OS. This is required before the OS is started. The OS start API initializes the OS time tick interrupt and starts the highest priority task running (i.e starts the scheduler). Note that \nos_start(
)\n never returns; once called the device is either running in an application task context or in idle task context.\n\n\nInitializing application modules and tasks can get somewhat complicated with RTOS's similar to Mynewt. Care must be taken that the API provided by a task are initialized prior to being called by another (higher priority) task. \n\n\nFor example, take a simple application with two tasks (tasks 1 and 2, with task 1 higher priority than task 2). Task 2 provides an API which has a semaphore lock and this semaphore is initialized by task 2 when the task handler for task 2 is called. Task 1 is expected to call this API.\n\n\nConsider the sequence of events when the OS is started. The scheduler starts running and picks the highest priority task (task 1 in this case). The task handler function for task 1 is called and will keep running until it yields execution. Before yielding, code in the task 1 handler function calls the API provided by task 2. The semaphore being acce
ssed in the task 2 API has yet to be initialized since the task 2 handler function has not had a chance to run! This will lead to undesirable behavior and will need to be addressed by the application developer. Note that the Mynewt OS does guard against internal API being called before the OS has started (they will return error) but it does not safeguard application defined objects from access prior to initialization.\n\n\nExample\n\n\nOne way to avoid initialization issues like the one described above is to perform task initializations prior to starting the OS. The code example shown below illustrates this concept. The application initializes the OS, calls an application specific \"task initialization\" function, and then starts the OS. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling \nos_task_init()\n). \n\n\nIn the example
, each task works in a ping-pong like fashion: task 1 wakes up, adds a token to semaphore 1 and then waits for a token from semaphore 2. Task 2 waits for a token on semaphore 1 and once it gets it, adds a token to semaphore 2. Notice that the semaphores are initialized by the application specific task initialization functions and not inside the task handler functions. If task 2 (being lower in priority than task 1) had called \nos_sem_init()\n for task2_sem inside \ntask2_handler()\n, task 1 would have called \nos_sem_pend()\n using task2_sem before task2_sem was initialized.\n\n\n \n/* Task 1 handler function */\n\n \nvoid\n\n \ntask1_handler\n(\nvoid\n \n*arg\n)\n {\n \nwhile\n (\n1\n) {\n \n/* Release semaphore to task 2 */\n\n \nos_sem_release\n(\ntask1_sem\n);\n\n \n/* Wait for semaphore from task 2 */\n\n \nos_sem_pend\n(\ntask2_sem\n, \nOS_TIMEOUT_NEVER\n);\n }\n }\n\n \n/* Task 2 handler function */\
n\n \nvoid\n\n \ntask2_handler\n(\nvoid\n \n*arg\n)\n {\n \nstruct\n \nos_task\n \n*t\n;\n\n \nwhile\n (\n1\n) {\n \n/* Wait for semaphore from task1 */\n\n \nos_sem_pend\n(\ntask1_sem\n, \nOS_TIMEOUT_NEVER\n);\n\n \n/* Release task2 semaphore */\n\n \nos_sem_release\n(\ntask2_sem\n);\n }\n }\n\n\n \n/* Initialize task 1 exposed data objects */\n\n \nvoid\n\n \ntask1_init\n(\nvoid\n)\n {\n \n/* Initialize task1 semaphore */\n\n \nos_sem_init\n(\ntask1_sem\n, \n0\n);\n }\n\n \n/* Initialize task 2 exposed data objects */\n\n \nvoid\n\n \ntask2_init\n(\nvoid\n)\n {\n \n/* Initialize task1 semaphore */\n\n \nos_sem_init\n(\ntask2_sem\n, \n0\n);\n }\n\n \n/**\n\n\n * init_app_tasks\n\n\n * \n\n\n * Called by main.c after os_init(). This function performs initializations \n\n\n * that are required before tasks are running. \n\n\n *
\n\n\n * @return int 0 success; error otherwise.\n\n\n */\n\n \nstatic\n \nint\n\n \ninit_app_tasks\n(\nvoid\n)\n {\n \n/*\n\n\n * Initialize tasks 1 and 2. Note that the task handlers are not called yet; they will\n\n\n * be called when the OS is started.\n\n\n */\n\n \nos_task_init\n(\ntask1\n, \ntask1\n, \ntask1_handler\n, \nNULL\n, \nTASK1_PRIO\n, \n \nOS_WAIT_FOREVER\n, \ntask1_stack\n, \nTASK1_STACK_SIZE\n);\n\n \nos_task_init\n(\ntask2\n, \ntask2\n, \ntask2_handler\n, \nNULL\n, \nTASK2_PRIO\n, \n \nOS_WAIT_FOREVER\n, \ntask2_stack\n, \nTASK2_STACK_SIZE\n);\n\n \n/* Call task specific initialization functions. */\n\n \ntask1_init\n();\n \ntask2_init\n();\n\n \nreturn\n \n0\n;\n }\n\n \n/**\n\n\n * main\n\n\n * \n\n\n * The main function for the application. This function initializes the os, calls \n\n\n * the application spe
cific task initialization function. then starts the \n\n\n * OS. We should not return from os start! \n\n\n */\n\n \nint\n\n \nmain\n(\nvoid\n)\n {\n \nint\n \ni\n;\n \nint\n \nrc\n;\n \nuint32_t\n \nseed\n;\n\n \n/* Initialize OS */\n\n \nos_init\n();\n\n \n/* Initialize application specific tasks */\n\n \ninit_app_tasks\n();\n\n \n/* Start the OS */\n\n \nos_start\n();\n\n \n/* os start should never return. If it does, this should be an error */\n\n \nassert\n(\n0\n);\n\n \nreturn\n \nrc\n;\n }\n\n\n\n\n\nOS Functions\n\n\nThe functions available at the OS level are:\n\n\n\n\nos_init\n\n\nos_start\n\n\nos_started",
+ "text": "Mynewt Core OS\n\n\nThe Mynewt Core OS is a multitasking, preemptive real-time operating system combining a scheduler with typical RTOS features such as mutexes, semaphores, memory pools, etc. The Mynewt Core OS also provides a number of useful utilities such as a task watchdog, networking stack, memory buffers and time management API. Each of these features is described in detail in its own section of the manual.\n\n\nA multitasking, preemptive operating system is one in which a number of different tasks can be instantiated and assigned a priority, with higher priority tasks running before lower priority tasks. Furthermore, if a lower priority task is running and a higher priority task wants to run, the lower priority task is halted and the higher priority task is allowed to run. In other words, the lower priority task is preempted by the higher priority task.\n\n\nWhy use an OS?\n\n\nYou may ask yourself \"why do I need a multitasking preemptive OS\"? The answ
er may indeed be that you do not. Some applications are simple and only require a polling loop. Others are more complex and may require that certain jobs are executed in a timely manner or before other jobs are executed. If you have a simple polling loop, you cannot move on to service a job until the current job is done being serviced. With the Mynewt OS, the application developer need not worry about certain jobs taking too long or not executing in a timely fashion; the OS provides mechanisms to deal with these situations. Another benefit of using an OS is that it helps shield application developers from other application code being written; the developer does not have to worry (or has to worry less) about other application code behaving badly and causing undesirable behavior or preventing their code from executing properly. Other benefits of using an OS (and the Mynewt OS in particular) is that it also provides features that the developer would otherwise need to create on his/her
own. \n\n\nCore OS Features\n\n\n\n\n\n\nScheduler/context switching\n\n\nTime\n\n\nTasks\n\n\nEvent queues/callouts\n\n\nSemaphores\n\n\nMutexes\n\n\nMemory pools\n\n\nHeap\n\n\nMbufs\n\n\nSanity\n\n\nCallouts\n\n\nPorting OS to other platforms\n\n\n\n\nBasic OS Application Creation\n\n\nCreating an application using the Mynewt Core OS is a relatively simple task. The main steps are:\n\n\n\n\nInstall the basic Newt Tool structure (build structure) for your application.\n\n\nCreate your BSP (Board Support Package).\n\n\nIn your application \nmain()\n function, call the \nsysinit()\n function to initialize \nthe system and packages, perform application specific initialization, then\nwait and dispatch events from the OS default event \nqueue in an infinite loop. (See \nSystem Configuration and Initialization\n for more details.) \n\n\n\n\nInitializing application modules and tasks can get somewhat complicated with RTOS's similar to Mynewt. Care must be taken that the API provided by a
task are initialized prior to being called by another (higher priority) task. \n\n\nFor example, take a simple application with two tasks (tasks 1 and 2, with task 1 higher priority than task 2). Task 2 provides an API which has a semaphore lock and this semaphore is initialized by task 2 when the task handler for task 2 is called. Task 1 is expected to call this API.\n\n\nConsider the sequence of events when the OS is started. The scheduler starts running and picks the highest priority task (task 1 in this case). The task handler function for task 1 is called and will keep running until it yields execution. Before yielding, code in the task 1 handler function calls the API provided by task 2. The semaphore being accessed in the task 2 API has yet to be initialized since the task 2 handler function has not had a chance to run! This will lead to undesirable behavior and will need to be addressed by the application developer. Note that the Mynewt OS does guard against internal API be
ing called before the OS has started (they will return error) but it does not safeguard application defined objects from access prior to initialization.\n\n\nExample\n\n\nOne way to avoid initialization issues like the one described above is for the application to \ninitialize the objects that are accessed by multiple tasks before it initializes the tasks with the OS.\n\n\nThe code example shown below illustrates this concept. The application initializes system and packages, calls an application specific \"task initialization\" function, and dispatches events from the default event queue. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling \nos_task_init()\n). \n\n\nIn the example, each task works in a ping-pong like fashion: task 1 wakes up, adds a token to semaphore 1 and then waits for a token from semaphore 2. Task 2 waits
for a token on semaphore 1 and once it gets it, adds a token to semaphore 2. Notice that the semaphores are initialized by the application specific task initialization functions and not inside the task handler functions. If task 2 (being lower in priority than task 1) had called \nos_sem_init()\n for task2_sem inside \ntask2_handler()\n, task 1 would have called \nos_sem_pend()\n using task2_sem before task2_sem was initialized.\n\n\n \nstruct\n \nos_sem\n \ntask1_sem\n;\n \nstruct\n \nos_sem\n \ntask2_sem\n;\n\n \n/* Task 1 handler function */\n\n \nvoid\n\n \ntask1_handler\n(\nvoid\n \n*arg\n)\n {\n \nwhile\n (\n1\n) {\n \n/* Release semaphore to task 2 */\n\n \nos_sem_release\n(\ntask1_sem\n);\n\n \n/* Wait for semaphore from task 2 */\n\n \nos_sem_pend\n(\ntask2_sem\n, \nOS_TIMEOUT_NEVER\n);\n }\n }\n\n \n/* Task 2 handler function */\n\n \nvoid\n\n \ntask2_handler\n(\nvoid\n \n*arg\n)\n {
\n \nstruct\n \nos_task\n \n*t\n;\n\n \nwhile\n (\n1\n) {\n \n/* Wait for semaphore from task1 */\n\n \nos_sem_pend\n(\ntask1_sem\n, \nOS_TIMEOUT_NEVER\n);\n\n \n/* Release task2 semaphore */\n\n \nos_sem_release\n(\ntask2_sem\n);\n }\n }\n\n\n \n/* Initialize task 1 exposed data objects */\n\n \nvoid\n\n \ntask1_init\n(\nvoid\n)\n {\n \n/* Initialize task1 semaphore */\n\n \nos_sem_init\n(\ntask1_sem\n, \n0\n);\n }\n\n \n/* Initialize task 2 exposed data objects */\n\n \nvoid\n\n \ntask2_init\n(\nvoid\n)\n {\n \n/* Initialize task1 semaphore */\n\n \nos_sem_init\n(\ntask2_sem\n, \n0\n);\n }\n\n \n/**\n\n\n * init_app_tasks\n\n\n * \n\n\n * This function performs initializations that are required before tasks run. \n\n\n * \n\n\n * @return int 0 success; error otherwise.\n\n\n */\n\n \nstatic\n \nint\n\n \ninit_app_tasks\n(\
nvoid\n)\n {\n \n/* \n\n\n * Call task specific initialization functions to initialize any shared objects \n\n\n * before initializing the tasks with the OS.\n\n\n */\n\n \ntask1_init\n();\n \ntask2_init\n();\n\n \n/*\n\n\n * Initialize tasks 1 and 2 with the OS. \n\n\n */\n\n \nos_task_init\n(\ntask1\n, \ntask1\n, \ntask1_handler\n, \nNULL\n, \nTASK1_PRIO\n, \n \nOS_WAIT_FOREVER\n, \ntask1_stack\n, \nTASK1_STACK_SIZE\n);\n\n \nos_task_init\n(\ntask2\n, \ntask2\n, \ntask2_handler\n, \nNULL\n, \nTASK2_PRIO\n, \n \nOS_WAIT_FOREVER\n, \ntask2_stack\n, \nTASK2_STACK_SIZE\n);\n\n \nreturn\n \n0\n;\n }\n\n \n/**\n\n\n * main\n\n\n * \n\n\n * The main function for the application. This function initializes the system and packages, \n\n\n * calls the application specific task initialization function, then waits and dispatches \n\n\n *
events from the OS default event queue in an infinite loop. \n\n\n */\n\n \nint\n\n \nmain\n(\nint\n \nargc\n, \nchar\n \n**arg\n)\n {\n\n \n/* Perform system and package initialization */\n\n \nsysinit\n();\n\n \n/* Initialize application specific tasks */\n\n \ninit_app_tasks\n();\n\n \nwhile\n (\n1\n) {\n \nos_eventq_run\n(\nos_eventq_dflt_get\n());\n }\n \n/* main never returns */\n \n}\n\n\n\n\n\nOS Functions\n\n\nThe functions available at the OS level are:\n\n\n\n\nos_started",
"title": "toc"
},
{
@@ -1962,70 +1962,20 @@
},
{
"location": "/os/core_os/mynewt_os/#basic-os-application-creation",
- "text": "Creating an application using the Mynewt Core OS is a relatively simple task: once you have installed the basic Newt Tool structure (build structure) for your application and created your BSP (Board Support Package), the developer initializes the OS by calling os_init() , performs application specific initializations, and then starts the os by calling os_start() . The os_init() API performs two basic functions: calls architecture and bsp specific setup and initializes the idle task of the OS. This is required before the OS is started. The OS start API initializes the OS time tick interrupt and starts the highest priority task running (i.e starts the scheduler). Note that os_start() never returns; once called the device is either running in an application task context or in idle task context. Initializing application modules and tasks can get somewhat complicated with RTOS's similar to Mynewt. Care must be taken that the API provided by a task are initia
lized prior to being called by another (higher priority) task. For example, take a simple application with two tasks (tasks 1 and 2, with task 1 higher priority than task 2). Task 2 provides an API which has a semaphore lock and this semaphore is initialized by task 2 when the task handler for task 2 is called. Task 1 is expected to call this API. Consider the sequence of events when the OS is started. The scheduler starts running and picks the highest priority task (task 1 in this case). The task handler function for task 1 is called and will keep running until it yields execution. Before yielding, code in the task 1 handler function calls the API provided by task 2. The semaphore being accessed in the task 2 API has yet to be initialized since the task 2 handler function has not had a chance to run! This will lead to undesirable behavior and will need to be addressed by the application developer. Note that the Mynewt OS does guard against internal API being called before the OS
has started (they will return error) but it does not safeguard application defined objects from access prior to initialization.",
+ "text": "Creating an application using the Mynewt Core OS is a relatively simple task. The main steps are: Install the basic Newt Tool structure (build structure) for your application. Create your BSP (Board Support Package). In your application main() function, call the sysinit() function to initialize \nthe system and packages, perform application specific initialization, then\nwait and dispatch events from the OS default event \nqueue in an infinite loop. (See System Configuration and Initialization for more details.) Initializing application modules and tasks can get somewhat complicated with RTOS's similar to Mynewt. Care must be taken that the API provided by a task are initialized prior to being called by another (higher priority) task. For example, take a simple application with two tasks (tasks 1 and 2, with task 1 higher priority than task 2). Task 2 provides an API which has a semaphore lock and this semaphore is initialized by task 2 when the t
ask handler for task 2 is called. Task 1 is expected to call this API. Consider the sequence of events when the OS is started. The scheduler starts running and picks the highest priority task (task 1 in this case). The task handler function for task 1 is called and will keep running until it yields execution. Before yielding, code in the task 1 handler function calls the API provided by task 2. The semaphore being accessed in the task 2 API has yet to be initialized since the task 2 handler function has not had a chance to run! This will lead to undesirable behavior and will need to be addressed by the application developer. Note that the Mynewt OS does guard against internal API being called before the OS has started (they will return error) but it does not safeguard application defined objects from access prior to initialization.",
"title": "Basic OS Application Creation"
},
{
"location": "/os/core_os/mynewt_os/#example",
- "text": "One way to avoid initialization issues like the one described above is to perform task initializations prior to starting the OS. The code example shown below illustrates this concept. The application initializes the OS, calls an application specific \"task initialization\" function, and then starts the OS. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling os_task_init() ). In the example, each task works in a ping-pong like fashion: task 1 wakes up, adds a token to semaphore 1 and then waits for a token from semaphore 2. Task 2 waits for a token on semaphore 1 and once it gets it, adds a token to semaphore 2. Notice that the semaphores are initialized by the application specific task initialization functions and not inside the task handler functions. If task 2 (being lower in priority than task 1) had ca
lled os_sem_init() for task2_sem inside task2_handler() , task 1 would have called os_sem_pend() using task2_sem before task2_sem was initialized. /* Task 1 handler function */ \n void \n task1_handler ( void *arg )\n {\n while ( 1 ) {\n /* Release semaphore to task 2 */ \n os_sem_release ( task1_sem );\n\n /* Wait for semaphore from task 2 */ \n os_sem_pend ( task2_sem , OS_TIMEOUT_NEVER );\n }\n }\n\n /* Task 2 handler function */ \n void \n task2_handler ( void *arg )\n {\n struct os_task *t ;\n\n while ( 1 ) {\n /* Wait for semaphore from task1 */ \n os_sem_pend ( task1_sem , OS_TIMEOUT_NEVER );\n\n /* Release task2 semaphore */ \n os_sem_release ( task2_sem );\n }\n }\n\n\n /* Initialize task 1 exposed data objects */ \n void \n task1_init ( void )\n {\n /* Initialize t
ask1 semaphore */ \n os_sem_init ( task1_sem , 0 );\n }\n\n /* Initialize task 2 exposed data objects */ \n void \n task2_init ( void )\n {\n /* Initialize task1 semaphore */ \n os_sem_init ( task2_sem , 0 );\n }\n\n /** * init_app_tasks * * Called by main.c after os_init(). This function performs initializations * that are required before tasks are running. * * @return int 0 success; error otherwise. */ \n static int \n init_app_tasks ( void )\n {\n /* * Initialize tasks 1 and 2. Note that the task handlers are not called yet; they will * be called when the OS is started. */ \n os_task_init ( task1 , task1 , task1_handler , NULL , TASK1_PRIO , \n OS_WAIT_FOREVER , task1_stack , TASK1_STACK_SIZE );\n\n os_task_init ( task2 , task2 , task2_handler , NULL , TASK2_PRIO , \n
OS_WAIT_FOREVER , task2_stack , TASK2_STACK_SIZE );\n\n /* Call task specific initialization functions. */ \n task1_init ();\n task2_init ();\n\n return 0 ;\n }\n\n /** * main * * The main function for the application. This function initializes the os, calls * the application specific task initialization function. then starts the * OS. We should not return from os start! */ \n int \n main ( void )\n {\n int i ;\n int rc ;\n uint32_t seed ;\n\n /* Initialize OS */ \n os_init ();\n\n /* Initialize application specific tasks */ \n init_app_tasks ();\n\n /* Start the OS */ \n os_start ();\n\n /* os start should never return. If it does, this should be an error */ \n assert ( 0 );\n\n return rc ;\n }",
+ "text": "One way to avoid initialization issues like the one described above is for the application to \ninitialize the objects that are accessed by multiple tasks before it initializes the tasks with the OS. The code example shown below illustrates this concept. The application initializes system and packages, calls an application specific \"task initialization\" function, and dispatches events from the default event queue. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling os_task_init() ). In the example, each task works in a ping-pong like fashion: task 1 wakes up, adds a token to semaphore 1 and then waits for a token from semaphore 2. Task 2 waits for a token on semaphore 1 and once it gets it, adds a token to semaphore 2. Notice that the semaphores are initialized by the application specific task initial
ization functions and not inside the task handler functions. If task 2 (being lower in priority than task 1) had called os_sem_init() for task2_sem inside task2_handler() , task 1 would have called os_sem_pend() using task2_sem before task2_sem was initialized. struct os_sem task1_sem ;\n struct os_sem task2_sem ;\n\n /* Task 1 handler function */ \n void \n task1_handler ( void *arg )\n {\n while ( 1 ) {\n /* Release semaphore to task 2 */ \n os_sem_release ( task1_sem );\n\n /* Wait for semaphore from task 2 */ \n os_sem_pend ( task2_sem , OS_TIMEOUT_NEVER );\n }\n }\n\n /* Task 2 handler function */ \n void \n task2_handler ( void *arg )\n {\n struct os_task *t ;\n\n while ( 1 ) {\n /* Wait for semaphore from task1 */ \n os_sem_pend ( task1_sem , OS_TIMEOUT_NEVER );\n\n /* Release task2 semaphore */
\n os_sem_release ( task2_sem );\n }\n }\n\n\n /* Initialize task 1 exposed data objects */ \n void \n task1_init ( void )\n {\n /* Initialize task1 semaphore */ \n os_sem_init ( task1_sem , 0 );\n }\n\n /* Initialize task 2 exposed data objects */ \n void \n task2_init ( void )\n {\n /* Initialize task1 semaphore */ \n os_sem_init ( task2_sem , 0 );\n }\n\n /** * init_app_tasks * * This function performs initializations that are required before tasks run. * * @return int 0 success; error otherwise. */ \n static int \n init_app_tasks ( void )\n {\n /* * Call task specific initialization functions to initialize any shared objects * before initializing the tasks with the OS. */ \n task1_init ();\n task2_init ();\n\n /* * Initialize tasks 1 and 2 with the OS.
*/ \n os_task_init ( task1 , task1 , task1_handler , NULL , TASK1_PRIO , \n OS_WAIT_FOREVER , task1_stack , TASK1_STACK_SIZE );\n\n os_task_init ( task2 , task2 , task2_handler , NULL , TASK2_PRIO , \n OS_WAIT_FOREVER , task2_stack , TASK2_STACK_SIZE );\n\n return 0 ;\n }\n\n /** * main * * The main function for the application. This function initializes the system and packages, * calls the application specific task initialization function, then waits and dispatches * events from the OS default event queue in an infinite loop. */ \n int \n main ( int argc , char **arg )\n {\n\n /* Perform system and package initialization */ \n sysinit ();\n\n /* Initialize application specific tasks */ \n init_app_tasks ();\n\n while ( 1 ) {\n os_eventq_run ( os_eventq_dflt_get ());\n }\n
/* main never returns */ \n}",
"title": "Example"
},
{
"location": "/os/core_os/mynewt_os/#os-functions",
- "text": "The functions available at the OS level are: os_init os_start os_started",
+ "text": "The functions available at the OS level are: os_started",
"title": "OS Functions"
},
{
- "location": "/os/core_os/os_init/",
- "text": "os_init\n\n\nvoid\n \nos_init\n(\nvoid\n)\n\n\n\n\n\nInitializes the OS. Must be called before the OS is started (i.e. \nos_start()\n is called).\n\n\n\n\nArguments\n\n\nNone\n\n\n\n\nReturned values\n\n\nNone\n\n\n\n\nNotes\n\n\nThe call to \nos_init()\n performs architecture and bsp initializations and initializes the idle task.\n\n\nThis function does not start the OS, the OS time tick interrupt, or the scheduler.",
- "title": "os_init"
- },
- {
- "location": "/os/core_os/os_init/#os_init",
- "text": "void os_init ( void ) Initializes the OS. Must be called before the OS is started (i.e. os_start() is called).",
- "title": "os_init"
- },
- {
- "location": "/os/core_os/os_init/#arguments",
- "text": "None",
- "title": "Arguments"
- },
- {
- "location": "/os/core_os/os_init/#returned-values",
- "text": "None",
- "title": "Returned values"
- },
- {
- "location": "/os/core_os/os_init/#notes",
- "text": "The call to os_init() performs architecture and bsp initializations and initializes the idle task. This function does not start the OS, the OS time tick interrupt, or the scheduler.",
- "title": "Notes"
- },
- {
- "location": "/os/core_os/os_start/",
- "text": "os_start\n\n\nvoid\n \nos_start\n(\nvoid\n)\n\n\n\n\n\nStarts the OS by initializing and enabling the OS time tick and starting the scheduler.\n\n\nThis function does not return.\n\n\n\n\nArguments\n\n\nNone\n\n\n\n\nReturned values\n\n\nNone (does not return).\n\n\n\n\nNotes\n\n\nOnce \nos_start()\n has been called, context is switched to the highest priority task that was initialized prior to calling \nos_start()\n.",
- "title": "os_start"
- },
- {
- "location": "/os/core_os/os_start/#os_start",
- "text": "void os_start ( void ) Starts the OS by initializing and enabling the OS time tick and starting the scheduler. This function does not return.",
- "title": "os_start"
- },
- {
- "location": "/os/core_os/os_start/#arguments",
- "text": "None",
- "title": "Arguments"
- },
- {
- "location": "/os/core_os/os_start/#returned-values",
- "text": "None (does not return).",
- "title": "Returned values"
- },
- {
- "location": "/os/core_os/os_start/#notes",
- "text": "Once os_start() has been called, context is switched to the highest priority task that was initialized prior to calling os_start() .",
- "title": "Notes"
- },
- {
"location": "/os/core_os/os_started/",
"text": "os_started\n\n\nint\n \nos_started\n(\nvoid\n)\n\n\n\n\n\nReturns 'true' (1) if the os has been started; 0 otherwise.\n\n\n\n\nArguments\n\n\nNone\n\n\n\n\nReturned values\n\n\nInteger value with 0 meaning the OS has not been started and 1 indicating the OS has been started (i.e. \nos_start()\n has been called).",
"title": "os_started"
@@ -2567,7 +2517,7 @@
},
{
"location": "/os/core_os/task/task/",
- "text": "Task\n\n\nA task, along with the scheduler, forms the basis of the Mynewt OS. A task \nconsists of two basic elements: a task stack and a task function. The task \nfunction is basically a forever loop, waiting for some \"event\" to wake it up. \nThere are two methods used to signal a task that it has work to do: \nevent queues\n \nand \nsemaphores\n .\n\n\nThe Mynewt OS is a multi-tasking, preemptive OS. Every task is assigned a task \npriority (from 0 to 255), with 0 being the highest priority task. If a higher \npriority task than the current task wants to run, the scheduler preempts the \ncurrently running task and switches context to the higher priority task. This is \njust a fancy way of saying that the processor stack pointer now points to the \nstack of the higher priority task and the task resumes execution where it left \noff.\n\n\nTasks run to completion unless they are preempted by a higher priority task. The \ndeveloper must ensure that tasks eventua
lly \"sleep\"; otherwise lower priority \ntasks will never get a chance to run (actually, any task lower in priority than \nthe task that never sleeps). A task will be put to sleep in the following cases: \nit puts itself to sleep using \nos_time_delay()\n, it waits on an \nevent queue\n\nwhich is empty or attempts to obtain a mutex or a \nsemaphore\n that is currently \nowned by another task.\n\n\nNote that other sections of the manual describe these OS features in more \ndetail.\n\n\nDescription\n\n\nIn order to create a task two data structures need to be defined: the task \nobject (\nstruct os_task\n) and its associated stack. Determining the stack size can \nbe a bit tricky; generally developers should not declare large local variables \non the stack so that task stacks can be of limited size. However, all \napplications are different and the developer must choose the stack size \naccordingly. NOTE: be careful when declaring your stack! The stack is in units \nof \nos_stack_t\
n sized elements (generally 32-bits). Looking at the example given \nbelow and assuming \nos_stack_t\n is defined to be a 32-bit unsigned value, \n\"my_task_stack\" will use 256 bytes. \n\n\nA task must also have an associated \"task function\". This is the function that \nwill be called when the task is first run. This task function should never \nreturn!\n\n\nIn order to inform the Mynewt OS of the new task and to have it added to the \nscheduler, the \nos_task_init()\n function is called. Once \nos_task_init()\n is \ncalled, the task is made ready to run and is added to the active task list. Note \nthat a task can be initialized (started) before or after the os has started \n(i.e. before \nos_start()\n is called) but must be initialized after the os has \nbeen initialized (i.e. 'os_init()' has been called). In most of the examples and \ncurrent Mynewt projects, the os is initialized, tasks are initialized, and the \nthe os is started. Once the os has started, the highest priority
task will be \nthe first task set to run.\n\n\nInformation about a task can be obtained using the \nos_task_info_get_next()\n \nAPI. Developers can walk the list of tasks to obtain information on all created \ntasks. This information is of type \nos_task_info\n and is described below.\n\n\nThe following is a very simple example showing a single application task. This \ntask simply toggles an LED at a one second interval.\n\n\n/* Create a simple \nproject\n with a task that blinks a LED every second */\n\n\n\n/* Define task stack and task object */\n\n\n#define MY_TASK_PRI (OS_TASK_PRI_HIGHEST) \n\n\n#define MY_STACK_SIZE (64) \n\n\nstruct\n \nos_task\n \nmy_task\n; \n\nos_stack_t\n \nmy_task_stack\n[\nMY_STACK_SIZE\n]; \n\n\n/* This is the task function */\n\n\nvoid\n \nmy_task_func\n(\nvoid\n \n*arg\n) {\n \n/* Set the led pin as an output */\n\n \nhal_gpio_init_out\n(\nLED_BLINK_PIN\n, \n1\n);\n\n \n/* The task is a forever loop that does not return */\n\n
\nwhile\n (\n1\n) {\n \n/* Wait one second */\n \n \nos_time_delay\n(\n1000\n);\n\n \n/* Toggle the LED */\n \n \nhal_gpio_toggle\n(\nLED_BLINK_PIN\n);\n }\n}\n\n\n/* This is the main function for the project */\n\n\nint\n \nmain\n(\nvoid\n) {\n \nint\n \nrc\n;\n\n \n/* Initialize OS */\n\n \nos_init\n();\n\n \n/* Initialize the task */\n\n \nos_task_init\n(\nmy_task\n, \nmy_task\n, \nmy_task_func\n, \nNULL\n, \nMY_TASK_PRIO\n, \n \nOS_WAIT_FOREVER\n, \nmy_task_stack\n, \nMY_STACK_SIZE\n);\n\n \n/* Start the OS */\n\n \nos_start\n();\n\n \n/* os start should never return. If it does, this should be an error */\n\n \nassert\n(\n0\n);\n\n \nreturn\n \nrc\n;\n}\n\n\n\n\n\nData structures\n\n\n/* The highest and lowest task priorities */\n\n\n#define OS_TASK_PRI_HIGHEST (0)\n\n\n#define OS_TASK_PRI_LOWEST (0xff)\n\n\n\n/* Task states */\n\n\ntypedef\n \nenum\n \nos_task_state\n {\n \nOS_T
ASK_READY\n \n=\n \n1\n, \n \nOS_TASK_SLEEP\n \n=\n \n2\n\n} \nos_task_state_t\n;\n\n\n/* Task flags */\n\n\n#define OS_TASK_FLAG_NO_TIMEOUT (0x0001U)\n\n\n#define OS_TASK_FLAG_SEM_WAIT (0x0002U)\n\n\n#define OS_TASK_FLAG_MUTEX_WAIT (0x0004U)\n\n\n\ntypedef\n \nvoid\n (\n*\nos_task_func_t\n)(\nvoid\n \n*\n);\n\n\n#define OS_TASK_MAX_NAME_LEN (32)\n\n\n\n\n\n\n\n\nstruct\n \nos_task\n {\n \nos_stack_t\n \n*t_stackptr\n;\n \nos_stack_t\n \n*t_stacktop\n;\n\n \nuint16_t\n \nt_stacksize\n;\n \nuint16_t\n \nt_flags\n;\n\n \nuint8_t\n \nt_taskid\n;\n \nuint8_t\n \nt_prio\n;\n \nuint8_t\n \nt_state\n;\n \nuint8_t\n \nt_pad\n;\n\n \nchar\n \n*t_name\n;\n \nos_task_func_t\n \nt_func\n;\n \nvoid\n \n*t_arg\n;\n\n \nvoid\n \n*t_obj\n;\n\n \nstruct\n \nos_sanity_check\n \nt_sanity_check\n; \n\n \nos_time_t\n \nt_next_wakeup\n;\n \nos_time_t\n \nt_run_time\n;\n \nuint32_t\n \nt_ctx_sw_cnt\n;\n\n \n/* Global list of all tasks, ir
respective of run or sleep lists */\n\n \nSTAILQ_ENTRY\n(\nos_task\n) \nt_os_task_list\n;\n\n \n/* Used to chain task to either the run or sleep list */\n \n \nTAILQ_ENTRY\n(\nos_task\n) \nt_os_list\n;\n\n \n/* Used to chain task to an object such as a semaphore or mutex */\n\n \nSLIST_ENTRY\n(\nos_task\n) \nt_obj_list\n;\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nt_stackptr\n\n\nCurrent stack pointer\n\n\n\n\n\n\nt_stacktop\n\n\nThe address of the top of the task stack. The stack grows downward\n\n\n\n\n\n\nt_stacksize\n\n\nThe size of the stack, in units of os_stack_t (not bytes!)\n\n\n\n\n\n\nt_flags\n\n\nTask flags (see flag definitions)\n\n\n\n\n\n\nt_taskid\n\n\nA numeric id assigned to each task\n\n\n\n\n\n\nt_prio\n\n\nThe priority of the task. The lower the number, the higher the priority\n\n\n\n\n\n\nt_state\n\n\nThe task state (see state definitions)\n\n\n\n\n\n\nt_pad\n\n\npadding (for alignment)\n\n\n\n\n\n\nt_name\n\n\nName
of task\n\n\n\n\n\n\nt_func\n\n\nPointer to task function\n\n\n\n\n\n\nt_obj\n\n\nGeneric object used by mutexes and semaphores when the task is waiting on a mutex or semaphore\n\n\n\n\n\n\nt_sanity_check\n\n\nSanity task data structure\n\n\n\n\n\n\nt_next_wakeup\n\n\nOS time when task is next scheduled to wake up\n\n\n\n\n\n\nt_run_time\n\n\nThe amount of os time ticks this task has been running\n\n\n\n\n\n\nt_ctx_sw_cnt\n\n\nThe number of times that this task has been run\n\n\n\n\n\n\nt_os_task_list\n\n\nList pointer for global task list. All tasks are placed on this list\n\n\n\n\n\n\nt_os_list\n\n\nList pointer used by either the active task list or the sleeping task list\n\n\n\n\n\n\nt_obj_list\n\n\nList pointer for tasks waiting on a semaphore or mutex\n\n\n\n\n\n\n\n\n\n\nstruct\n \nos_task_info\n {\n \nuint8_t\n \noti_prio\n;\n \nuint8_t\n \noti_taskid\n;\n \nuint8_t\n \noti_state\n;\n \nuint8_t\n \noti_flags\n;\n \nuint16_t\n \noti_stkusage\n;\n \nuint16_t\
n \noti_stksize\n;\n \nuint32_t\n \noti_cswcnt\n;\n \nuint32_t\n \noti_runtime\n;\n \nos_time_t\n \noti_last_checkin\n;\n \nos_time_t\n \noti_next_checkin\n;\n\n \nchar\n \noti_name\n[\nOS_TASK_MAX_NAME_LEN\n];\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\noti_prio\n\n\nTask priority\n\n\n\n\n\n\noti_taskid\n\n\nTask id\n\n\n\n\n\n\noti_state\n\n\nTask state\n\n\n\n\n\n\noti_flags\n\n\nTask flags\n\n\n\n\n\n\noti_stkusage\n\n\nAmount of stack used by the task (in os_stack_t units)\n\n\n\n\n\n\noti_stksize\n\n\nThe size of the stack (in os_stack_t units)\n\n\n\n\n\n\noti_cswcnt\n\n\nThe context switch count\n\n\n\n\n\n\noti_runtime\n\n\nThe amount of time that the task has run (in os time ticks)\n\n\n\n\n\n\noti_last_checkin\n\n\nThe time (os time) at which this task last checked in to the sanity task\n\n\n\n\n\n\noti_next_checkin\n\n\nThe time (os time) at which this task last checked in to the sanity task\n\n\n\n\n\n\noti_name\n\n\nName of
the task\n\n\n\n\n\n\n\n\n\n\nList of Functions\n\n\nThe functions available in task are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nos_task_init\n\n\nCalled to create a task. This adds the task object to the list of ready to run tasks.\n\n\n\n\n\n\nos_task_count\n\n\nReturns the number of tasks that have been created.\n\n\n\n\n\n\nos_task_info_get_next\n\n\nPopulates the os task info structure given with task information.",
+ "text": "Task\n\n\nA task, along with the scheduler, forms the basis of the Mynewt OS. A task \nconsists of two basic elements: a task stack and a task function. The task \nfunction is basically a forever loop, waiting for some \"event\" to wake it up. \nThere are two methods used to signal a task that it has work to do: \nevent queues\n \nand \nsemaphores\n .\n\n\nThe Mynewt OS is a multi-tasking, preemptive OS. Every task is assigned a task \npriority (from 0 to 255), with 0 being the highest priority task. If a higher \npriority task than the current task wants to run, the scheduler preempts the \ncurrently running task and switches context to the higher priority task. This is \njust a fancy way of saying that the processor stack pointer now points to the \nstack of the higher priority task and the task resumes execution where it left \noff.\n\n\nTasks run to completion unless they are preempted by a higher priority task. The \ndeveloper must ensure that tasks eventua
lly \"sleep\"; otherwise lower priority \ntasks will never get a chance to run (actually, any task lower in priority than \nthe task that never sleeps). A task will be put to sleep in the following cases: \nit puts itself to sleep using \nos_time_delay()\n, it waits on an \nevent queue\n\nwhich is empty or attempts to obtain a mutex or a \nsemaphore\n that is currently \nowned by another task.\n\n\nNote that other sections of the manual describe these OS features in more \ndetail.\n\n\nDescription\n\n\nIn order to create a task two data structures need to be defined: the task \nobject (\nstruct os_task\n) and its associated stack. Determining the stack size can \nbe a bit tricky; generally developers should not declare large local variables \non the stack so that task stacks can be of limited size. However, all \napplications are different and the developer must choose the stack size \naccordingly. NOTE: be careful when declaring your stack! The stack is in units \nof \nos_stack_t\
n sized elements (generally 32-bits). Looking at the example given \nbelow and assuming \nos_stack_t\n is defined to be a 32-bit unsigned value, \n\"my_task_stack\" will use 256 bytes. \n\n\nA task must also have an associated \"task function\". This is the function that \nwill be called when the task is first run. This task function should never \nreturn!\n\n\nIn order to inform the Mynewt OS of the new task and to have it added to the \nscheduler, the \nos_task_init()\n function is called. Once \nos_task_init()\n is \ncalled, the task is made ready to run and is added to the active task list. Note \nthat a task can be initialized (started) before or after the os has started \n(i.e. before \nos_start()\n is called) but must be initialized after the os has \nbeen initialized (i.e. 'os_init()' has been called). In most of the examples and \ncurrent Mynewt projects, the os is initialized, tasks are initialized, and the \nthe os is started. Once the os has started, the highest priority
task will be \nthe first task set to run.\n\n\nInformation about a task can be obtained using the \nos_task_info_get_next()\n \nAPI. Developers can walk the list of tasks to obtain information on all created \ntasks. This information is of type \nos_task_info\n and is described below.\n\n\nThe following is a very simple example showing a single application task. This \ntask simply toggles an LED at a one second interval.\n\n\n/* Create a simple \nproject\n with a task that blinks a LED every second */\n\n\n\n/* Define task stack and task object */\n\n\n#define MY_TASK_PRI (OS_TASK_PRI_HIGHEST) \n\n\n#define MY_STACK_SIZE (64) \n\n\nstruct\n \nos_task\n \nmy_task\n; \n\nos_stack_t\n \nmy_task_stack\n[\nMY_STACK_SIZE\n]; \n\n\n/* This is the task function */\n\n\nvoid\n \nmy_task_func\n(\nvoid\n \n*arg\n) {\n \n/* Set the led pin as an output */\n\n \nhal_gpio_init_out\n(\nLED_BLINK_PIN\n, \n1\n);\n\n \n/* The task is a forever loop that does not return */\n\n
\nwhile\n (\n1\n) {\n \n/* Wait one second */\n \n \nos_time_delay\n(\n1000\n);\n\n \n/* Toggle the LED */\n \n \nhal_gpio_toggle\n(\nLED_BLINK_PIN\n);\n }\n}\n\n\n/* This is the main function for the project */\n\n\nint\n \nmain\n(\nint\n \nargc\n, \nchar\n \n**argv\n) \n{\n\n \n/* Perform system and package initialization */\n\n \nsysinit\n();\n\n \n/* Initialize the task */\n\n \nos_task_init\n(\nmy_task\n, \nmy_task\n, \nmy_task_func\n, \nNULL\n, \nMY_TASK_PRIO\n, \n \nOS_WAIT_FOREVER\n, \nmy_task_stack\n, \nMY_STACK_SIZE\n);\n\n \n/* Process events from the default event queue. */\n\n \nwhile\n (\n1\n) {\n \nos_eventq_run\n(\nos_eventq_dflt_get\n());\n }\n \n/* main never returns */\n \n}\n\n\n\n\n\nData structures\n\n\n/* The highest and lowest task priorities */\n\n\n#define OS_TASK_PRI_HIGHEST (0)\n\n\n#define OS_TASK_PRI_LOWEST (0xff)\n\n\n\n/* Task states */\n\n\ntypedef\n \
nenum\n \nos_task_state\n {\n \nOS_TASK_READY\n \n=\n \n1\n, \n \nOS_TASK_SLEEP\n \n=\n \n2\n\n} \nos_task_state_t\n;\n\n\n/* Task flags */\n\n\n#define OS_TASK_FLAG_NO_TIMEOUT (0x0001U)\n\n\n#define OS_TASK_FLAG_SEM_WAIT (0x0002U)\n\n\n#define OS_TASK_FLAG_MUTEX_WAIT (0x0004U)\n\n\n\ntypedef\n \nvoid\n (\n*\nos_task_func_t\n)(\nvoid\n \n*\n);\n\n\n#define OS_TASK_MAX_NAME_LEN (32)\n\n\n\n\n\n\n\n\nstruct\n \nos_task\n {\n \nos_stack_t\n \n*t_stackptr\n;\n \nos_stack_t\n \n*t_stacktop\n;\n\n \nuint16_t\n \nt_stacksize\n;\n \nuint16_t\n \nt_flags\n;\n\n \nuint8_t\n \nt_taskid\n;\n \nuint8_t\n \nt_prio\n;\n \nuint8_t\n \nt_state\n;\n \nuint8_t\n \nt_pad\n;\n\n \nchar\n \n*t_name\n;\n \nos_task_func_t\n \nt_func\n;\n \nvoid\n \n*t_arg\n;\n\n \nvoid\n \n*t_obj\n;\n\n \nstruct\n \nos_sanity_check\n \nt_sanity_check\n; \n\n \nos_time_t\n \nt_next_wakeup\n;\n \nos_time_t\n \nt_run_time\n;\n \nuint32_t\n \nt_ctx_sw_cnt\n;\n
\n \n/* Global list of all tasks, irrespective of run or sleep lists */\n\n \nSTAILQ_ENTRY\n(\nos_task\n) \nt_os_task_list\n;\n\n \n/* Used to chain task to either the run or sleep list */\n \n \nTAILQ_ENTRY\n(\nos_task\n) \nt_os_list\n;\n\n \n/* Used to chain task to an object such as a semaphore or mutex */\n\n \nSLIST_ENTRY\n(\nos_task\n) \nt_obj_list\n;\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nt_stackptr\n\n\nCurrent stack pointer\n\n\n\n\n\n\nt_stacktop\n\n\nThe address of the top of the task stack. The stack grows downward\n\n\n\n\n\n\nt_stacksize\n\n\nThe size of the stack, in units of os_stack_t (not bytes!)\n\n\n\n\n\n\nt_flags\n\n\nTask flags (see flag definitions)\n\n\n\n\n\n\nt_taskid\n\n\nA numeric id assigned to each task\n\n\n\n\n\n\nt_prio\n\n\nThe priority of the task. The lower the number, the higher the priority\n\n\n\n\n\n\nt_state\n\n\nThe task state (see state definitions)\n\n\n\n\n\n\nt_pad\n\n\npadding (for al
ignment)\n\n\n\n\n\n\nt_name\n\n\nName of task\n\n\n\n\n\n\nt_func\n\n\nPointer to task function\n\n\n\n\n\n\nt_obj\n\n\nGeneric object used by mutexes and semaphores when the task is waiting on a mutex or semaphore\n\n\n\n\n\n\nt_sanity_check\n\n\nSanity task data structure\n\n\n\n\n\n\nt_next_wakeup\n\n\nOS time when task is next scheduled to wake up\n\n\n\n\n\n\nt_run_time\n\n\nThe amount of os time ticks this task has been running\n\n\n\n\n\n\nt_ctx_sw_cnt\n\n\nThe number of times that this task has been run\n\n\n\n\n\n\nt_os_task_list\n\n\nList pointer for global task list. All tasks are placed on this list\n\n\n\n\n\n\nt_os_list\n\n\nList pointer used by either the active task list or the sleeping task list\n\n\n\n\n\n\nt_obj_list\n\n\nList pointer for tasks waiting on a semaphore or mutex\n\n\n\n\n\n\n\n\n\n\nstruct\n \nos_task_info\n {\n \nuint8_t\n \noti_prio\n;\n \nuint8_t\n \noti_taskid\n;\n \nuint8_t\n \noti_state\n;\n \nuint8_t\n \noti_flags\n;\n \nuint16
_t\n \noti_stkusage\n;\n \nuint16_t\n \noti_stksize\n;\n \nuint32_t\n \noti_cswcnt\n;\n \nuint32_t\n \noti_runtime\n;\n \nos_time_t\n \noti_last_checkin\n;\n \nos_time_t\n \noti_next_checkin\n;\n\n \nchar\n \noti_name\n[\nOS_TASK_MAX_NAME_LEN\n];\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\noti_prio\n\n\nTask priority\n\n\n\n\n\n\noti_taskid\n\n\nTask id\n\n\n\n\n\n\noti_state\n\n\nTask state\n\n\n\n\n\n\noti_flags\n\n\nTask flags\n\n\n\n\n\n\noti_stkusage\n\n\nAmount of stack used by the task (in os_stack_t units)\n\n\n\n\n\n\noti_stksize\n\n\nThe size of the stack (in os_stack_t units)\n\n\n\n\n\n\noti_cswcnt\n\n\nThe context switch count\n\n\n\n\n\n\noti_runtime\n\n\nThe amount of time that the task has run (in os time ticks)\n\n\n\n\n\n\noti_last_checkin\n\n\nThe time (os time) at which this task last checked in to the sanity task\n\n\n\n\n\n\noti_next_checkin\n\n\nThe time (os time) at which this task last checked in to the sanity t
ask\n\n\n\n\n\n\noti_name\n\n\nName of the task\n\n\n\n\n\n\n\n\n\n\nList of Functions\n\n\nThe functions available in task are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nos_task_init\n\n\nCalled to create a task. This adds the task object to the list of ready to run tasks.\n\n\n\n\n\n\nos_task_count\n\n\nReturns the number of tasks that have been created.\n\n\n\n\n\n\nos_task_info_get_next\n\n\nPopulates the os task info structure given with task information.",
"title": "toc"
},
{
@@ -2577,7 +2527,7 @@
},
{
"location": "/os/core_os/task/task/#description",
- "text": "In order to create a task two data structures need to be defined: the task \nobject ( struct os_task ) and its associated stack. Determining the stack size can \nbe a bit tricky; generally developers should not declare large local variables \non the stack so that task stacks can be of limited size. However, all \napplications are different and the developer must choose the stack size \naccordingly. NOTE: be careful when declaring your stack! The stack is in units \nof os_stack_t sized elements (generally 32-bits). Looking at the example given \nbelow and assuming os_stack_t is defined to be a 32-bit unsigned value, \n\"my_task_stack\" will use 256 bytes. A task must also have an associated \"task function\". This is the function that \nwill be called when the task is first run. This task function should never \nreturn! In order to inform the Mynewt OS of the new task and to have it added to the \nscheduler, the os_task_init() function is called. Once o
s_task_init() is \ncalled, the task is made ready to run and is added to the active task list. Note \nthat a task can be initialized (started) before or after the os has started \n(i.e. before os_start() is called) but must be initialized after the os has \nbeen initialized (i.e. 'os_init()' has been called). In most of the examples and \ncurrent Mynewt projects, the os is initialized, tasks are initialized, and the \nthe os is started. Once the os has started, the highest priority task will be \nthe first task set to run. Information about a task can be obtained using the os_task_info_get_next() \nAPI. Developers can walk the list of tasks to obtain information on all created \ntasks. This information is of type os_task_info and is described below. The following is a very simple example showing a single application task. This \ntask simply toggles an LED at a one second interval. /* Create a simple project with a task that blinks a LED every second */ /* Define task st
ack and task object */ #define MY_TASK_PRI (OS_TASK_PRI_HIGHEST) #define MY_STACK_SIZE (64) struct os_task my_task ; os_stack_t my_task_stack [ MY_STACK_SIZE ]; /* This is the task function */ void my_task_func ( void *arg ) {\n /* Set the led pin as an output */ \n hal_gpio_init_out ( LED_BLINK_PIN , 1 );\n\n /* The task is a forever loop that does not return */ \n while ( 1 ) {\n /* Wait one second */ \n os_time_delay ( 1000 );\n\n /* Toggle the LED */ \n hal_gpio_toggle ( LED_BLINK_PIN );\n }\n} /* This is the main function for the project */ int main ( void ) {\n int rc ;\n\n /* Initialize OS */ \n os_init ();\n\n /* Initialize the task */ \n os_task_init ( my_task , my_task , my_task_func , NULL , MY_TASK_PRIO , \n OS_WAIT_FOREVER , my_task_stack , MY_STACK_SIZE );\n\n /* Start the OS */ \n os_start ();\n\n /* os start should never r
eturn. If it does, this should be an error */ \n assert ( 0 );\n\n return rc ;\n}",
+ "text": "In order to create a task two data structures need to be defined: the task \nobject ( struct os_task ) and its associated stack. Determining the stack size can \nbe a bit tricky; generally developers should not declare large local variables \non the stack so that task stacks can be of limited size. However, all \napplications are different and the developer must choose the stack size \naccordingly. NOTE: be careful when declaring your stack! The stack is in units \nof os_stack_t sized elements (generally 32-bits). Looking at the example given \nbelow and assuming os_stack_t is defined to be a 32-bit unsigned value, \n\"my_task_stack\" will use 256 bytes. A task must also have an associated \"task function\". This is the function that \nwill be called when the task is first run. This task function should never \nreturn! In order to inform the Mynewt OS of the new task and to have it added to the \nscheduler, the os_task_init() function is called. Once o
s_task_init() is \ncalled, the task is made ready to run and is added to the active task list. Note \nthat a task can be initialized (started) before or after the os has started \n(i.e. before os_start() is called) but must be initialized after the os has \nbeen initialized (i.e. 'os_init()' has been called). In most of the examples and \ncurrent Mynewt projects, the os is initialized, tasks are initialized, and the \nthe os is started. Once the os has started, the highest priority task will be \nthe first task set to run. Information about a task can be obtained using the os_task_info_get_next() \nAPI. Developers can walk the list of tasks to obtain information on all created \ntasks. This information is of type os_task_info and is described below. The following is a very simple example showing a single application task. This \ntask simply toggles an LED at a one second interval. /* Create a simple project with a task that blinks a LED every second */ /* Define task st
ack and task object */ #define MY_TASK_PRI (OS_TASK_PRI_HIGHEST) #define MY_STACK_SIZE (64) struct os_task my_task ; os_stack_t my_task_stack [ MY_STACK_SIZE ]; /* This is the task function */ void my_task_func ( void *arg ) {\n /* Set the led pin as an output */ \n hal_gpio_init_out ( LED_BLINK_PIN , 1 );\n\n /* The task is a forever loop that does not return */ \n while ( 1 ) {\n /* Wait one second */ \n os_time_delay ( 1000 );\n\n /* Toggle the LED */ \n hal_gpio_toggle ( LED_BLINK_PIN );\n }\n} /* This is the main function for the project */ int main ( int argc , char **argv ) \n{\n\n /* Perform system and package initialization */ \n sysinit ();\n\n /* Initialize the task */ \n os_task_init ( my_task , my_task , my_task_func , NULL , MY_TASK_PRIO , \n OS_WAIT_FOREVER , my_task_stack , MY_STACK_SIZE );\n\n /* Process events from the default e
vent queue. */ \n while ( 1 ) {\n os_eventq_run ( os_eventq_dflt_get ());\n }\n /* main never returns */ \n}",
"title": "Description"
},
{
@@ -4752,17 +4702,17 @@
},
{
"location": "/os/modules/console/console/",
- "text": "Console\n\n\nThe console is an operating system window where users interact with system programs of the operating system \nor a console application by entering text input (typically from a keyboard) and reading text output \n(typically on the computer terminal or monitor). The text written on the console brings some information \nand is a sequence of characters sent by the OS or programs running on the OS. \n\n\nSupport is currently available for console access via the serial port on the hardware board.\n\n\nDescription\n\n\nIn the Mynewt OS, the console library comes in two versions:\n\n\n\n\nfull - containing the full implementation\n\n\nstub - containing stubs for the API\n\n\n\n\nBoth of these have a \npkg.yml\n file which states that they provide the \nconsole\n API. If a pkg uses \nthis API, it should list \nconsole\n as a requirement. For example, the shell pkg is defined by the \nfollowing pkg.yml file:\n\n\n pkg.name: libs/shell \n pkg.vers: 0.1\n
pkg.deps:\n - libs/os\n - libs/util\n pkg.reqs:\n - console\n pkg.identities:\n - SHELL \n\n\n\n\n\nThe project .yml file decides which version of the console pkg should be included. \nIf a project requires the full console capability it lists dependency \nlibs/console/full\n in its pkg.yml \nfile. On the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to) \nbut may have a dependency on a pkg that has console capability. In that case you would use a console stub. \n\n\nAnother example would be the bootloader project where we want to keep the size of the image small. It includes \nthe \nlibs/os\n pkg that can print out messages on a console (e.g. if there is a hard fault) and the \nlibs/util\n \npkg that uses the full console (but only if SHELL is present to provide a CLI). However, we do not want to use \nany console I/O capability in this particular bootloader project to keep the size small. We simp
ly use the console \nstub instead, and the pkg.yml file for the project boot pkg looks like the following:\n\n\n project.name: boot\n project.identities: bootloader\n project.pkgs:\n - libs/os\n - libs/bootutil\n - libs/nffs\n - libs/console/stub\n - libs/util \n\n\n\n\n\nConsole has 2 modes for transmit; \nblocking mode\n and \nnon-blocking mode\n. Usually the \nnon-blocking mode\n is the \nactive one; the output buffer is drained by getting TX completion interrupts from hardware, and more data is added \nbased on these interrupts.\n\n\nBlocking mode\n is used when we don't want TX completion interrupts. It is used when system crashes, and we still \nwant to output info related to that crash.\n\n\nConsole, by default, echoes everything it receives back. Terminal programs expect this, and is a way for the user to \nknow that the console is connected and responsive. Whether echoing happens or not can be controlled programmatically.\n\n\nThe
Console also has a prompt that is configurable. It is off by default but can be turned on programatically. The\nprompt cahracter can also be changed by the user.\n\n\nData structures\n\n\nN/A\n\n\nList of Functions\n\n\nThe functions available in console are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nconsole_blocking_mode\n\n\nCalls the \nconsole_blocking_tx\n function to flush the buffered console output (transmit) queue.\n\n\n\n\n\n\nconsole_echo\n\n\nControls whether echoing is on or off for the console.\n\n\n\n\n\n\nconsole_init\n\n\nInitialize the console.\n\n\n\n\n\n\nconsole_is_init\n\n\nReturns whether console has been initialized or not.\n\n\n\n\n\n\nconsole_printf\n\n\nWrites a formatted message instead of raw output to the console.\n\n\n\n\n\n\nconsole_read\n\n\nCopies up the to given number of bytes to the input string.\n\n\n\n\n\n\nconsole_write\n\n\nQueues characters to console display over serial port.",
+ "text": "Console\n\n\nThe console is an operating system window where users interact with the OS subsystems or a console \napplication. A user typically inputs text from a keyboard and reads the OS output text on a computer\nmonitor. The text are sent as a sequence of characters between the user and the OS. \n\n\nSupport is currently available for console access via the serial port on the hardware board.\n\n\nDescription\n\n\nIn the Mynewt OS, the console library comes in two versions:\n\n\n\n\n\n\nThe \nsys/console/full\n package implements the complete console functionality and API.\n\n\n\n\n\n\nThe \nsys/console/stub\n package implements stubs for the API.\n\n\n\n\n\n\nBoth packages export the \nconsole\n API, and any package that uses \nthe console API must list \nconsole\n as a requirement. For example, the shell package defines the following \npkg.yml\n\nfile:\n\n\npkg.name: sys/shell\npkg.deps:\n - kernel/os\n - encoding/base64\n - time/datetime\n -
util/crc\npkg.req_apis:\n - console\n\n\n\n\n\nThe project \npkg.yml\n file specifies the version of the console package to use.\nA project that requires the full console capability must list the \nsys/console/full\n package as a dependency \nin its \npkg.yml\n file.\n\n\nAn example is the \nslinky\n application. It requires the full console capability and has the following\n\npkg.yml\n file: \n\n\npkg.name: apps/slinky\npkg.deps:\n - test/flash_test\n - mgmt/imgmgr\n - mgmt/newtmgr\n - mgmt/newtmgr/transport/nmgr_shell\n - kernel/os\n - boot/bootutil\n - sys/shell\n - sys/console/full\n ...\n - sys/id\n\n\n\n\n\nOn the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to) \nbut may have a dependency on a package that has console capability. In this case, you use \nthe console stub API and list the \nsys/console/stub\n package as a dependency in its \npkg.yml\n file. \n\n\nAn example is the bootloader pr
oject where we want to keep the size of the image small. It includes \nthe \nkernel/os\n package that can print out messages on a console (e.g. if there is a hard fault).\nHowever, we do not want to use any console I/O capability in this particular bootloader project to \nkeep the size small. The project uses the console stub API and has the following \npkg.yml\n file: \n\n\npkg.name: apps/boot\npkg.deps:\n - boot/bootutil\n - kernel/os\n - sys/console/stub\n\n\n\n\n\nConsole has 2 modes for transmit; \nblocking mode\n and \nnon-blocking mode\n. Usually the \nnon-blocking mode\n is the \nactive one; the output buffer is drained by getting TX completion interrupts from hardware, and more data is added \nbased on these interrupts.\n\n\nBlocking mode\n is used when we don't want TX completion interrupts. It is used when system crashes, and we still \nwant to output info related to that crash.\n\n\nConsole, by default, echoes everything it receives back. Terminal programs expec
t this, and is a way for the user to \nknow that the console is connected and responsive. Whether echoing happens or not can be controlled programmatically.\n\n\nThe Console also has a prompt that is configurable. It is off by default but can be turned on programmatically. The\nprompt character can also be changed by the user.\n\n\nData structures\n\n\nN/A\n\n\nList of Functions\n\n\nThe functions available in console are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nconsole_blocking_mode\n\n\nCalls the \nconsole_blocking_tx\n function to flush the buffered console output (transmit) queue.\n\n\n\n\n\n\nconsole_echo\n\n\nControls whether echoing is on or off for the console.\n\n\n\n\n\n\nconsole_init\n\n\nInitialize the console.\n\n\n\n\n\n\nconsole_is_init\n\n\nReturns whether console has been initialized or not.\n\n\n\n\n\n\nconsole_printf\n\n\nWrites a formatted message instead of raw output to the console.\n\n\n\n\n\n\nconsole_read\n\n\nCopies up the to given n
umber of bytes to the input string.\n\n\n\n\n\n\nconsole_write\n\n\nQueues characters to console display over serial port.",
"title": "toc"
},
{
"location": "/os/modules/console/console/#console",
- "text": "The console is an operating system window where users interact with system programs of the operating system \nor a console application by entering text input (typically from a keyboard) and reading text output \n(typically on the computer terminal or monitor). The text written on the console brings some information \nand is a sequence of characters sent by the OS or programs running on the OS. Support is currently available for console access via the serial port on the hardware board.",
+ "text": "The console is an operating system window where users interact with the OS subsystems or a console \napplication. A user typically inputs text from a keyboard and reads the OS output text on a computer\nmonitor. The text are sent as a sequence of characters between the user and the OS. Support is currently available for console access via the serial port on the hardware board.",
"title": "Console"
},
{
"location": "/os/modules/console/console/#description",
- "text": "In the Mynewt OS, the console library comes in two versions: full - containing the full implementation stub - containing stubs for the API Both of these have a pkg.yml file which states that they provide the console API. If a pkg uses \nthis API, it should list console as a requirement. For example, the shell pkg is defined by the \nfollowing pkg.yml file: pkg.name: libs/shell \n pkg.vers: 0.1\n pkg.deps:\n - libs/os\n - libs/util\n pkg.reqs:\n - console\n pkg.identities:\n - SHELL The project .yml file decides which version of the console pkg should be included. \nIf a project requires the full console capability it lists dependency libs/console/full in its pkg.yml \nfile. On the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to) \nbut may have a dependency on a pkg that has console capability. In that case you would use a console stub. Another example w
ould be the bootloader project where we want to keep the size of the image small. It includes \nthe libs/os pkg that can print out messages on a console (e.g. if there is a hard fault) and the libs/util \npkg that uses the full console (but only if SHELL is present to provide a CLI). However, we do not want to use \nany console I/O capability in this particular bootloader project to keep the size small. We simply use the console \nstub instead, and the pkg.yml file for the project boot pkg looks like the following: project.name: boot\n project.identities: bootloader\n project.pkgs:\n - libs/os\n - libs/bootutil\n - libs/nffs\n - libs/console/stub\n - libs/util Console has 2 modes for transmit; blocking mode and non-blocking mode . Usually the non-blocking mode is the \nactive one; the output buffer is drained by getting TX completion interrupts from hardware, and more data is added \nbased on these interrupts. Blocking mode
is used when we don't want TX completion interrupts. It is used when system crashes, and we still \nwant to output info related to that crash. Console, by default, echoes everything it receives back. Terminal programs expect this, and is a way for the user to \nknow that the console is connected and responsive. Whether echoing happens or not can be controlled programmatically. The Console also has a prompt that is configurable. It is off by default but can be turned on programatically. The\nprompt cahracter can also be changed by the user.",
+ "text": "In the Mynewt OS, the console library comes in two versions: The sys/console/full package implements the complete console functionality and API. The sys/console/stub package implements stubs for the API. Both packages export the console API, and any package that uses \nthe console API must list console as a requirement. For example, the shell package defines the following pkg.yml \nfile: pkg.name: sys/shell\npkg.deps:\n - kernel/os\n - encoding/base64\n - time/datetime\n - util/crc\npkg.req_apis:\n - console The project pkg.yml file specifies the version of the console package to use.\nA project that requires the full console capability must list the sys/console/full package as a dependency \nin its pkg.yml file. An example is the slinky application. It requires the full console capability and has the following pkg.yml file: pkg.name: apps/slinky\npkg.deps:\n - test/flash_test\n - mgmt/imgmgr\n - mgmt/newtm
gr\n - mgmt/newtmgr/transport/nmgr_shell\n - kernel/os\n - boot/bootutil\n - sys/shell\n - sys/console/full\n ...\n - sys/id On the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to) \nbut may have a dependency on a package that has console capability. In this case, you use \nthe console stub API and list the sys/console/stub package as a dependency in its pkg.yml file. An example is the bootloader project where we want to keep the size of the image small. It includes \nthe kernel/os package that can print out messages on a console (e.g. if there is a hard fault).\nHowever, we do not want to use any console I/O capability in this particular bootloader project to \nkeep the size small. The project uses the console stub API and has the following pkg.yml file: pkg.name: apps/boot\npkg.deps:\n - boot/bootutil\n - kernel/os\n - sys/console/stub Console has 2 modes for transmit; blocking mode a
nd non-blocking mode . Usually the non-blocking mode is the \nactive one; the output buffer is drained by getting TX completion interrupts from hardware, and more data is added \nbased on these interrupts. Blocking mode is used when we don't want TX completion interrupts. It is used when system crashes, and we still \nwant to output info related to that crash. Console, by default, echoes everything it receives back. Terminal programs expect this, and is a way for the user to \nknow that the console is connected and responsive. Whether echoing happens or not can be controlled programmatically. The Console also has a prompt that is configurable. It is off by default but can be turned on programmatically. The\nprompt character can also be changed by the user.",
"title": "Description"
},
{
@@ -4962,17 +4912,17 @@
},
{
"location": "/os/modules/shell/shell/",
- "text": "Shell\n\n\nThe shell is package sitting on top of console, handling 2 jobs: processing console input and implementing \n\nnewtmgr\n line protocol over serial line. Shell runs in its own task.\n\n\nDescription\n\n\n\n\n\n\nShell's first job is directing incoming commands to other subsystems. It parses the incoming character string \nand splits it into tokens. Then it looks for the subsystem to handle this command based on the first token of input.\n\n\n\n\n\n\nSubsystems register their command handlers using \nshell_cmd_register()\n. When shell calls the command handler, it passes the other tokens as arguments.\n\n\n\n\n\n\nA few commands are currently available in the shell - \ntasks\n, \nlog\n, \necho\n, \ndate\n and \nprompt\n.\n\n\n\n\n\n\n\n\n\n\nShell's second job is doing framing, encoding and decoding newtmgr protocol when it's carried over the console. \nProtocol handler (libs/newtmgr) registers itself using \nshell_nlip_input_register()\n, and shell cal
ls the registered \nhandler for every frame. Outgoing frames for the protocol are sent using \nshell_nlip_output()\n.\n\n\n\n\n\n\n\n\nCreate a sim target to check out these commands available in shell.\n\n\nuser@~/dev/larva$ newt target create blinky_sim\nCreating target blinky_sim\nTarget blinky_sim successfully created!\nuser@~/dev/larva$ newt target set blinky_sim name=blinky_sim\nTarget blinky_sim successfully set name to blinky_sim\nuser@~/dev/larva$ newt target set blinky_sim arch=sim\nTarget blinky_sim successfully set arch to sim\nuser@~/dev/larva$ newt target set blinky_sim project=blinky\nTarget blinky_sim successfully set project to blinky\nuser@~/dev/larva$ newt target set blinky_sim bsp=hw/bsp/native\nTarget blinky_sim successfully set bsp to hw/bsp/native\nuser@~/dev/larva$ newt target set blinky_sim compiler_def=debug\nTarget blinky_sim successfully set compiler_def to debug\nuser@~/dev/larva$ newt target set blinky_sim compiler=sim\nTarget blinky_sim successfully se
t compiler to sim\nuser@~/dev/larva$ newt target show\nblinky_sim\n arch: sim\n bsp: hw/bsp/native\n compiler: sim\n compiler_def: debug\n name: blinky_sim\n project: blinky\nuser@~/dev/larva$ newt target build blinky_sim\nBuilding target blinky_sim (project = blinky)\nCompiling case.c\nCompiling suite.c\nCompiling testutil.c\n..\n..\nBuilding project blinky\nLinking blinky.elf\nSuccessfully run!\n\nuser@~/dev/larva$ ./project/blinky/bin/blinky_sim/blinky.elf\nuart0 at /dev/ttys005\n\n\n\n\n\nOpen up a new terminal to run minicom, a text-based serial port control and terminal emulation program. Set device name to the serial port of the target. \n\n\nuser@~$ minicom -D /dev/ttys005\nWelcome to minicom 2.7\n\nOPTIONS: \nCompiled on Nov 24 2015, 16:14:21.\nPort /dev/ttys005, 11:32:17\n\nPress Meta-Z for help on special keys\n\nlog \n174578:[0] bla\n174578:[0] bab\n\ntasks\n217809:6 tasks: \n217809: shell (prio: 3, nw: 0, flags: 0x0, ssize: 0, cswcnt: 59, tot_run_time
: 0ms)\n217840: idle (prio: 255, nw: 0, flags: 0x0, ssize: 0, cswcnt: 18763, tot_run_time: 217809ms)\n217878: uart_poller (prio: 0, nw: 217819, flags: 0x0, ssize: 0, cswcnt: 18667, tot_run_time: 0ms)\n217923: task1 (prio: 1, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n217953: os_sanity (prio: 254, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n218010: task2 (prio: 2, nw: 217709, flags: 0x3, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n\n\nprompt\nUsage: prompt [set|show] [prompt_char]\nprompt set \n\nPrompt set to: \n\n229370: \n\n\n\n\n\n\nData structures\n\n\nThis data structure is used in holding information about registered command handlers.\n\n\nstruct\n \nshell_cmd\n {\n \nchar\n \n*sc_cmd\n;\n \nshell_cmd_func_t\n \nsc_cmd_func\n;\n \nSTAILQ_ENTRY\n(\nshell_cmd\n) \nsc_next\n;\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nsc_cmd\n\n\nCharacter string of the command\n\n\n\n\n\n\nsc_cmd_func\n\n\n
Pointer to the command handler\n\n\n\n\n\n\nsc_next\n\n\nBookkeeping linkage internal for shell\n\n\n\n\n\n\n\n\nList of Functions\n\n\n\n\nThe functions available in this OS feature are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nshell_task_init\n\n\nInitializes the shell package. This creates a task for shell, and registers few commands on its own.\n\n\n\n\n\n\nshell_cmd_register\n\n\nRegisters a handler for incoming console commands.\n\n\n\n\n\n\nshell_nlip_input_register\n\n\nRegisters a handler for incoming newtmgr messages.\n\n\n\n\n\n\nshell_nlip_output\n\n\nQueue outgoing newtmgr message for transmission.",
+ "text": "Shell\n\n\nThe shell runs above the console and provides two functionalities:\n\n\n\n\nProcesses console input. \n\n\nImplements the \nnewtmgr\n line protocol over serial transport. \n\n\n\n\nThe \nsys/shell\n package implements the shell. The shell uses the OS default event queue \nfor shell events and runs in the context of the main task. An application can, optionally, \nspecify a dedicated event queue for the shell to use.\n\n\nDescription\n\n\n\n\n\n\nThe shell's first job is to direct incoming commands to other subsystems. It parses the incoming character string \ninto tokens and uses the first token to determine the subsystem command handler to call to process the command.\n\n\n\n\n\n\nSubsystems register their command handlers using the \nshell_cmd_register()\n \n function. When shell calls the command handler, it passes the other tokens as arguments.\n\n\n\n\n\n\nA few commands are currently available in the shell - \ntasks\n, \nlog\n, \necho\n, \nda
te\n and \nprompt\n.\n\n\n\n\n\n\n\n\n\n\nThe shell's second job is to handle packet framing, encoding, and decoding of newtmgr protocol messages that are\nsent over the console. The Newtmgr serial transport package (\nmgmt/newtmgr/transport/newtmgr_shell\n) \ncalls the \nshell_nlip_input_register()\n function to register a handler that the shell calls when it \nreceives newtmgr request messages.\n\n\n\n\n\n\n\n\nCreate a sim target to check out these commands available in shell.\n\n\nuser@~/dev/larva$ newt target create blinky_sim\nCreating target blinky_sim\nTarget blinky_sim successfully created!\nuser@~/dev/larva$ newt target set blinky_sim name=blinky_sim\nTarget blinky_sim successfully set name to blinky_sim\nuser@~/dev/larva$ newt target set blinky_sim arch=sim\nTarget blinky_sim successfully set arch to sim\nuser@~/dev/larva$ newt target set blinky_sim project=blinky\nTarget blinky_sim successfully set project to blinky\nuser@~/dev/larva$ newt target set blinky_sim bsp=hw/b
sp/native\nTarget blinky_sim successfully set bsp to hw/bsp/native\nuser@~/dev/larva$ newt target set blinky_sim compiler_def=debug\nTarget blinky_sim successfully set compiler_def to debug\nuser@~/dev/larva$ newt target set blinky_sim compiler=sim\nTarget blinky_sim successfully set compiler to sim\nuser@~/dev/larva$ newt target show\nblinky_sim\n arch: sim\n bsp: hw/bsp/native\n compiler: sim\n compiler_def: debug\n name: blinky_sim\n project: blinky\nuser@~/dev/larva$ newt target build blinky_sim\nBuilding target blinky_sim (project = blinky)\nCompiling case.c\nCompiling suite.c\nCompiling testutil.c\n..\n..\nBuilding project blinky\nLinking blinky.elf\nSuccessfully run!\n\nuser@~/dev/larva$ ./project/blinky/bin/blinky_sim/blinky.elf\nuart0 at /dev/ttys005\n\n\n\n\n\nOpen up a new terminal to run minicom, a text-based serial port control and terminal emulation program. Set device name to the serial port of the target. \n\n\nuser@~$ minicom -D /dev/ttys005\nWelco
me to minicom 2.7\n\nOPTIONS: \nCompiled on Nov 24 2015, 16:14:21.\nPort /dev/ttys005, 11:32:17\n\nPress Meta-Z for help on special keys\n\nlog \n174578:[0] bla\n174578:[0] bab\n\ntasks\n217809:6 tasks: \n217809: shell (prio: 3, nw: 0, flags: 0x0, ssize: 0, cswcnt: 59, tot_run_time: 0ms)\n217840: idle (prio: 255, nw: 0, flags: 0x0, ssize: 0, cswcnt: 18763, tot_run_time: 217809ms)\n217878: uart_poller (prio: 0, nw: 217819, flags: 0x0, ssize: 0, cswcnt: 18667, tot_run_time: 0ms)\n217923: task1 (prio: 1, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n217953: os_sanity (prio: 254, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n218010: task2 (prio: 2, nw: 217709, flags: 0x3, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n\n\nprompt\nUsage: prompt [set|show] [prompt_char]\nprompt set \n\nPrompt set to: \n\n229370: \n\n\n\n\n\n\nData structures\n\n\nThis data structure is used in holding information about registered command handlers.\n\n\nstruct\n
\nshell_cmd\n {\n \nchar\n \n*sc_cmd\n;\n \nshell_cmd_func_t\n \nsc_cmd_func\n;\n \nSTAILQ_ENTRY\n(\nshell_cmd\n) \nsc_next\n;\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nsc_cmd\n\n\nCharacter string of the command\n\n\n\n\n\n\nsc_cmd_func\n\n\nPointer to the command handler\n\n\n\n\n\n\nsc_next\n\n\nBookkeeping linkage internal for shell\n\n\n\n\n\n\n\n\nList of Functions\n\n\n\n\nThe functions available in this OS feature are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nshell_cmd_register\n\n\nRegisters a handler for incoming console commands.\n\n\n\n\n\n\nshell_nlip_input_register\n\n\nRegisters a handler for incoming newtmgr messages.\n\n\n\n\n\n\nshell_nlip_output\n\n\nQueue outgoing newtmgr message for transmission.\n\n\n\n\n\n\nshell_evq_set\n\n\nSpecifies a dedicated event queue for shell events.",
"title": "toc"
},
{
"location": "/os/modules/shell/shell/#shell",
- "text": "The shell is package sitting on top of console, handling 2 jobs: processing console input and implementing newtmgr line protocol over serial line. Shell runs in its own task.",
+ "text": "The shell runs above the console and provides two functionalities: Processes console input. Implements the newtmgr line protocol over serial transport. The sys/shell package implements the shell. The shell uses the OS default event queue \nfor shell events and runs in the context of the main task. An application can, optionally, \nspecify a dedicated event queue for the shell to use.",
"title": "Shell"
},
{
"location": "/os/modules/shell/shell/#description",
- "text": "Shell's first job is directing incoming commands to other subsystems. It parses the incoming character string \nand splits it into tokens. Then it looks for the subsystem to handle this command based on the first token of input. Subsystems register their command handlers using shell_cmd_register() . When shell calls the command handler, it passes the other tokens as arguments. A few commands are currently available in the shell - tasks , log , echo , date and prompt . Shell's second job is doing framing, encoding and decoding newtmgr protocol when it's carried over the console. \nProtocol handler (libs/newtmgr) registers itself using shell_nlip_input_register() , and shell calls the registered \nhandler for every frame. Outgoing frames for the protocol are sent using shell_nlip_output() . Create a sim target to check out these commands available in shell. user@~/dev/larva$ newt target create blinky_sim\nCreating target blinky_sim\nTarget
blinky_sim successfully created!\nuser@~/dev/larva$ newt target set blinky_sim name=blinky_sim\nTarget blinky_sim successfully set name to blinky_sim\nuser@~/dev/larva$ newt target set blinky_sim arch=sim\nTarget blinky_sim successfully set arch to sim\nuser@~/dev/larva$ newt target set blinky_sim project=blinky\nTarget blinky_sim successfully set project to blinky\nuser@~/dev/larva$ newt target set blinky_sim bsp=hw/bsp/native\nTarget blinky_sim successfully set bsp to hw/bsp/native\nuser@~/dev/larva$ newt target set blinky_sim compiler_def=debug\nTarget blinky_sim successfully set compiler_def to debug\nuser@~/dev/larva$ newt target set blinky_sim compiler=sim\nTarget blinky_sim successfully set compiler to sim\nuser@~/dev/larva$ newt target show\nblinky_sim\n arch: sim\n bsp: hw/bsp/native\n compiler: sim\n compiler_def: debug\n name: blinky_sim\n project: blinky\nuser@~/dev/larva$ newt target build blinky_sim\nBuilding target blinky_sim (project = blinky)\nCom
piling case.c\nCompiling suite.c\nCompiling testutil.c\n..\n..\nBuilding project blinky\nLinking blinky.elf\nSuccessfully run!\n\nuser@~/dev/larva$ ./project/blinky/bin/blinky_sim/blinky.elf\nuart0 at /dev/ttys005 Open up a new terminal to run minicom, a text-based serial port control and terminal emulation program. Set device name to the serial port of the target. user@~$ minicom -D /dev/ttys005\nWelcome to minicom 2.7\n\nOPTIONS: \nCompiled on Nov 24 2015, 16:14:21.\nPort /dev/ttys005, 11:32:17\n\nPress Meta-Z for help on special keys\n\nlog \n174578:[0] bla\n174578:[0] bab\n\ntasks\n217809:6 tasks: \n217809: shell (prio: 3, nw: 0, flags: 0x0, ssize: 0, cswcnt: 59, tot_run_time: 0ms)\n217840: idle (prio: 255, nw: 0, flags: 0x0, ssize: 0, cswcnt: 18763, tot_run_time: 217809ms)\n217878: uart_poller (prio: 0, nw: 217819, flags: 0x0, ssize: 0, cswcnt: 18667, tot_run_time: 0ms)\n217923: task1 (prio: 1, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n217953: o
s_sanity (prio: 254, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n218010: task2 (prio: 2, nw: 217709, flags: 0x3, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n\n\nprompt\nUsage: prompt [set|show] [prompt_char]\nprompt set \nPrompt set to: \n229370:",
+ "text": "The shell's first job is to direct incoming commands to other subsystems. It parses the incoming character string \ninto tokens and uses the first token to determine the subsystem command handler to call to process the command. Subsystems register their command handlers using the shell_cmd_register() \n function. When shell calls the command handler, it passes the other tokens as arguments. A few commands are currently available in the shell - tasks , log , echo , date and prompt . The shell's second job is to handle packet framing, encoding, and decoding of newtmgr protocol messages that are\nsent over the console. The Newtmgr serial transport package ( mgmt/newtmgr/transport/newtmgr_shell ) \ncalls the shell_nlip_input_register() function to register a handler that the shell calls when it \nreceives newtmgr request messages. Create a sim target to check out these commands available in shell. user@~/dev/larva$ newt target create bli
nky_sim\nCreating target blinky_sim\nTarget blinky_sim successfully created!\nuser@~/dev/larva$ newt target set blinky_sim name=blinky_sim\nTarget blinky_sim successfully set name to blinky_sim\nuser@~/dev/larva$ newt target set blinky_sim arch=sim\nTarget blinky_sim successfully set arch to sim\nuser@~/dev/larva$ newt target set blinky_sim project=blinky\nTarget blinky_sim successfully set project to blinky\nuser@~/dev/larva$ newt target set blinky_sim bsp=hw/bsp/native\nTarget blinky_sim successfully set bsp to hw/bsp/native\nuser@~/dev/larva$ newt target set blinky_sim compiler_def=debug\nTarget blinky_sim successfully set compiler_def to debug\nuser@~/dev/larva$ newt target set blinky_sim compiler=sim\nTarget blinky_sim successfully set compiler to sim\nuser@~/dev/larva$ newt target show\nblinky_sim\n arch: sim\n bsp: hw/bsp/native\n compiler: sim\n compiler_def: debug\n name: blinky_sim\n project: blinky\nuser@~/dev/larva$ newt target build blinky_sim\nBuildin
g target blinky_sim (
<TRUNCATED>
[03/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Posted by ad...@apache.org.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/modules/shell/shell_task_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/shell/shell_task_init/index.html b/latest/os/modules/shell/shell_task_init/index.html
deleted file mode 100644
index 3c99eff..0000000
--- a/latest/os/modules/shell/shell_task_init/index.html
+++ /dev/null
@@ -1,703 +0,0 @@
-<!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/modules/shell/shell_task_init/"> -->
- <link rel="shortcut icon" href="../../../../img/favicon.ico">
-
- <title>shell_task_init - 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="shell_task_init">
-
-
- <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="../../../core_os/mynewt_os/">OS Core</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../core_os/porting/port_os/">Porting to your Platform</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../console/console/">Console</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../shell/">Shell</a>
-
-
- <ul>
-
-
-
-
-
-
-
- <li><a href="
- ./
-">Functions</a>
-
-
- <ul>
-
-
-
- <li class="active">
- <a href="./">shell_task_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../shell_cmd_register/">shell_cmd_register</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../shell_nlip_output/">shell_nlip_output</a>
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../split/split/">Split Images</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../bootloader/bootloader/">Bootloader</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li><a href="
-
-
- ../../fs/fs/fs/
-
-">File System</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../hal/hal/">Hardware Abstraction Layer</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../drivers/driver/">Drivers</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../testutil/testutil/">Test Utilities</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../devmgmt/newtmgr/">Device Management with Newt Manager</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../imgmgr/imgmgr/">Image Manager</a>
-
-
- </li>
-
-
-
-
-
- <li >
- <a href="../../baselibc/">Baselibc library</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../elua/elua/">Embedded Lua</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../json/json/">JSON</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../fcb/fcb/">Flash Circular Buffer</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../stats/stats/">Stats</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../logs/logs/">Logs</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../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>» <a href="../shell/">Shell</a></li>
-
-
-
- <li>» Functions</li>
-
-
-
- <li>» shell_task_init</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="shell_task_init"><font color="F2853F" style="font-size:24pt"> shell_task_init</font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">int</span> <span style="color: #000000">shell_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</span>, <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">stack_size</span>, <span style="color: #A90D91">int</span> <span style="color: #000000">max_input_length</span>);
-</pre></div>
-
-
-<p>Initializes the shell package. This creates a task for shell, and registers a few commands on its own
-(<code>echo</code>, <code>?</code>, <code>prompt</code> for example). It also allocates memory for buffering console input.</p>
-<h4 id="arguments">Arguments</h4>
-<table>
-<thead>
-<tr>
-<th>Arguments</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>prio</code></td>
-<td>Priority of the shell task</td>
-</tr>
-<tr>
-<td><code>stack</code></td>
-<td>Pointer to shell tasks's stack</td>
-</tr>
-<tr>
-<td><code>stack_size</code></td>
-<td>Size of the aforementioned stack (in units of os_stack_t)</td>
-</tr>
-<tr>
-<td><code>max_input_length</code></td>
-<td>the maximum expected length of line for input</td>
-</tr>
-</tbody>
-</table>
-<h4 id="returned-values">Returned values</h4>
-<p>Returns 0 on success; nonzero on failure.</p>
-<h4 id="notes">Notes</h4>
-<p>You can register commands before calling this, but only if OS has not been started.</p>
-<h4 id="example">Example</h4>
-<p>Here's an example of stand-alone code which allows the user to execute regression tests for sys/config package only.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #633820">#define SHELL_TASK_PRIO (3)</span>
-<span style="color: #633820">#define SHELL_MAX_INPUT_LEN (256)</span>
-<span style="color: #633820">#define SHELL_TASK_STACK_SIZE (OS_STACK_ALIGN(384))</span>
-<span style="color: #A90D91">os_stack_t</span> <span style="color: #000000">shell_stack</span>[<span style="color: #000000">SHELL_TASK_STACK_SIZE</span>];
-
-<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">shell_task_init</span>(<span style="color: #000000">SHELL_TASK_PRIO</span>, <span style="color: #000000">shell_stack</span>, <span style="color: #000000">SHELL_TASK_STACK_SIZE</span>,
- <span style="color: #000000">SHELL_MAX_INPUT_LEN</span>);
- ....
-}
-</pre></div>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../shell/>
- <span class="fa fa-arrow-left"></span>
- Previous: Shell
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../shell_cmd_register/>
- Next: shell_cmd_register
- <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/8e70b507/latest/os/modules/split/split/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/split/split/index.html b/latest/os/modules/split/split/index.html
index f902f40..6e708ea 100644
--- a/latest/os/modules/split/split/index.html
+++ b/latest/os/modules/split/split/index.html
@@ -981,9 +981,9 @@ special loader.elf image during the link.</p>
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../shell/shell_nlip_output/>
+ <a href=../../shell/shell_evq_set/>
<span class="fa fa-arrow-left"></span>
- Previous: shell_nlip_output
+ Previous: shell_evq_set
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/modules/sysinitconfig/sysinitconfig/index.html
----------------------------------------------------------------------
diff --git a/latest/os/modules/sysinitconfig/sysinitconfig/index.html b/latest/os/modules/sysinitconfig/sysinitconfig/index.html
index 2740baf..f931b2e 100644
--- a/latest/os/modules/sysinitconfig/sysinitconfig/index.html
+++ b/latest/os/modules/sysinitconfig/sysinitconfig/index.html
@@ -907,7 +907,7 @@ You can override the <code>OS_MAIN_TASK_PRIO</code> and <code>OS_MAIN_TASK_STACK
<ul>
<li>At the start of <code>main()</code>, call the Mynewt <code>sysinit()</code> function to initialize
the packages before performing any other processing.</li>
-<li>At the end of <code>main()</code>, wait for and dispatch events from the default event queue in a forever loop. </li>
+<li>At the end of <code>main()</code>, wait for and dispatch events from the default event queue in an infinite loop. </li>
</ul>
<p><strong>Note:</strong> You must include the <code>sysinit/sysinit.h</code> header file to access the <code>sysinit()</code> function.</p>
<p>Here is an example of a <code>main()</code> function:</p>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/sitemap.xml
----------------------------------------------------------------------
diff --git a/latest/sitemap.xml b/latest/sitemap.xml
index c210311..0c120ee 100644
--- a/latest/sitemap.xml
+++ b/latest/sitemap.xml
@@ -4,7 +4,7 @@
<url>
<loc>http://mynewt.apache.org/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -13,7 +13,7 @@
<url>
<loc>http://mynewt.apache.org/pages/ble/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -22,7 +22,7 @@
<url>
<loc>http://mynewt.apache.org/quick-start/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -30,7 +30,7 @@
<url>
<loc>http://mynewt.apache.org/about/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -38,7 +38,7 @@
<url>
<loc>http://mynewt.apache.org/talks/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -46,7 +46,7 @@
<url>
<loc>http://mynewt.apache.org/download/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -54,7 +54,7 @@
<url>
<loc>http://mynewt.apache.org/community/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -62,7 +62,7 @@
<url>
<loc>http://mynewt.apache.org/events/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -71,7 +71,7 @@
<url>
<loc>http://mynewt.apache.org/os/introduction/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -83,7 +83,7 @@
<url>
<loc>http://mynewt.apache.org/os/get_started/vocabulary/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -123,13 +123,13 @@
<url>
<loc>http://mynewt.apache.org/faq/how_to_edit_docs/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>http://mynewt.apache.org/faq/answers/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/mkdocs/search_index.json
----------------------------------------------------------------------
diff --git a/mkdocs/search_index.json b/mkdocs/search_index.json
index 187a837..cf393eb 100644
--- a/mkdocs/search_index.json
+++ b/mkdocs/search_index.json
@@ -1566,56 +1566,6 @@
"title": "OS Functions"
},
{
- "location": "/os/core_os/os_init/",
- "text": "os_init\n\n\nvoid os_init(void)\n\n\n\n\n\nInitializes the OS. Must be called before the OS is started (i.e. os_start() is called).\n\n\n\n\nArguments\n\n\nNone\n\n\n\n\nReturned values\n\n\nNone\n\n\n\n\nNotes\n\n\nThe call to os_init performs architecture and bsp initializations and initializes the idle task.\n\n\nThis function does not start the OS, the OS time tick interrupt, or the scheduler.",
- "title": "os_init"
- },
- {
- "location": "/os/core_os/os_init/#os_init",
- "text": "void os_init(void) Initializes the OS. Must be called before the OS is started (i.e. os_start() is called).",
- "title": "os_init"
- },
- {
- "location": "/os/core_os/os_init/#arguments",
- "text": "None",
- "title": "Arguments"
- },
- {
- "location": "/os/core_os/os_init/#returned-values",
- "text": "None",
- "title": "Returned values"
- },
- {
- "location": "/os/core_os/os_init/#notes",
- "text": "The call to os_init performs architecture and bsp initializations and initializes the idle task. This function does not start the OS, the OS time tick interrupt, or the scheduler.",
- "title": "Notes"
- },
- {
- "location": "/os/core_os/os_start/",
- "text": "os_start\n\n\nvoid os_start(void)\n\n\n\n\n\nStarts the OS by initializing and enabling the OS time tick and starting the scheduler.\n\n\nThis function does not return.\n\n\n\n\nArguments\n\n\nNone\n\n\n\n\nReturned values\n\n\nNone (does not return).\n\n\n\n\nNotes\n\n\nOnce os_start has been called, context is switched to the highest priority task that was initialized prior to calling os_start.",
- "title": "os_start"
- },
- {
- "location": "/os/core_os/os_start/#os_start",
- "text": "void os_start(void) Starts the OS by initializing and enabling the OS time tick and starting the scheduler. This function does not return.",
- "title": "os_start"
- },
- {
- "location": "/os/core_os/os_start/#arguments",
- "text": "None",
- "title": "Arguments"
- },
- {
- "location": "/os/core_os/os_start/#returned-values",
- "text": "None (does not return).",
- "title": "Returned values"
- },
- {
- "location": "/os/core_os/os_start/#notes",
- "text": "Once os_start has been called, context is switched to the highest priority task that was initialized prior to calling os_start.",
- "title": "Notes"
- },
- {
"location": "/os/core_os/os_started/",
"text": "os_started\n\n\nint os_started(void)\n\n\n\n\n\nReturns 'true' (1) if the os has been started; 0 otherwise.\n\n\n\n\nArguments\n\n\nNone\n\n\n\n\nReturned values\n\n\nInteger value with 0 meaning the OS has not been started and 1 indicating the OS has been started (i.e. os_start() has been called).",
"title": "os_started"
@@ -4481,36 +4431,6 @@
"title": "List of Functions"
},
{
- "location": "/os/modules/shell/shell_task_init/",
- "text": "shell_task_init\n\n\nint shell_task_init(uint8_t prio, os_stack_t *stack, uint16_t stack_size,\n int max_input_length);\n\n\n\n\n\nInitializes the shell package. This creates a task for shell, and registers few commands on its own (\necho\n, \n?\n, for example). It also allocates memory for buffering console input.\n\n\nArguments\n\n\n\n\n\n\n\n\nArguments\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nprio\n\n\nPriority of the shell task\n\n\n\n\n\n\nstack\n\n\nPointer to shell tasks's stack\n\n\n\n\n\n\nstack_size\n\n\nSize of the aforementioned stack (in units of os_stack_t)\n\n\n\n\n\n\nmax_input_length\n\n\nthe maximum expected length of line for input\n\n\n\n\n\n\n\n\nReturned values\n\n\nReturns 0 on success; nonzero on failure.\n\n\nNotes\n\n\nYou can register commands before calling this, but only if OS has not been started.\n\n\nExample\n\n\nHere's an example of stand-alone code which allows the user to execute regression tests for sys/config
package only.\n\n\n#define SHELL_TASK_PRIO (3)\n#define SHELL_MAX_INPUT_LEN (256)\n#define SHELL_TASK_STACK_SIZE (OS_STACK_ALIGN(384))\nos_stack_t shell_stack[SHELL_TASK_STACK_SIZE];\n\nint\nmain(int argc, char **argv)\n{\n ....\n shell_task_init(SHELL_TASK_PRIO, shell_stack, SHELL_TASK_STACK_SIZE,\n SHELL_MAX_INPUT_LEN);\n ....\n}",
- "title": "shell_task_init"
- },
- {
- "location": "/os/modules/shell/shell_task_init/#shell_task_init",
- "text": "int shell_task_init(uint8_t prio, os_stack_t *stack, uint16_t stack_size,\n int max_input_length); Initializes the shell package. This creates a task for shell, and registers few commands on its own ( echo , ? , for example). It also allocates memory for buffering console input.",
- "title": " shell_task_init"
- },
- {
- "location": "/os/modules/shell/shell_task_init/#arguments",
- "text": "Arguments Description prio Priority of the shell task stack Pointer to shell tasks's stack stack_size Size of the aforementioned stack (in units of os_stack_t) max_input_length the maximum expected length of line for input",
- "title": "Arguments"
- },
- {
- "location": "/os/modules/shell/shell_task_init/#returned-values",
- "text": "Returns 0 on success; nonzero on failure.",
- "title": "Returned values"
- },
- {
- "location": "/os/modules/shell/shell_task_init/#notes",
- "text": "You can register commands before calling this, but only if OS has not been started.",
- "title": "Notes"
- },
- {
- "location": "/os/modules/shell/shell_task_init/#example",
- "text": "Here's an example of stand-alone code which allows the user to execute regression tests for sys/config package only. #define SHELL_TASK_PRIO (3)\n#define SHELL_MAX_INPUT_LEN (256)\n#define SHELL_TASK_STACK_SIZE (OS_STACK_ALIGN(384))\nos_stack_t shell_stack[SHELL_TASK_STACK_SIZE];\n\nint\nmain(int argc, char **argv)\n{\n ....\n shell_task_init(SHELL_TASK_PRIO, shell_stack, SHELL_TASK_STACK_SIZE,\n SHELL_MAX_INPUT_LEN);\n ....\n}",
- "title": "Example"
- },
- {
"location": "/os/modules/shell/shell_cmd_register/",
"text": "shell_cmd_register \n\n\nint shell_cmd_register(struct shell_cmd *sc)\n\n\n\n\n\nRegisters a handler for incoming console commands. Within the structure there is the command string and the handler for those commands. Caller must allocate the memory for this structure and keep it around as shell links this to its own internal data structures.\n\n\nCommand handler is of type \nint(*shell_cmd_func_t)(int argc, char **argv)\n. Command line arguments are passed to it as an array of character pointers.\n\n\nArguments\n\n\n\n\n\n\n\n\nArguments\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nsc\n\n\nStructure containing info about the command.\n\n\n\n\n\n\n\n\nReturned values\n\n\nReturns 0 on success.\nNon-zero on failure.\n\n\nExample\n\n\nstatic int fs_ls_cmd(int argc, char **argv);\n\nstatic struct shell_cmd fs_ls_struct = {\n .sc_cmd = \nls\n,\n .sc_cmd_func = fs_ls_cmd\n};\n\nvoid\nfs_cli_init(void)\n{\n shell_cmd_register(\nfs_ls_struct);\n ....\n}",
"title": "shell_cmd_register"
@@ -4586,6 +4506,31 @@
"title": "Example"
},
{
+ "location": "/os/modules/shell/shell_evq_set/",
+ "text": "shell_task_init\n\n\nvoid\n \nshell_evq_set\n(\nstruct\n \nos_eventq\n \n*evq\n)\n\n\n\n\n\nSpecifies an event queue to use for shell events. You must create the event queue \nand the task to process events from the queue before calling this function. \n\n\nBy default, shell uses the OS default event queue and executes in the context\nof the main task that Mynewt creates.\n\n\nArguments\n\n\n\n\n\n\n\n\nArguments\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nevq\n\n\nPointer to the event queue to use for shell events.\n\n\n\n\n\n\n\n\nReturned values\n\n\nNone\n\n\nNotes",
+ "title": "shell_evq_set"
+ },
+ {
+ "location": "/os/modules/shell/shell_evq_set/#shell_task_init",
+ "text": "void shell_evq_set ( struct os_eventq *evq ) Specifies an event queue to use for shell events. You must create the event queue \nand the task to process events from the queue before calling this function. By default, shell uses the OS default event queue and executes in the context\nof the main task that Mynewt creates.",
+ "title": " shell_task_init"
+ },
+ {
+ "location": "/os/modules/shell/shell_evq_set/#arguments",
+ "text": "Arguments Description evq Pointer to the event queue to use for shell events.",
+ "title": "Arguments"
+ },
+ {
+ "location": "/os/modules/shell/shell_evq_set/#returned-values",
+ "text": "None",
+ "title": "Returned values"
+ },
+ {
+ "location": "/os/modules/shell/shell_evq_set/#notes",
+ "text": "",
+ "title": "Notes"
+ },
+ {
"location": "/os/modules/bootloader/bootloader/",
"text": "Bootloader\n\n\nInsert synopsis here\n\n\nDescription\n\n\nDescribe module here, special features, how pieces fit together etc.\n\n\nData structures\n\n\nReplace this with the list of data structures used, why, any neat features\n\n\nList of Functions\n\n\n\n\nThe functions available in bootloader are:\n\n\n\n\nboot_build_status\n\n\nboot_build_status_one\n\n\nboot_clear_status\n\n\nboot_copy_area\n\n\nboot_copy_image\n\n\nboot_erase_area\n\n\nboot_fill_slot\n\n\nboot_find_image_area_idx\n\n\nboot_find_image_part\n\n\nboot_find_image_slot\n\n\nboot_go\n\n\nboot_init_flash\n\n\nboot_move_area\n\n\nboot_read_image_header\n\n\nboot_read_image_headers\n\n\nboot_read_status\n\n\nboot_select_image_slot\n\n\nboot_slot_addr\n\n\nboot_slot_to_area_idx\n\n\nboot_swap_areas\n\n\nboot_vect_delete_main\n\n\nboot_vect_delete_test\n\n\nboot_vect_read_main\n\n\nboot_vect_read_one\n\n\nboot_vect_read_test\n\n\nboot_write_status",
"title": "toc"
@@ -6261,36 +6206,6 @@
"title": "List of Functions"
},
{
- "location": "/os/modules/imgmgr/imgmgr_module_init/",
- "text": "imgmgr_module_init \n\n\n int\n imgmgr_module_init(void)\n\n\n\n\n\nRegisters image manager commands with newtmgr. This function should be called while initializing the project, preferably after newtmgr itself has been initialized.\n\n\nArguments\n\n\nN/A\n\n\nReturned values\n\n\nList any values returned.\nError codes?\n\n\nNotes\n\n\nExample\n\n\nint main(int argc, char **argv)\n{\n ...\n\n nmgr_task_init(NEWTMGR_TASK_PRIO, newtmgr_stack, NEWTMGR_TASK_STACK_SIZE);\n imgmgr_module_init();\n\n ...\n}",
- "title": "imgmgr_module_init"
- },
- {
- "location": "/os/modules/imgmgr/imgmgr_module_init/#imgmgr_module_init",
- "text": "int\n imgmgr_module_init(void) Registers image manager commands with newtmgr. This function should be called while initializing the project, preferably after newtmgr itself has been initialized.",
- "title": " imgmgr_module_init "
- },
- {
- "location": "/os/modules/imgmgr/imgmgr_module_init/#arguments",
- "text": "N/A",
- "title": "Arguments"
- },
- {
- "location": "/os/modules/imgmgr/imgmgr_module_init/#returned-values",
- "text": "List any values returned.\nError codes?",
- "title": "Returned values"
- },
- {
- "location": "/os/modules/imgmgr/imgmgr_module_init/#notes",
- "text": "",
- "title": "Notes"
- },
- {
- "location": "/os/modules/imgmgr/imgmgr_module_init/#example",
- "text": "int main(int argc, char **argv)\n{\n ...\n\n nmgr_task_init(NEWTMGR_TASK_PRIO, newtmgr_stack, NEWTMGR_TASK_STACK_SIZE);\n imgmgr_module_init();\n\n ...\n}",
- "title": "Example"
- },
- {
"location": "/os/modules/imgmgr/imgr_ver_parse/",
"text": "imgr_ver_parse \n\n\n int\n imgr_ver_parse(char *src, struct image_version *ver)\n\n\n\n\n\nParses character string containing image version number \nsrc\n and writes that to \nver\n. Version number string should be in format \n.\n.\n.\n. Major and minor numbers should be within range 0-255, revision between 0-65535 and build_number 0-4294967295.\n\n\nArguments\n\n\n\n\n\n\n\n\nArguments\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nsrc\n\n\nPointer to C string that contains version number being parsed\n\n\n\n\n\n\nver\n\n\nImage version number structure containing the returned value\n\n\n\n\n\n\n\n\nReturned values\n\n\n0 on success and \n0 if version number string could not be parsed.\n\n\nNotes\n\n\nNumbers within the string are separated by \n.\n. The first number is the major number, and must be provided. Rest of the numbers (minor etc.) are optional.\n\n\nExample\n\n\nint main(int argc, char **argv)\n{\n struct image_version hdr_ver;\n int rc;\n ...
\n\n rc = imgr_ver_parse(argv[3], \nhdr_ver);\n if (rc != 0) {\n print_usage(stderr);\n return 1;\n }\n ...\n}",
"title": "imgr_ver_parse"
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/callout/callout/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/callout/callout/index.html b/os/core_os/callout/callout/index.html
index 020d81d..6dd2d6d 100644
--- a/os/core_os/callout/callout/index.html
+++ b/os/core_os/callout/callout/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/callout/os_callout_func_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/callout/os_callout_func_init/index.html b/os/core_os/callout/os_callout_func_init/index.html
index becc1e2..9d567b9 100644
--- a/os/core_os/callout/os_callout_func_init/index.html
+++ b/os/core_os/callout/os_callout_func_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/callout/os_callout_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/callout/os_callout_init/index.html b/os/core_os/callout/os_callout_init/index.html
index 72b22d0..ccbf36b 100644
--- a/os/core_os/callout/os_callout_init/index.html
+++ b/os/core_os/callout/os_callout_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/callout/os_callout_queued/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/callout/os_callout_queued/index.html b/os/core_os/callout/os_callout_queued/index.html
index ef99ee3..c9c7d12 100644
--- a/os/core_os/callout/os_callout_queued/index.html
+++ b/os/core_os/callout/os_callout_queued/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/callout/os_callout_reset/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/callout/os_callout_reset/index.html b/os/core_os/callout/os_callout_reset/index.html
index cee83dd..49a78bd 100644
--- a/os/core_os/callout/os_callout_reset/index.html
+++ b/os/core_os/callout/os_callout_reset/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/callout/os_callout_stop/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/callout/os_callout_stop/index.html b/os/core_os/callout/os_callout_stop/index.html
index f84107d..699a7f5 100644
--- a/os/core_os/callout/os_callout_stop/index.html
+++ b/os/core_os/callout/os_callout_stop/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/context_switch/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/context_switch/index.html b/os/core_os/context_switch/context_switch/index.html
index 6425cf2..37aa6fd 100644
--- a/os/core_os/context_switch/context_switch/index.html
+++ b/os/core_os/context_switch/context_switch/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_arch_ctx_sw/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_arch_ctx_sw/index.html b/os/core_os/context_switch/os_arch_ctx_sw/index.html
index ff2f827..7e34c88 100644
--- a/os/core_os/context_switch/os_arch_ctx_sw/index.html
+++ b/os/core_os/context_switch/os_arch_ctx_sw/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_sched/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_sched/index.html b/os/core_os/context_switch/os_sched/index.html
index 634b8a2..84c3891 100644
--- a/os/core_os/context_switch/os_sched/index.html
+++ b/os/core_os/context_switch/os_sched/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html b/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
index acad98a..f061eb8 100644
--- a/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
+++ b/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_sched_get_current_task/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_sched_get_current_task/index.html b/os/core_os/context_switch/os_sched_get_current_task/index.html
index af5753a..db57fea 100644
--- a/os/core_os/context_switch/os_sched_get_current_task/index.html
+++ b/os/core_os/context_switch/os_sched_get_current_task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_sched_insert/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_sched_insert/index.html b/os/core_os/context_switch/os_sched_insert/index.html
index 80646fe..8f1f310 100644
--- a/os/core_os/context_switch/os_sched_insert/index.html
+++ b/os/core_os/context_switch/os_sched_insert/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_sched_next_task/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_sched_next_task/index.html b/os/core_os/context_switch/os_sched_next_task/index.html
index 1645ba1..537417e 100644
--- a/os/core_os/context_switch/os_sched_next_task/index.html
+++ b/os/core_os/context_switch/os_sched_next_task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_sched_os_timer_exp/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_sched_os_timer_exp/index.html b/os/core_os/context_switch/os_sched_os_timer_exp/index.html
index a31ea58..89c223b 100644
--- a/os/core_os/context_switch/os_sched_os_timer_exp/index.html
+++ b/os/core_os/context_switch/os_sched_os_timer_exp/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_sched_resort/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_sched_resort/index.html b/os/core_os/context_switch/os_sched_resort/index.html
index 2b27988..53f9f5d 100644
--- a/os/core_os/context_switch/os_sched_resort/index.html
+++ b/os/core_os/context_switch/os_sched_resort/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_sched_set_current_task/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_sched_set_current_task/index.html b/os/core_os/context_switch/os_sched_set_current_task/index.html
index f20d5e6..6f0f0b0 100644
--- a/os/core_os/context_switch/os_sched_set_current_task/index.html
+++ b/os/core_os/context_switch/os_sched_set_current_task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_sched_sleep/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_sched_sleep/index.html b/os/core_os/context_switch/os_sched_sleep/index.html
index 4fd4654..5ee4836 100644
--- a/os/core_os/context_switch/os_sched_sleep/index.html
+++ b/os/core_os/context_switch/os_sched_sleep/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/context_switch/os_sched_wakeup/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/context_switch/os_sched_wakeup/index.html b/os/core_os/context_switch/os_sched_wakeup/index.html
index 7edd2c4..42f6385 100644
--- a/os/core_os/context_switch/os_sched_wakeup/index.html
+++ b/os/core_os/context_switch/os_sched_wakeup/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/event_queue/event_queue/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/event_queue/event_queue/index.html b/os/core_os/event_queue/event_queue/index.html
index 54c34b6..a7c94c5 100644
--- a/os/core_os/event_queue/event_queue/index.html
+++ b/os/core_os/event_queue/event_queue/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/event_queue/os_eventq_get/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/event_queue/os_eventq_get/index.html b/os/core_os/event_queue/os_eventq_get/index.html
index 79f665b..2e39a29 100644
--- a/os/core_os/event_queue/os_eventq_get/index.html
+++ b/os/core_os/event_queue/os_eventq_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/event_queue/os_eventq_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/event_queue/os_eventq_init/index.html b/os/core_os/event_queue/os_eventq_init/index.html
index 6133468..c9b6cc8 100644
--- a/os/core_os/event_queue/os_eventq_init/index.html
+++ b/os/core_os/event_queue/os_eventq_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/event_queue/os_eventq_put/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/event_queue/os_eventq_put/index.html b/os/core_os/event_queue/os_eventq_put/index.html
index e01620a..1648a48 100644
--- a/os/core_os/event_queue/os_eventq_put/index.html
+++ b/os/core_os/event_queue/os_eventq_put/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/event_queue/os_eventq_remove/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/event_queue/os_eventq_remove/index.html b/os/core_os/event_queue/os_eventq_remove/index.html
index 821b6ed..a34b7b6 100644
--- a/os/core_os/event_queue/os_eventq_remove/index.html
+++ b/os/core_os/event_queue/os_eventq_remove/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/heap/heap/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/heap/heap/index.html b/os/core_os/heap/heap/index.html
index feff5dd..1a52acc 100644
--- a/os/core_os/heap/heap/index.html
+++ b/os/core_os/heap/heap/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/heap/os_free/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/heap/os_free/index.html b/os/core_os/heap/os_free/index.html
index 7fc8315..646f3a2 100644
--- a/os/core_os/heap/os_free/index.html
+++ b/os/core_os/heap/os_free/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/heap/os_malloc/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/heap/os_malloc/index.html b/os/core_os/heap/os_malloc/index.html
index a1cfc1f..bc693fb 100644
--- a/os/core_os/heap/os_malloc/index.html
+++ b/os/core_os/heap/os_malloc/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/heap/os_realloc/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/heap/os_realloc/index.html b/os/core_os/heap/os_realloc/index.html
index 1ab3206..7f3ea1d 100644
--- a/os/core_os/heap/os_realloc/index.html
+++ b/os/core_os/heap/os_realloc/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/OS_MBUF_DATA/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/OS_MBUF_DATA/index.html b/os/core_os/mbuf/OS_MBUF_DATA/index.html
index 6b5549d..c79de36 100644
--- a/os/core_os/mbuf/OS_MBUF_DATA/index.html
+++ b/os/core_os/mbuf/OS_MBUF_DATA/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html b/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
index 14d9d6f..a6449a5 100644
--- a/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
+++ b/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html b/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
index 5bd2bf6..14bf708 100644
--- a/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
+++ b/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html b/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
index 5c4bc17..e2936f8 100644
--- a/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
+++ b/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html b/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
index ef36761..1e8e7b6 100644
--- a/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
+++ b/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html b/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
index ae3a77d..5bbcb61 100644
--- a/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
+++ b/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/OS_MBUF_USRHDR/index.html b/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
index 2231589..ba87cfa 100644
--- a/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
+++ b/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html b/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
index f66d5ce..9828c28 100644
--- a/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
+++ b/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/mbuf/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/mbuf/index.html b/os/core_os/mbuf/mbuf/index.html
index ebd8742..a091d0a 100644
--- a/os/core_os/mbuf/mbuf/index.html
+++ b/os/core_os/mbuf/mbuf/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_adj/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_adj/index.html b/os/core_os/mbuf/os_mbuf_adj/index.html
index a939a12..452fe47 100644
--- a/os/core_os/mbuf/os_mbuf_adj/index.html
+++ b/os/core_os/mbuf/os_mbuf_adj/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_append/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_append/index.html b/os/core_os/mbuf/os_mbuf_append/index.html
index 0a723a5..a507b67 100644
--- a/os/core_os/mbuf/os_mbuf_append/index.html
+++ b/os/core_os/mbuf/os_mbuf_append/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_concat/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_concat/index.html b/os/core_os/mbuf/os_mbuf_concat/index.html
index f903017..c75fbd5 100644
--- a/os/core_os/mbuf/os_mbuf_concat/index.html
+++ b/os/core_os/mbuf/os_mbuf_concat/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_copydata/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_copydata/index.html b/os/core_os/mbuf/os_mbuf_copydata/index.html
index 39d0996..8af8985 100644
--- a/os/core_os/mbuf/os_mbuf_copydata/index.html
+++ b/os/core_os/mbuf/os_mbuf_copydata/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_copyinto/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_copyinto/index.html b/os/core_os/mbuf/os_mbuf_copyinto/index.html
index 997db0e..7a7723f 100644
--- a/os/core_os/mbuf/os_mbuf_copyinto/index.html
+++ b/os/core_os/mbuf/os_mbuf_copyinto/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_dup/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_dup/index.html b/os/core_os/mbuf/os_mbuf_dup/index.html
index 36d8942..b9e0786 100644
--- a/os/core_os/mbuf/os_mbuf_dup/index.html
+++ b/os/core_os/mbuf/os_mbuf_dup/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_extend/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_extend/index.html b/os/core_os/mbuf/os_mbuf_extend/index.html
index 11d2173..612dbe7 100644
--- a/os/core_os/mbuf/os_mbuf_extend/index.html
+++ b/os/core_os/mbuf/os_mbuf_extend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_free_chain/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_free_chain/index.html b/os/core_os/mbuf/os_mbuf_free_chain/index.html
index 4ecf821..df21693 100644
--- a/os/core_os/mbuf/os_mbuf_free_chain/index.html
+++ b/os/core_os/mbuf/os_mbuf_free_chain/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_get/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_get/index.html b/os/core_os/mbuf/os_mbuf_get/index.html
index 5267854..e5ed8e4 100644
--- a/os/core_os/mbuf/os_mbuf_get/index.html
+++ b/os/core_os/mbuf/os_mbuf_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html b/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
index 77828ac..e300ef4 100644
--- a/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
+++ b/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_memcmp/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_memcmp/index.html b/os/core_os/mbuf/os_mbuf_memcmp/index.html
index 00c7f13..0966dc0 100644
--- a/os/core_os/mbuf/os_mbuf_memcmp/index.html
+++ b/os/core_os/mbuf/os_mbuf_memcmp/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_off/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_off/index.html b/os/core_os/mbuf/os_mbuf_off/index.html
index 3b1fd52..1f7774d 100644
--- a/os/core_os/mbuf/os_mbuf_off/index.html
+++ b/os/core_os/mbuf/os_mbuf_off/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_pool_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_pool_init/index.html b/os/core_os/mbuf/os_mbuf_pool_init/index.html
index 46e92db..3cf06c6 100644
--- a/os/core_os/mbuf/os_mbuf_pool_init/index.html
+++ b/os/core_os/mbuf/os_mbuf_pool_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_prepend/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_prepend/index.html b/os/core_os/mbuf/os_mbuf_prepend/index.html
index 215ae04..453edd1 100644
--- a/os/core_os/mbuf/os_mbuf_prepend/index.html
+++ b/os/core_os/mbuf/os_mbuf_prepend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mbuf/os_mbuf_pullup/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/os_mbuf_pullup/index.html b/os/core_os/mbuf/os_mbuf_pullup/index.html
index 567d2fc..e5d28f8 100644
--- a/os/core_os/mbuf/os_mbuf_pullup/index.html
+++ b/os/core_os/mbuf/os_mbuf_pullup/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html b/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
index 220b49a..617ee88 100644
--- a/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
+++ b/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html b/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
index 3efe250..96821ca 100644
--- a/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
+++ b/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/memory_pool/memory_pool/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/memory_pool/memory_pool/index.html b/os/core_os/memory_pool/memory_pool/index.html
index 6c199ad..6a90bb3 100644
--- a/os/core_os/memory_pool/memory_pool/index.html
+++ b/os/core_os/memory_pool/memory_pool/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/memory_pool/os_memblock_get/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/memory_pool/os_memblock_get/index.html b/os/core_os/memory_pool/os_memblock_get/index.html
index f8f8ae3..eaf780c 100644
--- a/os/core_os/memory_pool/os_memblock_get/index.html
+++ b/os/core_os/memory_pool/os_memblock_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/memory_pool/os_memblock_put/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/memory_pool/os_memblock_put/index.html b/os/core_os/memory_pool/os_memblock_put/index.html
index 3a6545e..1a34987 100644
--- a/os/core_os/memory_pool/os_memblock_put/index.html
+++ b/os/core_os/memory_pool/os_memblock_put/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/memory_pool/os_mempool_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/memory_pool/os_mempool_init/index.html b/os/core_os/memory_pool/os_mempool_init/index.html
index 3cff372..e967b25 100644
--- a/os/core_os/memory_pool/os_mempool_init/index.html
+++ b/os/core_os/memory_pool/os_mempool_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mqueue/mqueue/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mqueue/mqueue/index.html b/os/core_os/mqueue/mqueue/index.html
index 8c9c4e3..1b436fd 100644
--- a/os/core_os/mqueue/mqueue/index.html
+++ b/os/core_os/mqueue/mqueue/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mqueue/os_mqueue_get/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mqueue/os_mqueue_get/index.html b/os/core_os/mqueue/os_mqueue_get/index.html
index fb16767..94483be 100644
--- a/os/core_os/mqueue/os_mqueue_get/index.html
+++ b/os/core_os/mqueue/os_mqueue_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mqueue/os_mqueue_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mqueue/os_mqueue_init/index.html b/os/core_os/mqueue/os_mqueue_init/index.html
index bca29d8..80d3a27 100644
--- a/os/core_os/mqueue/os_mqueue_init/index.html
+++ b/os/core_os/mqueue/os_mqueue_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mqueue/os_mqueue_put/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mqueue/os_mqueue_put/index.html b/os/core_os/mqueue/os_mqueue_put/index.html
index dec521d..54f3ef2 100644
--- a/os/core_os/mqueue/os_mqueue_put/index.html
+++ b/os/core_os/mqueue/os_mqueue_put/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/msys/msys/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/msys/msys/index.html b/os/core_os/msys/msys/index.html
index abd466a..91cd191 100644
--- a/os/core_os/msys/msys/index.html
+++ b/os/core_os/msys/msys/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/msys/os_msys_get/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/msys/os_msys_get/index.html b/os/core_os/msys/os_msys_get/index.html
index c77d032..0ef7030 100644
--- a/os/core_os/msys/os_msys_get/index.html
+++ b/os/core_os/msys/os_msys_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/msys/os_msys_get_pkthdr/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/msys/os_msys_get_pkthdr/index.html b/os/core_os/msys/os_msys_get_pkthdr/index.html
index 58d9dc8..042ad69 100644
--- a/os/core_os/msys/os_msys_get_pkthdr/index.html
+++ b/os/core_os/msys/os_msys_get_pkthdr/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/msys/os_msys_register/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/msys/os_msys_register/index.html b/os/core_os/msys/os_msys_register/index.html
index c388504..4a62a5d 100644
--- a/os/core_os/msys/os_msys_register/index.html
+++ b/os/core_os/msys/os_msys_register/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/msys/os_msys_reset/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/msys/os_msys_reset/index.html b/os/core_os/msys/os_msys_reset/index.html
index 25267a9..93ad989 100644
--- a/os/core_os/msys/os_msys_reset/index.html
+++ b/os/core_os/msys/os_msys_reset/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mutex/mutex/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mutex/mutex/index.html b/os/core_os/mutex/mutex/index.html
index 05c8464..2732958 100644
--- a/os/core_os/mutex/mutex/index.html
+++ b/os/core_os/mutex/mutex/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mutex/os_mutex_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mutex/os_mutex_init/index.html b/os/core_os/mutex/os_mutex_init/index.html
index f7734aa..9f1a31a 100644
--- a/os/core_os/mutex/os_mutex_init/index.html
+++ b/os/core_os/mutex/os_mutex_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mutex/os_mutex_pend/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mutex/os_mutex_pend/index.html b/os/core_os/mutex/os_mutex_pend/index.html
index 66afee7..775c795 100644
--- a/os/core_os/mutex/os_mutex_pend/index.html
+++ b/os/core_os/mutex/os_mutex_pend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mutex/os_mutex_release/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mutex/os_mutex_release/index.html b/os/core_os/mutex/os_mutex_release/index.html
index cd3e257..7cd6956 100644
--- a/os/core_os/mutex/os_mutex_release/index.html
+++ b/os/core_os/mutex/os_mutex_release/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/mynewt_os/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mynewt_os/index.html b/os/core_os/mynewt_os/index.html
index 4acd0e5..fdf23ae 100644
--- a/os/core_os/mynewt_os/index.html
+++ b/os/core_os/mynewt_os/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../os_init/
-">System-level Functions</a>
+ ../os_started/
+">Functions</a>
</li>
@@ -784,8 +784,8 @@ main(void)
<h3 id="os-functions">OS Functions</h3>
<p>The functions available at the OS level are:</p>
<ul>
-<li><a href="../os_init/">os_init</a></li>
-<li><a href="../os_start/">os_start</a></li>
+<li><a href="os_init.md">os_init</a></li>
+<li><a href="os_start.md">os_start</a></li>
<li><a href="../os_started/">os_started</a></li>
</ul>
@@ -805,8 +805,8 @@ main(void)
</li>
<li class="pull-right">
- <a href=../os_init/>
- Next: os_init
+ <a href=../os_started/>
+ Next: os_started
<span class="fa fa-arrow-right"></span>
</a>
[11/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Posted by ad...@apache.org.
Updated the docs for new system startup and initialization implementation - Author:cwanda
Project: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/commit/8e70b507
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/8e70b507
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/8e70b507
Branch: refs/heads/asf-site
Commit: 8e70b507d5dda60822b85c1c74da2fae1e0b4126
Parents: 637e3d8
Author: aditihilbert <ad...@runtime.io>
Authored: Wed Feb 8 07:23:09 2017 -0800
Committer: aditihilbert <ad...@runtime.io>
Committed: Wed Feb 8 07:23:09 2017 -0800
----------------------------------------------------------------------
develop/mkdocs/search_index.json | 164 +---
develop/os/core_os/callout/callout/index.html | 4 +-
.../callout/os_callout_func_init/index.html | 4 +-
.../core_os/callout/os_callout_init/index.html | 4 +-
.../callout/os_callout_queued/index.html | 4 +-
.../core_os/callout/os_callout_reset/index.html | 4 +-
.../core_os/callout/os_callout_stop/index.html | 4 +-
.../context_switch/context_switch/index.html | 4 +-
.../context_switch/os_arch_ctx_sw/index.html | 4 +-
.../core_os/context_switch/os_sched/index.html | 4 +-
.../os_sched_ctx_sw_hook/index.html | 4 +-
.../os_sched_get_current_task/index.html | 4 +-
.../context_switch/os_sched_insert/index.html | 4 +-
.../os_sched_next_task/index.html | 4 +-
.../os_sched_os_timer_exp/index.html | 4 +-
.../context_switch/os_sched_resort/index.html | 4 +-
.../os_sched_set_current_task/index.html | 4 +-
.../context_switch/os_sched_sleep/index.html | 4 +-
.../context_switch/os_sched_wakeup/index.html | 4 +-
.../core_os/event_queue/event_queue/index.html | 4 +-
.../event_queue/os_eventq_dflt_get/index.html | 4 +-
.../event_queue/os_eventq_dflt_set/index.html | 4 +-
.../event_queue/os_eventq_get/index.html | 4 +-
.../event_queue/os_eventq_init/index.html | 4 +-
.../event_queue/os_eventq_inited/index.html | 4 +-
.../event_queue/os_eventq_put/index.html | 4 +-
.../event_queue/os_eventq_remove/index.html | 4 +-
develop/os/core_os/heap/heap/index.html | 4 +-
develop/os/core_os/heap/os_free/index.html | 4 +-
develop/os/core_os/heap/os_malloc/index.html | 4 +-
develop/os/core_os/heap/os_realloc/index.html | 4 +-
develop/os/core_os/mbuf/OS_MBUF_DATA/index.html | 4 +-
.../mbuf/OS_MBUF_LEADINGSPACE/index.html | 4 +-
.../os/core_os/mbuf/OS_MBUF_PKTHDR/index.html | 4 +-
.../mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html | 4 +-
.../os/core_os/mbuf/OS_MBUF_PKTLEN/index.html | 4 +-
.../mbuf/OS_MBUF_TRAILINGSPACE/index.html | 4 +-
.../os/core_os/mbuf/OS_MBUF_USRHDR/index.html | 4 +-
.../core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html | 4 +-
develop/os/core_os/mbuf/mbuf/index.html | 4 +-
develop/os/core_os/mbuf/os_mbuf_adj/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_append/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_concat/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_copydata/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_copyinto/index.html | 4 +-
develop/os/core_os/mbuf/os_mbuf_dup/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_extend/index.html | 4 +-
.../core_os/mbuf/os_mbuf_free_chain/index.html | 4 +-
develop/os/core_os/mbuf/os_mbuf_get/index.html | 4 +-
.../core_os/mbuf/os_mbuf_get_pkthdr/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_memcmp/index.html | 4 +-
develop/os/core_os/mbuf/os_mbuf_off/index.html | 4 +-
.../core_os/mbuf/os_mbuf_pool_init/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_prepend/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_pullup/index.html | 4 +-
.../memory_pool/OS_MEMPOOL_BYTES/index.html | 4 +-
.../memory_pool/OS_MEMPOOL_SIZE/index.html | 4 +-
.../core_os/memory_pool/memory_pool/index.html | 4 +-
.../memory_pool/os_memblock_get/index.html | 4 +-
.../memory_pool/os_memblock_put/index.html | 4 +-
.../memory_pool/os_mempool_init/index.html | 4 +-
develop/os/core_os/mqueue/mqueue/index.html | 4 +-
.../os/core_os/mqueue/os_mqueue_get/index.html | 4 +-
.../os/core_os/mqueue/os_mqueue_init/index.html | 4 +-
.../os/core_os/mqueue/os_mqueue_put/index.html | 4 +-
develop/os/core_os/msys/msys/index.html | 4 +-
develop/os/core_os/msys/os_msys_get/index.html | 4 +-
.../core_os/msys/os_msys_get_pkthdr/index.html | 4 +-
.../os/core_os/msys/os_msys_register/index.html | 4 +-
.../os/core_os/msys/os_msys_reset/index.html | 4 +-
develop/os/core_os/mutex/mutex/index.html | 4 +-
.../os/core_os/mutex/os_mutex_init/index.html | 4 +-
.../os/core_os/mutex/os_mutex_pend/index.html | 4 +-
.../core_os/mutex/os_mutex_release/index.html | 4 +-
develop/os/core_os/mynewt_os/index.html | 75 +-
develop/os/core_os/os_init/index.html | 783 -------------------
develop/os/core_os/os_start/index.html | 783 -------------------
develop/os/core_os/os_started/index.html | 26 +-
.../sanity/os_sanity_check_init/index.html | 4 +-
.../sanity/os_sanity_check_register/index.html | 4 +-
.../sanity/os_sanity_check_reset/index.html | 4 +-
.../sanity/os_sanity_task_checkin/index.html | 4 +-
.../sanity/os_sanity_task_init/index.html | 4 +-
develop/os/core_os/sanity/sanity/index.html | 4 +-
.../os/core_os/semaphore/os_sem_init/index.html | 4 +-
.../os/core_os/semaphore/os_sem_pend/index.html | 4 +-
.../core_os/semaphore/os_sem_release/index.html | 4 +-
.../os/core_os/semaphore/semaphore/index.html | 4 +-
.../os/core_os/task/os_task_count/index.html | 4 +-
.../task/os_task_info_get_next/index.html | 4 +-
develop/os/core_os/task/os_task_init/index.html | 4 +-
develop/os/core_os/task/task/index.html | 24 +-
.../os/core_os/time/os_gettimeofday/index.html | 4 +-
.../os/core_os/time/os_settimeofday/index.html | 4 +-
develop/os/core_os/time/os_time/index.html | 4 +-
.../os/core_os/time/os_time_delay/index.html | 4 +-
develop/os/core_os/time/os_time_get/index.html | 4 +-
develop/os/core_os/time/os_time_tick/index.html | 4 +-
develop/os/modules/console/console/index.html | 91 ++-
develop/os/modules/imgmgr/imgmgr/index.html | 10 +-
.../imgmgr/imgmgr_module_init/index.html | 654 ----------------
.../os/modules/imgmgr/imgr_ver_parse/index.html | 16 +-
.../os/modules/imgmgr/imgr_ver_str/index.html | 12 +-
develop/os/modules/shell/shell/index.html | 38 +-
.../modules/shell/shell_cmd_register/index.html | 20 +-
.../os/modules/shell/shell_evq_set/index.html | 676 ++++++++++++++++
.../shell/shell_nlip_input_register/index.html | 16 +-
.../modules/shell/shell_nlip_output/index.html | 20 +-
.../os/modules/shell/shell_task_init/index.html | 703 -----------------
develop/os/modules/split/split/index.html | 4 +-
.../sysinitconfig/sysinitconfig/index.html | 2 +-
develop/sitemap.xml | 24 +-
latest/mkdocs/search_index.json | 164 +---
latest/os/core_os/callout/callout/index.html | 4 +-
.../callout/os_callout_func_init/index.html | 4 +-
.../core_os/callout/os_callout_init/index.html | 4 +-
.../callout/os_callout_queued/index.html | 4 +-
.../core_os/callout/os_callout_reset/index.html | 4 +-
.../core_os/callout/os_callout_stop/index.html | 4 +-
.../context_switch/context_switch/index.html | 4 +-
.../context_switch/os_arch_ctx_sw/index.html | 4 +-
.../core_os/context_switch/os_sched/index.html | 4 +-
.../os_sched_ctx_sw_hook/index.html | 4 +-
.../os_sched_get_current_task/index.html | 4 +-
.../context_switch/os_sched_insert/index.html | 4 +-
.../os_sched_next_task/index.html | 4 +-
.../os_sched_os_timer_exp/index.html | 4 +-
.../context_switch/os_sched_resort/index.html | 4 +-
.../os_sched_set_current_task/index.html | 4 +-
.../context_switch/os_sched_sleep/index.html | 4 +-
.../context_switch/os_sched_wakeup/index.html | 4 +-
.../core_os/event_queue/event_queue/index.html | 4 +-
.../event_queue/os_eventq_dflt_get/index.html | 4 +-
.../event_queue/os_eventq_dflt_set/index.html | 4 +-
.../event_queue/os_eventq_get/index.html | 4 +-
.../event_queue/os_eventq_init/index.html | 4 +-
.../event_queue/os_eventq_inited/index.html | 4 +-
.../event_queue/os_eventq_put/index.html | 4 +-
.../event_queue/os_eventq_remove/index.html | 4 +-
latest/os/core_os/heap/heap/index.html | 4 +-
latest/os/core_os/heap/os_free/index.html | 4 +-
latest/os/core_os/heap/os_malloc/index.html | 4 +-
latest/os/core_os/heap/os_realloc/index.html | 4 +-
latest/os/core_os/mbuf/OS_MBUF_DATA/index.html | 4 +-
.../mbuf/OS_MBUF_LEADINGSPACE/index.html | 4 +-
.../os/core_os/mbuf/OS_MBUF_PKTHDR/index.html | 4 +-
.../mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html | 4 +-
.../os/core_os/mbuf/OS_MBUF_PKTLEN/index.html | 4 +-
.../mbuf/OS_MBUF_TRAILINGSPACE/index.html | 4 +-
.../os/core_os/mbuf/OS_MBUF_USRHDR/index.html | 4 +-
.../core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html | 4 +-
latest/os/core_os/mbuf/mbuf/index.html | 4 +-
latest/os/core_os/mbuf/os_mbuf_adj/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_append/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_concat/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_copydata/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_copyinto/index.html | 4 +-
latest/os/core_os/mbuf/os_mbuf_dup/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_extend/index.html | 4 +-
.../core_os/mbuf/os_mbuf_free_chain/index.html | 4 +-
latest/os/core_os/mbuf/os_mbuf_get/index.html | 4 +-
.../core_os/mbuf/os_mbuf_get_pkthdr/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_memcmp/index.html | 4 +-
latest/os/core_os/mbuf/os_mbuf_off/index.html | 4 +-
.../core_os/mbuf/os_mbuf_pool_init/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_prepend/index.html | 4 +-
.../os/core_os/mbuf/os_mbuf_pullup/index.html | 4 +-
.../memory_pool/OS_MEMPOOL_BYTES/index.html | 4 +-
.../memory_pool/OS_MEMPOOL_SIZE/index.html | 4 +-
.../core_os/memory_pool/memory_pool/index.html | 4 +-
.../memory_pool/os_memblock_get/index.html | 4 +-
.../memory_pool/os_memblock_put/index.html | 4 +-
.../memory_pool/os_mempool_init/index.html | 4 +-
latest/os/core_os/mqueue/mqueue/index.html | 4 +-
.../os/core_os/mqueue/os_mqueue_get/index.html | 4 +-
.../os/core_os/mqueue/os_mqueue_init/index.html | 4 +-
.../os/core_os/mqueue/os_mqueue_put/index.html | 4 +-
latest/os/core_os/msys/msys/index.html | 4 +-
latest/os/core_os/msys/os_msys_get/index.html | 4 +-
.../core_os/msys/os_msys_get_pkthdr/index.html | 4 +-
.../os/core_os/msys/os_msys_register/index.html | 4 +-
latest/os/core_os/msys/os_msys_reset/index.html | 4 +-
latest/os/core_os/mutex/mutex/index.html | 4 +-
.../os/core_os/mutex/os_mutex_init/index.html | 4 +-
.../os/core_os/mutex/os_mutex_pend/index.html | 4 +-
.../core_os/mutex/os_mutex_release/index.html | 4 +-
latest/os/core_os/mynewt_os/index.html | 75 +-
latest/os/core_os/os_init/index.html | 783 -------------------
latest/os/core_os/os_start/index.html | 783 -------------------
latest/os/core_os/os_started/index.html | 26 +-
.../sanity/os_sanity_check_init/index.html | 4 +-
.../sanity/os_sanity_check_register/index.html | 4 +-
.../sanity/os_sanity_check_reset/index.html | 4 +-
.../sanity/os_sanity_task_checkin/index.html | 4 +-
.../sanity/os_sanity_task_init/index.html | 4 +-
latest/os/core_os/sanity/sanity/index.html | 4 +-
.../os/core_os/semaphore/os_sem_init/index.html | 4 +-
.../os/core_os/semaphore/os_sem_pend/index.html | 4 +-
.../core_os/semaphore/os_sem_release/index.html | 4 +-
.../os/core_os/semaphore/semaphore/index.html | 4 +-
latest/os/core_os/task/os_task_count/index.html | 4 +-
.../task/os_task_info_get_next/index.html | 4 +-
latest/os/core_os/task/os_task_init/index.html | 4 +-
latest/os/core_os/task/task/index.html | 24 +-
.../os/core_os/time/os_gettimeofday/index.html | 4 +-
.../os/core_os/time/os_settimeofday/index.html | 4 +-
latest/os/core_os/time/os_time/index.html | 4 +-
latest/os/core_os/time/os_time_delay/index.html | 4 +-
latest/os/core_os/time/os_time_get/index.html | 4 +-
latest/os/core_os/time/os_time_tick/index.html | 4 +-
latest/os/modules/console/console/index.html | 91 ++-
latest/os/modules/imgmgr/imgmgr/index.html | 10 +-
.../imgmgr/imgmgr_module_init/index.html | 654 ----------------
.../os/modules/imgmgr/imgr_ver_parse/index.html | 16 +-
.../os/modules/imgmgr/imgr_ver_str/index.html | 12 +-
latest/os/modules/shell/shell/index.html | 38 +-
.../modules/shell/shell_cmd_register/index.html | 20 +-
.../os/modules/shell/shell_evq_set/index.html | 676 ++++++++++++++++
.../shell/shell_nlip_input_register/index.html | 16 +-
.../modules/shell/shell_nlip_output/index.html | 20 +-
.../os/modules/shell/shell_task_init/index.html | 703 -----------------
latest/os/modules/split/split/index.html | 4 +-
.../sysinitconfig/sysinitconfig/index.html | 2 +-
latest/sitemap.xml | 24 +-
mkdocs/search_index.json | 135 +---
os/core_os/callout/callout/index.html | 4 +-
.../callout/os_callout_func_init/index.html | 4 +-
os/core_os/callout/os_callout_init/index.html | 4 +-
os/core_os/callout/os_callout_queued/index.html | 4 +-
os/core_os/callout/os_callout_reset/index.html | 4 +-
os/core_os/callout/os_callout_stop/index.html | 4 +-
.../context_switch/context_switch/index.html | 4 +-
.../context_switch/os_arch_ctx_sw/index.html | 4 +-
os/core_os/context_switch/os_sched/index.html | 4 +-
.../os_sched_ctx_sw_hook/index.html | 4 +-
.../os_sched_get_current_task/index.html | 4 +-
.../context_switch/os_sched_insert/index.html | 4 +-
.../os_sched_next_task/index.html | 4 +-
.../os_sched_os_timer_exp/index.html | 4 +-
.../context_switch/os_sched_resort/index.html | 4 +-
.../os_sched_set_current_task/index.html | 4 +-
.../context_switch/os_sched_sleep/index.html | 4 +-
.../context_switch/os_sched_wakeup/index.html | 4 +-
os/core_os/event_queue/event_queue/index.html | 4 +-
os/core_os/event_queue/os_eventq_get/index.html | 4 +-
.../event_queue/os_eventq_init/index.html | 4 +-
os/core_os/event_queue/os_eventq_put/index.html | 4 +-
.../event_queue/os_eventq_remove/index.html | 4 +-
os/core_os/heap/heap/index.html | 4 +-
os/core_os/heap/os_free/index.html | 4 +-
os/core_os/heap/os_malloc/index.html | 4 +-
os/core_os/heap/os_realloc/index.html | 4 +-
os/core_os/mbuf/OS_MBUF_DATA/index.html | 4 +-
os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html | 4 +-
os/core_os/mbuf/OS_MBUF_PKTHDR/index.html | 4 +-
.../mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html | 4 +-
os/core_os/mbuf/OS_MBUF_PKTLEN/index.html | 4 +-
.../mbuf/OS_MBUF_TRAILINGSPACE/index.html | 4 +-
os/core_os/mbuf/OS_MBUF_USRHDR/index.html | 4 +-
os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html | 4 +-
os/core_os/mbuf/mbuf/index.html | 4 +-
os/core_os/mbuf/os_mbuf_adj/index.html | 4 +-
os/core_os/mbuf/os_mbuf_append/index.html | 4 +-
os/core_os/mbuf/os_mbuf_concat/index.html | 4 +-
os/core_os/mbuf/os_mbuf_copydata/index.html | 4 +-
os/core_os/mbuf/os_mbuf_copyinto/index.html | 4 +-
os/core_os/mbuf/os_mbuf_dup/index.html | 4 +-
os/core_os/mbuf/os_mbuf_extend/index.html | 4 +-
os/core_os/mbuf/os_mbuf_free_chain/index.html | 4 +-
os/core_os/mbuf/os_mbuf_get/index.html | 4 +-
os/core_os/mbuf/os_mbuf_get_pkthdr/index.html | 4 +-
os/core_os/mbuf/os_mbuf_memcmp/index.html | 4 +-
os/core_os/mbuf/os_mbuf_off/index.html | 4 +-
os/core_os/mbuf/os_mbuf_pool_init/index.html | 4 +-
os/core_os/mbuf/os_mbuf_prepend/index.html | 4 +-
os/core_os/mbuf/os_mbuf_pullup/index.html | 4 +-
.../memory_pool/OS_MEMPOOL_BYTES/index.html | 4 +-
.../memory_pool/OS_MEMPOOL_SIZE/index.html | 4 +-
os/core_os/memory_pool/memory_pool/index.html | 4 +-
.../memory_pool/os_memblock_get/index.html | 4 +-
.../memory_pool/os_memblock_put/index.html | 4 +-
.../memory_pool/os_mempool_init/index.html | 4 +-
os/core_os/mqueue/mqueue/index.html | 4 +-
os/core_os/mqueue/os_mqueue_get/index.html | 4 +-
os/core_os/mqueue/os_mqueue_init/index.html | 4 +-
os/core_os/mqueue/os_mqueue_put/index.html | 4 +-
os/core_os/msys/msys/index.html | 4 +-
os/core_os/msys/os_msys_get/index.html | 4 +-
os/core_os/msys/os_msys_get_pkthdr/index.html | 4 +-
os/core_os/msys/os_msys_register/index.html | 4 +-
os/core_os/msys/os_msys_reset/index.html | 4 +-
os/core_os/mutex/mutex/index.html | 4 +-
os/core_os/mutex/os_mutex_init/index.html | 4 +-
os/core_os/mutex/os_mutex_pend/index.html | 4 +-
os/core_os/mutex/os_mutex_release/index.html | 4 +-
os/core_os/mynewt_os/index.html | 12 +-
os/core_os/os_init/index.html | 750 ------------------
os/core_os/os_start/index.html | 750 ------------------
os/core_os/os_started/index.html | 26 +-
.../sanity/os_sanity_check_init/index.html | 4 +-
.../sanity/os_sanity_check_register/index.html | 4 +-
.../sanity/os_sanity_check_reset/index.html | 4 +-
.../sanity/os_sanity_task_checkin/index.html | 4 +-
.../sanity/os_sanity_task_init/index.html | 4 +-
os/core_os/sanity/sanity/index.html | 4 +-
os/core_os/semaphore/os_sem_init/index.html | 4 +-
os/core_os/semaphore/os_sem_pend/index.html | 4 +-
os/core_os/semaphore/os_sem_release/index.html | 4 +-
os/core_os/semaphore/semaphore/index.html | 4 +-
os/core_os/task/os_task_count/index.html | 4 +-
.../task/os_task_info_get_next/index.html | 4 +-
os/core_os/task/os_task_init/index.html | 4 +-
os/core_os/task/task/index.html | 4 +-
os/core_os/time/os_gettimeofday/index.html | 4 +-
os/core_os/time/os_settimeofday/index.html | 4 +-
os/core_os/time/os_time/index.html | 4 +-
os/core_os/time/os_time_delay/index.html | 4 +-
os/core_os/time/os_time_get/index.html | 4 +-
os/core_os/time/os_time_tick/index.html | 4 +-
os/modules/bootloader/bootloader/index.html | 4 +-
os/modules/imgmgr/imgmgr/index.html | 8 +-
os/modules/imgmgr/imgmgr_module_init/index.html | 632 ---------------
os/modules/imgmgr/imgr_ver_parse/index.html | 16 +-
os/modules/imgmgr/imgr_ver_str/index.html | 12 +-
os/modules/shell/shell/index.html | 8 +-
os/modules/shell/shell_cmd_register/index.html | 20 +-
os/modules/shell/shell_evq_set/index.html | 643 +++++++++++++++
.../shell/shell_nlip_input_register/index.html | 16 +-
os/modules/shell/shell_nlip_output/index.html | 20 +-
os/modules/shell/shell_task_init/index.html | 670 ----------------
sitemap.xml | 26 +-
v0_9_0/sitemap.xml | 26 +-
332 files changed, 3103 insertions(+), 10049 deletions(-)
----------------------------------------------------------------------
[08/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Posted by ad...@apache.org.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/os_start/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/os_start/index.html b/develop/os/core_os/os_start/index.html
deleted file mode 100644
index 9c9abc8..0000000
--- a/develop/os/core_os/os_start/index.html
+++ /dev/null
@@ -1,783 +0,0 @@
-<!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/os_start/"> -->
- <link rel="shortcut icon" href="../../../img/favicon.ico">
-
- <title>os_start - 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_start">
-
-
- <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_init/
-">System-level Functions</a>
-
-
- <ul>
-
-
-
- <li >
- <a href="../os_init/">os_init</a>
- </li>
-
-
-
-
-
- <li class="active">
- <a href="./">os_start</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_started/">os_started</a>
- </li>
-
-
-
- </ul>
-
- </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_queue/">Event Queues</a>
-
-
- </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="/develop/os/introduction">Docs</a></li>
-
-
-
- <li>» <a href="../mynewt_os/">OS Core</a></li>
-
-
-
- <li>» <a href="../os_init/">System-level Functions</a></li>
-
-
-
- <li>» os_start</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="os_start"><font color="#F2853F" style="font-size:24pt">os_start</font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">void</span> <span style="color: #000000">os_start</span>(<span style="color: #A90D91">void</span>)
-</pre></div>
-
-
-<p>Starts the OS by initializing and enabling the OS time tick and starting the scheduler.</p>
-<p>This function does not return.</p>
-<p><br></p>
-<h4 id="arguments">Arguments</h4>
-<p>None</p>
-<p><br></p>
-<h4 id="returned-values">Returned values</h4>
-<p>None (does not return).</p>
-<p><br></p>
-<h4 id="notes">Notes</h4>
-<p>Once <code>os_start()</code> has been called, context is switched to the highest priority task that was initialized prior to calling <code>os_start()</code>.</p>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../os_init/>
- <span class="fa fa-arrow-left"></span>
- Previous: os_init
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../os_started/>
- Next: os_started
- <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/8e70b507/develop/os/core_os/os_started/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/os_started/index.html b/develop/os/core_os/os_started/index.html
index 2b8f0dc..69576a0 100644
--- a/develop/os/core_os/os_started/index.html
+++ b/develop/os/core_os/os_started/index.html
@@ -255,30 +255,14 @@
<li><a href="
- ../os_init/
-">System-level Functions</a>
+ ./
+">Functions</a>
<ul>
- <li >
- <a href="../os_init/">os_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_start/">os_start</a>
- </li>
-
-
-
-
-
<li class="active">
<a href="./">os_started</a>
</li>
@@ -698,7 +682,7 @@
- <li>» <a href="../os_init/">System-level Functions</a></li>
+ <li>» Functions</li>
@@ -731,9 +715,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../os_start/>
+ <a href=../mynewt_os/>
<span class="fa fa-arrow-left"></span>
- Previous: os_start
+ Previous: OS Core
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/sanity/os_sanity_check_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/sanity/os_sanity_check_init/index.html b/develop/os/core_os/sanity/os_sanity_check_init/index.html
index fc2b40d..97f6e11 100644
--- a/develop/os/core_os/sanity/os_sanity_check_init/index.html
+++ b/develop/os/core_os/sanity/os_sanity_check_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/sanity/os_sanity_check_register/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/sanity/os_sanity_check_register/index.html b/develop/os/core_os/sanity/os_sanity_check_register/index.html
index d60bb46..c1c399c 100644
--- a/develop/os/core_os/sanity/os_sanity_check_register/index.html
+++ b/develop/os/core_os/sanity/os_sanity_check_register/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/sanity/os_sanity_check_reset/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/sanity/os_sanity_check_reset/index.html b/develop/os/core_os/sanity/os_sanity_check_reset/index.html
index 07ee65b..2a43d65 100644
--- a/develop/os/core_os/sanity/os_sanity_check_reset/index.html
+++ b/develop/os/core_os/sanity/os_sanity_check_reset/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/sanity/os_sanity_task_checkin/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/sanity/os_sanity_task_checkin/index.html b/develop/os/core_os/sanity/os_sanity_task_checkin/index.html
index 00b3593..cf6e8a1 100644
--- a/develop/os/core_os/sanity/os_sanity_task_checkin/index.html
+++ b/develop/os/core_os/sanity/os_sanity_task_checkin/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/sanity/os_sanity_task_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/sanity/os_sanity_task_init/index.html b/develop/os/core_os/sanity/os_sanity_task_init/index.html
index 2f45c0a..7503739 100644
--- a/develop/os/core_os/sanity/os_sanity_task_init/index.html
+++ b/develop/os/core_os/sanity/os_sanity_task_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/sanity/sanity/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/sanity/sanity/index.html b/develop/os/core_os/sanity/sanity/index.html
index cca900d..4c7ffbf 100644
--- a/develop/os/core_os/sanity/sanity/index.html
+++ b/develop/os/core_os/sanity/sanity/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/semaphore/os_sem_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/semaphore/os_sem_init/index.html b/develop/os/core_os/semaphore/os_sem_init/index.html
index 7afa586..7b5c2fb 100644
--- a/develop/os/core_os/semaphore/os_sem_init/index.html
+++ b/develop/os/core_os/semaphore/os_sem_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/semaphore/os_sem_pend/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/semaphore/os_sem_pend/index.html b/develop/os/core_os/semaphore/os_sem_pend/index.html
index d193f2d..3adf700 100644
--- a/develop/os/core_os/semaphore/os_sem_pend/index.html
+++ b/develop/os/core_os/semaphore/os_sem_pend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/semaphore/os_sem_release/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/semaphore/os_sem_release/index.html b/develop/os/core_os/semaphore/os_sem_release/index.html
index fb89bb4..8057d32 100644
--- a/develop/os/core_os/semaphore/os_sem_release/index.html
+++ b/develop/os/core_os/semaphore/os_sem_release/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/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 e1ed3b7..0b78b98 100644
--- a/develop/os/core_os/semaphore/semaphore/index.html
+++ b/develop/os/core_os/semaphore/semaphore/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/task/os_task_count/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/task/os_task_count/index.html b/develop/os/core_os/task/os_task_count/index.html
index 1d2c4e2..ffda10e 100644
--- a/develop/os/core_os/task/os_task_count/index.html
+++ b/develop/os/core_os/task/os_task_count/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/task/os_task_info_get_next/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/task/os_task_info_get_next/index.html b/develop/os/core_os/task/os_task_info_get_next/index.html
index 31fe25a..2250580 100644
--- a/develop/os/core_os/task/os_task_info_get_next/index.html
+++ b/develop/os/core_os/task/os_task_info_get_next/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/task/os_task_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/task/os_task_init/index.html b/develop/os/core_os/task/os_task_init/index.html
index cf5012f..0b895f7 100644
--- a/develop/os/core_os/task/os_task_init/index.html
+++ b/develop/os/core_os/task/os_task_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/task/task/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/task/task/index.html b/develop/os/core_os/task/task/index.html
index 5643b91..d529058 100644
--- a/develop/os/core_os/task/task/index.html
+++ b/develop/os/core_os/task/task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
@@ -772,23 +772,21 @@ task simply toggles an LED at a one second interval.</p>
}
<span style="color: #177500">/* This is the main function for the project */</span>
-<span style="color: #A90D91">int</span> <span style="color: #000000">main</span>(<span style="color: #A90D91">void</span>) {
- <span style="color: #A90D91">int</span> <span style="color: #000000">rc</span>;
+<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: #177500">/* Initialize OS */</span>
- <span style="color: #000000">os_init</span>();
+ <span style="color: #177500">/* Perform system and package initialization */</span>
+ <span style="color: #000000">sysinit</span>();
<span style="color: #177500">/* Initialize the task */</span>
<span style="color: #000000">os_task_init</span>(<span style="color: #000000">&my_task</span>, <span style="color: #C41A16">"my_task"</span>, <span style="color: #000000">my_task_func</span>, <span style="color: #A90D91">NULL</span>, <span style="color: #000000">MY_TASK_PRIO</span>,
<span style="color: #000000">OS_WAIT_FOREVER</span>, <span style="color: #000000">my_task_stack</span>, <span style="color: #000000">MY_STACK_SIZE</span>);
- <span style="color: #177500">/* Start the OS */</span>
- <span style="color: #000000">os_start</span>();
-
- <span style="color: #177500">/* os start should never return. If it does, this should be an error */</span>
- <span style="color: #000000">assert</span>(<span style="color: #1C01CE">0</span>);
-
- <span style="color: #A90D91">return</span> <span style="color: #000000">rc</span>;
+ <span style="color: #177500">/* Process events from the default event queue. */</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>());
+ }
+ <span style="color: #177500">/* main never returns */</span>
}
</pre></div>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/time/os_gettimeofday/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/time/os_gettimeofday/index.html b/develop/os/core_os/time/os_gettimeofday/index.html
index 0f13eb2..8a861fd 100644
--- a/develop/os/core_os/time/os_gettimeofday/index.html
+++ b/develop/os/core_os/time/os_gettimeofday/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/time/os_settimeofday/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/time/os_settimeofday/index.html b/develop/os/core_os/time/os_settimeofday/index.html
index c96e78f..65d4ad8 100644
--- a/develop/os/core_os/time/os_settimeofday/index.html
+++ b/develop/os/core_os/time/os_settimeofday/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/time/os_time/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/time/os_time/index.html b/develop/os/core_os/time/os_time/index.html
index 6c2b07c..3a0f1c5 100644
--- a/develop/os/core_os/time/os_time/index.html
+++ b/develop/os/core_os/time/os_time/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/time/os_time_delay/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/time/os_time_delay/index.html b/develop/os/core_os/time/os_time_delay/index.html
index b38437a..9276be0 100644
--- a/develop/os/core_os/time/os_time_delay/index.html
+++ b/develop/os/core_os/time/os_time_delay/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/time/os_time_get/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/time/os_time_get/index.html b/develop/os/core_os/time/os_time_get/index.html
index 049133e..a144a00 100644
--- a/develop/os/core_os/time/os_time_get/index.html
+++ b/develop/os/core_os/time/os_time_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/time/os_time_tick/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/time/os_time_tick/index.html b/develop/os/core_os/time/os_time_tick/index.html
index ae1afee..b387358 100644
--- a/develop/os/core_os/time/os_time_tick/index.html
+++ b/develop/os/core_os/time/os_time_tick/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/modules/console/console/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/console/console/index.html b/develop/os/modules/console/console/index.html
index 4e5f085..e88b293 100644
--- a/develop/os/modules/console/console/index.html
+++ b/develop/os/modules/console/console/index.html
@@ -555,49 +555,66 @@
</div>
<h1 id="console">Console</h1>
-<p>The console is an operating system window where users interact with system programs of the operating system
-or a console application by entering text input (typically from a keyboard) and reading text output
-(typically on the computer terminal or monitor). The text written on the console brings some information
-and is a sequence of characters sent by the OS or programs running on the OS. </p>
+<p>The console is an operating system window where users interact with the OS subsystems or a console
+application. A user typically inputs text from a keyboard and reads the OS output text on a computer
+monitor. The text are sent as a sequence of characters between the user and the OS. </p>
<p>Support is currently available for console access via the serial port on the hardware board.</p>
<h3 id="description">Description</h3>
<p>In the Mynewt OS, the console library comes in two versions:</p>
<ul>
-<li>full - containing the full implementation</li>
-<li>stub - containing stubs for the API</li>
+<li>
+<p>The <code>sys/console/full</code> package implements the complete console functionality and API.</p>
+</li>
+<li>
+<p>The <code>sys/console/stub</code> package implements stubs for the API.</p>
+</li>
</ul>
-<p>Both of these have a <code>pkg.yml</code> file which states that they provide the <code>console</code> API. If a pkg uses
-this API, it should list <code>console</code> as a requirement. For example, the shell pkg is defined by the
-following pkg.yml file:</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> pkg.name: libs/shell
- pkg.vers: 0.1
- pkg.deps:
- - libs/os
- - libs/util
- pkg.reqs:
- - console
- pkg.identities:
- - SHELL
+<p>Both packages export the <code>console</code> API, and any package that uses
+the console API must list <code>console</code> as a requirement. For example, the shell package defines the following <code>pkg.yml</code>
+file:</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">pkg.name: sys/shell
+pkg.deps:
+ - kernel/os
+ - encoding/base64
+ - time/datetime
+ - util/crc
+pkg.req_apis:
+ - console
+</pre></div>
+
+
+<p>The project <code>pkg.yml</code> file specifies the version of the console package to use.
+A project that requires the full console capability must list the <code>sys/console/full</code> package as a dependency
+in its <code>pkg.yml</code> file.</p>
+<p>An example is the <code>slinky</code> application. It requires the full console capability and has the following
+<code>pkg.yml</code> file: </p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">pkg.name: apps/slinky
+pkg.deps:
+ - test/flash_test
+ - mgmt/imgmgr
+ - mgmt/newtmgr
+ - mgmt/newtmgr/transport/nmgr_shell
+ - kernel/os
+ - boot/bootutil
+ - sys/shell
+ - sys/console/full
+ ...
+ - sys/id
</pre></div>
-<p>The project .yml file decides which version of the console pkg should be included.
-If a project requires the full console capability it lists dependency <code>libs/console/full</code> in its pkg.yml
-file. On the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to)
-but may have a dependency on a pkg that has console capability. In that case you would use a console stub. </p>
-<p>Another example would be the bootloader project where we want to keep the size of the image small. It includes
-the <code>libs/os</code> pkg that can print out messages on a console (e.g. if there is a hard fault) and the <code>libs/util</code>
-pkg that uses the full console (but only if SHELL is present to provide a CLI). However, we do not want to use
-any console I/O capability in this particular bootloader project to keep the size small. We simply use the console
-stub instead, and the pkg.yml file for the project boot pkg looks like the following:</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> project.name: boot
- project.identities: bootloader
- project.pkgs:
- - libs/os
- - libs/bootutil
- - libs/nffs
- - libs/console/stub
- - libs/util
+<p>On the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to)
+but may have a dependency on a package that has console capability. In this case, you use
+the console stub API and list the <code>sys/console/stub</code> package as a dependency in its <code>pkg.yml</code> file. </p>
+<p>An example is the bootloader project where we want to keep the size of the image small. It includes
+the <code>kernel/os</code> package that can print out messages on a console (e.g. if there is a hard fault).
+However, we do not want to use any console I/O capability in this particular bootloader project to
+keep the size small. The project uses the console stub API and has the following <code>pkg.yml</code> file: </p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">pkg.name: apps/boot
+pkg.deps:
+ - boot/bootutil
+ - kernel/os
+ - sys/console/stub
</pre></div>
@@ -608,8 +625,8 @@ based on these interrupts.</p>
want to output info related to that crash.</p>
<p>Console, by default, echoes everything it receives back. Terminal programs expect this, and is a way for the user to
know that the console is connected and responsive. Whether echoing happens or not can be controlled programmatically.</p>
-<p>The Console also has a prompt that is configurable. It is off by default but can be turned on programatically. The
-prompt cahracter can also be changed by the user.</p>
+<p>The Console also has a prompt that is configurable. It is off by default but can be turned on programmatically. The
+prompt character can also be changed by the user.</p>
<h3 id="data-structures">Data structures</h3>
<p>N/A</p>
<h3 id="list-of-functions">List of Functions</h3>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/modules/imgmgr/imgmgr/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/imgmgr/imgmgr/index.html b/develop/os/modules/imgmgr/imgmgr/index.html
index ce39df4..c341ea0 100644
--- a/develop/os/modules/imgmgr/imgmgr/index.html
+++ b/develop/os/modules/imgmgr/imgmgr/index.html
@@ -381,7 +381,7 @@
<li><a href="
- ../imgmgr_module_init/
+ ../imgr_ver_parse/
">Functions</a>
@@ -576,10 +576,6 @@
</thead>
<tbody>
<tr>
-<td><a href="../imgmgr_module_init/">imgmgr_module_init</a></td>
-<td>Registers image manager commands with newtmgr.</td>
-</tr>
-<tr>
<td><a href="../imgr_ver_parse/">imgr_ver_parse</a></td>
<td>Parses character string containing specified image version number and writes that to given image_version struct.</td>
</tr>
@@ -606,8 +602,8 @@
</li>
<li class="pull-right">
- <a href=../imgmgr_module_init/>
- Next: imgmgr_module_init
+ <a href=../imgr_ver_parse/>
+ Next: imgr_ver_parse
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/modules/imgmgr/imgmgr_module_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/imgmgr/imgmgr_module_init/index.html b/develop/os/modules/imgmgr/imgmgr_module_init/index.html
deleted file mode 100644
index eba4234..0000000
--- a/develop/os/modules/imgmgr/imgmgr_module_init/index.html
+++ /dev/null
@@ -1,654 +0,0 @@
-<!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/modules/imgmgr/imgmgr_module_init/"> -->
- <link rel="shortcut icon" href="../../../../img/favicon.ico">
-
- <title>imgmgr_module_init - 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="imgmgr_module_init">
-
-
- <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="../../../core_os/mynewt_os/">OS Core</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../core_os/porting/port_os/">Porting to your Platform</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../console/console/">Console</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../shell/shell/">Shell</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../split/split/">Split Images</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../bootloader/bootloader/">Bootloader</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li><a href="
-
-
- ../../fs/fs/fs/
-
-">File System</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../hal/hal/">Hardware Abstraction Layer</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../drivers/driver/">Drivers</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../testutil/testutil/">Test Utilities</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../devmgmt/newtmgr/">Device Management with Newt Manager</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../imgmgr/">Image Manager</a>
-
-
- <ul>
-
-
-
-
-
-
-
- <li><a href="
- ./
-">Functions</a>
-
-
- <ul>
-
-
-
- <li class="active">
- <a href="./">imgmgr_module_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../imgr_ver_parse/">imgr_ver_parse</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../imgr_ver_str/">imgr_ver_str</a>
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
-
-
- <li >
- <a href="../../baselibc/">Baselibc library</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../elua/elua/">Embedded Lua</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../json/json/">JSON</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../fcb/fcb/">Flash Circular Buffer</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../stats/stats/">Stats</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../logs/logs/">Logs</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../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="/develop/os/introduction">Docs</a></li>
-
-
-
- <li>» <a href="../imgmgr/">Image Manager</a></li>
-
-
-
- <li>» Functions</li>
-
-
-
- <li>» imgmgr_module_init</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="imgmgr_module_init"><font color="#F2853F" style="font-size:24pt"> imgmgr_module_init </font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> void
- imgmgr_module_init(void)
-</pre></div>
-
-
-<p>Registers the image manager commands with the <code>mgmt</code> package. <code>sysinit()</code> automatically calls this function during
-system initialization.</p>
-<h4 id="arguments">Arguments</h4>
-<p>N/A</p>
-<h4 id="returned-values">Returned values</h4>
-<p>N/A</p>
-<h4 id="notes">Notes</h4>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../imgmgr/>
- <span class="fa fa-arrow-left"></span>
- Previous: Image Manager
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../imgr_ver_parse/>
- Next: imgr_ver_parse
- <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/8e70b507/develop/os/modules/imgmgr/imgr_ver_parse/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/imgmgr/imgr_ver_parse/index.html b/develop/os/modules/imgmgr/imgr_ver_parse/index.html
index 35c2f7f..40e65ff 100644
--- a/develop/os/modules/imgmgr/imgr_ver_parse/index.html
+++ b/develop/os/modules/imgmgr/imgr_ver_parse/index.html
@@ -381,7 +381,7 @@
<li><a href="
- ../imgmgr_module_init/
+ ./
">Functions</a>
@@ -389,14 +389,6 @@
- <li >
- <a href="../imgmgr_module_init/">imgmgr_module_init</a>
- </li>
-
-
-
-
-
<li class="active">
<a href="./">imgr_ver_parse</a>
</li>
@@ -572,7 +564,7 @@
- <li>» <a href="../imgmgr_module_init/">Functions</a></li>
+ <li>» Functions</li>
@@ -638,9 +630,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../imgmgr_module_init/>
+ <a href=../imgmgr/>
<span class="fa fa-arrow-left"></span>
- Previous: imgmgr_module_init
+ Previous: Image Manager
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/modules/imgmgr/imgr_ver_str/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/imgmgr/imgr_ver_str/index.html b/develop/os/modules/imgmgr/imgr_ver_str/index.html
index 6758575..cbb5c81 100644
--- a/develop/os/modules/imgmgr/imgr_ver_str/index.html
+++ b/develop/os/modules/imgmgr/imgr_ver_str/index.html
@@ -381,7 +381,7 @@
<li><a href="
- ../imgmgr_module_init/
+ ../imgr_ver_parse/
">Functions</a>
@@ -390,14 +390,6 @@
<li >
- <a href="../imgmgr_module_init/">imgmgr_module_init</a>
- </li>
-
-
-
-
-
- <li >
<a href="../imgr_ver_parse/">imgr_ver_parse</a>
</li>
@@ -572,7 +564,7 @@
- <li>» <a href="../imgmgr_module_init/">Functions</a></li>
+ <li>» <a href="../imgr_ver_parse/">Functions</a></li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/modules/shell/shell/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/shell/shell/index.html b/develop/os/modules/shell/shell/index.html
index 4e1a4b2..1235ceb 100644
--- a/develop/os/modules/shell/shell/index.html
+++ b/develop/os/modules/shell/shell/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ../shell_cmd_register/
">Functions</a>
@@ -555,16 +555,23 @@
</div>
<h1 id="shell">Shell</h1>
-<p>The shell is package sitting on top of console, handling 2 jobs: processing console input and implementing
-<a href="../../../../newtmgr/overview/">newtmgr</a> line protocol over serial line. Shell runs in its own task.</p>
+<p>The shell runs above the console and provides two functionalities:</p>
+<ul>
+<li>Processes console input. </li>
+<li>Implements the <a href="../../../../newtmgr/overview/">newtmgr</a> line protocol over serial transport. </li>
+</ul>
+<p>The <code>sys/shell</code> package implements the shell. The shell uses the OS default event queue
+for shell events and runs in the context of the main task. An application can, optionally,
+specify a dedicated event queue for the shell to use.</p>
<h3 id="description">Description</h3>
<ul>
<li>
-<p>Shell's first job is directing incoming commands to other subsystems. It parses the incoming character string
-and splits it into tokens. Then it looks for the subsystem to handle this command based on the first token of input.</p>
+<p>The shell's first job is to direct incoming commands to other subsystems. It parses the incoming character string
+into tokens and uses the first token to determine the subsystem command handler to call to process the command.</p>
<ul>
<li>
-<p>Subsystems register their command handlers using <code>shell_cmd_register()</code>. When shell calls the command handler, it passes the other tokens as arguments.</p>
+<p>Subsystems register their command handlers using the <code>shell_cmd_register()</code>
+ function. When shell calls the command handler, it passes the other tokens as arguments.</p>
</li>
<li>
<p>A few commands are currently available in the shell - <code>tasks</code>, <code>log</code>, <code>echo</code>, <code>date</code> and <code>prompt</code>.</p>
@@ -572,9 +579,10 @@ and splits it into tokens. Then it looks for the subsystem to handle this comman
</ul>
</li>
<li>
-<p>Shell's second job is doing framing, encoding and decoding newtmgr protocol when it's carried over the console.
-Protocol handler (libs/newtmgr) registers itself using <code>shell_nlip_input_register()</code>, and shell calls the registered
-handler for every frame. Outgoing frames for the protocol are sent using <code>shell_nlip_output()</code>.</p>
+<p>The shell's second job is to handle packet framing, encoding, and decoding of newtmgr protocol messages that are
+sent over the console. The Newtmgr serial transport package (<code>mgmt/newtmgr/transport/newtmgr_shell</code>)
+calls the <code>shell_nlip_input_register()</code> function to register a handler that the shell calls when it
+receives newtmgr request messages.</p>
</li>
</ul>
<p><br></p>
@@ -694,10 +702,6 @@ Prompt set to: >
</thead>
<tbody>
<tr>
-<td><a href="../shell_task_init/">shell_task_init</a></td>
-<td>Initializes the shell package. This creates a task for shell, and registers few commands on its own.</td>
-</tr>
-<tr>
<td><a href="../shell_cmd_register/">shell_cmd_register</a></td>
<td>Registers a handler for incoming console commands.</td>
</tr>
@@ -709,6 +713,10 @@ Prompt set to: >
<td><a href="../shell_nlip_output/">shell_nlip_output</a></td>
<td>Queue outgoing newtmgr message for transmission.</td>
</tr>
+<tr>
+<td><a href="../shell_evq_set/">shell_evq_set</a></td>
+<td>Specifies a dedicated event queue for shell events.</td>
+</tr>
</tbody>
</table>
@@ -728,8 +736,8 @@ Prompt set to: >
</li>
<li class="pull-right">
- <a href=../shell_task_init/>
- Next: shell_task_init
+ <a href=../shell_cmd_register/>
+ Next: shell_cmd_register
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/modules/shell/shell_cmd_register/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/shell/shell_cmd_register/index.html b/develop/os/modules/shell/shell_cmd_register/index.html
index df1425d..ca17509 100644
--- a/develop/os/modules/shell/shell_cmd_register/index.html
+++ b/develop/os/modules/shell/shell_cmd_register/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ./
">Functions</a>
@@ -296,16 +296,16 @@
- <li >
- <a href="../shell_task_init/">shell_task_init</a>
+ <li class="active">
+ <a href="./">shell_cmd_register</a>
</li>
- <li class="active">
- <a href="./">shell_cmd_register</a>
+ <li >
+ <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
</li>
@@ -313,7 +313,7 @@
<li >
- <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
+ <a href="../shell_nlip_output/">shell_nlip_output</a>
</li>
@@ -321,7 +321,7 @@
<li >
- <a href="../shell_nlip_output/">shell_nlip_output</a>
+ <a href="../shell_evq_set/">shell_evq_set</a>
</li>
@@ -580,7 +580,7 @@
- <li>» <a href="../shell_task_init/">Functions</a></li>
+ <li>» Functions</li>
@@ -644,9 +644,9 @@ Non-zero on failure.</p>
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../shell_task_init/>
+ <a href=../shell/>
<span class="fa fa-arrow-left"></span>
- Previous: shell_task_init
+ Previous: Shell
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/modules/shell/shell_evq_set/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/shell/shell_evq_set/index.html b/develop/os/modules/shell/shell_evq_set/index.html
new file mode 100644
index 0000000..9e4f2ad
--- /dev/null
+++ b/develop/os/modules/shell/shell_evq_set/index.html
@@ -0,0 +1,676 @@
+<!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/modules/shell/shell_evq_set/"> -->
+ <link rel="shortcut icon" href="../../../../img/favicon.ico">
+
+ <title>shell_evq_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="shell_evq_set">
+
+
+ <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="../../../core_os/mynewt_os/">OS Core</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../core_os/porting/port_os/">Porting to your Platform</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../console/console/">Console</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../shell/">Shell</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="
+ ../shell_cmd_register/
+">Functions</a>
+
+
+ <ul>
+
+
+
+ <li >
+ <a href="../shell_cmd_register/">shell_cmd_register</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../shell_nlip_output/">shell_nlip_output</a>
+ </li>
+
+
+
+
+
+ <li class="active">
+ <a href="./">shell_evq_set</a>
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../split/split/">Split Images</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../bootloader/bootloader/">Bootloader</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+
+
+ ../../fs/fs/fs/
+
+">File System</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../hal/hal/">Hardware Abstraction Layer</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../drivers/driver/">Drivers</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../testutil/testutil/">Test Utilities</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../devmgmt/newtmgr/">Device Management with Newt Manager</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../imgmgr/imgmgr/">Image Manager</a>
+
+
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../../baselibc/">Baselibc library</a>
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../elua/elua/">Embedded Lua</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../json/json/">JSON</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../fcb/fcb/">Flash Circular Buffer</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../stats/stats/">Stats</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../logs/logs/">Logs</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../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="/develop/os/introduction">Docs</a></li>
+
+
+
+ <li>» <a href="../shell/">Shell</a></li>
+
+
+
+ <li>» <a href="../shell_cmd_register/">Functions</a></li>
+
+
+
+ <li>» shell_evq_set</li>
+
+
+
+ </ul>
+</div>
+ </div>
+
+ <h2 id="shell_evq_set"><font color="F2853F" style="font-size:24pt"> shell_evq_set</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">void</span> <span style="color: #000000">shell_evq_set</span>(<span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> <span style="color: #000000">*evq</span>)
+</pre></div>
+
+
+<p>Specifies an event queue to use for shell events. You must create the event queue
+and the task to process events from the queue before calling this function. </p>
+<p>By default, shell uses the OS default event queue and executes in the context
+of the main task that Mynewt creates.</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 the event queue to use for shell events.</td>
+</tr>
+</tbody>
+</table>
+<h4 id="returned-values">Returned values</h4>
+<p>None</p>
+<h4 id="notes">Notes</h4>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../shell_nlip_output/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: shell_nlip_output
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../../split/split/>
+ Next: Split Images
+ <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/8e70b507/develop/os/modules/shell/shell_nlip_input_register/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/shell/shell_nlip_input_register/index.html b/develop/os/modules/shell/shell_nlip_input_register/index.html
index e783b28..4f22874 100644
--- a/develop/os/modules/shell/shell_nlip_input_register/index.html
+++ b/develop/os/modules/shell/shell_nlip_input_register/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ../shell_cmd_register/
">Functions</a>
@@ -297,23 +297,23 @@
<li >
- <a href="../shell_task_init/">shell_task_init</a>
+ <a href="../shell_cmd_register/">shell_cmd_register</a>
</li>
- <li >
- <a href="../shell_cmd_register/">shell_cmd_register</a>
+ <li class="active">
+ <a href="./">shell_nlip_input_register</a>
</li>
- <li class="active">
- <a href="./">shell_nlip_input_register</a>
+ <li >
+ <a href="../shell_nlip_output/">shell_nlip_output</a>
</li>
@@ -321,7 +321,7 @@
<li >
- <a href="../shell_nlip_output/">shell_nlip_output</a>
+ <a href="../shell_evq_set/">shell_evq_set</a>
</li>
@@ -580,7 +580,7 @@
- <li>» <a href="../shell_task_init/">Functions</a></li>
+ <li>» <a href="../shell_cmd_register/">Functions</a></li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/modules/shell/shell_nlip_output/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/shell/shell_nlip_output/index.html b/develop/os/modules/shell/shell_nlip_output/index.html
index b0d81fa..275b2e0 100644
--- a/develop/os/modules/shell/shell_nlip_output/index.html
+++ b/develop/os/modules/shell/shell_nlip_output/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ../shell_cmd_register/
">Functions</a>
@@ -297,7 +297,7 @@
<li >
- <a href="../shell_task_init/">shell_task_init</a>
+ <a href="../shell_cmd_register/">shell_cmd_register</a>
</li>
@@ -305,23 +305,23 @@
<li >
- <a href="../shell_cmd_register/">shell_cmd_register</a>
+ <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
</li>
- <li >
- <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
+ <li class="active">
+ <a href="./">shell_nlip_output</a>
</li>
- <li class="active">
- <a href="./">shell_nlip_output</a>
+ <li >
+ <a href="../shell_evq_set/">shell_evq_set</a>
</li>
@@ -580,7 +580,7 @@
- <li>» <a href="../shell_task_init/">Functions</a></li>
+ <li>» <a href="../shell_cmd_register/">Functions</a></li>
@@ -648,8 +648,8 @@
</li>
<li class="pull-right">
- <a href=../../split/split/>
- Next: Split Images
+ <a href=../shell_evq_set/>
+ Next: shell_evq_set
<span class="fa fa-arrow-right"></span>
</a>
[09/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Posted by ad...@apache.org.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/callout/callout/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/callout/callout/index.html b/develop/os/core_os/callout/callout/index.html
index ec537fd..7ec6934 100644
--- a/develop/os/core_os/callout/callout/index.html
+++ b/develop/os/core_os/callout/callout/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/callout/os_callout_func_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/callout/os_callout_func_init/index.html b/develop/os/core_os/callout/os_callout_func_init/index.html
index 424a8e1..8a5e2e6 100644
--- a/develop/os/core_os/callout/os_callout_func_init/index.html
+++ b/develop/os/core_os/callout/os_callout_func_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/callout/os_callout_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/callout/os_callout_init/index.html b/develop/os/core_os/callout/os_callout_init/index.html
index 38e719c..2e4e043 100644
--- a/develop/os/core_os/callout/os_callout_init/index.html
+++ b/develop/os/core_os/callout/os_callout_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/callout/os_callout_queued/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/callout/os_callout_queued/index.html b/develop/os/core_os/callout/os_callout_queued/index.html
index e1dd73f..04702f5 100644
--- a/develop/os/core_os/callout/os_callout_queued/index.html
+++ b/develop/os/core_os/callout/os_callout_queued/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/callout/os_callout_reset/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/callout/os_callout_reset/index.html b/develop/os/core_os/callout/os_callout_reset/index.html
index 6f516ec..a02c680 100644
--- a/develop/os/core_os/callout/os_callout_reset/index.html
+++ b/develop/os/core_os/callout/os_callout_reset/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/callout/os_callout_stop/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/callout/os_callout_stop/index.html b/develop/os/core_os/callout/os_callout_stop/index.html
index c2666d5..5bfa2b5 100644
--- a/develop/os/core_os/callout/os_callout_stop/index.html
+++ b/develop/os/core_os/callout/os_callout_stop/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/context_switch/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/context_switch/index.html b/develop/os/core_os/context_switch/context_switch/index.html
index 11a529c..9de0c84 100644
--- a/develop/os/core_os/context_switch/context_switch/index.html
+++ b/develop/os/core_os/context_switch/context_switch/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_arch_ctx_sw/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_arch_ctx_sw/index.html b/develop/os/core_os/context_switch/os_arch_ctx_sw/index.html
index 014c4d0..eb4843a 100644
--- a/develop/os/core_os/context_switch/os_arch_ctx_sw/index.html
+++ b/develop/os/core_os/context_switch/os_arch_ctx_sw/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_sched/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_sched/index.html b/develop/os/core_os/context_switch/os_sched/index.html
index 7ee6e2d..ed17ee5 100644
--- a/develop/os/core_os/context_switch/os_sched/index.html
+++ b/develop/os/core_os/context_switch/os_sched/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html b/develop/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
index 7fac8f7..0c11bce 100644
--- a/develop/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
+++ b/develop/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_sched_get_current_task/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_sched_get_current_task/index.html b/develop/os/core_os/context_switch/os_sched_get_current_task/index.html
index 1c5106c..281153d 100644
--- a/develop/os/core_os/context_switch/os_sched_get_current_task/index.html
+++ b/develop/os/core_os/context_switch/os_sched_get_current_task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_sched_insert/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_sched_insert/index.html b/develop/os/core_os/context_switch/os_sched_insert/index.html
index cf9853a..f7e3a1b 100644
--- a/develop/os/core_os/context_switch/os_sched_insert/index.html
+++ b/develop/os/core_os/context_switch/os_sched_insert/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_sched_next_task/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_sched_next_task/index.html b/develop/os/core_os/context_switch/os_sched_next_task/index.html
index c44ce56..fc57aa7 100644
--- a/develop/os/core_os/context_switch/os_sched_next_task/index.html
+++ b/develop/os/core_os/context_switch/os_sched_next_task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_sched_os_timer_exp/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_sched_os_timer_exp/index.html b/develop/os/core_os/context_switch/os_sched_os_timer_exp/index.html
index ba7ff47..18b0311 100644
--- a/develop/os/core_os/context_switch/os_sched_os_timer_exp/index.html
+++ b/develop/os/core_os/context_switch/os_sched_os_timer_exp/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_sched_resort/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_sched_resort/index.html b/develop/os/core_os/context_switch/os_sched_resort/index.html
index 30ccfde..48e8b4b 100644
--- a/develop/os/core_os/context_switch/os_sched_resort/index.html
+++ b/develop/os/core_os/context_switch/os_sched_resort/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_sched_set_current_task/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_sched_set_current_task/index.html b/develop/os/core_os/context_switch/os_sched_set_current_task/index.html
index 52edbe2..f2a7518 100644
--- a/develop/os/core_os/context_switch/os_sched_set_current_task/index.html
+++ b/develop/os/core_os/context_switch/os_sched_set_current_task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_sched_sleep/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_sched_sleep/index.html b/develop/os/core_os/context_switch/os_sched_sleep/index.html
index 4c225c4..38c8dcd 100644
--- a/develop/os/core_os/context_switch/os_sched_sleep/index.html
+++ b/develop/os/core_os/context_switch/os_sched_sleep/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/context_switch/os_sched_wakeup/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/context_switch/os_sched_wakeup/index.html b/develop/os/core_os/context_switch/os_sched_wakeup/index.html
index 8e72afb..dec4890 100644
--- a/develop/os/core_os/context_switch/os_sched_wakeup/index.html
+++ b/develop/os/core_os/context_switch/os_sched_wakeup/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/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 0fa89fa..8d45ba9 100644
--- a/develop/os/core_os/event_queue/event_queue/index.html
+++ b/develop/os/core_os/event_queue/event_queue/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/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
index 4ea6fa7..52c268e 100644
--- 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
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/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
index 4d309d4..d0e421a 100644
--- 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
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/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 eab7491..f676073 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
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/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 00566cc..887e3fc 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
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/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
index c0f957f..5231bb0 100644
--- a/develop/os/core_os/event_queue/os_eventq_inited/index.html
+++ b/develop/os/core_os/event_queue/os_eventq_inited/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/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 ab70cf5..b3969d3 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
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/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 c7a495b..1aa4c03 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
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/heap/heap/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/heap/heap/index.html b/develop/os/core_os/heap/heap/index.html
index 604d3fc..ec241df 100644
--- a/develop/os/core_os/heap/heap/index.html
+++ b/develop/os/core_os/heap/heap/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/heap/os_free/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/heap/os_free/index.html b/develop/os/core_os/heap/os_free/index.html
index e509dfe..899b1c4 100644
--- a/develop/os/core_os/heap/os_free/index.html
+++ b/develop/os/core_os/heap/os_free/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/heap/os_malloc/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/heap/os_malloc/index.html b/develop/os/core_os/heap/os_malloc/index.html
index 854f336..7292617 100644
--- a/develop/os/core_os/heap/os_malloc/index.html
+++ b/develop/os/core_os/heap/os_malloc/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/heap/os_realloc/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/heap/os_realloc/index.html b/develop/os/core_os/heap/os_realloc/index.html
index 8924bcc..eda02e5 100644
--- a/develop/os/core_os/heap/os_realloc/index.html
+++ b/develop/os/core_os/heap/os_realloc/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/OS_MBUF_DATA/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/OS_MBUF_DATA/index.html b/develop/os/core_os/mbuf/OS_MBUF_DATA/index.html
index c25eb69..b2d3579 100644
--- a/develop/os/core_os/mbuf/OS_MBUF_DATA/index.html
+++ b/develop/os/core_os/mbuf/OS_MBUF_DATA/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html b/develop/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
index 003ff97..23fdeb8 100644
--- a/develop/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
+++ b/develop/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html b/develop/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
index ae31be1..d307e4c 100644
--- a/develop/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
+++ b/develop/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html b/develop/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
index 639d05b..0e061e6 100644
--- a/develop/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
+++ b/develop/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html b/develop/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
index d853096..38f882b 100644
--- a/develop/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
+++ b/develop/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html b/develop/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
index 3e12b8a..13a67ac 100644
--- a/develop/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
+++ b/develop/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/OS_MBUF_USRHDR/index.html b/develop/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
index f5455c3..60c4c0e 100644
--- a/develop/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
+++ b/develop/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html b/develop/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
index 833f53e..a2509a9 100644
--- a/develop/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
+++ b/develop/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/mbuf/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/mbuf/index.html b/develop/os/core_os/mbuf/mbuf/index.html
index 7210b37..b670425 100644
--- a/develop/os/core_os/mbuf/mbuf/index.html
+++ b/develop/os/core_os/mbuf/mbuf/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_adj/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_adj/index.html b/develop/os/core_os/mbuf/os_mbuf_adj/index.html
index 7ab5f09..8c3821b 100644
--- a/develop/os/core_os/mbuf/os_mbuf_adj/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_adj/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_append/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_append/index.html b/develop/os/core_os/mbuf/os_mbuf_append/index.html
index 1cda7c6..fac7679 100644
--- a/develop/os/core_os/mbuf/os_mbuf_append/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_append/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_concat/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_concat/index.html b/develop/os/core_os/mbuf/os_mbuf_concat/index.html
index b0f5254..3793f55 100644
--- a/develop/os/core_os/mbuf/os_mbuf_concat/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_concat/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_copydata/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_copydata/index.html b/develop/os/core_os/mbuf/os_mbuf_copydata/index.html
index 48d1bf8..a4e6a78 100644
--- a/develop/os/core_os/mbuf/os_mbuf_copydata/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_copydata/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_copyinto/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_copyinto/index.html b/develop/os/core_os/mbuf/os_mbuf_copyinto/index.html
index 771778c..8de6f1a 100644
--- a/develop/os/core_os/mbuf/os_mbuf_copyinto/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_copyinto/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_dup/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_dup/index.html b/develop/os/core_os/mbuf/os_mbuf_dup/index.html
index 1c58042..33855d4 100644
--- a/develop/os/core_os/mbuf/os_mbuf_dup/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_dup/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_extend/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_extend/index.html b/develop/os/core_os/mbuf/os_mbuf_extend/index.html
index 6fbf5a0..514c5f6 100644
--- a/develop/os/core_os/mbuf/os_mbuf_extend/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_extend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_free_chain/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_free_chain/index.html b/develop/os/core_os/mbuf/os_mbuf_free_chain/index.html
index c3e41fe..8a3ea13 100644
--- a/develop/os/core_os/mbuf/os_mbuf_free_chain/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_free_chain/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_get/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_get/index.html b/develop/os/core_os/mbuf/os_mbuf_get/index.html
index 1d505d1..aaf50f8 100644
--- a/develop/os/core_os/mbuf/os_mbuf_get/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html b/develop/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
index 3010035..a8be9a7 100644
--- a/develop/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_memcmp/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_memcmp/index.html b/develop/os/core_os/mbuf/os_mbuf_memcmp/index.html
index 839645a..30d8503 100644
--- a/develop/os/core_os/mbuf/os_mbuf_memcmp/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_memcmp/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_off/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_off/index.html b/develop/os/core_os/mbuf/os_mbuf_off/index.html
index 870b929..3b4dd98 100644
--- a/develop/os/core_os/mbuf/os_mbuf_off/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_off/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_pool_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_pool_init/index.html b/develop/os/core_os/mbuf/os_mbuf_pool_init/index.html
index 447d071..1ec48b1 100644
--- a/develop/os/core_os/mbuf/os_mbuf_pool_init/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_pool_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_prepend/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_prepend/index.html b/develop/os/core_os/mbuf/os_mbuf_prepend/index.html
index 723ef80..e36642d 100644
--- a/develop/os/core_os/mbuf/os_mbuf_prepend/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_prepend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mbuf/os_mbuf_pullup/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mbuf/os_mbuf_pullup/index.html b/develop/os/core_os/mbuf/os_mbuf_pullup/index.html
index 0d71aea..a46d6c4 100644
--- a/develop/os/core_os/mbuf/os_mbuf_pullup/index.html
+++ b/develop/os/core_os/mbuf/os_mbuf_pullup/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html b/develop/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
index 466a136..bf00d56 100644
--- a/develop/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
+++ b/develop/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html b/develop/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
index a5f885d..8ba2321 100644
--- a/develop/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
+++ b/develop/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/memory_pool/memory_pool/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/memory_pool/memory_pool/index.html b/develop/os/core_os/memory_pool/memory_pool/index.html
index e2069da..b043db3 100644
--- a/develop/os/core_os/memory_pool/memory_pool/index.html
+++ b/develop/os/core_os/memory_pool/memory_pool/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/memory_pool/os_memblock_get/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/memory_pool/os_memblock_get/index.html b/develop/os/core_os/memory_pool/os_memblock_get/index.html
index 5564b9d..feedbb2 100644
--- a/develop/os/core_os/memory_pool/os_memblock_get/index.html
+++ b/develop/os/core_os/memory_pool/os_memblock_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/memory_pool/os_memblock_put/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/memory_pool/os_memblock_put/index.html b/develop/os/core_os/memory_pool/os_memblock_put/index.html
index 280780c..d5b6cbc 100644
--- a/develop/os/core_os/memory_pool/os_memblock_put/index.html
+++ b/develop/os/core_os/memory_pool/os_memblock_put/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/memory_pool/os_mempool_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/memory_pool/os_mempool_init/index.html b/develop/os/core_os/memory_pool/os_mempool_init/index.html
index b671463..ad8aace 100644
--- a/develop/os/core_os/memory_pool/os_mempool_init/index.html
+++ b/develop/os/core_os/memory_pool/os_mempool_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mqueue/mqueue/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mqueue/mqueue/index.html b/develop/os/core_os/mqueue/mqueue/index.html
index a994053..93a5a4b 100644
--- a/develop/os/core_os/mqueue/mqueue/index.html
+++ b/develop/os/core_os/mqueue/mqueue/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mqueue/os_mqueue_get/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mqueue/os_mqueue_get/index.html b/develop/os/core_os/mqueue/os_mqueue_get/index.html
index 06e83e4..cb5e969 100644
--- a/develop/os/core_os/mqueue/os_mqueue_get/index.html
+++ b/develop/os/core_os/mqueue/os_mqueue_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mqueue/os_mqueue_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mqueue/os_mqueue_init/index.html b/develop/os/core_os/mqueue/os_mqueue_init/index.html
index c2371dc..bc6a21b 100644
--- a/develop/os/core_os/mqueue/os_mqueue_init/index.html
+++ b/develop/os/core_os/mqueue/os_mqueue_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mqueue/os_mqueue_put/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mqueue/os_mqueue_put/index.html b/develop/os/core_os/mqueue/os_mqueue_put/index.html
index 756289a..b966174 100644
--- a/develop/os/core_os/mqueue/os_mqueue_put/index.html
+++ b/develop/os/core_os/mqueue/os_mqueue_put/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/msys/msys/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/msys/msys/index.html b/develop/os/core_os/msys/msys/index.html
index 0b3716c..397df75 100644
--- a/develop/os/core_os/msys/msys/index.html
+++ b/develop/os/core_os/msys/msys/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/msys/os_msys_get/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/msys/os_msys_get/index.html b/develop/os/core_os/msys/os_msys_get/index.html
index 87a4397..bc8e412 100644
--- a/develop/os/core_os/msys/os_msys_get/index.html
+++ b/develop/os/core_os/msys/os_msys_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/msys/os_msys_get_pkthdr/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/msys/os_msys_get_pkthdr/index.html b/develop/os/core_os/msys/os_msys_get_pkthdr/index.html
index b480887..f95a3af 100644
--- a/develop/os/core_os/msys/os_msys_get_pkthdr/index.html
+++ b/develop/os/core_os/msys/os_msys_get_pkthdr/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/msys/os_msys_register/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/msys/os_msys_register/index.html b/develop/os/core_os/msys/os_msys_register/index.html
index f7d0bde..181484a 100644
--- a/develop/os/core_os/msys/os_msys_register/index.html
+++ b/develop/os/core_os/msys/os_msys_register/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/msys/os_msys_reset/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/msys/os_msys_reset/index.html b/develop/os/core_os/msys/os_msys_reset/index.html
index 4dbd242..aa69112 100644
--- a/develop/os/core_os/msys/os_msys_reset/index.html
+++ b/develop/os/core_os/msys/os_msys_reset/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mutex/mutex/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mutex/mutex/index.html b/develop/os/core_os/mutex/mutex/index.html
index 0bc9a5f..169c175 100644
--- a/develop/os/core_os/mutex/mutex/index.html
+++ b/develop/os/core_os/mutex/mutex/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mutex/os_mutex_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mutex/os_mutex_init/index.html b/develop/os/core_os/mutex/os_mutex_init/index.html
index 5034858..a55ae90 100644
--- a/develop/os/core_os/mutex/os_mutex_init/index.html
+++ b/develop/os/core_os/mutex/os_mutex_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mutex/os_mutex_pend/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mutex/os_mutex_pend/index.html b/develop/os/core_os/mutex/os_mutex_pend/index.html
index 7ef90bf..e327ebe 100644
--- a/develop/os/core_os/mutex/os_mutex_pend/index.html
+++ b/develop/os/core_os/mutex/os_mutex_pend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mutex/os_mutex_release/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mutex/os_mutex_release/index.html b/develop/os/core_os/mutex/os_mutex_release/index.html
index 4508d2b..6bf1806 100644
--- a/develop/os/core_os/mutex/os_mutex_release/index.html
+++ b/develop/os/core_os/mutex/os_mutex_release/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/mynewt_os/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/mynewt_os/index.html b/develop/os/core_os/mynewt_os/index.html
index b4153c3..3e7183c 100644
--- a/develop/os/core_os/mynewt_os/index.html
+++ b/develop/os/core_os/mynewt_os/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../os_init/
-">System-level Functions</a>
+ ../os_started/
+">Functions</a>
</li>
@@ -702,15 +702,27 @@
<li><a href="../porting/port_os/">Porting OS to other platforms</a></li>
</ul>
<h3 id="basic-os-application-creation">Basic OS Application Creation</h3>
-<p>Creating an application using the Mynewt Core OS is a relatively simple task: once you have installed the basic Newt Tool structure (build structure) for your application and created your BSP (Board Support Package), the developer initializes the OS by calling <code>os_init()</code>, performs application specific initializations, and then starts the os by calling <code>os_start()</code>. </p>
-<p>The <code>os_init()</code> API performs two basic functions: calls architecture and bsp specific setup and initializes the idle task of the OS. This is required before the OS is started. The OS start API initializes the OS time tick interrupt and starts the highest priority task running (i.e starts the scheduler). Note that <code>os_start()</code> never returns; once called the device is either running in an application task context or in idle task context.</p>
+<p>Creating an application using the Mynewt Core OS is a relatively simple task. The main steps are:</p>
+<ol>
+<li>Install the basic Newt Tool structure (build structure) for your application.</li>
+<li>Create your BSP (Board Support Package).</li>
+<li>In your application <code>main()</code> function, call the <code>sysinit()</code> function to initialize
+the system and packages, perform application specific initialization, then
+wait and dispatch events from the OS default event
+queue in an infinite loop. (See <a href="../../modules/sysinitconfig/sysinitconfig/">System Configuration and Initialization</a> for more details.) </li>
+</ol>
<p>Initializing application modules and tasks can get somewhat complicated with RTOS's similar to Mynewt. Care must be taken that the API provided by a task are initialized prior to being called by another (higher priority) task. </p>
<p>For example, take a simple application with two tasks (tasks 1 and 2, with task 1 higher priority than task 2). Task 2 provides an API which has a semaphore lock and this semaphore is initialized by task 2 when the task handler for task 2 is called. Task 1 is expected to call this API.</p>
<p>Consider the sequence of events when the OS is started. The scheduler starts running and picks the highest priority task (task 1 in this case). The task handler function for task 1 is called and will keep running until it yields execution. Before yielding, code in the task 1 handler function calls the API provided by task 2. The semaphore being accessed in the task 2 API has yet to be initialized since the task 2 handler function has not had a chance to run! This will lead to undesirable behavior and will need to be addressed by the application developer. Note that the Mynewt OS does guard against internal API being called before the OS has started (they will return error) but it does not safeguard application defined objects from access prior to initialization.</p>
<h3 id="example">Example</h3>
-<p>One way to avoid initialization issues like the one described above is to perform task initializations prior to starting the OS. The code example shown below illustrates this concept. The application initializes the OS, calls an application specific "task initialization" function, and then starts the OS. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling <code>os_task_init()</code>). </p>
+<p>One way to avoid initialization issues like the one described above is for the application to
+initialize the objects that are accessed by multiple tasks before it initializes the tasks with the OS.</p>
+<p>The code example shown below illustrates this concept. The application initializes system and packages, calls an application specific "task initialization" function, and dispatches events from the default event queue. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling <code>os_task_init()</code>). </p>
<p>In the example, each task works in a ping-pong like fashion: task 1 wakes up, adds a token to semaphore 1 and then waits for a token from semaphore 2. Task 2 waits for a token on semaphore 1 and once it gets it, adds a token to semaphore 2. Notice that the semaphores are initialized by the application specific task initialization functions and not inside the task handler functions. If task 2 (being lower in priority than task 1) had called <code>os_sem_init()</code> for task2_sem inside <code>task2_handler()</code>, task 1 would have called <code>os_sem_pend()</code> using task2_sem before task2_sem was initialized.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> <span style="color: #177500">/* Task 1 handler function */</span>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> <span style="color: #A90D91">struct</span> <span style="color: #000000">os_sem</span> <span style="color: #000000">task1_sem</span>;
+ <span style="color: #A90D91">struct</span> <span style="color: #000000">os_sem</span> <span style="color: #000000">task2_sem</span>;
+
+ <span style="color: #177500">/* Task 1 handler function */</span>
<span style="color: #A90D91">void</span>
<span style="color: #000000">task1_handler</span>(<span style="color: #A90D91">void</span> <span style="color: #000000">*arg</span>)
{
@@ -758,17 +770,22 @@
<span style="color: #177500">/**</span>
<span style="color: #177500"> * init_app_tasks</span>
<span style="color: #177500"> * </span>
-<span style="color: #177500"> * Called by main.c after os_init(). This function performs initializations </span>
-<span style="color: #177500"> * that are required before tasks are running. </span>
+<span style="color: #177500"> * This function performs initializations that are required before tasks run. </span>
<span style="color: #177500"> * </span>
<span style="color: #177500"> * @return int 0 success; error otherwise.</span>
<span style="color: #177500"> */</span>
<span style="color: #A90D91">static</span> <span style="color: #A90D91">int</span>
<span style="color: #000000">init_app_tasks</span>(<span style="color: #A90D91">void</span>)
{
+ <span style="color: #177500">/* </span>
+<span style="color: #177500"> * Call task specific initialization functions to initialize any shared objects </span>
+<span style="color: #177500"> * before initializing the tasks with the OS.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #000000">task1_init</span>();
+ <span style="color: #000000">task2_init</span>();
+
<span style="color: #177500">/*</span>
-<span style="color: #177500"> * Initialize tasks 1 and 2. Note that the task handlers are not called yet; they will</span>
-<span style="color: #177500"> * be called when the OS is started.</span>
+<span style="color: #177500"> * Initialize tasks 1 and 2 with the OS. </span>
<span style="color: #177500"> */</span>
<span style="color: #000000">os_task_init</span>(<span style="color: #000000">&task1</span>, <span style="color: #C41A16">"task1"</span>, <span style="color: #000000">task1_handler</span>, <span style="color: #A90D91">NULL</span>, <span style="color: #000000">TASK1_PRIO</span>,
<span style="color: #000000">OS_WAIT_FOREVER</span>, <span style="color: #000000">task1_stack</span>, <span style="color: #000000">TASK1_STACK_SIZE</span>);
@@ -776,49 +793,37 @@
<span style="color: #000000">os_task_init</span>(<span style="color: #000000">&task2</span>, <span style="color: #C41A16">"task2"</span>, <span style="color: #000000">task2_handler</span>, <span style="color: #A90D91">NULL</span>, <span style="color: #000000">TASK2_PRIO</span>,
<span style="color: #000000">OS_WAIT_FOREVER</span>, <span style="color: #000000">task2_stack</span>, <span style="color: #000000">TASK2_STACK_SIZE</span>);
- <span style="color: #177500">/* Call task specific initialization functions. */</span>
- <span style="color: #000000">task1_init</span>();
- <span style="color: #000000">task2_init</span>();
-
<span style="color: #A90D91">return</span> <span style="color: #1C01CE">0</span>;
}
<span style="color: #177500">/**</span>
<span style="color: #177500"> * main</span>
<span style="color: #177500"> * </span>
-<span style="color: #177500"> * The main function for the application. This function initializes the os, calls </span>
-<span style="color: #177500"> * the application specific task initialization function. then starts the </span>
-<span style="color: #177500"> * OS. We should not return from os start! </span>
+<span style="color: #177500"> * The main function for the application. This function initializes the system and packages, </span>
+<span style="color: #177500"> * calls the application specific task initialization function, then waits and dispatches </span>
+<span style="color: #177500"> * events from the OS default event queue in an infinite loop. </span>
<span style="color: #177500"> */</span>
<span style="color: #A90D91">int</span>
- <span style="color: #000000">main</span>(<span style="color: #A90D91">void</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">**arg</span>)
{
- <span style="color: #A90D91">int</span> <span style="color: #000000">i</span>;
- <span style="color: #A90D91">int</span> <span style="color: #000000">rc</span>;
- <span style="color: #A90D91">uint32_t</span> <span style="color: #000000">seed</span>;
- <span style="color: #177500">/* Initialize OS */</span>
- <span style="color: #000000">os_init</span>();
+ <span style="color: #177500">/* Perform system and package initialization */</span>
+ <span style="color: #000000">sysinit</span>();
<span style="color: #177500">/* Initialize application specific tasks */</span>
<span style="color: #000000">init_app_tasks</span>();
- <span style="color: #177500">/* Start the OS */</span>
- <span style="color: #000000">os_start</span>();
-
- <span style="color: #177500">/* os start should never return. If it does, this should be an error */</span>
- <span style="color: #000000">assert</span>(<span style="color: #1C01CE">0</span>);
-
- <span style="color: #A90D91">return</span> <span style="color: #000000">rc</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>());
+ }
+ <span style="color: #177500">/* main never returns */</span>
+}
</pre></div>
<h3 id="os-functions">OS Functions</h3>
<p>The functions available at the OS level are:</p>
<ul>
-<li><a href="../os_init/">os_init</a></li>
-<li><a href="../os_start/">os_start</a></li>
<li><a href="../os_started/">os_started</a></li>
</ul>
@@ -838,8 +843,8 @@
</li>
<li class="pull-right">
- <a href=../os_init/>
- Next: os_init
+ <a href=../os_started/>
+ Next: os_started
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/core_os/os_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/core_os/os_init/index.html b/develop/os/core_os/os_init/index.html
deleted file mode 100644
index 4673826..0000000
--- a/develop/os/core_os/os_init/index.html
+++ /dev/null
@@ -1,783 +0,0 @@
-<!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/os_init/"> -->
- <link rel="shortcut icon" href="../../../img/favicon.ico">
-
- <title>os_init - 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_init">
-
-
- <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="
- ./
-">System-level Functions</a>
-
-
- <ul>
-
-
-
- <li class="active">
- <a href="./">os_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_start/">os_start</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_started/">os_started</a>
- </li>
-
-
-
- </ul>
-
- </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_queue/">Event Queues</a>
-
-
- </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="/develop/os/introduction">Docs</a></li>
-
-
-
- <li>» <a href="../mynewt_os/">OS Core</a></li>
-
-
-
- <li>» System-level Functions</li>
-
-
-
- <li>» os_init</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="os_init"><font color="#F2853F" style="font-size:24pt">os_init</font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">void</span> <span style="color: #000000">os_init</span>(<span style="color: #A90D91">void</span>)
-</pre></div>
-
-
-<p>Initializes the OS. Must be called before the OS is started (i.e. <code>os_start()</code> is called).</p>
-<p><br></p>
-<h4 id="arguments">Arguments</h4>
-<p>None</p>
-<p><br></p>
-<h4 id="returned-values">Returned values</h4>
-<p>None</p>
-<p><br></p>
-<h4 id="notes">Notes</h4>
-<p>The call to <code>os_init()</code> performs architecture and bsp initializations and initializes the idle task.</p>
-<p>This function does not start the OS, the OS time tick interrupt, or the scheduler.</p>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../mynewt_os/>
- <span class="fa fa-arrow-left"></span>
- Previous: OS Core
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../os_start/>
- Next: os_start
- <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
[02/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Posted by ad...@apache.org.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/os_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/os_init/index.html b/os/core_os/os_init/index.html
deleted file mode 100644
index 73a3381..0000000
--- a/os/core_os/os_init/index.html
+++ /dev/null
@@ -1,750 +0,0 @@
-<!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/os_init/"> -->
- <link rel="shortcut icon" href="../../../img/favicon.ico">
-
- <title>os_init - 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_init">
-
-
- <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="
- ./
-">System-level Functions</a>
-
-
- <ul>
-
-
-
- <li class="active">
- <a href="./">os_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_start/">os_start</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_started/">os_started</a>
- </li>
-
-
-
- </ul>
-
- </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_queue/">Event Queues</a>
-
-
- </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/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/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/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="/develop/os/introduction">Docs</a></li>
-
-
-
- <li>» <a href="../mynewt_os/">OS Core</a></li>
-
-
-
- <li>» System-level Functions</li>
-
-
-
- <li>» os_init</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="os_init"><font color="#F2853F" style="font-size:24pt">os_init</font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">void os_init(void)
-</pre></div>
-
-
-<p>Initializes the OS. Must be called before the OS is started (i.e. os_start() is called).</p>
-<p><br></p>
-<h4 id="arguments">Arguments</h4>
-<p>None</p>
-<p><br></p>
-<h4 id="returned-values">Returned values</h4>
-<p>None</p>
-<p><br></p>
-<h4 id="notes">Notes</h4>
-<p>The call to os_init performs architecture and bsp initializations and initializes the idle task.</p>
-<p>This function does not start the OS, the OS time tick interrupt, or the scheduler.</p>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../mynewt_os/>
- <span class="fa fa-arrow-left"></span>
- Previous: OS Core
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../os_start/>
- Next: os_start
- <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/8e70b507/os/core_os/os_start/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/os_start/index.html b/os/core_os/os_start/index.html
deleted file mode 100644
index 4809f04..0000000
--- a/os/core_os/os_start/index.html
+++ /dev/null
@@ -1,750 +0,0 @@
-<!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/os_start/"> -->
- <link rel="shortcut icon" href="../../../img/favicon.ico">
-
- <title>os_start - 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_start">
-
-
- <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_init/
-">System-level Functions</a>
-
-
- <ul>
-
-
-
- <li >
- <a href="../os_init/">os_init</a>
- </li>
-
-
-
-
-
- <li class="active">
- <a href="./">os_start</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_started/">os_started</a>
- </li>
-
-
-
- </ul>
-
- </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_queue/">Event Queues</a>
-
-
- </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/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/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/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="/develop/os/introduction">Docs</a></li>
-
-
-
- <li>» <a href="../mynewt_os/">OS Core</a></li>
-
-
-
- <li>» <a href="../os_init/">System-level Functions</a></li>
-
-
-
- <li>» os_start</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="os_start"><font color="#F2853F" style="font-size:24pt">os_start</font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">void os_start(void)
-</pre></div>
-
-
-<p>Starts the OS by initializing and enabling the OS time tick and starting the scheduler.</p>
-<p>This function does not return.</p>
-<p><br></p>
-<h4 id="arguments">Arguments</h4>
-<p>None</p>
-<p><br></p>
-<h4 id="returned-values">Returned values</h4>
-<p>None (does not return).</p>
-<p><br></p>
-<h4 id="notes">Notes</h4>
-<p>Once os_start has been called, context is switched to the highest priority task that was initialized prior to calling os_start.</p>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../os_init/>
- <span class="fa fa-arrow-left"></span>
- Previous: os_init
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../os_started/>
- Next: os_started
- <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/8e70b507/os/core_os/os_started/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/os_started/index.html b/os/core_os/os_started/index.html
index 1c4997d..6d9e6aa 100644
--- a/os/core_os/os_started/index.html
+++ b/os/core_os/os_started/index.html
@@ -255,30 +255,14 @@
<li><a href="
- ../os_init/
-">System-level Functions</a>
+ ./
+">Functions</a>
<ul>
- <li >
- <a href="../os_init/">os_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_start/">os_start</a>
- </li>
-
-
-
-
-
<li class="active">
<a href="./">os_started</a>
</li>
@@ -665,7 +649,7 @@
- <li>» <a href="../os_init/">System-level Functions</a></li>
+ <li>» Functions</li>
@@ -698,9 +682,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../os_start/>
+ <a href=../mynewt_os/>
<span class="fa fa-arrow-left"></span>
- Previous: os_start
+ Previous: OS Core
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/sanity/os_sanity_check_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/sanity/os_sanity_check_init/index.html b/os/core_os/sanity/os_sanity_check_init/index.html
index 0352335..69ecaf3 100644
--- a/os/core_os/sanity/os_sanity_check_init/index.html
+++ b/os/core_os/sanity/os_sanity_check_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/sanity/os_sanity_check_register/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/sanity/os_sanity_check_register/index.html b/os/core_os/sanity/os_sanity_check_register/index.html
index ddcdb0a..094e961 100644
--- a/os/core_os/sanity/os_sanity_check_register/index.html
+++ b/os/core_os/sanity/os_sanity_check_register/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/sanity/os_sanity_check_reset/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/sanity/os_sanity_check_reset/index.html b/os/core_os/sanity/os_sanity_check_reset/index.html
index 32bee97..f7481f1 100644
--- a/os/core_os/sanity/os_sanity_check_reset/index.html
+++ b/os/core_os/sanity/os_sanity_check_reset/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/sanity/os_sanity_task_checkin/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/sanity/os_sanity_task_checkin/index.html b/os/core_os/sanity/os_sanity_task_checkin/index.html
index 8ba1654..0aba184 100644
--- a/os/core_os/sanity/os_sanity_task_checkin/index.html
+++ b/os/core_os/sanity/os_sanity_task_checkin/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/sanity/os_sanity_task_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/sanity/os_sanity_task_init/index.html b/os/core_os/sanity/os_sanity_task_init/index.html
index f05bb0e..dd9bb31 100644
--- a/os/core_os/sanity/os_sanity_task_init/index.html
+++ b/os/core_os/sanity/os_sanity_task_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/sanity/sanity/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/sanity/sanity/index.html b/os/core_os/sanity/sanity/index.html
index fca395c..ce72733 100644
--- a/os/core_os/sanity/sanity/index.html
+++ b/os/core_os/sanity/sanity/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/semaphore/os_sem_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/semaphore/os_sem_init/index.html b/os/core_os/semaphore/os_sem_init/index.html
index 2dba121..1de4192 100644
--- a/os/core_os/semaphore/os_sem_init/index.html
+++ b/os/core_os/semaphore/os_sem_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/semaphore/os_sem_pend/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/semaphore/os_sem_pend/index.html b/os/core_os/semaphore/os_sem_pend/index.html
index 59ebd26..4826e73 100644
--- a/os/core_os/semaphore/os_sem_pend/index.html
+++ b/os/core_os/semaphore/os_sem_pend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/semaphore/os_sem_release/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/semaphore/os_sem_release/index.html b/os/core_os/semaphore/os_sem_release/index.html
index e116bbb..9e67d6c 100644
--- a/os/core_os/semaphore/os_sem_release/index.html
+++ b/os/core_os/semaphore/os_sem_release/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/semaphore/semaphore/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/semaphore/semaphore/index.html b/os/core_os/semaphore/semaphore/index.html
index 8d92f4a..b7185ad 100644
--- a/os/core_os/semaphore/semaphore/index.html
+++ b/os/core_os/semaphore/semaphore/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/task/os_task_count/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/task/os_task_count/index.html b/os/core_os/task/os_task_count/index.html
index 76c5642..043e84e 100644
--- a/os/core_os/task/os_task_count/index.html
+++ b/os/core_os/task/os_task_count/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/task/os_task_info_get_next/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/task/os_task_info_get_next/index.html b/os/core_os/task/os_task_info_get_next/index.html
index 11881a3..04bf113 100644
--- a/os/core_os/task/os_task_info_get_next/index.html
+++ b/os/core_os/task/os_task_info_get_next/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/task/os_task_init/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/task/os_task_init/index.html b/os/core_os/task/os_task_init/index.html
index 19e114a..0b0d022 100644
--- a/os/core_os/task/os_task_init/index.html
+++ b/os/core_os/task/os_task_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/task/task/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/task/task/index.html b/os/core_os/task/task/index.html
index c72d237..64459e0 100644
--- a/os/core_os/task/task/index.html
+++ b/os/core_os/task/task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/time/os_gettimeofday/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/time/os_gettimeofday/index.html b/os/core_os/time/os_gettimeofday/index.html
index 5aca5a1..5e2698a 100644
--- a/os/core_os/time/os_gettimeofday/index.html
+++ b/os/core_os/time/os_gettimeofday/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/time/os_settimeofday/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/time/os_settimeofday/index.html b/os/core_os/time/os_settimeofday/index.html
index a07ba85..a9ce6b9 100644
--- a/os/core_os/time/os_settimeofday/index.html
+++ b/os/core_os/time/os_settimeofday/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/time/os_time/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/time/os_time/index.html b/os/core_os/time/os_time/index.html
index 995c183..066d76d 100644
--- a/os/core_os/time/os_time/index.html
+++ b/os/core_os/time/os_time/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/time/os_time_delay/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/time/os_time_delay/index.html b/os/core_os/time/os_time_delay/index.html
index d20c3b2..fdfb58e 100644
--- a/os/core_os/time/os_time_delay/index.html
+++ b/os/core_os/time/os_time_delay/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/time/os_time_get/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/time/os_time_get/index.html b/os/core_os/time/os_time_get/index.html
index e6bc181..0db0d52 100644
--- a/os/core_os/time/os_time_get/index.html
+++ b/os/core_os/time/os_time_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/core_os/time/os_time_tick/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/time/os_time_tick/index.html b/os/core_os/time/os_time_tick/index.html
index 908f53e..65a712a 100644
--- a/os/core_os/time/os_time_tick/index.html
+++ b/os/core_os/time/os_time_tick/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/modules/bootloader/bootloader/index.html
----------------------------------------------------------------------
diff --git a/os/modules/bootloader/bootloader/index.html b/os/modules/bootloader/bootloader/index.html
index b82d2a0..f206c97 100644
--- a/os/modules/bootloader/bootloader/index.html
+++ b/os/modules/bootloader/bootloader/index.html
@@ -567,9 +567,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../shell/shell_nlip_output/>
+ <a href=../../shell/shell_evq_set/>
<span class="fa fa-arrow-left"></span>
- Previous: shell_nlip_output
+ Previous: shell_evq_set
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/modules/imgmgr/imgmgr/index.html
----------------------------------------------------------------------
diff --git a/os/modules/imgmgr/imgmgr/index.html b/os/modules/imgmgr/imgmgr/index.html
index 6248320..5279745 100644
--- a/os/modules/imgmgr/imgmgr/index.html
+++ b/os/modules/imgmgr/imgmgr/index.html
@@ -359,7 +359,7 @@
<li><a href="
- ../imgmgr_module_init/
+ ../imgr_ver_parse/
">Functions</a>
@@ -543,7 +543,7 @@
</thead>
<tbody>
<tr>
-<td><a href="../imgmgr_module_init/">imgmgr_module_init</a></td>
+<td><a href="imgmgr_module_init.md">imgmgr_module_init</a></td>
<td>Registers image manager commands with newtmgr.</td>
</tr>
<tr>
@@ -573,8 +573,8 @@
</li>
<li class="pull-right">
- <a href=../imgmgr_module_init/>
- Next: imgmgr_module_init
+ <a href=../imgr_ver_parse/>
+ Next: imgr_ver_parse
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/modules/imgmgr/imgmgr_module_init/index.html
----------------------------------------------------------------------
diff --git a/os/modules/imgmgr/imgmgr_module_init/index.html b/os/modules/imgmgr/imgmgr_module_init/index.html
deleted file mode 100644
index d121cbd..0000000
--- a/os/modules/imgmgr/imgmgr_module_init/index.html
+++ /dev/null
@@ -1,632 +0,0 @@
-<!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/modules/imgmgr/imgmgr_module_init/"> -->
- <link rel="shortcut icon" href="../../../../img/favicon.ico">
-
- <title>imgmgr_module_init - 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="imgmgr_module_init">
-
-
- <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="../../../core_os/mynewt_os/">OS Core</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../core_os/porting/port_os/">Porting to your Platform</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../console/console/">Console</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../shell/shell/">Shell</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../bootloader/bootloader/">Bootloader</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li><a href="
-
-
- ../../fs/fs/fs/
-
-">File System</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../hal/hal/">Hardware Abstraction Layer</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../testutil/testutil/">Test Utilities</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../devmgmt/newtmgr/">Device Management with Newt Manager</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../imgmgr/">Image Manager</a>
-
-
- <ul>
-
-
-
-
-
-
-
- <li><a href="
- ./
-">Functions</a>
-
-
- <ul>
-
-
-
- <li class="active">
- <a href="./">imgmgr_module_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../imgr_ver_parse/">imgr_ver_parse</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../imgr_ver_str/">imgr_ver_str</a>
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
-
-
- <li >
- <a href="../../baselibc/">Baselibc library</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../elua/elua/">Embedded Lua</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../json/json/">JSON</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../stats/stats/">Stats</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../logs/logs/">Logs</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../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="/develop/os/introduction">Docs</a></li>
-
-
-
- <li>» <a href="../imgmgr/">Image Manager</a></li>
-
-
-
- <li>» Functions</li>
-
-
-
- <li>» imgmgr_module_init</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="imgmgr_module_init"><font color="#F2853F" style="font-size:24pt"> imgmgr_module_init </font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> int
- imgmgr_module_init(void)
-</pre></div>
-
-
-<p>Registers image manager commands with newtmgr. This function should be called while initializing the project, preferably after newtmgr itself has been initialized.</p>
-<h4 id="arguments">Arguments</h4>
-<p>N/A</p>
-<h4 id="returned-values">Returned values</h4>
-<p>List any values returned.
-Error codes?</p>
-<h4 id="notes">Notes</h4>
-<h4 id="example">Example</h4>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">int main(int argc, char **argv)
-{
- ...
-
- nmgr_task_init(NEWTMGR_TASK_PRIO, newtmgr_stack, NEWTMGR_TASK_STACK_SIZE);
- imgmgr_module_init();
-
- ...
-}
-</pre></div>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../imgmgr/>
- <span class="fa fa-arrow-left"></span>
- Previous: Image Manager
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../imgr_ver_parse/>
- Next: imgr_ver_parse
- <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/8e70b507/os/modules/imgmgr/imgr_ver_parse/index.html
----------------------------------------------------------------------
diff --git a/os/modules/imgmgr/imgr_ver_parse/index.html b/os/modules/imgmgr/imgr_ver_parse/index.html
index cde94e3..3f8dd57 100644
--- a/os/modules/imgmgr/imgr_ver_parse/index.html
+++ b/os/modules/imgmgr/imgr_ver_parse/index.html
@@ -359,7 +359,7 @@
<li><a href="
- ../imgmgr_module_init/
+ ./
">Functions</a>
@@ -367,14 +367,6 @@
- <li >
- <a href="../imgmgr_module_init/">imgmgr_module_init</a>
- </li>
-
-
-
-
-
<li class="active">
<a href="./">imgr_ver_parse</a>
</li>
@@ -539,7 +531,7 @@
- <li>» <a href="../imgmgr_module_init/">Functions</a></li>
+ <li>» Functions</li>
@@ -605,9 +597,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../imgmgr_module_init/>
+ <a href=../imgmgr/>
<span class="fa fa-arrow-left"></span>
- Previous: imgmgr_module_init
+ Previous: Image Manager
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/modules/imgmgr/imgr_ver_str/index.html
----------------------------------------------------------------------
diff --git a/os/modules/imgmgr/imgr_ver_str/index.html b/os/modules/imgmgr/imgr_ver_str/index.html
index 5593dcc..730673f 100644
--- a/os/modules/imgmgr/imgr_ver_str/index.html
+++ b/os/modules/imgmgr/imgr_ver_str/index.html
@@ -359,7 +359,7 @@
<li><a href="
- ../imgmgr_module_init/
+ ../imgr_ver_parse/
">Functions</a>
@@ -368,14 +368,6 @@
<li >
- <a href="../imgmgr_module_init/">imgmgr_module_init</a>
- </li>
-
-
-
-
-
- <li >
<a href="../imgr_ver_parse/">imgr_ver_parse</a>
</li>
@@ -539,7 +531,7 @@
- <li>» <a href="../imgmgr_module_init/">Functions</a></li>
+ <li>» <a href="../imgr_ver_parse/">Functions</a></li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/modules/shell/shell/index.html
----------------------------------------------------------------------
diff --git a/os/modules/shell/shell/index.html b/os/modules/shell/shell/index.html
index 0c6bf8a..ff8d2b0 100644
--- a/os/modules/shell/shell/index.html
+++ b/os/modules/shell/shell/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ../shell_cmd_register/
">Functions</a>
@@ -647,7 +647,7 @@ stat stat
</thead>
<tbody>
<tr>
-<td><a href="../shell_task_init/">shell_task_init</a></td>
+<td><a href="shell_task_init.md">shell_task_init</a></td>
<td>Initializes the shell package. This creates a task for shell, and registers few commands on its own.</td>
</tr>
<tr>
@@ -681,8 +681,8 @@ stat stat
</li>
<li class="pull-right">
- <a href=../shell_task_init/>
- Next: shell_task_init
+ <a href=../shell_cmd_register/>
+ Next: shell_cmd_register
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/modules/shell/shell_cmd_register/index.html
----------------------------------------------------------------------
diff --git a/os/modules/shell/shell_cmd_register/index.html b/os/modules/shell/shell_cmd_register/index.html
index 8b689b2..7984dd3 100644
--- a/os/modules/shell/shell_cmd_register/index.html
+++ b/os/modules/shell/shell_cmd_register/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ./
">Functions</a>
@@ -296,16 +296,16 @@
- <li >
- <a href="../shell_task_init/">shell_task_init</a>
+ <li class="active">
+ <a href="./">shell_cmd_register</a>
</li>
- <li class="active">
- <a href="./">shell_cmd_register</a>
+ <li >
+ <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
</li>
@@ -313,7 +313,7 @@
<li >
- <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
+ <a href="../shell_nlip_output/">shell_nlip_output</a>
</li>
@@ -321,7 +321,7 @@
<li >
- <a href="../shell_nlip_output/">shell_nlip_output</a>
+ <a href="../shell_evq_set/">shell_evq_set</a>
</li>
@@ -547,7 +547,7 @@
- <li>» <a href="../shell_task_init/">Functions</a></li>
+ <li>» Functions</li>
@@ -608,9 +608,9 @@ fs_cli_init(void)
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../shell_task_init/>
+ <a href=../shell/>
<span class="fa fa-arrow-left"></span>
- Previous: shell_task_init
+ Previous: Shell
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/modules/shell/shell_evq_set/index.html
----------------------------------------------------------------------
diff --git a/os/modules/shell/shell_evq_set/index.html b/os/modules/shell/shell_evq_set/index.html
new file mode 100644
index 0000000..4410598
--- /dev/null
+++ b/os/modules/shell/shell_evq_set/index.html
@@ -0,0 +1,643 @@
+<!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/modules/shell/shell_evq_set/"> -->
+ <link rel="shortcut icon" href="../../../../img/favicon.ico">
+
+ <title>shell_evq_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="shell_evq_set">
+
+
+ <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="../../../core_os/mynewt_os/">OS Core</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../core_os/porting/port_os/">Porting to your Platform</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../console/console/">Console</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../shell/">Shell</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="
+ ../shell_cmd_register/
+">Functions</a>
+
+
+ <ul>
+
+
+
+ <li >
+ <a href="../shell_cmd_register/">shell_cmd_register</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../shell_nlip_output/">shell_nlip_output</a>
+ </li>
+
+
+
+
+
+ <li class="active">
+ <a href="./">shell_evq_set</a>
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../bootloader/bootloader/">Bootloader</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+
+
+ ../../fs/fs/fs/
+
+">File System</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../hal/hal/">Hardware Abstraction Layer</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../testutil/testutil/">Test Utilities</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../devmgmt/newtmgr/">Device Management with Newt Manager</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../imgmgr/imgmgr/">Image Manager</a>
+
+
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../../baselibc/">Baselibc library</a>
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../elua/elua/">Embedded Lua</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../json/json/">JSON</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../stats/stats/">Stats</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../logs/logs/">Logs</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../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="/develop/os/introduction">Docs</a></li>
+
+
+
+ <li>» <a href="../shell/">Shell</a></li>
+
+
+
+ <li>» <a href="../shell_cmd_register/">Functions</a></li>
+
+
+
+ <li>» shell_evq_set</li>
+
+
+
+ </ul>
+</div>
+ </div>
+
+ <h2 id="shell_task_init"><font color="F2853F" style="font-size:24pt"> shell_task_init</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">void</span> <span style="color: #000000">shell_evq_set</span>(<span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> <span style="color: #000000">*evq</span>)
+</pre></div>
+
+
+<p>Specifies an event queue to use for shell events. You must create the event queue
+and the task to process events from the queue before calling this function. </p>
+<p>By default, shell uses the OS default event queue and executes in the context
+of the main task that Mynewt creates.</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 the event queue to use for shell events.</td>
+</tr>
+</tbody>
+</table>
+<h4 id="returned-values">Returned values</h4>
+<p>None</p>
+<h4 id="notes">Notes</h4>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../shell_nlip_output/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: shell_nlip_output
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../../bootloader/bootloader/>
+ Next: Bootloader
+ <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/8e70b507/os/modules/shell/shell_nlip_input_register/index.html
----------------------------------------------------------------------
diff --git a/os/modules/shell/shell_nlip_input_register/index.html b/os/modules/shell/shell_nlip_input_register/index.html
index 60e5dfe..7fe8f5d 100644
--- a/os/modules/shell/shell_nlip_input_register/index.html
+++ b/os/modules/shell/shell_nlip_input_register/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ../shell_cmd_register/
">Functions</a>
@@ -297,23 +297,23 @@
<li >
- <a href="../shell_task_init/">shell_task_init</a>
+ <a href="../shell_cmd_register/">shell_cmd_register</a>
</li>
- <li >
- <a href="../shell_cmd_register/">shell_cmd_register</a>
+ <li class="active">
+ <a href="./">shell_nlip_input_register</a>
</li>
- <li class="active">
- <a href="./">shell_nlip_input_register</a>
+ <li >
+ <a href="../shell_nlip_output/">shell_nlip_output</a>
</li>
@@ -321,7 +321,7 @@
<li >
- <a href="../shell_nlip_output/">shell_nlip_output</a>
+ <a href="../shell_evq_set/">shell_evq_set</a>
</li>
@@ -547,7 +547,7 @@
- <li>» <a href="../shell_task_init/">Functions</a></li>
+ <li>» <a href="../shell_cmd_register/">Functions</a></li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/os/modules/shell/shell_nlip_output/index.html
----------------------------------------------------------------------
diff --git a/os/modules/shell/shell_nlip_output/index.html b/os/modules/shell/shell_nlip_output/index.html
index d9c5dc4..1264c4b 100644
--- a/os/modules/shell/shell_nlip_output/index.html
+++ b/os/modules/shell/shell_nlip_output/index.html
@@ -288,7 +288,7 @@
<li><a href="
- ../shell_task_init/
+ ../shell_cmd_register/
">Functions</a>
@@ -297,7 +297,7 @@
<li >
- <a href="../shell_task_init/">shell_task_init</a>
+ <a href="../shell_cmd_register/">shell_cmd_register</a>
</li>
@@ -305,23 +305,23 @@
<li >
- <a href="../shell_cmd_register/">shell_cmd_register</a>
+ <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
</li>
- <li >
- <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
+ <li class="active">
+ <a href="./">shell_nlip_output</a>
</li>
- <li class="active">
- <a href="./">shell_nlip_output</a>
+ <li >
+ <a href="../shell_evq_set/">shell_evq_set</a>
</li>
@@ -547,7 +547,7 @@
- <li>» <a href="../shell_task_init/">Functions</a></li>
+ <li>» <a href="../shell_cmd_register/">Functions</a></li>
@@ -615,8 +615,8 @@ err:
</li>
<li class="pull-right">
- <a href=../../bootloader/bootloader/>
- Next: Bootloader
+ <a href=../shell_evq_set/>
+ Next: shell_evq_set
<span class="fa fa-arrow-right"></span>
</a>
[05/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Posted by ad...@apache.org.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/callout/callout/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/callout/callout/index.html b/latest/os/core_os/callout/callout/index.html
index a964328..f9335c1 100644
--- a/latest/os/core_os/callout/callout/index.html
+++ b/latest/os/core_os/callout/callout/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/callout/os_callout_func_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/callout/os_callout_func_init/index.html b/latest/os/core_os/callout/os_callout_func_init/index.html
index 168ac98..e375ed0 100644
--- a/latest/os/core_os/callout/os_callout_func_init/index.html
+++ b/latest/os/core_os/callout/os_callout_func_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/callout/os_callout_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/callout/os_callout_init/index.html b/latest/os/core_os/callout/os_callout_init/index.html
index 2d8df99..dc28a0a 100644
--- a/latest/os/core_os/callout/os_callout_init/index.html
+++ b/latest/os/core_os/callout/os_callout_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/callout/os_callout_queued/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/callout/os_callout_queued/index.html b/latest/os/core_os/callout/os_callout_queued/index.html
index 8805c7b..65d0038 100644
--- a/latest/os/core_os/callout/os_callout_queued/index.html
+++ b/latest/os/core_os/callout/os_callout_queued/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/callout/os_callout_reset/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/callout/os_callout_reset/index.html b/latest/os/core_os/callout/os_callout_reset/index.html
index a0fe433..93e6d3f 100644
--- a/latest/os/core_os/callout/os_callout_reset/index.html
+++ b/latest/os/core_os/callout/os_callout_reset/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/callout/os_callout_stop/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/callout/os_callout_stop/index.html b/latest/os/core_os/callout/os_callout_stop/index.html
index 58a57a0..d336989 100644
--- a/latest/os/core_os/callout/os_callout_stop/index.html
+++ b/latest/os/core_os/callout/os_callout_stop/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/context_switch/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/context_switch/index.html b/latest/os/core_os/context_switch/context_switch/index.html
index 9c8f28d..1d6a0e4 100644
--- a/latest/os/core_os/context_switch/context_switch/index.html
+++ b/latest/os/core_os/context_switch/context_switch/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_arch_ctx_sw/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_arch_ctx_sw/index.html b/latest/os/core_os/context_switch/os_arch_ctx_sw/index.html
index 4fc6c2b..6cac308 100644
--- a/latest/os/core_os/context_switch/os_arch_ctx_sw/index.html
+++ b/latest/os/core_os/context_switch/os_arch_ctx_sw/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_sched/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_sched/index.html b/latest/os/core_os/context_switch/os_sched/index.html
index 6ee217c..dc48eb4 100644
--- a/latest/os/core_os/context_switch/os_sched/index.html
+++ b/latest/os/core_os/context_switch/os_sched/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html b/latest/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
index b8a3661..f54381f 100644
--- a/latest/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
+++ b/latest/os/core_os/context_switch/os_sched_ctx_sw_hook/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_sched_get_current_task/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_sched_get_current_task/index.html b/latest/os/core_os/context_switch/os_sched_get_current_task/index.html
index c11817d..9282fde 100644
--- a/latest/os/core_os/context_switch/os_sched_get_current_task/index.html
+++ b/latest/os/core_os/context_switch/os_sched_get_current_task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_sched_insert/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_sched_insert/index.html b/latest/os/core_os/context_switch/os_sched_insert/index.html
index 7ff2b07..1b5ab07 100644
--- a/latest/os/core_os/context_switch/os_sched_insert/index.html
+++ b/latest/os/core_os/context_switch/os_sched_insert/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_sched_next_task/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_sched_next_task/index.html b/latest/os/core_os/context_switch/os_sched_next_task/index.html
index c61abf0..9b5f593 100644
--- a/latest/os/core_os/context_switch/os_sched_next_task/index.html
+++ b/latest/os/core_os/context_switch/os_sched_next_task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_sched_os_timer_exp/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_sched_os_timer_exp/index.html b/latest/os/core_os/context_switch/os_sched_os_timer_exp/index.html
index ecd5b5f..b1e4771 100644
--- a/latest/os/core_os/context_switch/os_sched_os_timer_exp/index.html
+++ b/latest/os/core_os/context_switch/os_sched_os_timer_exp/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_sched_resort/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_sched_resort/index.html b/latest/os/core_os/context_switch/os_sched_resort/index.html
index 1327cab..315e00a 100644
--- a/latest/os/core_os/context_switch/os_sched_resort/index.html
+++ b/latest/os/core_os/context_switch/os_sched_resort/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_sched_set_current_task/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_sched_set_current_task/index.html b/latest/os/core_os/context_switch/os_sched_set_current_task/index.html
index 14d3f34..05899f3 100644
--- a/latest/os/core_os/context_switch/os_sched_set_current_task/index.html
+++ b/latest/os/core_os/context_switch/os_sched_set_current_task/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_sched_sleep/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_sched_sleep/index.html b/latest/os/core_os/context_switch/os_sched_sleep/index.html
index d0da904..290caed 100644
--- a/latest/os/core_os/context_switch/os_sched_sleep/index.html
+++ b/latest/os/core_os/context_switch/os_sched_sleep/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/context_switch/os_sched_wakeup/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/context_switch/os_sched_wakeup/index.html b/latest/os/core_os/context_switch/os_sched_wakeup/index.html
index 0d2f132..3868a2c 100644
--- a/latest/os/core_os/context_switch/os_sched_wakeup/index.html
+++ b/latest/os/core_os/context_switch/os_sched_wakeup/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/event_queue/event_queue/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/event_queue/event_queue/index.html b/latest/os/core_os/event_queue/event_queue/index.html
index fb2dbd5..5fb7a12 100644
--- a/latest/os/core_os/event_queue/event_queue/index.html
+++ b/latest/os/core_os/event_queue/event_queue/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/event_queue/os_eventq_dflt_get/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/event_queue/os_eventq_dflt_get/index.html b/latest/os/core_os/event_queue/os_eventq_dflt_get/index.html
index 017f38d..3fd6a41 100644
--- a/latest/os/core_os/event_queue/os_eventq_dflt_get/index.html
+++ b/latest/os/core_os/event_queue/os_eventq_dflt_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/event_queue/os_eventq_dflt_set/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/event_queue/os_eventq_dflt_set/index.html b/latest/os/core_os/event_queue/os_eventq_dflt_set/index.html
index 7370bef..dea845f 100644
--- a/latest/os/core_os/event_queue/os_eventq_dflt_set/index.html
+++ b/latest/os/core_os/event_queue/os_eventq_dflt_set/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/event_queue/os_eventq_get/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/event_queue/os_eventq_get/index.html b/latest/os/core_os/event_queue/os_eventq_get/index.html
index 980bf42..3a3586d 100644
--- a/latest/os/core_os/event_queue/os_eventq_get/index.html
+++ b/latest/os/core_os/event_queue/os_eventq_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/event_queue/os_eventq_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/event_queue/os_eventq_init/index.html b/latest/os/core_os/event_queue/os_eventq_init/index.html
index 9639941..bfff705 100644
--- a/latest/os/core_os/event_queue/os_eventq_init/index.html
+++ b/latest/os/core_os/event_queue/os_eventq_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/event_queue/os_eventq_inited/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/event_queue/os_eventq_inited/index.html b/latest/os/core_os/event_queue/os_eventq_inited/index.html
index bb24add..d505a91 100644
--- a/latest/os/core_os/event_queue/os_eventq_inited/index.html
+++ b/latest/os/core_os/event_queue/os_eventq_inited/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/event_queue/os_eventq_put/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/event_queue/os_eventq_put/index.html b/latest/os/core_os/event_queue/os_eventq_put/index.html
index 44d85da..9b841db 100644
--- a/latest/os/core_os/event_queue/os_eventq_put/index.html
+++ b/latest/os/core_os/event_queue/os_eventq_put/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/event_queue/os_eventq_remove/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/event_queue/os_eventq_remove/index.html b/latest/os/core_os/event_queue/os_eventq_remove/index.html
index 11d6eca..0b3cd0f 100644
--- a/latest/os/core_os/event_queue/os_eventq_remove/index.html
+++ b/latest/os/core_os/event_queue/os_eventq_remove/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/heap/heap/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/heap/heap/index.html b/latest/os/core_os/heap/heap/index.html
index 66b8ff5..b9a2673 100644
--- a/latest/os/core_os/heap/heap/index.html
+++ b/latest/os/core_os/heap/heap/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/heap/os_free/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/heap/os_free/index.html b/latest/os/core_os/heap/os_free/index.html
index b20cbf2..5e6e8bd 100644
--- a/latest/os/core_os/heap/os_free/index.html
+++ b/latest/os/core_os/heap/os_free/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/heap/os_malloc/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/heap/os_malloc/index.html b/latest/os/core_os/heap/os_malloc/index.html
index a098693..24fd926 100644
--- a/latest/os/core_os/heap/os_malloc/index.html
+++ b/latest/os/core_os/heap/os_malloc/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/heap/os_realloc/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/heap/os_realloc/index.html b/latest/os/core_os/heap/os_realloc/index.html
index fc2a2c7..2ea1ac4 100644
--- a/latest/os/core_os/heap/os_realloc/index.html
+++ b/latest/os/core_os/heap/os_realloc/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/OS_MBUF_DATA/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/OS_MBUF_DATA/index.html b/latest/os/core_os/mbuf/OS_MBUF_DATA/index.html
index 2cf70bd..b84eee5 100644
--- a/latest/os/core_os/mbuf/OS_MBUF_DATA/index.html
+++ b/latest/os/core_os/mbuf/OS_MBUF_DATA/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html b/latest/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
index 92a22f6..dd93674 100644
--- a/latest/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
+++ b/latest/os/core_os/mbuf/OS_MBUF_LEADINGSPACE/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html b/latest/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
index b47ebed..3bb0c88 100644
--- a/latest/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
+++ b/latest/os/core_os/mbuf/OS_MBUF_PKTHDR/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html b/latest/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
index 6728559..eb6fcb1 100644
--- a/latest/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
+++ b/latest/os/core_os/mbuf/OS_MBUF_PKTHDR_TO_MBUF/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html b/latest/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
index 276ac5e..135497c 100644
--- a/latest/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
+++ b/latest/os/core_os/mbuf/OS_MBUF_PKTLEN/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html b/latest/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
index 9125455..22c7cb1 100644
--- a/latest/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
+++ b/latest/os/core_os/mbuf/OS_MBUF_TRAILINGSPACE/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/OS_MBUF_USRHDR/index.html b/latest/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
index 43b4a55..316a82c 100644
--- a/latest/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
+++ b/latest/os/core_os/mbuf/OS_MBUF_USRHDR/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html b/latest/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
index 6485cac..682c5af 100644
--- a/latest/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
+++ b/latest/os/core_os/mbuf/OS_MBUF_USRHDR_LEN/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/mbuf/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/mbuf/index.html b/latest/os/core_os/mbuf/mbuf/index.html
index 6245147..73da822 100644
--- a/latest/os/core_os/mbuf/mbuf/index.html
+++ b/latest/os/core_os/mbuf/mbuf/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_adj/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_adj/index.html b/latest/os/core_os/mbuf/os_mbuf_adj/index.html
index 7fc67ad..815ede1 100644
--- a/latest/os/core_os/mbuf/os_mbuf_adj/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_adj/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_append/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_append/index.html b/latest/os/core_os/mbuf/os_mbuf_append/index.html
index 8274924..3d7b388 100644
--- a/latest/os/core_os/mbuf/os_mbuf_append/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_append/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_concat/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_concat/index.html b/latest/os/core_os/mbuf/os_mbuf_concat/index.html
index 9bde8cc..274064b 100644
--- a/latest/os/core_os/mbuf/os_mbuf_concat/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_concat/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_copydata/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_copydata/index.html b/latest/os/core_os/mbuf/os_mbuf_copydata/index.html
index ab75768..e0b6820 100644
--- a/latest/os/core_os/mbuf/os_mbuf_copydata/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_copydata/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_copyinto/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_copyinto/index.html b/latest/os/core_os/mbuf/os_mbuf_copyinto/index.html
index ea9577c..07ccb75 100644
--- a/latest/os/core_os/mbuf/os_mbuf_copyinto/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_copyinto/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_dup/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_dup/index.html b/latest/os/core_os/mbuf/os_mbuf_dup/index.html
index 2db5a30..322498d 100644
--- a/latest/os/core_os/mbuf/os_mbuf_dup/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_dup/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_extend/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_extend/index.html b/latest/os/core_os/mbuf/os_mbuf_extend/index.html
index b01a167..d1d644e 100644
--- a/latest/os/core_os/mbuf/os_mbuf_extend/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_extend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_free_chain/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_free_chain/index.html b/latest/os/core_os/mbuf/os_mbuf_free_chain/index.html
index 22ccc60..7222635 100644
--- a/latest/os/core_os/mbuf/os_mbuf_free_chain/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_free_chain/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_get/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_get/index.html b/latest/os/core_os/mbuf/os_mbuf_get/index.html
index bce3a6f..fd4638a 100644
--- a/latest/os/core_os/mbuf/os_mbuf_get/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html b/latest/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
index 96695ef..a04de0c 100644
--- a/latest/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_get_pkthdr/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_memcmp/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_memcmp/index.html b/latest/os/core_os/mbuf/os_mbuf_memcmp/index.html
index 4958dff..750b98a 100644
--- a/latest/os/core_os/mbuf/os_mbuf_memcmp/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_memcmp/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_off/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_off/index.html b/latest/os/core_os/mbuf/os_mbuf_off/index.html
index 1c5862c..528b664 100644
--- a/latest/os/core_os/mbuf/os_mbuf_off/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_off/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_pool_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_pool_init/index.html b/latest/os/core_os/mbuf/os_mbuf_pool_init/index.html
index 32d3639..c1d69ca 100644
--- a/latest/os/core_os/mbuf/os_mbuf_pool_init/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_pool_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_prepend/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_prepend/index.html b/latest/os/core_os/mbuf/os_mbuf_prepend/index.html
index 041750f..a1feeb2 100644
--- a/latest/os/core_os/mbuf/os_mbuf_prepend/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_prepend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mbuf/os_mbuf_pullup/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mbuf/os_mbuf_pullup/index.html b/latest/os/core_os/mbuf/os_mbuf_pullup/index.html
index 814954d..413e3cf 100644
--- a/latest/os/core_os/mbuf/os_mbuf_pullup/index.html
+++ b/latest/os/core_os/mbuf/os_mbuf_pullup/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html b/latest/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
index 4da9d63..1c158f3 100644
--- a/latest/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
+++ b/latest/os/core_os/memory_pool/OS_MEMPOOL_BYTES/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html b/latest/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
index 16beeb8..b5e7e63 100644
--- a/latest/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
+++ b/latest/os/core_os/memory_pool/OS_MEMPOOL_SIZE/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/memory_pool/memory_pool/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/memory_pool/memory_pool/index.html b/latest/os/core_os/memory_pool/memory_pool/index.html
index d107c5c..26a1fbb 100644
--- a/latest/os/core_os/memory_pool/memory_pool/index.html
+++ b/latest/os/core_os/memory_pool/memory_pool/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/memory_pool/os_memblock_get/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/memory_pool/os_memblock_get/index.html b/latest/os/core_os/memory_pool/os_memblock_get/index.html
index 38e49dd..1dae6da 100644
--- a/latest/os/core_os/memory_pool/os_memblock_get/index.html
+++ b/latest/os/core_os/memory_pool/os_memblock_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/memory_pool/os_memblock_put/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/memory_pool/os_memblock_put/index.html b/latest/os/core_os/memory_pool/os_memblock_put/index.html
index ef97e95..2daae36 100644
--- a/latest/os/core_os/memory_pool/os_memblock_put/index.html
+++ b/latest/os/core_os/memory_pool/os_memblock_put/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/memory_pool/os_mempool_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/memory_pool/os_mempool_init/index.html b/latest/os/core_os/memory_pool/os_mempool_init/index.html
index 64fa62a..3b16df7 100644
--- a/latest/os/core_os/memory_pool/os_mempool_init/index.html
+++ b/latest/os/core_os/memory_pool/os_mempool_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mqueue/mqueue/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mqueue/mqueue/index.html b/latest/os/core_os/mqueue/mqueue/index.html
index aa4a0d9..0f36b68 100644
--- a/latest/os/core_os/mqueue/mqueue/index.html
+++ b/latest/os/core_os/mqueue/mqueue/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mqueue/os_mqueue_get/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mqueue/os_mqueue_get/index.html b/latest/os/core_os/mqueue/os_mqueue_get/index.html
index 63314bf..843b4aa 100644
--- a/latest/os/core_os/mqueue/os_mqueue_get/index.html
+++ b/latest/os/core_os/mqueue/os_mqueue_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mqueue/os_mqueue_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mqueue/os_mqueue_init/index.html b/latest/os/core_os/mqueue/os_mqueue_init/index.html
index 2cd8244..5682add 100644
--- a/latest/os/core_os/mqueue/os_mqueue_init/index.html
+++ b/latest/os/core_os/mqueue/os_mqueue_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mqueue/os_mqueue_put/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mqueue/os_mqueue_put/index.html b/latest/os/core_os/mqueue/os_mqueue_put/index.html
index 7bc816b..c9721b9 100644
--- a/latest/os/core_os/mqueue/os_mqueue_put/index.html
+++ b/latest/os/core_os/mqueue/os_mqueue_put/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/msys/msys/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/msys/msys/index.html b/latest/os/core_os/msys/msys/index.html
index 4eee74d..0894c96 100644
--- a/latest/os/core_os/msys/msys/index.html
+++ b/latest/os/core_os/msys/msys/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/msys/os_msys_get/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/msys/os_msys_get/index.html b/latest/os/core_os/msys/os_msys_get/index.html
index f6d2830..67b3c33 100644
--- a/latest/os/core_os/msys/os_msys_get/index.html
+++ b/latest/os/core_os/msys/os_msys_get/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/msys/os_msys_get_pkthdr/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/msys/os_msys_get_pkthdr/index.html b/latest/os/core_os/msys/os_msys_get_pkthdr/index.html
index cdb36cd..1000421 100644
--- a/latest/os/core_os/msys/os_msys_get_pkthdr/index.html
+++ b/latest/os/core_os/msys/os_msys_get_pkthdr/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/msys/os_msys_register/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/msys/os_msys_register/index.html b/latest/os/core_os/msys/os_msys_register/index.html
index 7cf858e..b4da336 100644
--- a/latest/os/core_os/msys/os_msys_register/index.html
+++ b/latest/os/core_os/msys/os_msys_register/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/msys/os_msys_reset/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/msys/os_msys_reset/index.html b/latest/os/core_os/msys/os_msys_reset/index.html
index 7deb0cc..dba081d 100644
--- a/latest/os/core_os/msys/os_msys_reset/index.html
+++ b/latest/os/core_os/msys/os_msys_reset/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mutex/mutex/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mutex/mutex/index.html b/latest/os/core_os/mutex/mutex/index.html
index e980a63..fc2d399 100644
--- a/latest/os/core_os/mutex/mutex/index.html
+++ b/latest/os/core_os/mutex/mutex/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mutex/os_mutex_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mutex/os_mutex_init/index.html b/latest/os/core_os/mutex/os_mutex_init/index.html
index 27c35e2..ef5c1ea 100644
--- a/latest/os/core_os/mutex/os_mutex_init/index.html
+++ b/latest/os/core_os/mutex/os_mutex_init/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mutex/os_mutex_pend/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mutex/os_mutex_pend/index.html b/latest/os/core_os/mutex/os_mutex_pend/index.html
index f41d89c..feb5363 100644
--- a/latest/os/core_os/mutex/os_mutex_pend/index.html
+++ b/latest/os/core_os/mutex/os_mutex_pend/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mutex/os_mutex_release/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mutex/os_mutex_release/index.html b/latest/os/core_os/mutex/os_mutex_release/index.html
index 515d2bc..9b4d0f3 100644
--- a/latest/os/core_os/mutex/os_mutex_release/index.html
+++ b/latest/os/core_os/mutex/os_mutex_release/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../../os_init/
-">System-level Functions</a>
+ ../../os_started/
+">Functions</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/mynewt_os/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/mynewt_os/index.html b/latest/os/core_os/mynewt_os/index.html
index ffbf51a..1634ecd 100644
--- a/latest/os/core_os/mynewt_os/index.html
+++ b/latest/os/core_os/mynewt_os/index.html
@@ -255,8 +255,8 @@
<li><a href="
- ../os_init/
-">System-level Functions</a>
+ ../os_started/
+">Functions</a>
</li>
@@ -702,15 +702,27 @@
<li><a href="../porting/port_os/">Porting OS to other platforms</a></li>
</ul>
<h3 id="basic-os-application-creation">Basic OS Application Creation</h3>
-<p>Creating an application using the Mynewt Core OS is a relatively simple task: once you have installed the basic Newt Tool structure (build structure) for your application and created your BSP (Board Support Package), the developer initializes the OS by calling <code>os_init()</code>, performs application specific initializations, and then starts the os by calling <code>os_start()</code>. </p>
-<p>The <code>os_init()</code> API performs two basic functions: calls architecture and bsp specific setup and initializes the idle task of the OS. This is required before the OS is started. The OS start API initializes the OS time tick interrupt and starts the highest priority task running (i.e starts the scheduler). Note that <code>os_start()</code> never returns; once called the device is either running in an application task context or in idle task context.</p>
+<p>Creating an application using the Mynewt Core OS is a relatively simple task. The main steps are:</p>
+<ol>
+<li>Install the basic Newt Tool structure (build structure) for your application.</li>
+<li>Create your BSP (Board Support Package).</li>
+<li>In your application <code>main()</code> function, call the <code>sysinit()</code> function to initialize
+the system and packages, perform application specific initialization, then
+wait and dispatch events from the OS default event
+queue in an infinite loop. (See <a href="../../modules/sysinitconfig/sysinitconfig/">System Configuration and Initialization</a> for more details.) </li>
+</ol>
<p>Initializing application modules and tasks can get somewhat complicated with RTOS's similar to Mynewt. Care must be taken that the API provided by a task are initialized prior to being called by another (higher priority) task. </p>
<p>For example, take a simple application with two tasks (tasks 1 and 2, with task 1 higher priority than task 2). Task 2 provides an API which has a semaphore lock and this semaphore is initialized by task 2 when the task handler for task 2 is called. Task 1 is expected to call this API.</p>
<p>Consider the sequence of events when the OS is started. The scheduler starts running and picks the highest priority task (task 1 in this case). The task handler function for task 1 is called and will keep running until it yields execution. Before yielding, code in the task 1 handler function calls the API provided by task 2. The semaphore being accessed in the task 2 API has yet to be initialized since the task 2 handler function has not had a chance to run! This will lead to undesirable behavior and will need to be addressed by the application developer. Note that the Mynewt OS does guard against internal API being called before the OS has started (they will return error) but it does not safeguard application defined objects from access prior to initialization.</p>
<h3 id="example">Example</h3>
-<p>One way to avoid initialization issues like the one described above is to perform task initializations prior to starting the OS. The code example shown below illustrates this concept. The application initializes the OS, calls an application specific "task initialization" function, and then starts the OS. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling <code>os_task_init()</code>). </p>
+<p>One way to avoid initialization issues like the one described above is for the application to
+initialize the objects that are accessed by multiple tasks before it initializes the tasks with the OS.</p>
+<p>The code example shown below illustrates this concept. The application initializes system and packages, calls an application specific "task initialization" function, and dispatches events from the default event queue. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling <code>os_task_init()</code>). </p>
<p>In the example, each task works in a ping-pong like fashion: task 1 wakes up, adds a token to semaphore 1 and then waits for a token from semaphore 2. Task 2 waits for a token on semaphore 1 and once it gets it, adds a token to semaphore 2. Notice that the semaphores are initialized by the application specific task initialization functions and not inside the task handler functions. If task 2 (being lower in priority than task 1) had called <code>os_sem_init()</code> for task2_sem inside <code>task2_handler()</code>, task 1 would have called <code>os_sem_pend()</code> using task2_sem before task2_sem was initialized.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> <span style="color: #177500">/* Task 1 handler function */</span>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> <span style="color: #A90D91">struct</span> <span style="color: #000000">os_sem</span> <span style="color: #000000">task1_sem</span>;
+ <span style="color: #A90D91">struct</span> <span style="color: #000000">os_sem</span> <span style="color: #000000">task2_sem</span>;
+
+ <span style="color: #177500">/* Task 1 handler function */</span>
<span style="color: #A90D91">void</span>
<span style="color: #000000">task1_handler</span>(<span style="color: #A90D91">void</span> <span style="color: #000000">*arg</span>)
{
@@ -758,17 +770,22 @@
<span style="color: #177500">/**</span>
<span style="color: #177500"> * init_app_tasks</span>
<span style="color: #177500"> * </span>
-<span style="color: #177500"> * Called by main.c after os_init(). This function performs initializations </span>
-<span style="color: #177500"> * that are required before tasks are running. </span>
+<span style="color: #177500"> * This function performs initializations that are required before tasks run. </span>
<span style="color: #177500"> * </span>
<span style="color: #177500"> * @return int 0 success; error otherwise.</span>
<span style="color: #177500"> */</span>
<span style="color: #A90D91">static</span> <span style="color: #A90D91">int</span>
<span style="color: #000000">init_app_tasks</span>(<span style="color: #A90D91">void</span>)
{
+ <span style="color: #177500">/* </span>
+<span style="color: #177500"> * Call task specific initialization functions to initialize any shared objects </span>
+<span style="color: #177500"> * before initializing the tasks with the OS.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #000000">task1_init</span>();
+ <span style="color: #000000">task2_init</span>();
+
<span style="color: #177500">/*</span>
-<span style="color: #177500"> * Initialize tasks 1 and 2. Note that the task handlers are not called yet; they will</span>
-<span style="color: #177500"> * be called when the OS is started.</span>
+<span style="color: #177500"> * Initialize tasks 1 and 2 with the OS. </span>
<span style="color: #177500"> */</span>
<span style="color: #000000">os_task_init</span>(<span style="color: #000000">&task1</span>, <span style="color: #C41A16">"task1"</span>, <span style="color: #000000">task1_handler</span>, <span style="color: #A90D91">NULL</span>, <span style="color: #000000">TASK1_PRIO</span>,
<span style="color: #000000">OS_WAIT_FOREVER</span>, <span style="color: #000000">task1_stack</span>, <span style="color: #000000">TASK1_STACK_SIZE</span>);
@@ -776,49 +793,37 @@
<span style="color: #000000">os_task_init</span>(<span style="color: #000000">&task2</span>, <span style="color: #C41A16">"task2"</span>, <span style="color: #000000">task2_handler</span>, <span style="color: #A90D91">NULL</span>, <span style="color: #000000">TASK2_PRIO</span>,
<span style="color: #000000">OS_WAIT_FOREVER</span>, <span style="color: #000000">task2_stack</span>, <span style="color: #000000">TASK2_STACK_SIZE</span>);
- <span style="color: #177500">/* Call task specific initialization functions. */</span>
- <span style="color: #000000">task1_init</span>();
- <span style="color: #000000">task2_init</span>();
-
<span style="color: #A90D91">return</span> <span style="color: #1C01CE">0</span>;
}
<span style="color: #177500">/**</span>
<span style="color: #177500"> * main</span>
<span style="color: #177500"> * </span>
-<span style="color: #177500"> * The main function for the application. This function initializes the os, calls </span>
-<span style="color: #177500"> * the application specific task initialization function. then starts the </span>
-<span style="color: #177500"> * OS. We should not return from os start! </span>
+<span style="color: #177500"> * The main function for the application. This function initializes the system and packages, </span>
+<span style="color: #177500"> * calls the application specific task initialization function, then waits and dispatches </span>
+<span style="color: #177500"> * events from the OS default event queue in an infinite loop. </span>
<span style="color: #177500"> */</span>
<span style="color: #A90D91">int</span>
- <span style="color: #000000">main</span>(<span style="color: #A90D91">void</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">**arg</span>)
{
- <span style="color: #A90D91">int</span> <span style="color: #000000">i</span>;
- <span style="color: #A90D91">int</span> <span style="color: #000000">rc</span>;
- <span style="color: #A90D91">uint32_t</span> <span style="color: #000000">seed</span>;
- <span style="color: #177500">/* Initialize OS */</span>
- <span style="color: #000000">os_init</span>();
+ <span style="color: #177500">/* Perform system and package initialization */</span>
+ <span style="color: #000000">sysinit</span>();
<span style="color: #177500">/* Initialize application specific tasks */</span>
<span style="color: #000000">init_app_tasks</span>();
- <span style="color: #177500">/* Start the OS */</span>
- <span style="color: #000000">os_start</span>();
-
- <span style="color: #177500">/* os start should never return. If it does, this should be an error */</span>
- <span style="color: #000000">assert</span>(<span style="color: #1C01CE">0</span>);
-
- <span style="color: #A90D91">return</span> <span style="color: #000000">rc</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>());
+ }
+ <span style="color: #177500">/* main never returns */</span>
+}
</pre></div>
<h3 id="os-functions">OS Functions</h3>
<p>The functions available at the OS level are:</p>
<ul>
-<li><a href="../os_init/">os_init</a></li>
-<li><a href="../os_start/">os_start</a></li>
<li><a href="../os_started/">os_started</a></li>
</ul>
@@ -838,8 +843,8 @@
</li>
<li class="pull-right">
- <a href=../os_init/>
- Next: os_init
+ <a href=../os_started/>
+ Next: os_started
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/latest/os/core_os/os_init/index.html
----------------------------------------------------------------------
diff --git a/latest/os/core_os/os_init/index.html b/latest/os/core_os/os_init/index.html
deleted file mode 100644
index 2cb5511..0000000
--- a/latest/os/core_os/os_init/index.html
+++ /dev/null
@@ -1,783 +0,0 @@
-<!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/os_init/"> -->
- <link rel="shortcut icon" href="../../../img/favicon.ico">
-
- <title>os_init - 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_init">
-
-
- <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="
- ./
-">System-level Functions</a>
-
-
- <ul>
-
-
-
- <li class="active">
- <a href="./">os_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_start/">os_start</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../os_started/">os_started</a>
- </li>
-
-
-
- </ul>
-
- </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_queue/">Event Queues</a>
-
-
- </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>» <a href="../mynewt_os/">OS Core</a></li>
-
-
-
- <li>» System-level Functions</li>
-
-
-
- <li>» os_init</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="os_init"><font color="#F2853F" style="font-size:24pt">os_init</font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">void</span> <span style="color: #000000">os_init</span>(<span style="color: #A90D91">void</span>)
-</pre></div>
-
-
-<p>Initializes the OS. Must be called before the OS is started (i.e. <code>os_start()</code> is called).</p>
-<p><br></p>
-<h4 id="arguments">Arguments</h4>
-<p>None</p>
-<p><br></p>
-<h4 id="returned-values">Returned values</h4>
-<p>None</p>
-<p><br></p>
-<h4 id="notes">Notes</h4>
-<p>The call to <code>os_init()</code> performs architecture and bsp initializations and initializes the idle task.</p>
-<p>This function does not start the OS, the OS time tick interrupt, or the scheduler.</p>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../mynewt_os/>
- <span class="fa fa-arrow-left"></span>
- Previous: OS Core
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../os_start/>
- Next: os_start
- <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
[07/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Posted by ad...@apache.org.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/modules/shell/shell_task_init/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/shell/shell_task_init/index.html b/develop/os/modules/shell/shell_task_init/index.html
deleted file mode 100644
index a78c8b6..0000000
--- a/develop/os/modules/shell/shell_task_init/index.html
+++ /dev/null
@@ -1,703 +0,0 @@
-<!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/modules/shell/shell_task_init/"> -->
- <link rel="shortcut icon" href="../../../../img/favicon.ico">
-
- <title>shell_task_init - 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="shell_task_init">
-
-
- <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="../../../core_os/mynewt_os/">OS Core</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../core_os/porting/port_os/">Porting to your Platform</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../console/console/">Console</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../shell/">Shell</a>
-
-
- <ul>
-
-
-
-
-
-
-
- <li><a href="
- ./
-">Functions</a>
-
-
- <ul>
-
-
-
- <li class="active">
- <a href="./">shell_task_init</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../shell_cmd_register/">shell_cmd_register</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../shell_nlip_input_register/">shell_nlip_input_register</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../shell_nlip_output/">shell_nlip_output</a>
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../split/split/">Split Images</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../bootloader/bootloader/">Bootloader</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li><a href="
-
-
- ../../fs/fs/fs/
-
-">File System</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../hal/hal/">Hardware Abstraction Layer</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../drivers/driver/">Drivers</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../testutil/testutil/">Test Utilities</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../devmgmt/newtmgr/">Device Management with Newt Manager</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../imgmgr/imgmgr/">Image Manager</a>
-
-
- </li>
-
-
-
-
-
- <li >
- <a href="../../baselibc/">Baselibc library</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../elua/elua/">Embedded Lua</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../json/json/">JSON</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../fcb/fcb/">Flash Circular Buffer</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../stats/stats/">Stats</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../logs/logs/">Logs</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../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="/develop/os/introduction">Docs</a></li>
-
-
-
- <li>» <a href="../shell/">Shell</a></li>
-
-
-
- <li>» Functions</li>
-
-
-
- <li>» shell_task_init</li>
-
-
-
- </ul>
-</div>
- </div>
-
- <h2 id="shell_task_init"><font color="F2853F" style="font-size:24pt"> shell_task_init</font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">int</span> <span style="color: #000000">shell_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</span>, <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">stack_size</span>, <span style="color: #A90D91">int</span> <span style="color: #000000">max_input_length</span>);
-</pre></div>
-
-
-<p>Initializes the shell package. This creates a task for shell, and registers a few commands on its own
-(<code>echo</code>, <code>?</code>, <code>prompt</code> for example). It also allocates memory for buffering console input.</p>
-<h4 id="arguments">Arguments</h4>
-<table>
-<thead>
-<tr>
-<th>Arguments</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td><code>prio</code></td>
-<td>Priority of the shell task</td>
-</tr>
-<tr>
-<td><code>stack</code></td>
-<td>Pointer to shell tasks's stack</td>
-</tr>
-<tr>
-<td><code>stack_size</code></td>
-<td>Size of the aforementioned stack (in units of os_stack_t)</td>
-</tr>
-<tr>
-<td><code>max_input_length</code></td>
-<td>the maximum expected length of line for input</td>
-</tr>
-</tbody>
-</table>
-<h4 id="returned-values">Returned values</h4>
-<p>Returns 0 on success; nonzero on failure.</p>
-<h4 id="notes">Notes</h4>
-<p>You can register commands before calling this, but only if OS has not been started.</p>
-<h4 id="example">Example</h4>
-<p>Here's an example of stand-alone code which allows the user to execute regression tests for sys/config package only.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #633820">#define SHELL_TASK_PRIO (3)</span>
-<span style="color: #633820">#define SHELL_MAX_INPUT_LEN (256)</span>
-<span style="color: #633820">#define SHELL_TASK_STACK_SIZE (OS_STACK_ALIGN(384))</span>
-<span style="color: #A90D91">os_stack_t</span> <span style="color: #000000">shell_stack</span>[<span style="color: #000000">SHELL_TASK_STACK_SIZE</span>];
-
-<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">shell_task_init</span>(<span style="color: #000000">SHELL_TASK_PRIO</span>, <span style="color: #000000">shell_stack</span>, <span style="color: #000000">SHELL_TASK_STACK_SIZE</span>,
- <span style="color: #000000">SHELL_MAX_INPUT_LEN</span>);
- ....
-}
-</pre></div>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../shell/>
- <span class="fa fa-arrow-left"></span>
- Previous: Shell
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../shell_cmd_register/>
- Next: shell_cmd_register
- <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/8e70b507/develop/os/modules/split/split/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/split/split/index.html b/develop/os/modules/split/split/index.html
index e323153..b848ac6 100644
--- a/develop/os/modules/split/split/index.html
+++ b/develop/os/modules/split/split/index.html
@@ -981,9 +981,9 @@ special loader.elf image during the link.</p>
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../shell/shell_nlip_output/>
+ <a href=../../shell/shell_evq_set/>
<span class="fa fa-arrow-left"></span>
- Previous: shell_nlip_output
+ Previous: shell_evq_set
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/os/modules/sysinitconfig/sysinitconfig/index.html
----------------------------------------------------------------------
diff --git a/develop/os/modules/sysinitconfig/sysinitconfig/index.html b/develop/os/modules/sysinitconfig/sysinitconfig/index.html
index 2e1927f..c2374e4 100644
--- a/develop/os/modules/sysinitconfig/sysinitconfig/index.html
+++ b/develop/os/modules/sysinitconfig/sysinitconfig/index.html
@@ -907,7 +907,7 @@ You can override the <code>OS_MAIN_TASK_PRIO</code> and <code>OS_MAIN_TASK_STACK
<ul>
<li>At the start of <code>main()</code>, call the Mynewt <code>sysinit()</code> function to initialize
the packages before performing any other processing.</li>
-<li>At the end of <code>main()</code>, wait for and dispatch events from the default event queue in a forever loop. </li>
+<li>At the end of <code>main()</code>, wait for and dispatch events from the default event queue in an infinite loop. </li>
</ul>
<p><strong>Note:</strong> You must include the <code>sysinit/sysinit.h</code> header file to access the <code>sysinit()</code> function.</p>
<p>Here is an example of a <code>main()</code> function:</p>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/sitemap.xml
----------------------------------------------------------------------
diff --git a/develop/sitemap.xml b/develop/sitemap.xml
index c210311..0c120ee 100644
--- a/develop/sitemap.xml
+++ b/develop/sitemap.xml
@@ -4,7 +4,7 @@
<url>
<loc>http://mynewt.apache.org/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -13,7 +13,7 @@
<url>
<loc>http://mynewt.apache.org/pages/ble/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -22,7 +22,7 @@
<url>
<loc>http://mynewt.apache.org/quick-start/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -30,7 +30,7 @@
<url>
<loc>http://mynewt.apache.org/about/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -38,7 +38,7 @@
<url>
<loc>http://mynewt.apache.org/talks/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -46,7 +46,7 @@
<url>
<loc>http://mynewt.apache.org/download/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -54,7 +54,7 @@
<url>
<loc>http://mynewt.apache.org/community/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -62,7 +62,7 @@
<url>
<loc>http://mynewt.apache.org/events/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -71,7 +71,7 @@
<url>
<loc>http://mynewt.apache.org/os/introduction/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -83,7 +83,7 @@
<url>
<loc>http://mynewt.apache.org/os/get_started/vocabulary/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
@@ -123,13 +123,13 @@
<url>
<loc>http://mynewt.apache.org/faq/how_to_edit_docs/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>http://mynewt.apache.org/faq/answers/</loc>
- <lastmod>2017-02-02</lastmod>
+ <lastmod>2017-02-08</lastmod>
<changefreq>daily</changefreq>
</url>
[10/11] incubator-mynewt-site git commit: Updated the docs for new
system startup and initialization implementation - Author:cwanda
Posted by ad...@apache.org.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/8e70b507/develop/mkdocs/search_index.json
----------------------------------------------------------------------
diff --git a/develop/mkdocs/search_index.json b/develop/mkdocs/search_index.json
index 240c0f7..779e2f4 100644
--- a/develop/mkdocs/search_index.json
+++ b/develop/mkdocs/search_index.json
@@ -1942,7 +1942,7 @@
},
{
"location": "/os/core_os/mynewt_os/",
- "text": "Mynewt Core OS\n\n\nThe Mynewt Core OS is a multitasking, preemptive real-time operating system combining a scheduler with typical RTOS features such as mutexes, semaphores, memory pools, etc. The Mynewt Core OS also provides a number of useful utilities such as a task watchdog, networking stack, memory buffers and time management API. Each of these features is described in detail in its own section of the manual.\n\n\nA multitasking, preemptive operating system is one in which a number of different tasks can be instantiated and assigned a priority, with higher priority tasks running before lower priority tasks. Furthermore, if a lower priority task is running and a higher priority task wants to run, the lower priority task is halted and the higher priority task is allowed to run. In other words, the lower priority task is preempted by the higher priority task.\n\n\nWhy use an OS?\n\n\nYou may ask yourself \"why do I need a multitasking preemptive OS\"? The answ
er may indeed be that you do not. Some applications are simple and only require a polling loop. Others are more complex and may require that certain jobs are executed in a timely manner or before other jobs are executed. If you have a simple polling loop, you cannot move on to service a job until the current job is done being serviced. With the Mynewt OS, the application developer need not worry about certain jobs taking too long or not executing in a timely fashion; the OS provides mechanisms to deal with these situations. Another benefit of using an OS is that it helps shield application developers from other application code being written; the developer does not have to worry (or has to worry less) about other application code behaving badly and causing undesirable behavior or preventing their code from executing properly. Other benefits of using an OS (and the Mynewt OS in particular) is that it also provides features that the developer would otherwise need to create on his/her
own. \n\n\nCore OS Features\n\n\n\n\n\n\nScheduler/context switching\n\n\nTime\n\n\nTasks\n\n\nEvent queues/callouts\n\n\nSemaphores\n\n\nMutexes\n\n\nMemory pools\n\n\nHeap\n\n\nMbufs\n\n\nSanity\n\n\nCallouts\n\n\nPorting OS to other platforms\n\n\n\n\nBasic OS Application Creation\n\n\nCreating an application using the Mynewt Core OS is a relatively simple task: once you have installed the basic Newt Tool structure (build structure) for your application and created your BSP (Board Support Package), the developer initializes the OS by calling \nos_init()\n, performs application specific initializations, and then starts the os by calling \nos_start()\n. \n\n\nThe \nos_init()\n API performs two basic functions: calls architecture and bsp specific setup and initializes the idle task of the OS. This is required before the OS is started. The OS start API initializes the OS time tick interrupt and starts the highest priority task running (i.e starts the scheduler). Note that \nos_start(
)\n never returns; once called the device is either running in an application task context or in idle task context.\n\n\nInitializing application modules and tasks can get somewhat complicated with RTOS's similar to Mynewt. Care must be taken that the API provided by a task are initialized prior to being called by another (higher priority) task. \n\n\nFor example, take a simple application with two tasks (tasks 1 and 2, with task 1 higher priority than task 2). Task 2 provides an API which has a semaphore lock and this semaphore is initialized by task 2 when the task handler for task 2 is called. Task 1 is expected to call this API.\n\n\nConsider the sequence of events when the OS is started. The scheduler starts running and picks the highest priority task (task 1 in this case). The task handler function for task 1 is called and will keep running until it yields execution. Before yielding, code in the task 1 handler function calls the API provided by task 2. The semaphore being acce
ssed in the task 2 API has yet to be initialized since the task 2 handler function has not had a chance to run! This will lead to undesirable behavior and will need to be addressed by the application developer. Note that the Mynewt OS does guard against internal API being called before the OS has started (they will return error) but it does not safeguard application defined objects from access prior to initialization.\n\n\nExample\n\n\nOne way to avoid initialization issues like the one described above is to perform task initializations prior to starting the OS. The code example shown below illustrates this concept. The application initializes the OS, calls an application specific \"task initialization\" function, and then starts the OS. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling \nos_task_init()\n). \n\n\nIn the example
, each task works in a ping-pong like fashion: task 1 wakes up, adds a token to semaphore 1 and then waits for a token from semaphore 2. Task 2 waits for a token on semaphore 1 and once it gets it, adds a token to semaphore 2. Notice that the semaphores are initialized by the application specific task initialization functions and not inside the task handler functions. If task 2 (being lower in priority than task 1) had called \nos_sem_init()\n for task2_sem inside \ntask2_handler()\n, task 1 would have called \nos_sem_pend()\n using task2_sem before task2_sem was initialized.\n\n\n \n/* Task 1 handler function */\n\n \nvoid\n\n \ntask1_handler\n(\nvoid\n \n*arg\n)\n {\n \nwhile\n (\n1\n) {\n \n/* Release semaphore to task 2 */\n\n \nos_sem_release\n(\ntask1_sem\n);\n\n \n/* Wait for semaphore from task 2 */\n\n \nos_sem_pend\n(\ntask2_sem\n, \nOS_TIMEOUT_NEVER\n);\n }\n }\n\n \n/* Task 2 handler function */\
n\n \nvoid\n\n \ntask2_handler\n(\nvoid\n \n*arg\n)\n {\n \nstruct\n \nos_task\n \n*t\n;\n\n \nwhile\n (\n1\n) {\n \n/* Wait for semaphore from task1 */\n\n \nos_sem_pend\n(\ntask1_sem\n, \nOS_TIMEOUT_NEVER\n);\n\n \n/* Release task2 semaphore */\n\n \nos_sem_release\n(\ntask2_sem\n);\n }\n }\n\n\n \n/* Initialize task 1 exposed data objects */\n\n \nvoid\n\n \ntask1_init\n(\nvoid\n)\n {\n \n/* Initialize task1 semaphore */\n\n \nos_sem_init\n(\ntask1_sem\n, \n0\n);\n }\n\n \n/* Initialize task 2 exposed data objects */\n\n \nvoid\n\n \ntask2_init\n(\nvoid\n)\n {\n \n/* Initialize task1 semaphore */\n\n \nos_sem_init\n(\ntask2_sem\n, \n0\n);\n }\n\n \n/**\n\n\n * init_app_tasks\n\n\n * \n\n\n * Called by main.c after os_init(). This function performs initializations \n\n\n * that are required before tasks are running. \n\n\n *
\n\n\n * @return int 0 success; error otherwise.\n\n\n */\n\n \nstatic\n \nint\n\n \ninit_app_tasks\n(\nvoid\n)\n {\n \n/*\n\n\n * Initialize tasks 1 and 2. Note that the task handlers are not called yet; they will\n\n\n * be called when the OS is started.\n\n\n */\n\n \nos_task_init\n(\ntask1\n, \ntask1\n, \ntask1_handler\n, \nNULL\n, \nTASK1_PRIO\n, \n \nOS_WAIT_FOREVER\n, \ntask1_stack\n, \nTASK1_STACK_SIZE\n);\n\n \nos_task_init\n(\ntask2\n, \ntask2\n, \ntask2_handler\n, \nNULL\n, \nTASK2_PRIO\n, \n \nOS_WAIT_FOREVER\n, \ntask2_stack\n, \nTASK2_STACK_SIZE\n);\n\n \n/* Call task specific initialization functions. */\n\n \ntask1_init\n();\n \ntask2_init\n();\n\n \nreturn\n \n0\n;\n }\n\n \n/**\n\n\n * main\n\n\n * \n\n\n * The main function for the application. This function initializes the os, calls \n\n\n * the application spe
cific task initialization function. then starts the \n\n\n * OS. We should not return from os start! \n\n\n */\n\n \nint\n\n \nmain\n(\nvoid\n)\n {\n \nint\n \ni\n;\n \nint\n \nrc\n;\n \nuint32_t\n \nseed\n;\n\n \n/* Initialize OS */\n\n \nos_init\n();\n\n \n/* Initialize application specific tasks */\n\n \ninit_app_tasks\n();\n\n \n/* Start the OS */\n\n \nos_start\n();\n\n \n/* os start should never return. If it does, this should be an error */\n\n \nassert\n(\n0\n);\n\n \nreturn\n \nrc\n;\n }\n\n\n\n\n\nOS Functions\n\n\nThe functions available at the OS level are:\n\n\n\n\nos_init\n\n\nos_start\n\n\nos_started",
+ "text": "Mynewt Core OS\n\n\nThe Mynewt Core OS is a multitasking, preemptive real-time operating system combining a scheduler with typical RTOS features such as mutexes, semaphores, memory pools, etc. The Mynewt Core OS also provides a number of useful utilities such as a task watchdog, networking stack, memory buffers and time management API. Each of these features is described in detail in its own section of the manual.\n\n\nA multitasking, preemptive operating system is one in which a number of different tasks can be instantiated and assigned a priority, with higher priority tasks running before lower priority tasks. Furthermore, if a lower priority task is running and a higher priority task wants to run, the lower priority task is halted and the higher priority task is allowed to run. In other words, the lower priority task is preempted by the higher priority task.\n\n\nWhy use an OS?\n\n\nYou may ask yourself \"why do I need a multitasking preemptive OS\"? The answ
er may indeed be that you do not. Some applications are simple and only require a polling loop. Others are more complex and may require that certain jobs are executed in a timely manner or before other jobs are executed. If you have a simple polling loop, you cannot move on to service a job until the current job is done being serviced. With the Mynewt OS, the application developer need not worry about certain jobs taking too long or not executing in a timely fashion; the OS provides mechanisms to deal with these situations. Another benefit of using an OS is that it helps shield application developers from other application code being written; the developer does not have to worry (or has to worry less) about other application code behaving badly and causing undesirable behavior or preventing their code from executing properly. Other benefits of using an OS (and the Mynewt OS in particular) is that it also provides features that the developer would otherwise need to create on his/her
own. \n\n\nCore OS Features\n\n\n\n\n\n\nScheduler/context switching\n\n\nTime\n\n\nTasks\n\n\nEvent queues/callouts\n\n\nSemaphores\n\n\nMutexes\n\n\nMemory pools\n\n\nHeap\n\n\nMbufs\n\n\nSanity\n\n\nCallouts\n\n\nPorting OS to other platforms\n\n\n\n\nBasic OS Application Creation\n\n\nCreating an application using the Mynewt Core OS is a relatively simple task. The main steps are:\n\n\n\n\nInstall the basic Newt Tool structure (build structure) for your application.\n\n\nCreate your BSP (Board Support Package).\n\n\nIn your application \nmain()\n function, call the \nsysinit()\n function to initialize \nthe system and packages, perform application specific initialization, then\nwait and dispatch events from the OS default event \nqueue in an infinite loop. (See \nSystem Configuration and Initialization\n for more details.) \n\n\n\n\nInitializing application modules and tasks can get somewhat complicated with RTOS's similar to Mynewt. Care must be taken that the API provided by a
task are initialized prior to being called by another (higher priority) task. \n\n\nFor example, take a simple application with two tasks (tasks 1 and 2, with task 1 higher priority than task 2). Task 2 provides an API which has a semaphore lock and this semaphore is initialized by task 2 when the task handler for task 2 is called. Task 1 is expected to call this API.\n\n\nConsider the sequence of events when the OS is started. The scheduler starts running and picks the highest priority task (task 1 in this case). The task handler function for task 1 is called and will keep running until it yields execution. Before yielding, code in the task 1 handler function calls the API provided by task 2. The semaphore being accessed in the task 2 API has yet to be initialized since the task 2 handler function has not had a chance to run! This will lead to undesirable behavior and will need to be addressed by the application developer. Note that the Mynewt OS does guard against internal API be
ing called before the OS has started (they will return error) but it does not safeguard application defined objects from access prior to initialization.\n\n\nExample\n\n\nOne way to avoid initialization issues like the one described above is for the application to \ninitialize the objects that are accessed by multiple tasks before it initializes the tasks with the OS.\n\n\nThe code example shown below illustrates this concept. The application initializes system and packages, calls an application specific \"task initialization\" function, and dispatches events from the default event queue. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling \nos_task_init()\n). \n\n\nIn the example, each task works in a ping-pong like fashion: task 1 wakes up, adds a token to semaphore 1 and then waits for a token from semaphore 2. Task 2 waits
for a token on semaphore 1 and once it gets it, adds a token to semaphore 2. Notice that the semaphores are initialized by the application specific task initialization functions and not inside the task handler functions. If task 2 (being lower in priority than task 1) had called \nos_sem_init()\n for task2_sem inside \ntask2_handler()\n, task 1 would have called \nos_sem_pend()\n using task2_sem before task2_sem was initialized.\n\n\n \nstruct\n \nos_sem\n \ntask1_sem\n;\n \nstruct\n \nos_sem\n \ntask2_sem\n;\n\n \n/* Task 1 handler function */\n\n \nvoid\n\n \ntask1_handler\n(\nvoid\n \n*arg\n)\n {\n \nwhile\n (\n1\n) {\n \n/* Release semaphore to task 2 */\n\n \nos_sem_release\n(\ntask1_sem\n);\n\n \n/* Wait for semaphore from task 2 */\n\n \nos_sem_pend\n(\ntask2_sem\n, \nOS_TIMEOUT_NEVER\n);\n }\n }\n\n \n/* Task 2 handler function */\n\n \nvoid\n\n \ntask2_handler\n(\nvoid\n \n*arg\n)\n {
\n \nstruct\n \nos_task\n \n*t\n;\n\n \nwhile\n (\n1\n) {\n \n/* Wait for semaphore from task1 */\n\n \nos_sem_pend\n(\ntask1_sem\n, \nOS_TIMEOUT_NEVER\n);\n\n \n/* Release task2 semaphore */\n\n \nos_sem_release\n(\ntask2_sem\n);\n }\n }\n\n\n \n/* Initialize task 1 exposed data objects */\n\n \nvoid\n\n \ntask1_init\n(\nvoid\n)\n {\n \n/* Initialize task1 semaphore */\n\n \nos_sem_init\n(\ntask1_sem\n, \n0\n);\n }\n\n \n/* Initialize task 2 exposed data objects */\n\n \nvoid\n\n \ntask2_init\n(\nvoid\n)\n {\n \n/* Initialize task1 semaphore */\n\n \nos_sem_init\n(\ntask2_sem\n, \n0\n);\n }\n\n \n/**\n\n\n * init_app_tasks\n\n\n * \n\n\n * This function performs initializations that are required before tasks run. \n\n\n * \n\n\n * @return int 0 success; error otherwise.\n\n\n */\n\n \nstatic\n \nint\n\n \ninit_app_tasks\n(\
nvoid\n)\n {\n \n/* \n\n\n * Call task specific initialization functions to initialize any shared objects \n\n\n * before initializing the tasks with the OS.\n\n\n */\n\n \ntask1_init\n();\n \ntask2_init\n();\n\n \n/*\n\n\n * Initialize tasks 1 and 2 with the OS. \n\n\n */\n\n \nos_task_init\n(\ntask1\n, \ntask1\n, \ntask1_handler\n, \nNULL\n, \nTASK1_PRIO\n, \n \nOS_WAIT_FOREVER\n, \ntask1_stack\n, \nTASK1_STACK_SIZE\n);\n\n \nos_task_init\n(\ntask2\n, \ntask2\n, \ntask2_handler\n, \nNULL\n, \nTASK2_PRIO\n, \n \nOS_WAIT_FOREVER\n, \ntask2_stack\n, \nTASK2_STACK_SIZE\n);\n\n \nreturn\n \n0\n;\n }\n\n \n/**\n\n\n * main\n\n\n * \n\n\n * The main function for the application. This function initializes the system and packages, \n\n\n * calls the application specific task initialization function, then waits and dispatches \n\n\n *
events from the OS default event queue in an infinite loop. \n\n\n */\n\n \nint\n\n \nmain\n(\nint\n \nargc\n, \nchar\n \n**arg\n)\n {\n\n \n/* Perform system and package initialization */\n\n \nsysinit\n();\n\n \n/* Initialize application specific tasks */\n\n \ninit_app_tasks\n();\n\n \nwhile\n (\n1\n) {\n \nos_eventq_run\n(\nos_eventq_dflt_get\n());\n }\n \n/* main never returns */\n \n}\n\n\n\n\n\nOS Functions\n\n\nThe functions available at the OS level are:\n\n\n\n\nos_started",
"title": "toc"
},
{
@@ -1962,70 +1962,20 @@
},
{
"location": "/os/core_os/mynewt_os/#basic-os-application-creation",
- "text": "Creating an application using the Mynewt Core OS is a relatively simple task: once you have installed the basic Newt Tool structure (build structure) for your application and created your BSP (Board Support Package), the developer initializes the OS by calling os_init() , performs application specific initializations, and then starts the os by calling os_start() . The os_init() API performs two basic functions: calls architecture and bsp specific setup and initializes the idle task of the OS. This is required before the OS is started. The OS start API initializes the OS time tick interrupt and starts the highest priority task running (i.e starts the scheduler). Note that os_start() never returns; once called the device is either running in an application task context or in idle task context. Initializing application modules and tasks can get somewhat complicated with RTOS's similar to Mynewt. Care must be taken that the API provided by a task are initia
lized prior to being called by another (higher priority) task. For example, take a simple application with two tasks (tasks 1 and 2, with task 1 higher priority than task 2). Task 2 provides an API which has a semaphore lock and this semaphore is initialized by task 2 when the task handler for task 2 is called. Task 1 is expected to call this API. Consider the sequence of events when the OS is started. The scheduler starts running and picks the highest priority task (task 1 in this case). The task handler function for task 1 is called and will keep running until it yields execution. Before yielding, code in the task 1 handler function calls the API provided by task 2. The semaphore being accessed in the task 2 API has yet to be initialized since the task 2 handler function has not had a chance to run! This will lead to undesirable behavior and will need to be addressed by the application developer. Note that the Mynewt OS does guard against internal API being called before the OS
has started (they will return error) but it does not safeguard application defined objects from access prior to initialization.",
+ "text": "Creating an application using the Mynewt Core OS is a relatively simple task. The main steps are: Install the basic Newt Tool structure (build structure) for your application. Create your BSP (Board Support Package). In your application main() function, call the sysinit() function to initialize \nthe system and packages, perform application specific initialization, then\nwait and dispatch events from the OS default event \nqueue in an infinite loop. (See System Configuration and Initialization for more details.) Initializing application modules and tasks can get somewhat complicated with RTOS's similar to Mynewt. Care must be taken that the API provided by a task are initialized prior to being called by another (higher priority) task. For example, take a simple application with two tasks (tasks 1 and 2, with task 1 higher priority than task 2). Task 2 provides an API which has a semaphore lock and this semaphore is initialized by task 2 when the t
ask handler for task 2 is called. Task 1 is expected to call this API. Consider the sequence of events when the OS is started. The scheduler starts running and picks the highest priority task (task 1 in this case). The task handler function for task 1 is called and will keep running until it yields execution. Before yielding, code in the task 1 handler function calls the API provided by task 2. The semaphore being accessed in the task 2 API has yet to be initialized since the task 2 handler function has not had a chance to run! This will lead to undesirable behavior and will need to be addressed by the application developer. Note that the Mynewt OS does guard against internal API being called before the OS has started (they will return error) but it does not safeguard application defined objects from access prior to initialization.",
"title": "Basic OS Application Creation"
},
{
"location": "/os/core_os/mynewt_os/#example",
- "text": "One way to avoid initialization issues like the one described above is to perform task initializations prior to starting the OS. The code example shown below illustrates this concept. The application initializes the OS, calls an application specific \"task initialization\" function, and then starts the OS. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling os_task_init() ). In the example, each task works in a ping-pong like fashion: task 1 wakes up, adds a token to semaphore 1 and then waits for a token from semaphore 2. Task 2 waits for a token on semaphore 1 and once it gets it, adds a token to semaphore 2. Notice that the semaphores are initialized by the application specific task initialization functions and not inside the task handler functions. If task 2 (being lower in priority than task 1) had ca
lled os_sem_init() for task2_sem inside task2_handler() , task 1 would have called os_sem_pend() using task2_sem before task2_sem was initialized. /* Task 1 handler function */ \n void \n task1_handler ( void *arg )\n {\n while ( 1 ) {\n /* Release semaphore to task 2 */ \n os_sem_release ( task1_sem );\n\n /* Wait for semaphore from task 2 */ \n os_sem_pend ( task2_sem , OS_TIMEOUT_NEVER );\n }\n }\n\n /* Task 2 handler function */ \n void \n task2_handler ( void *arg )\n {\n struct os_task *t ;\n\n while ( 1 ) {\n /* Wait for semaphore from task1 */ \n os_sem_pend ( task1_sem , OS_TIMEOUT_NEVER );\n\n /* Release task2 semaphore */ \n os_sem_release ( task2_sem );\n }\n }\n\n\n /* Initialize task 1 exposed data objects */ \n void \n task1_init ( void )\n {\n /* Initialize t
ask1 semaphore */ \n os_sem_init ( task1_sem , 0 );\n }\n\n /* Initialize task 2 exposed data objects */ \n void \n task2_init ( void )\n {\n /* Initialize task1 semaphore */ \n os_sem_init ( task2_sem , 0 );\n }\n\n /** * init_app_tasks * * Called by main.c after os_init(). This function performs initializations * that are required before tasks are running. * * @return int 0 success; error otherwise. */ \n static int \n init_app_tasks ( void )\n {\n /* * Initialize tasks 1 and 2. Note that the task handlers are not called yet; they will * be called when the OS is started. */ \n os_task_init ( task1 , task1 , task1_handler , NULL , TASK1_PRIO , \n OS_WAIT_FOREVER , task1_stack , TASK1_STACK_SIZE );\n\n os_task_init ( task2 , task2 , task2_handler , NULL , TASK2_PRIO , \n
OS_WAIT_FOREVER , task2_stack , TASK2_STACK_SIZE );\n\n /* Call task specific initialization functions. */ \n task1_init ();\n task2_init ();\n\n return 0 ;\n }\n\n /** * main * * The main function for the application. This function initializes the os, calls * the application specific task initialization function. then starts the * OS. We should not return from os start! */ \n int \n main ( void )\n {\n int i ;\n int rc ;\n uint32_t seed ;\n\n /* Initialize OS */ \n os_init ();\n\n /* Initialize application specific tasks */ \n init_app_tasks ();\n\n /* Start the OS */ \n os_start ();\n\n /* os start should never return. If it does, this should be an error */ \n assert ( 0 );\n\n return rc ;\n }",
+ "text": "One way to avoid initialization issues like the one described above is for the application to \ninitialize the objects that are accessed by multiple tasks before it initializes the tasks with the OS. The code example shown below illustrates this concept. The application initializes system and packages, calls an application specific \"task initialization\" function, and dispatches events from the default event queue. The application task initialization function is responsible for initializing all the data objects that each task exposes to the other tasks. The tasks themselves are also initialized at this time (by calling os_task_init() ). In the example, each task works in a ping-pong like fashion: task 1 wakes up, adds a token to semaphore 1 and then waits for a token from semaphore 2. Task 2 waits for a token on semaphore 1 and once it gets it, adds a token to semaphore 2. Notice that the semaphores are initialized by the application specific task initial
ization functions and not inside the task handler functions. If task 2 (being lower in priority than task 1) had called os_sem_init() for task2_sem inside task2_handler() , task 1 would have called os_sem_pend() using task2_sem before task2_sem was initialized. struct os_sem task1_sem ;\n struct os_sem task2_sem ;\n\n /* Task 1 handler function */ \n void \n task1_handler ( void *arg )\n {\n while ( 1 ) {\n /* Release semaphore to task 2 */ \n os_sem_release ( task1_sem );\n\n /* Wait for semaphore from task 2 */ \n os_sem_pend ( task2_sem , OS_TIMEOUT_NEVER );\n }\n }\n\n /* Task 2 handler function */ \n void \n task2_handler ( void *arg )\n {\n struct os_task *t ;\n\n while ( 1 ) {\n /* Wait for semaphore from task1 */ \n os_sem_pend ( task1_sem , OS_TIMEOUT_NEVER );\n\n /* Release task2 semaphore */
\n os_sem_release ( task2_sem );\n }\n }\n\n\n /* Initialize task 1 exposed data objects */ \n void \n task1_init ( void )\n {\n /* Initialize task1 semaphore */ \n os_sem_init ( task1_sem , 0 );\n }\n\n /* Initialize task 2 exposed data objects */ \n void \n task2_init ( void )\n {\n /* Initialize task1 semaphore */ \n os_sem_init ( task2_sem , 0 );\n }\n\n /** * init_app_tasks * * This function performs initializations that are required before tasks run. * * @return int 0 success; error otherwise. */ \n static int \n init_app_tasks ( void )\n {\n /* * Call task specific initialization functions to initialize any shared objects * before initializing the tasks with the OS. */ \n task1_init ();\n task2_init ();\n\n /* * Initialize tasks 1 and 2 with the OS.
*/ \n os_task_init ( task1 , task1 , task1_handler , NULL , TASK1_PRIO , \n OS_WAIT_FOREVER , task1_stack , TASK1_STACK_SIZE );\n\n os_task_init ( task2 , task2 , task2_handler , NULL , TASK2_PRIO , \n OS_WAIT_FOREVER , task2_stack , TASK2_STACK_SIZE );\n\n return 0 ;\n }\n\n /** * main * * The main function for the application. This function initializes the system and packages, * calls the application specific task initialization function, then waits and dispatches * events from the OS default event queue in an infinite loop. */ \n int \n main ( int argc , char **arg )\n {\n\n /* Perform system and package initialization */ \n sysinit ();\n\n /* Initialize application specific tasks */ \n init_app_tasks ();\n\n while ( 1 ) {\n os_eventq_run ( os_eventq_dflt_get ());\n }\n
/* main never returns */ \n}",
"title": "Example"
},
{
"location": "/os/core_os/mynewt_os/#os-functions",
- "text": "The functions available at the OS level are: os_init os_start os_started",
+ "text": "The functions available at the OS level are: os_started",
"title": "OS Functions"
},
{
- "location": "/os/core_os/os_init/",
- "text": "os_init\n\n\nvoid\n \nos_init\n(\nvoid\n)\n\n\n\n\n\nInitializes the OS. Must be called before the OS is started (i.e. \nos_start()\n is called).\n\n\n\n\nArguments\n\n\nNone\n\n\n\n\nReturned values\n\n\nNone\n\n\n\n\nNotes\n\n\nThe call to \nos_init()\n performs architecture and bsp initializations and initializes the idle task.\n\n\nThis function does not start the OS, the OS time tick interrupt, or the scheduler.",
- "title": "os_init"
- },
- {
- "location": "/os/core_os/os_init/#os_init",
- "text": "void os_init ( void ) Initializes the OS. Must be called before the OS is started (i.e. os_start() is called).",
- "title": "os_init"
- },
- {
- "location": "/os/core_os/os_init/#arguments",
- "text": "None",
- "title": "Arguments"
- },
- {
- "location": "/os/core_os/os_init/#returned-values",
- "text": "None",
- "title": "Returned values"
- },
- {
- "location": "/os/core_os/os_init/#notes",
- "text": "The call to os_init() performs architecture and bsp initializations and initializes the idle task. This function does not start the OS, the OS time tick interrupt, or the scheduler.",
- "title": "Notes"
- },
- {
- "location": "/os/core_os/os_start/",
- "text": "os_start\n\n\nvoid\n \nos_start\n(\nvoid\n)\n\n\n\n\n\nStarts the OS by initializing and enabling the OS time tick and starting the scheduler.\n\n\nThis function does not return.\n\n\n\n\nArguments\n\n\nNone\n\n\n\n\nReturned values\n\n\nNone (does not return).\n\n\n\n\nNotes\n\n\nOnce \nos_start()\n has been called, context is switched to the highest priority task that was initialized prior to calling \nos_start()\n.",
- "title": "os_start"
- },
- {
- "location": "/os/core_os/os_start/#os_start",
- "text": "void os_start ( void ) Starts the OS by initializing and enabling the OS time tick and starting the scheduler. This function does not return.",
- "title": "os_start"
- },
- {
- "location": "/os/core_os/os_start/#arguments",
- "text": "None",
- "title": "Arguments"
- },
- {
- "location": "/os/core_os/os_start/#returned-values",
- "text": "None (does not return).",
- "title": "Returned values"
- },
- {
- "location": "/os/core_os/os_start/#notes",
- "text": "Once os_start() has been called, context is switched to the highest priority task that was initialized prior to calling os_start() .",
- "title": "Notes"
- },
- {
"location": "/os/core_os/os_started/",
"text": "os_started\n\n\nint\n \nos_started\n(\nvoid\n)\n\n\n\n\n\nReturns 'true' (1) if the os has been started; 0 otherwise.\n\n\n\n\nArguments\n\n\nNone\n\n\n\n\nReturned values\n\n\nInteger value with 0 meaning the OS has not been started and 1 indicating the OS has been started (i.e. \nos_start()\n has been called).",
"title": "os_started"
@@ -2567,7 +2517,7 @@
},
{
"location": "/os/core_os/task/task/",
- "text": "Task\n\n\nA task, along with the scheduler, forms the basis of the Mynewt OS. A task \nconsists of two basic elements: a task stack and a task function. The task \nfunction is basically a forever loop, waiting for some \"event\" to wake it up. \nThere are two methods used to signal a task that it has work to do: \nevent queues\n \nand \nsemaphores\n .\n\n\nThe Mynewt OS is a multi-tasking, preemptive OS. Every task is assigned a task \npriority (from 0 to 255), with 0 being the highest priority task. If a higher \npriority task than the current task wants to run, the scheduler preempts the \ncurrently running task and switches context to the higher priority task. This is \njust a fancy way of saying that the processor stack pointer now points to the \nstack of the higher priority task and the task resumes execution where it left \noff.\n\n\nTasks run to completion unless they are preempted by a higher priority task. The \ndeveloper must ensure that tasks eventua
lly \"sleep\"; otherwise lower priority \ntasks will never get a chance to run (actually, any task lower in priority than \nthe task that never sleeps). A task will be put to sleep in the following cases: \nit puts itself to sleep using \nos_time_delay()\n, it waits on an \nevent queue\n\nwhich is empty or attempts to obtain a mutex or a \nsemaphore\n that is currently \nowned by another task.\n\n\nNote that other sections of the manual describe these OS features in more \ndetail.\n\n\nDescription\n\n\nIn order to create a task two data structures need to be defined: the task \nobject (\nstruct os_task\n) and its associated stack. Determining the stack size can \nbe a bit tricky; generally developers should not declare large local variables \non the stack so that task stacks can be of limited size. However, all \napplications are different and the developer must choose the stack size \naccordingly. NOTE: be careful when declaring your stack! The stack is in units \nof \nos_stack_t\
n sized elements (generally 32-bits). Looking at the example given \nbelow and assuming \nos_stack_t\n is defined to be a 32-bit unsigned value, \n\"my_task_stack\" will use 256 bytes. \n\n\nA task must also have an associated \"task function\". This is the function that \nwill be called when the task is first run. This task function should never \nreturn!\n\n\nIn order to inform the Mynewt OS of the new task and to have it added to the \nscheduler, the \nos_task_init()\n function is called. Once \nos_task_init()\n is \ncalled, the task is made ready to run and is added to the active task list. Note \nthat a task can be initialized (started) before or after the os has started \n(i.e. before \nos_start()\n is called) but must be initialized after the os has \nbeen initialized (i.e. 'os_init()' has been called). In most of the examples and \ncurrent Mynewt projects, the os is initialized, tasks are initialized, and the \nthe os is started. Once the os has started, the highest priority
task will be \nthe first task set to run.\n\n\nInformation about a task can be obtained using the \nos_task_info_get_next()\n \nAPI. Developers can walk the list of tasks to obtain information on all created \ntasks. This information is of type \nos_task_info\n and is described below.\n\n\nThe following is a very simple example showing a single application task. This \ntask simply toggles an LED at a one second interval.\n\n\n/* Create a simple \nproject\n with a task that blinks a LED every second */\n\n\n\n/* Define task stack and task object */\n\n\n#define MY_TASK_PRI (OS_TASK_PRI_HIGHEST) \n\n\n#define MY_STACK_SIZE (64) \n\n\nstruct\n \nos_task\n \nmy_task\n; \n\nos_stack_t\n \nmy_task_stack\n[\nMY_STACK_SIZE\n]; \n\n\n/* This is the task function */\n\n\nvoid\n \nmy_task_func\n(\nvoid\n \n*arg\n) {\n \n/* Set the led pin as an output */\n\n \nhal_gpio_init_out\n(\nLED_BLINK_PIN\n, \n1\n);\n\n \n/* The task is a forever loop that does not return */\n\n
\nwhile\n (\n1\n) {\n \n/* Wait one second */\n \n \nos_time_delay\n(\n1000\n);\n\n \n/* Toggle the LED */\n \n \nhal_gpio_toggle\n(\nLED_BLINK_PIN\n);\n }\n}\n\n\n/* This is the main function for the project */\n\n\nint\n \nmain\n(\nvoid\n) {\n \nint\n \nrc\n;\n\n \n/* Initialize OS */\n\n \nos_init\n();\n\n \n/* Initialize the task */\n\n \nos_task_init\n(\nmy_task\n, \nmy_task\n, \nmy_task_func\n, \nNULL\n, \nMY_TASK_PRIO\n, \n \nOS_WAIT_FOREVER\n, \nmy_task_stack\n, \nMY_STACK_SIZE\n);\n\n \n/* Start the OS */\n\n \nos_start\n();\n\n \n/* os start should never return. If it does, this should be an error */\n\n \nassert\n(\n0\n);\n\n \nreturn\n \nrc\n;\n}\n\n\n\n\n\nData structures\n\n\n/* The highest and lowest task priorities */\n\n\n#define OS_TASK_PRI_HIGHEST (0)\n\n\n#define OS_TASK_PRI_LOWEST (0xff)\n\n\n\n/* Task states */\n\n\ntypedef\n \nenum\n \nos_task_state\n {\n \nOS_T
ASK_READY\n \n=\n \n1\n, \n \nOS_TASK_SLEEP\n \n=\n \n2\n\n} \nos_task_state_t\n;\n\n\n/* Task flags */\n\n\n#define OS_TASK_FLAG_NO_TIMEOUT (0x0001U)\n\n\n#define OS_TASK_FLAG_SEM_WAIT (0x0002U)\n\n\n#define OS_TASK_FLAG_MUTEX_WAIT (0x0004U)\n\n\n\ntypedef\n \nvoid\n (\n*\nos_task_func_t\n)(\nvoid\n \n*\n);\n\n\n#define OS_TASK_MAX_NAME_LEN (32)\n\n\n\n\n\n\n\n\nstruct\n \nos_task\n {\n \nos_stack_t\n \n*t_stackptr\n;\n \nos_stack_t\n \n*t_stacktop\n;\n\n \nuint16_t\n \nt_stacksize\n;\n \nuint16_t\n \nt_flags\n;\n\n \nuint8_t\n \nt_taskid\n;\n \nuint8_t\n \nt_prio\n;\n \nuint8_t\n \nt_state\n;\n \nuint8_t\n \nt_pad\n;\n\n \nchar\n \n*t_name\n;\n \nos_task_func_t\n \nt_func\n;\n \nvoid\n \n*t_arg\n;\n\n \nvoid\n \n*t_obj\n;\n\n \nstruct\n \nos_sanity_check\n \nt_sanity_check\n; \n\n \nos_time_t\n \nt_next_wakeup\n;\n \nos_time_t\n \nt_run_time\n;\n \nuint32_t\n \nt_ctx_sw_cnt\n;\n\n \n/* Global list of all tasks, ir
respective of run or sleep lists */\n\n \nSTAILQ_ENTRY\n(\nos_task\n) \nt_os_task_list\n;\n\n \n/* Used to chain task to either the run or sleep list */\n \n \nTAILQ_ENTRY\n(\nos_task\n) \nt_os_list\n;\n\n \n/* Used to chain task to an object such as a semaphore or mutex */\n\n \nSLIST_ENTRY\n(\nos_task\n) \nt_obj_list\n;\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nt_stackptr\n\n\nCurrent stack pointer\n\n\n\n\n\n\nt_stacktop\n\n\nThe address of the top of the task stack. The stack grows downward\n\n\n\n\n\n\nt_stacksize\n\n\nThe size of the stack, in units of os_stack_t (not bytes!)\n\n\n\n\n\n\nt_flags\n\n\nTask flags (see flag definitions)\n\n\n\n\n\n\nt_taskid\n\n\nA numeric id assigned to each task\n\n\n\n\n\n\nt_prio\n\n\nThe priority of the task. The lower the number, the higher the priority\n\n\n\n\n\n\nt_state\n\n\nThe task state (see state definitions)\n\n\n\n\n\n\nt_pad\n\n\npadding (for alignment)\n\n\n\n\n\n\nt_name\n\n\nName
of task\n\n\n\n\n\n\nt_func\n\n\nPointer to task function\n\n\n\n\n\n\nt_obj\n\n\nGeneric object used by mutexes and semaphores when the task is waiting on a mutex or semaphore\n\n\n\n\n\n\nt_sanity_check\n\n\nSanity task data structure\n\n\n\n\n\n\nt_next_wakeup\n\n\nOS time when task is next scheduled to wake up\n\n\n\n\n\n\nt_run_time\n\n\nThe amount of os time ticks this task has been running\n\n\n\n\n\n\nt_ctx_sw_cnt\n\n\nThe number of times that this task has been run\n\n\n\n\n\n\nt_os_task_list\n\n\nList pointer for global task list. All tasks are placed on this list\n\n\n\n\n\n\nt_os_list\n\n\nList pointer used by either the active task list or the sleeping task list\n\n\n\n\n\n\nt_obj_list\n\n\nList pointer for tasks waiting on a semaphore or mutex\n\n\n\n\n\n\n\n\n\n\nstruct\n \nos_task_info\n {\n \nuint8_t\n \noti_prio\n;\n \nuint8_t\n \noti_taskid\n;\n \nuint8_t\n \noti_state\n;\n \nuint8_t\n \noti_flags\n;\n \nuint16_t\n \noti_stkusage\n;\n \nuint16_t\
n \noti_stksize\n;\n \nuint32_t\n \noti_cswcnt\n;\n \nuint32_t\n \noti_runtime\n;\n \nos_time_t\n \noti_last_checkin\n;\n \nos_time_t\n \noti_next_checkin\n;\n\n \nchar\n \noti_name\n[\nOS_TASK_MAX_NAME_LEN\n];\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\noti_prio\n\n\nTask priority\n\n\n\n\n\n\noti_taskid\n\n\nTask id\n\n\n\n\n\n\noti_state\n\n\nTask state\n\n\n\n\n\n\noti_flags\n\n\nTask flags\n\n\n\n\n\n\noti_stkusage\n\n\nAmount of stack used by the task (in os_stack_t units)\n\n\n\n\n\n\noti_stksize\n\n\nThe size of the stack (in os_stack_t units)\n\n\n\n\n\n\noti_cswcnt\n\n\nThe context switch count\n\n\n\n\n\n\noti_runtime\n\n\nThe amount of time that the task has run (in os time ticks)\n\n\n\n\n\n\noti_last_checkin\n\n\nThe time (os time) at which this task last checked in to the sanity task\n\n\n\n\n\n\noti_next_checkin\n\n\nThe time (os time) at which this task last checked in to the sanity task\n\n\n\n\n\n\noti_name\n\n\nName of
the task\n\n\n\n\n\n\n\n\n\n\nList of Functions\n\n\nThe functions available in task are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nos_task_init\n\n\nCalled to create a task. This adds the task object to the list of ready to run tasks.\n\n\n\n\n\n\nos_task_count\n\n\nReturns the number of tasks that have been created.\n\n\n\n\n\n\nos_task_info_get_next\n\n\nPopulates the os task info structure given with task information.",
+ "text": "Task\n\n\nA task, along with the scheduler, forms the basis of the Mynewt OS. A task \nconsists of two basic elements: a task stack and a task function. The task \nfunction is basically a forever loop, waiting for some \"event\" to wake it up. \nThere are two methods used to signal a task that it has work to do: \nevent queues\n \nand \nsemaphores\n .\n\n\nThe Mynewt OS is a multi-tasking, preemptive OS. Every task is assigned a task \npriority (from 0 to 255), with 0 being the highest priority task. If a higher \npriority task than the current task wants to run, the scheduler preempts the \ncurrently running task and switches context to the higher priority task. This is \njust a fancy way of saying that the processor stack pointer now points to the \nstack of the higher priority task and the task resumes execution where it left \noff.\n\n\nTasks run to completion unless they are preempted by a higher priority task. The \ndeveloper must ensure that tasks eventua
lly \"sleep\"; otherwise lower priority \ntasks will never get a chance to run (actually, any task lower in priority than \nthe task that never sleeps). A task will be put to sleep in the following cases: \nit puts itself to sleep using \nos_time_delay()\n, it waits on an \nevent queue\n\nwhich is empty or attempts to obtain a mutex or a \nsemaphore\n that is currently \nowned by another task.\n\n\nNote that other sections of the manual describe these OS features in more \ndetail.\n\n\nDescription\n\n\nIn order to create a task two data structures need to be defined: the task \nobject (\nstruct os_task\n) and its associated stack. Determining the stack size can \nbe a bit tricky; generally developers should not declare large local variables \non the stack so that task stacks can be of limited size. However, all \napplications are different and the developer must choose the stack size \naccordingly. NOTE: be careful when declaring your stack! The stack is in units \nof \nos_stack_t\
n sized elements (generally 32-bits). Looking at the example given \nbelow and assuming \nos_stack_t\n is defined to be a 32-bit unsigned value, \n\"my_task_stack\" will use 256 bytes. \n\n\nA task must also have an associated \"task function\". This is the function that \nwill be called when the task is first run. This task function should never \nreturn!\n\n\nIn order to inform the Mynewt OS of the new task and to have it added to the \nscheduler, the \nos_task_init()\n function is called. Once \nos_task_init()\n is \ncalled, the task is made ready to run and is added to the active task list. Note \nthat a task can be initialized (started) before or after the os has started \n(i.e. before \nos_start()\n is called) but must be initialized after the os has \nbeen initialized (i.e. 'os_init()' has been called). In most of the examples and \ncurrent Mynewt projects, the os is initialized, tasks are initialized, and the \nthe os is started. Once the os has started, the highest priority
task will be \nthe first task set to run.\n\n\nInformation about a task can be obtained using the \nos_task_info_get_next()\n \nAPI. Developers can walk the list of tasks to obtain information on all created \ntasks. This information is of type \nos_task_info\n and is described below.\n\n\nThe following is a very simple example showing a single application task. This \ntask simply toggles an LED at a one second interval.\n\n\n/* Create a simple \nproject\n with a task that blinks a LED every second */\n\n\n\n/* Define task stack and task object */\n\n\n#define MY_TASK_PRI (OS_TASK_PRI_HIGHEST) \n\n\n#define MY_STACK_SIZE (64) \n\n\nstruct\n \nos_task\n \nmy_task\n; \n\nos_stack_t\n \nmy_task_stack\n[\nMY_STACK_SIZE\n]; \n\n\n/* This is the task function */\n\n\nvoid\n \nmy_task_func\n(\nvoid\n \n*arg\n) {\n \n/* Set the led pin as an output */\n\n \nhal_gpio_init_out\n(\nLED_BLINK_PIN\n, \n1\n);\n\n \n/* The task is a forever loop that does not return */\n\n
\nwhile\n (\n1\n) {\n \n/* Wait one second */\n \n \nos_time_delay\n(\n1000\n);\n\n \n/* Toggle the LED */\n \n \nhal_gpio_toggle\n(\nLED_BLINK_PIN\n);\n }\n}\n\n\n/* This is the main function for the project */\n\n\nint\n \nmain\n(\nint\n \nargc\n, \nchar\n \n**argv\n) \n{\n\n \n/* Perform system and package initialization */\n\n \nsysinit\n();\n\n \n/* Initialize the task */\n\n \nos_task_init\n(\nmy_task\n, \nmy_task\n, \nmy_task_func\n, \nNULL\n, \nMY_TASK_PRIO\n, \n \nOS_WAIT_FOREVER\n, \nmy_task_stack\n, \nMY_STACK_SIZE\n);\n\n \n/* Process events from the default event queue. */\n\n \nwhile\n (\n1\n) {\n \nos_eventq_run\n(\nos_eventq_dflt_get\n());\n }\n \n/* main never returns */\n \n}\n\n\n\n\n\nData structures\n\n\n/* The highest and lowest task priorities */\n\n\n#define OS_TASK_PRI_HIGHEST (0)\n\n\n#define OS_TASK_PRI_LOWEST (0xff)\n\n\n\n/* Task states */\n\n\ntypedef\n \
nenum\n \nos_task_state\n {\n \nOS_TASK_READY\n \n=\n \n1\n, \n \nOS_TASK_SLEEP\n \n=\n \n2\n\n} \nos_task_state_t\n;\n\n\n/* Task flags */\n\n\n#define OS_TASK_FLAG_NO_TIMEOUT (0x0001U)\n\n\n#define OS_TASK_FLAG_SEM_WAIT (0x0002U)\n\n\n#define OS_TASK_FLAG_MUTEX_WAIT (0x0004U)\n\n\n\ntypedef\n \nvoid\n (\n*\nos_task_func_t\n)(\nvoid\n \n*\n);\n\n\n#define OS_TASK_MAX_NAME_LEN (32)\n\n\n\n\n\n\n\n\nstruct\n \nos_task\n {\n \nos_stack_t\n \n*t_stackptr\n;\n \nos_stack_t\n \n*t_stacktop\n;\n\n \nuint16_t\n \nt_stacksize\n;\n \nuint16_t\n \nt_flags\n;\n\n \nuint8_t\n \nt_taskid\n;\n \nuint8_t\n \nt_prio\n;\n \nuint8_t\n \nt_state\n;\n \nuint8_t\n \nt_pad\n;\n\n \nchar\n \n*t_name\n;\n \nos_task_func_t\n \nt_func\n;\n \nvoid\n \n*t_arg\n;\n\n \nvoid\n \n*t_obj\n;\n\n \nstruct\n \nos_sanity_check\n \nt_sanity_check\n; \n\n \nos_time_t\n \nt_next_wakeup\n;\n \nos_time_t\n \nt_run_time\n;\n \nuint32_t\n \nt_ctx_sw_cnt\n;\n
\n \n/* Global list of all tasks, irrespective of run or sleep lists */\n\n \nSTAILQ_ENTRY\n(\nos_task\n) \nt_os_task_list\n;\n\n \n/* Used to chain task to either the run or sleep list */\n \n \nTAILQ_ENTRY\n(\nos_task\n) \nt_os_list\n;\n\n \n/* Used to chain task to an object such as a semaphore or mutex */\n\n \nSLIST_ENTRY\n(\nos_task\n) \nt_obj_list\n;\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nt_stackptr\n\n\nCurrent stack pointer\n\n\n\n\n\n\nt_stacktop\n\n\nThe address of the top of the task stack. The stack grows downward\n\n\n\n\n\n\nt_stacksize\n\n\nThe size of the stack, in units of os_stack_t (not bytes!)\n\n\n\n\n\n\nt_flags\n\n\nTask flags (see flag definitions)\n\n\n\n\n\n\nt_taskid\n\n\nA numeric id assigned to each task\n\n\n\n\n\n\nt_prio\n\n\nThe priority of the task. The lower the number, the higher the priority\n\n\n\n\n\n\nt_state\n\n\nThe task state (see state definitions)\n\n\n\n\n\n\nt_pad\n\n\npadding (for al
ignment)\n\n\n\n\n\n\nt_name\n\n\nName of task\n\n\n\n\n\n\nt_func\n\n\nPointer to task function\n\n\n\n\n\n\nt_obj\n\n\nGeneric object used by mutexes and semaphores when the task is waiting on a mutex or semaphore\n\n\n\n\n\n\nt_sanity_check\n\n\nSanity task data structure\n\n\n\n\n\n\nt_next_wakeup\n\n\nOS time when task is next scheduled to wake up\n\n\n\n\n\n\nt_run_time\n\n\nThe amount of os time ticks this task has been running\n\n\n\n\n\n\nt_ctx_sw_cnt\n\n\nThe number of times that this task has been run\n\n\n\n\n\n\nt_os_task_list\n\n\nList pointer for global task list. All tasks are placed on this list\n\n\n\n\n\n\nt_os_list\n\n\nList pointer used by either the active task list or the sleeping task list\n\n\n\n\n\n\nt_obj_list\n\n\nList pointer for tasks waiting on a semaphore or mutex\n\n\n\n\n\n\n\n\n\n\nstruct\n \nos_task_info\n {\n \nuint8_t\n \noti_prio\n;\n \nuint8_t\n \noti_taskid\n;\n \nuint8_t\n \noti_state\n;\n \nuint8_t\n \noti_flags\n;\n \nuint16
_t\n \noti_stkusage\n;\n \nuint16_t\n \noti_stksize\n;\n \nuint32_t\n \noti_cswcnt\n;\n \nuint32_t\n \noti_runtime\n;\n \nos_time_t\n \noti_last_checkin\n;\n \nos_time_t\n \noti_next_checkin\n;\n\n \nchar\n \noti_name\n[\nOS_TASK_MAX_NAME_LEN\n];\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\noti_prio\n\n\nTask priority\n\n\n\n\n\n\noti_taskid\n\n\nTask id\n\n\n\n\n\n\noti_state\n\n\nTask state\n\n\n\n\n\n\noti_flags\n\n\nTask flags\n\n\n\n\n\n\noti_stkusage\n\n\nAmount of stack used by the task (in os_stack_t units)\n\n\n\n\n\n\noti_stksize\n\n\nThe size of the stack (in os_stack_t units)\n\n\n\n\n\n\noti_cswcnt\n\n\nThe context switch count\n\n\n\n\n\n\noti_runtime\n\n\nThe amount of time that the task has run (in os time ticks)\n\n\n\n\n\n\noti_last_checkin\n\n\nThe time (os time) at which this task last checked in to the sanity task\n\n\n\n\n\n\noti_next_checkin\n\n\nThe time (os time) at which this task last checked in to the sanity t
ask\n\n\n\n\n\n\noti_name\n\n\nName of the task\n\n\n\n\n\n\n\n\n\n\nList of Functions\n\n\nThe functions available in task are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nos_task_init\n\n\nCalled to create a task. This adds the task object to the list of ready to run tasks.\n\n\n\n\n\n\nos_task_count\n\n\nReturns the number of tasks that have been created.\n\n\n\n\n\n\nos_task_info_get_next\n\n\nPopulates the os task info structure given with task information.",
"title": "toc"
},
{
@@ -2577,7 +2527,7 @@
},
{
"location": "/os/core_os/task/task/#description",
- "text": "In order to create a task two data structures need to be defined: the task \nobject ( struct os_task ) and its associated stack. Determining the stack size can \nbe a bit tricky; generally developers should not declare large local variables \non the stack so that task stacks can be of limited size. However, all \napplications are different and the developer must choose the stack size \naccordingly. NOTE: be careful when declaring your stack! The stack is in units \nof os_stack_t sized elements (generally 32-bits). Looking at the example given \nbelow and assuming os_stack_t is defined to be a 32-bit unsigned value, \n\"my_task_stack\" will use 256 bytes. A task must also have an associated \"task function\". This is the function that \nwill be called when the task is first run. This task function should never \nreturn! In order to inform the Mynewt OS of the new task and to have it added to the \nscheduler, the os_task_init() function is called. Once o
s_task_init() is \ncalled, the task is made ready to run and is added to the active task list. Note \nthat a task can be initialized (started) before or after the os has started \n(i.e. before os_start() is called) but must be initialized after the os has \nbeen initialized (i.e. 'os_init()' has been called). In most of the examples and \ncurrent Mynewt projects, the os is initialized, tasks are initialized, and the \nthe os is started. Once the os has started, the highest priority task will be \nthe first task set to run. Information about a task can be obtained using the os_task_info_get_next() \nAPI. Developers can walk the list of tasks to obtain information on all created \ntasks. This information is of type os_task_info and is described below. The following is a very simple example showing a single application task. This \ntask simply toggles an LED at a one second interval. /* Create a simple project with a task that blinks a LED every second */ /* Define task st
ack and task object */ #define MY_TASK_PRI (OS_TASK_PRI_HIGHEST) #define MY_STACK_SIZE (64) struct os_task my_task ; os_stack_t my_task_stack [ MY_STACK_SIZE ]; /* This is the task function */ void my_task_func ( void *arg ) {\n /* Set the led pin as an output */ \n hal_gpio_init_out ( LED_BLINK_PIN , 1 );\n\n /* The task is a forever loop that does not return */ \n while ( 1 ) {\n /* Wait one second */ \n os_time_delay ( 1000 );\n\n /* Toggle the LED */ \n hal_gpio_toggle ( LED_BLINK_PIN );\n }\n} /* This is the main function for the project */ int main ( void ) {\n int rc ;\n\n /* Initialize OS */ \n os_init ();\n\n /* Initialize the task */ \n os_task_init ( my_task , my_task , my_task_func , NULL , MY_TASK_PRIO , \n OS_WAIT_FOREVER , my_task_stack , MY_STACK_SIZE );\n\n /* Start the OS */ \n os_start ();\n\n /* os start should never r
eturn. If it does, this should be an error */ \n assert ( 0 );\n\n return rc ;\n}",
+ "text": "In order to create a task two data structures need to be defined: the task \nobject ( struct os_task ) and its associated stack. Determining the stack size can \nbe a bit tricky; generally developers should not declare large local variables \non the stack so that task stacks can be of limited size. However, all \napplications are different and the developer must choose the stack size \naccordingly. NOTE: be careful when declaring your stack! The stack is in units \nof os_stack_t sized elements (generally 32-bits). Looking at the example given \nbelow and assuming os_stack_t is defined to be a 32-bit unsigned value, \n\"my_task_stack\" will use 256 bytes. A task must also have an associated \"task function\". This is the function that \nwill be called when the task is first run. This task function should never \nreturn! In order to inform the Mynewt OS of the new task and to have it added to the \nscheduler, the os_task_init() function is called. Once o
s_task_init() is \ncalled, the task is made ready to run and is added to the active task list. Note \nthat a task can be initialized (started) before or after the os has started \n(i.e. before os_start() is called) but must be initialized after the os has \nbeen initialized (i.e. 'os_init()' has been called). In most of the examples and \ncurrent Mynewt projects, the os is initialized, tasks are initialized, and the \nthe os is started. Once the os has started, the highest priority task will be \nthe first task set to run. Information about a task can be obtained using the os_task_info_get_next() \nAPI. Developers can walk the list of tasks to obtain information on all created \ntasks. This information is of type os_task_info and is described below. The following is a very simple example showing a single application task. This \ntask simply toggles an LED at a one second interval. /* Create a simple project with a task that blinks a LED every second */ /* Define task st
ack and task object */ #define MY_TASK_PRI (OS_TASK_PRI_HIGHEST) #define MY_STACK_SIZE (64) struct os_task my_task ; os_stack_t my_task_stack [ MY_STACK_SIZE ]; /* This is the task function */ void my_task_func ( void *arg ) {\n /* Set the led pin as an output */ \n hal_gpio_init_out ( LED_BLINK_PIN , 1 );\n\n /* The task is a forever loop that does not return */ \n while ( 1 ) {\n /* Wait one second */ \n os_time_delay ( 1000 );\n\n /* Toggle the LED */ \n hal_gpio_toggle ( LED_BLINK_PIN );\n }\n} /* This is the main function for the project */ int main ( int argc , char **argv ) \n{\n\n /* Perform system and package initialization */ \n sysinit ();\n\n /* Initialize the task */ \n os_task_init ( my_task , my_task , my_task_func , NULL , MY_TASK_PRIO , \n OS_WAIT_FOREVER , my_task_stack , MY_STACK_SIZE );\n\n /* Process events from the default e
vent queue. */ \n while ( 1 ) {\n os_eventq_run ( os_eventq_dflt_get ());\n }\n /* main never returns */ \n}",
"title": "Description"
},
{
@@ -4752,17 +4702,17 @@
},
{
"location": "/os/modules/console/console/",
- "text": "Console\n\n\nThe console is an operating system window where users interact with system programs of the operating system \nor a console application by entering text input (typically from a keyboard) and reading text output \n(typically on the computer terminal or monitor). The text written on the console brings some information \nand is a sequence of characters sent by the OS or programs running on the OS. \n\n\nSupport is currently available for console access via the serial port on the hardware board.\n\n\nDescription\n\n\nIn the Mynewt OS, the console library comes in two versions:\n\n\n\n\nfull - containing the full implementation\n\n\nstub - containing stubs for the API\n\n\n\n\nBoth of these have a \npkg.yml\n file which states that they provide the \nconsole\n API. If a pkg uses \nthis API, it should list \nconsole\n as a requirement. For example, the shell pkg is defined by the \nfollowing pkg.yml file:\n\n\n pkg.name: libs/shell \n pkg.vers: 0.1\n
pkg.deps:\n - libs/os\n - libs/util\n pkg.reqs:\n - console\n pkg.identities:\n - SHELL \n\n\n\n\n\nThe project .yml file decides which version of the console pkg should be included. \nIf a project requires the full console capability it lists dependency \nlibs/console/full\n in its pkg.yml \nfile. On the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to) \nbut may have a dependency on a pkg that has console capability. In that case you would use a console stub. \n\n\nAnother example would be the bootloader project where we want to keep the size of the image small. It includes \nthe \nlibs/os\n pkg that can print out messages on a console (e.g. if there is a hard fault) and the \nlibs/util\n \npkg that uses the full console (but only if SHELL is present to provide a CLI). However, we do not want to use \nany console I/O capability in this particular bootloader project to keep the size small. We simp
ly use the console \nstub instead, and the pkg.yml file for the project boot pkg looks like the following:\n\n\n project.name: boot\n project.identities: bootloader\n project.pkgs:\n - libs/os\n - libs/bootutil\n - libs/nffs\n - libs/console/stub\n - libs/util \n\n\n\n\n\nConsole has 2 modes for transmit; \nblocking mode\n and \nnon-blocking mode\n. Usually the \nnon-blocking mode\n is the \nactive one; the output buffer is drained by getting TX completion interrupts from hardware, and more data is added \nbased on these interrupts.\n\n\nBlocking mode\n is used when we don't want TX completion interrupts. It is used when system crashes, and we still \nwant to output info related to that crash.\n\n\nConsole, by default, echoes everything it receives back. Terminal programs expect this, and is a way for the user to \nknow that the console is connected and responsive. Whether echoing happens or not can be controlled programmatically.\n\n\nThe
Console also has a prompt that is configurable. It is off by default but can be turned on programatically. The\nprompt cahracter can also be changed by the user.\n\n\nData structures\n\n\nN/A\n\n\nList of Functions\n\n\nThe functions available in console are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nconsole_blocking_mode\n\n\nCalls the \nconsole_blocking_tx\n function to flush the buffered console output (transmit) queue.\n\n\n\n\n\n\nconsole_echo\n\n\nControls whether echoing is on or off for the console.\n\n\n\n\n\n\nconsole_init\n\n\nInitialize the console.\n\n\n\n\n\n\nconsole_is_init\n\n\nReturns whether console has been initialized or not.\n\n\n\n\n\n\nconsole_printf\n\n\nWrites a formatted message instead of raw output to the console.\n\n\n\n\n\n\nconsole_read\n\n\nCopies up the to given number of bytes to the input string.\n\n\n\n\n\n\nconsole_write\n\n\nQueues characters to console display over serial port.",
+ "text": "Console\n\n\nThe console is an operating system window where users interact with the OS subsystems or a console \napplication. A user typically inputs text from a keyboard and reads the OS output text on a computer\nmonitor. The text are sent as a sequence of characters between the user and the OS. \n\n\nSupport is currently available for console access via the serial port on the hardware board.\n\n\nDescription\n\n\nIn the Mynewt OS, the console library comes in two versions:\n\n\n\n\n\n\nThe \nsys/console/full\n package implements the complete console functionality and API.\n\n\n\n\n\n\nThe \nsys/console/stub\n package implements stubs for the API.\n\n\n\n\n\n\nBoth packages export the \nconsole\n API, and any package that uses \nthe console API must list \nconsole\n as a requirement. For example, the shell package defines the following \npkg.yml\n\nfile:\n\n\npkg.name: sys/shell\npkg.deps:\n - kernel/os\n - encoding/base64\n - time/datetime\n -
util/crc\npkg.req_apis:\n - console\n\n\n\n\n\nThe project \npkg.yml\n file specifies the version of the console package to use.\nA project that requires the full console capability must list the \nsys/console/full\n package as a dependency \nin its \npkg.yml\n file.\n\n\nAn example is the \nslinky\n application. It requires the full console capability and has the following\n\npkg.yml\n file: \n\n\npkg.name: apps/slinky\npkg.deps:\n - test/flash_test\n - mgmt/imgmgr\n - mgmt/newtmgr\n - mgmt/newtmgr/transport/nmgr_shell\n - kernel/os\n - boot/bootutil\n - sys/shell\n - sys/console/full\n ...\n - sys/id\n\n\n\n\n\nOn the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to) \nbut may have a dependency on a package that has console capability. In this case, you use \nthe console stub API and list the \nsys/console/stub\n package as a dependency in its \npkg.yml\n file. \n\n\nAn example is the bootloader pr
oject where we want to keep the size of the image small. It includes \nthe \nkernel/os\n package that can print out messages on a console (e.g. if there is a hard fault).\nHowever, we do not want to use any console I/O capability in this particular bootloader project to \nkeep the size small. The project uses the console stub API and has the following \npkg.yml\n file: \n\n\npkg.name: apps/boot\npkg.deps:\n - boot/bootutil\n - kernel/os\n - sys/console/stub\n\n\n\n\n\nConsole has 2 modes for transmit; \nblocking mode\n and \nnon-blocking mode\n. Usually the \nnon-blocking mode\n is the \nactive one; the output buffer is drained by getting TX completion interrupts from hardware, and more data is added \nbased on these interrupts.\n\n\nBlocking mode\n is used when we don't want TX completion interrupts. It is used when system crashes, and we still \nwant to output info related to that crash.\n\n\nConsole, by default, echoes everything it receives back. Terminal programs expec
t this, and is a way for the user to \nknow that the console is connected and responsive. Whether echoing happens or not can be controlled programmatically.\n\n\nThe Console also has a prompt that is configurable. It is off by default but can be turned on programmatically. The\nprompt character can also be changed by the user.\n\n\nData structures\n\n\nN/A\n\n\nList of Functions\n\n\nThe functions available in console are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nconsole_blocking_mode\n\n\nCalls the \nconsole_blocking_tx\n function to flush the buffered console output (transmit) queue.\n\n\n\n\n\n\nconsole_echo\n\n\nControls whether echoing is on or off for the console.\n\n\n\n\n\n\nconsole_init\n\n\nInitialize the console.\n\n\n\n\n\n\nconsole_is_init\n\n\nReturns whether console has been initialized or not.\n\n\n\n\n\n\nconsole_printf\n\n\nWrites a formatted message instead of raw output to the console.\n\n\n\n\n\n\nconsole_read\n\n\nCopies up the to given n
umber of bytes to the input string.\n\n\n\n\n\n\nconsole_write\n\n\nQueues characters to console display over serial port.",
"title": "toc"
},
{
"location": "/os/modules/console/console/#console",
- "text": "The console is an operating system window where users interact with system programs of the operating system \nor a console application by entering text input (typically from a keyboard) and reading text output \n(typically on the computer terminal or monitor). The text written on the console brings some information \nand is a sequence of characters sent by the OS or programs running on the OS. Support is currently available for console access via the serial port on the hardware board.",
+ "text": "The console is an operating system window where users interact with the OS subsystems or a console \napplication. A user typically inputs text from a keyboard and reads the OS output text on a computer\nmonitor. The text are sent as a sequence of characters between the user and the OS. Support is currently available for console access via the serial port on the hardware board.",
"title": "Console"
},
{
"location": "/os/modules/console/console/#description",
- "text": "In the Mynewt OS, the console library comes in two versions: full - containing the full implementation stub - containing stubs for the API Both of these have a pkg.yml file which states that they provide the console API. If a pkg uses \nthis API, it should list console as a requirement. For example, the shell pkg is defined by the \nfollowing pkg.yml file: pkg.name: libs/shell \n pkg.vers: 0.1\n pkg.deps:\n - libs/os\n - libs/util\n pkg.reqs:\n - console\n pkg.identities:\n - SHELL The project .yml file decides which version of the console pkg should be included. \nIf a project requires the full console capability it lists dependency libs/console/full in its pkg.yml \nfile. On the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to) \nbut may have a dependency on a pkg that has console capability. In that case you would use a console stub. Another example w
ould be the bootloader project where we want to keep the size of the image small. It includes \nthe libs/os pkg that can print out messages on a console (e.g. if there is a hard fault) and the libs/util \npkg that uses the full console (but only if SHELL is present to provide a CLI). However, we do not want to use \nany console I/O capability in this particular bootloader project to keep the size small. We simply use the console \nstub instead, and the pkg.yml file for the project boot pkg looks like the following: project.name: boot\n project.identities: bootloader\n project.pkgs:\n - libs/os\n - libs/bootutil\n - libs/nffs\n - libs/console/stub\n - libs/util Console has 2 modes for transmit; blocking mode and non-blocking mode . Usually the non-blocking mode is the \nactive one; the output buffer is drained by getting TX completion interrupts from hardware, and more data is added \nbased on these interrupts. Blocking mode
is used when we don't want TX completion interrupts. It is used when system crashes, and we still \nwant to output info related to that crash. Console, by default, echoes everything it receives back. Terminal programs expect this, and is a way for the user to \nknow that the console is connected and responsive. Whether echoing happens or not can be controlled programmatically. The Console also has a prompt that is configurable. It is off by default but can be turned on programatically. The\nprompt cahracter can also be changed by the user.",
+ "text": "In the Mynewt OS, the console library comes in two versions: The sys/console/full package implements the complete console functionality and API. The sys/console/stub package implements stubs for the API. Both packages export the console API, and any package that uses \nthe console API must list console as a requirement. For example, the shell package defines the following pkg.yml \nfile: pkg.name: sys/shell\npkg.deps:\n - kernel/os\n - encoding/base64\n - time/datetime\n - util/crc\npkg.req_apis:\n - console The project pkg.yml file specifies the version of the console package to use.\nA project that requires the full console capability must list the sys/console/full package as a dependency \nin its pkg.yml file. An example is the slinky application. It requires the full console capability and has the following pkg.yml file: pkg.name: apps/slinky\npkg.deps:\n - test/flash_test\n - mgmt/imgmgr\n - mgmt/newtm
gr\n - mgmt/newtmgr/transport/nmgr_shell\n - kernel/os\n - boot/bootutil\n - sys/shell\n - sys/console/full\n ...\n - sys/id On the other hand, a project may not have a physical console (e.g. a UART port to connect a terminal to) \nbut may have a dependency on a package that has console capability. In this case, you use \nthe console stub API and list the sys/console/stub package as a dependency in its pkg.yml file. An example is the bootloader project where we want to keep the size of the image small. It includes \nthe kernel/os package that can print out messages on a console (e.g. if there is a hard fault).\nHowever, we do not want to use any console I/O capability in this particular bootloader project to \nkeep the size small. The project uses the console stub API and has the following pkg.yml file: pkg.name: apps/boot\npkg.deps:\n - boot/bootutil\n - kernel/os\n - sys/console/stub Console has 2 modes for transmit; blocking mode a
nd non-blocking mode . Usually the non-blocking mode is the \nactive one; the output buffer is drained by getting TX completion interrupts from hardware, and more data is added \nbased on these interrupts. Blocking mode is used when we don't want TX completion interrupts. It is used when system crashes, and we still \nwant to output info related to that crash. Console, by default, echoes everything it receives back. Terminal programs expect this, and is a way for the user to \nknow that the console is connected and responsive. Whether echoing happens or not can be controlled programmatically. The Console also has a prompt that is configurable. It is off by default but can be turned on programmatically. The\nprompt character can also be changed by the user.",
"title": "Description"
},
{
@@ -4962,17 +4912,17 @@
},
{
"location": "/os/modules/shell/shell/",
- "text": "Shell\n\n\nThe shell is package sitting on top of console, handling 2 jobs: processing console input and implementing \n\nnewtmgr\n line protocol over serial line. Shell runs in its own task.\n\n\nDescription\n\n\n\n\n\n\nShell's first job is directing incoming commands to other subsystems. It parses the incoming character string \nand splits it into tokens. Then it looks for the subsystem to handle this command based on the first token of input.\n\n\n\n\n\n\nSubsystems register their command handlers using \nshell_cmd_register()\n. When shell calls the command handler, it passes the other tokens as arguments.\n\n\n\n\n\n\nA few commands are currently available in the shell - \ntasks\n, \nlog\n, \necho\n, \ndate\n and \nprompt\n.\n\n\n\n\n\n\n\n\n\n\nShell's second job is doing framing, encoding and decoding newtmgr protocol when it's carried over the console. \nProtocol handler (libs/newtmgr) registers itself using \nshell_nlip_input_register()\n, and shell cal
ls the registered \nhandler for every frame. Outgoing frames for the protocol are sent using \nshell_nlip_output()\n.\n\n\n\n\n\n\n\n\nCreate a sim target to check out these commands available in shell.\n\n\nuser@~/dev/larva$ newt target create blinky_sim\nCreating target blinky_sim\nTarget blinky_sim successfully created!\nuser@~/dev/larva$ newt target set blinky_sim name=blinky_sim\nTarget blinky_sim successfully set name to blinky_sim\nuser@~/dev/larva$ newt target set blinky_sim arch=sim\nTarget blinky_sim successfully set arch to sim\nuser@~/dev/larva$ newt target set blinky_sim project=blinky\nTarget blinky_sim successfully set project to blinky\nuser@~/dev/larva$ newt target set blinky_sim bsp=hw/bsp/native\nTarget blinky_sim successfully set bsp to hw/bsp/native\nuser@~/dev/larva$ newt target set blinky_sim compiler_def=debug\nTarget blinky_sim successfully set compiler_def to debug\nuser@~/dev/larva$ newt target set blinky_sim compiler=sim\nTarget blinky_sim successfully se
t compiler to sim\nuser@~/dev/larva$ newt target show\nblinky_sim\n arch: sim\n bsp: hw/bsp/native\n compiler: sim\n compiler_def: debug\n name: blinky_sim\n project: blinky\nuser@~/dev/larva$ newt target build blinky_sim\nBuilding target blinky_sim (project = blinky)\nCompiling case.c\nCompiling suite.c\nCompiling testutil.c\n..\n..\nBuilding project blinky\nLinking blinky.elf\nSuccessfully run!\n\nuser@~/dev/larva$ ./project/blinky/bin/blinky_sim/blinky.elf\nuart0 at /dev/ttys005\n\n\n\n\n\nOpen up a new terminal to run minicom, a text-based serial port control and terminal emulation program. Set device name to the serial port of the target. \n\n\nuser@~$ minicom -D /dev/ttys005\nWelcome to minicom 2.7\n\nOPTIONS: \nCompiled on Nov 24 2015, 16:14:21.\nPort /dev/ttys005, 11:32:17\n\nPress Meta-Z for help on special keys\n\nlog \n174578:[0] bla\n174578:[0] bab\n\ntasks\n217809:6 tasks: \n217809: shell (prio: 3, nw: 0, flags: 0x0, ssize: 0, cswcnt: 59, tot_run_time
: 0ms)\n217840: idle (prio: 255, nw: 0, flags: 0x0, ssize: 0, cswcnt: 18763, tot_run_time: 217809ms)\n217878: uart_poller (prio: 0, nw: 217819, flags: 0x0, ssize: 0, cswcnt: 18667, tot_run_time: 0ms)\n217923: task1 (prio: 1, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n217953: os_sanity (prio: 254, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n218010: task2 (prio: 2, nw: 217709, flags: 0x3, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n\n\nprompt\nUsage: prompt [set|show] [prompt_char]\nprompt set \n\nPrompt set to: \n\n229370: \n\n\n\n\n\n\nData structures\n\n\nThis data structure is used in holding information about registered command handlers.\n\n\nstruct\n \nshell_cmd\n {\n \nchar\n \n*sc_cmd\n;\n \nshell_cmd_func_t\n \nsc_cmd_func\n;\n \nSTAILQ_ENTRY\n(\nshell_cmd\n) \nsc_next\n;\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nsc_cmd\n\n\nCharacter string of the command\n\n\n\n\n\n\nsc_cmd_func\n\n\n
Pointer to the command handler\n\n\n\n\n\n\nsc_next\n\n\nBookkeeping linkage internal for shell\n\n\n\n\n\n\n\n\nList of Functions\n\n\n\n\nThe functions available in this OS feature are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nshell_task_init\n\n\nInitializes the shell package. This creates a task for shell, and registers few commands on its own.\n\n\n\n\n\n\nshell_cmd_register\n\n\nRegisters a handler for incoming console commands.\n\n\n\n\n\n\nshell_nlip_input_register\n\n\nRegisters a handler for incoming newtmgr messages.\n\n\n\n\n\n\nshell_nlip_output\n\n\nQueue outgoing newtmgr message for transmission.",
+ "text": "Shell\n\n\nThe shell runs above the console and provides two functionalities:\n\n\n\n\nProcesses console input. \n\n\nImplements the \nnewtmgr\n line protocol over serial transport. \n\n\n\n\nThe \nsys/shell\n package implements the shell. The shell uses the OS default event queue \nfor shell events and runs in the context of the main task. An application can, optionally, \nspecify a dedicated event queue for the shell to use.\n\n\nDescription\n\n\n\n\n\n\nThe shell's first job is to direct incoming commands to other subsystems. It parses the incoming character string \ninto tokens and uses the first token to determine the subsystem command handler to call to process the command.\n\n\n\n\n\n\nSubsystems register their command handlers using the \nshell_cmd_register()\n \n function. When shell calls the command handler, it passes the other tokens as arguments.\n\n\n\n\n\n\nA few commands are currently available in the shell - \ntasks\n, \nlog\n, \necho\n, \nda
te\n and \nprompt\n.\n\n\n\n\n\n\n\n\n\n\nThe shell's second job is to handle packet framing, encoding, and decoding of newtmgr protocol messages that are\nsent over the console. The Newtmgr serial transport package (\nmgmt/newtmgr/transport/newtmgr_shell\n) \ncalls the \nshell_nlip_input_register()\n function to register a handler that the shell calls when it \nreceives newtmgr request messages.\n\n\n\n\n\n\n\n\nCreate a sim target to check out these commands available in shell.\n\n\nuser@~/dev/larva$ newt target create blinky_sim\nCreating target blinky_sim\nTarget blinky_sim successfully created!\nuser@~/dev/larva$ newt target set blinky_sim name=blinky_sim\nTarget blinky_sim successfully set name to blinky_sim\nuser@~/dev/larva$ newt target set blinky_sim arch=sim\nTarget blinky_sim successfully set arch to sim\nuser@~/dev/larva$ newt target set blinky_sim project=blinky\nTarget blinky_sim successfully set project to blinky\nuser@~/dev/larva$ newt target set blinky_sim bsp=hw/b
sp/native\nTarget blinky_sim successfully set bsp to hw/bsp/native\nuser@~/dev/larva$ newt target set blinky_sim compiler_def=debug\nTarget blinky_sim successfully set compiler_def to debug\nuser@~/dev/larva$ newt target set blinky_sim compiler=sim\nTarget blinky_sim successfully set compiler to sim\nuser@~/dev/larva$ newt target show\nblinky_sim\n arch: sim\n bsp: hw/bsp/native\n compiler: sim\n compiler_def: debug\n name: blinky_sim\n project: blinky\nuser@~/dev/larva$ newt target build blinky_sim\nBuilding target blinky_sim (project = blinky)\nCompiling case.c\nCompiling suite.c\nCompiling testutil.c\n..\n..\nBuilding project blinky\nLinking blinky.elf\nSuccessfully run!\n\nuser@~/dev/larva$ ./project/blinky/bin/blinky_sim/blinky.elf\nuart0 at /dev/ttys005\n\n\n\n\n\nOpen up a new terminal to run minicom, a text-based serial port control and terminal emulation program. Set device name to the serial port of the target. \n\n\nuser@~$ minicom -D /dev/ttys005\nWelco
me to minicom 2.7\n\nOPTIONS: \nCompiled on Nov 24 2015, 16:14:21.\nPort /dev/ttys005, 11:32:17\n\nPress Meta-Z for help on special keys\n\nlog \n174578:[0] bla\n174578:[0] bab\n\ntasks\n217809:6 tasks: \n217809: shell (prio: 3, nw: 0, flags: 0x0, ssize: 0, cswcnt: 59, tot_run_time: 0ms)\n217840: idle (prio: 255, nw: 0, flags: 0x0, ssize: 0, cswcnt: 18763, tot_run_time: 217809ms)\n217878: uart_poller (prio: 0, nw: 217819, flags: 0x0, ssize: 0, cswcnt: 18667, tot_run_time: 0ms)\n217923: task1 (prio: 1, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n217953: os_sanity (prio: 254, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n218010: task2 (prio: 2, nw: 217709, flags: 0x3, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n\n\nprompt\nUsage: prompt [set|show] [prompt_char]\nprompt set \n\nPrompt set to: \n\n229370: \n\n\n\n\n\n\nData structures\n\n\nThis data structure is used in holding information about registered command handlers.\n\n\nstruct\n
\nshell_cmd\n {\n \nchar\n \n*sc_cmd\n;\n \nshell_cmd_func_t\n \nsc_cmd_func\n;\n \nSTAILQ_ENTRY\n(\nshell_cmd\n) \nsc_next\n;\n};\n\n\n\n\n\n\n\n\n\n\n\nElement\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nsc_cmd\n\n\nCharacter string of the command\n\n\n\n\n\n\nsc_cmd_func\n\n\nPointer to the command handler\n\n\n\n\n\n\nsc_next\n\n\nBookkeeping linkage internal for shell\n\n\n\n\n\n\n\n\nList of Functions\n\n\n\n\nThe functions available in this OS feature are:\n\n\n\n\n\n\n\n\nFunction\n\n\nDescription\n\n\n\n\n\n\n\n\n\n\nshell_cmd_register\n\n\nRegisters a handler for incoming console commands.\n\n\n\n\n\n\nshell_nlip_input_register\n\n\nRegisters a handler for incoming newtmgr messages.\n\n\n\n\n\n\nshell_nlip_output\n\n\nQueue outgoing newtmgr message for transmission.\n\n\n\n\n\n\nshell_evq_set\n\n\nSpecifies a dedicated event queue for shell events.",
"title": "toc"
},
{
"location": "/os/modules/shell/shell/#shell",
- "text": "The shell is package sitting on top of console, handling 2 jobs: processing console input and implementing newtmgr line protocol over serial line. Shell runs in its own task.",
+ "text": "The shell runs above the console and provides two functionalities: Processes console input. Implements the newtmgr line protocol over serial transport. The sys/shell package implements the shell. The shell uses the OS default event queue \nfor shell events and runs in the context of the main task. An application can, optionally, \nspecify a dedicated event queue for the shell to use.",
"title": "Shell"
},
{
"location": "/os/modules/shell/shell/#description",
- "text": "Shell's first job is directing incoming commands to other subsystems. It parses the incoming character string \nand splits it into tokens. Then it looks for the subsystem to handle this command based on the first token of input. Subsystems register their command handlers using shell_cmd_register() . When shell calls the command handler, it passes the other tokens as arguments. A few commands are currently available in the shell - tasks , log , echo , date and prompt . Shell's second job is doing framing, encoding and decoding newtmgr protocol when it's carried over the console. \nProtocol handler (libs/newtmgr) registers itself using shell_nlip_input_register() , and shell calls the registered \nhandler for every frame. Outgoing frames for the protocol are sent using shell_nlip_output() . Create a sim target to check out these commands available in shell. user@~/dev/larva$ newt target create blinky_sim\nCreating target blinky_sim\nTarget
blinky_sim successfully created!\nuser@~/dev/larva$ newt target set blinky_sim name=blinky_sim\nTarget blinky_sim successfully set name to blinky_sim\nuser@~/dev/larva$ newt target set blinky_sim arch=sim\nTarget blinky_sim successfully set arch to sim\nuser@~/dev/larva$ newt target set blinky_sim project=blinky\nTarget blinky_sim successfully set project to blinky\nuser@~/dev/larva$ newt target set blinky_sim bsp=hw/bsp/native\nTarget blinky_sim successfully set bsp to hw/bsp/native\nuser@~/dev/larva$ newt target set blinky_sim compiler_def=debug\nTarget blinky_sim successfully set compiler_def to debug\nuser@~/dev/larva$ newt target set blinky_sim compiler=sim\nTarget blinky_sim successfully set compiler to sim\nuser@~/dev/larva$ newt target show\nblinky_sim\n arch: sim\n bsp: hw/bsp/native\n compiler: sim\n compiler_def: debug\n name: blinky_sim\n project: blinky\nuser@~/dev/larva$ newt target build blinky_sim\nBuilding target blinky_sim (project = blinky)\nCom
piling case.c\nCompiling suite.c\nCompiling testutil.c\n..\n..\nBuilding project blinky\nLinking blinky.elf\nSuccessfully run!\n\nuser@~/dev/larva$ ./project/blinky/bin/blinky_sim/blinky.elf\nuart0 at /dev/ttys005 Open up a new terminal to run minicom, a text-based serial port control and terminal emulation program. Set device name to the serial port of the target. user@~$ minicom -D /dev/ttys005\nWelcome to minicom 2.7\n\nOPTIONS: \nCompiled on Nov 24 2015, 16:14:21.\nPort /dev/ttys005, 11:32:17\n\nPress Meta-Z for help on special keys\n\nlog \n174578:[0] bla\n174578:[0] bab\n\ntasks\n217809:6 tasks: \n217809: shell (prio: 3, nw: 0, flags: 0x0, ssize: 0, cswcnt: 59, tot_run_time: 0ms)\n217840: idle (prio: 255, nw: 0, flags: 0x0, ssize: 0, cswcnt: 18763, tot_run_time: 217809ms)\n217878: uart_poller (prio: 0, nw: 217819, flags: 0x0, ssize: 0, cswcnt: 18667, tot_run_time: 0ms)\n217923: task1 (prio: 1, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n217953: o
s_sanity (prio: 254, nw: 218710, flags: 0x0, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n218010: task2 (prio: 2, nw: 217709, flags: 0x3, ssize: 0, cswcnt: 218, tot_run_time: 0ms)\n\n\nprompt\nUsage: prompt [set|show] [prompt_char]\nprompt set \nPrompt set to: \n229370:",
+ "text": "The shell's first job is to direct incoming commands to other subsystems. It parses the incoming character string \ninto tokens and uses the first token to determine the subsystem command handler to call to process the command. Subsystems register their command handlers using the shell_cmd_register() \n function. When shell calls the command handler, it passes the other tokens as arguments. A few commands are currently available in the shell - tasks , log , echo , date and prompt . The shell's second job is to handle packet framing, encoding, and decoding of newtmgr protocol messages that are\nsent over the console. The Newtmgr serial transport package ( mgmt/newtmgr/transport/newtmgr_shell ) \ncalls the shell_nlip_input_register() function to register a handler that the shell calls when it \nreceives newtmgr request messages. Create a sim target to check out these commands available in shell. user@~/dev/larva$ newt target create bli
nky_sim\nCreating target blinky_sim\nTarget blinky_sim successfully created!\nuser@~/dev/larva$ newt target set blinky_sim name=blinky_sim\nTarget blinky_sim successfully set name to blinky_sim\nuser@~/dev/larva$ newt target set blinky_sim arch=sim\nTarget blinky_sim successfully set arch to sim\nuser@~/dev/larva$ newt target set blinky_sim project=blinky\nTarget blinky_sim successfully set project to blinky\nuser@~/dev/larva$ newt target set blinky_sim bsp=hw/bsp/native\nTarget blinky_sim successfully set bsp to hw/bsp/native\nuser@~/dev/larva$ newt target set blinky_sim compiler_def=debug\nTarget blinky_sim successfully set compiler_def to debug\nuser@~/dev/larva$ newt target set blinky_sim compiler=sim\nTarget blinky_sim successfully set compiler to sim\nuser@~/dev/larva$ newt target show\nblinky_sim\n arch: sim\n bsp: hw/bsp/native\n compiler: sim\n compiler_def: debug\n name: blinky_sim\n project: blinky\nuser@~/dev/larva$ newt target build blinky_sim\nBuildin
g target blinky_
<TRUNCATED>