You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mynewt.apache.org by GitBox <gi...@apache.org> on 2018/07/04 01:54:10 UTC
[GitHub] aditihilbert closed pull request #454: automated asf-site build
aditihilbert closed pull request #454: automated asf-site build
URL: https://github.com/apache/mynewt-site/pull/454
This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:
As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):
diff --git a/about/index.html b/about/index.html
index 339cad125..9c4bf1557 100644
--- a/about/index.html
+++ b/about/index.html
@@ -227,7 +227,7 @@ <h3 id="feature-request">Feature Request</h3>
<p>If you have suggestions for a new feature, use case, or implementation improvements, file a JIRA ticket with Issue Type set to "Wish". Introduce it in the <a href="../dev@mynewt.incubator.apache.org">dev@</a> mailing list with a link to the JIRA ticket. This assumes you have signed up for an account on JIRA and submitted a request to the dev@ mailing list for your JIRA username to be added to the Apache Mynewt (MYNEWT) project.</p>
<p><br></p>
<h3 id="faq">FAQ</h3>
-<p><font color="#F2853F"> Questions? </font> Click <a href="../latest/faq/answers">here</a></p>
+<p><font color="#F2853F"> Questions? </font> Click <a href="../latest/mynewt_faq.html">here</a></p>
</div>
</div>
diff --git a/develop/_static/common.html b/develop/_static/common.html
deleted file mode 100644
index e831c4424..000000000
--- a/develop/_static/common.html
+++ /dev/null
@@ -1,313 +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">
-
-
-
-
- <title><no title> — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../genindex.html"/>
- <link rel="search" title="Search" href="../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../index.html"/>
-
-
- <script src="js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" 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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <no title>
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/_static/common.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul>
-<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
-
-
- </div>
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt 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">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="jquery.js"></script>
- <script type="text/javascript" src="underscore.js"></script>
- <script type="text/javascript" src="doctools.js"></script>
- <script type="text/javascript" src="js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="js/affix.js"></script>
- <script type="text/javascript" src="js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/concepts.html b/develop/concepts.html
deleted file mode 100644
index 4821f8ab9..000000000
--- a/develop/concepts.html
+++ /dev/null
@@ -1,510 +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">
-
-
-
-
- <title>Concepts — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="genindex.html"/>
- <link rel="search" title="Search" href="search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="index.html"/>
- <link rel="next" title="Tutorials" href="tutorials/tutorials.html"/>
- <link rel="prev" title="Using the Serial Port with Mynewt OS" href="get_started/serial_access.html"/>
-
-
- <script src="_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- Concepts
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/concepts.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="vocabulary">
-<span id="concepts"></span><span id="id1"></span><h1>Concepts<a class="headerlink" href="#vocabulary" title="Permalink to this headline">¶</a></h1>
-<p>This page is meant to introduce you to some of the concepts inherent to
-the Apache Mynewt Operating System, and <em>Newt</em> the tool that stitches a
-project built on Apache Mynewt together.</p>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#project" id="id2">Project</a></li>
-<li><a class="reference internal" href="#package" id="id3">Package</a></li>
-<li><a class="reference internal" href="#target" id="id4">Target</a></li>
-<li><a class="reference internal" href="#configuration" id="id5">Configuration</a></li>
-</ul>
-</div>
-<div class="section" id="project">
-<h2><a class="toc-backref" href="#id2">Project</a><a class="headerlink" href="#project" title="Permalink to this headline">¶</a></h2>
-<p>The project is the base directory of your embedded software tree. It is
-a workspace that contains a logical collection of source code, for one
-or more of your applications. A project consists of the following items:</p>
-<ul class="simple">
-<li>Project Definition: defines project level dependencies, and
-parameters (located in <code class="docutils literal notranslate"><span class="pre">project.yml</span></code>)</li>
-<li>Packages</li>
-</ul>
-<p><a class="reference internal" href="#package">Package</a> are described in detail in the section below.</p>
-<p>Here is an example project definition file from the default Apache
-Mynewt project:</p>
-<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="c1"># project.yml</span>
-<span class="c1"># <snip></span>
-<span class="l l-Scalar l-Scalar-Plain">project.name</span><span class="p p-Indicator">:</span> <span class="s">"my_project"</span>
-
-<span class="l l-Scalar l-Scalar-Plain">project.repositories</span><span class="p p-Indicator">:</span>
- <span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">apache-mynewt-core</span>
-
-<span class="c1"># Use github's distribution mechanism for core ASF libraries.</span>
-<span class="c1"># This provides mirroring automatically for us.</span>
-<span class="c1">#</span>
-<span class="l l-Scalar l-Scalar-Plain">repository.apache-mynewt-core</span><span class="p p-Indicator">:</span>
- <span class="l l-Scalar l-Scalar-Plain">type</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">github</span>
- <span class="l l-Scalar l-Scalar-Plain">vers</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">1-latest</span>
- <span class="l l-Scalar l-Scalar-Plain">user</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">apache</span>
- <span class="l l-Scalar l-Scalar-Plain">repo</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">mynewt-core</span>
-</pre></div>
-</div>
-<p>A couple of things to note in the project definition:</p>
-<ul class="simple">
-<li><code class="docutils literal notranslate"><span class="pre">project.repositories</span></code>: Defines the remote repositories that this
-project relies upon.</li>
-<li><code class="docutils literal notranslate"><span class="pre">repository.apache-mynewt-core</span></code>: Defines the repository information
-for the <code class="docutils literal notranslate"><span class="pre">apache-mynewt-core</span></code> repository.</li>
-<li><code class="docutils literal notranslate"><span class="pre">vers=1-latest</span></code>: Defines the repository version. This string will
-use the latest stable version in the ‘Master’ github branch. To use
-the latest version in the master branch, just change it to
-<code class="docutils literal notranslate"><span class="pre">vers=0-dev</span></code>. Note that this branch might not be stable.</li>
-</ul>
-<p>Repositories are versioned collections of packages.</p>
-<p>Projects can rely on remote repositories for functionality, and the newt
-tool will resolve those remote repositories, and download the correct
-version into your local source tree. Newly fetched repositories are put
-in the <code class="docutils literal notranslate"><span class="pre">repos</span></code> directory of your project, and can be referenced
-throughout the system by using the <code class="docutils literal notranslate"><span class="pre">@</span></code> specifier.</p>
-<p>By default, the <code class="docutils literal notranslate"><span class="pre">@apache-mynewt-core</span></code> repository is included in every
-project. Apache Mynewt Core contains all the base functionality of the
-Apache Mynewt Operating System, including the Real Time Kernel,
-Bluetooth Networking Stack, Flash File System, Console, Shell and
-Bootloader.</p>
-<p><em>NOTE:</em> Any project can be converted into a repository by providing it
-with a <code class="docutils literal notranslate"><span class="pre">repository.yml</span></code> file and putting it up onto Github. More
-information about repositories can be found in the Newt documentation.</p>
-</div>
-<div class="section" id="package">
-<h2><a class="toc-backref" href="#id3">Package</a><a class="headerlink" href="#package" title="Permalink to this headline">¶</a></h2>
-<p>A package is a collection items that form a fundamental unit in the
-Mynewt Operating System. Packages can be:</p>
-<ul class="simple">
-<li>Applications</li>
-<li>Libraries</li>
-<li>Compiler definitions</li>
-<li>Targets</li>
-</ul>
-<p>A package is identified by having a <code class="docutils literal notranslate"><span class="pre">pkg.yml</span></code> file in it’s base
-directory. Here is a sample <code class="docutils literal notranslate"><span class="pre">pkg.yml</span></code> file for the blinky applicaton:</p>
-<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="c1"># pkg.yml</span>
-<span class="c1"># <snip></span>
-<span class="l l-Scalar l-Scalar-Plain">pkg.name</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">apps/blinky</span>
-<span class="l l-Scalar l-Scalar-Plain">pkg.type</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">app</span>
-<span class="l l-Scalar l-Scalar-Plain">pkg.description</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">Basic example application which blinks an LED.</span>
-<span class="l l-Scalar l-Scalar-Plain">pkg.author</span><span class="p p-Indicator">:</span> <span class="s">"Apache</span><span class="nv"> </span><span class="s">Mynewt</span><span class="nv"> </span><span class="s"><dev@mynewt.apache.org>"</span>
-<span class="l l-Scalar l-Scalar-Plain">pkg.homepage</span><span class="p p-Indicator">:</span> <span class="s">"http://mynewt.apache.org/"</span>
-<span class="l l-Scalar l-Scalar-Plain">pkg.keywords</span><span class="p p-Indicator">:</span>
-
-<span class="l l-Scalar l-Scalar-Plain">pkg.deps</span><span class="p p-Indicator">:</span>
- <span class="p p-Indicator">-</span> <span class="s">"@apache-mynewt-core/libs/os"</span>
- <span class="p p-Indicator">-</span> <span class="s">"@apache-mynewt-core/hw/hal"</span>
- <span class="p p-Indicator">-</span> <span class="s">"@apache-mynewt-core/libs/console/full"</span>
-</pre></div>
-</div>
-<p>Packages have a few features worth noting:</p>
-<ul class="simple">
-<li>Dependencies: Packages can rely upon other packages, and when they do
-they will inherit their functionality (header files, library
-definitions, etc.)</li>
-<li>APIs: Packages can export named APIs, and they can require that
-certain APIs be present, in order to compile.</li>
-</ul>
-<p>Everything that newt knows about within a project’s directory is a
-package. This makes it very clean and easy to write re-usable
-components, which can describe their Dependencies and APIs to the rest
-of the system.</p>
-</div>
-<div class="section" id="target">
-<span id="mynewt-target"></span><h2><a class="toc-backref" href="#id4">Target</a><a class="headerlink" href="#target" title="Permalink to this headline">¶</a></h2>
-<p>A target in Apache Mynewt is very similar to a target in <em>make</em>. It is
-the collection of parameters that must be passed to Newt in order to
-generate a reproducible build. A target represents the top of the build
-tree, and any packages or parameters specified at the target level,
-cascade down to all dependencies.</p>
-<p>Targets are also packages, and are stored in the <code class="docutils literal notranslate"><span class="pre">targets/</span></code> directory
-at the base of your project. Most targets consist of:</p>
-<ul class="simple">
-<li><code class="docutils literal notranslate"><span class="pre">app</span></code>: The application to build.</li>
-<li><code class="docutils literal notranslate"><span class="pre">bsp</span></code>: The board support package to combine with that application</li>
-<li><code class="docutils literal notranslate"><span class="pre">build_profile</span></code>: Either <code class="docutils literal notranslate"><span class="pre">debug</span></code> or <code class="docutils literal notranslate"><span class="pre">optimized</span></code>.</li>
-</ul>
-<p>Targets can also have additional items specified, including:</p>
-<ul class="simple">
-<li><code class="docutils literal notranslate"><span class="pre">aflags</span></code>: Any additional assembler flags you might want to specify
-to the build.</li>
-<li><code class="docutils literal notranslate"><span class="pre">cflags</span></code>: Any additional compiler flags you might want to specify
-to the build.</li>
-<li><code class="docutils literal notranslate"><span class="pre">lflags</span></code>: Any additional linker flags you might want to specify to
-the build.</li>
-</ul>
-<p>In order to create and manipulate targets, the <em>newt</em> tool offers a set
-of helper commands, you can find more information about these by
-issuing:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> newt target
-<span class="go">Usage:</span>
-<span class="go"> newt target [flags]</span>
-<span class="go"> newt target [command]</span>
-
-<span class="go">Available Commands:</span>
-<span class="go"> amend Add, change, or delete values for multi-value target variables</span>
-<span class="go"> cmake</span>
-<span class="go"> config View or populate a target's system configuration</span>
-<span class="go"> copy Copy target</span>
-<span class="go"> create Create a target</span>
-<span class="go"> delete Delete target</span>
-<span class="go"> dep View target's dependency graph</span>
-<span class="go"> revdep View target's reverse-dependency graph</span>
-<span class="go"> set Set target configuration variable</span>
-<span class="go"> show View target configuration variables</span>
-
-<span class="go">Global Flags:</span>
-<span class="go"> -h, --help Help for newt commands</span>
-<span class="go"> -j, --jobs int Number of concurrent build jobs (default 2)</span>
-<span class="go"> -l, --loglevel string Log level (default "WARN")</span>
-<span class="go"> -o, --outfile string Filename to tee output to</span>
-<span class="go"> -q, --quiet Be quiet; only display error output</span>
-<span class="go"> -s, --silent Be silent; don't output anything</span>
-<span class="go"> -v, --verbose Enable verbose output when executing commands</span>
-
-<span class="go">Use "newt target [command] --help" for more information about a command.</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="configuration">
-<h2><a class="toc-backref" href="#id5">Configuration</a><a class="headerlink" href="#configuration" title="Permalink to this headline">¶</a></h2>
-<p>Additional help topics:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> newt target config show <target-name>
-<span class="go">...</span>
-<span class="go">* PACKAGE: sys/stats</span>
-<span class="go"> * Setting: STATS_CLI</span>
-<span class="go"> * Description: Expose the "stat" shell command.</span>
-<span class="go"> * Value: 0</span>
-<span class="go"> * Setting: STATS_NAMES</span>
-<span class="go"> * Description: Include and report the textual name of each statistic.</span>
-<span class="go"> * Value: 0</span>
-<span class="go"> * Setting: STATS_NEWTMGR</span>
-<span class="go"> * Description: Expose the "stat" newtmgr command.</span>
-<span class="go"> * Value: 0</span>
-<span class="go">...</span>
-<span class="gp">$</span>
-</pre></div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="tutorials/tutorials.html" class="btn btn-neutral float-right" title="Tutorials" accesskey="n">Next: Tutorials <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="get_started/serial_access.html" class="btn btn-neutral" title="Using the Serial Port with Mynewt OS" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Using the Serial Port with Mynewt OS</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'./',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="_static/js/affix.js"></script>
- <script type="text/javascript" src="_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/genindex.html b/develop/genindex.html
deleted file mode 100644
index 1eca7b2eb..000000000
--- a/develop/genindex.html
+++ /dev/null
@@ -1,1164 +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">
-
-
-
-
- <title>Index — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="#"/>
- <link rel="search" title="Search" href="search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="index.html"/>
-
-
- <script src="_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- Index
-
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul>
-<li class="toctree-l1"><a class="reference internal" href="index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
-
-<h1 id="index">Index</h1>
-
-<div class="genindex-jumpbox">
- <a href="#_"><strong>_</strong></a>
- | <a href="#C"><strong>C</strong></a>
- | <a href="#F"><strong>F</strong></a>
- | <a href="#H"><strong>H</strong></a>
- | <a href="#J"><strong>J</strong></a>
- | <a href="#L"><strong>L</strong></a>
- | <a href="#N"><strong>N</strong></a>
- | <a href="#O"><strong>O</strong></a>
- | <a href="#S"><strong>S</strong></a>
- | <a href="#T"><strong>T</strong></a>
-
-</div>
-<h2 id="_">_</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/hal/hal_bsp/hal_bsp.html#c._sbrk">_sbrk (C function)</a>
-</li>
- </ul></td>
-</tr></table>
-
-<h2 id="C">C</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/config/config.html#c.conf_bytes_from_str">conf_bytes_from_str (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_commit">conf_commit (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_ensure_loaded">conf_ensure_loaded (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_get_value">conf_get_value (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#_CPPv312conf_handler">conf_handler (C++ class)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_init">conf_init (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_load">conf_load (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_register">conf_register (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_save">conf_save (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_save_one">conf_save_one (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_save_tree">conf_save_tree (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_set_from_storage">conf_set_from_storage (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_set_value">conf_set_value (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_store_init">conf_store_init (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_str_from_bytes">conf_str_from_bytes (C function)</a>
-</li>
- </ul></td>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/config/config.html#c.conf_str_from_value">conf_str_from_value (C function)</a>
-</li>
- <li><a href="os/modules/config/config.html#c.conf_value_from_str">conf_value_from_str (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_blocking_mode">console_blocking_mode (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_echo">console_echo (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_handle_char">console_handle_char (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_init">console_init (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_is_init">console_is_init (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_line_event_put">console_line_event_put (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_line_queue_set">console_line_queue_set (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_non_blocking_mode">console_non_blocking_mode (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_out">console_out (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_printf">console_printf (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_read">console_read (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_rx_restart">console_rx_restart (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_set_completion_cb">console_set_completion_cb (C function)</a>
-</li>
- <li><a href="os/modules/console/console.html#c.console_write">console_write (C function)</a>
-</li>
- </ul></td>
-</tr></table>
-
-<h2 id="F">F</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_append">fcb_append (C function)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_append_finish">fcb_append_finish (C function)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_append_to_scratch">fcb_append_to_scratch (C function)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_clear">fcb_clear (C function)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#_CPPv39fcb_entry">fcb_entry (C++ class)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_free_sector_cnt">fcb_free_sector_cnt (C function)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_getnext">fcb_getnext (C function)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_init">fcb_init (C function)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_is_empty">fcb_is_empty (C function)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#_CPPv37fcb_log">fcb_log (C++ class)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_offset_last_n">fcb_offset_last_n (C function)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_rotate">fcb_rotate (C function)</a>
-</li>
- <li><a href="os/modules/fcb/fcb.html#c.fcb_walk">fcb_walk (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_close">fs_close (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_closedir">fs_closedir (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_dirent_is_dir">fs_dirent_is_dir (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_dirent_name">fs_dirent_name (C function)</a>
-</li>
- </ul></td>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/fs/fs.html#c.fs_filelen">fs_filelen (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_getpos">fs_getpos (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_mkdir">fs_mkdir (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_open">fs_open (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_opendir">fs_opendir (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs_add.html#c.fs_ops::SLIST_ENTRY">fs_ops::SLIST_ENTRY (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs_add.html#c.fs_ops_for">fs_ops_for (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs_add.html#c.fs_ops_from_container">fs_ops_from_container (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs_add.html#c.fs_ops_try_unique">fs_ops_try_unique (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_read">fs_read (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_readdir">fs_readdir (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs_add.html#c.fs_register">fs_register (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_rename">fs_rename (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_seek">fs_seek (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_unlink">fs_unlink (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fs_write">fs_write (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fsutil_read_file">fsutil_read_file (C function)</a>
-</li>
- <li><a href="os/modules/fs/fs.html#c.fsutil_write_file">fsutil_write_file (C function)</a>
-</li>
- </ul></td>
-</tr></table>
-
-<h2 id="H">H</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/hal/hal_bsp/hal_bsp.html#c.hal_bsp_core_dump">hal_bsp_core_dump (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_bsp/hal_bsp.html#c.hal_bsp_flash_dev">hal_bsp_flash_dev (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_bsp/hal_bsp.html#c.hal_bsp_get_nvic_priority">hal_bsp_get_nvic_priority (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_bsp/hal_bsp.html#c.hal_bsp_hw_id">hal_bsp_hw_id (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_bsp/hal_bsp.html#c.hal_bsp_hw_id_len">hal_bsp_hw_id_len (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_bsp/hal_bsp.html#c.hal_bsp_init">hal_bsp_init (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_bsp/hal_bsp.html#c.hal_bsp_power_state">hal_bsp_power_state (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_system/hal_sys.html#c.hal_debugger_connected">hal_debugger_connected (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_flash/hal_flash.html#c.hal_flash_align">hal_flash_align (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_flash/hal_flash.html#c.hal_flash_erase">hal_flash_erase (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_flash/hal_flash.html#c.hal_flash_erase_sector">hal_flash_erase_sector (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_flash/hal_flash.html#c.hal_flash_init">hal_flash_init (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_flash/hal_flash.html#c.hal_flash_ioctl">hal_flash_ioctl (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_flash/hal_flash.html#c.hal_flash_read">hal_flash_read (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_flash/hal_flash.html#c.hal_flash_write">hal_flash_write (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_gpio/hal_gpio.html#c.hal_gpio_init_in">hal_gpio_init_in (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_gpio/hal_gpio.html#c.hal_gpio_init_out">hal_gpio_init_out (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_gpio/hal_gpio.html#c.hal_gpio_irq_disable">hal_gpio_irq_disable (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_gpio/hal_gpio.html#c.hal_gpio_irq_enable">hal_gpio_irq_enable (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_gpio/hal_gpio.html#c.hal_gpio_irq_init">hal_gpio_irq_init (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_gpio/hal_gpio.html#c.hal_gpio_irq_release">hal_gpio_irq_release (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_gpio/hal_gpio.html#c.hal_gpio_read">hal_gpio_read (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_gpio/hal_gpio.html#c.hal_gpio_toggle">hal_gpio_toggle (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_gpio/hal_gpio.html#c.hal_gpio_write">hal_gpio_write (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_i2c/hal_i2c.html#c.hal_i2c_init">hal_i2c_init (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_i2c/hal_i2c.html#_CPPv319hal_i2c_master_data">hal_i2c_master_data (C++ class)</a>
-</li>
- <li><a href="os/modules/hal/hal_i2c/hal_i2c.html#c.hal_i2c_master_probe">hal_i2c_master_probe (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_i2c/hal_i2c.html#c.hal_i2c_master_read">hal_i2c_master_read (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_i2c/hal_i2c.html#c.hal_i2c_master_write">hal_i2c_master_write (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_system/hal_sys.html#c.hal_reset_cause">hal_reset_cause (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_system/hal_sys.html#c.hal_reset_cause_str">hal_reset_cause_str (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_abort">hal_spi_abort (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_config">hal_spi_config (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_data_mode_breakout">hal_spi_data_mode_breakout (C function)</a>
-</li>
- </ul></td>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_disable">hal_spi_disable (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_enable">hal_spi_enable (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_init">hal_spi_init (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_set_txrx_cb">hal_spi_set_txrx_cb (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#_CPPv316hal_spi_settings">hal_spi_settings (C++ class)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_slave_set_def_tx_val">hal_spi_slave_set_def_tx_val (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_tx_val">hal_spi_tx_val (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_txrx">hal_spi_txrx (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_spi/hal_spi.html#c.hal_spi_txrx_noblock">hal_spi_txrx_noblock (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_system/hal_sys.html#c.hal_system_clock_start">hal_system_clock_start (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_system/hal_sys.html#c.hal_system_reset">hal_system_reset (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_system/hal_sys.html#c.hal_system_restart">hal_system_restart (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_system/hal_sys.html#c.hal_system_start">hal_system_start (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#_CPPv39hal_timer">hal_timer (C++ class)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#c.hal_timer_config">hal_timer_config (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#c.hal_timer_deinit">hal_timer_deinit (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#c.hal_timer_delay">hal_timer_delay (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#c.hal_timer_get_resolution">hal_timer_get_resolution (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#c.hal_timer_init">hal_timer_init (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#c.hal_timer_read">hal_timer_read (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#c.hal_timer_set_cb">hal_timer_set_cb (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#c.hal_timer_start">hal_timer_start (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#c.hal_timer_start_at">hal_timer_start_at (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_timer/hal_timer.html#c.hal_timer_stop">hal_timer_stop (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_uart/hal_uart.html#c.hal_uart_blocking_tx">hal_uart_blocking_tx (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_uart/hal_uart.html#c.hal_uart_close">hal_uart_close (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_uart/hal_uart.html#c.hal_uart_config">hal_uart_config (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_uart/hal_uart.html#c.hal_uart_init">hal_uart_init (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_uart/hal_uart.html#c.hal_uart_init_cbs">hal_uart_init_cbs (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_uart/hal_uart.html#c.hal_uart_start_rx">hal_uart_start_rx (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_uart/hal_uart.html#c.hal_uart_start_tx">hal_uart_start_tx (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_watchdog/hal_watchdog.html#c.hal_watchdog_enable">hal_watchdog_enable (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_watchdog/hal_watchdog.html#c.hal_watchdog_init">hal_watchdog_init (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_watchdog/hal_watchdog.html#c.hal_watchdog_tickle">hal_watchdog_tickle (C function)</a>
-</li>
- </ul></td>
-</tr></table>
-
-<h2 id="J">J</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/json/json.html#c.json_encode_array_finish">json_encode_array_finish (C function)</a>
-</li>
- <li><a href="os/modules/json/json.html#c.json_encode_array_name">json_encode_array_name (C function)</a>
-</li>
- <li><a href="os/modules/json/json.html#c.json_encode_array_start">json_encode_array_start (C function)</a>
-</li>
- <li><a href="os/modules/json/json.html#c.json_encode_array_value">json_encode_array_value (C function)</a>
-</li>
- <li><a href="os/modules/json/json.html#c.json_encode_object_entry">json_encode_object_entry (C function)</a>
-</li>
- </ul></td>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/json/json.html#c.json_encode_object_finish">json_encode_object_finish (C function)</a>
-</li>
- <li><a href="os/modules/json/json.html#c.json_encode_object_key">json_encode_object_key (C function)</a>
-</li>
- <li><a href="os/modules/json/json.html#c.json_encode_object_start">json_encode_object_start (C function)</a>
-</li>
- <li><a href="os/modules/json/json.html#c.json_read_array">json_read_array (C function)</a>
-</li>
- <li><a href="os/modules/json/json.html#c.json_read_object">json_read_object (C function)</a>
-</li>
- </ul></td>
-</tr></table>
-
-<h2 id="L">L</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/logs/logs.html#c.log::STAILQ_ENTRY">log::STAILQ_ENTRY (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_append">log_append (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_append_body">log_append_body (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_append_mbuf">log_append_mbuf (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_append_mbuf_body">log_append_mbuf_body (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_append_mbuf_no_free">log_append_mbuf_no_free (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_append_mbuf_typed">log_append_mbuf_typed (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_append_mbuf_typed_no_free">log_append_mbuf_typed_no_free (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_append_typed">log_append_typed (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_console_get">log_console_get (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_console_init">log_console_init (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_flush">log_flush (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_init">log_init (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_level_get">log_level_get (C function)</a>
-</li>
- </ul></td>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/logs/logs.html#c.log_level_set">log_level_set (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_list_get_next">log_list_get_next (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_module_get_name">log_module_get_name (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_module_register">log_module_register (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_nmgr_register_group">log_nmgr_register_group (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_printf">log_printf (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_read">log_read (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_read_body">log_read_body (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_read_hdr">log_read_hdr (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_read_mbuf">log_read_mbuf (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_read_mbuf_body">log_read_mbuf_body (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_register">log_register (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_walk">log_walk (C function)</a>
-</li>
- <li><a href="os/modules/logs/logs.html#c.log_walk_body">log_walk_body (C function)</a>
-</li>
- </ul></td>
-</tr></table>
-
-<h2 id="N">N</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/fs/nffs.html#c.nffs_detect">nffs_detect (C function)</a>
-</li>
- <li><a href="os/modules/fs/nffs.html#c.nffs_format">nffs_format (C function)</a>
-</li>
- </ul></td>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/fs/nffs.html#c.nffs_init">nffs_init (C function)</a>
-</li>
- <li><a href="os/modules/fs/nffs.html#c.nffs_misc_desc_from_flash_area">nffs_misc_desc_from_flash_area (C function)</a>
-</li>
- </ul></td>
-</tr></table>
-
-<h2 id="O">O</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/core_os/callout/callout.html#_CPPv310os_callout">os_callout (C++ class)</a>
-</li>
- <li><a href="os/core_os/callout/callout.html#c.os_callout_init">os_callout_init (C function)</a>
-</li>
- <li><a href="os/core_os/callout/callout.html#c.os_callout_queued">os_callout_queued (C function)</a>
-</li>
- <li><a href="os/core_os/callout/callout.html#c.os_callout_remaining_ticks">os_callout_remaining_ticks (C function)</a>
-</li>
- <li><a href="os/core_os/callout/callout.html#c.os_callout_reset">os_callout_reset (C function)</a>
-</li>
- <li><a href="os/core_os/callout/callout.html#c.os_callout_stop">os_callout_stop (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_delay_nsecs">os_cputime_delay_nsecs (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_delay_ticks">os_cputime_delay_ticks (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_delay_usecs">os_cputime_delay_usecs (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_get32">os_cputime_get32 (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_init">os_cputime_init (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_nsecs_to_ticks">os_cputime_nsecs_to_ticks (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_ticks_to_nsecs">os_cputime_ticks_to_nsecs (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_ticks_to_usecs">os_cputime_ticks_to_usecs (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_timer_init">os_cputime_timer_init (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_timer_relative">os_cputime_timer_relative (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_timer_start">os_cputime_timer_start (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_timer_stop">os_cputime_timer_stop (C function)</a>
-</li>
- <li><a href="os/core_os/cputime/os_cputime.html#c.os_cputime_usecs_to_ticks">os_cputime_usecs_to_ticks (C function)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#_CPPv38os_event">os_event (C++ class)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#_CPPv39os_eventq">os_eventq (C++ class)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#c.os_eventq_dflt_get">os_eventq_dflt_get (C function)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#c.os_eventq_get">os_eventq_get (C function)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#c.os_eventq_get_no_wait">os_eventq_get_no_wait (C function)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#c.os_eventq_init">os_eventq_init (C function)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#c.os_eventq_inited">os_eventq_inited (C function)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#c.os_eventq_poll">os_eventq_poll (C function)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#c.os_eventq_put">os_eventq_put (C function)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#c.os_eventq_remove">os_eventq_remove (C function)</a>
-</li>
- <li><a href="os/core_os/event_queue/event_queue.html#c.os_eventq_run">os_eventq_run (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_get_uptime">os_get_uptime (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_get_uptime_usec">os_get_uptime_usec (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_gettimeofday">os_gettimeofday (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#_CPPv37os_mbuf">os_mbuf (C++ class)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_adj">os_mbuf_adj (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_append">os_mbuf_append (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_appendfrom">os_mbuf_appendfrom (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_cmpf">os_mbuf_cmpf (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_cmpm">os_mbuf_cmpm (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_concat">os_mbuf_concat (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_copydata">os_mbuf_copydata (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_copyinto">os_mbuf_copyinto (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_dup">os_mbuf_dup (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_extend">os_mbuf_extend (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_free">os_mbuf_free (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_free_chain">os_mbuf_free_chain (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_get">os_mbuf_get (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_get_pkthdr">os_mbuf_get_pkthdr (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_len">os_mbuf_len (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_off">os_mbuf_off (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#_CPPv314os_mbuf_pkthdr">os_mbuf_pkthdr (C++ class)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#_CPPv312os_mbuf_pool">os_mbuf_pool (C++ class)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_pool_init">os_mbuf_pool_init (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_prepend">os_mbuf_prepend (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_prepend_pullup">os_mbuf_prepend_pullup (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_pullup">os_mbuf_pullup (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_trim_front">os_mbuf_trim_front (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mbuf_widen">os_mbuf_widen (C function)</a>
-</li>
- </ul></td>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/core_os/memory_pool/memory_pool.html#_CPPv311os_memblock">os_memblock (C++ class)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#c.os_memblock_from">os_memblock_from (C function)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#c.os_memblock_get">os_memblock_get (C function)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#c.os_memblock_put">os_memblock_put (C function)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#c.os_memblock_put_from_cb">os_memblock_put_from_cb (C function)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#_CPPv310os_mempool">os_mempool (C++ class)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#c.os_mempool_clear">os_mempool_clear (C function)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#c.os_mempool_ext_init">os_mempool_ext_init (C function)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#_CPPv315os_mempool_info">os_mempool_info (C++ class)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#c.os_mempool_info_get_next">os_mempool_info_get_next (C function)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#c.os_mempool_init">os_mempool_init (C function)</a>
-</li>
- <li><a href="os/core_os/memory_pool/memory_pool.html#c.os_mempool_is_sane">os_mempool_is_sane (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#_CPPv39os_mqueue">os_mqueue (C++ class)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mqueue_get">os_mqueue_get (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mqueue_init">os_mqueue_init (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_mqueue_put">os_mqueue_put (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_msys_count">os_msys_count (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_msys_get">os_msys_get (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_msys_get_pkthdr">os_msys_get_pkthdr (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_msys_num_free">os_msys_num_free (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_msys_register">os_msys_register (C function)</a>
-</li>
- <li><a href="os/core_os/mbuf/mbuf.html#c.os_msys_reset">os_msys_reset (C function)</a>
-</li>
- <li><a href="os/core_os/mutex/mutex.html#_CPPv38os_mutex">os_mutex (C++ class)</a>
-</li>
- <li><a href="os/core_os/mutex/mutex.html#c.os_mutex::SLIST_HEAD">os_mutex::SLIST_HEAD (C function)</a>
-</li>
- <li><a href="os/core_os/mutex/mutex.html#c.os_mutex_init">os_mutex_init (C function)</a>
-</li>
- <li><a href="os/core_os/mutex/mutex.html#c.os_mutex_pend">os_mutex_pend (C function)</a>
-</li>
- <li><a href="os/core_os/mutex/mutex.html#c.os_mutex_release">os_mutex_release (C function)</a>
-</li>
- <li><a href="os/core_os/sanity/sanity.html#_CPPv315os_sanity_check">os_sanity_check (C++ class)</a>
-</li>
- <li><a href="os/core_os/sanity/sanity.html#c.os_sanity_check_init">os_sanity_check_init (C function)</a>
-</li>
- <li><a href="os/core_os/sanity/sanity.html#c.os_sanity_check_register">os_sanity_check_register (C function)</a>
-</li>
- <li><a href="os/core_os/sanity/sanity.html#c.os_sanity_check_reset">os_sanity_check_reset (C function)</a>
-</li>
- <li><a href="os/core_os/sanity/sanity.html#c.os_sanity_task_checkin">os_sanity_task_checkin (C function)</a>
-</li>
- <li><a href="os/core_os/context_switch/context_switch.html#c.os_sched">os_sched (C function)</a>
-</li>
- <li><a href="os/core_os/context_switch/context_switch.html#c.os_sched_get_current_task">os_sched_get_current_task (C function)</a>
-</li>
- <li><a href="os/core_os/context_switch/context_switch.html#c.os_sched_next_task">os_sched_next_task (C function)</a>
-</li>
- <li><a href="os/core_os/context_switch/context_switch.html#c.os_sched_set_current_task">os_sched_set_current_task (C function)</a>
-</li>
- <li><a href="os/core_os/semaphore/semaphore.html#_CPPv36os_sem">os_sem (C++ class)</a>
-</li>
- <li><a href="os/core_os/semaphore/semaphore.html#c.os_sem_get_count">os_sem_get_count (C function)</a>
-</li>
- <li><a href="os/core_os/semaphore/semaphore.html#c.os_sem_init">os_sem_init (C function)</a>
-</li>
- <li><a href="os/core_os/semaphore/semaphore.html#c.os_sem_pend">os_sem_pend (C function)</a>
-</li>
- <li><a href="os/core_os/semaphore/semaphore.html#c.os_sem_release">os_sem_release (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_settimeofday">os_settimeofday (C function)</a>
-</li>
- <li><a href="os/core_os/task/task.html#_CPPv37os_task">os_task (C++ class)</a>
-</li>
- <li><a href="os/core_os/task/task.html#c.os_task_count">os_task_count (C function)</a>
-</li>
- <li><a href="os/core_os/task/task.html#_CPPv312os_task_info">os_task_info (C++ class)</a>
-</li>
- <li><a href="os/core_os/task/task.html#c.os_task_info_get_next">os_task_info_get_next (C function)</a>
-</li>
- <li><a href="os/core_os/task/task.html#c.os_task_init">os_task_init (C function)</a>
-</li>
- <li><a href="os/core_os/task/task.html#c.os_task_remove">os_task_remove (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_os_tick/hal_os_tick.html#c.os_tick_idle">os_tick_idle (C function)</a>
-</li>
- <li><a href="os/modules/hal/hal_os_tick/hal_os_tick.html#c.os_tick_init">os_tick_init (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_time_advance">os_time_advance (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_time_delay">os_time_delay (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_time_get">os_time_get (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_time_ms_to_ticks">os_time_ms_to_ticks (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_time_ms_to_ticks32">os_time_ms_to_ticks32 (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_time_ticks_to_ms">os_time_ticks_to_ms (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#c.os_time_ticks_to_ms32">os_time_ticks_to_ms32 (C function)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#_CPPv310os_timeval">os_timeval (C++ class)</a>
-</li>
- <li><a href="os/core_os/time/os_time.html#_CPPv311os_timezone">os_timezone (C++ class)</a>
-</li>
- </ul></td>
-</tr></table>
-
-<h2 id="S">S</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/sensor_framework/sensor_api.html#_CPPv36sensor">sensor (C++ class)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#_CPPv310sensor_cfg">sensor_cfg (C++ class)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#c.sensor_check_type">sensor_check_type (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_clear_high_thresh">sensor_clear_high_thresh (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_clear_low_thresh">sensor_clear_low_thresh (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#_CPPv313sensor_data_t">sensor_data_t (C++ type)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_ftostr">sensor_ftostr (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#c.sensor_get_config">sensor_get_config (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_get_type_traits_byname">sensor_get_type_traits_byname (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_get_type_traits_bytype">sensor_get_type_traits_bytype (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#c.sensor_init">sensor_init (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#c.sensor_lock">sensor_lock (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_evq_get">sensor_mgr_evq_get (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_find_next">sensor_mgr_find_next (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_find_next_bydevname">sensor_mgr_find_next_bydevname (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_find_next_bytype">sensor_mgr_find_next_bytype (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_lock">sensor_mgr_lock (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_match_bytype">sensor_mgr_match_bytype (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_put_interrupt_evt">sensor_mgr_put_interrupt_evt (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_put_notify_evt">sensor_mgr_put_notify_evt (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_put_read_evt">sensor_mgr_put_read_evt (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_register">sensor_mgr_register (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_mgr_unlock">sensor_mgr_unlock (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#_CPPv315sensor_notifier">sensor_notifier (C++ class)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_oic_init">sensor_oic_init (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_oic_tx_trigger">sensor_oic_tx_trigger (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#c.sensor_pkg_init">sensor_pkg_init (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#c.sensor_read">sensor_read (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#_CPPv318sensor_read_ev_ctx">sensor_read_ev_ctx (C++ class)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_listener_api.html#c.sensor_register_listener">sensor_register_listener (C function)</a>
-</li>
- </ul></td>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/sensor_framework/sensor_notifier_api.html#c.sensor_register_notifier">sensor_register_notifier (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#c.sensor_set_driver">sensor_set_driver (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#c.sensor_set_interface">sensor_set_interface (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_set_n_poll_rate">sensor_set_n_poll_rate (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_set_poll_rate_ms">sensor_set_poll_rate_ms (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_set_thresh">sensor_set_thresh (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#c.sensor_set_type_mask">sensor_set_type_mask (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_mgr_api.html#c.sensor_trigger_init">sensor_trigger_init (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#_CPPv318sensor_type_traits">sensor_type_traits (C++ class)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_api.html#c.sensor_unlock">sensor_unlock (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_listener_api.html#c.sensor_unregister_listener">sensor_unregister_listener (C function)</a>
-</li>
- <li><a href="os/modules/sensor_framework/sensor_notifier_api.html#c.sensor_unregister_notifier">sensor_unregister_notifier (C function)</a>
-</li>
- <li><a href="os/modules/shell/shell.html#c.shell_cmd_register">shell_cmd_register (C function)</a>
-</li>
- <li><a href="os/modules/shell/shell.html#c.shell_evq_set">shell_evq_set (C function)</a>
-</li>
- <li><a href="os/modules/shell/shell.html#c.shell_nlip_input_register">shell_nlip_input_register (C function)</a>
-</li>
- <li><a href="os/modules/shell/shell.html#c.shell_nlip_output">shell_nlip_output (C function)</a>
-</li>
- <li><a href="os/modules/shell/shell.html#c.shell_register">shell_register (C function)</a>
-</li>
- <li><a href="os/modules/shell/shell.html#c.shell_register_app_cmd_handler">shell_register_app_cmd_handler (C function)</a>
-</li>
- <li><a href="os/modules/shell/shell.html#c.shell_register_default_module">shell_register_default_module (C function)</a>
-</li>
- <li><a href="os/modules/shell/shell.html#c.shell_register_prompt_handler">shell_register_prompt_handler (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.SLIST_HEAD">SLIST_HEAD (C function)</a>
-</li>
- <li><a href="os/modules/stats/stats.html#c.stats_group_find">stats_group_find (C function)</a>
-</li>
- <li><a href="os/modules/stats/stats.html#c.stats_group_walk">stats_group_walk (C function)</a>
-</li>
- <li><a href="os/modules/stats/stats.html#c.stats_hdr::STAILQ_ENTRY">stats_hdr::STAILQ_ENTRY (C function)</a>
-</li>
- <li><a href="os/modules/stats/stats.html#c.stats_init">stats_init (C function)</a>
-</li>
- <li><a href="os/modules/stats/stats.html#c.stats_init_and_reg">stats_init_and_reg (C function)</a>
-</li>
- <li><a href="os/modules/stats/stats.html#c.stats_nmgr_register_group">stats_nmgr_register_group (C function)</a>
-</li>
- <li><a href="os/modules/stats/stats.html#c.stats_register">stats_register (C function)</a>
-</li>
- <li><a href="os/modules/stats/stats.html#c.stats_reset">stats_reset (C function)</a>
-</li>
- <li><a href="os/modules/stats/stats.html#c.stats_shell_register">stats_shell_register (C function)</a>
-</li>
- <li><a href="os/modules/stats/stats.html#c.stats_walk">stats_walk (C function)</a>
-</li>
- </ul></td>
-</tr></table>
-
-<h2 id="T">T</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_complete">tu_case_complete (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_fail">tu_case_fail (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_fail_assert">tu_case_fail_assert (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_init">tu_case_init (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_pass">tu_case_pass (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_pass_manual">tu_case_pass_manual (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_post_test">tu_case_post_test (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_pre_test">tu_case_pre_test (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_set_init_cb">tu_case_set_init_cb (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_set_post_cb">tu_case_set_post_cb (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_set_pre_cb">tu_case_set_pre_cb (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_case_write_pass_auto">tu_case_write_pass_auto (C function)</a>
-</li>
- </ul></td>
- <td style="width: 33%; vertical-align: top;"><ul>
- <li><a href="os/modules/testutil/testutil.html#c.tu_restart">tu_restart (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_start_os">tu_start_os (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_complete">tu_suite_complete (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_init">tu_suite_init (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_post_test">tu_suite_post_test (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_pre_test">tu_suite_pre_test (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_register">tu_suite_register (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_set_complete_cb">tu_suite_set_complete_cb (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_set_fail_cb">tu_suite_set_fail_cb (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_set_init_cb">tu_suite_set_init_cb (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_set_pass_cb">tu_suite_set_pass_cb (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_set_post_test_cb">tu_suite_set_post_test_cb (C function)</a>
-</li>
- <li><a href="os/modules/testutil/testutil.html#c.tu_suite_set_pre_test_cb">tu_suite_set_pre_test_cb (C function)</a>
-</li>
- </ul></td>
-</tr></table>
-
-
-
- </div>
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'./',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="_static/js/affix.js"></script>
- <script type="text/javascript" src="_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/get_started/docker.html b/develop/get_started/docker.html
deleted file mode 100644
index dc40045d5..000000000
--- a/develop/get_started/docker.html
+++ /dev/null
@@ -1,467 +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">
-
-
-
-
- <title>Everything You Need in a Docker Container — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../genindex.html"/>
- <link rel="search" title="Search" href="../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../index.html"/>
- <link rel="up" title="Setup & Get Started" href="index.html"/>
- <link rel="next" title="Creating Your First Mynewt Project" href="project_create.html"/>
- <link rel="prev" title="Installing the Cross Tools for ARM" href="native_install/cross_tools.html"/>
-
-
- <script src="../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="index.html">Setup & Get Started</a> /
-
- Everything You Need in a Docker Container
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/get_started/docker.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="index.html">Setup & Get Started</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="native_install/index.html">Native Installation</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Docker Container</a></li>
-<li class="toctree-l2"><a class="reference internal" href="project_create.html">Create Your First Project</a></li>
-<li class="toctree-l2"><a class="reference internal" href="serial_access.html">Serial Port Setup</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="everything-you-need-in-a-docker-container">
-<h1>Everything You Need in a Docker Container<a class="headerlink" href="#everything-you-need-in-a-docker-container" title="Permalink to this headline">¶</a></h1>
-<p>Docker provides a quick and easy way to get up and running with Mynewt.
-The newt command line tool and the entire build toolchain is available
-in a single docker container. The container is all that’s needed to run
-your Mynewt based application in the simulator. Enabling USB2 with your
-docker installation will allow you to load your application on a
-supported device.</p>
-<p>Docker is the only supported option if you are working on a Windows
-machine. If you are using Mac OS X or Linux, you have the choice of
-installing a Docker container of tools and toolchains or installing them
-natively. This chapter describes how to set up the Docker image for all
-three platforms.</p>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#install-docker" id="id1">Install Docker</a><ul>
-<li><a class="reference internal" href="#mac-and-windows" id="id2">Mac and Windows</a></li>
-<li><a class="reference internal" href="#linux" id="id3">Linux</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#pull-the-mynewt-container" id="id4">Pull the Mynewt Container</a></li>
-<li><a class="reference internal" href="#use-a-newt-wrapper-script" id="id5">Use a <code class="docutils literal notranslate"><span class="pre">newt</span></code> wrapper script</a></li>
-<li><a class="reference internal" href="#enable-usb2-support-for-mac-or-windows" id="id6">Enable USB2 Support for Mac or Windows</a><ul>
-<li><a class="reference internal" href="#install-virtualbox-extension-pack" id="id7">Install VirtualBox extension pack</a></li>
-<li><a class="reference internal" href="#enable-usb2-and-select-your-device" id="id8">Enable USB2 and select your device</a></li>
-</ul>
-</li>
-</ul>
-</div>
-<div class="section" id="install-docker">
-<h2><a class="toc-backref" href="#id1">Install Docker</a><a class="headerlink" href="#install-docker" title="Permalink to this headline">¶</a></h2>
-<p>Install docker for your platform. <a class="reference external" href="https://www.docker.com/products/docker-toolbox">Mac OS
-X</a> /
-<a class="reference external" href="https://www.docker.com/products/docker-toolbox">Windows</a> /
-<a class="reference external" href="https://docs.docker.com/engine/installation/linux/">Linux</a></p>
-<div class="section" id="mac-and-windows">
-<h3><a class="toc-backref" href="#id2">Mac and Windows</a><a class="headerlink" href="#mac-and-windows" title="Permalink to this headline">¶</a></h3>
-<p>Mac and Windows require Docker Toolbox to interact with USB devices.
-Docker for Mac and Docker for Windows do not support USB. Docker Toolbox
-uses VirtualBox and allows you to map USB devices into docker containers
-as described below.</p>
-<p>Make sure to double click the Docker Quickstart Terminal application if
-you’re on Mac or Windows.</p>
-</div>
-<div class="section" id="linux">
-<h3><a class="toc-backref" href="#id3">Linux</a><a class="headerlink" href="#linux" title="Permalink to this headline">¶</a></h3>
-<p>The docker daemon listens on a Unix domain socket on Linux. That socket
-is owned by root, which means by default you must be root to start a
-container. Make sure to follow the optional step of adding yourself to
-the docker group so you can start the newt container as yourself.</p>
-</div>
-</div>
-<div class="section" id="pull-the-mynewt-container">
-<h2><a class="toc-backref" href="#id4">Pull the Mynewt Container</a><a class="headerlink" href="#pull-the-mynewt-container" title="Permalink to this headline">¶</a></h2>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> docker pull mynewt/newt:latest
-</pre></div>
-</div>
-<p><strong>Note</strong> You can upgrade your container by repeating this command when updates are made available.</p>
-</div>
-<div class="section" id="use-a-newt-wrapper-script">
-<h2><a class="toc-backref" href="#id5">Use a <code class="docutils literal notranslate"><span class="pre">newt</span></code> wrapper script</a><a class="headerlink" href="#use-a-newt-wrapper-script" title="Permalink to this headline">¶</a></h2>
-<p>Use the newt wrapper script to invoke newt. Create the following file,
-name it <code class="docutils literal notranslate"><span class="pre">newt</span></code>, make it executable, and put it in your path. This will
-allow you to run newt as if it was natively installed. You can now
-follow the normal tutorials using the newt wrapper script.</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="ch">#!/bin/bash</span>
-
-<span class="k">if</span> <span class="o">[</span> <span class="s2">"</span><span class="nv">$1</span><span class="s2">"</span> <span class="o">=</span> <span class="s2">"debug"</span> <span class="o">]</span> <span class="o">||</span> <span class="o">[</span> <span class="s2">"</span><span class="nv">$1</span><span class="s2">"</span> <span class="o">=</span> <span class="s2">"run"</span> <span class="o">]</span>
-<span class="k">then</span>
- <span class="nv">ti</span><span class="o">=</span><span class="s2">"-ti"</span>
-<span class="k">fi</span>
-
-docker run -e <span class="nv">NEWT_USER</span><span class="o">=</span><span class="k">$(</span>id -u<span class="k">)</span> -e <span class="nv">NEWT_GROUP</span><span class="o">=</span><span class="k">$(</span>id -g<span class="k">)</span> -e <span class="nv">NEWT_HOST</span><span class="o">=</span><span class="k">$(</span>uname<span class="k">)</span> <span class="nv">$ti</span> --rm --device<span class="o">=</span>/dev/bus/usb --privileged -v <span class="k">$(</span><span class="nb">pwd</span><span class="k">)</span>:/workspace -w /workspace mynewt/newt:latest /newt <span class="s2">"</span><span class="nv">$@</span><span class="s2">"</span>
-</pre></div>
-</div>
-<p><strong>Note</strong> Remember to point to the correct subdirectory level when
-invoking <code class="docutils literal notranslate"><span class="pre">newt</span></code>. For example, invoke it using <code class="docutils literal notranslate"><span class="pre">../newt</span></code> in the
-example below.</p>
-<div class="code console highlight-none notranslate"><div class="highlight"><pre><span></span>user@~/dockertest$ ls
-myproj newt
-user@~/dockertest$ cd myproj
-user@~/dockertest/myproj$ ../newt version
-Apache Newt version: 1.1.0
-</pre></div>
-</div>
-</div>
-<div class="section" id="enable-usb2-support-for-mac-or-windows">
-<h2><a class="toc-backref" href="#id6">Enable USB2 Support for Mac or Windows</a><a class="headerlink" href="#enable-usb2-support-for-mac-or-windows" title="Permalink to this headline">¶</a></h2>
-<p>If you plan on loading your application on an actual device, do the
-steps below.</p>
-<div class="section" id="install-virtualbox-extension-pack">
-<h3><a class="toc-backref" href="#id7">Install VirtualBox extension pack</a><a class="headerlink" href="#install-virtualbox-extension-pack" title="Permalink to this headline">¶</a></h3>
-<p>Docker uses a VirtualBox Linux VM to run containers. A free VirtualBox
-extension pack is required to enable USB2 support. Download the
-<a class="reference external" href="https://www.virtualbox.org/wiki/Downloads">VirtualBox Extension
-Pack</a> version that matches
-your VirtualBox installation and double click to install</p>
-</div>
-<div class="section" id="enable-usb2-and-select-your-device">
-<h3><a class="toc-backref" href="#id8">Enable USB2 and select your device</a><a class="headerlink" href="#enable-usb2-and-select-your-device" title="Permalink to this headline">¶</a></h3>
-<ul class="simple">
-<li>The “default” VM created by docker-machine must first be stopped
-before you can enable USB2. You have two options:<ul>
-<li>Run the command <code class="docutils literal notranslate"><span class="pre">docker-machine</span> <span class="pre">stop</span> <span class="pre">default</span></code> in the terminal
-window or</li>
-<li>Use the VirtualBox UI. Right click on <code class="docutils literal notranslate"><span class="pre">default</span></code> -> Close ->
-Power Off</li>
-</ul>
-</li>
-<li>Enable USB2 using the VirtualBox UI. Select the “default”
-VM->Settings->Ports->USB2 to enable USB2. Add your device to the USB
-Device Filters to make the device visible in the docker container.
-See the image below.</li>
-<li>Restart the “default” VM. You have two options:<ul>
-<li>Run <code class="docutils literal notranslate"><span class="pre">docker-machine</span> <span class="pre">start</span> <span class="pre">default</span></code> in the terminal window or</li>
-<li>Use the VirtualBox UI. Make sure the “default” machine is
-highlighted. Click the green “Start” button. Select “Headless Start”.</li>
-</ul>
-</li>
-</ul>
-<img alt="../_images/virtualbox_usb.jpg" src="../_images/virtualbox_usb.jpg" />
-<p><strong>Note</strong>: When working with actual hardware, remember that each board
-has an ID. If you swap boards and do not refresh the USB Device Filter
-on the VirtualBox UI, the ID might be stale and the Docker instance may
-not be able to see the board correctly. For example, you may see an
-error message like <code class="docutils literal notranslate"><span class="pre">Error:</span> <span class="pre">unable</span> <span class="pre">to</span> <span class="pre">find</span> <span class="pre">CMSIS-DAP</span> <span class="pre">device</span></code> when you
-try to load or run an image on the board. In that case, you need to
-click on the USB link in VirtualBox UI, remove the existing USB Device
-Filter (e.g. “Atmel Corp. EDBG CMSIS-DAP[0101]”) by clicking on the
-“Removes selected USB filter” button, and add a new filter by clicking
-on the “Adds new USB filter” button.</p>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="project_create.html" class="btn btn-neutral float-right" title="Creating Your First Mynewt Project" accesskey="n">Next: Creating Your First Mynewt Project <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="native_install/cross_tools.html" class="btn btn-neutral" title="Installing the Cross Tools for ARM" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Installing the Cross Tools for ARM</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../_static/js/affix.js"></script>
- <script type="text/javascript" src="../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/get_started/index.html b/develop/get_started/index.html
deleted file mode 100644
index e0f970b55..000000000
--- a/develop/get_started/index.html
+++ /dev/null
@@ -1,360 +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">
-
-
-
-
- <title>Setup & Get Started — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../genindex.html"/>
- <link rel="search" title="Search" href="../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../index.html"/>
- <link rel="next" title="Native Installation" href="native_install/index.html"/>
- <link rel="prev" title="Introduction" href="../index.html"/>
-
-
- <script src="../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- Setup & Get Started
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/get_started/index.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Setup & Get Started</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="native_install/index.html">Native Installation</a></li>
-<li class="toctree-l2"><a class="reference internal" href="docker.html">Docker Container</a></li>
-<li class="toctree-l2"><a class="reference internal" href="project_create.html">Create Your First Project</a></li>
-<li class="toctree-l2"><a class="reference internal" href="serial_access.html">Serial Port Setup</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="setup-get-started">
-<h1>Setup & Get Started<a class="headerlink" href="#setup-get-started" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-</div>
-<p>If you are curious about Mynewt and want to get a quick feel for the
-project, you’ve come to the right place. We have two options for you:</p>
-<p><strong>Option 1 (Recommended)</strong> allows you to install the Newt tool,
-instances of the Mynewt OS (for simulated targets), and toolchains for
-developing embedded software (e.g. GNU toolchain) natively on your
-laptop or computer. We have tried to make the process easy. For example,
-for the Mac OS we created brew formulas.</p>
-<p>We recommend this option if you are familiar with such environments or
-are concerned about performance on your machine. Follow the instructions
-in “<a class="reference internal" href="native_install/index.html"><span class="doc">Native Installation</span></a>” if you prefer
-this option.</p>
-<p><strong>Option 2</strong> is an easy, self-contained way to get up and running with
-Mynewt - but has limitations! The Newt tool and build toolchains are all
-available in a single <a class="reference internal" href="docker.html"><span class="doc">Docker Container</span></a> that
-you can install on your laptop or computer.</p>
-<p>However, this is not a long-term option since support is not likely for
-all features useful or critical to embedded systems development. For
-example, USB device mapping available in the Docker toolkit is no longer
-available in the new Docker releases. The Docker option is also
-typically slower than the native install option.</p>
-<p>You can then proceed with the instructions on how to <a class="reference internal" href="project_create.html"><span class="doc">Creating Your First Mynewt Project</span></a> - on simulated hardware.</p>
-<p>Upon successful start, several tutorials await your eager attention!</p>
-<p><strong>Send us an email on the dev@ mailing list if you have comments or
-suggestions!</strong> If you haven’t joined the mailing list, you will find the
-links <a class="reference external" href="/community.html">here</a>.</p>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="native_install/index.html" class="btn btn-neutral float-right" title="Native Installation" accesskey="n">Next: Native Installation <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="../index.html" class="btn btn-neutral" title="Introduction" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Introduction</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../_static/js/affix.js"></script>
- <script type="text/javascript" src="../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/get_started/native_install/cross_tools.html b/develop/get_started/native_install/cross_tools.html
deleted file mode 100644
index 1ef8066c6..000000000
--- a/develop/get_started/native_install/cross_tools.html
+++ /dev/null
@@ -1,580 +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">
-
-
-
-
- <title>Installing the Cross Tools for ARM — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../genindex.html"/>
- <link rel="search" title="Search" href="../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../index.html"/>
- <link rel="up" title="Native Installation" href="index.html"/>
- <link rel="next" title="Everything You Need in a Docker Container" href="../docker.html"/>
- <link rel="prev" title="Installing Native Toolchain" href="native_tools.html"/>
-
-
- <script src="../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">Setup & Get Started</a> /
-
- <a href="index.html">Native Installation</a> /
-
- Installing the Cross Tools for ARM
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/get_started/native_install/cross_tools.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../index.html">Introduction</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">Setup & Get Started</a><ul class="current">
-<li class="toctree-l2 current"><a class="reference internal" href="index.html">Native Installation</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="../../newt/install/newt_mac.html">Installing Newt on Mac OS</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../newt/install/newt_linux.html">Installing Newt on Linux</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../newt/install/newt_windows.html">Installing Newt on Windows</a></li>
-<li class="toctree-l3"><a class="reference internal" href="native_tools.html">Installing Native Toolchain</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">Installing the Cross Tools for ARM</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../docker.html">Docker Container</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../project_create.html">Create Your First Project</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../serial_access.html">Serial Port Setup</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="installing-the-cross-tools-for-arm">
-<h1>Installing the Cross Tools for ARM<a class="headerlink" href="#installing-the-cross-tools-for-arm" title="Permalink to this headline">¶</a></h1>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#installing-the-arm-cross-toolchain" id="id1">Installing the ARM Cross Toolchain</a><ul>
-<li><a class="reference internal" href="#installing-the-arm-toolchain-for-mac-os-x" id="id2">Installing the ARM Toolchain For Mac OS X</a></li>
-<li><a class="reference internal" href="#installing-the-arm-toolchain-for-linux" id="id3">Installing the ARM Toolchain For Linux</a></li>
-<li><a class="reference internal" href="#installing-the-arm-toolchain-for-windows" id="id4">Installing the ARM Toolchain for Windows</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#installing-the-debuggers" id="id5">Installing the Debuggers</a><ul>
-<li><a class="reference internal" href="#installing-the-openocd-debugger" id="id6">Installing the OpenOCD Debugger</a></li>
-<li><a class="reference internal" href="#installing-openocd-on-mac-os" id="id7">Installing OpenOCD on Mac OS</a></li>
-<li><a class="reference internal" href="#installing-openocd-on-linux" id="id8">Installing OpenOCD on Linux</a></li>
-<li><a class="reference internal" href="#installing-openocd-on-windows" id="id9">Installing OpenOCD on Windows</a></li>
-<li><a class="reference internal" href="#installing-segger-j-link" id="id10">Installing SEGGER J-Link</a></li>
-</ul>
-</li>
-</ul>
-</div>
-<p>This page shows you how to install the tools to build, run, and debug
-Mynewt OS applications that run on supported ARM target boards. It shows
-you how to install the following tools on Mac OS, Linux and Windows:</p>
-<ul class="simple">
-<li>ARM cross toolchain to compile and build Mynewt applications for the
-target boards.</li>
-<li>Debuggers to load and debug applications on the target boards.</li>
-</ul>
-<div class="section" id="installing-the-arm-cross-toolchain">
-<h2><a class="toc-backref" href="#id1">Installing the ARM Cross Toolchain</a><a class="headerlink" href="#installing-the-arm-cross-toolchain" title="Permalink to this headline">¶</a></h2>
-<p>ARM maintains a pre-built GNU toolchain with gcc and gdb targeted at
-Embedded ARM Processors, namely Cortex-R/Cortex-M processor families.
-Mynewt OS has been tested with version 4.9 of the toolchain and we
-recommend you install this version to get started. Mynewt OS will
-eventually work with multiple versions available, including the latest
-releases.</p>
-<div class="section" id="installing-the-arm-toolchain-for-mac-os-x">
-<h3><a class="toc-backref" href="#id2">Installing the ARM Toolchain For Mac OS X</a><a class="headerlink" href="#installing-the-arm-toolchain-for-mac-os-x" title="Permalink to this headline">¶</a></h3>
-<p>Add the <strong>PX4/homebrew-px4</strong> homebrew tap and install version 4.9 of the
-toolchain. After installing, check that the symbolic link that homebrew
-created points to the correct version of the debugger.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> brew tap PX4/homebrew-px4
-<span class="gp">$</span> brew update
-<span class="gp">$</span> brew install gcc-arm-none-eabi-49
-<span class="gp">$</span> arm-none-eabi-gcc --version
-<span class="go">arm-none-eabi-gcc (GNU Tools for ARM Embedded Processors) 4.9.3 20150529 (release) [ARM/embedded-4_9-branch revision 224288]</span>
-<span class="go">Copyright (C) 2014 Free Software Foundation, Inc.</span>
-<span class="go">This is free software; see the source for copying conditions. There is NO</span>
-<span class="go">warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</span>
-<span class="gp">$</span> ls -al /usr/local/bin/arm-none-eabi-gdb
-<span class="go">lrwxr-xr-x 1 aditihilbert admin 69 Sep 22 17:16 /usr/local/bin/arm-none-eabi-gdb -> /usr/local/Cellar/gcc-arm-none-eabi-49/20150609/bin/arm-none-eabi-gdb</span>
-</pre></div>
-</div>
-<p><strong>Note:</strong> If no version is specified, brew will install the latest
-version available.</p>
-</div>
-<div class="section" id="installing-the-arm-toolchain-for-linux">
-<h3><a class="toc-backref" href="#id3">Installing the ARM Toolchain For Linux</a><a class="headerlink" href="#installing-the-arm-toolchain-for-linux" title="Permalink to this headline">¶</a></h3>
-<p>On a Debian-based Linux distribution, gcc 4.9.3 for ARM can be installed
-with apt-get as documented below. The steps are explained in depth at
-<a class="reference external" href="https://launchpad.net/~team-gcc-arm-embedded/+archive/ubuntu/ppa">https://launchpad.net/~team-gcc-arm-embedded/+archive/ubuntu/ppa</a>.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> sudo apt-get remove binutils-arm-none-eabi gcc-arm-none-eabi
-<span class="gp">$</span> sudo add-apt-repository ppa:team-gcc-arm-embedded/ppa
-<span class="gp">$</span> sudo apt-get update
-<span class="gp">$</span> sudo apt-get install gcc-arm-none-eabi
-<span class="gp">$</span> sudo apt-get install gdb-arm-none-eabi
-</pre></div>
-</div>
-</div>
-<div class="section" id="installing-the-arm-toolchain-for-windows">
-<h3><a class="toc-backref" href="#id4">Installing the ARM Toolchain for Windows</a><a class="headerlink" href="#installing-the-arm-toolchain-for-windows" title="Permalink to this headline">¶</a></h3>
-<ol class="arabic">
-<li><p class="first">Download and run the <a class="reference external" href="https://launchpad.net/gcc-arm-embedded/4.9/4.9-2015-q2-update/+download/gcc-arm-none-eabi-4_9-2015q2-20150609-win32.exe">installer</a>
-to install arm-none-eabi-gcc and arm-none-eabi-gdb. Select the default
-destination folder: <strong>C:\Program Files (x86)\GNU Tools ARM Embedded\4.9 2015q2</strong>.</p>
-<p><strong>Notes:</strong></p>
-<ul class="simple">
-<li>Check the <code class="docutils literal notranslate"><span class="pre">Add</span> <span class="pre">path</span> <span class="pre">to</span> <span class="pre">environment</span> <span class="pre">variable</span></code> option before you click the <code class="docutils literal notranslate"><span class="pre">Finish</span></code> button for the installation.</li>
-<li>You may select a different folder but the installation
-instructions use the default values.</li>
-</ul>
-</li>
-<li><p class="first">Check that you are using the installed versions
-arm-none-eabi-gcc and arm-none-eabi-gdb. Open a MinGW terminal and run
-the <code class="docutils literal notranslate"><span class="pre">which</span></code> commands.</p>
-<p><strong>Note:</strong> You must start a new MinGW terminal to inherit the new
-<strong>Path</strong> values.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> which arm-none-eabi-gcc
-<span class="go">/c/Program Files (x86)/GNU Tools ARM Embedded/4.9 2015q2/bin/arm-none-eabi-gcc</span>
-<span class="gp">$</span>which arm-none-eabi-gdb
-<span class="go">/c/Program Files (x86)/GNU Tools ARM Embedded/4.9 2015q2/bin/arm-none-eabi-gdb</span>
-</pre></div>
-</div>
-</li>
-</ol>
-</div>
-</div>
-<div class="section" id="installing-the-debuggers">
-<h2><a class="toc-backref" href="#id5">Installing the Debuggers</a><a class="headerlink" href="#installing-the-debuggers" title="Permalink to this headline">¶</a></h2>
-<p>Mynewt uses, depending on the board, either the OpenOCD or SEGGER J-Link
-debuggers.</p>
-<div class="section" id="installing-the-openocd-debugger">
-<h3><a class="toc-backref" href="#id6">Installing the OpenOCD Debugger</a><a class="headerlink" href="#installing-the-openocd-debugger" title="Permalink to this headline">¶</a></h3>
-<p>OpenOCD (Open On-Chip
-Debugger) is open-source software that allows your computer to interface
-with the JTAG debug connector on a variety of boards. A JTAG connection
-lets you debug and test embedded target devices. For more on OpenOCD go
-to <a class="reference external" href="http://openocd.org">http://openocd.org</a>.</p>
-<p>OpenOCD version 0.10.0 with nrf52 support is required. A binary for this
-version is available to download for Mac OS, Linux, and Windows.</p>
-</div>
-<div class="section" id="installing-openocd-on-mac-os">
-<h3><a class="toc-backref" href="#id7">Installing OpenOCD on Mac OS</a><a class="headerlink" href="#installing-openocd-on-mac-os" title="Permalink to this headline">¶</a></h3>
-<ol class="arabic">
-<li><p class="first">Download the <a class="reference external" href="https://github.com/runtimeco/openocd-binaries/raw/master/openocd-bin-0.10.0-MacOS.tgz">binary tarball for Mac
-OS</a>.</p>
-</li>
-<li><p class="first">Change to the root directory:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> <span class="nb">cd</span> /
-</pre></div>
-</div>
-</li>
-<li><p class="first">Untar the tarball and install into <strong>/usr/local/bin</strong>. You
-will need to replace <strong>~/Downloads</strong> with the directory that the
-tarball is downloaded to.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> sudo tar -xf ~/Downloads/openocd-bin-0.10.0-MacOS.tgz <span class="sb">`</span>
-</pre></div>
-</div>
-</li>
-<li><p class="first">Check the OpenOCD version you are using.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> which openocd
-<span class="go">/usr/local/bin/openocd</span>
-<span class="gp">$</span> openocd -v
-<span class="go">Open On-Chip Debugger 0.10.0</span>
-<span class="go">Licensed under GNU GPL v2</span>
-<span class="go">For bug reports, read</span>
-<span class="go">http://openocd.org/doc/doxygen/bugs.html</span>
-</pre></div>
-</div>
-<p>You should see version: <strong>0.10.0</strong>.</p>
-<p>If you see one of these errors:</p>
-<ul class="simple">
-<li>Library not loaded: /usr/local/lib/libusb-0.1.4.dylib - Run
-<code class="docutils literal notranslate"><span class="pre">brew</span> <span class="pre">install</span> <span class="pre">libusb-compat</span></code>.</li>
-<li>Library not loaded: /usr/local/opt/libftdi/lib/libftdi1.2.dylib - Run
-<code class="docutils literal notranslate"><span class="pre">brew</span> <span class="pre">install</span> <span class="pre">libftdi</span></code>.</li>
-<li>Library not loaded: /usr/local/lib/libhidapi.0.dylib - Run
-<code class="docutils literal notranslate"><span class="pre">brew</span> <span class="pre">install</span> <span class="pre">hidapi</span></code>.</li>
-</ul>
-</li>
-</ol>
-</div>
-<div class="section" id="installing-openocd-on-linux">
-<h3><a class="toc-backref" href="#id8">Installing OpenOCD on Linux</a><a class="headerlink" href="#installing-openocd-on-linux" title="Permalink to this headline">¶</a></h3>
-<ol class="arabic">
-<li><p class="first">Download the <a class="reference external" href="https://github.com/runtimeco/openocd-binaries/raw/master/openocd-bin-0.10.0-Linux.tgz">binary tarball for
-Linux</a></p>
-</li>
-<li><p class="first">Change to the root directory:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> <span class="nb">cd</span> /
-</pre></div>
-</div>
-</li>
-<li><p class="first">Untar the tarball and install into <strong>/usr/local/bin</strong>. You
-will need to replace <strong>~/Downloads</strong> with the directory that the
-tarball is downloaded to.</p>
-<p><strong>Note:</strong> You must specify the -p option for the tar command.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> sudo tar -xpf ~/Downloads/openocd-bin-0.10.0-Linux.tgz
-</pre></div>
-</div>
-</li>
-<li><p class="first">Check the OpenOCD version you are using:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> which openocd
-<span class="go">/usr/local/bin/openocd</span>
-<span class="gp">$</span> openocd -v
-<span class="go">Open On-Chip Debugger 0.10.0</span>
-<span class="go">Licensed under GNU GPL v2</span>
-<span class="go">For bug reports, read</span>
-<span class="go">http://openocd.org/doc/doxygen/bugs.html</span>
-</pre></div>
-</div>
-<p>You should see version: <strong>0.10.0</strong>.</p>
-<p>If you see any of these error messages:</p>
-<ul class="simple">
-<li>openocd: error while loading shared libraries: libhidapi-hidraw.so.0:
-cannot open shared object file: No such file or directory</li>
-<li>openocd: error while loading shared libraries: libusb-1.0.so.0:
-cannot open shared object file: No such file or directory</li>
-</ul>
-<p>run the following command to install the libraries:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> sudo apt-get install libhidapi-dev:i386
-</pre></div>
-</div>
-</li>
-</ol>
-</div>
-<div class="section" id="installing-openocd-on-windows">
-<h3><a class="toc-backref" href="#id9">Installing OpenOCD on Windows</a><a class="headerlink" href="#installing-openocd-on-windows" title="Permalink to this headline">¶</a></h3>
-<ol class="arabic">
-<li><p class="first">Download the <a class="reference external" href="https://github.com/runtimeco/openocd-binaries/raw/master/openocd-0.10.0.zip">binary zip file for
-Windows</a>.</p>
-</li>
-<li><p class="first">Extract into the <strong>C:\openocd-0.10.0</strong> folder.</p>
-</li>
-<li><p class="first">Add the path: <strong>C:\openocd-0.10.0\bin</strong> to your Windows User
-<strong>Path</strong> environment variable. Note: You must add <strong>bin</strong> to the path.</p>
-</li>
-<li><p class="first">Check the OpenOCD version you are using. Open a new MinGW
-terminal and run the following commands:</p>
-<p><strong>Note:</strong> You must start a new MinGW terminal to inherit the new
-<strong>Path</strong> values.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> which openocd
-<span class="go">/c/openocd-0.10.0/bin/openocd</span>
-<span class="gp">$</span> openocd -v
-<span class="go">Open On-Chip Debugger 0.10.0</span>
-<span class="go">Licensed under GNU GPL v2</span>
-<span class="go">For bug reports, read</span>
-<span class="go"> http://openocd.org/doc/doxygen/bugs.html</span>
-</pre></div>
-</div>
-<p>You should see version: <strong>0.10.0</strong>.</p>
-</li>
-</ol>
-</div>
-<div class="section" id="installing-segger-j-link">
-<h3><a class="toc-backref" href="#id10">Installing SEGGER J-Link</a><a class="headerlink" href="#installing-segger-j-link" title="Permalink to this headline">¶</a></h3>
-<p>You can download and install Segger J-LINK Software and documentation pack from
-<a class="reference external" href="https://www.segger.com/jlink-software.html">SEGGER</a>.</p>
-<p><strong>Note:</strong> On Windows, perform the following after the installation:</p>
-<ul class="simple">
-<li>Add the installation destination folder path to your Windows user
-<strong>Path</strong> environment variable. You do not need to add <strong>bin</strong> to the
-path.</li>
-<li>Open a new MinGW terminal to inherit the new <strong>Path</strong> values.</li>
-</ul>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="../docker.html" class="btn btn-neutral float-right" title="Everything You Need in a Docker Container" accesskey="n">Next: Everything You Need in a Docker Container <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="native_tools.html" class="btn btn-neutral" title="Installing Native Toolchain" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Installing Native Toolchain</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/get_started/native_install/index.html b/develop/get_started/native_install/index.html
deleted file mode 100644
index 44fa20ce5..000000000
--- a/develop/get_started/native_install/index.html
+++ /dev/null
@@ -1,377 +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">
-
-
-
-
- <title>Native Installation — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../genindex.html"/>
- <link rel="search" title="Search" href="../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../index.html"/>
- <link rel="up" title="Setup & Get Started" href="../index.html"/>
- <link rel="next" title="Installing Newt on Mac OS" href="../../newt/install/newt_mac.html"/>
- <link rel="prev" title="Setup & Get Started" href="../index.html"/>
-
-
- <script src="../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">Setup & Get Started</a> /
-
- Native Installation
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/get_started/native_install/index.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../index.html">Introduction</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">Setup & Get Started</a><ul class="current">
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Native Installation</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="../../newt/install/newt_mac.html">Installing Newt on Mac OS</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../newt/install/newt_linux.html">Installing Newt on Linux</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../newt/install/newt_windows.html">Installing Newt on Windows</a></li>
-<li class="toctree-l3"><a class="reference internal" href="native_tools.html">Installing Native Toolchain</a></li>
-<li class="toctree-l3"><a class="reference internal" href="cross_tools.html">Installing the Cross Tools for ARM</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../docker.html">Docker Container</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../project_create.html">Create Your First Project</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../serial_access.html">Serial Port Setup</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="native-installation">
-<h1>Native Installation<a class="headerlink" href="#native-installation" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-</div>
-<p>This section shows you how to install the tools to develop and build
-Mynewt OS applications on Mac OS, Linux, and Windows, and run and debug
-the applications on target boards. For Mac OS and Linux, you can also
-build Mynewt OS applications that run on Mynewt’s simulated hardware.
-These applications run natively on Mac OS and Linux.</p>
-<p>The tools you need are:</p>
-<ul>
-<li><p class="first"><strong>Newt tool</strong>: Tool to create, build, load, and debug Mynewt OS
-applications.</p>
-<ul class="simple">
-<li><a class="reference internal" href="../../newt/install/newt_mac.html"><span class="doc">Installing Newt on Mac OS</span></a>.</li>
-<li><a class="reference internal" href="../../newt/install/newt_linux.html"><span class="doc">Installing Newt on Linux</span></a>.</li>
-<li><a class="reference internal" href="../../newt/install/newt_windows.html"><span class="doc">Installing Newt on Windows</span></a>.</li>
-</ul>
-</li>
-<li><p class="first"><strong>Native toolchain</strong>: Native toolchain to compile and build Mynewt OS
-applications that run on Mynewt’s simulated hardware on Mac OS and
-Linux.</p>
-<p>(See <a class="reference internal" href="native_tools.html"><span class="doc">Installing Native Toolchain</span></a>).</p>
-</li>
-<li><p class="first"><strong>Cross tools</strong> for ARM:</p>
-<ul class="simple">
-<li>Cross toolchain for ARM to compile and build Mynewt OS
-applications for target boards.</li>
-<li>Debuggers to load and debug applications on target boards.</li>
-</ul>
-<p>(See <a class="reference internal" href="cross_tools.html"><span class="doc">Installing the Cross Tools for ARM</span></a>).</p>
-</li>
-</ul>
-<p>If you would like to use an IDE to develop and debug Mynewt
-applications, see <a class="reference internal" href="../../misc/ide.html"><span class="doc">Developing Mynewt Applications with Visual Studio Code</span></a>. You must still perform the native
-installation outlined on this page.</p>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="../../newt/install/newt_mac.html" class="btn btn-neutral float-right" title="Installing Newt on Mac OS" accesskey="n">Next: Installing Newt on Mac OS <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="../index.html" class="btn btn-neutral" title="Setup & Get Started" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Setup & Get Started</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/get_started/native_install/native_tools.html b/develop/get_started/native_install/native_tools.html
deleted file mode 100644
index c30602a25..000000000
--- a/develop/get_started/native_install/native_tools.html
+++ /dev/null
@@ -1,496 +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">
-
-
-
-
- <title>Installing Native Toolchain — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../genindex.html"/>
- <link rel="search" title="Search" href="../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../index.html"/>
- <link rel="up" title="Native Installation" href="index.html"/>
- <link rel="next" title="Installing the Cross Tools for ARM" href="cross_tools.html"/>
- <link rel="prev" title="Installing Newt on Windows" href="../../newt/install/newt_windows.html"/>
-
-
- <script src="../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">Setup & Get Started</a> /
-
- <a href="index.html">Native Installation</a> /
-
- Installing Native Toolchain
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/get_started/native_install/native_tools.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../index.html">Introduction</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">Setup & Get Started</a><ul class="current">
-<li class="toctree-l2 current"><a class="reference internal" href="index.html">Native Installation</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="../../newt/install/newt_mac.html">Installing Newt on Mac OS</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../newt/install/newt_linux.html">Installing Newt on Linux</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../newt/install/newt_windows.html">Installing Newt on Windows</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">Installing Native Toolchain</a></li>
-<li class="toctree-l3"><a class="reference internal" href="cross_tools.html">Installing the Cross Tools for ARM</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../docker.html">Docker Container</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../project_create.html">Create Your First Project</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../serial_access.html">Serial Port Setup</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="installing-native-toolchain">
-<h1>Installing Native Toolchain<a class="headerlink" href="#installing-native-toolchain" title="Permalink to this headline">¶</a></h1>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#setting-up-the-toolchain-for-mac" id="id1">Setting Up the Toolchain for Mac</a><ul>
-<li><a class="reference internal" href="#installing-brew" id="id2">Installing Brew</a></li>
-<li><a class="reference internal" href="#installing-gcc-libc" id="id3">Installing gcc/libc</a></li>
-<li><a class="reference internal" href="#installing-gdb" id="id4">Installing gdb</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#setting-up-the-toolchain-for-linux" id="id5">Setting Up the Toolchain for Linux</a><ul>
-<li><a class="reference internal" href="#install-gcc-libc-that-will-produce-32-bit-executables" id="id6">Install gcc/libc that will produce 32-bit executables:</a></li>
-<li><a class="reference internal" href="#install-gdb" id="id7">Install gdb</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#next" id="id8">Next</a></li>
-</ul>
-</div>
-<p>This page shows you how to install the toolchain to build Mynewt OS
-applications that run native on Mac OS and Linux. The applications run
-on Mynewt’s simulated hardware. It also allows you to run the test
-suites for all packages that do not require HW support.</p>
-<p><strong>Note:</strong> This is not supported on Windows.</p>
-<div class="section" id="setting-up-the-toolchain-for-mac">
-<h2><a class="toc-backref" href="#id1">Setting Up the Toolchain for Mac</a><a class="headerlink" href="#setting-up-the-toolchain-for-mac" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="installing-brew">
-<h3><a class="toc-backref" href="#id2">Installing Brew</a><a class="headerlink" href="#installing-brew" title="Permalink to this headline">¶</a></h3>
-<p>If you have not already installed Homebrew from the <code class="docutils literal notranslate"><span class="pre">newt</span></code> tutorials
-pages install it (<a class="reference internal" href="../../newt/install/newt_mac.html"><span class="doc">Installing Newt on Mac OS</span></a>).</p>
-</div>
-<div class="section" id="installing-gcc-libc">
-<h3><a class="toc-backref" href="#id3">Installing gcc/libc</a><a class="headerlink" href="#installing-gcc-libc" title="Permalink to this headline">¶</a></h3>
-<p>OS X ships with a C compiler called Clang. To build applications for the
-Mynewt simulator with, a different compiler is used as default: gcc.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> brew install gcc
-<span class="go">...</span>
-<span class="go">...</span>
-<span class="go">==> Summary</span>
-<span class="go">🍺 /usr/local/Cellar/gcc/5.2.0: 1353 files, 248M</span>
-</pre></div>
-</div>
-<p>Check the gcc version you have installed (either using brew or
-previously installed). The brew-installed version can be checked using
-<code class="docutils literal notranslate"><span class="pre">brew</span> <span class="pre">list</span> <span class="pre">gcc</span></code>. The default compiler.yml configuration file in Mynewt
-expects version 5.x for Mac users, so if the installed version is 6.x
-and you wish to continue with this newer version, modify the
-<code class="docutils literal notranslate"><span class="pre"><mynewt-src-directory>/repos/apache-mynewt-core/compiler/sim/compiler.yml</span></code>
-file to change the default <code class="docutils literal notranslate"><span class="pre">gcc-5</span></code> defined there to that displayed by
-<code class="docutils literal notranslate"><span class="pre">brew</span> <span class="pre">list</span> <span class="pre">gcc</span></code> e.g. <code class="docutils literal notranslate"><span class="pre">gcc-6</span></code>. In
-other words, replace the lines shown highlighted below:</p>
-<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="c1"># OS X.</span>
-<span class="hll"><span class="l l-Scalar l-Scalar-Plain">compiler.path.cc.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"gcc-5"</span>
-</span><span class="hll"><span class="l l-Scalar l-Scalar-Plain">compiler.path.as.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"gcc-5"</span>
-</span><span class="l l-Scalar l-Scalar-Plain">compiler.path.objdump.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"gobjdump"</span>
-<span class="l l-Scalar l-Scalar-Plain">compiler.path.objsize.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"objsize"</span>
-<span class="l l-Scalar l-Scalar-Plain">compiler.path.objcopy.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"gobjcopy"</span>
-</pre></div>
-</div>
-<p>with the following:</p>
-<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">compiler.path.cc.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"gcc-6"</span>
-<span class="l l-Scalar l-Scalar-Plain">compiler.path.as.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"gcc-6”</span>
-</pre></div>
-</div>
-<p>In case you wish to use Clang, you can change your
-<code class="docutils literal notranslate"><span class="pre"><mynewt-src-directory>/repos/apache-mynewt-core/compiler/sim/compiler.yml</span></code>
-to use Clang. Delete the gcc-5 DARWIN.OVERWRITE lines highlighted below.</p>
-<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="c1"># OS X.</span>
-<span class="hll"><span class="l l-Scalar l-Scalar-Plain">compiler.path.cc.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"gcc-5"</span>
-</span><span class="hll"><span class="l l-Scalar l-Scalar-Plain">compiler.path.as.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"gcc-5"</span>
-</span><span class="l l-Scalar l-Scalar-Plain">compiler.path.objdump.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"gobjdump"</span>
-<span class="l l-Scalar l-Scalar-Plain">compiler.path.objsize.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"objsize"</span>
-<span class="l l-Scalar l-Scalar-Plain">compiler.path.objcopy.DARWIN.OVERWRITE</span><span class="p p-Indicator">:</span> <span class="s">"gobjcopy"</span>
-</pre></div>
-</div>
-<p><strong>NOTE:</strong> Both the newer gcc 6.x and Clang report a few warnings but
-they can be ignored.</p>
-<p><strong>FURTHER NOTE:</strong> Mynewt developers mostly use gcc 5.x for sim builds;
-so it may take a little while to fix issues reported by the newer
-compiler. One option is to <strong>disable warnings</strong>. To do that, remove the
-<code class="docutils literal notranslate"><span class="pre">-Werror</span></code> flag as an option for the compiler in the
-<code class="docutils literal notranslate"><span class="pre"><mynewt-src-directory>/repos/apache-mynewt-core/compiler/sim/compiler.yml</span></code>
-file as shown below.</p>
-<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">compiler.flags.base</span><span class="p p-Indicator">:</span> <span class="p p-Indicator">></span>
-<span class="hll"> <span class="no">-m32 -Wall -ggdb</span>
-</span></pre></div>
-</div>
-<p>You may alternatively choose to <strong>specify the precise warnings to
-ignore</strong> depending on the error thrown by the compiler. For example, if
-you see a <code class="docutils literal notranslate"><span class="pre">[-Werror=misleading-indentation]</span></code> error while building the
-sim image, add <code class="docutils literal notranslate"><span class="pre">-Wno-misleading-indentation]</span></code> as a compiler flag in
-the same line from the
-<code class="docutils literal notranslate"><span class="pre"><mynewt-src-directory>/repos/apache-mynewt-core/compiler/sim/compiler.yml</span></code>
-file.</p>
-<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">compiler.flags.base</span><span class="p p-Indicator">:</span> <span class="p p-Indicator">></span>
-<span class="hll"> <span class="no">-m32 -Wall -Werror -ggdb -Wno-misleading-indentation</span>
-</span></pre></div>
-</div>
-<p>A third option is to simply <strong>downgrade to gcc 5.x</strong>.</p>
-</div>
-<div class="section" id="installing-gdb">
-<h3><a class="toc-backref" href="#id4">Installing gdb</a><a class="headerlink" href="#installing-gdb" title="Permalink to this headline">¶</a></h3>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> brew install gdb
-<span class="go">...</span>
-<span class="go">...</span>
-<span class="go">==> Summary</span>
-<span class="go">🍺 /usr/local/Cellar/gdb/7.10.1: XXX files,YYM</span>
-</pre></div>
-</div>
-<p><strong>NOTE:</strong> When running a program with gdb, you may need to sign your gdb
-executable. <a class="reference external" href="https://gcc.gnu.org/onlinedocs/gnat_ugn/Codesigning-the-Debugger.html">This
-page</a>
-shows a recipe for gdb signing. Alternately you can skip this step and
-continue without the ability to debug your mynewt application on your
-PC.*</p>
-</div>
-</div>
-<div class="section" id="setting-up-the-toolchain-for-linux">
-<h2><a class="toc-backref" href="#id5">Setting Up the Toolchain for Linux</a><a class="headerlink" href="#setting-up-the-toolchain-for-linux" title="Permalink to this headline">¶</a></h2>
-<p>The below procedure can be used to set up a Debian-based Linux system
-(e.g., Ubuntu). If you are running a different Linux distribution, you
-will need to substitute invocations of <em>apt-get</em> in the below steps with
-the package manager that your distro uses.</p>
-<div class="section" id="install-gcc-libc-that-will-produce-32-bit-executables">
-<h3><a class="toc-backref" href="#id6">Install gcc/libc that will produce 32-bit executables:</a><a class="headerlink" href="#install-gcc-libc-that-will-produce-32-bit-executables" title="Permalink to this headline">¶</a></h3>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> sudo apt-get install gcc-multilib libc6-i386
-</pre></div>
-</div>
-</div>
-<div class="section" id="install-gdb">
-<h3><a class="toc-backref" href="#id7">Install gdb</a><a class="headerlink" href="#install-gdb" title="Permalink to this headline">¶</a></h3>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> sudo apt-get install gdb
-
-<span class="go">Reading package lists... Done</span>
-<span class="go">Building dependency tree</span>
-<span class="go">Reading state information... Done</span>
-<span class="go">Suggested packages:</span>
-<span class="go"> gdb-doc gdbserver</span>
-<span class="go">The following NEW packages will be installed:</span>
-<span class="go"> gdb</span>
-<span class="go">...</span>
-<span class="go">Processing triggers for man-db (2.6.7.1-1ubuntu1) ...</span>
-<span class="go">Setting up gdb (7.7.1-0ubuntu5~14.04.2) ...</span>
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="next">
-<h2><a class="toc-backref" href="#id8">Next</a><a class="headerlink" href="#next" title="Permalink to this headline">¶</a></h2>
-<p>At this point you have installed all the necessary software to build and
-run your first project on a simulator on your Mac OS or Linux computer.
-You may proceed to <a class="reference internal" href="../project_create.html"><span class="doc">Creating Your First Mynewt Project</span></a> or continue to the next section and install the cross tools for
-ARM.</p>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="cross_tools.html" class="btn btn-neutral float-right" title="Installing the Cross Tools for ARM" accesskey="n">Next: Installing the Cross Tools for ARM <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="../../newt/install/newt_windows.html" class="btn btn-neutral" title="Installing Newt on Windows" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Installing Newt on Windows</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/get_started/project_create.html b/develop/get_started/project_create.html
deleted file mode 100644
index e3ade654d..000000000
--- a/develop/get_started/project_create.html
+++ /dev/null
@@ -1,754 +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">
-
-
-
-
- <title>Creating Your First Mynewt Project — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../genindex.html"/>
- <link rel="search" title="Search" href="../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../index.html"/>
- <link rel="up" title="Setup & Get Started" href="index.html"/>
- <link rel="next" title="Using the Serial Port with Mynewt OS" href="serial_access.html"/>
- <link rel="prev" title="Everything You Need in a Docker Container" href="docker.html"/>
-
-
- <script src="../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="index.html">Setup & Get Started</a> /
-
- Creating Your First Mynewt Project
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/get_started/project_create.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="index.html">Setup & Get Started</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="native_install/index.html">Native Installation</a></li>
-<li class="toctree-l2"><a class="reference internal" href="docker.html">Docker Container</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Create Your First Project</a></li>
-<li class="toctree-l2"><a class="reference internal" href="serial_access.html">Serial Port Setup</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="creating-your-first-mynewt-project">
-<h1>Creating Your First Mynewt Project<a class="headerlink" href="#creating-your-first-mynewt-project" title="Permalink to this headline">¶</a></h1>
-<p>This page shows you how to create a Mynewt project using the <code class="docutils literal notranslate"><span class="pre">newt</span></code>
-command-line tool. The project is a blinky application that toggles a
-pin. The application uses the Mynewt’s simulated hardware and runs as a
-native application on Mac OS and Linux.</p>
-<p><strong>Note:</strong> The Mynewt simulator is not yet supported on Windows. If you
-are using the native install option (not the Docker option), you will
-need to create the blinky application for a target board. We recommend
-that you read the section on creating a new project and fetching the
-source repository to understand the Mynewt repository structure, create
-a new project, and fetch the source dependencies before proceeding to
-one of the <a class="reference internal" href="../tutorials/blinky/blinky.html#blinky-tutorials"><span class="std std-ref">Project Blinky</span></a>.</p>
-<p>This guide shows you how to:</p>
-<ol class="arabic simple">
-<li>Create a new project and fetch the source repository and
-dependencies.</li>
-<li>Test the project packages. (Not supported on Windows.)</li>
-<li>Build and run the simulated blinky application. (Not supported on
-Windows.)</li>
-</ol>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#prerequisites" id="id1">Prerequisites</a></li>
-<li><a class="reference internal" href="#creating-a-new-project-and-fetching-the-source-repository" id="id2">Creating a New Project and Fetching the Source Repository</a><ul>
-<li><a class="reference internal" href="#creating-a-new-project" id="id3">Creating a New Project</a></li>
-<li><a class="reference internal" href="#fetching-the-mynewt-source-repository-and-dependencies" id="id4">Fetching the Mynewt Source Repository and Dependencies</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#testing-the-project-packages" id="id5">Testing the Project Packages</a></li>
-<li><a class="reference internal" href="#building-and-running-the-simulated-blinky-application" id="id6">Building and Running the Simulated Blinky Application</a><ul>
-<li><a class="reference internal" href="#building-the-application" id="id7">Building the Application</a></li>
-<li><a class="reference internal" href="#running-the-blinky-application" id="id8">Running the Blinky Application</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#exploring-other-mynewt-os-features" id="id9">Exploring other Mynewt OS Features</a></li>
-</ul>
-</div>
-<div class="section" id="prerequisites">
-<h2><a class="toc-backref" href="#id1">Prerequisites</a><a class="headerlink" href="#prerequisites" title="Permalink to this headline">¶</a></h2>
-<ul class="simple">
-<li>Have Internet connectivity to fetch remote Mynewt components.</li>
-<li>Install the newt tool:<ul>
-<li>If you have taken the native install option, see the installation
-instructions for <a class="reference internal" href="../newt/install/newt_mac.html"><span class="doc">Mac OS</span></a>,
-<a class="reference internal" href="../newt/install/newt_linux.html"><span class="doc">Linux</span></a>, or
-<a class="reference internal" href="../newt/install/newt_windows.html"><span class="doc">Windows</span></a>.</li>
-<li>If you have taken the Docker option, you have already installed
-Newt.</li>
-</ul>
-</li>
-<li>Install the <a class="reference internal" href="native_install/native_tools.html"><span class="doc">native toolchain</span></a> to compile and
-build a Mynewt native application.</li>
-</ul>
-</div>
-<div class="section" id="creating-a-new-project-and-fetching-the-source-repository">
-<h2><a class="toc-backref" href="#id2">Creating a New Project and Fetching the Source Repository</a><a class="headerlink" href="#creating-a-new-project-and-fetching-the-source-repository" title="Permalink to this headline">¶</a></h2>
-<p>This section describes how to use the newt tool to create a new project
-and fetch the core mynewt source repository.</p>
-<div class="section" id="creating-a-new-project">
-<h3><a class="toc-backref" href="#id3">Creating a New Project</a><a class="headerlink" href="#creating-a-new-project" title="Permalink to this headline">¶</a></h3>
-<p>Choose a name for your project. We name the project <code class="docutils literal notranslate"><span class="pre">myproj</span></code>.</p>
-<p>Run the <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">new</span> <span class="pre">myproj</span></code> command, from your <strong>dev</strong> directory, to
-create a new project:</p>
-<p><strong>Note:</strong> This tutorial assumes you created a <strong>dev</strong> directory under
-your home directory.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> <span class="nb">cd</span> ~/dev
-<span class="gp">$</span> newt new myproj
-<span class="go">Downloading project skeleton from apache/mynewt-blinky...</span>
-<span class="go">Installing skeleton in myproj...</span>
-<span class="go">Project myproj successfully created.</span>
-</pre></div>
-</div>
-<p>The newt tool creates a project base directory name <strong>myproj</strong>. All newt
-tool commands are run from the project base directory. The newt tool
-populates this new project with a base skeleton of a new Apache Mynewt
-project in the project base directory. It has the following structure:</p>
-<p><strong>Note</strong>: If you do not have <code class="docutils literal notranslate"><span class="pre">tree</span></code>, run <code class="docutils literal notranslate"><span class="pre">brew</span> <span class="pre">install</span> <span class="pre">tree</span></code> to
-install on Mac OS, <code class="docutils literal notranslate"><span class="pre">sudo</span> <span class="pre">apt-get</span> <span class="pre">install</span> <span class="pre">tree</span></code> to install on Linux,
-and <code class="docutils literal notranslate"><span class="pre">pacman</span> <span class="pre">-Su</span> <span class="pre">tree</span></code> from a MinGW terminal to install on Windows.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> <span class="nb">cd</span> myproj
-<span class="gp">$</span> tree
-<span class="go">.</span>
-<span class="go">├── DISCLAIMER</span>
-<span class="go">├── LICENSE</span>
-<span class="go">├── NOTICE</span>
-<span class="go">├── README.md</span>
-<span class="go">├── apps</span>
-<span class="go">│ └── blinky</span>
-<span class="go">│ ├── pkg.yml</span>
-<span class="go">│ └── src</span>
-<span class="go">│ └── main.c</span>
-<span class="go">├── project.yml</span>
-<span class="go">└── targets</span>
-<span class="go"> ├── my_blinky_sim</span>
-<span class="go"> │ ├── pkg.yml</span>
-<span class="go"> │ └── target.yml</span>
-<span class="go"> └── unittest</span>
-<span class="go"> ├── pkg.yml</span>
-<span class="go"> └── target.yml</span>
-
-<span class="go">6 directories, 11 files</span>
-</pre></div>
-</div>
-<p>The newt tool installs the following files for a project in the project
-base directory:</p>
-<ol class="arabic simple">
-<li>The file <code class="docutils literal notranslate"><span class="pre">project.yml</span></code> contains the repository list that the
-project uses to fetch its packages. Your project is a collection of
-repositories. In this case, the project only comprises the core
-mynewt repository. Later, you will add more repositories to include
-other mynewt components.</li>
-<li>The file <code class="docutils literal notranslate"><span class="pre">apps/blinky/pkg.yml</span></code> contains the description of your
-application and its package dependencies.</li>
-<li>A <code class="docutils literal notranslate"><span class="pre">target</span></code> directory that contains the <code class="docutils literal notranslate"><span class="pre">my_blinky_sim</span></code> directory.
-The <code class="docutils literal notranslate"><span class="pre">my_blinky_sim</span></code> directory a target information to build a
-version of myproj. Use <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">target</span> <span class="pre">show</span></code> to see available build
-targets.</li>
-<li>A non-buildable target called <code class="docutils literal notranslate"><span class="pre">unittest</span></code>. This is used internally
-by <code class="docutils literal notranslate"><span class="pre">newt</span></code> and is not a formal build target.</li>
-</ol>
-<p><strong>Note:</strong> The actual code and package files are not installed (except
-the template for <code class="docutils literal notranslate"><span class="pre">main.c</span></code>). See the next step to install the packages.</p>
-</div>
-<div class="section" id="fetching-the-mynewt-source-repository-and-dependencies">
-<h3><a class="toc-backref" href="#id4">Fetching the Mynewt Source Repository and Dependencies</a><a class="headerlink" href="#fetching-the-mynewt-source-repository-and-dependencies" title="Permalink to this headline">¶</a></h3>
-<p>By default, Mynewt projects rely on a single repository:
-<strong>apache-mynewt-core</strong> and uses the source in the master branch. If you
-need to use a different branch, you need to change the <code class="docutils literal notranslate"><span class="pre">vers</span></code> value in
-the project.yml file:</p>
-<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">repository.apache-mynewt-core</span><span class="p p-Indicator">:</span>
- <span class="l l-Scalar l-Scalar-Plain">type</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">github</span>
-<span class="hll"> <span class="l l-Scalar l-Scalar-Plain">vers</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">1-latest</span>
-</span> <span class="l l-Scalar l-Scalar-Plain">user</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">apache</span>
- <span class="l l-Scalar l-Scalar-Plain">repo</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">mynewt-core</span>
-</pre></div>
-</div>
-<p>Changing vers to 0-dev will put you on the latest master branch. <strong>This
-branch may not be stable and you may encounter bugs or other problems.</strong></p>
-<p><strong>Note:</strong> On Windows platforms, you will need to change vers to 0-dev
-and use the latest master branch. Release 1.0.0 is not supported on
-Windows.</p>
-<p>Run the <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">install</span></code> command, from your project base directory
-(myproj), to fetch the source repository and dependencies.</p>
-<p><strong>Note:</strong> It may take a while to download the apache-mynewt-core
-reposistory. Use the <em>-v</em> (verbose) option to see the installation
-progress.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> newt install
-<span class="go">apache-mynewt-core successfully installed version 1.3.0-none</span>
-</pre></div>
-</div>
-<p><strong>Note:</strong> If you get the following error:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">ReadDesc: No matching branch for apache-mynewt-core repo</span>
-<span class="go">Error: No matching branch for apache-mynewt-core repop</span>
-</pre></div>
-</div>
-<p>You must edit the <code class="docutils literal notranslate"><span class="pre">project.yml</span></code> file and change the line
-<code class="docutils literal notranslate"><span class="pre">repo:</span> <span class="pre">incubator-mynewt-core</span></code> as shown in the following example to
-<code class="docutils literal notranslate"><span class="pre">repo:</span> <span class="pre">mynewt-core</span></code>:</p>
-<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">repository.apache-mynewt-core</span><span class="p p-Indicator">:</span>
- <span class="l l-Scalar l-Scalar-Plain">type</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">github</span>
- <span class="l l-Scalar l-Scalar-Plain">vers</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">1-latest</span>
- <span class="l l-Scalar l-Scalar-Plain">user</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">apache</span>
-<span class="hll"> <span class="l l-Scalar l-Scalar-Plain">repo</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">incubator-mynewt-core</span>
-</span></pre></div>
-</div>
-<p>View the core of the Apache Mynewt OS that is downloaded into your local
-directory.</p>
-<p>(The actual output will depend on what is in the latest ‘master’ branch)</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> tree -L <span class="m">2</span> repos/apache-mynewt-core/
-
-<span class="go">repos/apache-mynewt-core/</span>
-<span class="go">├── CODING_STANDARDS.md</span>
-<span class="go">├── DISCLAIMER</span>
-<span class="go">├── LICENSE</span>
-<span class="go">├── NOTICE</span>
-<span class="go">├── README.md</span>
-<span class="go">├── RELEASE_NOTES.md</span>
-<span class="go">├── apps</span>
-<span class="go">│ ├── blecent</span>
-<span class="go">│ ├── blehci</span>
-<span class="go">│ ├── bleprph</span>
-<span class="go">│ ├── bleprph_oic</span>
-<span class="go">│ ├── blesplit</span>
-<span class="go">│ ├── bletest</span>
-<span class="go">│ ├── bleuart</span>
-<span class="go">│ ├── boot</span>
-<span class="go">│ ├── btshell</span>
-<span class="go">│ ├── fat2native</span>
-<span class="go">│ ├── ffs2native</span>
-<span class="go">│ ├── ocf_sample</span>
-<span class="go">│ ├── slinky</span>
-<span class="go">│ ├── slinky_oic</span>
-<span class="go">│ ├── spitest</span>
-<span class="go">│ ├── splitty</span>
-<span class="go">│ ├── test</span>
-<span class="go">│ ├── testbench</span>
-<span class="go">│ └── timtest</span>
-<span class="go">├── boot</span>
-<span class="go">│ ├── boot_serial</span>
-<span class="go">│ ├── bootutil</span>
-<span class="go">│ ├── split</span>
-<span class="go">│ └── split_app</span>
-<span class="go">├── compiler</span>
-<span class="go">│ ├── arm-none-eabi-m0</span>
-<span class="go">│ ├── arm-none-eabi-m4</span>
-<span class="go">│ ├── gdbmacros</span>
-<span class="go">│ ├── mips</span>
-<span class="go">│ ├── sim</span>
-<span class="go">│ └── sim-mips</span>
-<span class="go">├── crypto</span>
-<span class="go">│ ├── mbedtls</span>
-<span class="go">│ └── tinycrypt</span>
-<span class="go">├── docs</span>
-<span class="go">│ └── doxygen.xml</span>
-<span class="go">├── encoding</span>
-<span class="go">│ ├── base64</span>
-<span class="go">│ ├── cborattr</span>
-<span class="go">│ ├── json</span>
-<span class="go">│ └── tinycbor</span>
-<span class="go">├── fs</span>
-<span class="go">│ ├── disk</span>
-<span class="go">│ ├── fatfs</span>
-<span class="go">│ ├── fcb</span>
-<span class="go">│ ├── fs</span>
-<span class="go">│ └── nffs</span>
-<span class="go">├── hw</span>
-<span class="go">│ ├── bsp</span>
-<span class="go">│ ├── cmsis-core</span>
-<span class="go">│ ├── drivers</span>
-<span class="go">│ ├── hal</span>
-<span class="go">│ ├── mcu</span>
-<span class="go">│ └── scripts</span>
-<span class="go">├── kernel</span>
-<span class="go">│ └── os</span>
-<span class="go">├── libc</span>
-<span class="go">│ └── baselibc</span>
-<span class="go">├── mgmt</span>
-<span class="go">│ ├── imgmgr</span>
-<span class="go">│ ├── mgmt</span>
-<span class="go">│ ├── newtmgr</span>
-<span class="go">│ └── oicmgr</span>
-<span class="go">├── net</span>
-<span class="go">│ ├── ip</span>
-<span class="go">│ ├── nimble</span>
-<span class="go">│ ├── oic</span>
-<span class="go">│ └── wifi</span>
-<span class="go">├── project.yml</span>
-<span class="go">├── repository.yml</span>
-<span class="go">├── sys</span>
-<span class="go">│ ├── config</span>
-<span class="go">│ ├── console</span>
-<span class="go">│ ├── coredump</span>
-<span class="go">│ ├── defs</span>
-<span class="go">│ ├── flash_map</span>
-<span class="go">│ ├── id</span>
-<span class="go">│ ├── log</span>
-<span class="go">│ ├── mfg</span>
-<span class="go">│ ├── reboot</span>
-<span class="go">│ ├── shell</span>
-<span class="go">│ ├── stats</span>
-<span class="go">│ └── sysinit</span>
-<span class="go">├── targets</span>
-<span class="go">│ └── unittest</span>
-<span class="go">├── test</span>
-<span class="go">│ ├── crash_test</span>
-<span class="go">│ ├── flash_test</span>
-<span class="go">│ ├── runtest</span>
-<span class="go">│ └── testutil</span>
-<span class="go">├── time</span>
-<span class="go">│ └── datetime</span>
-<span class="go">└── util</span>
-<span class="go"> ├── cbmem</span>
-<span class="go"> ├── crc</span>
-<span class="go"> └── mem</span>
-
-<span class="go">94 directories, 9 files</span>
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="testing-the-project-packages">
-<h2><a class="toc-backref" href="#id5">Testing the Project Packages</a><a class="headerlink" href="#testing-the-project-packages" title="Permalink to this headline">¶</a></h2>
-<p><strong>Note</strong>: This is not yet supported on Windows.</p>
-<p>You can use the newt tool to execute the unit tests in a package. For
-example, run the following command to test the <code class="docutils literal notranslate"><span class="pre">sys/config</span></code> package in
-the <code class="docutils literal notranslate"><span class="pre">apache-mynewt-core</span></code> repo:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> newt <span class="nb">test</span> @apache-mynewt-core/sys/config
-<span class="go">Testing package @apache-mynewt-core/sys/config/test-fcb</span>
-<span class="go">Compiling bootutil_misc.c</span>
-<span class="go">Compiling image_ec.c</span>
-<span class="go">Compiling image_rsa.c</span>
-<span class="go">Compiling image_validate.c</span>
-
-<span class="go">...</span>
-
-<span class="go">Linking ~/dev/myproj/bin/targets/unittest/sys_config_test-fcb/app/sys/config/test-fcb/sys_config_test-fcb.elf</span>
-<span class="go">Executing test: ~/dev/myproj/bin/targets/unittest/sys_config_test-fcb/app/sys/config/test-fcb/sys_config_test-fcb.elf</span>
-<span class="go">Testing package @apache-mynewt-core/sys/config/test-nffs</span>
-<span class="go">Compiling repos/apache-mynewt-core/encoding/base64/src/hex.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/fs/fs/src/fs_cli.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/fs/fs/src/fs_dirent.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/fs/fs/src/fs_mkdir.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/fs/fs/src/fs_mount.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/encoding/base64/src/base64.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/fs/fs/src/fs_file.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/fs/disk/src/disk.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/fs/fs/src/fs_nmgr.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/fs/fs/src/fsutil.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/fs/nffs/src/nffs.c</span>
-
-<span class="go">...</span>
-
-<span class="go">Linking ~/dev/myproj/bin/targets/unittest/sys_config_test-nffs/app/sys/config/test-nffs/sys_config_test-nffs.elf</span>
-<span class="go">Executing test: ~/dev/myproj/bin/targets/unittest/sys_config_test-nffs/app/sys/config/test-nffs/sys_config_test-nffs.elf</span>
-<span class="go">Passed tests: [sys/config/test-fcb sys/config/test-nffs]</span>
-<span class="go">All tests passed</span>
-</pre></div>
-</div>
-<p><strong>Note:</strong> If you installed the latest gcc using homebrew on your Mac,
-you are probably running gcc-6. Make sure you change the compiler.yml
-configuration to specify that you are using gcc-6 (See <a class="reference internal" href="native_install/native_tools.html"><span class="doc">Installing Native Toolchain</span></a>). You can also
-downgrade your installation to gcc-5 and use the default gcc compiler configuration for MyNewt:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> brew uninstall gcc-6
-<span class="gp">$</span> brew link gcc-5
-</pre></div>
-</div>
-<p><strong>Note:</strong> If you are running the standard gcc for 64-bit machines, it
-does not support 32-bit. In that case you will see compilation errors.
-You need to install multilib gcc (e.g. gcc-multilib if you running on a
-64-bit Ubuntu).</p>
-<p>To test all the packages in a project, specify <code class="docutils literal notranslate"><span class="pre">all</span></code> instead of the
-package name.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> newt <span class="nb">test</span> all
-<span class="go">Testing package @apache-mynewt-core/boot/boot_serial/test</span>
-<span class="go">Compiling repos/apache-mynewt-core/boot/boot_serial/test/src/boot_test.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/boot/boot_serial/test/src/testcases/boot_serial_setup.c</span>
-
-<span class="go">...</span>
-
-<span class="go">Linking ~/dev/myproj/bin/targets/unittest/boot_boot_serial_test/app/boot/boot_serial/test/boot_boot_serial_test.elf</span>
-
-<span class="go">...lots of compiling and testing...</span>
-
-<span class="go">Linking ~/dev/myproj/bin/targets/unittest/util_cbmem_test/app/util/cbmem/test/util_cbmem_test.elf</span>
-<span class="go">Executing test: ~/dev/myproj/bin/targets/unittest/util_cbmem_test/app/util/cbmem/test/util_cbmem_test.elf</span>
-<span class="go">Passed tests: [boot/boot_serial/test boot/bootutil/test crypto/mbedtls/test encoding/base64/test encoding/cborattr/test encoding/json/test fs/fcb/test fs/nffs/test kernel/os/test net/ip/mn_socket/test net/nimble/host/test net/oic/test sys/config/test-fcb sys/config/test-nffs sys/flash_map/test sys/log/full/test util/cbmem/test]</span>
-<span class="go">All tests passed</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="building-and-running-the-simulated-blinky-application">
-<h2><a class="toc-backref" href="#id6">Building and Running the Simulated Blinky Application</a><a class="headerlink" href="#building-and-running-the-simulated-blinky-application" title="Permalink to this headline">¶</a></h2>
-<p>The section shows you how to build and run the blinky application to run
-on Mynewt’s simulated hardware.</p>
-<p><strong>Note</strong>: This is not yet supported on Windows. Refer to the <a class="reference internal" href="../tutorials/blinky/blinky.html#blinky-tutorials"><span class="std std-ref">Project Blinky</span></a> to create a blinky application
-for a target board.</p>
-<div class="section" id="building-the-application">
-<h3><a class="toc-backref" href="#id7">Building the Application</a><a class="headerlink" href="#building-the-application" title="Permalink to this headline">¶</a></h3>
-<p>To build the simulated blinky application, run <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">build</span> <span class="pre">my_blinky_sim</span></code>:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> newt build my_blinky_sim
-<span class="go">Building target targets/my_blinky_sim</span>
-<span class="go">Compiling repos/apache-mynewt-core/hw/hal/src/hal_common.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/hw/drivers/uart/src/uart.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/hw/hal/src/hal_flash.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/hw/bsp/native/src/hal_bsp.c</span>
-<span class="go">Compiling repos/apache-mynewt-core/hw/drivers/uart/uart_hal/src/uart_hal.c</span>
-<span class="go">Compiling apps/blinky/src/main.c</span>
-
-<span class="go">...</span>
-
-<span class="go">Archiving sys_mfg.a</span>
-<span class="go">Archiving sys_sysinit.a</span>
-<span class="go">Archiving util_mem.a</span>
-<span class="go">Linking ~/dev/myproj/bin/targets/my_blinky_sim/app/apps/blinky/blinky.elf</span>
-<span class="go">Target successfully built: targets/my_blinky_sim</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="running-the-blinky-application">
-<h3><a class="toc-backref" href="#id8">Running the Blinky Application</a><a class="headerlink" href="#running-the-blinky-application" title="Permalink to this headline">¶</a></h3>
-<p>You can run the simulated version of your project and see the simulated
-LED blink.</p>
-<p>If you natively install the toolchain execute the binary directly:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> ./bin/targets/my_blinky_sim/app/apps/blinky/blinky.elf
-<span class="go">hal_gpio set pin 1 to 0</span>
-</pre></div>
-</div>
-<p>If you are using newt docker, use <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">run</span></code> to run the simulated
-binary.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> newt run my_blinky_sim
-<span class="go">Loading app image into slot 1</span>
-<span class="go"> ...</span>
-<span class="go">Debugging ~/dev/myproj/bin/targets/my_blinky_sim/app/apps/blinky/blinky.elf</span>
-<span class="go"> ...</span>
-<span class="go">Reading symbols from /bin/targets/my_blinky_sim/app/apps/blinky/blinky.elf...done.</span>
-<span class="go">(gdb)</span>
-</pre></div>
-</div>
-<p>Type <code class="docutils literal notranslate"><span class="pre">r</span></code> at the <code class="docutils literal notranslate"><span class="pre">(gdb)</span></code> prompt to run the project. You will see an
-output indicating that the hal_gpio pin is toggling between 1 and 0 in
-a simulated blink.</p>
-<p>Type <code class="docutils literal notranslate"><span class="pre">r</span></code> at the <code class="docutils literal notranslate"><span class="pre">(gdb)</span></code> prompt to run the project. You will see an
-output indicating that the <code class="docutils literal notranslate"><span class="pre">hal_gpio</span></code> pin is toggling between 1 and 0
-in a simulated blink.</p>
-</div>
-</div>
-<div class="section" id="exploring-other-mynewt-os-features">
-<h2><a class="toc-backref" href="#id9">Exploring other Mynewt OS Features</a><a class="headerlink" href="#exploring-other-mynewt-os-features" title="Permalink to this headline">¶</a></h2>
-<p>Congratulations, you have created your first project! The blinky
-application is not terribly exciting when it is run in the simulator, as
-there is no LED to blink. Apache Mynewt has a lot more functionality
-than just running simulated applications. It provides all the features
-you’ll need to cross-compile your application, run it on real hardware
-and develop a full featured application.</p>
-<p>If you’re interested in learning more, a good next step is to dig in to
-one of the <a class="reference internal" href="../tutorials/tutorials.html#tutorials"><span class="std std-ref">Tutorials</span></a> and get a Mynewt
-project running on real hardware.</p>
-<p>Happy Hacking!</p>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="serial_access.html" class="btn btn-neutral float-right" title="Using the Serial Port with Mynewt OS" accesskey="n">Next: Using the Serial Port with Mynewt OS <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="docker.html" class="btn btn-neutral" title="Everything You Need in a Docker Container" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Everything You Need in a Docker Container</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../_static/js/affix.js"></script>
- <script type="text/javascript" src="../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/get_started/serial_access.html b/develop/get_started/serial_access.html
deleted file mode 100644
index ffbe51468..000000000
--- a/develop/get_started/serial_access.html
+++ /dev/null
@@ -1,530 +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">
-
-
-
-
- <title>Using the Serial Port with Mynewt OS — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../genindex.html"/>
- <link rel="search" title="Search" href="../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../index.html"/>
- <link rel="up" title="Setup & Get Started" href="index.html"/>
- <link rel="next" title="Concepts" href="../concepts.html"/>
- <link rel="prev" title="Creating Your First Mynewt Project" href="project_create.html"/>
-
-
- <script src="../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="index.html">Setup & Get Started</a> /
-
- Using the Serial Port with Mynewt OS
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/get_started/serial_access.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="index.html">Setup & Get Started</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="native_install/index.html">Native Installation</a></li>
-<li class="toctree-l2"><a class="reference internal" href="docker.html">Docker Container</a></li>
-<li class="toctree-l2"><a class="reference internal" href="project_create.html">Create Your First Project</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Serial Port Setup</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="using-the-serial-port-with-mynewt-os">
-<h1>Using the Serial Port with Mynewt OS<a class="headerlink" href="#using-the-serial-port-with-mynewt-os" title="Permalink to this headline">¶</a></h1>
-<p>Some of the projects and tutorials here will allow you to use a serial
-port to interact with your Mynewt project. While most modern PCs and
-laptops no longer have a true serial port, almost all can use their USB
-ports as serial ports.</p>
-<p>This page will show you how to connect to some of the development boards we
-use via a serial port.</p>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#using-the-usb-port-on-the-nrf52dk" id="id4">Using the USB port on the nRF52DK</a></li>
-<li><a class="reference internal" href="#using-a-usb-to-serial-breakout-board" id="id5">Using a USB to Serial Breakout Board</a><ul>
-<li><a class="reference internal" href="#setup-ft232h" id="id6">Setup FT232H</a></li>
-<li><a class="reference internal" href="#setup-nordic-semiconductor-nrf52dk" id="id7">Setup Nordic Semiconductor NRF52DK</a></li>
-<li><a class="reference internal" href="#setup-arduino-m0-pro" id="id8">Setup Arduino M0 Pro</a></li>
-<li><a class="reference internal" href="#setup-serial-communications" id="id9">Setup Serial Communications</a><ul>
-<li><a class="reference internal" href="#example-for-mac-os-and-linux-platforms" id="id10">Example for Mac OS and Linux Platforms</a></li>
-<li><a class="reference internal" href="#example-for-windows-platforms" id="id11">Example for Windows Platforms</a></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-</div>
-<div class="section" id="using-the-usb-port-on-the-nrf52dk">
-<h2><a class="toc-backref" href="#id4">Using the USB port on the nRF52DK</a><a class="headerlink" href="#using-the-usb-port-on-the-nrf52dk" title="Permalink to this headline">¶</a></h2>
-<p>The nRF52DK can communicate via a serial port directly through its USB port. By default, it uses the UART onboard, so if you need to use the UART for other purposes, consider using a USB<–>Serial converter or the Segger RTT Console instead, instructions provided below.</p>
-<p>To see your device, check the USB devices that are connected to your computer (macOS):</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> ls -l /dev/*USB*
-<span class="go">crw-rw-rw- 1 <user> None 117, 5 May 9 04:24 /dev/cu.usbmodem1411</span>
-<span class="go">crw-rw-rw- 1 <user> None 117, 5 May 9 04:24 /dev/tty.usbmodem1411</span>
-<span class="gp">$</span>
-</pre></div>
-</div>
-<p>The <code class="docutils literal notranslate"><span class="pre">/dev/cu.usbmodem####</span></code> and <code class="docutils literal notranslate"><span class="pre">/dev/tty.usbmodem####</span></code> represent your device. To get console access, you can either use the screen command or Minicom:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> minicom -D /dev/tty.usbmodem1411
-
-<span class="go">Welcome to minicom 2.7</span>
-
-<span class="go">OPTIONS:</span>
-<span class="go">Compiled on Apr 26 2018, 13:21:44</span>
-<span class="go">Port /dev/tty.usbmodem1411, 11:12:13</span>
-
-<span class="go">Press Meta-Z for help on special keys</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="using-a-usb-to-serial-breakout-board">
-<h2><a class="toc-backref" href="#id5">Using a USB to Serial Breakout Board</a><a class="headerlink" href="#using-a-usb-to-serial-breakout-board" title="Permalink to this headline">¶</a></h2>
-<p>If you need to use an external USB to Serial converter, this guide will show you how to set it up. The development boards covered here are:</p>
-<ul class="simple">
-<li>Nordic Semiconductor nRF52dk</li>
-<li>Arduino M0 Pro</li>
-</ul>
-<p>For this tutorial, we’ll be using the <a class="reference external" href="https://www.adafruit.com/products/2264">AdaFruit FT232H Breakout
-Board</a>, but almost
-any similar board should work just as well. You will also need Minicom
-or a similar Serial communications application. We’ll show you how to
-use the <code class="docutils literal notranslate"><span class="pre">screen</span></code> command built in to Mac OS X, but later tutorials
-will also show Minicom setup.</p>
-<div class="section" id="setup-ft232h">
-<h3><a class="toc-backref" href="#id6">Setup FT232H</a><a class="headerlink" href="#setup-ft232h" title="Permalink to this headline">¶</a></h3>
-<p>This is a great board because it’s so easy to set up, and it can do
-Serial UART, SPI, I2C and GPIO as well. There’s full documentation on
-the board
-<a class="reference external" href="https://learn.adafruit.com/adafruit-ft232h-breakout/overview">here</a>
-but we’re only covering the wiring for the Serial UART.</p>
-<p>Start by connecting a jumper wire to Pin D0. This will be the UART Tx
-pin, which we’ll then connect to the Rx pin on the Development Board.</p>
-<p>Next connect a jumper wire to pin D1. This will be the UART Rx pin,
-which we’ll connect to the Tx pin on the development board.</p>
-<p>Finally connect a jumper wire to the GND pin.</p>
-<p>It should look like this:</p>
-<div class="figure" id="id1">
-<img alt="FT232H Wiring" src="../_images/ft232h.png" />
-<p class="caption"><span class="caption-text">FT232H Wiring</span></p>
-</div>
-</div>
-<div class="section" id="setup-nordic-semiconductor-nrf52dk">
-<h3><a class="toc-backref" href="#id7">Setup Nordic Semiconductor NRF52DK</a><a class="headerlink" href="#setup-nordic-semiconductor-nrf52dk" title="Permalink to this headline">¶</a></h3>
-<p>On the NRF52DK developer kit board, the Rx pin is P0.08, so you’ll
-attach your jumper wire from the Tx pin (D0) of the FT232H board here.</p>
-<p>The TX Pin is pin P0.06, so you’ll attache the jumper wire from the Rx
-Pin (D1) on the FT232H board here.</p>
-<p>Finally, the GND wire should go to the GND Pin on the NRF52DK. When
-you’re done, your wiring should look like this:</p>
-<div class="figure" id="id2">
-<img alt="NRF52DK Wiring" src="../_images/nrf52dk.png" />
-<p class="caption"><span class="caption-text">NRF52DK Wiring</span></p>
-</div>
-</div>
-<div class="section" id="setup-arduino-m0-pro">
-<h3><a class="toc-backref" href="#id8">Setup Arduino M0 Pro</a><a class="headerlink" href="#setup-arduino-m0-pro" title="Permalink to this headline">¶</a></h3>
-<p>On the Arduino M0 Pro, the Tx and Rx pins are clearly labeled as such,
-as is the GND pin. Just make sure you wire Rx from the FT232H to TX on
-the M0 Pro, and vice-versa.</p>
-<p>Your Arduino M0 Pro should look like this:</p>
-<div class="figure" id="id3">
-<img alt="Arduino M0 Pro Wiring" src="../_images/m0pro.png" />
-<p class="caption"><span class="caption-text">Arduino M0 Pro Wiring</span></p>
-</div>
-</div>
-<div class="section" id="setup-serial-communications">
-<h3><a class="toc-backref" href="#id9">Setup Serial Communications</a><a class="headerlink" href="#setup-serial-communications" title="Permalink to this headline">¶</a></h3>
-<p>You will need to know the serial port to connect to and use a terminal
-program to connect to the board.</p>
-<div class="section" id="example-for-mac-os-and-linux-platforms">
-<h4><a class="toc-backref" href="#id10">Example for Mac OS and Linux Platforms</a><a class="headerlink" href="#example-for-mac-os-and-linux-platforms" title="Permalink to this headline">¶</a></h4>
-<p>First check what USB devices are already connected before connecting the
-FT232H board to your computer. The ports are listed in the <strong>/dev</strong>
-directory and the format of the port name is platform dependent:</p>
-<ul class="simple">
-<li>Mac OS uses the format <code class="docutils literal notranslate"><span class="pre">tty.usbserial-<some</span> <span class="pre">identifier></span></code>.</li>
-<li>Linux uses the format <code class="docutils literal notranslate"><span class="pre">TTYUSB<N></span></code>, where <code class="docutils literal notranslate"><span class="pre">N</span></code> is a number. For
-example, TTYUSB2.</li>
-</ul>
-<p>This example is run on a Mac OS system.</p>
-<p>Check what USB devices are already connected:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> ls -la /dev/*usb*
-<span class="go">0 crw-rw-rw- 1 root wheel 20, 63 Nov 23 11:13 /dev/cu.usbmodem401322</span>
-<span class="go">0 crw-rw-rw- 1 root wheel 20, 62 Nov 23 11:13 /dev/tty.usbmodem401322</span>
-<span class="gp">$</span>
-</pre></div>
-</div>
-<p>Plug in the FT232H board and check the ports again:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> ls -la /dev/*usb*
-<span class="go">0 crw-rw-rw- 1 root wheel 20, 63 Nov 23 11:13 /dev/cu.usbmodem401322</span>
-<span class="go">0 crw-rw-rw- 1 root wheel 20, 65 Nov 23 11:26 /dev/cu.usbserial-0020124</span>
-<span class="go">0 crw-rw-rw- 1 root wheel 20, 62 Nov 23 11:13 /dev/tty.usbmodem401322</span>
-<span class="go">0 crw-rw-rw- 1 root wheel 20, 64 Nov 23 11:26 /dev/tty.usbserial-0020124</span>
-<span class="gp">$</span>
-</pre></div>
-</div>
-<p>The FT232H is connected to <code class="docutils literal notranslate"><span class="pre">/dev/tty.usbserial-0020124</span></code> (The number
-after tty.usbserial will be different on your machine.) Use the screen
-command to connect to the board:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> screen /dev/tty.usbserial-0020124 <span class="m">115200</span>
-</pre></div>
-</div>
-<p>To exit out of <code class="docutils literal notranslate"><span class="pre">screen</span></code> you’ll type <code class="docutils literal notranslate"><span class="pre">control-A</span></code> followed by
-<code class="docutils literal notranslate"><span class="pre">control-\</span></code> and you’ll be back to a terminal prompt.</p>
-<p>You can also use minicom:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> minicom -D /dev/tty.usbserial-0020124
-
-<span class="go">Welcome to minicom 2.7</span>
-
-<span class="go">OPTIONS:</span>
-<span class="go">Compiled on Nov 24 2015, 16:14:21.</span>
-<span class="go">Port /dev/tty.usbserial-0020124, 09:57:17</span>
-
-<span class="go">Press Meta-Z for help on special keys</span>
-</pre></div>
-</div>
-<p>If there’s no Mynewt app running, or the Mynewt app doesn’t have the
-Shell and Console enabled, you won’t see anything there, but you can
-always refer back to this page from later tutorials if you need to.</p>
-</div>
-<div class="section" id="example-for-windows-platforms">
-<h4><a class="toc-backref" href="#id11">Example for Windows Platforms</a><a class="headerlink" href="#example-for-windows-platforms" title="Permalink to this headline">¶</a></h4>
-<p>First check what USB devices are already connected before connecting the
-FT232H board to your computer. You can locate the ports from a MinGW
-terminal or use the Windows Device Manager.</p>
-<p>On a MinGW terminal, the ports are listed in the /dev directory and the
-format of the port name is <code class="docutils literal notranslate"><span class="pre">ttyS<N></span></code> where N is a number. You must map
-the port name to a Windows COM port: <code class="docutils literal notranslate"><span class="pre">/dev/ttyS<N></span></code> maps to
-<code class="docutils literal notranslate"><span class="pre">COM<N+1></span></code>. For example, <code class="docutils literal notranslate"><span class="pre">/dev/ttyS2</span></code> maps to <code class="docutils literal notranslate"><span class="pre">COM3</span></code>.</p>
-<p>Check what USB devices are already connected:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> ls -l /dev/ttyS*
-<span class="go">crw-rw-rw- 1 <user> None 117, 5 May 9 04:24 /dev/ttyS5</span>
-<span class="gp">$</span>
-</pre></div>
-</div>
-<p>/dev/ttyS5 maps to the Windows COM6 port. You can run Windows Device
-Manager to confirm:</p>
-<p><img alt="Device Manager - USB Devices" src="../_images/device_manager_no_ft232H.png" /></p>
-<p>Plug in the FT232H board and check the ports again:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> ls -l /dev/ttyS*
-<span class="go">ls -l /dev/ttyS*</span>
-<span class="go">crw-rw-rw- 1 <user> None 117, 10 May 9 04:55 /dev/ttyS10</span>
-<span class="go">crw-rw-rw- 1 <user> None 117, 5 May 9 04:55 /dev/ttyS5</span>
-<span class="gp">$</span>
-</pre></div>
-</div>
-<p>The FT232H board is connected to port /dev/ttyS10 (or COM11):</p>
-<p><img alt="Device Manager - FT232H" src="../_images/device_manager_ft232H.png" /></p>
-<p>We use the PuTTY terminal application to connect to the board on the
-COM11 port: <img alt="PuTTY" src="../_images/putty.png" /></p>
-<p>Press Open and you should get a terminal screen titled “COM11 - PuTTY”</p>
-<p>If there’s no Mynewt app running, or the Mynewt app doesn’t have the
-Shell and Console enabled, you won’t see anything there, but you can
-always refer back to this page from later tutorials if you need to.</p>
-<p>Now that you know how to communicate with your Mynewt application, let’s
-move on to creating one!</p>
-</div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="../concepts.html" class="btn btn-neutral float-right" title="Concepts" accesskey="n">Next: Concepts <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="project_create.html" class="btn btn-neutral" title="Creating Your First Mynewt Project" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Creating Your First Mynewt Project</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../_static/js/affix.js"></script>
- <script type="text/javascript" src="../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/index.html b/develop/index.html
deleted file mode 100644
index 6c3f471a8..000000000
--- a/develop/index.html
+++ /dev/null
@@ -1,392 +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">
-
-
-
-
- <title>Mynewt Documentation — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="genindex.html"/>
- <link rel="search" title="Search" href="search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="#"/>
- <link rel="next" title="Setup & Get Started" href="get_started/index.html"/>
-
-
- <script src="_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- Mynewt Documentation
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/index.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="introduction">
-<h1>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-</div>
-<div class="section" id="welcome-to-apache-mynewt">
-<h2>Welcome to Apache Mynewt<a class="headerlink" href="#welcome-to-apache-mynewt" title="Permalink to this headline">¶</a></h2>
-<p>Apache Mynewt is an operating system that makes it easy to develop
-applications for microcontroller environments where power and cost are
-driving factors. Examples of these devices are connected locks, lights,
-and wearables.</p>
-<p>Microcontroller environments have a number of characteristics that makes
-the operating system requirements for them unique:</p>
-<ul class="simple">
-<li>Low memory footprint: memory on these systems range from 8-16KB (on
-the low end) to 16MB (on the high end).</li>
-<li>Reduced code size: code often runs out of flash, and total available
-code size ranges from 64-128KB to 16-32MB.</li>
-<li>Low processing speed: processor speeds vary from 10-12MHz to
-160-200MHz.</li>
-<li>Low power operation: devices operate in mostly sleeping mode, in
-order to conserve battery power and maximize power usage.</li>
-</ul>
-<p>As more and more devices get connected, these interconnected devices
-perform complex tasks. To perform these tasks, you need low-level
-operational functionality built into the operating system. Typically,
-connected devices built with these microcontrollers perform a myriad of
-functions:</p>
-<ul class="simple">
-<li>Networking Stacks: Bluetooth Low Energy and Thread</li>
-<li>Peripherals: PWM to drive motors, ADCs to measure sensor data, and
-RTCs to keep time.</li>
-<li>Scheduled Processing: actions must happen on a calendared or periodic
-basis.</li>
-</ul>
-<p>Apache Mynewt accomplishes all the above easily, by providing a complete
-operating system for constrained devices, including:</p>
-<ul class="simple">
-<li>A fully open-source Bluetooth Low Energy stack with both Host and
-Controller implementations.</li>
-<li>A pre-emptive, multi-tasking Real Time operating system kernel</li>
-<li>A Hardware Abstraction Layer (HAL) that abstracts the MCU’s
-peripheral functions, allowing developers to easily write
-cross-platform code.</li>
-</ul>
-</div>
-<div class="section" id="newt">
-<h2>Newt<a class="headerlink" href="#newt" title="Permalink to this headline">¶</a></h2>
-<p>In order to provide all this functionality, and operate in an extremely
-low resource environment, Mynewt provides a very fine-grained source
-package management and build system tool, called <em>newt</em>.</p>
-<p>You can install <em>newt</em> for <a class="reference internal" href="newt/install/newt_mac.html"><span class="doc">Mac OS</span></a>,
-<a class="reference internal" href="newt/install/newt_linux.html"><span class="doc">Linux</span></a>, or
-<a class="reference internal" href="newt/install/newt_windows.html"><span class="doc">Windows</span></a>.</p>
-</div>
-<div class="section" id="newt-manager">
-<h2>Newt Manager<a class="headerlink" href="#newt-manager" title="Permalink to this headline">¶</a></h2>
-<p>In order to enable a user to communicate with remote instances of Mynewt
-OS and query, configure, and operate them, Mynewt provides an
-application tool called Newt Manager or <em>newtmgr</em>.</p>
-<p>You can install <em>newtmgr</em> for <a class="reference internal" href="newtmgr/install/install_mac.html"><span class="doc">Mac OS</span></a>,
-<a class="reference internal" href="newtmgr/install/install_linux.html"><span class="doc">Linux</span></a>, or
-<a class="reference internal" href="newtmgr/install/install_windows.html"><span class="doc">Windows</span></a>.</p>
-</div>
-<div class="section" id="build-your-first-mynewt-app-with-newt">
-<h2>Build your first Mynewt App with Newt<a class="headerlink" href="#build-your-first-mynewt-app-with-newt" title="Permalink to this headline">¶</a></h2>
-<p>With the introductions out of the way, now is a good time to <a class="reference internal" href="get_started/index.html"><span class="doc">get set up
-and started</span></a> with your first Mynewt
-application.</p>
-<p>Happy Hacking!</p>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="get_started/index.html" class="btn btn-neutral float-right" title="Setup & Get Started" accesskey="n">Next: Setup & Get Started <span class="fa fa-arrow-circle-right"></span></a>
-
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'./',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="_static/js/affix.js"></script>
- <script type="text/javascript" src="_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/misc/faq.html b/develop/misc/faq.html
deleted file mode 100644
index b01af9410..000000000
--- a/develop/misc/faq.html
+++ /dev/null
@@ -1,437 +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">
-
-
-
-
- <title>FAQ - Administrative — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../genindex.html"/>
- <link rel="search" title="Search" href="../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../index.html"/>
- <link rel="up" title="Appendix" href="index.html"/>
- <link rel="prev" title="Developing Mynewt Applications with Visual Studio Code" href="ide.html"/>
-
-
- <script src="../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="index.html">Appendix</a> /
-
- FAQ - Administrative
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/misc/faq.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="index.html">Appendix</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="go_env.html">Contributing to Newt or Newtmgr Tools</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ide.html">Developing Mynewt Applications with Visual Studio Code</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">FAQ - Administrative</a></li>
-</ul>
-</li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="faq-administrative">
-<h1>FAQ - Administrative<a class="headerlink" href="#faq-administrative" title="Permalink to this headline">¶</a></h1>
-<p>Here is a list of frequently asked questions about the project and administrative processes.</p>
-<div class="section" id="administrative-questions">
-<h2>Administrative questions:<a class="headerlink" href="#administrative-questions" title="Permalink to this headline">¶</a></h2>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#how-do-i-submit-a-bug" id="id1">How do I submit a bug?</a></li>
-<li><a class="reference internal" href="#how-do-i-request-a-feature" id="id2">How do I request a feature?</a></li>
-<li><a class="reference internal" href="#i-am-not-on-the-committer-list-how-do-i-submit-a-patch" id="id3">I am not on the committer list. How do I submit a patch?</a></li>
-<li><a class="reference internal" href="#i-am-a-committer-in-the-project-can-i-merge-my-own-pull-request-into-the-git-repository" id="id4">I am a committer in the project. Can I merge my own Pull Request into the git repository?</a></li>
-<li><a class="reference internal" href="#i-would-like-to-make-some-edits-to-the-documentation-what-do-i-do" id="id5">I would like to make some edits to the documentation. What do I do?</a></li>
-<li><a class="reference internal" href="#i-would-like-to-make-some-edits-to-the-documentation-but-want-to-use-an-editor-on-my-own-laptop-what-do-i-do" id="id6">I would like to make some edits to the documentation but want to use an editor on my own laptop. What do I do?</a></li>
-</ul>
-</div>
-<div class="section" id="how-do-i-submit-a-bug">
-<h3><a class="toc-backref" href="#id1">How do I submit a bug?</a><a class="headerlink" href="#how-do-i-submit-a-bug" title="Permalink to this headline">¶</a></h3>
-<p>If you do not have a JIRA account sign up
-for an account on
-<a class="reference external" href="https://issues.apache.org/jira/secure/Signup!default.jspa">JIRA</a>.</p>
-<p>Submit a request to the @dev mailing list for your JIRA username to be
-added to the Apache Mynewt (MYNEWT) project. You can view the issues on
-JIRA for the MYNEWT project without an account but you need to log in
-for reporting a bug.</p>
-<p>Log in. Choose the “MYNEWT” project. Click on the “Create” button to
-create a ticket. Choose “Bug” as the Issue Type. Fill in the bug
-description, how it is triggered, and other details.</p>
-</div>
-<div class="section" id="how-do-i-request-a-feature">
-<h3><a class="toc-backref" href="#id2">How do I request a feature?</a><a class="headerlink" href="#how-do-i-request-a-feature" title="Permalink to this headline">¶</a></h3>
-<p>If you do not have a JIRA account sign up for an account on
-<a class="reference external" href="https://issues.apache.org/jira/secure/Signup!default.jspa">JIRA</a>.</p>
-<p>Submit a request to the @dev mailing list for your JIRA username to be
-added to the Apache Mynewt (MYNEWT) project. You can view the issues on
-JIRA for the MYNEWT project without an account but you need to log in
-for reporting a bug.</p>
-<p>Log in. Choose the “MYNEWT” project. Click on the “Create” button to
-create a ticket. Choose “Wish” as the Issue Type. Fill in the feature
-description, benefits, and any other implementation details. Note in the
-description whether you want to work on it yourself.</p>
-<p>If you are not a committer and you wish to work on it, someone who is on
-the committer list will have to review your request and assign it to
-you. You will have to refer to this JIRA ticket in your pull request.</p>
-</div>
-<div class="section" id="i-am-not-on-the-committer-list-how-do-i-submit-a-patch">
-<h3><a class="toc-backref" href="#id3">I am not on the committer list. How do I submit a patch?</a><a class="headerlink" href="#i-am-not-on-the-committer-list-how-do-i-submit-a-patch" title="Permalink to this headline">¶</a></h3>
-<p><strong>You submit your proposed changes for your peers with committer status
-to review and merge.</strong></p>
-<p>The process to submit a Pull Request on github.com is described on the
-<a class="reference external" href="https://cwiki.apache.org/confluence/display/MYNEWT/Submitting+Pull+Requests">Confluence page for the
-project</a>.</p>
-</div>
-<div class="section" id="i-am-a-committer-in-the-project-can-i-merge-my-own-pull-request-into-the-git-repository">
-<h3><a class="toc-backref" href="#id4">I am a committer in the project. Can I merge my own Pull Request into the git repository?</a><a class="headerlink" href="#i-am-a-committer-in-the-project-can-i-merge-my-own-pull-request-into-the-git-repository" title="Permalink to this headline">¶</a></h3>
-<p>Yes, but only if your Pull Request has been reviewed and approved by
-another committer in Apache Mynewt. The process to merge a Pull Request
-is described on the <a class="reference external" href="https://cwiki.apache.org/confluence/display/MYNEWT/Merging+Pull+Requests">Confluence page for the
-project</a>.</p>
-</div>
-<div class="section" id="i-would-like-to-make-some-edits-to-the-documentation-what-do-i-do">
-<h3><a class="toc-backref" href="#id5">I would like to make some edits to the documentation. What do I do?</a><a class="headerlink" href="#i-would-like-to-make-some-edits-to-the-documentation-what-do-i-do" title="Permalink to this headline">¶</a></h3>
-<p>You submit your proposed changes for your peers with committer status
-to review and merge.</p>
-<p>Each Mynewt repository has its own set of related documentation in the docs/ folder. The
-overall project documentation is in <a class="reference external" href="https://github.com/apache/mynewt-documentation">mynewt-documentation</a>
-on github.com.</p>
-<p>Navigate to the file you wish to edit on github.com. All the technical
-documentation is in reStructuredText files under the <code class="docutils literal notranslate"><span class="pre">/docs</span></code> directory. Click
-on the pencil icon (“Edit the file in your fork of this project”) and
-start making changes.</p>
-<p>Click the green “Propose file change” button. You will be directed to
-the page where you can start a pull request from the branch that was
-created for you. The branch is gets an automatic name <code class="docutils literal notranslate"><span class="pre">patch-#</span></code> where
-# is a number. Click on the green “Compare & pull request” to open the
-pull request.</p>
-<p>In the comment for the pull request, include a description of the
-changes you have made and why. Github will automatically notify everyone
-on the <a class="reference external" href="mailto:commits%40mynewt.apache.org">commits<span>@</span>mynewt<span>.</span>apache<span>.</span>org</a> mailing list about the newly opened
-pull requests. You can open a pull request even if you don’t think the
-code is ready for merging but want some discussion on the matter.</p>
-<p>Upon receiving notification, one or more committers will review your
-work, ask for edits or clarifications, and merge when your proposed
-changes are ready.</p>
-<p>If you want to withdraw the pull request simply go to your fork
-<code class="docutils literal notranslate"><span class="pre">https://github.com/<your</span> <span class="pre">github</span> <span class="pre">username>/mynewt-documentation</span></code> and click on
-“branches”. You should see your branch under “Your branches”. Click on
-the delete icon.</p>
-</div>
-<div class="section" id="i-would-like-to-make-some-edits-to-the-documentation-but-want-to-use-an-editor-on-my-own-laptop-what-do-i-do">
-<h3><a class="toc-backref" href="#id6">I would like to make some edits to the documentation but want to use an editor on my own laptop. What do I do?</a><a class="headerlink" href="#i-would-like-to-make-some-edits-to-the-documentation-but-want-to-use-an-editor-on-my-own-laptop-what-do-i-do" title="Permalink to this headline">¶</a></h3>
-<p>You submit your proposed changes for your peers with committer status
-to review and merge.</p>
-<p>Go to the <a class="reference external" href="https://github.com/apache/mynewt-documentation">documentation
-mirror</a> on github.com. You
-need to create your own fork of the repo in github.com by clicking on
-the “Fork” button on the top right. Clone the forked repository into
-your laptop (using <code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">clone</span></code> from a terminal or using the download
-buttons on the github page)and create a local branch for the edits and
-switching to it (using <code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">checkout</span> <span class="pre">-b</span> <span class="pre"><new-branchname></span></code> or GitHub
-Desktop).</p>
-<p>Make your changes using the editor of your choice. Push that branch to
-your fork on github. Then submit a pull request from that branch on your
-github fork.</p>
-<p>The review and merge process is the same as other pull requests
-described for earlier questions.</p>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
-
- <a href="ide.html" class="btn btn-neutral" title="Developing Mynewt Applications with Visual Studio Code" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Developing Mynewt Applications with Visual Studio Code</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../_static/js/affix.js"></script>
- <script type="text/javascript" src="../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/misc/go_env.html b/develop/misc/go_env.html
deleted file mode 100644
index 38e973a40..000000000
--- a/develop/misc/go_env.html
+++ /dev/null
@@ -1,550 +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">
-
-
-
-
- <title>Contributing to Newt or Newtmgr Tools — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../genindex.html"/>
- <link rel="search" title="Search" href="../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../index.html"/>
- <link rel="up" title="Appendix" href="index.html"/>
- <link rel="next" title="Developing Mynewt Applications with Visual Studio Code" href="ide.html"/>
- <link rel="prev" title="Appendix" href="index.html"/>
-
-
- <script src="../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="index.html">Appendix</a> /
-
- Contributing to Newt or Newtmgr Tools
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/misc/go_env.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="index.html">Appendix</a><ul class="current">
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Contributing to Newt or Newtmgr Tools</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ide.html">Developing Mynewt Applications with Visual Studio Code</a></li>
-<li class="toctree-l2"><a class="reference internal" href="faq.html">FAQ - Administrative</a></li>
-</ul>
-</li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="contributing-to-newt-or-newtmgr-tools">
-<h1>Contributing to Newt or Newtmgr Tools<a class="headerlink" href="#contributing-to-newt-or-newtmgr-tools" title="Permalink to this headline">¶</a></h1>
-<p>Newt and Newtmgr are written in Go (golang). This guide shows you how to
-install Go and setup your environment to update and build the tools if
-you want to:</p>
-<ul class="simple">
-<li>Build the tools with latest updates from the master branch on Linux
-or Windows platforms.
-<strong>Note:</strong> For Mac OS, you can use the
-<code class="docutils literal notranslate"><span class="pre">brew</span> <span class="pre">install</span> <span class="pre">mynewt-newt</span> <span class="pre">-HEAD</span></code> and the
-<code class="docutils literal notranslate"><span class="pre">brew</span> <span class="pre">install</span> <span class="pre">mynewt-newtmgr</span> <span class="pre">--HEAD</span></code> commands.</li>
-<li>Contribute to newt or newtmgr features or fix bugs.</li>
-</ul>
-<p>This guide shows you how to perform the following:</p>
-<ol class="arabic simple">
-<li>Install Mac OS X, Linux, Windows. (Tasks that are specific to each
-platform are called out.)</li>
-<li>Setup the Go environment.</li>
-<li>Download the source, build, and install the newt or newtmgr tools.</li>
-<li>Update and rebuild the tools.</li>
-</ol>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#step-1-installing-go" id="id1">Step 1: Installing Go</a><ul>
-<li><a class="reference internal" href="#installing-go-on-mac-os-x" id="id2">Installing Go on Mac OS X</a></li>
-<li><a class="reference internal" href="#installing-go-on-linux-and-windows" id="id3">Installing Go on Linux and Windows</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#step-2-setting-up-your-go-environment" id="id4">Step 2: Setting Up Your Go Environment</a></li>
-<li><a class="reference internal" href="#step-3-downloading-the-source-and-installing-the-tools" id="id5">Step 3: Downloading the Source and Installing the Tools</a><ul>
-<li><a class="reference internal" href="#downloading-and-installing-the-newt-tool" id="id6">Downloading and Installing the Newt Tool</a></li>
-<li><a class="reference internal" href="#downloading-and-installing-the-newtmgr-tool" id="id7">Downloading and Installing the Newtmgr Tool</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#step-4-updating-and-rebuilding-the-tools" id="id8">Step 4: Updating and Rebuilding the Tools:</a></li>
-</ul>
-</div>
-<p><strong>Note:</strong> You will also need to read and follow the instructions from
-the <a class="reference internal" href="faq.html"><span class="doc">FAQ - Administrative</span></a> to set up your git repos to submit changes.</p>
-<div class="section" id="step-1-installing-go">
-<h2><a class="toc-backref" href="#id1">Step 1: Installing Go</a><a class="headerlink" href="#step-1-installing-go" title="Permalink to this headline">¶</a></h2>
-<p>The latest master branch of newt and newtmgr requires GO version 1.7.6
-or higher. You can skip this step and proceed to Step 2 if you already
-have Go version 1.7.6 or higher installed.</p>
-<div class="section" id="installing-go-on-mac-os-x">
-<h3><a class="toc-backref" href="#id2">Installing Go on Mac OS X</a><a class="headerlink" href="#installing-go-on-mac-os-x" title="Permalink to this headline">¶</a></h3>
-<p>If you do not have Homebrew installed, run the following command. You
-will be prompted for your sudo password.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> ruby -e <span class="s2">"</span><span class="k">$(</span>curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install<span class="k">)</span><span class="s2">"</span>
-</pre></div>
-</div>
-<p>You can also extract (or <code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">clone</span></code>) Homebrew and install it to
-/usr/local.</p>
-<p>Use brew to install Go:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> brew install go
-<span class="go">==></span>
-<span class="go">...</span>
-<span class="go">...</span>
-<span class="go">==> Summary</span>
-<span class="go">🍺 /usr/local/Cellar/go/1.8.3: 7,035 files, 282.0MB</span>
-</pre></div>
-</div>
-<p>You can also download the Go package directly from
-(<a class="reference external" href="https://golang.org/dl/">https://golang.org/dl/</a>) and install it in /usr/local/bin instead of
-brewing it.</p>
-</div>
-<div class="section" id="installing-go-on-linux-and-windows">
-<h3><a class="toc-backref" href="#id3">Installing Go on Linux and Windows</a><a class="headerlink" href="#installing-go-on-linux-and-windows" title="Permalink to this headline">¶</a></h3>
-<p>You can download Go from
-<a class="reference external" href="https://golang.org/dl/">https://golang.org/dl/</a>.</p>
-</div>
-</div>
-<div class="section" id="step-2-setting-up-your-go-environment">
-<h2><a class="toc-backref" href="#id4">Step 2: Setting Up Your Go Environment</a><a class="headerlink" href="#step-2-setting-up-your-go-environment" title="Permalink to this headline">¶</a></h2>
-<p>This section describes the Go environment and how to setup a Go
-workspace. If you already have a Go workspace for your other Go
-projects, you can skip this step and proceed to Step 3.</p>
-<p>Go provides an environment to compile Go code, construct Go packages,
-and import Go code. You will use Go commands to import the newt or
-newtmgr package repository into your local Go environment. The Go
-language environment dictates a specific directory structure, or
-workspace in Go parlance. It must contain three sibling directories with
-the names <strong>src</strong>, <strong>pkg</strong> and <strong>bin</strong>:</p>
-<ul class="simple">
-<li>src contains Go source files organized into packages (one package per
-directory)</li>
-<li>pkg contains package objects</li>
-<li>bin contains the Go application executables that Go builds and
-installs.</li>
-</ul>
-<p>The <strong>GOPATH</strong> environment variable specifies the location of your
-workspace. To setup this workspace environment, create a <strong>dev</strong>
-directory and then a <strong>go</strong> directory under it. Set the GOPATH
-environment variable to this directory where you will clone the newt and
-newtmgr repositories.</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> <span class="nb">cd</span> <span class="nv">$HOME</span>
-<span class="gp">$</span> mkdir -p dev/go
-<span class="gp">$</span> <span class="nb">cd</span> dev/go
-<span class="gp">$</span> <span class="nb">export</span> <span class="nv">GOPATH</span><span class="o">=</span><span class="sb">`</span><span class="nb">pwd</span><span class="sb">`</span>
-</pre></div>
-</div>
-<p>Add the following export statements to your ~/.bash_profile file and
-source the file:</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nb">export</span> <span class="nv">GOPATH</span><span class="o">=</span><span class="nv">$HOME</span>/dev/go
-<span class="nb">export</span> <span class="nv">PATH</span><span class="o">=</span><span class="nv">$GOPATH</span>/bin:<span class="nv">$PATH</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="step-3-downloading-the-source-and-installing-the-tools">
-<h2><a class="toc-backref" href="#id5">Step 3: Downloading the Source and Installing the Tools</a><a class="headerlink" href="#step-3-downloading-the-source-and-installing-the-tools" title="Permalink to this headline">¶</a></h2>
-<p>Newt and newtmgr are individual Go packages and have their own git
-repositories. You can download the source and install one or both tools.</p>
-<p>We use the <code class="docutils literal notranslate"><span class="pre">go</span> <span class="pre">get</span></code> command to download the source, build, and install
-the binary in the <strong>$GOPATH/bin</strong> directory.</p>
-<div class="section" id="downloading-and-installing-the-newt-tool">
-<h3><a class="toc-backref" href="#id6">Downloading and Installing the Newt Tool</a><a class="headerlink" href="#downloading-and-installing-the-newt-tool" title="Permalink to this headline">¶</a></h3>
-<p>The newt Go package is <strong>mynewt.apache.org/newt/newt</strong> and is stored in
-the <a class="reference external" href="https://github.com/apache/mynewt-newt">Apache Mynewt newt tool repository mirrored on
-github</a>.</p>
-<p>Download the newt package source and install the tool:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> <span class="nb">cd</span> <span class="nv">$GOPATH</span>
-<span class="gp">$</span> go get mynewt.apache.org/newt/newt
-<span class="gp">$</span> <span class="nb">cd</span> <span class="nv">$GOPATH</span>/src/mynewt.apache.org/newt
-<span class="gp">$</span> ls
-<span class="go">DISCLAIMER RELEASE_NOTES.md util</span>
-<span class="go">INSTALLING.md build.sh viper</span>
-<span class="go">LICENSE newt yaml</span>
-<span class="go">NOTICE newtmgr</span>
-<span class="go">README.md newtvm</span>
-<span class="gp">$</span> git status
-<span class="go">On branch master</span>
-<span class="go">Your branch is up-to-date with 'origin/master'.</span>
-<span class="go">nothing to commit, working directory clean</span>
-</pre></div>
-</div>
-<p><strong>Note:</strong> The source code under the <strong>newtmgr</strong> directory is no longer
-used or updated. The current <strong>newtmgr</strong> source has its own Git
-repository.</p>
-<p>Check that the newt binary is installed and you are using the one from
-<strong>$GOPATH/bin</strong>:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> ls <span class="nv">$GOPATH</span>/bin/newt
-<span class="go">~/dev/go/bin/newt</span>
-<span class="gp">$</span> which newt
-<span class="go">~/dev/go/bin/newt</span>
-<span class="gp">$</span> newt version
-<span class="go">Apache Newt version: 1.1.0-dev</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="downloading-and-installing-the-newtmgr-tool">
-<h3><a class="toc-backref" href="#id7">Downloading and Installing the Newtmgr Tool</a><a class="headerlink" href="#downloading-and-installing-the-newtmgr-tool" title="Permalink to this headline">¶</a></h3>
-<p>The newtmgr Go package is <strong>mynewt.apache.org/newtmgr/newtmgr</strong>. It is
-stored in the <a class="reference external" href="https://github.com/apache/mynewt-newtmgr">Apache Mynewt newtmgr tool repository mirrored on
-github</a>.</p>
-<p>Download the newtmgr package and install the tool:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> <span class="nb">cd</span> <span class="nv">$GOPATH</span>
-<span class="gp">$</span> go get mynewt.apache.org/newtmgr/newtmgr
-<span class="gp">$</span> <span class="nb">cd</span> <span class="nv">$GOPATH</span>/src/mynewt.apache.org/newtmgr
-<span class="gp">$</span> ls
-<span class="go">LICENSE NOTICE README.md newtmgr nmxact</span>
-<span class="gp">$</span> git status
-<span class="go">On branch master</span>
-<span class="go">Your branch is up-to-date with 'origin/master'.</span>
-<span class="go">nothing to commit, working directory clean</span>
-</pre></div>
-</div>
-<p>Check that the newtmgr binary is installed and you are using the one
-from <strong>$GOPATH/bin</strong>:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> ls <span class="nv">$GOPATH</span>/bin/newtmgr
-<span class="go">~/dev/go/bin/newtmgr</span>
-<span class="gp">$</span> which newtmgr
-<span class="go">~/dev/go/bin/newtmgr</span>
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="step-4-updating-and-rebuilding-the-tools">
-<h2><a class="toc-backref" href="#id8">Step 4: Updating and Rebuilding the Tools:</a><a class="headerlink" href="#step-4-updating-and-rebuilding-the-tools" title="Permalink to this headline">¶</a></h2>
-<p>This section shows you
-how to rebuild the newt and newtmgr tools with the latest updates from
-the master branch or after you have made changes in your branch.</p>
-<p>Here is the general procedure to rebuild either the newt or newtmgr
-tool. The only difference is the directory where you will be executing
-the commands from. You will need to repeat the procedure to rebuild both
-tools.</p>
-<ol class="arabic simple">
-<li>Change to the directory where the local Git repository for the tool
-is installed.</li>
-<li>Pull the latest changes from the master branch. If you made changes
-you will need to rebase with <strong>origin master</strong> (See
-<a class="reference internal" href="faq.html"><span class="doc">FAQ - Administrative</span></a>).</li>
-<li>Build and install the tool.</li>
-</ol>
-<p>Change to the directory where the source for the tool is installed.</p>
-<p>For the <strong>newt</strong> tool:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> <span class="nb">cd</span> <span class="nv">$GOPATH</span>/src/mynewt.apache.org/newt/newt
-</pre></div>
-</div>
-<p>For the <strong>newtmgr</strong> tool:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> <span class="nb">cd</span> <span class="nv">$GOPATH</span>/src/mynewt.apache.org/newtmgr/newtmgr
-</pre></div>
-</div>
-<p>After you change to the specific tool directory, get the latest updates
-from the master branch. If you made changes and need to rebase with the
-origin, add the <code class="docutils literal notranslate"><span class="pre">--rebase</span> <span class="pre">origin</span> <span class="pre">master</span></code> arguments to the <code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">pull</span></code>
-command:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> git pull
-</pre></div>
-</div>
-<p>Build and install the tool. The updated binary will be installed in the
-<strong>$GOPATH/bin</strong> directory:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> go install
-</pre></div>
-</div>
-<p>You can run the <code class="docutils literal notranslate"><span class="pre">ls</span> <span class="pre">-l</span></code> command to check the modification time for the
-binary to ensure the new version is installed.</p>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ide.html" class="btn btn-neutral float-right" title="Developing Mynewt Applications with Visual Studio Code" accesskey="n">Next: Developing Mynewt Applications with Visual Studio Code <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="index.html" class="btn btn-neutral" title="Appendix" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Appendix</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../_static/js/affix.js"></script>
- <script type="text/javascript" src="../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/misc/ide.html b/develop/misc/ide.html
deleted file mode 100644
index fd12f393c..000000000
--- a/develop/misc/ide.html
+++ /dev/null
@@ -1,671 +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">
-
-
-
-
- <title>Developing Mynewt Applications with Visual Studio Code — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../genindex.html"/>
- <link rel="search" title="Search" href="../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../index.html"/>
- <link rel="up" title="Appendix" href="index.html"/>
- <link rel="next" title="FAQ - Administrative" href="faq.html"/>
- <link rel="prev" title="Contributing to Newt or Newtmgr Tools" href="go_env.html"/>
-
-
- <script src="../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="index.html">Appendix</a> /
-
- Developing Mynewt Applications with Visual Studio Code
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/misc/ide.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="index.html">Appendix</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="go_env.html">Contributing to Newt or Newtmgr Tools</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Developing Mynewt Applications with Visual Studio Code</a></li>
-<li class="toctree-l2"><a class="reference internal" href="faq.html">FAQ - Administrative</a></li>
-</ul>
-</li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="developing-mynewt-applications-with-visual-studio-code">
-<h1>Developing Mynewt Applications with Visual Studio Code<a class="headerlink" href="#developing-mynewt-applications-with-visual-studio-code" title="Permalink to this headline">¶</a></h1>
-<p>This guide shows you how to set up Visual Studio Code to develop and
-debug Mynewt applications. Visual Studio Code is supported on Mac OS,
-Linux, and Windows. This guide shows you how to:</p>
-<ol class="arabic simple">
-<li>Install Visual Studio Code.</li>
-<li>Install the C/C++ and debugger extensions.</li>
-<li>Define task configurations to build Mynewt applications.</li>
-<li>Define debugger configurations to debug Mynewt applications.</li>
-<li>Launch the debugger.</li>
-</ol>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#installing-visual-studio-code" id="id1">Installing Visual Studio Code</a></li>
-<li><a class="reference internal" href="#installing-the-c-c-and-debugger-extensions" id="id2">Installing the C/C++ and Debugger Extensions</a></li>
-<li><a class="reference internal" href="#defining-tasks-for-mynewt-projects" id="id3">Defining Tasks for Mynewt Projects</a><ul>
-<li><a class="reference internal" href="#associating-a-mynewt-project-to-a-workspace" id="id4">Associating a Mynewt Project to a Workspace</a></li>
-<li><a class="reference internal" href="#defining-visual-studio-code-tasks-to-build-and-debug-mynewt-applications" id="id5">Defining Visual Studio Code Tasks to Build and Debug Mynewt Applications</a></li>
-<li><a class="reference internal" href="#running-a-task" id="id6">Running a Task</a></li>
-<li><a class="reference internal" href="#defining-tasks-for-other-newt-commands" id="id7">Defining Tasks for Other Newt Commands</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#defining-debugger-configurations" id="id8">Defining Debugger Configurations</a></li>
-<li><a class="reference internal" href="#debugging-your-application" id="id9">Debugging Your Application</a></li>
-<li><a class="reference internal" href="#working-with-multiple-mynewt-applications" id="id10">Working with Multiple Mynewt Applications</a></li>
-</ul>
-</div>
-<p>Prerequisites:</p>
-<ul class="simple">
-<li>Have Internet connectivity to fetch remote Mynewt components.</li>
-<li>Have a computer to build a Mynewt application.</li>
-<li>Perform <a class="reference internal" href="../get_started/native_install/index.html"><span class="doc">native installation</span></a> for the
-Mynewt tools and toolchains.
-<strong>Note:</strong> For Windows platforms, ensure that the MinGW bash you
-install is added to your Windows Path. In addition, if you are using
-Windows 10 WSL, you must have the MinGW bash before the Windows 10
-WSL bash in your Windows Path.</li>
-<li>Read the Mynewt OS Concepts section.</li>
-<li>Create a project space (directory structure) and populate it with the
-core code repository (apache-mynewt-core) or know how to as explained
-in Creating Your First Project.</li>
-<li>Complete one of the <a class="reference internal" href="../tutorials/blinky/blinky.html#blinky-tutorials"><span class="std std-ref">Blinky Tutorials</span></a>.</li>
-</ul>
-<p><strong>Notes:</strong></p>
-<ul class="simple">
-<li>This guide is not a tutorial for Visual Studio Code. It assumes you
-are familiar with Visual Studio Code. If this is your first time
-using Visual Studio Code, we recommend that you read the Visual
-Studio Code <a class="reference external" href="https://code.visualstudio.com/docs">documentation and
-tutorials</a> and evaluate
-whether you would like to use it to develop Mynewt applications.</li>
-<li>This guide uses Visual Studio Code on Windows. Visual Studio Code is
-supported on Linux and Mac OS but may have some variations in the
-keyboard shortcuts and command names for these platforms.</li>
-<li>You can also use the Eclipse IDE to develop Mynewt applications. See
-<a class="reference external" href="https://www.codecoup.pl/blog/hacking-mynewt-in-eclipse">hacking-mynewt-in-eclipse</a> for more
-details. On Windows platforms, you must also ensure the MinGW bash is
-set in your Windows Path as described in the prerequisites.</li>
-</ul>
-<div class="section" id="installing-visual-studio-code">
-<h2><a class="toc-backref" href="#id1">Installing Visual Studio Code</a><a class="headerlink" href="#installing-visual-studio-code" title="Permalink to this headline">¶</a></h2>
-<p>Download and install Visual Studio Code from <a class="reference external" href="https://code.visualstudio.com/">https://code.visualstudio.com/</a>.</p>
-</div>
-<div class="section" id="installing-the-c-c-and-debugger-extensions">
-<h2><a class="toc-backref" href="#id2">Installing the C/C++ and Debugger Extensions</a><a class="headerlink" href="#installing-the-c-c-and-debugger-extensions" title="Permalink to this headline">¶</a></h2>
-<p>You need to install two extensions:</p>
-<ol class="arabic simple">
-<li>The C/C++ extension from Microsoft. This extension provides language
-support such as symbol searching, signatuare help, go to definition,
-and go to declaration.</li>
-<li>The Native Debug extension from webfreak. This extension provides GDB
-support.</li>
-</ol>
-<p>To install the C/C++ extension:</p>
-<ol class="arabic simple">
-<li>Press <code class="docutils literal notranslate"><span class="pre">Ctrl-P</span></code> to open the search box.</li>
-<li>Type <code class="docutils literal notranslate"><span class="pre">ext</span> <span class="pre">install</span> <span class="pre">cpptools</span></code> in the search box and press Enter. You
-should see the extension at the top of the list.</li>
-<li>Click <code class="docutils literal notranslate"><span class="pre">Install</span></code> to install the extension.</li>
-</ol>
-<p>To install the Native Debugger:</p>
-<ol class="arabic simple">
-<li>Press <code class="docutils literal notranslate"><span class="pre">Ctrl-P</span></code> to open the search box.</li>
-<li>Type <code class="docutils literal notranslate"><span class="pre">ext</span> <span class="pre">install</span> <span class="pre">webfreak.debug</span></code> in the search box and press
-Enter. You should see the Native Debug extension at the top of the
-list.</li>
-<li>Click <code class="docutils literal notranslate"><span class="pre">Install</span></code> to install the extension.</li>
-</ol>
-</div>
-<div class="section" id="defining-tasks-for-mynewt-projects">
-<h2><a class="toc-backref" href="#id3">Defining Tasks for Mynewt Projects</a><a class="headerlink" href="#defining-tasks-for-mynewt-projects" title="Permalink to this headline">¶</a></h2>
-<p>Two main concepts in Visual Studio Code are workspaces and tasks. A
-workspace represents a folder that is open. You can open multiple
-workspaces and switch between workspaces.</p>
-<p>Tasks allow you to integrate the external tools and operations that are
-used to build or test your project into Visual Studio Code. Tasks are
-run from and the task results can be analyzed in Visual Studio Code.
-Tasks are defined within the scope of a workspace. This means that the
-tasks you define for a workspace only apply to the given workspace.</p>
-<div class="section" id="associating-a-mynewt-project-to-a-workspace">
-<h3><a class="toc-backref" href="#id4">Associating a Mynewt Project to a Workspace</a><a class="headerlink" href="#associating-a-mynewt-project-to-a-workspace" title="Permalink to this headline">¶</a></h3>
-<p>For your Mynewt
-project, your Visual Studio Code workspace is the Mynewt project base
-directory. For example, if you create a project named <code class="docutils literal notranslate"><span class="pre">myproj</span></code> under
-the <code class="docutils literal notranslate"><span class="pre">~/dev</span></code> directory, then you open the <code class="docutils literal notranslate"><span class="pre">~/dev/myproj</span></code> folder for
-your workspace.</p>
-<p>Select <strong>File</strong> > <strong>Open Folder</strong>, and select the <code class="docutils literal notranslate"><span class="pre">myproj</span></code> folder from
-the <code class="docutils literal notranslate"><span class="pre">Select</span> <span class="pre">Folder</span></code> dialog box to open the folder.</p>
-</div>
-<div class="section" id="defining-visual-studio-code-tasks-to-build-and-debug-mynewt-applications">
-<h3><a class="toc-backref" href="#id5">Defining Visual Studio Code Tasks to Build and Debug Mynewt Applications</a><a class="headerlink" href="#defining-visual-studio-code-tasks-to-build-and-debug-mynewt-applications" title="Permalink to this headline">¶</a></h3>
-<p>You define Visual Studio Code tasks to build and debug your Mynewt
-targets in Visual Studio Code. We use the Blinky application for the
-Arduino Zero board from the <a class="reference internal" href="../tutorials/blinky/arduino_zero.html"><span class="doc">Blinky On Arduino Zero
-Tutorial</span></a> to illustrate how to define
-the tasks to build and debug the Arduino blinky bootloader and
-application targets.</p>
-<p>Perform the following steps to create the tasks to build and debug the
-Arduino blinky bootloader and appliction targets:</p>
-<p>Step 1: Press <code class="docutils literal notranslate"><span class="pre">Ctrl-Shift-P</span></code>, type <code class="docutils literal notranslate"><span class="pre">task</span></code>, and select
-<strong>Tasks:Configure Task Runner</strong> from the search results.</p>
-<p>Step 2: Select <strong>Others</strong> (scroll down to the bottom of the list) to
-create a task runner for external commands.</p>
-<div class="figure">
-<img alt="../_images/task_runner_small.png" src="../_images/task_runner_small.png" />
-</div>
-<p>Tasks are defined in the <code class="docutils literal notranslate"><span class="pre">tasks.json</span></code> file. You should see the
-<code class="docutils literal notranslate"><span class="pre">.vscode</span></code> folder created in the <code class="docutils literal notranslate"><span class="pre">MYPROJ</span></code> folder and a <code class="docutils literal notranslate"><span class="pre">tasks.json</span></code>
-file created in the <code class="docutils literal notranslate"><span class="pre">.vscode</span></code> folder. The <code class="docutils literal notranslate"><span class="pre">tasks.json</span></code> file has the
-following default values.</p>
-<div class="figure">
-<img alt="../_images/task_json_small.png" src="../_images/task_json_small.png" />
-</div>
-<p>The sample <code class="docutils literal notranslate"><span class="pre">tasks.json</span></code> file defines a simple task that runs the echo
-command with “Hello World” as the argument.</p>
-<p>Step 3: Delete the content from the <code class="docutils literal notranslate"><span class="pre">tasks.json</span></code> file, add the
-following definitions, and press <code class="docutils literal notranslate"><span class="pre">Ctrl-S</span></code> to save the file.</p>
-<div class="highlight-JSON notranslate"><div class="highlight"><pre><span></span><span class="p">{</span>
- <span class="nt">"version"</span><span class="p">:</span> <span class="s2">"0.1.0"</span><span class="p">,</span>
- <span class="nt">"command"</span><span class="p">:</span> <span class="s2">"newt"</span><span class="p">,</span>
- <span class="nt">"echoCommand"</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span>
- <span class="nt">"isShellCommand"</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span>
-
- <span class="nt">"tasks"</span><span class="p">:[</span>
- <span class="p">{</span>
- <span class="nt">"taskName"</span><span class="p">:</span> <span class="s2">"build_arduino_boot"</span><span class="p">,</span>
- <span class="nt">"args"</span><span class="p">:</span> <span class="p">[</span><span class="s2">"build"</span><span class="p">,</span> <span class="s2">"arduino_boot"</span><span class="p">],</span>
- <span class="nt">"suppressTaskName"</span><span class="p">:</span> <span class="kc">true</span>
- <span class="p">},</span>
- <span class="p">{</span>
- <span class="nt">"taskName"</span><span class="p">:</span> <span class="s2">"build_arduino_blinky"</span><span class="p">,</span>
- <span class="nt">"args"</span><span class="p">:</span> <span class="p">[</span><span class="s2">"build"</span><span class="p">,</span> <span class="s2">"arduino_blinky"</span><span class="p">],</span>
- <span class="nt">"isBuildCommand"</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span>
- <span class="nt">"suppressTaskName"</span><span class="p">:</span> <span class="kc">true</span>
- <span class="p">},</span>
- <span class="p">{</span>
- <span class="nt">"taskName"</span><span class="p">:</span> <span class="s2">"create_arduino_blinky"</span><span class="p">,</span>
- <span class="nt">"args"</span><span class="p">:</span> <span class="p">[</span><span class="s2">"create-image"</span><span class="p">,</span> <span class="s2">"arduino_blinky"</span><span class="p">,</span> <span class="s2">"1.0.0"</span><span class="p">],</span>
- <span class="nt">"suppressTaskName"</span><span class="p">:</span><span class="kc">true</span>
- <span class="p">},</span>
- <span class="p">{</span>
- <span class="nt">"taskName"</span><span class="p">:</span> <span class="s2">"debug_arduino_blinky"</span><span class="p">,</span>
- <span class="nt">"args"</span><span class="p">:</span> <span class="p">[</span><span class="s2">"debug"</span><span class="p">,</span> <span class="s2">"arduino_blinky"</span><span class="p">,</span> <span class="s2">"-n"</span><span class="p">],</span>
- <span class="nt">"suppressTaskName"</span><span class="p">:</span> <span class="kc">true</span>
- <span class="p">}</span>
- <span class="p">]</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-<p>The <code class="docutils literal notranslate"><span class="pre">tasks.json</span></code> file specifies the tasks that are run to build and
-debug the Arduino blinky targets. Each task runs a <code class="docutils literal notranslate"><span class="pre">newt</span></code> command. The
-<code class="docutils literal notranslate"><span class="pre">newt</span></code> command to run and the arguments for the <code class="docutils literal notranslate"><span class="pre">newt</span></code> command are
-passed in the <code class="docutils literal notranslate"><span class="pre">args</span></code> property for each task.</p>
-<p>The following tasks are defined in this example:</p>
-<ol class="arabic">
-<li><p class="first"><strong>build_arduino_boot</strong>: Runs the <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">build</span> <span class="pre">arduino_boot</span></code>
-command to build the arduino_boot target.</p>
-</li>
-<li><p class="first"><strong>build_arduino_blinky</strong>: Runs the <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">build</span> <span class="pre">arduino_blinky</span></code>
-command to build the arduino_blinky target.</p>
-<p><strong>Note:</strong> This task sets the <code class="docutils literal notranslate"><span class="pre">isBuildCommand</span></code> property to <code class="docutils literal notranslate"><span class="pre">true</span></code>.
-This is an optional property that, when set to true, allows you to
-run the <strong>Tasks: Run Build Task</strong>(<code class="docutils literal notranslate"><span class="pre">Ctrl-Shift-B</span></code>) command to
-start the task.</p>
-</li>
-<li><p class="first"><strong>create_arduino_blinky</strong>: Runs the
-<code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">create-image</span> <span class="pre">arduino_blinky</span></code> command to create the image
-file.</p>
-</li>
-<li><p class="first"><strong>debug_arduino_blinky</strong>: Runs the <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">build</span> <span class="pre">arduino_blinky</span> <span class="pre">-n</span></code>
-command to debug the arduino_blinky target. The <code class="docutils literal notranslate"><span class="pre">-n</span></code> flag is
-specified to start only the GDB server and not the GDB client. We
-will launch the GDB client from Visual Studio Code.</p>
-</li>
-</ol>
-<p>For more information on tasks and all supported properties, see the
-<a class="reference external" href="https://code.visualstudio.com/docs/editor/tasks">Visual Studio Code Task
-documentation</a>.</p>
-</div>
-<div class="section" id="running-a-task">
-<h3><a class="toc-backref" href="#id6">Running a Task</a><a class="headerlink" href="#running-a-task" title="Permalink to this headline">¶</a></h3>
-<p>To run a task, press <code class="docutils literal notranslate"><span class="pre">Ctrl-Shift-P</span></code>, type <code class="docutils literal notranslate"><span class="pre">task</span></code> on the search box,
-and select <strong>Tasks: Run Task</strong>. The tasks that you define in the
-<code class="docutils literal notranslate"><span class="pre">tasks.json</span></code> file are listed. Select the task to run.</p>
-<p>The following is an example of running the <code class="docutils literal notranslate"><span class="pre">build_arduino_boot</span></code> task:</p>
-<div class="figure">
-<img alt="../_images/task_select_small.png" src="../_images/task_select_small.png" />
-</div>
-<div class="figure">
-<img alt="../_images/task_start_small.png" src="../_images/task_start_small.png" />
-</div>
-<p><strong>Note</strong>: To run the <code class="docutils literal notranslate"><span class="pre">build_arduino_blinky</span></code> task, you can use the
-keyboard shortcut <code class="docutils literal notranslate"><span class="pre">Ctrl-Shift-B</span></code> because the task has the property
-<code class="docutils literal notranslate"><span class="pre">isBuildCommand</span></code> set to true.</p>
-</div>
-<div class="section" id="defining-tasks-for-other-newt-commands">
-<h3><a class="toc-backref" href="#id7">Defining Tasks for Other Newt Commands</a><a class="headerlink" href="#defining-tasks-for-other-newt-commands" title="Permalink to this headline">¶</a></h3>
-<p>Other newt commands, such as the <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">load</span></code> command, do not need to
-run from within Visual Studio Code. You can define a task for each
-command as a convenience and run the command as a task, or you can run
-the newt command on the command line from the Visual Studio Code
-integrated terminal or an external terminal.</p>
-<p>To create the tasks for the <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">load</span> <span class="pre">arduino_boot</span></code> and
-<code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">load</span> <span class="pre">arduino_blinky</span></code> commands, add the following definitions to
-the <code class="docutils literal notranslate"><span class="pre">tasks.json</span></code> file:</p>
-<div class="highlight-JSON notranslate"><div class="highlight"><pre><span></span><span class="p">[</span>
- <span class="p">{</span>
- <span class="nt">"taskName"</span><span class="p">:</span> <span class="s2">"load_arduino_boot"</span><span class="p">,</span>
- <span class="nt">"args"</span><span class="p">:</span> <span class="p">[</span><span class="s2">"load"</span><span class="p">,</span> <span class="s2">"arduino_boot"</span><span class="p">],</span>
- <span class="nt">"suppressTaskName"</span><span class="p">:</span><span class="kc">true</span>
- <span class="p">},</span>
- <span class="p">{</span>
- <span class="nt">"taskName"</span><span class="p">:</span> <span class="s2">"load_arduino_blinky"</span><span class="p">,</span>
- <span class="nt">"args"</span><span class="p">:</span> <span class="p">[</span><span class="s2">"load"</span><span class="p">,</span> <span class="s2">"arduino_blinky"</span><span class="p">],</span>
- <span class="nt">"suppressTaskName"</span><span class="p">:</span><span class="kc">true</span>
- <span class="p">},</span>
-<span class="p">]</span>
-</pre></div>
-</div>
-<p>To run a command from the Visual Studio integrated terminal, instead of
-starting a task, press <code class="docutils literal notranslate"><span class="pre">Ctrl-`</span></code> to launch the integrated terminal and
-enter the command on the prompt:</p>
-<div class="figure">
-<img alt="../_images/integrated_terminal_small.png" src="../_images/integrated_terminal_small.png" />
-</div>
-</div>
-</div>
-<div class="section" id="defining-debugger-configurations">
-<h2><a class="toc-backref" href="#id8">Defining Debugger Configurations</a><a class="headerlink" href="#defining-debugger-configurations" title="Permalink to this headline">¶</a></h2>
-<p>You need to define a debugger
-configuration to launch the GDB debugger from within Visual Studio Code:</p>
-<p>Step 1: Select <strong>Debug</strong> > <strong>Open Configuration</strong>, and select the
-<strong>GDB</strong> environment.</p>
-<div class="figure">
-<img alt="../_images/debug_new_config_small.png" src="../_images/debug_new_config_small.png" />
-</div>
-<p>You should see a default <code class="docutils literal notranslate"><span class="pre">launch.json</span></code> file created in the <code class="docutils literal notranslate"><span class="pre">.vscode</span></code>
-folder.</p>
-<div class="figure">
-<img alt="../_images/launch_small.png" src="../_images/launch_small.png" />
-</div>
-<p>Step 2: Delete the content from the <code class="docutils literal notranslate"><span class="pre">launch.json</span></code> file, add the
-following definitions, and press ‘Ctrl-S’ to save the file.</p>
-<div class="highlight-json notranslate"><div class="highlight"><pre><span></span><span class="p">{</span>
- <span class="nt">"version"</span><span class="p">:</span> <span class="s2">"0.2.0"</span><span class="p">,</span>
- <span class="nt">"configurations"</span><span class="p">:</span> <span class="p">[</span>
- <span class="p">{</span>
- <span class="nt">"name"</span><span class="p">:</span> <span class="s2">"gdb_arduino_blinky"</span><span class="p">,</span>
- <span class="nt">"type"</span><span class="p">:</span> <span class="s2">"gdb"</span><span class="p">,</span>
- <span class="nt">"request"</span><span class="p">:</span> <span class="s2">"attach"</span><span class="p">,</span>
- <span class="nt">"executable"</span><span class="p">:</span> <span class="s2">"${workspaceRoot}\\bin\\targets\\arduino_blinky\\app\\apps\\blinky\\blinky.elf"</span><span class="p">,</span>
- <span class="nt">"target"</span><span class="p">:</span> <span class="s2">":3333"</span><span class="p">,</span>
- <span class="nt">"cwd"</span><span class="p">:</span> <span class="s2">"${workspaceRoot}"</span><span class="p">,</span>
- <span class="nt">"gdbpath"</span><span class="p">:</span> <span class="s2">"C:\\Program Files (x86)\\GNU Tools ARM Embedded\\4.9 2015q2\\bin\\arm-none-eabi-gdb.exe"</span><span class="p">,</span>
- <span class="nt">"remote"</span><span class="p">:</span> <span class="kc">true</span>
-
- <span class="p">}</span>
- <span class="p">]</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-<p>This defines a <code class="docutils literal notranslate"><span class="pre">gdb_arduino_blinky</span></code> debugger configuration. It
-specifies:</p>
-<ul class="simple">
-<li>The debugger is type <strong>gdb</strong>.</li>
-<li>To use the <code class="docutils literal notranslate"><span class="pre">blinky.elf</span></code> file for the executable.</li>
-<li>To use port 3333 to connect with the remote target.</li>
-<li>To use arm-none-eabi-gdb for the GDB program.</li>
-</ul>
-</div>
-<div class="section" id="debugging-your-application">
-<h2><a class="toc-backref" href="#id9">Debugging Your Application</a><a class="headerlink" href="#debugging-your-application" title="Permalink to this headline">¶</a></h2>
-<p>To debug your application, start the GDB server and
-launch the GDB session from Visual Studio Code. For the the arduino
-blinky example, perform the following:</p>
-<p>Step 1: Run the debug_arduino_blinky task to start the GDB server.
-Perform the following:</p>
-<ol class="arabic simple">
-<li>Press <code class="docutils literal notranslate"><span class="pre">Ctrl-Shift-P</span></code> and type <code class="docutils literal notranslate"><span class="pre">task</span></code> in the search box.</li>
-<li>Select <strong>Tasks:Run Task</strong> > <strong>debug_arduinoblinky</strong>.</li>
-<li>Press <code class="docutils literal notranslate"><span class="pre">Ctrl-Shift-U</span></code> to open the Output Panel and see the OpenOCD
-GDB Server output.</li>
-</ol>
-<div class="figure">
-<img alt="../_images/gdb_server_small.png" src="../_images/gdb_server_small.png" />
-</div>
-<p>Step 2: Start the GDB session. Perform the following:</p>
-<ol class="arabic simple">
-<li>Press <code class="docutils literal notranslate"><span class="pre">Ctrl-Shift-Y</span></code> to view the Debug Console.</li>
-<li>Press the Debugging icon on the activity bar (Ctrl-Shift-D) to bring
-up the Debug Side Bar.</li>
-<li>Select <code class="docutils literal notranslate"><span class="pre">gdb_arduino_blinky</span></code> from the DEBUG drop down menu.</li>
-<li>Press the green play button to start the gdb session.</li>
-</ol>
-<div class="figure">
-<img alt="../_images/gdb_small.png" src="../_images/gdb_small.png" />
-</div>
-<p>Step 3: Debug your application. You should see a debug session similar
-to the one shown below:</p>
-<div class="figure">
-<img alt="../_images/gdb_debug_small.png" src="../_images/gdb_debug_small.png" />
-</div>
-<p>For more information on how to use the Visual Studio Code Debugger, see
-the <a class="reference external" href="https://code.visualstudio.com/docs/editor/debugging">Visual Studio Code debugging
-documentation</a>.</p>
-</div>
-<div class="section" id="working-with-multiple-mynewt-applications">
-<h2><a class="toc-backref" href="#id10">Working with Multiple Mynewt Applications</a><a class="headerlink" href="#working-with-multiple-mynewt-applications" title="Permalink to this headline">¶</a></h2>
-<p>As mentioned previously, each mynewt project corresponds to a Visual
-Studio Code workspace. If you have multiple Mynewt application targets
-defined in same project, you will need to define build and debug tasks
-for each target in the <code class="docutils literal notranslate"><span class="pre">tasks.json</span></code> file and debugger configurations
-for the targets in the <code class="docutils literal notranslate"><span class="pre">launch.json</span></code> file for the workspace. If you
-have a different Mynewt project for each mynewt application, you will
-need to define build and debug tasks in the <code class="docutils literal notranslate"><span class="pre">tasks.json</span></code> file and the
-debugger configuration in the <code class="docutils literal notranslate"><span class="pre">launch.json</span></code> file for each workspace.</p>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="faq.html" class="btn btn-neutral float-right" title="FAQ - Administrative" accesskey="n">Next: FAQ - Administrative <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="go_env.html" class="btn btn-neutral" title="Contributing to Newt or Newtmgr Tools" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Contributing to Newt or Newtmgr Tools</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../_static/js/affix.js"></script>
- <script type="text/javascript" src="../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/misc/index.html b/develop/misc/index.html
deleted file mode 100644
index 646ce1dcd..000000000
--- a/develop/misc/index.html
+++ /dev/null
@@ -1,339 +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">
-
-
-
-
- <title>Appendix — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../genindex.html"/>
- <link rel="search" title="Search" href="../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../index.html"/>
- <link rel="next" title="Contributing to Newt or Newtmgr Tools" href="go_env.html"/>
- <link rel="prev" title="Mynewt OS related FAQ" href="../mynewt_faq.html"/>
-
-
- <script src="../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- Appendix
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/misc/index.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Appendix</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="go_env.html">Contributing to Newt or Newtmgr Tools</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ide.html">Developing Mynewt Applications with Visual Studio Code</a></li>
-<li class="toctree-l2"><a class="reference internal" href="faq.html">FAQ - Administrative</a></li>
-</ul>
-</li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="appendix">
-<h1>Appendix<a class="headerlink" href="#appendix" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="go_env.html">Contributing to Newt or Newtmgr Tools</a></li>
-<li class="toctree-l1"><a class="reference internal" href="ide.html">Developing Mynewt Applications with Visual Studio Code</a></li>
-<li class="toctree-l1"><a class="reference internal" href="faq.html">FAQ - Administrative</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="go_env.html" class="btn btn-neutral float-right" title="Contributing to Newt or Newtmgr Tools" accesskey="n">Next: Contributing to Newt or Newtmgr Tools <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="../mynewt_faq.html" class="btn btn-neutral" title="Mynewt OS related FAQ" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Mynewt OS related FAQ</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../_static/js/affix.js"></script>
- <script type="text/javascript" src="../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/mynewt_faq.html b/develop/mynewt_faq.html
deleted file mode 100644
index 68084688b..000000000
--- a/develop/mynewt_faq.html
+++ /dev/null
@@ -1,708 +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">
-
-
-
-
- <title>Mynewt OS related FAQ — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="genindex.html"/>
- <link rel="search" title="Search" href="search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="index.html"/>
- <link rel="next" title="Appendix" href="misc/index.html"/>
- <link rel="prev" title="Installing Previous Releases of Newtmgr" href="newtmgr/install/prev_releases.html"/>
-
-
- <script src="_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- Mynewt OS related FAQ
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-documentation/edit/master/docs/mynewt_faq.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="mynewt-os-related-faq">
-<span id="mynewt-faq"></span><h1>Mynewt OS related FAQ<a class="headerlink" href="#mynewt-os-related-faq" title="Permalink to this headline">¶</a></h1>
-<p>Here are some lists, grouped by categories, of frequently asked
-questions when working with Mynewt OS and tools.</p>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#bluetooth" id="id1">Bluetooth</a><ul>
-<li><a class="reference internal" href="#nimble-on-nrf52840" id="id2">NimBLE on nRF52840</a></li>
-<li><a class="reference internal" href="#trigger-exactly-one-ble-advertisement-immediately" id="id3">Trigger Exactly One BLE Advertisement Immediately</a></li>
-<li><a class="reference internal" href="#supported-bluetooth-radio-transceivers" id="id4">Supported Bluetooth Radio Transceivers</a></li>
-<li><a class="reference internal" href="#nimble-operational-questions" id="id5">NimBLE Operational Questions</a></li>
-<li><a class="reference internal" href="#blemesh-forgets-all-keys-on-restart" id="id6"><code class="docutils literal notranslate"><span class="pre">blemesh</span></code> Forgets All Keys on Restart</a></li>
-<li><a class="reference internal" href="#l2cap-connection" id="id7">L2CAP Connection</a></li>
-<li><a class="reference internal" href="#bitbang-ble-mesh-ble-advertising" id="id8">Bitbang, BLE Mesh, BLE Advertising</a></li>
-<li><a class="reference internal" href="#extended-advertising-with-btshell" id="id9">Extended Advertising with <code class="docutils literal notranslate"><span class="pre">btshell</span></code></a></li>
-<li><a class="reference internal" href="#configuring-maximum-number-of-connections-for-blehci" id="id10">Configuring Maximum Number of Connections for <code class="docutils literal notranslate"><span class="pre">blehci</span></code></a></li>
-<li><a class="reference internal" href="#disconnect-crash-while-writing-analog-value-from-central-module" id="id11">Disconnect/Crash While Writing Analog Value From Central Module</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#bootloader-and-firmware-upgrade" id="id12">Bootloader and Firmware Upgrade</a></li>
-<li><a class="reference internal" href="#file-system" id="id13">File System</a><ul>
-<li><a class="reference internal" href="#nffs-setup" id="id14"><code class="docutils literal notranslate"><span class="pre">nffs</span></code> Setup</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#nfc" id="id15">NFC</a></li>
-<li><a class="reference internal" href="#newt" id="id16">Newt</a><ul>
-<li><a class="reference internal" href="#difference-between-newt-commands-install-upgrade-and-sync" id="id17">Difference Between <code class="docutils literal notranslate"><span class="pre">newt</span></code> Commands <code class="docutils literal notranslate"><span class="pre">install</span></code>, <code class="docutils literal notranslate"><span class="pre">upgrade</span></code>, and <code class="docutils literal notranslate"><span class="pre">sync</span></code></a></li>
-<li><a class="reference internal" href="#newt-size-command-vs-elf-file-size" id="id18"><code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">size</span></code> Command vs. Elf File Size</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#newtmgr" id="id19">Newtmgr</a><ul>
-<li><a class="reference internal" href="#connection-profile-using-newtmgr" id="id20">Connection Profile using newtmgr</a></li>
-<li><a class="reference internal" href="#nmp" id="id21">NMP</a></li>
-<li><a class="reference internal" href="#newtmgr-with-the-adafruit-nrf52dk" id="id22">Newtmgr with the Adafruit nRF52DK</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#porting-mynewt" id="id23">Porting Mynewt</a><ul>
-<li><a class="reference internal" href="#porting-mynewt-to-core-m3-mcu" id="id24">Porting Mynewt to Core-M3 MCU</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#mynewt-syntax-and-semantics" id="id25">Mynewt Syntax and Semantics</a><ul>
-<li><a class="reference internal" href="#ending-the-delay-of-a-task-blocking-a-call-early" id="id26">Ending the Delay of a Task Blocking a Call Early</a></li>
-<li><a class="reference internal" href="#random-function-device" id="id27">Random Function / Device</a></li>
-<li><a class="reference internal" href="#setting-serial-and-mfghash" id="id28">Setting <code class="docutils literal notranslate"><span class="pre">serial</span></code> and <code class="docutils literal notranslate"><span class="pre">mfghash</span></code></a></li>
-<li><a class="reference internal" href="#leading-zeros-format-in-printf" id="id29">Leading Zeros Format in <code class="docutils literal notranslate"><span class="pre">printf</span></code></a></li>
-<li><a class="reference internal" href="#mynewt-equivalent-of-unix-sleep-3" id="id30">Mynewt Equivalent of UNIX <code class="docutils literal notranslate"><span class="pre">sleep(3)</span></code></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#modules-in-mynewt" id="id31">Modules in Mynewt</a></li>
-<li><a class="reference internal" href="#troubleshooting" id="id32">Troubleshooting</a><ul>
-<li><a class="reference internal" href="#error-unsatisfied-apis-detected" id="id33">Error: Unsatisfied APIs detected</a></li>
-<li><a class="reference internal" href="#greyed-out-files-on-ios-11" id="id34">Greyed out files on iOS 11</a></li>
-<li><a class="reference internal" href="#arm-none-eabi-gcc-build-error-for-project" id="id35"><code class="docutils literal notranslate"><span class="pre">arm-none-eabi-gcc</span></code> Build Error for Project</a></li>
-<li><a class="reference internal" href="#issues-running-image-on-boot" id="id36">Issues Running Image on Boot</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#miscellaneous" id="id37">Miscellaneous</a><ul>
-<li><a class="reference internal" href="#enable-trace-in-mynewt" id="id38">Enable Trace in Mynewt</a></li>
-<li><a class="reference internal" href="#version-control-applications-with-git" id="id39">Version Control Applications with Git</a></li>
-<li><a class="reference internal" href="#alternatives-to-cmsis-nvic-c" id="id40">Alternatives to <code class="docutils literal notranslate"><span class="pre">cmsis_nvic.c</span></code></a></li>
-<li><a class="reference internal" href="#inverted-pin-value-on-nrf52-dk" id="id41">Inverted Pin Value on nRF52-DK</a></li>
-<li><a class="reference internal" href="#documentation-on-correct-values-for-ble-gap-disc-params" id="id42">Documentation on Correct Values for <code class="docutils literal notranslate"><span class="pre">ble_gap_disc_params</span></code></a></li>
-<li><a class="reference internal" href="#time-precision-on-nrf52" id="id43">Time Precision on nRF52</a></li>
-<li><a class="reference internal" href="#multicast-messaging-and-group-messaging" id="id44">Multicast Messaging and Group Messaging</a></li>
-<li><a class="reference internal" href="#difference-between-compiler-yml-vs-pkg-yml" id="id45">Difference between <code class="docutils literal notranslate"><span class="pre">compiler.yml</span></code> vs. <code class="docutils literal notranslate"><span class="pre">pkg.yml</span></code></a></li>
-<li><a class="reference internal" href="#drivers-in-mynewt" id="id46">Drivers in Mynewt</a></li>
-<li><a class="reference internal" href="#reduce-code-size-for-mynewt-image" id="id47">Reduce Code Size for Mynewt Image</a></li>
-</ul>
-</li>
-</ul>
-</div>
-<div class="section" id="bluetooth">
-<h2><a class="toc-backref" href="#id1">Bluetooth</a><a class="headerlink" href="#bluetooth" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="nimble-on-nrf52840">
-<h3><a class="toc-backref" href="#id2">NimBLE on nRF52840</a><a class="headerlink" href="#nimble-on-nrf52840" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Is the nRF52840 supported by NimBLE?</p>
-<p><strong>A</strong>: The nRF52840 is supported, including Bluetooth 5 features.</p>
-</div>
-<div class="section" id="trigger-exactly-one-ble-advertisement-immediately">
-<h3><a class="toc-backref" href="#id3">Trigger Exactly One BLE Advertisement Immediately</a><a class="headerlink" href="#trigger-exactly-one-ble-advertisement-immediately" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Is there a way to trigger exactly one BLE advertisement immediately? I basically want to use BLE as a means to advertise to a whole group of devices and it needs to be relatively time-precise. Hoping for about 1ms precision, but it’s okay if there’s a delay as long as it’s deterministic.</p>
-<p><strong>A</strong>: With extended advertising you can enable an advertising instance for exactly 1 advertising event but there will be some delay before controller starts advertising which depends on the level of precision. The NimBLE controller always schedules the 1st advertising event with a constant 5ms delay. However, if there are other things scheduled in the controller it may need to schedule it later so it’s not guaranteed to be deterministic. Periodic advertising is currently not supported.</p>
-</div>
-<div class="section" id="supported-bluetooth-radio-transceivers">
-<h3><a class="toc-backref" href="#id4">Supported Bluetooth Radio Transceivers</a><a class="headerlink" href="#supported-bluetooth-radio-transceivers" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Are there any other Bluetooth radio transceivers that are supported already or anyone working on? If there is a Bluetooth radio that can be integrated using the HCI, we can use the NimBLE host? If so, I suppose we don’t need detailed specs of the Bluetooth radio?</p>
-<p><strong>A</strong>: You should be able to run the NimBLE host against pretty much any controller using HCI. We have a BLE controller implementation for Nordic only, but host (in theory) should work with all. More likely, it will work with 5.0 controller. For 4.x controllers it may fail on initialization since we do not check controller features - but this can be fixed as for other radio transceivers. For example, there’s NXP KW41Z which has BLE-compatible radio documented. However, NXP documentation is more or less a description of zillions of different registers so not as friendly as the one from Nordic which explains how to actually use it.</p>
-</div>
-<div class="section" id="nimble-operational-questions">
-<h3><a class="toc-backref" href="#id5">NimBLE Operational Questions</a><a class="headerlink" href="#nimble-operational-questions" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Can I update firmware via BLE for multiple devices simultaneously using a single device/phone supporting Bluetooth?</p>
-<p><strong>A</strong>: Yes, it is possible to update several Nimble devices simultaneously from a single phone (e.g., central) as long as the central can handle all the simultaneous Bluetooth connections. You can also do it using your computer as a central with newtmgr. Just open two terminals and initiate a newtmgr image upload command in each, each to a different device. You will, however, get better overall throughput if you limit yourself to one upgrade at a time.</p>
-<p><strong>Q</strong>: I have the following doubts on NimBLE: The document says 32+ concurrent connections, multiple connections in simultaneous central and peripheral roles. Does that mean the “device running NimBLE” can connect to 32 different other devices like phones?</p>
-<p><strong>A</strong>: Yes, with one caveat: each of the 32 centrals needs to be sufficiently cooperative in choosing connection partners (<a class="reference external" href="http://www.novelbits.io/ble-connection-intervals/">http://www.novelbits.io/ble-connection-intervals/</a>). Your app might need to request different connection parameters from the centrals (using <code class="docutils literal notranslate"><span class="pre">ble_gap_update_params</span></code>).</p>
-<p>Of course, you will also need to build the Mynewt image device with a configuration suitable for 32 concurrent connections (e.g., <code class="docutils literal notranslate"><span class="pre">NIMBLE_MAX_CONNECTIONS=32</span></code>, etc.)</p>
-</div>
-<div class="section" id="blemesh-forgets-all-keys-on-restart">
-<h3><a class="toc-backref" href="#id6"><code class="docutils literal notranslate"><span class="pre">blemesh</span></code> Forgets All Keys on Restart</a><a class="headerlink" href="#blemesh-forgets-all-keys-on-restart" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Is it expected that the blemesh example forgets all the keys on restart and needs to be provisioned again? If so, how can I implement key persistence myself? Is there any API to obtain / provide mesh keys before the mesh node is started? I found bt_mesh_provision, but the comment there seems to indicate that this is not the right way to use it.</p>
-<p><strong>A</strong>: Mesh implementations do not persist keys at the moment. There is a plan to add it but not sure about timeline. It probably needs to be implemented inside mesh implementation so there’s no API, but if you’d like to hack something I suggest taking a look at shell.c and testing.c - there are some testing functions to add/display keys. Another area to look if you actually want to persist keys to flash is <code class="docutils literal notranslate"><span class="pre">net/nimble/host/store/config/src/ble_store_config.c</span></code>. This is the code that persists and restores security material for (non-mesh) Bluetooth.</p>
-</div>
-<div class="section" id="l2cap-connection">
-<h3><a class="toc-backref" href="#id7">L2CAP Connection</a><a class="headerlink" href="#l2cap-connection" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I want to do an L2CAP connection, and am trying the auth-passkey command, but am not sure about the parameters <code class="docutils literal notranslate"><span class="pre">psm</span></code>, <code class="docutils literal notranslate"><span class="pre">action</span></code>, and <code class="docutils literal notranslate"><span class="pre">oob</span></code>. What is <code class="docutils literal notranslate"><span class="pre">psm</span></code>, and what is the value of that parameter in the btshell command <code class="docutils literal notranslate"><span class="pre">l2cap-connect</span></code>? How do I set the parameters <code class="docutils literal notranslate"><span class="pre">action</span></code> and <code class="docutils literal notranslate"><span class="pre">oob</span></code>?</p>
-<p><strong>A</strong>: <code class="docutils literal notranslate"><span class="pre">psm</span></code> stands for Protocol Service Multiplexer. You pass the <code class="docutils literal notranslate"><span class="pre">psm</span></code> value to either <code class="docutils literal notranslate"><span class="pre">l2-cap-connect</span></code> or <code class="docutils literal notranslate"><span class="pre">l2cap-create-server</span></code>. The parameters <code class="docutils literal notranslate"><span class="pre">action</span></code> and <code class="docutils literal notranslate"><span class="pre">oob</span></code> are just passing constant values as defined in the API.</p>
-</div>
-<div class="section" id="bitbang-ble-mesh-ble-advertising">
-<h3><a class="toc-backref" href="#id8">Bitbang, BLE Mesh, BLE Advertising</a><a class="headerlink" href="#bitbang-ble-mesh-ble-advertising" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Is it possible to run bitbanging and BLE mesh at the same time? How about running BLE Mesh and BLE advertising at the same time?</p>
-<p><strong>A</strong>: It is possible to run bitbanging and BLE mesh at the same time, but the bitbanging UART takes a lot of CPU on Nordic. We’ve run it at 9600 which would probably be okay for lower rate devices, but for reliability it is recommended to run at 4800. If this is just for the console and your UART port is tied up, <code class="docutils literal notranslate"><span class="pre">rtt</span></code> is recommended. Visit <a class="reference internal" href="tutorials/tooling/segger_rtt.html"><span class="doc">Segger RTT Console</span></a> for more information. However, bitbanger can be handy given limited UARTs.</p>
-<p>You can certainly continue advertisements during connections, if you are using the GATT bearer for mesh. Mesh is also tied into the ext-adv bearer in Mynewt, which also allows for interleaving, even if you’re transmitting mesh data on advertising channels.</p>
-</div>
-<div class="section" id="extended-advertising-with-btshell">
-<h3><a class="toc-backref" href="#id9">Extended Advertising with <code class="docutils literal notranslate"><span class="pre">btshell</span></code></a><a class="headerlink" href="#extended-advertising-with-btshell" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I am using <code class="docutils literal notranslate"><span class="pre">btshell</span></code> for advertising with nRF52. When I use 31 bytes, <code class="docutils literal notranslate"><span class="pre">mfg_data</span></code> accepts the data with extended advertising. But when I use more bytes than that, <code class="docutils literal notranslate"><span class="pre">mfg_data</span></code> doesn’t accept it. Is 251 byte payload supported in extended advertising? How can I send more than a 251 byte payload on extended advertising?</p>
-<p><strong>A</strong>: You need to set the <code class="docutils literal notranslate"><span class="pre">BLE_EXT_ADV_MAX_SIZE</span></code> syscfg to your required value. For example:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">newt target amend <your_target> syscfg=BLE_EXT_ADV=1:BLE_EXT_ADV_MAX_SIZE=1650</span>
-</pre></div>
-</div>
-<p>The default is 31 bytes, and the max is 1650.</p>
-<p>Keep in mind that with extended advertising, you cannot set advertising data for an instance configured as scannable (e.g. <code class="docutils literal notranslate"><span class="pre">advertise-configure</span> <span class="pre">scannable=1</span></code>). Either set scan response data using <code class="docutils literal notranslate"><span class="pre">advertise-set-scan-rsp</span></code> command (parameters are the same as for <code class="docutils literal notranslate"><span class="pre">advertise-set-adv-data</span></code>) or configure the instance as non-scannable. For example, <code class="docutils literal notranslate"><span class="pre">advertise-configure</span></code> alone will configure the instance as non-connectable and non-scannable which means you can set advertising data. Also note that if you continue to use a scannable instance you will need to perform active scanning in order to get scan response data.</p>
-<p>FYI, legacy advertising instances can accept both advertising and scan response data but since they use legacy PDUs the limit is still 31 bytes.</p>
-</div>
-<div class="section" id="configuring-maximum-number-of-connections-for-blehci">
-<h3><a class="toc-backref" href="#id10">Configuring Maximum Number of Connections for <code class="docutils literal notranslate"><span class="pre">blehci</span></code></a><a class="headerlink" href="#configuring-maximum-number-of-connections-for-blehci" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: How do I set the maximum number of connections for the <code class="docutils literal notranslate"><span class="pre">blehci</span></code> <a class="reference internal" href="tutorials/ble/blehci_project.html"><span class="doc">example</span></a>? I see there is a <code class="docutils literal notranslate"><span class="pre">MYNEWT_VAL_BLE_MAX_CONNECTIONS</span></code>, but I don’t know how to set it.</p>
-<p><strong>A</strong>: You can to set it in target settings:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">newt target amend <target> syscfg=BLE_MAX_CONNECTIONS=2</span>
-</pre></div>
-</div>
-<p>and then rebuild using <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">build</span> <span class="pre"><target></span></code>. <code class="docutils literal notranslate"><span class="pre">MYNEWT_VAL_BLE_MAX_CONNECTIONS</span></code> is just a symbol that is defined in <code class="docutils literal notranslate"><span class="pre">syscfg.h</span></code> which is autogenerated by <code class="docutils literal notranslate"><span class="pre">newt</span></code> tool and contains all the settings set at package/app/target level.</p>
-<p><strong>Q</strong>: What if I need to set 2 constants? What’s the syntax?</p>
-<p><strong>A</strong>: You can set each setting in separate commands or separate <code class="docutils literal notranslate"><span class="pre">key=value</span></code> pairs with colon:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">newt target amend <target> syscfg=FOO=1:BAR=2</span>
-</pre></div>
-</div>
-<p><strong>Q</strong>: How do you know the constant is <code class="docutils literal notranslate"><span class="pre">BLE_MAX_CONNECTIONS</span></code> and not <code class="docutils literal notranslate"><span class="pre">MYNEWT_VAL_BLE_MAX_CONNECTIONS</span></code>? Is there a place I can see those names?</p>
-<p><strong>A</strong>: This is actually one of NimBLE’s settings - you can find these settings available for different packages in the <code class="docutils literal notranslate"><span class="pre">syscfg.yml</span></code> files in the repository. You can also use <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">target</span> <span class="pre">config</span> <span class="pre">show</span> <span class="pre"><target></span></code> to show all settings with their current values, and then change any of these settings accordingly. Each setting will get a symbol prefixed by <code class="docutils literal notranslate"><span class="pre">MYNEWT_VAL_</span></code> in the autogenerated <code class="docutils literal notranslate"><span class="pre">syscfg.h</span></code> file so you can get the actual setting name from this symbol. For more info on System Configuration and Initialization, please visit the <span class="xref std std-doc">Compile-Time Configuration and Initialization</span> page in the OS User Guide.</p>
-</div>
-<div class="section" id="disconnect-crash-while-writing-analog-value-from-central-module">
-<h3><a class="toc-backref" href="#id11">Disconnect/Crash While Writing Analog Value From Central Module</a><a class="headerlink" href="#disconnect-crash-while-writing-analog-value-from-central-module" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I’m trying to write analog sensor data from my central module to my peripheral module. I can receive the values from the ADC callback perfectly, but I’m not able to write them to the peripheral module. The peripheral module disconnects right when the <code class="docutils literal notranslate"><span class="pre">ble_gattc_write_flat</span></code> command is called. What could be causing the issue?</p>
-<p><strong>A</strong>: First, check the reason for the disconnect. The gap event callback should indicate the reason in <code class="docutils literal notranslate"><span class="pre">disconnect.reason</span></code>. If the code never reaches the disconnect callback, then the code most likely crashed. If so, check whether <code class="docutils literal notranslate"><span class="pre">ble_gattc_write_flat</span></code> is called from an interrupt context. Calling into the BLE host from within an interrupt is a bad idea in general, and may cause a crash to occur because the Bluetooth host attempts to log to the console during the write procedure. Logging to the console uses quite a bit of stack space, so it is likely that the interrupt stack is overflowing.</p>
-<p>Instead, you should send an event to the event queue and handle this in a task context. You’ll need to associate the characteristic data with the event so that your event callback knows what payload to pass to the <code class="docutils literal notranslate"><span class="pre">ble_gattc_write_flat()</span></code> function. If you don’t need to perform multiple writes in rapid succession, then you can just use a single global event and single global buffer. However, you will still need to make sure your buffer doesn’t become corrupted by a subsequent ADC interrupt while you are in mid-write.</p>
-</div>
-</div>
-<div class="section" id="bootloader-and-firmware-upgrade">
-<h2><a class="toc-backref" href="#id12">Bootloader and Firmware Upgrade</a><a class="headerlink" href="#bootloader-and-firmware-upgrade" title="Permalink to this headline">¶</a></h2>
-<p><strong>Q</strong>: I wanted to check if the stack provides firmware upgrade capability and if so, is there an example you can provide on how it is being done?</p>
-<p><strong>A</strong>: The newtmgr tool is used to upgrade Mynewt devices. Newtmgr is a command line tool, but there are other client libraries available. There is some information listed under the “Image Upgrade” header in the <a class="reference internal" href="os/modules/split/split.html"><span class="doc">Split Image documentation</span></a>.</p>
-<p><strong>Q</strong>: Is there any documentation on using the bootloader? It sounds like it has baked-in support for serial loading, but I can’t find any details on serial protocol, or how to do a serial boot load. I assume we set a GPREGRET flag that tells the bootloader to expect to be flashed by serial, then it handles the rest. Is that true?</p>
-<p><strong>A</strong>: The serial bootloader would inspect a GPIO to see whether to wait for image upload commands or not. The protocol is the same newtmgr protocol we use for usual image uploads. For some the state reporting is simplified (omitted), and image upload goes to slot 0 instead of slot 1. The serial bootloading is built into newtmgr. For more information, refer to the documentation on the <a class="reference internal" href="os/modules/bootloader/bootloader.html"><span class="doc">Mynewt bootloader</span></a>.</p>
-<p><strong>Q</strong>: Is there any major difference between MCUboot and the Mynewt bootloader?</p>
-<p><strong>A</strong>: They use different formats. The header is different as well, since you need to pass an extra flag (e.g. -2 to newt for <code class="docutils literal notranslate"><span class="pre">create-image</span></code>).</p>
-<p><strong>Q</strong>: What is the difference between <code class="docutils literal notranslate"><span class="pre">boot_serial</span></code> and <code class="docutils literal notranslate"><span class="pre">bootutil</span></code>?</p>
-<p><strong>A</strong>: <code class="docutils literal notranslate"><span class="pre">boot_serial</span></code> is used only for downloading images over the serial port. If you are using newtmgr to upload image over serial, it is handled in <code class="docutils literal notranslate"><span class="pre">boot_serial</span></code>. All other bootloader code is in <code class="docutils literal notranslate"><span class="pre">bootutil</span></code>.</p>
-</div>
-<div class="section" id="file-system">
-<h2><a class="toc-backref" href="#id13">File System</a><a class="headerlink" href="#file-system" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="nffs-setup">
-<h3><a class="toc-backref" href="#id14"><code class="docutils literal notranslate"><span class="pre">nffs</span></code> Setup</a><a class="headerlink" href="#nffs-setup" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I’m struggling to find any examples for <code class="docutils literal notranslate"><span class="pre">nffs</span></code>, especially how do I setup the <code class="docutils literal notranslate"><span class="pre">nffs_area_desc</span></code> correctly. Where do I set it up in the BSP especially?</p>
-<p><strong>A</strong>: It’s all taken care of in <code class="docutils literal notranslate"><span class="pre">nffs_pkg_init</span></code>. As long as the <code class="docutils literal notranslate"><span class="pre">nffs</span></code> package is included in the project, it should initialize itself. A few things you might find helpful:</p>
-<ol class="arabic simple">
-<li>The <code class="docutils literal notranslate"><span class="pre">NFFS_FLASH_AREA</span></code> syscfg setting specifies the flash area that contains the file system.</li>
-<li>The BSP’s <code class="docutils literal notranslate"><span class="pre">bsp.yml</span></code> file defines all the flash areas in the system, including the one specified in “1.” above.</li>
-</ol>
-</div>
-</div>
-<div class="section" id="nfc">
-<h2><a class="toc-backref" href="#id15">NFC</a><a class="headerlink" href="#nfc" title="Permalink to this headline">¶</a></h2>
-<p>The NFC stack is work in progress.</p>
-</div>
-<div class="section" id="newt">
-<h2><a class="toc-backref" href="#id16">Newt</a><a class="headerlink" href="#newt" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="difference-between-newt-commands-install-upgrade-and-sync">
-<h3><a class="toc-backref" href="#id17">Difference Between <code class="docutils literal notranslate"><span class="pre">newt</span></code> Commands <code class="docutils literal notranslate"><span class="pre">install</span></code>, <code class="docutils literal notranslate"><span class="pre">upgrade</span></code>, and <code class="docutils literal notranslate"><span class="pre">sync</span></code></a><a class="headerlink" href="#difference-between-newt-commands-install-upgrade-and-sync" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: What’s the difference between <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">install</span></code>, <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">upgrade</span></code>, and <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">sync</span></code>?</p>
-<p><strong>A</strong>:</p>
-<ul class="simple">
-<li><code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">install</span></code>: downloads repos that aren’t installed yet. The downloaded version matches what <code class="docutils literal notranslate"><span class="pre">project.yml</span></code> specifies.</li>
-<li><code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">upgrade</span></code>: performs an install, but also applies to repos that are already installed.</li>
-<li><code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">sync</span></code>: fetches and pulls the latest for each repo, but does not change the branch (version).</li>
-</ul>
-</div>
-<div class="section" id="newt-size-command-vs-elf-file-size">
-<h3><a class="toc-backref" href="#id18"><code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">size</span></code> Command vs. Elf File Size</a><a class="headerlink" href="#newt-size-command-vs-elf-file-size" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I did a test build of blinky for nrf52 and got an elf-file of size 295424 bytes. If I use the newt size command for the application it says something like: 18764 bytes. What does this mean?</p>
-<p><strong>A</strong>: Elfs have a lot of extra information. newt size will show the are in flash that is used which better matches the <code class="docutils literal notranslate"><span class="pre">blinky.elf.bin</span></code> file. Try <code class="docutils literal notranslate"><span class="pre">running</span> <span class="pre">newt</span> <span class="pre">-ldebug</span> <span class="pre">build</span> <span class="pre">-v</span> <span class="pre"><your-target></span></code> and you will see something like this:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">arm-none-eabi-objcopy -R .bss -R .bss.core -R .bss.core.nz -O binary ...</span>
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="newtmgr">
-<h2><a class="toc-backref" href="#id19">Newtmgr</a><a class="headerlink" href="#newtmgr" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="connection-profile-using-newtmgr">
-<h3><a class="toc-backref" href="#id20">Connection Profile using newtmgr</a><a class="headerlink" href="#connection-profile-using-newtmgr" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I’m trying to connect to an Adafruit nRF52 Feather Pro running Mynewt via the newtmgr tool on MacOS. I have the device powered via micro USB to my Mac. How do I find the “connection profile” of the device so I can connect to it? I want to communicate over BLE and not serial.</p>
-<p><strong>A</strong>: A connection profile tells newtmgr how to communicate with your device. You can create one using the <code class="docutils literal notranslate"><span class="pre">newtmgr</span> <span class="pre">conn</span> <span class="pre">add</span></code> command. Try talking to your device without a connection profile first. If that works, you can create a profile to make it easier to communicate with the device going forward.</p>
-<p>For BLE, you can send an echo command to your device with something like this:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">newtmgr --conntype ble --connstring peer_name=nimble-bleprph echo Hello</span>
-</pre></div>
-</div>
-<p>That <code class="docutils literal notranslate"><span class="pre">peer_name</span> <span class="pre">string</span></code> is correct if your device is running the <code class="docutils literal notranslate"><span class="pre">bleprph</span></code> app. You’ll need to adjust it if your device has a different BLE name. The <code class="docutils literal notranslate"><span class="pre">--conntype</span> <span class="pre">ble</span> <span class="pre">--connstring</span> <span class="pre">peer_name=nimble-bleprph</span></code> part is what would go in a connection profile. If you create one, then you can just specify the profile’s name rather than typing that long string each time you send a command.</p>
-</div>
-<div class="section" id="nmp">
-<h3><a class="toc-backref" href="#id21">NMP</a><a class="headerlink" href="#nmp" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: What does NMP stand for?</p>
-<p><strong>A</strong>: Newtmgr Management Protocol</p>
-</div>
-<div class="section" id="newtmgr-with-the-adafruit-nrf52dk">
-<h3><a class="toc-backref" href="#id22">Newtmgr with the Adafruit nRF52DK</a><a class="headerlink" href="#newtmgr-with-the-adafruit-nrf52dk" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I’m having issues using Newt Manager with the Adafruit nRF52DK. What do I do?</p>
-<p>You can specify the reduced MTU by adding <code class="docutils literal notranslate"><span class="pre">mtu=128</span></code> to your connection string. The reason for this change is that MTU is the serial boot loader used to have a smaller receive buffer (128 bytes). The newtmgr tool sends larger image chunks by default, so specifying the MTU will reduce the image size.</p>
-<dl class="docutils">
-<dt><strong>A</strong>: There are two things you will need to do to fix any issues you encounter when working with the Adafruit nRF52DK and Newt Manager:</dt>
-<dd>You can specify the reduced MTU by adding <code class="docutils literal notranslate"><span class="pre">mtu=128</span></code> to your connection string. The reason for this change is that MTU is the serial boot loader used to have a smaller receive buffer (128 bytes). The newtmgr tool sends larger image chunks by default, so specifying the MTU will reduce the image size.</dd>
-</dl>
-<p>1. Specify a reduced MTU:
-You can specify the reduced MTU by adding <code class="docutils literal notranslate"><span class="pre">mtu=128</span></code> to your connection string. The reason for this change is that MTU is the serial boot loader used to have a smaller receive buffer (128 bytes). The newtmgr tool sends larger image chunks by default, so specifying the MTU will reduce the image size.</p>
-<p>2. Indicate that the existing image should not be erased:
-This is accomplished with the <code class="docutils literal notranslate"><span class="pre">-e</span></code> command line option. Your command line should look similar to the following:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> newtmgr --conntype serial --connextra <span class="s1">'dev=/dev/ttyUSB0,mtu=128'</span> image upload -e <image-path>
-</pre></div>
-</div>
-<p>This change is needed because the serial boot loader doesn’t support the standalone “erase image” command - as a result, it drops the request. The newtmgr image upload command starts by sending an erase command, then times out when it doesn’t receive a response. The older version of newtmgr would use smaller chunk size for images, and it did not send the standalone erase command. When newtmgr was changed in versions 1.2 and 1.3, the serial boot loader changed along with it. The latest newtmgr is not compatible with an older version of the boot loader (which your board will probably ship with) without the above workarounds.</p>
-</div>
-</div>
-<div class="section" id="porting-mynewt">
-<h2><a class="toc-backref" href="#id23">Porting Mynewt</a><a class="headerlink" href="#porting-mynewt" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="porting-mynewt-to-core-m3-mcu">
-<h3><a class="toc-backref" href="#id24">Porting Mynewt to Core-M3 MCU</a><a class="headerlink" href="#porting-mynewt-to-core-m3-mcu" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I have a weird OS tick issue with a Core-M3 MCU port. The tick rate is set up identically to most ARM MCUs by setting up a hardware interrupt to trigger SysClock / <code class="docutils literal notranslate"><span class="pre">os_tick_per_sec</span></code>. SysClock is correct and <code class="docutils literal notranslate"><span class="pre">os_tick_per_sec</span></code> is set to 1000, but the tick rate seems to be significantly higher. What am I doing wrong?</p>
-<p><strong>A</strong>: Check whether the LED is actually staying on or it is flickering really fast by debugging through the loop. If it is staying on, you may be getting into an <code class="docutils literal notranslate"><span class="pre">assert()</span></code>. Otherwise, it is due to the fact that the OS timer wasn’t created, which is done by <code class="docutils literal notranslate"><span class="pre">hal_bsp.c</span></code>. The OS timer needs a hardware timer to be running, so you will need to call <code class="docutils literal notranslate"><span class="pre">hal_timer_init</span></code> for timer 0 at one point.</p>
-</div>
-</div>
-<div class="section" id="mynewt-syntax-and-semantics">
-<h2><a class="toc-backref" href="#id25">Mynewt Syntax and Semantics</a><a class="headerlink" href="#mynewt-syntax-and-semantics" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="ending-the-delay-of-a-task-blocking-a-call-early">
-<h3><a class="toc-backref" href="#id26">Ending the Delay of a Task Blocking a Call Early</a><a class="headerlink" href="#ending-the-delay-of-a-task-blocking-a-call-early" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I have a task which is blocking on a call to <code class="docutils literal notranslate"><span class="pre">os_time_delay()</span></code>. What is the recommended way to end the delay early in an ISR (e.g. button press)?</p>
-<p><strong>A</strong>: The best way would be to use a semaphore. Initialize the semaphore with a count of 0 (<code class="docutils literal notranslate"><span class="pre">os_sem_init()</span></code>), then block on the semaphore with the maximum delay you want to wait for (<code class="docutils literal notranslate"><span class="pre">os_sem_pend()</span></code>). The button press event would wake the first task up early by calling <code class="docutils literal notranslate"><span class="pre">os_sem_release()</span></code>.</p>
-</div>
-<div class="section" id="random-function-device">
-<h3><a class="toc-backref" href="#id27">Random Function / Device</a><a class="headerlink" href="#random-function-device" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Does Mynewt have a random function or random device?</p>
-<p><strong>A</strong>: <code class="docutils literal notranslate"><span class="pre">baselibc</span></code> has <code class="docutils literal notranslate"><span class="pre">rand()</span></code>, and <code class="docutils literal notranslate"><span class="pre">crypto/tinycrypt</span></code> has <code class="docutils literal notranslate"><span class="pre">hmac-prng</span></code>.</p>
-</div>
-<div class="section" id="setting-serial-and-mfghash">
-<h3><a class="toc-backref" href="#id28">Setting <code class="docutils literal notranslate"><span class="pre">serial</span></code> and <code class="docutils literal notranslate"><span class="pre">mfghash</span></code></a><a class="headerlink" href="#setting-serial-and-mfghash" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: What is <code class="docutils literal notranslate"><span class="pre">mfghash</span></code>? How do I set <code class="docutils literal notranslate"><span class="pre">serial</span></code> and <code class="docutils literal notranslate"><span class="pre">mfghash</span></code> (currently blank in my app)?</p>
-<p><strong>A</strong>: <code class="docutils literal notranslate"><span class="pre">mfghash</span></code> is computed if you’re using <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">mfg</span></code> to construct your flash image, and it identifies the build of your bootloader. <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">mfg</span></code> bundles togetherthe bootloader, target image, and other data you’d want to bundle when creating an image to burn to flash. See the <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">mfg</span></code> <span class="xref std std-doc">documentation</span> for the construction side of things and <code class="docutils literal notranslate"><span class="pre">apache-mynewt-core/sys/mfg/src/mfg.c</span></code> for the firmware side. <code class="docutils literal notranslate"><span class="pre">serial</span></code> was intended to be used if you want to have your own naming scheme per device when building products; i.e. you want something other than the mcu serial number, or if you don’t have serial number available.</p>
-</div>
-<div class="section" id="leading-zeros-format-in-printf">
-<h3><a class="toc-backref" href="#id29">Leading Zeros Format in <code class="docutils literal notranslate"><span class="pre">printf</span></code></a><a class="headerlink" href="#leading-zeros-format-in-printf" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Is there a way to make printf and console_printf honor the leading zeroes format? As in:</p>
-<p><code class="docutils literal notranslate"><span class="pre">console_printf("%.2d",</span> <span class="pre">5);</span></code></p>
-<p>outputting “05” instead of as for me now: “2d” ?</p>
-<p><strong>A</strong>: <code class="docutils literal notranslate"><span class="pre">console_printf("%02d",</span> <span class="pre">5);</span></code></p>
-</div>
-<div class="section" id="mynewt-equivalent-of-unix-sleep-3">
-<h3><a class="toc-backref" href="#id30">Mynewt Equivalent of UNIX <code class="docutils literal notranslate"><span class="pre">sleep(3)</span></code></a><a class="headerlink" href="#mynewt-equivalent-of-unix-sleep-3" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Is there an equivalent to the UNIX sleep(3)?</p>
-<p><strong>A</strong>: <code class="docutils literal notranslate"><span class="pre">os_time_delay(OS_TICKS_PER_SEC</span> <span class="pre">*</span> <span class="pre">secs)</span></code></p>
-</div>
-</div>
-<div class="section" id="modules-in-mynewt">
-<h2><a class="toc-backref" href="#id31">Modules in Mynewt</a><a class="headerlink" href="#modules-in-mynewt" title="Permalink to this headline">¶</a></h2>
-<p><strong>Q</strong>: Can you tell me what the purpose of the module argument is in the Mynewt logging library? It looks like it just takes an int. Is this just to assign an integer ID for each module that logs?</p>
-<p><strong>A</strong>: It is just an integer which accompanies each log entry. It provides context for each log entry, and it allows a client to filter messages based on module (e.g. “give me all the file system log entries”).</p>
-<p><strong>Q</strong>: So, what is the conceptual difference between a log name, and a module number? It seems like a log type would be assigned the same name as the module that is using it, and that the module number is just a numerical ID for the module. Basically, I don’t understand what the purpose of storing the name into the log type is, and passing the module number in as part of <code class="docutils literal notranslate"><span class="pre">LOG_<LEVEL></span></code> macro.</p>
-<p><strong>A</strong>: A log just represents a medium or region of storage (e.g., “console”, or “flash circular buffer in 12kB of flash, starting at 0x0007d000”). Many parts of the system can write to the same log, so you may end up with Bluetooth, file system, and kernel scheduler entries all in the same log. The module ID distinguishes these entries from one another. You can control level per module, so you can say, “give me all bluetooth warnings, but only give me system level errors”.</p>
-<p><strong>Q</strong>: Okay, so for something like console logging, we would likely register one log for the entire application, and give each module an ID?</p>
-<p><strong>A</strong>: I think the thought is that would be the debug log, and during development you could pipe that to console. In production, that might go in the spare image slot. I’m not sure if we support it yet, but we should make sure the log can write to multiple handlers at the same time.</p>
-</div>
-<div class="section" id="troubleshooting">
-<h2><a class="toc-backref" href="#id32">Troubleshooting</a><a class="headerlink" href="#troubleshooting" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="error-unsatisfied-apis-detected">
-<h3><a class="toc-backref" href="#id33">Error: Unsatisfied APIs detected</a><a class="headerlink" href="#error-unsatisfied-apis-detected" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I ran into the following error message:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">Error: Unsatisfied APIs detected:</span>
-<span class="go">* stats, required by: hw/drivers/sensors/bmp280, hw/drivers/sensors/ms5837, net/oic</span>
-</pre></div>
-</div>
-<p>How do I resolve this?</p>
-<p><strong>A</strong>: You may be missing some package dependencies in your <code class="docutils literal notranslate"><span class="pre">pkg.yml</span></code> file. In this case, you need to include <code class="docutils literal notranslate"><span class="pre">sys/stats</span></code> (either <code class="docutils literal notranslate"><span class="pre">sys/stats/full</span></code> or <code class="docutils literal notranslate"><span class="pre">sys/stats/stub</span></code>) to your <code class="docutils literal notranslate"><span class="pre">pkg.yml</span></code> file. You can add it to either your app’s or target’s pkg.yml file, but if you have a custom app it is recommended that you add it to your app’s <code class="docutils literal notranslate"><span class="pre">pkg.yml</span></code>. That way you can have multiple targets for the same app, without having to add it to every target. Moreover, if you share your app package, others won’t run into the same error when building it.</p>
-</div>
-<div class="section" id="greyed-out-files-on-ios-11">
-<h3><a class="toc-backref" href="#id34">Greyed out files on iOS 11</a><a class="headerlink" href="#greyed-out-files-on-ios-11" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I’m trying to use the Adafruit Mynewt Manager to upload a custom image over BLE. Uploading one of the provided <code class="docutils literal notranslate"><span class="pre">bleuartx000.img</span></code> works fine and I can boot into them, confirm etc. However, when I try to upload a custom image I can’t even seem to add it to the app. Images stored in the iCloud drive just appear as disabled icons. Anyone with a clue as to how to get that working?</p>
-<p><strong>A</strong>: The new iOS version no longer allows files with unrecognized extensions to be selected. Try renaming the file to something more compatible (e.g. .txt).</p>
-</div>
-<div class="section" id="arm-none-eabi-gcc-build-error-for-project">
-<h3><a class="toc-backref" href="#id35"><code class="docutils literal notranslate"><span class="pre">arm-none-eabi-gcc</span></code> Build Error for Project</a><a class="headerlink" href="#arm-none-eabi-gcc-build-error-for-project" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I am having this error when I try to build my project:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">Building target targets/stm32l072czy6tr_boot</span>
-<span class="go">Error: exec: "arm-none-eabi-gcc": executable file not found in $PATH</span>
-</pre></div>
-</div>
-<p>How do I add it?</p>
-<p><strong>A</strong>: First, install the GNU Arm Embedded Toolchain if you haven’t already. Then, depending on your OS, add the link to your <code class="docutils literal notranslate"><span class="pre">arm-none-eabi-gcc</span></code> executable path to your PATH environment variable.</p>
-</div>
-<div class="section" id="issues-running-image-on-boot">
-<h3><a class="toc-backref" href="#id36">Issues Running Image on Boot</a><a class="headerlink" href="#issues-running-image-on-boot" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I was able to successfully create a BSP for my custom board (using nRF52 MCU), then build and run that image in the debugger. However, it does not run on boot. Any ideas to fix the issue?</p>
-<p><strong>A</strong>: A good process in general is to do a full flash erase, then flash the bootloader and the running image. Make sure to dump the contents of flash and see that it actually gets written there as well. If you experience the issue again after a reboot, you will also want to set <code class="docutils literal notranslate"><span class="pre">MCU_DCDC_ENABLED:0</span></code> then redo the process of erase, rebuild, and reload.</p>
-</div>
-</div>
-<div class="section" id="miscellaneous">
-<h2><a class="toc-backref" href="#id37">Miscellaneous</a><a class="headerlink" href="#miscellaneous" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="enable-trace-in-mynewt">
-<h3><a class="toc-backref" href="#id38">Enable Trace in Mynewt</a><a class="headerlink" href="#enable-trace-in-mynewt" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I’m trying to use gdb with Trace, but do not know how to enable it. How do I do this in Mynewt?</p>
-<p><strong>A</strong>: To enable Trace, you can add <code class="docutils literal notranslate"><span class="pre">cflags</span></code> to <code class="docutils literal notranslate"><span class="pre">pkg.yml</span></code> in your target directory:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">~/dev/mynewt $ cat targets/mytarget/pkg.yml</span>
-<span class="gp">#</span><span class="c1">## Package: targets/mytarget</span>
-<span class="go">pkg.name: “targets/mytarget”</span>
-<span class="go">pkg.type: "target"</span>
-<span class="go">pkg.description:</span>
-<span class="go">pkg.author:</span>
-<span class="go">pkg.homepage:</span>
-<span class="go"></span>
-<span class="go">pkg.cflags:</span>
-<span class="go"> - -DENABLE_TRACE</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="version-control-applications-with-git">
-<h3><a class="toc-backref" href="#id39">Version Control Applications with Git</a><a class="headerlink" href="#version-control-applications-with-git" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: What’s the recommended way to work with git when you want to version control your application? As <code class="docutils literal notranslate"><span class="pre">apache-mynewt-core</span></code> is already a repository, there is a repo in repo problem. Are there any good alternatives/tools to submodules, mirror, etc? Ideally, I want to version control everything from the top level project directory as well as upgrading apache-mynewt-core, pushing pull requests back to Mynewt if needed, etc.</p>
-<p><strong>A</strong>: You can simply have a separate git for your app. For example, if you followed the Blinky tutorial, your git would be in <code class="docutils literal notranslate"><span class="pre">apps/foo</span></code>, while repos gits are in repos. You may also keep your app in the core repo, just have your own working branch for it.</p>
-<p>Another option is to have your git repository with local packages (including apps) and have <code class="docutils literal notranslate"><span class="pre">repository.yml</span></code> there so <code class="docutils literal notranslate"><span class="pre">newt</span> <span class="pre">install</span></code> can download all dependencies. Just make sure to put e.g. <code class="docutils literal notranslate"><span class="pre">bin</span></code>, <code class="docutils literal notranslate"><span class="pre">repos</span></code>, and <code class="docutils literal notranslate"><span class="pre">project.state</span></code>, and others in <code class="docutils literal notranslate"><span class="pre">.gitignore</span></code> so they are not in version control.</p>
-</div>
-<div class="section" id="alternatives-to-cmsis-nvic-c">
-<h3><a class="toc-backref" href="#id40">Alternatives to <code class="docutils literal notranslate"><span class="pre">cmsis_nvic.c</span></code></a><a class="headerlink" href="#alternatives-to-cmsis-nvic-c" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: What do I use instead of the full version of <code class="docutils literal notranslate"><span class="pre">cmsis_nvic.c</span></code> (i.e. for setting and getting irq priorities)?</p>
-<p><strong>A</strong>: Those functions are in the <code class="docutils literal notranslate"><span class="pre">core_cmx.h</span></code> files in <code class="docutils literal notranslate"><span class="pre">hw/cmsis-core</span></code>.</p>
-</div>
-<div class="section" id="inverted-pin-value-on-nrf52-dk">
-<h3><a class="toc-backref" href="#id41">Inverted Pin Value on nRF52-DK</a><a class="headerlink" href="#inverted-pin-value-on-nrf52-dk" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: I’ve been experiencing what seems to be some oddities with <code class="docutils literal notranslate"><span class="pre">hal_gpio_write</span></code>. It appears as though the LED pin value on the nRF52-DK is inverted (0 sets the pin high, 1 sets it low). I am checking the GPIO state by turning an LED on and off. Why is this the case?</p>
-<p><strong>A</strong>: LEDs on the nRF52-DK are connected to VDD and GPIO so you need to set GPIO to a low state in order to make it turn on.</p>
-</div>
-<div class="section" id="documentation-on-correct-values-for-ble-gap-disc-params">
-<h3><a class="toc-backref" href="#id42">Documentation on Correct Values for <code class="docutils literal notranslate"><span class="pre">ble_gap_disc_params</span></code></a><a class="headerlink" href="#documentation-on-correct-values-for-ble-gap-disc-params" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Is there documentation somewhere on correct values for <code class="docutils literal notranslate"><span class="pre">ble_gap_disc_params</span></code>? I’m trying to do a passive discovery and getting <code class="docutils literal notranslate"><span class="pre">BLE_HS_EINVAL</span></code>.</p>
-<p><strong>A</strong>: Unfortunately, not at the moment. Here is a brief description of the fields:</p>
-<ul class="simple">
-<li><code class="docutils literal notranslate"><span class="pre">itvl</span></code>: This is defined as the time interval from when the Controller started its last LE scan until it begins the subsequent LE scan. (units=0.625 msec)</li>
-<li><code class="docutils literal notranslate"><span class="pre">window</span></code>: The duration of the LE scan. <code class="docutils literal notranslate"><span class="pre">LE_Scan_Window</span></code> shall be less than or equal to <code class="docutils literal notranslate"><span class="pre">LE_Scan_Interval</span></code> (units=0.625 msec)</li>
-<li><code class="docutils literal notranslate"><span class="pre">filter_policy</span></code>: The only useful documentation is the table in the Bluetooth spec (section 2.E.7.8.10). This field controls which types of devices to listen for.</li>
-<li><code class="docutils literal notranslate"><span class="pre">limited</span></code>: If set, only discover devices in limited discoverable mode.</li>
-<li><code class="docutils literal notranslate"><span class="pre">passive</span></code>: If set, don’t send scan requests to advertisers (i.e., don’t request additional advertising data).</li>
-<li><code class="docutils literal notranslate"><span class="pre">filter_duplicates</span></code>: If set, the controller ignores all but the first advertisement from each device.</li>
-</ul>
-</div>
-<div class="section" id="time-precision-on-nrf52">
-<h3><a class="toc-backref" href="#id43">Time Precision on nRF52</a><a class="headerlink" href="#time-precision-on-nrf52" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Can <code class="docutils literal notranslate"><span class="pre">OS_TICKS_PER_SEC</span></code> be changed per app? I’m on the nRF52 and I need better time precision than 128Hz.</p>
-<p><strong>A</strong>: No, it isn’t possible to change the ticks per second for a single app. That constant is defined to be most efficient for the particular MCU.</p>
-<p>If you need precision, the OS tick timer is probably not the right thing to use. Take a look at <a class="reference internal" href="os/core_os/cputime/os_cputime.html"><span class="doc">CPU Time</span></a> for timer documentation. <code class="docutils literal notranslate"><span class="pre">os_cputime</span></code> has 1MHz frequency by default, and is enabled by default. It is recommended to use this for higher precision applications.</p>
-</div>
-<div class="section" id="multicast-messaging-and-group-messaging">
-<h3><a class="toc-backref" href="#id44">Multicast Messaging and Group Messaging</a><a class="headerlink" href="#multicast-messaging-and-group-messaging" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Is it possible to send a broadcast message by one of the devices present in the mesh (e.g. broadcast an event which happened)? Something like a push notification instead of continuously polling for it by a client.</p>
-<p><strong>A</strong>: It is possible to do so with a publish model. Group address or virtual address should help here, according to the Mesh spec. There is no real documentation on it but you can try it out on our <code class="docutils literal notranslate"><span class="pre">btmesh_shell</span></code> app. There is a <code class="docutils literal notranslate"><span class="pre">shell.c</span></code> file which exposes configuration client which you can use for testing (e.g. you can subscribe to virtual addresses). You can also trigger sending messages to devices. By playing with the <code class="docutils literal notranslate"><span class="pre">dst</span></code> command, you probably should be able to set destination to some group. However, since we do not support the provisioner role, there is a command provision which sets fixed keys so you can create a mesh network out of a couple of nodes without the actual provisioner.</p>
-</div>
-<div class="section" id="difference-between-compiler-yml-vs-pkg-yml">
-<h3><a class="toc-backref" href="#id45">Difference between <code class="docutils literal notranslate"><span class="pre">compiler.yml</span></code> vs. <code class="docutils literal notranslate"><span class="pre">pkg.yml</span></code></a><a class="headerlink" href="#difference-between-compiler-yml-vs-pkg-yml" title="Permalink to this headline">¶</a></h3>
-<p><code class="docutils literal notranslate"><span class="pre">compiler.yml</span></code> defines a compiler. <code class="docutils literal notranslate"><span class="pre">pkg.yml</span></code> contains metadata about the package. All packages have a <code class="docutils literal notranslate"><span class="pre">pkg.yml</span></code> file, even compiler packages.</p>
-</div>
-<div class="section" id="drivers-in-mynewt">
-<h3><a class="toc-backref" href="#id46">Drivers in Mynewt</a><a class="headerlink" href="#drivers-in-mynewt" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: Is this a correct assumption about Mynewt, that if there exists no driver implementation for a specific SoC, in <code class="docutils literal notranslate"><span class="pre">hw/drivers/</span></code>, then it is not supported. For instance, there exists a flash driver for <code class="docutils literal notranslate"><span class="pre">at45db</span></code>, this implies that the Nordic nRF52 SoC is not supported at the moment?</p>
-<p><strong>A</strong>: <code class="docutils literal notranslate"><span class="pre">at45db</span></code> is SPI, and any SPI would work. You send SPI configuration info when initializing. SPI drivers are below the <code class="docutils literal notranslate"><span class="pre">hw/mcu/</span></code> tree. <code class="docutils literal notranslate"><span class="pre">hw/drivers/pwm</span></code> and <code class="docutils literal notranslate"><span class="pre">hw/drivers/adc</span></code> are SoC specific. In general, drivers are for peripherals that aren’t universally supported. Features that all (or nearly all) MCUs support are implemented in the HAL. For example, internal flash support is a HAL feature. Visit the <a class="reference internal" href="os/modules/hal/hal.html"><span class="doc">HAL Documentation</span></a> for more information.</p>
-</div>
-<div class="section" id="reduce-code-size-for-mynewt-image">
-<h3><a class="toc-backref" href="#id47">Reduce Code Size for Mynewt Image</a><a class="headerlink" href="#reduce-code-size-for-mynewt-image" title="Permalink to this headline">¶</a></h3>
-<p><strong>Q</strong>: How do I reduce the code size for my Mynewt image?</p>
-<p><strong>A</strong>: Please refer to the tutorial documentation on <a class="reference internal" href="tutorials/other/codesize.html"><span class="doc">reducing application code size</span></a>.</p>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="misc/index.html" class="btn btn-neutral float-right" title="Appendix" accesskey="n">Next: Appendix <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="newtmgr/install/prev_releases.html" class="btn btn-neutral" title="Installing Previous Releases of Newtmgr" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Installing Previous Releases of Newtmgr</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'./',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="_static/js/affix.js"></script>
- <script type="text/javascript" src="_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/README.html b/develop/network/docs/README.html
deleted file mode 100644
index b2d03b5fa..000000000
--- a/develop/network/docs/README.html
+++ /dev/null
@@ -1,346 +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">
-
-
-
-
- <title>NimBLE Bluetooth Stack Documentation — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../genindex.html"/>
- <link rel="search" title="Search" href="../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../index.html"/>
-
-
- <script src="../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- NimBLE Bluetooth Stack Documentation
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/README.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul>
-<li class="toctree-l1"><a class="reference internal" href="../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="nimble-bluetooth-stack-documentation">
-<h1><a class="toc-backref" href="#id1">NimBLE Bluetooth Stack Documentation</a><a class="headerlink" href="#nimble-bluetooth-stack-documentation" title="Permalink to this headline">¶</a></h1>
-<p>This folder holds the documentation for the NimBLE Bluetooth stack from the
-<a class="reference external" href="https://mynewt.apache.org/">Apache Mynewt</a> project. It is built using <a class="reference external" href="http://www.sphinx-doc.org/">Sphinx</a>.
-The source code also contains inline comments in <a class="reference external" href="http://www.doxygen.org/">Doxygen</a>
-format to document the APIs.</p>
-<p>The complete project documentation can be found at <a class="reference external" href="https://github.com/apache/mynewt-documentation">mynewt documentation</a></p>
-<div class="contents topic" id="contents">
-<p class="topic-title first">Contents</p>
-<ul class="simple">
-<li><a class="reference internal" href="#nimble-bluetooth-stack-documentation" id="id1">NimBLE Bluetooth Stack Documentation</a><ul>
-<li><a class="reference internal" href="#writing-documentation" id="id2">Writing Documentation</a></li>
-<li><a class="reference internal" href="#previewing-changes" id="id3">Previewing Changes</a></li>
-</ul>
-</li>
-</ul>
-</div>
-<div class="section" id="writing-documentation">
-<h2><a class="toc-backref" href="#id2">Writing Documentation</a><a class="headerlink" href="#writing-documentation" title="Permalink to this headline">¶</a></h2>
-<p>See: <a class="reference external" href="https://github.com/apache/mynewt-documentation#writing-documentation">https://github.com/apache/mynewt-documentation#writing-documentation</a></p>
-</div>
-<div class="section" id="previewing-changes">
-<h2><a class="toc-backref" href="#id3">Previewing Changes</a><a class="headerlink" href="#previewing-changes" title="Permalink to this headline">¶</a></h2>
-<p>In order to preview any changes you make you must first install a Sphinx
-toolchain as described at <a class="reference external" href="https://github.com/apache/mynewt-documentation#id3">https://github.com/apache/mynewt-documentation#id3</a>.</p>
-<blockquote>
-<div>Then:</div></blockquote>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ <span class="nb">cd</span> docs
-$ make clean <span class="o">&&</span> make preview <span class="o">&&</span> <span class="o">(</span><span class="nb">cd</span> _build/html <span class="o">&&</span> python -m SimpleHTTPServer <span class="m">8080</span><span class="o">)</span>
-</pre></div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_hs/ble_att.html b/develop/network/docs/ble_hs/ble_att.html
deleted file mode 100644
index d7a0e5c19..000000000
--- a/develop/network/docs/ble_hs/ble_att.html
+++ /dev/null
@@ -1,364 +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">
-
-
-
-
- <title>NimBLE Host ATT Client Reference — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="NimBLE Host" href="ble_hs.html"/>
- <link rel="next" title="API for btshell app" href="../btshell/btshell_api.html"/>
- <link rel="prev" title="NimBLE Host Identity Reference" href="ble_hs_id.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="ble_hs.html">NimBLE Host</a> /
-
- NimBLE Host ATT Client Reference
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_hs/ble_att.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="ble_hs.html">NimBLE Host</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_return_codes.html">Return Codes</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gap.html">GAP</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gattc.html">GATT Client</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gatts.html">GATT Server</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_id.html">Identity</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">ATT</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="nimble-host-att-client-reference">
-<h1>NimBLE Host ATT Client Reference<a class="headerlink" href="#nimble-host-att-client-reference" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="introduction">
-<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
-<p>The Attribute Protocol (ATT) is a mid-level protocol that all BLE devices use to exchange data. Data is exchanged when
-an ATT client reads or writes an attribute belonging to an ATT server. Any device that needs to send or receive data
-must support both the client and server functionality of the ATT protocol. The only devices which do not support ATT
-are the most basic ones: broadcasters and observers (i.e., beaconing devices and listening devices).</p>
-<p>Most ATT functionality is not interesting to an application. Rather than use ATT directly, an application uses the
-higher level GATT profile, which sits directly above ATT in the host. NimBLE exposes the few bits of ATT functionality
-which are not encompassed by higher level GATT functions. This section documents the ATT functionality that the NimBLE
-host exposes to the application.</p>
-</div>
-<div class="section" id="header">
-<h2>Header<a class="headerlink" href="#header" title="Permalink to this headline">¶</a></h2>
-<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">"host/ble_hs.h"</span><span class="cp"></span>
-</pre></div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="../btshell/btshell_api.html" class="btn btn-neutral float-right" title="API for btshell app" accesskey="n">Next: API for btshell app <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="ble_hs_id.html" class="btn btn-neutral" title="NimBLE Host Identity Reference" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: NimBLE Host Identity Reference</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_hs/ble_gap.html b/develop/network/docs/ble_hs/ble_gap.html
deleted file mode 100644
index 2a73c4f63..000000000
--- a/develop/network/docs/ble_hs/ble_gap.html
+++ /dev/null
@@ -1,357 +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">
-
-
-
-
- <title>NimBLE Host GAP Reference — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="NimBLE Host" href="ble_hs.html"/>
- <link rel="next" title="NimBLE Host GATT Client Reference" href="ble_gattc.html"/>
- <link rel="prev" title="NimBLE Host Return Codes" href="ble_hs_return_codes.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="ble_hs.html">NimBLE Host</a> /
-
- NimBLE Host GAP Reference
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_hs/ble_gap.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="ble_hs.html">NimBLE Host</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_return_codes.html">Return Codes</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">GAP</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gattc.html">GATT Client</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gatts.html">GATT Server</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_id.html">Identity</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_att.html">ATT</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="nimble-host-gap-reference">
-<h1>NimBLE Host GAP Reference<a class="headerlink" href="#nimble-host-gap-reference" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="introduction">
-<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
-<p>The Generic Access Profile (GAP) is responsible for all connecting, advertising, scanning, and connection updating operations.</p>
-</div>
-<div class="section" id="header">
-<h2>Header<a class="headerlink" href="#header" title="Permalink to this headline">¶</a></h2>
-<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">"host/ble_hs.h"</span><span class="cp"></span>
-</pre></div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_gattc.html" class="btn btn-neutral float-right" title="NimBLE Host GATT Client Reference" accesskey="n">Next: NimBLE Host GATT Client Reference <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="ble_hs_return_codes.html" class="btn btn-neutral" title="NimBLE Host Return Codes" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: NimBLE Host Return Codes</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_hs/ble_gattc.html b/develop/network/docs/ble_hs/ble_gattc.html
deleted file mode 100644
index 176375e54..000000000
--- a/develop/network/docs/ble_hs/ble_gattc.html
+++ /dev/null
@@ -1,358 +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">
-
-
-
-
- <title>NimBLE Host GATT Client Reference — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="NimBLE Host" href="ble_hs.html"/>
- <link rel="next" title="NimBLE Host GATT Server Reference" href="ble_gatts.html"/>
- <link rel="prev" title="NimBLE Host GAP Reference" href="ble_gap.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="ble_hs.html">NimBLE Host</a> /
-
- NimBLE Host GATT Client Reference
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_hs/ble_gattc.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="ble_hs.html">NimBLE Host</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_return_codes.html">Return Codes</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gap.html">GAP</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">GATT Client</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gatts.html">GATT Server</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_id.html">Identity</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_att.html">ATT</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="nimble-host-gatt-client-reference">
-<h1>NimBLE Host GATT Client Reference<a class="headerlink" href="#nimble-host-gatt-client-reference" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="introduction">
-<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
-<p>The Generic Attribute Profile (GATT) manages all activities involving services, characteristics, and descriptors. The
-client half of the GATT API initiates GATT procedures.</p>
-</div>
-<div class="section" id="header">
-<h2>Header<a class="headerlink" href="#header" title="Permalink to this headline">¶</a></h2>
-<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">"host/ble_hs.h"</span><span class="cp"></span>
-</pre></div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_gatts.html" class="btn btn-neutral float-right" title="NimBLE Host GATT Server Reference" accesskey="n">Next: NimBLE Host GATT Server Reference <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="ble_gap.html" class="btn btn-neutral" title="NimBLE Host GAP Reference" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: NimBLE Host GAP Reference</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_hs/ble_gatts.html b/develop/network/docs/ble_hs/ble_gatts.html
deleted file mode 100644
index 2b67b3e7e..000000000
--- a/develop/network/docs/ble_hs/ble_gatts.html
+++ /dev/null
@@ -1,358 +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">
-
-
-
-
- <title>NimBLE Host GATT Server Reference — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="NimBLE Host" href="ble_hs.html"/>
- <link rel="next" title="NimBLE Host Identity Reference" href="ble_hs_id.html"/>
- <link rel="prev" title="NimBLE Host GATT Client Reference" href="ble_gattc.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="ble_hs.html">NimBLE Host</a> /
-
- NimBLE Host GATT Server Reference
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_hs/ble_gatts.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="ble_hs.html">NimBLE Host</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_return_codes.html">Return Codes</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gap.html">GAP</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gattc.html">GATT Client</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">GATT Server</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_id.html">Identity</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_att.html">ATT</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="nimble-host-gatt-server-reference">
-<h1>NimBLE Host GATT Server Reference<a class="headerlink" href="#nimble-host-gatt-server-reference" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="introduction">
-<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
-<p>The Generic Attribute Profile (GATT) manages all activities involving services, characteristics, and descriptors. The
-server half of the GATT API handles registration and responding to GATT clients.</p>
-</div>
-<div class="section" id="header">
-<h2>Header<a class="headerlink" href="#header" title="Permalink to this headline">¶</a></h2>
-<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">"host/ble_hs.h"</span><span class="cp"></span>
-</pre></div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_hs_id.html" class="btn btn-neutral float-right" title="NimBLE Host Identity Reference" accesskey="n">Next: NimBLE Host Identity Reference <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="ble_gattc.html" class="btn btn-neutral" title="NimBLE Host GATT Client Reference" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: NimBLE Host GATT Client Reference</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_hs/ble_hs.html b/develop/network/docs/ble_hs/ble_hs.html
deleted file mode 100644
index 4cee664eb..000000000
--- a/develop/network/docs/ble_hs/ble_hs.html
+++ /dev/null
@@ -1,368 +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">
-
-
-
-
- <title>NimBLE Host — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="BLE User Guide" href="../index.html"/>
- <link rel="next" title="NimBLE Host Return Codes" href="ble_hs_return_codes.html"/>
- <link rel="prev" title="Respond to sync and reset events" href="../ble_setup/ble_sync_cb.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- NimBLE Host
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_hs/ble_hs.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">NimBLE Host</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_return_codes.html">Return Codes</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gap.html">GAP</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gattc.html">GATT Client</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gatts.html">GATT Server</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_id.html">Identity</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_att.html">ATT</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="nimble-host">
-<h1>NimBLE Host<a class="headerlink" href="#nimble-host" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="introduction">
-<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
-<p>At a high level, the NimBLE stack is divided into two components:</p>
-<ul class="simple">
-<li>Host</li>
-<li>Controller</li>
-</ul>
-<p>This document is an API reference for the host component. If you are
-interested in the general structure of the NimBLE stack and its non-host
-components, you might want to read the <a class="reference internal" href="../index.html"><span class="doc">BLE User Guide</span></a>.</p>
-<p>The host sits directly below the application, and it serves as the
-interface to the application for all BLE operations.</p>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="ble_hs_return_codes.html">Return Codes</a></li>
-<li class="toctree-l1"><a class="reference internal" href="ble_gap.html">GAP</a></li>
-<li class="toctree-l1"><a class="reference internal" href="ble_gattc.html">GATT Client</a></li>
-<li class="toctree-l1"><a class="reference internal" href="ble_gatts.html">GATT Server</a></li>
-<li class="toctree-l1"><a class="reference internal" href="ble_hs_id.html">Identity</a></li>
-<li class="toctree-l1"><a class="reference internal" href="ble_att.html">ATT</a></li>
-</ul>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_hs_return_codes.html" class="btn btn-neutral float-right" title="NimBLE Host Return Codes" accesskey="n">Next: NimBLE Host Return Codes <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="../ble_setup/ble_sync_cb.html" class="btn btn-neutral" title="Respond to sync and reset events" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Respond to sync and reset events</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_hs/ble_hs_id.html b/develop/network/docs/ble_hs/ble_hs_id.html
deleted file mode 100644
index 5b60ae89b..000000000
--- a/develop/network/docs/ble_hs/ble_hs_id.html
+++ /dev/null
@@ -1,408 +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">
-
-
-
-
- <title>NimBLE Host Identity Reference — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="NimBLE Host" href="ble_hs.html"/>
- <link rel="next" title="NimBLE Host ATT Client Reference" href="ble_att.html"/>
- <link rel="prev" title="NimBLE Host GATT Server Reference" href="ble_gatts.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="ble_hs.html">NimBLE Host</a> /
-
- NimBLE Host Identity Reference
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_hs/ble_hs_id.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="ble_hs.html">NimBLE Host</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_return_codes.html">Return Codes</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gap.html">GAP</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gattc.html">GATT Client</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gatts.html">GATT Server</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">Identity</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_att.html">ATT</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="nimble-host-identity-reference">
-<h1>NimBLE Host Identity Reference<a class="headerlink" href="#nimble-host-identity-reference" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="introduction">
-<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
-<p>The identity API provides facilities for querying and configuring your device’s addresses. BLE’s addressing scheme is
-quite involved; the summary that follows is only a brief introduction.</p>
-<p>BLE defines four address types:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="17%" />
-<col width="52%" />
-<col width="7%" />
-<col width="24%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">Type</th>
-<th class="head">Description</th>
-<th class="head">Identity?</th>
-<th class="head">Configured with</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>Public</td>
-<td>Address assigned by manufacturer; the three most significant bytes form the manufacturer’s OUI.</td>
-<td>Yes</td>
-<td>N/A; read from controller at startup.</td>
-</tr>
-<tr class="row-odd"><td>Static random</td>
-<td>Randomly generated address.</td>
-<td>Yes</td>
-<td><em>ble_hs_id_set_rnd()</em></td>
-</tr>
-<tr class="row-even"><td>Resolvable private (RPA)</td>
-<td>Address randomly generated from an identity address and an identity resolving key (IRK).</td>
-<td>No</td>
-<td>N/A; generated by controller periodically.</td>
-</tr>
-<tr class="row-odd"><td>Non-resolvable private (NRPA)</td>
-<td>Randomly generated address.</td>
-<td>No</td>
-<td><em>ble_hs_id_set_rnd()</em></td>
-</tr>
-</tbody>
-</table>
-<div class="section" id="identity-addresses">
-<h3>Identity Addresses<a class="headerlink" href="#identity-addresses" title="Permalink to this headline">¶</a></h3>
-<p>The third column in the above table indicates the <em>identity</em> property of each address type. An identity address never
-changes, and a device can be identified by one of its unique identity addresses.</p>
-<p>Non-identity addresses are used by devices supporting BLE privacy. A device using the privacy feature frequently changes
-its own address to a newly-generated non-identity address. By cycling its address, the device makes it impossible for
-eavesdroppers to track its location.</p>
-<p>A device can have up to two identity addresses at once: one public and one static random. As indicated in the above table,
-the public identity address cannot be configured; the static random identity address can be set by calling <em>ble_hs_id_set_rnd()</em>.</p>
-<p>The address type is selected on a per-GAP-procedure basis. Each time you initiate a GAP procedure, you indicate which
-address type the device should use for the duration of the procedure.</p>
-</div>
-</div>
-<div class="section" id="header">
-<h2>Header<a class="headerlink" href="#header" title="Permalink to this headline">¶</a></h2>
-<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">"host/ble_hs.h"</span><span class="cp"></span>
-</pre></div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_att.html" class="btn btn-neutral float-right" title="NimBLE Host ATT Client Reference" accesskey="n">Next: NimBLE Host ATT Client Reference <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="ble_gatts.html" class="btn btn-neutral" title="NimBLE Host GATT Server Reference" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: NimBLE Host GATT Server Reference</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_hs/ble_hs_return_codes.html b/develop/network/docs/ble_hs/ble_hs_return_codes.html
deleted file mode 100644
index 992f95d43..000000000
--- a/develop/network/docs/ble_hs/ble_hs_return_codes.html
+++ /dev/null
@@ -1,1297 +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">
-
-
-
-
- <title>NimBLE Host Return Codes — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="NimBLE Host" href="ble_hs.html"/>
- <link rel="next" title="NimBLE Host GAP Reference" href="ble_gap.html"/>
- <link rel="prev" title="NimBLE Host" href="ble_hs.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="ble_hs.html">NimBLE Host</a> /
-
- NimBLE Host Return Codes
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_hs/ble_hs_return_codes.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="ble_hs.html">NimBLE Host</a><ul class="current">
-<li class="toctree-l3 current"><a class="current reference internal" href="#">Return Codes</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gap.html">GAP</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gattc.html">GATT Client</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_gatts.html">GATT Server</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_hs_id.html">Identity</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_att.html">ATT</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="nimble-host-return-codes">
-<h1>NimBLE Host Return Codes<a class="headerlink" href="#nimble-host-return-codes" title="Permalink to this headline">¶</a></h1>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#introduction" id="id1">Introduction</a><ul>
-<li><a class="reference internal" href="#summary" id="id2">Summary</a></li>
-<li><a class="reference internal" href="#example" id="id3">Example</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#return-code-reference" id="id4">Return Code Reference</a><ul>
-<li><a class="reference internal" href="#header" id="id5">Header</a></li>
-<li><a class="reference internal" href="#return-codes-core" id="id6">Return codes - Core</a></li>
-<li><a class="reference internal" href="#return-codes-att" id="id7">Return codes - ATT</a></li>
-<li><a class="reference internal" href="#return-codes-hci" id="id8">Return codes - HCI</a></li>
-<li><a class="reference internal" href="#return-codes-l2cap" id="id9">Return codes - L2CAP</a></li>
-<li><a class="reference internal" href="#return-codes-security-manager-us" id="id10">Return codes - Security manager (us)</a></li>
-<li><a class="reference internal" href="#return-codes-security-manager-peer" id="id11">Return codes - Security manager (peer)</a></li>
-</ul>
-</li>
-</ul>
-</div>
-<div class="section" id="introduction">
-<h2><a class="toc-backref" href="#id1">Introduction</a><a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="summary">
-<h3><a class="toc-backref" href="#id2">Summary</a><a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h3>
-<p>The NimBLE host reports status to the application via a set of return codes. The host encompasses several layers of the Bluetooth specification that each defines its own set of status codes. Rather than “abstract away” information from lower layers that the application developer might find useful, the NimBLE host aims to indicate precisely what happened when something fails. Consequently, the host utilizes a rather large set of return codes.</p>
-<p>A return code of 0 indicates success. For failure conditions, the return codes are partitioned into five separate sets:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="12%" />
-<col width="88%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">Set</th>
-<th class="head">Condition</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>Core</td>
-<td>Errors detected internally by the NimBLE host.</td>
-</tr>
-<tr class="row-odd"><td>ATT</td>
-<td>The ATT server has reported a failure via the transmission of an ATT Error Response. The return code corresponds to the value of the Error Code field in the response.</td>
-</tr>
-<tr class="row-even"><td>HCI</td>
-<td>The controller has reported an error to the host via a command complete or command status HCI event. The return code corresponds to the value of the Status field in the event.</td>
-</tr>
-<tr class="row-odd"><td>L2CAP</td>
-<td>An L2CAP signaling procedure has failed and an L2CAP Command Reject was sent as a result. The return code corresponds to the value of the Reason field in the command.</td>
-</tr>
-<tr class="row-even"><td>Security manager (us)</td>
-<td>The host detected an error during a security manager procedure and sent a Pairing Failed command to the peer. The return code corresponds to the value of the Reason field in the Pairing Failed command.</td>
-</tr>
-<tr class="row-odd"><td>Security manager (peer)</td>
-<td>A security manager procedure failed because the peer sent us a Pairing Failed command. The return code corresponds to the value of the Reason field in the Pairing Failed command.</td>
-</tr>
-</tbody>
-</table>
-<p>The return codes in the core set are defined by the NimBLE Host. The other sets are defined in the Bluetooth specification; the codes in this latter group are referred to as <em>formal status codes</em>. As defined in the Bluetooth specification, the formal status code sets are not disjoint. That is, they overlap. For example, the spec defines a status code of 1 to have all of the following meanings:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="24%" />
-<col width="76%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">Layer</th>
-<th class="head">Meaning</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>ATT</td>
-<td>Invalid handle.</td>
-</tr>
-<tr class="row-odd"><td>HCI</td>
-<td>Unknown HCI command.</td>
-</tr>
-<tr class="row-even"><td>L2CAP</td>
-<td>Signalling MTU exceeded.</td>
-</tr>
-<tr class="row-odd"><td>SM</td>
-<td>Passkey entry failed.</td>
-</tr>
-</tbody>
-</table>
-<p>Clearly, the host can’t just return an unadorned formal status code and expect the application to make sense of it. To resolve this ambiguity, the NimBLE host divides the full range of an int into several subranges. Each subrange corresponds to one of the five return code sets. For example, the ATT set is mapped onto the subrange <em>[0x100, 0x200)</em>. To indicate an ATT error of 3 (write not permitted), the NimBLE host returns a value 0x103 to the application.</p>
-<p>The host defines a set of convenience macros for converting from a formal status code to NimBLE host status code. These macros are documented in the table below.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="41%" />
-<col width="39%" />
-<col width="20%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">Macro</th>
-<th class="head">Status code set</th>
-<th class="head">Base value</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>BLE_HS_ATT_ERR()</td>
-<td>ATT</td>
-<td>0x100</td>
-</tr>
-<tr class="row-odd"><td>BLE_HS_HCI_ERR()</td>
-<td>HCI</td>
-<td>0x200</td>
-</tr>
-<tr class="row-even"><td>BLE_HS_L2C_ERR()</td>
-<td>L2CAP</td>
-<td>0x300</td>
-</tr>
-<tr class="row-odd"><td>BLE_HS_SM_US_ERR()</td>
-<td>Security manager (us)</td>
-<td>0x400</td>
-</tr>
-<tr class="row-even"><td>BLE_HS_SM_PEER_ERR()</td>
-<td>Security manager (peer)</td>
-<td>0x500</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="example">
-<h3><a class="toc-backref" href="#id3">Example</a><a class="headerlink" href="#example" title="Permalink to this headline">¶</a></h3>
-<p>The following example demonstrates how an application might determine which error is being reported by the host. In this example, the application performs the GAP encryption procedure and checks the return code. To simplify the example, the application uses a hypothetical <em>my_blocking_enc_proc()</em> function, which blocks until the pairing operation has completed.</p>
-<div class="code c highlight-none notranslate"><div class="highlight"><pre><span></span>void
-encrypt_connection(uint16_t conn_handle)
-{
- int rc;
-
- /* Perform a blocking GAP encryption procedure. */
- rc = my_blocking_enc_proc(conn_handle);
- switch (rc) {
- case 0:
- console_printf("success - link successfully encrypted\n");
- break;
-
- case BLE_HS_ENOTCONN:
- console_printf("failure - no connection with handle %d\n",
- conn_handle);
- break;
-
- case BLE_HS_ERR_SM_US_BASE(BLE_SM_ERR_CONFIRM_MISMATCH):
- console_printf("failure - mismatch in peer's confirm and random "
- "commands.\n");
- break;
-
- case BLE_HS_ERR_SM_PEER_BASE(BLE_SM_ERR_CONFIRM_MISMATCH):
- console_printf("failure - peer reports mismatch in our confirm and "
- "random commands.\n");
- break;
-
- default:
- console_printf("failure - other error: 0x%04x\n", rc);
- break;
- }
-}
-</pre></div>
-</div>
-</div>
-</div>
-<div class="section" id="return-code-reference">
-<h2><a class="toc-backref" href="#id4">Return Code Reference</a><a class="headerlink" href="#return-code-reference" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="header">
-<h3><a class="toc-backref" href="#id5">Header</a><a class="headerlink" href="#header" title="Permalink to this headline">¶</a></h3>
-<p>All NimBLE host return codes are made accessible by including the following header:</p>
-<div class="code c highlight-none notranslate"><div class="highlight"><pre><span></span>#include "host/ble_hs.h"
-</pre></div>
-</div>
-</div>
-<div class="section" id="return-codes-core">
-<h3><a class="toc-backref" href="#id6">Return codes - Core</a><a class="headerlink" href="#return-codes-core" title="Permalink to this headline">¶</a></h3>
-<p>The precise meaning of each of these error codes depends on the function that returns it.
-The API reference for a particular function indicates the conditions under which each of these codes are returned.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="7%" />
-<col width="23%" />
-<col width="70%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">Value</th>
-<th class="head">Name</th>
-<th class="head">Condition</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>0x00</td>
-<td><em>N/A</em></td>
-<td>Success</td>
-</tr>
-<tr class="row-odd"><td>0x01</td>
-<td>BLE_HS_EAGAIN</td>
-<td>Temporary failure; try again.</td>
-</tr>
-<tr class="row-even"><td>0x02</td>
-<td>BLE_HS_EALREADY</td>
-<td>Operation already in progress or completed.</td>
-</tr>
-<tr class="row-odd"><td>0x03</td>
-<td>BLE_HS_EINVAL</td>
-<td>One or more arguments are invalid.</td>
-</tr>
-<tr class="row-even"><td>0x04</td>
-<td>BLE_HS_EMSGSIZE</td>
-<td>The provided buffer is too small.</td>
-</tr>
-<tr class="row-odd"><td>0x05</td>
-<td>BLE_HS_ENOENT</td>
-<td>No entry matching the specified criteria.</td>
-</tr>
-<tr class="row-even"><td>0x06</td>
-<td>BLE_HS_ENOMEM</td>
-<td>Operation failed due to resource exhaustion.</td>
-</tr>
-<tr class="row-odd"><td>0x07</td>
-<td>BLE_HS_ENOTCONN</td>
-<td>No open connection with the specified handle.</td>
-</tr>
-<tr class="row-even"><td>0x08</td>
-<td>BLE_HS_ENOTSUP</td>
-<td>Operation disabled at compile time.</td>
-</tr>
-<tr class="row-odd"><td>0x09</td>
-<td>BLE_HS_EAPP</td>
-<td>Application callback behaved unexpectedly.</td>
-</tr>
-<tr class="row-even"><td>0x0a</td>
-<td>BLE_HS_EBADDATA</td>
-<td>Command from peer is invalid.</td>
-</tr>
-<tr class="row-odd"><td>0x0b</td>
-<td>BLE_HS_EOS</td>
-<td>Mynewt OS error.</td>
-</tr>
-<tr class="row-even"><td>0x0c</td>
-<td>BLE_HS_ECONTROLLER</td>
-<td>Event from controller is invalid.</td>
-</tr>
-<tr class="row-odd"><td>0x0d</td>
-<td>BLE_HS_ETIMEOUT</td>
-<td>Operation timed out.</td>
-</tr>
-<tr class="row-even"><td>0x0e</td>
-<td>BLE_HS_EDONE</td>
-<td>Operation completed successfully.</td>
-</tr>
-<tr class="row-odd"><td>0x0f</td>
-<td>BLE_HS_EBUSY</td>
-<td>Operation cannot be performed until procedure completes.</td>
-</tr>
-<tr class="row-even"><td>0x10</td>
-<td>BLE_HS_EREJECT</td>
-<td>Peer rejected a connection parameter update request.</td>
-</tr>
-<tr class="row-odd"><td>0x11</td>
-<td>BLE_HS_EUNKNOWN</td>
-<td>Unexpected failure; catch all.</td>
-</tr>
-<tr class="row-even"><td>0x12</td>
-<td>BLE_HS_EROLE</td>
-<td>Operation requires different role (e.g., central vs. peripheral).</td>
-</tr>
-<tr class="row-odd"><td>0x13</td>
-<td>BLE_HS_ETIMEOUT_HCI</td>
-<td>HCI request timed out; controller unresponsive.</td>
-</tr>
-<tr class="row-even"><td>0x14</td>
-<td>BLE_HS_ENOMEM_EVT</td>
-<td>Controller failed to send event due to memory exhaustion (combined host-controller only).</td>
-</tr>
-<tr class="row-odd"><td>0x15</td>
-<td>BLE_HS_ENOADDR</td>
-<td>Operation requires an identity address but none configured.</td>
-</tr>
-<tr class="row-even"><td>0x16</td>
-<td>BLE_HS_ENOTSYNCED</td>
-<td>Attempt to use the host before it is synced with controller.</td>
-</tr>
-<tr class="row-odd"><td>0x17</td>
-<td>BLE_HS_EAUTHEN</td>
-<td>Insufficient authentication.</td>
-</tr>
-<tr class="row-even"><td>0x18</td>
-<td>BLE_HS_EAUTHOR</td>
-<td>Insufficient authorization.</td>
-</tr>
-<tr class="row-odd"><td>0x19</td>
-<td>BLE_HS_EENCRYPT</td>
-<td>Insufficient encryption level.</td>
-</tr>
-<tr class="row-even"><td>0x1a</td>
-<td>BLE_HS_EENCRYPT_KEY_SZ</td>
-<td>Insufficient key size.</td>
-</tr>
-<tr class="row-odd"><td>0x1b</td>
-<td>BLE_HS_ESTORE_CAP</td>
-<td>Storage at capacity.</td>
-</tr>
-<tr class="row-even"><td>0x1c</td>
-<td>BLE_HS_ESTORE_FAIL</td>
-<td>Storage IO error.</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="return-codes-att">
-<h3><a class="toc-backref" href="#id7">Return codes - ATT</a><a class="headerlink" href="#return-codes-att" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="7%" />
-<col width="7%" />
-<col width="20%" />
-<col width="65%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">NimBLE Value</th>
-<th class="head">Formal Value</th>
-<th class="head">Name</th>
-<th class="head">Condition</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>0x0101</td>
-<td>0x01</td>
-<td>BLE_ATT_ERR_INVALID_HANDLE</td>
-<td>The attribute handle given was not valid on this server.</td>
-</tr>
-<tr class="row-odd"><td>0x0102</td>
-<td>0x02</td>
-<td>BLE_ATT_ERR_READ_NOT_PERMITTED</td>
-<td>The attribute cannot be read.</td>
-</tr>
-<tr class="row-even"><td>0x0103</td>
-<td>0x03</td>
-<td>BLE_ATT_ERR_WRITE_NOT_PERMITTED</td>
-<td>The attribute cannot be written.</td>
-</tr>
-<tr class="row-odd"><td>0x0104</td>
-<td>0x04</td>
-<td>BLE_ATT_ERR_INVALID_PDU</td>
-<td>The attribute PDU was invalid.</td>
-</tr>
-<tr class="row-even"><td>0x0105</td>
-<td>0x05</td>
-<td>BLE_ATT_ERR_INSUFFICIENT_AUTHEN</td>
-<td>The attribute requires authentication before it can be read or written.</td>
-</tr>
-<tr class="row-odd"><td>0x0106</td>
-<td>0x06</td>
-<td>BLE_ATT_ERR_REQ_NOT_SUPPORTED</td>
-<td>Attribute server does not support the request received from the client.</td>
-</tr>
-<tr class="row-even"><td>0x0107</td>
-<td>0x07</td>
-<td>BLE_ATT_ERR_INVALID_OFFSET</td>
-<td>Offset specified was past the end of the attribute.</td>
-</tr>
-<tr class="row-odd"><td>0x0108</td>
-<td>0x08</td>
-<td>BLE_ATT_ERR_INSUFFICIENT_AUTHOR</td>
-<td>The attribute requires authorization before it can be read or written.</td>
-</tr>
-<tr class="row-even"><td>0x0109</td>
-<td>0x09</td>
-<td>BLE_ATT_ERR_PREPARE_QUEUE_FULL</td>
-<td>Too many prepare writes have been queued.</td>
-</tr>
-<tr class="row-odd"><td>0x010a</td>
-<td>0x0a</td>
-<td>BLE_ATT_ERR_ATTR_NOT_FOUND</td>
-<td>No attribute found within the given attribute handle range.</td>
-</tr>
-<tr class="row-even"><td>0x010b</td>
-<td>0x0b</td>
-<td>BLE_ATT_ERR_ATTR_NOT_LONG</td>
-<td>The attribute cannot be read or written using the Read Blob Request.</td>
-</tr>
-<tr class="row-odd"><td>0x010c</td>
-<td>0x0c</td>
-<td>BLE_ATT_ERR_INSUFFICIENT_KEY_SZ</td>
-<td>The Encryption Key Size used for encrypting this link is insufficient.</td>
-</tr>
-<tr class="row-even"><td>0x010d</td>
-<td>0x0d</td>
-<td>BLE_ATT_ERR_INVALID_ATTR_VALUE_LEN</td>
-<td>The attribute value length is invalid for the operation.</td>
-</tr>
-<tr class="row-odd"><td>0x010e</td>
-<td>0x0e</td>
-<td>BLE_ATT_ERR_UNLIKELY</td>
-<td>The attribute request that was requested has encountered an error that was unlikely, and therefore could not be completed as requested.</td>
-</tr>
-<tr class="row-even"><td>0x010f</td>
-<td>0x0f</td>
-<td>BLE_ATT_ERR_INSUFFICIENT_ENC</td>
-<td>The attribute requires encryption before it can be read or written.</td>
-</tr>
-<tr class="row-odd"><td>0x0110</td>
-<td>0x10</td>
-<td>BLE_ATT_ERR_UNSUPPORTED_GROUP</td>
-<td>The attribute type is not a supported grouping attribute as defined by a higher layer specification.</td>
-</tr>
-<tr class="row-even"><td>0x0111</td>
-<td>0x11</td>
-<td>BLE_ATT_ERR_INSUFFICIENT_RES</td>
-<td>Insufficient Resources to complete the request.</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="return-codes-hci">
-<h3><a class="toc-backref" href="#id8">Return codes - HCI</a><a class="headerlink" href="#return-codes-hci" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="11%" />
-<col width="11%" />
-<col width="24%" />
-<col width="54%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">NimBLE Value</th>
-<th class="head">Formal Value</th>
-<th class="head">Name</th>
-<th class="head">Condition</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>0x0201</td>
-<td>0x01</td>
-<td>BLE_ERR_UNKNOWN_HCI_CMD</td>
-<td>Unknown HCI Command</td>
-</tr>
-<tr class="row-odd"><td>0x0202</td>
-<td>0x02</td>
-<td>BLE_ERR_UNK_CONN_ID</td>
-<td>Unknown Connection Identifier</td>
-</tr>
-<tr class="row-even"><td>0x0203</td>
-<td>0x03</td>
-<td>BLE_ERR_HW_FAIL</td>
-<td>Hardware Failure</td>
-</tr>
-<tr class="row-odd"><td>0x0204</td>
-<td>0x04</td>
-<td>BLE_ERR_PAGE_TMO</td>
-<td>Page Timeout</td>
-</tr>
-<tr class="row-even"><td>0x0205</td>
-<td>0x05</td>
-<td>BLE_ERR_AUTH_FAIL</td>
-<td>Authentication Failure</td>
-</tr>
-<tr class="row-odd"><td>0x0206</td>
-<td>0x06</td>
-<td>BLE_ERR_PINKEY_MISSING</td>
-<td>PIN or Key Missing</td>
-</tr>
-<tr class="row-even"><td>0x0207</td>
-<td>0x07</td>
-<td>BLE_ERR_MEM_CAPACITY</td>
-<td>Memory Capacity Exceeded</td>
-</tr>
-<tr class="row-odd"><td>0x0208</td>
-<td>0x08</td>
-<td>BLE_ERR_CONN_SPVN_TMO</td>
-<td>Connection Timeout</td>
-</tr>
-<tr class="row-even"><td>0x0209</td>
-<td>0x09</td>
-<td>BLE_ERR_CONN_LIMIT</td>
-<td>Connection Limit Exceeded</td>
-</tr>
-<tr class="row-odd"><td>0x020a</td>
-<td>0x0a</td>
-<td>BLE_ERR_SYNCH_CONN_LIMIT</td>
-<td>Synchronous Connection Limit To A Device Exceeded</td>
-</tr>
-<tr class="row-even"><td>0x020b</td>
-<td>0x0b</td>
-<td>BLE_ERR_ACL_CONN_EXISTS</td>
-<td>ACL Connection Already Exists</td>
-</tr>
-<tr class="row-odd"><td>0x020c</td>
-<td>0x0c</td>
-<td>BLE_ERR_CMD_DISALLOWED</td>
-<td>Command Disallowed</td>
-</tr>
-<tr class="row-even"><td>0x020d</td>
-<td>0x0d</td>
-<td>BLE_ERR_CONN_REJ_RESOURCES</td>
-<td>Connection Rejected due to Limited Resources</td>
-</tr>
-<tr class="row-odd"><td>0x020e</td>
-<td>0x0e</td>
-<td>BLE_ERR_CONN_REJ_SECURITY</td>
-<td>Connection Rejected Due To Security Reasons</td>
-</tr>
-<tr class="row-even"><td>0x020f</td>
-<td>0x0f</td>
-<td>BLE_ERR_CONN_REJ_BD_ADDR</td>
-<td>Connection Rejected due to Unacceptable BD_ADDR</td>
-</tr>
-<tr class="row-odd"><td>0x0210</td>
-<td>0x10</td>
-<td>BLE_ERR_CONN_ACCEPT_TMO</td>
-<td>Connection Accept Timeout Exceeded</td>
-</tr>
-<tr class="row-even"><td>0x0211</td>
-<td>0x11</td>
-<td>BLE_ERR_UNSUPPORTED</td>
-<td>Unsupported Feature or Parameter Value</td>
-</tr>
-<tr class="row-odd"><td>0x0212</td>
-<td>0x12</td>
-<td>BLE_ERR_INV_HCI_CMD_PARMS</td>
-<td>Invalid HCI Command Parameters</td>
-</tr>
-<tr class="row-even"><td>0x0213</td>
-<td>0x13</td>
-<td>BLE_ERR_REM_USER_CONN_TERM</td>
-<td>Remote User Terminated Connection</td>
-</tr>
-<tr class="row-odd"><td>0x0214</td>
-<td>0x14</td>
-<td>BLE_ERR_RD_CONN_TERM_RESRCS</td>
-<td>Remote Device Terminated Connection due to Low Resources</td>
-</tr>
-<tr class="row-even"><td>0x0215</td>
-<td>0x15</td>
-<td>BLE_ERR_RD_CONN_TERM_PWROFF</td>
-<td>Remote Device Terminated Connection due to Power Off</td>
-</tr>
-<tr class="row-odd"><td>0x0216</td>
-<td>0x16</td>
-<td>BLE_ERR_CONN_TERM_LOCAL</td>
-<td>Connection Terminated By Local Host</td>
-</tr>
-<tr class="row-even"><td>0x0217</td>
-<td>0x17</td>
-<td>BLE_ERR_REPEATED_ATTEMPTS</td>
-<td>Repeated Attempts</td>
-</tr>
-<tr class="row-odd"><td>0x0218</td>
-<td>0x18</td>
-<td>BLE_ERR_NO_PAIRING</td>
-<td>Pairing Not Allowed</td>
-</tr>
-<tr class="row-even"><td>0x0219</td>
-<td>0x19</td>
-<td>BLE_ERR_UNK_LMP</td>
-<td>Unknown LMP PDU</td>
-</tr>
-<tr class="row-odd"><td>0x021a</td>
-<td>0x1a</td>
-<td>BLE_ERR_UNSUPP_REM_FEATURE</td>
-<td>Unsupported Remote Feature / Unsupported LMP Feature</td>
-</tr>
-<tr class="row-even"><td>0x021b</td>
-<td>0x1b</td>
-<td>BLE_ERR_SCO_OFFSET</td>
-<td>SCO Offset Rejected</td>
-</tr>
-<tr class="row-odd"><td>0x021c</td>
-<td>0x1c</td>
-<td>BLE_ERR_SCO_ITVL</td>
-<td>SCO Interval Rejected</td>
-</tr>
-<tr class="row-even"><td>0x021d</td>
-<td>0x1d</td>
-<td>BLE_ERR_SCO_AIR_MODE</td>
-<td>SCO Air Mode Rejected</td>
-</tr>
-<tr class="row-odd"><td>0x021e</td>
-<td>0x1e</td>
-<td>BLE_ERR_INV_LMP_LL_PARM</td>
-<td>Invalid LMP Parameters / Invalid LL Parameters</td>
-</tr>
-<tr class="row-even"><td>0x021f</td>
-<td>0x1f</td>
-<td>BLE_ERR_UNSPECIFIED</td>
-<td>Unspecified Error</td>
-</tr>
-<tr class="row-odd"><td>0x0220</td>
-<td>0x20</td>
-<td>BLE_ERR_UNSUPP_LMP_LL_PARM</td>
-<td>Unsupported LMP Parameter Value / Unsupported LL Parameter Value</td>
-</tr>
-<tr class="row-even"><td>0x0221</td>
-<td>0x21</td>
-<td>BLE_ERR_NO_ROLE_CHANGE</td>
-<td>Role Change Not Allowed</td>
-</tr>
-<tr class="row-odd"><td>0x0222</td>
-<td>0x22</td>
-<td>BLE_ERR_LMP_LL_RSP_TMO</td>
-<td>LMP Response Timeout / LL Response Timeout</td>
-</tr>
-<tr class="row-even"><td>0x0223</td>
-<td>0x23</td>
-<td>BLE_ERR_LMP_COLLISION</td>
-<td>LMP Error Transaction Collision</td>
-</tr>
-<tr class="row-odd"><td>0x0224</td>
-<td>0x24</td>
-<td>BLE_ERR_LMP_PDU</td>
-<td>LMP PDU Not Allowed</td>
-</tr>
-<tr class="row-even"><td>0x0225</td>
-<td>0x25</td>
-<td>BLE_ERR_ENCRYPTION_MODE</td>
-<td>Encryption Mode Not Acceptable</td>
-</tr>
-<tr class="row-odd"><td>0x0226</td>
-<td>0x26</td>
-<td>BLE_ERR_LINK_KEY_CHANGE</td>
-<td>Link Key cannot be Changed</td>
-</tr>
-<tr class="row-even"><td>0x0227</td>
-<td>0x27</td>
-<td>BLE_ERR_UNSUPP_QOS</td>
-<td>Requested QoS Not Supported</td>
-</tr>
-<tr class="row-odd"><td>0x0228</td>
-<td>0x28</td>
-<td>BLE_ERR_INSTANT_PASSED</td>
-<td>Instant Passed</td>
-</tr>
-<tr class="row-even"><td>0x0229</td>
-<td>0x29</td>
-<td>BLE_ERR_UNIT_KEY_PAIRING</td>
-<td>Pairing With Unit Key Not Supported</td>
-</tr>
-<tr class="row-odd"><td>0x022a</td>
-<td>0x2a</td>
-<td>BLE_ERR_DIFF_TRANS_COLL</td>
-<td>Different Transaction Collision</td>
-</tr>
-<tr class="row-even"><td>0x022c</td>
-<td>0x2c</td>
-<td>BLE_ERR_QOS_PARM</td>
-<td>QoS Unacceptable Parameter</td>
-</tr>
-<tr class="row-odd"><td>0x022d</td>
-<td>0x2d</td>
-<td>BLE_ERR_QOS_REJECTED</td>
-<td>QoS Rejected</td>
-</tr>
-<tr class="row-even"><td>0x022e</td>
-<td>0x2e</td>
-<td>BLE_ERR_CHAN_CLASS</td>
-<td>Channel Classification Not Supported</td>
-</tr>
-<tr class="row-odd"><td>0x022f</td>
-<td>0x2f</td>
-<td>BLE_ERR_INSUFFICIENT_SEC</td>
-<td>Insufficient Security</td>
-</tr>
-<tr class="row-even"><td>0x0230</td>
-<td>0x30</td>
-<td>BLE_ERR_PARM_OUT_OF_RANGE</td>
-<td>Parameter Out Of Mandatory Range</td>
-</tr>
-<tr class="row-odd"><td>0x0232</td>
-<td>0x32</td>
-<td>BLE_ERR_PENDING_ROLE_SW</td>
-<td>Role Switch Pending</td>
-</tr>
-<tr class="row-even"><td>0x0234</td>
-<td>0x34</td>
-<td>BLE_ERR_RESERVED_SLOT</td>
-<td>Reserved Slot Violation</td>
-</tr>
-<tr class="row-odd"><td>0x0235</td>
-<td>0x35</td>
-<td>BLE_ERR_ROLE_SW_FAIL</td>
-<td>Role Switch Failed</td>
-</tr>
-<tr class="row-even"><td>0x0236</td>
-<td>0x36</td>
-<td>BLE_ERR_INQ_RSP_TOO_BIG</td>
-<td>Extended Inquiry Response Too Large</td>
-</tr>
-<tr class="row-odd"><td>0x0237</td>
-<td>0x37</td>
-<td>BLE_ERR_SEC_SIMPLE_PAIR</td>
-<td>Secure Simple Pairing Not Supported By Host</td>
-</tr>
-<tr class="row-even"><td>0x0238</td>
-<td>0x38</td>
-<td>BLE_ERR_HOST_BUSY_PAIR</td>
-<td>Host Busy - Pairing</td>
-</tr>
-<tr class="row-odd"><td>0x0239</td>
-<td>0x39</td>
-<td>BLE_ERR_CONN_REJ_CHANNEL</td>
-<td>Connection Rejected due to No Suitable Channel Found</td>
-</tr>
-<tr class="row-even"><td>0x023a</td>
-<td>0x3a</td>
-<td>BLE_ERR_CTLR_BUSY</td>
-<td>Controller Busy</td>
-</tr>
-<tr class="row-odd"><td>0x023b</td>
-<td>0x3b</td>
-<td>BLE_ERR_CONN_PARMS</td>
-<td>Unacceptable Connection Parameters</td>
-</tr>
-<tr class="row-even"><td>0x023c</td>
-<td>0x3c</td>
-<td>BLE_ERR_DIR_ADV_TMO</td>
-<td>Directed Advertising Timeout</td>
-</tr>
-<tr class="row-odd"><td>0x023d</td>
-<td>0x3d</td>
-<td>BLE_ERR_CONN_TERM_MIC</td>
-<td>Connection Terminated due to MIC Failure</td>
-</tr>
-<tr class="row-even"><td>0x023e</td>
-<td>0x3e</td>
-<td>BLE_ERR_CONN_ESTABLISHMENT</td>
-<td>Connection Failed to be Established</td>
-</tr>
-<tr class="row-odd"><td>0x023f</td>
-<td>0x3f</td>
-<td>BLE_ERR_MAC_CONN_FAIL</td>
-<td>MAC Connection Failed</td>
-</tr>
-<tr class="row-even"><td>0x0240</td>
-<td>0x40</td>
-<td>BLE_ERR_COARSE_CLK_ADJ</td>
-<td>Coarse Clock Adjustment Rejected but Will Try to Adjust Using Clock Dragging</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="return-codes-l2cap">
-<h3><a class="toc-backref" href="#id9">Return codes - L2CAP</a><a class="headerlink" href="#return-codes-l2cap" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="12%" />
-<col width="12%" />
-<col width="35%" />
-<col width="41%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">NimBLE Value</th>
-<th class="head">Formal Value</th>
-<th class="head">Name</th>
-<th class="head">Condition</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>0x0300</td>
-<td>0x00</td>
-<td>BLE_L2CAP_SIG_ERR_CMD_NOT_UNDERSTOOD</td>
-<td>Invalid or unsupported incoming L2CAP sig command.</td>
-</tr>
-<tr class="row-odd"><td>0x0301</td>
-<td>0x01</td>
-<td>BLE_L2CAP_SIG_ERR_MTU_EXCEEDED</td>
-<td>Incoming packet too large.</td>
-</tr>
-<tr class="row-even"><td>0x0302</td>
-<td>0x02</td>
-<td>BLE_L2CAP_SIG_ERR_INVALID_CID</td>
-<td>No channel with specified ID.</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="return-codes-security-manager-us">
-<h3><a class="toc-backref" href="#id10">Return codes - Security manager (us)</a><a class="headerlink" href="#return-codes-security-manager-us" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="8%" />
-<col width="8%" />
-<col width="17%" />
-<col width="67%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">NimBLE Value</th>
-<th class="head">Formal Value</th>
-<th class="head">Name</th>
-<th class="head">Condition</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>0x0401</td>
-<td>0x01</td>
-<td>BLE_SM_ERR_PASSKEY</td>
-<td>The user input of passkey failed, for example, the user cancelled the operation.</td>
-</tr>
-<tr class="row-odd"><td>0x0402</td>
-<td>0x02</td>
-<td>BLE_SM_ERR_OOB</td>
-<td>The OOB data is not available.</td>
-</tr>
-<tr class="row-even"><td>0x0403</td>
-<td>0x03</td>
-<td>BLE_SM_ERR_AUTHREQ</td>
-<td>The pairing procedure cannot be performed as authentication requirements cannot be met due to IO capabilities of one or both devices.</td>
-</tr>
-<tr class="row-odd"><td>0x0404</td>
-<td>0x04</td>
-<td>BLE_SM_ERR_CONFIRM_MISMATCH</td>
-<td>The confirm value does not match the calculated compare value.</td>
-</tr>
-<tr class="row-even"><td>0x0405</td>
-<td>0x05</td>
-<td>BLE_SM_ERR_PAIR_NOT_SUPP</td>
-<td>Pairing is not supported by the device.</td>
-</tr>
-<tr class="row-odd"><td>0x0406</td>
-<td>0x06</td>
-<td>BLE_SM_ERR_ENC_KEY_SZ</td>
-<td>The resultant encryption key size is insufficient for the security requirements of this device.</td>
-</tr>
-<tr class="row-even"><td>0x0407</td>
-<td>0x07</td>
-<td>BLE_SM_ERR_CMD_NOT_SUPP</td>
-<td>The SMP command received is not supported on this device.</td>
-</tr>
-<tr class="row-odd"><td>0x0408</td>
-<td>0x08</td>
-<td>BLE_SM_ERR_UNSPECIFIED</td>
-<td>Pairing failed due to an unspecified reason.</td>
-</tr>
-<tr class="row-even"><td>0x0409</td>
-<td>0x09</td>
-<td>BLE_SM_ERR_REPEATED</td>
-<td>Pairing or authentication procedure is disallowed because too little time has elapsed since last pairing request or security request.</td>
-</tr>
-<tr class="row-odd"><td>0x040a</td>
-<td>0x0a</td>
-<td>BLE_SM_ERR_INVAL</td>
-<td>The Invalid Parameters error code indicates that the command length is invalid or that a parameter is outside of the specified range.</td>
-</tr>
-<tr class="row-even"><td>0x040b</td>
-<td>0x0b</td>
-<td>BLE_SM_ERR_DHKEY</td>
-<td>Indicates to the remote device that the DHKey Check value received doesn’t match the one calculated by the local device.</td>
-</tr>
-<tr class="row-odd"><td>0x040c</td>
-<td>0x0c</td>
-<td>BLE_SM_ERR_NUMCMP</td>
-<td>Indicates that the confirm values in the numeric comparison protocol do not match.</td>
-</tr>
-<tr class="row-even"><td>0x040d</td>
-<td>0x0d</td>
-<td>BLE_SM_ERR_ALREADY</td>
-<td>Indicates that the pairing over the LE transport failed due to a Pairing Request sent over the BR/EDR transport in process.</td>
-</tr>
-<tr class="row-odd"><td>0x040e</td>
-<td>0x0e</td>
-<td>BLE_SM_ERR_CROSS_TRANS</td>
-<td>Indicates that the BR/EDR Link Key generated on the BR/EDR transport cannot be used to derive and distribute keys for the LE transport.</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="return-codes-security-manager-peer">
-<h3><a class="toc-backref" href="#id11">Return codes - Security manager (peer)</a><a class="headerlink" href="#return-codes-security-manager-peer" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="8%" />
-<col width="8%" />
-<col width="17%" />
-<col width="67%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">NimBLE Value</th>
-<th class="head">Formal Value</th>
-<th class="head">Name</th>
-<th class="head">Condition</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>0x0501</td>
-<td>0x01</td>
-<td>BLE_SM_ERR_PASSKEY</td>
-<td>The user input of passkey failed, for example, the user cancelled the operation.</td>
-</tr>
-<tr class="row-odd"><td>0x0502</td>
-<td>0x02</td>
-<td>BLE_SM_ERR_OOB</td>
-<td>The OOB data is not available.</td>
-</tr>
-<tr class="row-even"><td>0x0503</td>
-<td>0x03</td>
-<td>BLE_SM_ERR_AUTHREQ</td>
-<td>The pairing procedure cannot be performed as authentication requirements cannot be met due to IO capabilities of one or both devices.</td>
-</tr>
-<tr class="row-odd"><td>0x0504</td>
-<td>0x04</td>
-<td>BLE_SM_ERR_CONFIRM_MISMATCH</td>
-<td>The confirm value does not match the calculated compare value.</td>
-</tr>
-<tr class="row-even"><td>0x0505</td>
-<td>0x05</td>
-<td>BLE_SM_ERR_PAIR_NOT_SUPP</td>
-<td>Pairing is not supported by the device.</td>
-</tr>
-<tr class="row-odd"><td>0x0506</td>
-<td>0x06</td>
-<td>BLE_SM_ERR_ENC_KEY_SZ</td>
-<td>The resultant encryption key size is insufficient for the security requirements of this device.</td>
-</tr>
-<tr class="row-even"><td>0x0507</td>
-<td>0x07</td>
-<td>BLE_SM_ERR_CMD_NOT_SUPP</td>
-<td>The SMP command received is not supported on this device.</td>
-</tr>
-<tr class="row-odd"><td>0x0508</td>
-<td>0x08</td>
-<td>BLE_SM_ERR_UNSPECIFIED</td>
-<td>Pairing failed due to an unspecified reason.</td>
-</tr>
-<tr class="row-even"><td>0x0509</td>
-<td>0x09</td>
-<td>BLE_SM_ERR_REPEATED</td>
-<td>Pairing or authentication procedure is disallowed because too little time has elapsed since last pairing request or security request.</td>
-</tr>
-<tr class="row-odd"><td>0x050a</td>
-<td>0x0a</td>
-<td>BLE_SM_ERR_INVAL</td>
-<td>The Invalid Parameters error code indicates that the command length is invalid or that a parameter is outside of the specified range.</td>
-</tr>
-<tr class="row-even"><td>0x050b</td>
-<td>0x0b</td>
-<td>BLE_SM_ERR_DHKEY</td>
-<td>Indicates to the remote device that the DHKey Check value received doesn’t match the one calculated by the local device.</td>
-</tr>
-<tr class="row-odd"><td>0x050c</td>
-<td>0x0c</td>
-<td>BLE_SM_ERR_NUMCMP</td>
-<td>Indicates that the confirm values in the numeric comparison protocol do not match.</td>
-</tr>
-<tr class="row-even"><td>0x050d</td>
-<td>0x0d</td>
-<td>BLE_SM_ERR_ALREADY</td>
-<td>Indicates that the pairing over the LE transport failed due to a Pairing Request sent over the BR/EDR transport in process.</td>
-</tr>
-<tr class="row-odd"><td>0x050e</td>
-<td>0x0e</td>
-<td>BLE_SM_ERR_CROSS_TRANS</td>
-<td>Indicates that the BR/EDR Link Key generated on the BR/EDR transport cannot be used to derive and distribute keys for the LE transport.</td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_gap.html" class="btn btn-neutral float-right" title="NimBLE Host GAP Reference" accesskey="n">Next: NimBLE Host GAP Reference <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="ble_hs.html" class="btn btn-neutral" title="NimBLE Host" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: NimBLE Host</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_sec.html b/develop/network/docs/ble_sec.html
deleted file mode 100644
index d160d536c..000000000
--- a/develop/network/docs/ble_sec.html
+++ /dev/null
@@ -1,401 +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">
-
-
-
-
- <title>NimBLE Security — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../genindex.html"/>
- <link rel="search" title="Search" href="../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../index.html"/>
- <link rel="up" title="BLE User Guide" href="index.html"/>
- <link rel="next" title="NimBLE Setup" href="ble_setup/ble_setup_intro.html"/>
- <link rel="prev" title="BLE User Guide" href="index.html"/>
-
-
- <script src="../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="index.html">BLE User Guide</a> /
-
- NimBLE Security
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_sec.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2 current"><a class="current reference internal" href="#">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2"><a class="reference internal" href="btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="nimble-security">
-<h1>NimBLE Security<a class="headerlink" href="#nimble-security" title="Permalink to this headline">¶</a></h1>
-<p>The Bluetooth Low Energy security model includes five distinct security
-concepts as listed below. For detailed specifications, see BLUETOOTH
-SPECIFICATION Version 4.2 [Vol 1, Part A].</p>
-<ul class="simple">
-<li><strong>Pairing</strong>: The process for creating one or more shared secret keys.
-In LE a single link key is generated by combining contributions from
-each device into a link key used during pairing.</li>
-<li><strong>Bonding</strong>: The act of storing the keys created during pairing for
-use in subsequent connections in order to form a trusted device pair.</li>
-<li><strong>Device authentication</strong>: Verification that the two devices have the
-same keys (verify device identity)</li>
-<li><strong>Encryption</strong>: Keeps message confidential. Encryption in Bluetooth
-LE uses AES-CCM cryptography and is performed in the <em>Controller</em>.</li>
-<li><strong>Message integrity</strong>: Protects against message forgeries.</li>
-</ul>
-<p>Bluetooth LE uses four association models depending on the I/O
-capabilities of the devices.</p>
-<ul class="simple">
-<li><strong>Just Works</strong>: designed for scenarios where at least one of the
-devices does not have a display capable of displaying a six digit
-number nor does it have a keyboard capable of entering six decimal
-digits.</li>
-<li><strong>Numeric Comparison</strong>: designed for scenarios where both devices are
-capable of displaying a six digit number and both are capable of
-having the user enter “yes” or “no”. A good example of this model is
-the cell phone / PC scenario.</li>
-<li><strong>Out of Band</strong>: designed for scenarios where an Out of Band
-mechanism is used to both discover the devices as well as to exchange
-or transfer cryptographic numbers used in the pairing process.</li>
-<li><strong>Passkey Entry</strong>: designed for the scenario where one device has
-input capability but does not have the capability to display six
-digits and the other device has output capabilities. A good example
-of this model is the PC and keyboard scenario.</li>
-</ul>
-<div class="section" id="key-generation">
-<h2>Key Generation<a class="headerlink" href="#key-generation" title="Permalink to this headline">¶</a></h2>
-<p>Key generation for all purposes in Bluetooth LE is performed by the
-<em>Host</em> on each LE device independent of any other LE device.</p>
-</div>
-<div class="section" id="privacy-feature">
-<h2>Privacy Feature<a class="headerlink" href="#privacy-feature" title="Permalink to this headline">¶</a></h2>
-<p>Bluetooth LE supports an optional feature during connection mode and
-connection procedures that reduces the ability to track a LE device over
-a period of time by changing the Bluetooth device address on a frequent
-basis.</p>
-<p>There are two variants of the privacy feature.</p>
-<ul class="simple">
-<li>In the first variant, private addresses are resolved and generated by
-the <em>Host</em>.</li>
-<li>In the second variant, private addresses are resolved and generated
-by the <em>Controller</em> without involving the Host after the Host
-provides the Controller device identity information. The Host may
-provide the Controller with a complete resolving list or a subset of
-the resolving list. Device filtering becomes possible in the second
-variant when address resolution is performed in the Controller
-because the peer’s device identity address can be resolved prior to
-checking whether it is in the white list.</li>
-</ul>
-<p><strong>Note</strong>: When address resolution is performed exclusively in the Host,
-a device may experience increased power consumption because device
-filtering must be disabled. For more details on the privacy feature,
-refer to BLUETOOTH SPECIFICATION Version 4.2 [Vol 3, Part C] (Published
-02 December 2014), Page 592.</p>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_setup/ble_setup_intro.html" class="btn btn-neutral float-right" title="NimBLE Setup" accesskey="n">Next: NimBLE Setup <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="index.html" class="btn btn-neutral" title="BLE User Guide" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: BLE User Guide</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_setup/ble_addr.html b/develop/network/docs/ble_setup/ble_addr.html
deleted file mode 100644
index b22229be4..000000000
--- a/develop/network/docs/ble_setup/ble_addr.html
+++ /dev/null
@@ -1,397 +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">
-
-
-
-
- <title>Configure device address — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="NimBLE Setup" href="ble_setup_intro.html"/>
- <link rel="next" title="Respond to sync and reset events" href="ble_sync_cb.html"/>
- <link rel="prev" title="Configure clock for controller" href="ble_lp_clock.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="ble_setup_intro.html">NimBLE Setup</a> /
-
- Configure device address
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_setup/ble_addr.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="ble_setup_intro.html">NimBLE Setup</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="ble_lp_clock.html">Configure clock for controller</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">Configure device address</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_sync_cb.html">Respond to <em>sync</em> and <em>reset</em> events</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="configure-device-address">
-<h1>Configure device address<a class="headerlink" href="#configure-device-address" title="Permalink to this headline">¶</a></h1>
-<p>A BLE device needs an address to do just about anything. For information
-on the various types of Bluetooth addresses, see the <cite>NimBLE Host
-Identity Reference :doc:`<../ble_hs/ble_hs_id/ble_hs_id></cite>.</p>
-<p>There are several methods for assigning an address to a NimBLE device.
-The available options are documented below:</p>
-<div class="section" id="method-1-configure-nrf-hardware-with-a-public-address">
-<h2>Method 1: Configure nRF hardware with a public address<a class="headerlink" href="#method-1-configure-nrf-hardware-with-a-public-address" title="Permalink to this headline">¶</a></h2>
-<p>When Mynewt is running on a Nordic nRF platform, the NimBLE controller
-will attempt to read a public address out of the board’s FICR or UICR
-registers. The controller uses the following logic while trying to read
-an address from hardware:</p>
-<ol class="arabic simple">
-<li>If the <em>DEVICEADDRTYPE</em> FICR register is written, read the address
-programmed in the <em>DEVICEADDR[0]</em> and <em>DEVICEADDR[1]</em> FICR registers.</li>
-<li>Else if the upper 16 bits of the <em>CUSTOMER[1]</em> UICR register are 0,
-read the address programmed in the <em>CUSTOMER[0]</em> and <em>CUSTOMER[1]</em>
-UCI registers.</li>
-<li>Else, no address available.</li>
-</ol>
-</div>
-<div class="section" id="method-2-hardcode-a-public-address-in-the-mynewt-target">
-<h2>Method 2: Hardcode a public address in the Mynewt target<a class="headerlink" href="#method-2-hardcode-a-public-address-in-the-mynewt-target" title="Permalink to this headline">¶</a></h2>
-<p>The NimBLE controller package exports a
-<a class="reference internal" href="../../../os/modules/sysinitconfig/sysinitconfig.html"><span class="doc">syscfg</span></a> setting
-called <code class="docutils literal notranslate"><span class="pre">BLE_PUBLIC_DEV_ADDR</span></code>. This setting can be overridden at the
-application or target level to configure a public Bluetooth address. For
-example, a target can assign the public address <em>11:22:33:44:55:66</em> as
-follows:</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>syscfg.vals:
- BLE_PUBLIC_DEV_ADDR: '(uint8_t[6]){0x66, 0x55, 0x44, 0x33, 0x22, 0x11}'
-</pre></div>
-</div>
-<p>This setting takes the form of a C expression. Specifically, the value
-is a designated initializer expressing a six-byte array. Also note that
-the bytes are reversed, as an array is inherently little-endian, while
-addresses are generally expressed in big-endian.</p>
-<p>Note: this method takes precedence over method 1. Whatever is written to
-the <code class="docutils literal notranslate"><span class="pre">BLE_PUBLIC_DEV_ADDR</span></code> setting is the address that gets used.</p>
-</div>
-<div class="section" id="method-3-configure-a-random-address-at-runtime">
-<h2>Method 3: Configure a random address at runtime<a class="headerlink" href="#method-3-configure-a-random-address-at-runtime" title="Permalink to this headline">¶</a></h2>
-<p>Random addresses get configured through the NimBLE host. The following
-two functions are used in random address configuration:</p>
-<ul class="simple">
-<li><span class="xref std std-doc">ble_hs_id_gen_rnd</span>:
-Generates a new random address.</li>
-<li><span class="xref std std-doc">ble_hs_id_set_rnd</span>:
-Sets the device’s random address.</li>
-</ul>
-<p>For an example of how this is done, see the <span class="xref std std-doc"><../../../os/tutorials/ibeacon></span>.</p>
-<p><em>Note:</em> A NimBLE device can be configured with multiple addresses; at
-most one of each address type.</p>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_sync_cb.html" class="btn btn-neutral float-right" title="Respond to sync and reset events" accesskey="n">Next: Respond to sync and reset events <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="ble_lp_clock.html" class="btn btn-neutral" title="Configure clock for controller" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Configure clock for controller</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_setup/ble_lp_clock.html b/develop/network/docs/ble_setup/ble_lp_clock.html
deleted file mode 100644
index 1eaf8442d..000000000
--- a/develop/network/docs/ble_setup/ble_lp_clock.html
+++ /dev/null
@@ -1,400 +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">
-
-
-
-
- <title>Configure clock for controller — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="NimBLE Setup" href="ble_setup_intro.html"/>
- <link rel="next" title="Configure device address" href="ble_addr.html"/>
- <link rel="prev" title="NimBLE Setup" href="ble_setup_intro.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="ble_setup_intro.html">NimBLE Setup</a> /
-
- Configure clock for controller
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_setup/ble_lp_clock.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="ble_setup_intro.html">NimBLE Setup</a><ul class="current">
-<li class="toctree-l3 current"><a class="current reference internal" href="#">Configure clock for controller</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_addr.html">Configure device address</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_sync_cb.html">Respond to <em>sync</em> and <em>reset</em> events</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="configure-clock-for-controller">
-<h1>Configure clock for controller<a class="headerlink" href="#configure-clock-for-controller" title="Permalink to this headline">¶</a></h1>
-<p>The NimBLE stack uses OS cputime for scheduling various events inside
-controller. Since the code of controller is optimized to work with 32768
-Hz clock, the OS cputime has to be configured accordingly.</p>
-<p>To make things easier, controller package (<code class="docutils literal notranslate"><span class="pre">net/nimble/controller</span></code>)
-defines new system configuration setting <code class="docutils literal notranslate"><span class="pre">BLE_LP_CLOCK</span></code> as sets it to
-<code class="docutils literal notranslate"><span class="pre">1</span></code> so other packages can be configured if necessary. The next section
-describes configuration required for controller to work properly.</p>
-<div class="section" id="system-configuration">
-<h2>System configuration<a class="headerlink" href="#system-configuration" title="Permalink to this headline">¶</a></h2>
-<p><strong>Note:</strong> All BSPs based on nRF5x have below settings automatically
-applied when <code class="docutils literal notranslate"><span class="pre">BLE_LP_CLOCK</span></code> is set, there is no need to configure this
-in application.</p>
-<p>The following things need to be configured for NimBLE controller to work
-properly:</p>
-<ul class="simple">
-<li>OS cputime frequency shall be set to <code class="docutils literal notranslate"><span class="pre">32768</span></code></li>
-<li>OS cputime timer source shall be set to 32768 Hz clock source</li>
-<li>Default 1 MHz clock source can be disabled if not used by application</li>
-<li>32768 Hz clock source shall be enabled</li>
-<li>Crystal settling time shall be set to non-zero value (see below)</li>
-</ul>
-<p>For example, on nRF52 platform timer 5 can be used as source for 32768
-Hz clock. Also, timer 0 can be disabled since this is the default source
-for OS cputime clock and is no longer used. The configuration will look
-as below:</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>syscfg.vals:
- OS_CPUTIME_FREQ: 32768
- OS_CPUTIME_TIMER_NUM: 5
- TIMER_0: 0
- TIMER_5: 1
- BLE_XTAL_SETTLE_TIME: 1500
-</pre></div>
-</div>
-<p>On nRF51 platform the only difference is to use timer 3 instead of timer
-5.</p>
-<p>On platforms without 32768 Hz crystal available it usually can be
-synthesized by setting <code class="docutils literal notranslate"><span class="pre">XTAL_32768_SYNTH</span></code> to <code class="docutils literal notranslate"><span class="pre">1</span></code> - this is also
-already configured in existing BSPs.</p>
-</div>
-<div class="section" id="crystal-settle-time-configuration">
-<h2>Crystal settle time configuration<a class="headerlink" href="#crystal-settle-time-configuration" title="Permalink to this headline">¶</a></h2>
-<p>The configuration variable <code class="docutils literal notranslate"><span class="pre">BLE_XTAL_SETTLE_TIME</span></code> is used by the
-controller to turn on the necessary clock source(s) for the radio and
-associated peripherals prior to Bluetooth events (advertising, scanning,
-connections, etc). For the nRF5x platforms, the HFXO needs to be turned
-on prior to using the radio and the <code class="docutils literal notranslate"><span class="pre">BLE_XTAL_SETTLE_TIME</span></code> must be set
-to accommodate this time. The amount of time required is board
-dependent, so users must characterize their hardware and set
-<code class="docutils literal notranslate"><span class="pre">BLE_XTAL_SETTLE_TIME</span></code> accordingly. The current value of 1500
-microseconds is a fairly long time and was intended to work for most, if
-not all, platforms.</p>
-<p>Note that changing this time will impact battery life with the amount
-depending on the application. The HFXO draws a fairly large amount of
-current when running so keeping this time as small as possible will
-reduce overall current drain.</p>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_addr.html" class="btn btn-neutral float-right" title="Configure device address" accesskey="n">Next: Configure device address <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="ble_setup_intro.html" class="btn btn-neutral" title="NimBLE Setup" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: NimBLE Setup</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_setup/ble_setup_intro.html b/develop/network/docs/ble_setup/ble_setup_intro.html
deleted file mode 100644
index 10f67e851..000000000
--- a/develop/network/docs/ble_setup/ble_setup_intro.html
+++ /dev/null
@@ -1,367 +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">
-
-
-
-
- <title>NimBLE Setup — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="BLE User Guide" href="../index.html"/>
- <link rel="next" title="Configure clock for controller" href="ble_lp_clock.html"/>
- <link rel="prev" title="NimBLE Security" href="../ble_sec.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- NimBLE Setup
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_setup/ble_setup_intro.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">NimBLE Setup</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="ble_lp_clock.html">Configure clock for controller</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_addr.html">Configure device address</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_sync_cb.html">Respond to <em>sync</em> and <em>reset</em> events</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="nimble-setup">
-<h1>NimBLE Setup<a class="headerlink" href="#nimble-setup" title="Permalink to this headline">¶</a></h1>
-<p>Most NimBLE initialization is done automatically by
-<a class="reference internal" href="../../../os/modules/sysinitconfig/sysinitconfig.html"><span class="doc">sysinit</span></a>. This
-section documents the few bits of initialization that an application
-must perform manually.</p>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="ble_lp_clock.html">Configure clock for controller</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="ble_lp_clock.html#system-configuration">System configuration</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ble_lp_clock.html#crystal-settle-time-configuration">Crystal settle time configuration</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="ble_addr.html">Configure device address</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="ble_addr.html#method-1-configure-nrf-hardware-with-a-public-address">Method 1: Configure nRF hardware with a public address</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ble_addr.html#method-2-hardcode-a-public-address-in-the-mynewt-target">Method 2: Hardcode a public address in the Mynewt target</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ble_addr.html#method-3-configure-a-random-address-at-runtime">Method 3: Configure a random address at runtime</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="ble_sync_cb.html">Respond to <em>sync</em> and <em>reset</em> events</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="ble_sync_cb.html#sync">sync</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ble_sync_cb.html#reset">reset</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ble_sync_cb.html#example">Example</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_lp_clock.html" class="btn btn-neutral float-right" title="Configure clock for controller" accesskey="n">Next: Configure clock for controller <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="../ble_sec.html" class="btn btn-neutral" title="NimBLE Security" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: NimBLE Security</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/ble_setup/ble_sync_cb.html b/develop/network/docs/ble_setup/ble_sync_cb.html
deleted file mode 100644
index c1c1421e6..000000000
--- a/develop/network/docs/ble_setup/ble_sync_cb.html
+++ /dev/null
@@ -1,413 +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">
-
-
-
-
- <title>Respond to sync and reset events — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="NimBLE Setup" href="ble_setup_intro.html"/>
- <link rel="next" title="NimBLE Host" href="../ble_hs/ble_hs.html"/>
- <link rel="prev" title="Configure device address" href="ble_addr.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="ble_setup_intro.html">NimBLE Setup</a> /
-
- Respond to <em>sync</em> and <em>reset</em> events
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/ble_setup/ble_sync_cb.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="ble_setup_intro.html">NimBLE Setup</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="ble_lp_clock.html">Configure clock for controller</a></li>
-<li class="toctree-l3"><a class="reference internal" href="ble_addr.html">Configure device address</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">Respond to <em>sync</em> and <em>reset</em> events</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="respond-to-sync-and-reset-events">
-<h1>Respond to <em>sync</em> and <em>reset</em> events<a class="headerlink" href="#respond-to-sync-and-reset-events" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="sync">
-<h2>sync<a class="headerlink" href="#sync" title="Permalink to this headline">¶</a></h2>
-<p>The NimBLE stack is inoperable while the host and controller are out of
-sync. In a combined host-controller app, the sync happens immediately at
-startup. When the host and controller are separate, sync typically
-occurs in under a second after the application starts. An application
-learns when sync is achieved by configuring the host’s <em>sync callback</em>:
-<code class="docutils literal notranslate"><span class="pre">ble_hs_cfg.sync_cb</span></code>. The host calls the sync callback whenever sync
-is acquired. The sync callback has the following form:</p>
-<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">typedef</span> <span class="kt">void</span> <span class="nf">ble_hs_sync_fn</span><span class="p">(</span><span class="kt">void</span><span class="p">);</span>
-</pre></div>
-</div>
-<p>Because the NimBLE stack begins in the unsynced state, the application
-should delay all BLE operations until the sync callback has been called.</p>
-</div>
-<div class="section" id="reset">
-<h2>reset<a class="headerlink" href="#reset" title="Permalink to this headline">¶</a></h2>
-<p>Another event indicated by the host is a <em>controller reset</em>. The NimBLE
-stack resets itself when a catastrophic error occurs, such as loss of
-communication between the host and controller. Upon resetting, the host
-drops all BLE connections and loses sync with the controller. After a
-reset, the application should refrain from using the host until sync is
-again signaled via the sync callback.</p>
-<p>An application learns of a host reset by configuring the host’s <em>reset
-callback</em>: <code class="docutils literal notranslate"><span class="pre">ble_hs_cfg.reset_cb</span></code>. This callback has the following
-form:</p>
-<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">typedef</span> <span class="kt">void</span> <span class="nf">ble_hs_reset_fn</span><span class="p">(</span><span class="kt">int</span> <span class="n">reason</span><span class="p">);</span>
-</pre></div>
-</div>
-<p>The <code class="docutils literal notranslate"><span class="pre">reason</span></code> parameter is a <a class="reference internal" href="../ble_hs/ble_hs_return_codes.html"><span class="doc">NimBLE host return
-code</span></a>.</p>
-</div>
-<div class="section" id="example">
-<h2>Example<a class="headerlink" href="#example" title="Permalink to this headline">¶</a></h2>
-<p>The following example demonstrates the configuration of the sync and
-reset callbacks.</p>
-<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">"sysinit/sysinit.h"</span><span class="cp"></span>
-<span class="cp">#include</span> <span class="cpf">"console/console.h"</span><span class="cp"></span>
-<span class="cp">#include</span> <span class="cpf">"host/ble_hs.h"</span><span class="cp"></span>
-
-<span class="k">static</span> <span class="kt">void</span>
-<span class="nf">on_sync</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
-<span class="p">{</span>
- <span class="cm">/* Begin advertising, scanning for peripherals, etc. */</span>
-<span class="p">}</span>
-
-<span class="k">static</span> <span class="kt">void</span>
-<span class="nf">on_reset</span><span class="p">(</span><span class="kt">int</span> <span class="n">reason</span><span class="p">)</span>
-<span class="p">{</span>
- <span class="n">console_printf</span><span class="p">(</span><span class="s">"Resetting state; reason=%d</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">reason</span><span class="p">);</span>
-<span class="p">}</span>
-
-<span class="kt">int</span>
-<span class="nf">main</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
-<span class="p">{</span>
- <span class="cm">/* Initialize all packages. */</span>
- <span class="n">sysinit</span><span class="p">();</span>
-
- <span class="n">ble_hs_cfg</span><span class="p">.</span><span class="n">sync_cb</span> <span class="o">=</span> <span class="n">on_sync</span><span class="p">;</span>
- <span class="n">ble_hs_cfg</span><span class="p">.</span><span class="n">reset_cb</span> <span class="o">=</span> <span class="n">on_reset</span><span class="p">;</span>
-
- <span class="cm">/* As the last thing, process events from default event queue. */</span>
- <span class="k">while</span> <span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="p">{</span>
- <span class="n">os_eventq_run</span><span class="p">(</span><span class="n">os_eventq_dflt_get</span><span class="p">());</span>
- <span class="p">}</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="../ble_hs/ble_hs.html" class="btn btn-neutral float-right" title="NimBLE Host" accesskey="n">Next: NimBLE Host <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="ble_addr.html" class="btn btn-neutral" title="Configure device address" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Configure device address</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/btshell/btshell_GAP.html b/develop/network/docs/btshell/btshell_GAP.html
deleted file mode 100644
index cff3e0d57..000000000
--- a/develop/network/docs/btshell/btshell_GAP.html
+++ /dev/null
@@ -1,1953 +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">
-
-
-
-
- <title>GAP API for btshell — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="API for btshell app" href="btshell_api.html"/>
- <link rel="next" title="GATT feature API for btshell" href="btshell_GATT.html"/>
- <link rel="prev" title="API for btshell app" href="btshell_api.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="btshell_api.html">API for btshell app</a> /
-
- GAP API for btshell
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/btshell/btshell_GAP.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="btshell_api.html">btshell Usage API</a><ul class="current">
-<li class="toctree-l3 current"><a class="current reference internal" href="#">GAP</a></li>
-<li class="toctree-l3"><a class="reference internal" href="btshell_GATT.html">GATT</a></li>
-<li class="toctree-l3"><a class="reference internal" href="btshell_advdata.html">Advertisement Data Fields</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="gap-api-for-btshell">
-<h1>GAP API for btshell<a class="headerlink" href="#gap-api-for-btshell" title="Permalink to this headline">¶</a></h1>
-<p>Generic Access Profile (GAP) defines the generic procedures related to discovery of Bluetooth devices (idle mode
-procedures) and link management aspects of connecting to Bluetooth devices (connecting mode procedures). It also defines
-procedures related to use of different security levels.</p>
-<p>Several different modes and procedures may be performed simultaneously over an LE physical transport. The following
-modes and procedures are defined for use over an LE physical transport:</p>
-<ol class="arabic simple">
-<li><strong>Broadcast mode and observation procedure</strong><ul>
-<li>These allow two devices to communicate in a unidirectional connectionless manner using the advertising events.</li>
-</ul>
-</li>
-<li><strong>Discovery modes and procedures</strong><ul>
-<li>All devices shall be in either non-discoverable mode or one of the discoverable modes.</li>
-<li>A device in the discoverable mode shall be in either the general discoverable mode or the limited discoverable mode.</li>
-<li>A device in non-discoverable mode will not be discovered by any device that is performing either the general
-discovery procedure or the limited discovery procedure.</li>
-</ul>
-</li>
-<li><strong>Connection modes and procedures</strong><ul>
-<li>allow a device to establish a connection to another device.</li>
-<li>allow updating of parameters of the connection</li>
-<li>allow termination of the connection</li>
-</ul>
-</li>
-<li><strong>Bonding modes and procedures</strong><ul>
-<li>Bonding allows two connected devices to exchange and store security and identity information to create a trusted
-relationship.</li>
-<li>Bonding can occur only between two devices in bondable mode.</li>
-</ul>
-</li>
-</ol>
-<div class="section" id="available-commands">
-<h2>Available commands<a class="headerlink" href="#available-commands" title="Permalink to this headline">¶</a></h2>
-<p>Parameters default values are marked red.</p>
-<div class="section" id="configuration">
-<h3>Configuration<a class="headerlink" href="#configuration" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="12%" />
-<col width="10%" />
-<col width="16%" />
-<col width="61%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Command</strong></th>
-<th class="head"><strong>Parmeters</strong></th>
-<th class="head">** Possible values**</th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>set</strong></td>
-<td> </td>
-<td> </td>
-<td>Set configuration options</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>addr</td>
-<td>XX:XX:XX:XX:XX:XX</td>
-<td>Local device address</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Local device address type</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Use random address for scan requests</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>mtu</td>
-<td>[23-UINT16_MAX]</td>
-<td>GATT Maximum Transmission Unit (MTU)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>irk</td>
-<td>XX:XX:XX…</td>
-<td>Local Identity Resolving Key (16 byte</td>
-</tr>
-<tr class="row-even"><td><strong>set-priv-mode</strong></td>
-<td> </td>
-<td> </td>
-<td>Set privacy mode for device</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>addr</td>
-<td>XX:XX:XX:XX:XX:XX</td>
-<td>Remote device address</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Remote device public address type</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Remote device random address type</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>mode</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>0 - use network privacy, 1 - use device privacy</td>
-</tr>
-<tr class="row-odd"><td><strong>white-list</strong></td>
-<td> </td>
-<td> </td>
-<td>Add devices to white list (this command accepts multiple instances of addr and addr_type parameters)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>addr</td>
-<td>XX:XX:XX:XX:XX:XX</td>
-<td>Remote device address</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Remote device public address type</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Remote device random address type</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="device-discovery-and-connection">
-<h3>Device discovery and connection<a class="headerlink" href="#device-discovery-and-connection" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="13%" />
-<col width="16%" />
-<col width="14%" />
-<col width="56%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Command</strong></th>
-<th class="head"><strong>Parmeters</strong></th>
-<th class="head">** Possible values**</th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>scan</strong></td>
-<td> </td>
-<td> </td>
-<td>Discover remote devices</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>cancel</td>
-<td> </td>
-<td>cancel ongoing scan procedure</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>extended</td>
-<td><code class="docutils literal notranslate"><span class="pre">none</span></code></td>
-<td>Start legacy scan</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>1M</td>
-<td>Start extended scan on 1M PHY</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>coded</td>
-<td>Start extended scan on Coded PHY</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>both</td>
-<td>Start extended scan on both PHYs</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>duration</td>
-<td>[1-<code class="docutils literal notranslate"><span class="pre">INT32_MAX</span></code>],</td>
-<td>Duration of scan in milliseconds</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>limited</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use limited discovery procedure</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>passive</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use passive scan</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>interval</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT16_MAX]</td>
-<td>Scan interval, if 0 use stack’s default</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>window</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT16_MAX]</td>
-<td>Scan window, if 0 use stack’s default</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>filter</td>
-<td><code class="docutils literal notranslate"><span class="pre">no_wl</span></code></td>
-<td>Scan filter policy - Accept all advertising packets</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>use_wl</td>
-<td>Accept only advertising packets from devices on White List</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>no_wl_inita</td>
-<td>Accept all advertising packets (including directed RPA)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>use_wl_inita</td>
-<td>Accept only advertising packets from devices on White List (including directed RPA)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>nodups</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Disable duplicates filtering</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>own_addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Use public address for scan requests</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Use random address for scan requests</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>rpa_pub</td>
-<td>Use RPA address for scan requests (fallback to public if no IRK)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>rpa_rnd</td>
-<td>Use RPA address for scan requests (fallback to random if no IRK)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>extended_duration</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT16_MAX]</td>
-<td>Duration of extended scan in 10 milliseconds</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>extended_period</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT16_MAX]</td>
-<td>Periodic scan interval in 1.28 seconds (0 disabled)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>longrange_interval</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT16_MAX]</td>
-<td>Scan interval for Coded Scan , if 0 use stack’s default</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>longrange_window</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT16_MAX]</td>
-<td>Scan window for Coded Scan , if 0 use stack’s default</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>longrange_passive</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use passive scan for Coded Scan</td>
-</tr>
-<tr class="row-odd"><td><strong>connect</strong></td>
-<td> </td>
-<td> </td>
-<td>Initiate connection to remote device</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>cancel</td>
-<td> </td>
-<td>Cancel ongoing connection procedure</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>extended</td>
-<td><code class="docutils literal notranslate"><span class="pre">none</span></code></td>
-<td>Use legacy connection procedure</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>1M</td>
-<td>Extended connect using 1M PHY scan parameters</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>coded</td>
-<td>Extended connect using Coded PHY scan parameters</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>both</td>
-<td>Extended connect using 1M and Coded PHYs scan parameters</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>all</td>
-<td>Extended connect using 1M and Coded PHYs scan parameters (Provide also connection parameters for 2M PHY)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>peer_addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Remote device public address type</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Remote device random address type</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>public_id</td>
-<td>Remote device public address type (Identity)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>random_id</td>
-<td>Remote device random address type (Identity)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>peer_addr</td>
-<td>XX:XX:XX:XX:XX:XX</td>
-<td>Remote device address</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>own_addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Use public address for scan requests</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Use random address for scan requests</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>rpa_pub</td>
-<td>Use RPA address for scan requests (fallback to public if no IRK)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>rpa_rnd</td>
-<td>Use RPA address for scan requests (fallback to random if no IRK)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>duration</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-INT32_MAX]</td>
-<td>Connection attempt duration, if 0 use stack’s default</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>scan_interval</td>
-<td>[0-UINT16_MAX]</td>
-<td>Scan interval, default: 0x0010</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>scan_window</td>
-<td>[0-UINT16_MAX]</td>
-<td>Scan window, default: 0x0010</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>interval_min</td>
-<td>[0-UINT16_MAX]</td>
-<td>Minimum connection interval, default: 30</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>interval_max</td>
-<td>[0-UINT16_MAX]</td>
-<td>Maximum connection interval, default: 50</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>latency</td>
-<td>[UINT16]</td>
-<td>Connection latency, default: 0</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>timeout</td>
-<td>[UINT16]</td>
-<td>Connection timeout, default: 0x0100</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>min_conn_event_len</td>
-<td>[UINT16]</td>
-<td>Minimum length of connection event, default: 0x0010</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>max_conn_event_len</td>
-<td>[UINT16]</td>
-<td>Maximum length of connection event, default: 0x0300</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>coded_scan_interval</td>
-<td>[0-UINT16_MAX]</td>
-<td>Coded PHY Scan interval, default: 0x0010</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>coded_scan_window</td>
-<td>[0-UINT16_MAX]</td>
-<td>Coded PHY Scan window, default: 0x0010</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>coded_interval_min</td>
-<td>[0-UINT16_MAX]</td>
-<td>Coded PHY Minimum connection interval, default: 30</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>coded_interval_max</td>
-<td>[0-UINT16_MAX]</td>
-<td>Coded PHY Maximum connection interval, default: 50</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>coded_latency</td>
-<td>[UINT16]</td>
-<td>Coded PHY Connection latency, default: 0</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>coded_timeout</td>
-<td>[UINT16]</td>
-<td>Coded PHY Connection timeout, default: 0x0100</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>coded_min_conn_event_len</td>
-<td>[UINT16]</td>
-<td>Coded PHY Minimum length of connection event, default: 0x0010</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>coded_max_conn_event_len</td>
-<td>[UINT16]</td>
-<td>Coded PHY Maximum length of connection event, default: 0x0300</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>2M_scan_interval</td>
-<td>[0-UINT16_MAX]</td>
-<td>2M PHY Scan interval, default: 0x0010</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>2M_scan_window</td>
-<td>[0-UINT16_MAX]</td>
-<td>2M PHY Scan window, default: 0x0010</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>2M_interval_min</td>
-<td>[0-UINT16_MAX]</td>
-<td>2M PHY Minimum connection interval, default: 30</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>2M_interval_max</td>
-<td>[0-UINT16_MAX]</td>
-<td>2M PHY Maximum connection interval, default: 50</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>2M_latency</td>
-<td>[UINT16]</td>
-<td>2M PHY Connection latency, default: 0</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>2M_timeout</td>
-<td>[UINT16]</td>
-<td>2M PHY Connection timeout, default: 0x0100</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>2M_min_conn_event_len</td>
-<td>[UINT16]</td>
-<td>2M PHY Minimum length of connection event, default: 0x0010</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>2M_max_conn_event_len</td>
-<td>[UINT16]</td>
-<td>2M PHY Maximum length of connection event, default: 0x0300</td>
-</tr>
-<tr class="row-even"><td><strong>disconnect</strong></td>
-<td> </td>
-<td> </td>
-<td>Disconnect exisiting connection</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>reason</td>
-<td>[UINT8]</td>
-<td>Disconnect reason</td>
-</tr>
-<tr class="row-odd"><td><strong>show-addr</strong></td>
-<td> </td>
-<td> </td>
-<td>Show local public and random identity addresses</td>
-</tr>
-<tr class="row-even"><td><strong>show-conn</strong></td>
-<td> </td>
-<td> </td>
-<td>Show current connections</td>
-</tr>
-<tr class="row-odd"><td><strong>conn-rssi</strong></td>
-<td> </td>
-<td> </td>
-<td>Obtain RSSI of specified connection</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-odd"><td><strong>conn-update-params</strong></td>
-<td> </td>
-<td> </td>
-<td>Update parameters of specified connection</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>interval_min</td>
-<td>[0-UINT16_MAX]</td>
-<td>Minimum connection interval, default: 30</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>interval_max</td>
-<td>[0-UINT16_MAX]</td>
-<td>Maximum connection interval, default: 50</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>latency</td>
-<td>[UINT16]</td>
-<td>Connection latency, default: 0</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>timeout</td>
-<td>[UINT16]</td>
-<td>Connection timeout, default: 0x0100</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>min_conn_event_len</td>
-<td>[UINT16]</td>
-<td>Minimum length of connection event, default: 0x0010</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>max_conn_event_len</td>
-<td>[UINT16]</td>
-<td>Maximum length of connection event, default: 0x0300</td>
-</tr>
-<tr class="row-odd"><td><strong>conn-datalen</strong></td>
-<td> </td>
-<td> </td>
-<td>Set DLE parmaeters for connection</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>octets</td>
-<td>[UINT16]</td>
-<td>Maximum transmission packet size</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>time</td>
-<td>[UINT16]</td>
-<td>Maximum transmission packet time</td>
-</tr>
-<tr class="row-odd"><td><strong>phy-set</strong></td>
-<td> </td>
-<td> </td>
-<td>Set prefered PHYs used for connection</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>tx_phys_mask</td>
-<td>[UINT8]</td>
-<td>Prefered PHYs on TX is mask of following bits0x00 - no preference0x01 - 1M, 0x02 - 2M, 0x04 - Coded</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>rx_phys_mask</td>
-<td>[UINT8]</td>
-<td>Prefered PHYs on RX is mask of following bits0x00 - no preference0x01 - 1M, 0x02 - 2M, 0x04 - Coded</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>phy_opts</td>
-<td>[UINT16]</td>
-<td>Options for Coded PHY 0 - any coding, 1 - prefer S2, 2 - prefer S8</td>
-</tr>
-<tr class="row-even"><td><strong>phy-set-default</strong></td>
-<td> </td>
-<td> </td>
-<td>Set default prefered PHYs used for new connection</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>tx_phys_mask</td>
-<td>[UINT8]</td>
-<td>Prefered PHYs on TX is mask of following bits0x00 - no preference0x01 - 1M, 0x02 - 2M, 0x04 - Coded</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>rx_phys_mask</td>
-<td>[UINT8]</td>
-<td>Prefered PHYs on RX is mask of following bits0x00 - no preference0x01 - 1M, 0x02 - 2M, 0x04 - Coded</td>
-</tr>
-<tr class="row-odd"><td><strong>phy-read</strong></td>
-<td> </td>
-<td> </td>
-<td>Read connection current PHY</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-odd"><td><strong>l2cap-update</strong></td>
-<td> </td>
-<td> </td>
-<td>Update connection parameters</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>interval_min</td>
-<td>[0-UINT16_MAX]</td>
-<td>Minimum connection interval, default: 30</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>interval_max</td>
-<td>[0-UINT16_MAX]</td>
-<td>Maximum connection interval, default: 50</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>latency</td>
-<td>[UINT16]</td>
-<td>Connection latency, default: 0</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>timeout</td>
-<td>[UINT16]</td>
-<td>Connection timeout, default: 0x0100</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="security">
-<h3>Security<a class="headerlink" href="#security" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="14%" />
-<col width="10%" />
-<col width="14%" />
-<col width="62%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Command</strong></th>
-<th class="head"><strong>Parmeters</strong></th>
-<th class="head">** Possible values**</th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>security-set-data</strong></td>
-<td> </td>
-<td> </td>
-<td>Set security configuration</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>oob-flag</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Set Out-Of-Band (OOB) flag in Security Manager</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>mitm-flag</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Set Man-In-The-Middle (MITM) flag in Security Manager</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>io_capabilities</td>
-<td>0</td>
-<td>Set Input-Output Capabilities to “DisplayOnly”</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>1</td>
-<td>Set Input-Output Capabilities to “DisplayYesNo”</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>2</td>
-<td>Set Input-Output Capabilities to “KeyboardOnly”</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>3</td>
-<td>Set Input-Output Capabilities to “NoInputNoOutput”</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>4</td>
-<td>Set Input-Output Capabilities to “KeyboardDisplay”</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>our_key_dist</td>
-<td>[UINT8]</td>
-<td>Set Local Keys Distribution, this is a bit field of possible values: LTK (0x01), IRK (0x02), CSRK (0x04), LTK_SC(0x08)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>their_key_dist</td>
-<td>[UINT8]</td>
-<td>Set Remote Keys Distribution, this is a bit field of possible values: LTK (0x01), IRK (0x02), CSRK (0x04), LTK_SC(0x08)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>bonding-flag</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Set Bonding flag in Security Manager</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>sc-flag</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Set Secure Connections flag in Security Manager</td>
-</tr>
-<tr class="row-even"><td><strong>security-pair</strong></td>
-<td> </td>
-<td> </td>
-<td>Start pairing procedure</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td><strong>security-encryption</strong></td>
-<td> </td>
-<td> </td>
-<td>Start encryption procedure</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>ediv</td>
-<td>[UINT16]</td>
-<td>EDIV for LTK to use (use storage if not provided)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>rand</td>
-<td>[UINT64]</td>
-<td>Rand for LTK</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>ltk</td>
-<td>XX:XX:XX…</td>
-<td>LTK (16 bytes)</td>
-</tr>
-<tr class="row-odd"><td><strong>security-start</strong></td>
-<td> </td>
-<td> </td>
-<td>Start security procedure (This starts either pairing or encryption depending if keys are stored)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-odd"><td><strong>auth-passkey</strong></td>
-<td> </td>
-<td> </td>
-<td>Reply to Passkey request</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>action</td>
-<td>[UINT16]</td>
-<td>Action to reply (as received in event)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>key</td>
-<td>[0-999999]</td>
-<td>Passkey to reply (Input or Display action)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>oob</td>
-<td>XX:XX:XX:…</td>
-<td>Out-Of-Band secret (16 bytes) (OOB action)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>yesno</td>
-<td>Yy-Ny</td>
-<td>Confirm passkey (for Passkey Confirm action)</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="advertising-with-extended-advertising-enabled">
-<h3>Advertising with Extended Advertising enabled<a class="headerlink" href="#advertising-with-extended-advertising-enabled" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="18%" />
-<col width="15%" />
-<col width="17%" />
-<col width="50%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Command</strong></th>
-<th class="head"><strong>Parmeters</strong></th>
-<th class="head">** Possible values**</th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>advertise-configure</strong></td>
-<td> </td>
-<td> </td>
-<td>Configure new advertising instance</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>instance</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX]</td>
-<td>Advertising instance</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>connectable</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use connectable advertising</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>scannable</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use scannable advertising</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>peer_addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Remote device public address type</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Remote device random address type</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>public_id</td>
-<td>Remote device public address type (Identity)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>random_id</td>
-<td>Remote device random address type (Identity)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>peer_addr</td>
-<td>XX:XX:XX:XX:XX:XX</td>
-<td>Remote device address - if provided perform directed advertising</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>own_addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Use public address for scan requests</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Use random address for scan requests</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>rpa_pub</td>
-<td>Use RPA address for scan requests (fallback to public if no IRK)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>rpa_rnd</td>
-<td>Use RPA address for scan requests (fallback to random if no IRK)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>channel_map</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX}</td>
-<td>Primary advertising channels map. If 0 use all channels.</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>filter</td>
-<td><code class="docutils literal notranslate"><span class="pre">none</span></code></td>
-<td>Advertising filter policy - no filtering, no whitelist used</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>scan</td>
-<td>process all connection requests but only scans from white list</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>conn</td>
-<td>process all scan request but only connection requests from white list</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>both</td>
-<td>ignore all scan and connection requests unless in white list</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>interval_min</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT32_MAX]</td>
-<td>Minimum advertising interval in 0.625 miliseconds If 0 use stack default.</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>interval_max</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT32_MAX]</td>
-<td>Maximum advertising interval in 0.625 miliseconds If 0 use stack default.</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>rx_power</td>
-<td>[-127 - <code class="docutils literal notranslate"><span class="pre">127</span></code>]</td>
-<td>Advertising TX power in dBm</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>primary_phy</td>
-<td><code class="docutils literal notranslate"><span class="pre">1M</span></code></td>
-<td>Use 1M PHY on primary advertising channels</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td><code class="docutils literal notranslate"><span class="pre">coded</span></code></td>
-<td>Use Coded PHY on primary advertising channels</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>secondary_phy</td>
-<td><code class="docutils literal notranslate"><span class="pre">1M</span></code></td>
-<td>Use 1M PHY on secondary advertising channels</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td><code class="docutils literal notranslate"><span class="pre">coded</span></code></td>
-<td>Use coded PHY on primary advertising channels</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td><code class="docutils literal notranslate"><span class="pre">2M</span></code></td>
-<td>Use 2M PHY on primary advertising channels</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>sid</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-16]</td>
-<td>Adsertising instance SID</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>high_duty</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use high_duty advertising</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>anonymous</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use anonymous advertising</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>legacy</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use legacy PDUs for advertising</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>include_tx_power</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Include TX power information in advertising PDUs</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>scan_req_notif</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Enable SCAN_REQ notifications</td>
-</tr>
-<tr class="row-even"><td><strong>advertise-set-addr</strong></td>
-<td> </td>
-<td> </td>
-<td>Configure <em>random</em> adress for instance</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>instance</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX]</td>
-<td>Advertising instance</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>addr</td>
-<td>XX:XX:XX:XX:XX:XX</td>
-<td>Random address</td>
-</tr>
-<tr class="row-odd"><td><strong>advertise-set-adv-data</strong></td>
-<td> </td>
-<td> </td>
-<td>Configure advertising instance ADV_DATA. This allow to configure following TLVs:</td>
-</tr>
-<tr class="row-even"><td><strong>advertise-set-scan-rsp</strong></td>
-<td> </td>
-<td> </td>
-<td>Configure advertising instance SCAN_RSP. This allow to configure following TLVs:</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>instance</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX]</td>
-<td>Advertising instance</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>flags</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX]</td>
-<td>Flags value</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>uuid16</td>
-<td>[UINT16]</td>
-<td>16-bit UUID value (can be passed multiple times)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>uuid16_is_complete</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>I 16-bit UUID list is complete</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>uuid32</td>
-<td>[UINT32]</td>
-<td>32-bit UUID value (can be passed multiple times)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>uuid32_is_complete</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>I 32-bit UUID list is complete</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>uuid128</td>
-<td>XX:XX:XX:…</td>
-<td>128-bit UUID value (16 bytes) (can be passed multiple times)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>uuid128_is_complete</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>I 128-bit UUID list is complete</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>tx_power_level</td>
-<td>[-127 - 127]</td>
-<td>TX Power level to include</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>appearance</td>
-<td>[UINT16]</td>
-<td>Appearance</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>name</td>
-<td>string</td>
-<td>Name</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>advertising_interval</td>
-<td>[UINT16]</td>
-<td>Advertising interval</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>service_data_uuid32</td>
-<td>XX:XX:XX:…</td>
-<td>32-bit UUID service data</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>service_data_uuid128</td>
-<td>XX:XX:XX:…</td>
-<td>128-bit UUID service data</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>uri</td>
-<td>XX:XX:XX:…</td>
-<td>URI</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>msg_data</td>
-<td>XX:XX:XX:…</td>
-<td>Manufacturer data</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>eddystone_url</td>
-<td>string</td>
-<td>Eddystone with specified URL</td>
-</tr>
-<tr class="row-even"><td><strong>advertise-start</strong></td>
-<td> </td>
-<td> </td>
-<td>Start advertising with configured instance</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>instance</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX]</td>
-<td>Advertising instance</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>duration</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT16_MAX]</td>
-<td>Advertising duration in 10ms units. 0 - forver</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>max_events</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX]</td>
-<td>Maximum number of advertising events. 0 - no limit</td>
-</tr>
-<tr class="row-even"><td><strong>advertise-stop</strong></td>
-<td> </td>
-<td> </td>
-<td>Stop advertising</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>instance</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX]</td>
-<td>Advertising instance</td>
-</tr>
-<tr class="row-even"><td><strong>advertise-remove</strong></td>
-<td> </td>
-<td> </td>
-<td>Remove configured advertising instance</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>instance</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX]</td>
-<td>Advertising instance</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="legacy-advertising-with-extended-advertising-disabled">
-<h3>Legacy Advertising with Extended Advertising disabled<a class="headerlink" href="#legacy-advertising-with-extended-advertising-disabled" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="13%" />
-<col width="16%" />
-<col width="18%" />
-<col width="53%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Command</strong></th>
-<th class="head"><strong>Parmeters</strong></th>
-<th class="head">** Possible values**</th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>advertise</strong></td>
-<td> </td>
-<td> </td>
-<td>Enable advertising</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>stop</td>
-<td> </td>
-<td>Stop enabled advertising</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td><code class="docutils literal notranslate"><span class="pre">und</span></code></td>
-<td>Connectable mode: undirected</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>non</td>
-<td>non-connectable</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>dir</td>
-<td>directed</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>discov</td>
-<td><code class="docutils literal notranslate"><span class="pre">gen</span></code></td>
-<td>Discoverable mode: general discoverable</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>ltd</td>
-<td>limited discoverable</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>non</td>
-<td>non-discoverable</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>scannable</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use scannable advertising</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>peer_addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Remote device public address type</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Remote device random address type</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>public_id</td>
-<td>Remote device public address type (Identity)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>random_id</td>
-<td>Remote device random address type (Identity)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>peer_addr</td>
-<td>XX:XX:XX:XX:XX:XX</td>
-<td>Remote device address - if provided perform directed advertising</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>own_addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Use public address for scan requests</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Use random address for scan requests</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>rpa_pub</td>
-<td>Use RPA address for scan requests (fallback to public if no IRK)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>rpa_rnd</td>
-<td>Use RPA address for scan requests (fallback to random if no IRK)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>channel_map</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX}</td>
-<td>Primary advertising channels map. If 0 use all channels.</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>filter</td>
-<td><code class="docutils literal notranslate"><span class="pre">none</span></code></td>
-<td>Advertising filter policy - no filtering, no whitelist used</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>scan</td>
-<td>process all connection requests but only scans from white list</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>conn</td>
-<td>process all scan request but only connection requests from white list</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>both</td>
-<td>ignore all scan and connection requests unless in white list</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>interval_min</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT32_MAX]</td>
-<td>Minimum advertising interval in 0.625 miliseconds If 0 use stack default.</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>interval_max</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT32_MAX]</td>
-<td>Maximum advertising interval in 0.625 miliseconds If 0 use stack default.</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>high_duty</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use high_duty advertising</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>duration</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">1</span></code>-INT32_MAX]</td>
-<td>Advertising duration in ms</td>
-</tr>
-<tr class="row-odd"><td><strong>set-adv-data</strong></td>
-<td> </td>
-<td> </td>
-<td>Configure advertising instance ADV_DATA. This allow to configure following TLVs:</td>
-</tr>
-<tr class="row-even"><td><strong>set-scan-rsp</strong></td>
-<td> </td>
-<td> </td>
-<td>Configure advertising instance SCAN_RSP. This allow to configure following TLVs:</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>flags</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-UINT8_MAX]</td>
-<td>Flags value</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>uuid16</td>
-<td>[UINT16]</td>
-<td>16-bit UUID value (can be passed multiple times)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>uuid16_is_complete</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>I 16-bit UUID list is complete</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>uuid32</td>
-<td>[UINT32]</td>
-<td>32-bit UUID value (can be passed multiple times)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>uuid32_is_complete</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>I 32-bit UUID list is complete</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>uuid128</td>
-<td>XX:XX:XX:…</td>
-<td>128-bit UUID value (16 bytes) (can be passed multiple times)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>uuid128_is_complete</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>I 128-bit UUID list is complete</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>tx_power_level</td>
-<td>[-127 - 127]</td>
-<td>TX Power level to include</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>appearance</td>
-<td>[UINT16]</td>
-<td>Appearance</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>name</td>
-<td>string</td>
-<td>Name</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>advertising_interval</td>
-<td>[UINT16]</td>
-<td>Advertising interval</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>service_data_uuid32</td>
-<td>XX:XX:XX:…</td>
-<td>32-bit UUID service data</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>service_data_uuid128</td>
-<td>XX:XX:XX:…</td>
-<td>128-bit UUID service data</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>uri</td>
-<td>XX:XX:XX:…</td>
-<td>URI</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>msg_data</td>
-<td>XX:XX:XX:…</td>
-<td>Manufacturer data</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>eddystone_url</td>
-<td>string</td>
-<td>Eddystone with specified URL</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="l2cap-connection-oriented-channels">
-<h3>L2CAP Connection Oriented Channels<a class="headerlink" href="#l2cap-connection-oriented-channels" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="22%" />
-<col width="14%" />
-<col width="23%" />
-<col width="42%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Command</strong></th>
-<th class="head"><strong>Parmeters</strong></th>
-<th class="head">** Possible values**</th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>l2cap-create-server</strong></td>
-<td> </td>
-<td> </td>
-<td>Create L2CAP server</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>psm</td>
-<td>[UINT16]</td>
-<td>PSM</td>
-</tr>
-<tr class="row-even"><td><strong>l2cap-connect</strong></td>
-<td> </td>
-<td> </td>
-<td>Connect to remote L2CAP server</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>psm</td>
-<td>[UINT16]</td>
-<td>PSM</td>
-</tr>
-<tr class="row-odd"><td><strong>l2cap-disconnect</strong></td>
-<td> </td>
-<td> </td>
-<td>Disconnec from L2CAP server</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>idx</td>
-<td>[UINT16]</td>
-<td>L2CAP connection oriented channel identifier</td>
-</tr>
-<tr class="row-even"><td><strong>l2cap-send</strong></td>
-<td> </td>
-<td> </td>
-<td>Send data over connected L2CAP channel</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>idx</td>
-<td>[UINT16]</td>
-<td>L2CAP connection oriented channel identifier</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>bytes</td>
-<td>[UINT16]</td>
-<td>Number of bytes to send (hardcoded data pattern)</td>
-</tr>
-<tr class="row-even"><td><strong>l2cap-show-coc</strong></td>
-<td> </td>
-<td> </td>
-<td>Show connected L2CAP channels</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="keys-storage">
-<h3>Keys storage<a class="headerlink" href="#keys-storage" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="18%" />
-<col width="14%" />
-<col width="24%" />
-<col width="44%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Command</strong></th>
-<th class="head"><strong>Parmeters</strong></th>
-<th class="head">** Possible values**</th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>keystore-add</strong></td>
-<td> </td>
-<td> </td>
-<td>Add keys to storage</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>type</td>
-<td>msec</td>
-<td>Master Key</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>ssec</td>
-<td>Slave Key</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>cccd</td>
-<td>Client Characteristic Configuration Descriptor</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>addr</td>
-<td>XX:XX:XX:XX:XX:XX</td>
-<td>Device address</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Device address type</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Use random address for scan requests</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>ediv</td>
-<td>[UINT16]</td>
-<td>EDIV for LTK to add</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>rand</td>
-<td>[UINT64]</td>
-<td>Rand for LTK</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>ltk</td>
-<td>XX:XX:XX…</td>
-<td>LTK (16 bytes)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>irk</td>
-<td>XX:XX:XX…</td>
-<td>Identity Resolving Key (16 bytes)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>csrk</td>
-<td>XX:XX:XX…</td>
-<td>Connection Signature Resolving Key (16 bytes)</td>
-</tr>
-<tr class="row-even"><td><strong>keystore-del</strong></td>
-<td> </td>
-<td> </td>
-<td>Delete keys from storage</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>type</td>
-<td>msec</td>
-<td>Master Key</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>ssec</td>
-<td>Slave Key</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>cccd</td>
-<td>Client Characteristic Configuration Descriptor</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>addr</td>
-<td>XX:XX:XX:XX:XX:XX</td>
-<td>Device address</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>addr_type</td>
-<td><code class="docutils literal notranslate"><span class="pre">public</span></code></td>
-<td>Device address type</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>random</td>
-<td>Use random address for scan requests</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>ediv</td>
-<td>[UINT16]</td>
-<td>EDIV for LTK to remove</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>rand</td>
-<td>[UINT64]</td>
-<td>Rand for LTK</td>
-</tr>
-<tr class="row-odd"><td><strong>keystore-show</strong></td>
-<td> </td>
-<td> </td>
-<td>Show stored keys</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>type</td>
-<td>msec</td>
-<td>Master Keys</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>ssec</td>
-<td>Slave Keys</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>cccd</td>
-<td>Client Characteristic Configuration Descriptor s</td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="btshell_GATT.html" class="btn btn-neutral float-right" title="GATT feature API for btshell" accesskey="n">Next: GATT feature API for btshell <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="btshell_api.html" class="btn btn-neutral" title="API for btshell app" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: API for btshell app</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/btshell/btshell_GATT.html b/develop/network/docs/btshell/btshell_GATT.html
deleted file mode 100644
index 4a864b2e6..000000000
--- a/develop/network/docs/btshell/btshell_GATT.html
+++ /dev/null
@@ -1,596 +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">
-
-
-
-
- <title>GATT feature API for btshell — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="API for btshell app" href="btshell_api.html"/>
- <link rel="next" title="Advertisement Data Fields" href="btshell_advdata.html"/>
- <link rel="prev" title="GAP API for btshell" href="btshell_GAP.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="btshell_api.html">API for btshell app</a> /
-
- GATT feature API for btshell
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/btshell/btshell_GATT.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="btshell_api.html">btshell Usage API</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="btshell_GAP.html">GAP</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">GATT</a></li>
-<li class="toctree-l3"><a class="reference internal" href="btshell_advdata.html">Advertisement Data Fields</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="gatt-feature-api-for-btshell">
-<h1>GATT feature API for btshell<a class="headerlink" href="#gatt-feature-api-for-btshell" title="Permalink to this headline">¶</a></h1>
-<p>GATT(GENERIC ATTRIBUTE PROFILE) describes a service framework using the Attribute Protocol for discovering services,
-and for reading and writing characteristic values on a peer device. There are 11 features defined in the GATT Profile,
-and each of the features is mapped to procedures and sub-procedures:</p>
-<div class="section" id="available-commands">
-<h2>Available commands<a class="headerlink" href="#available-commands" title="Permalink to this headline">¶</a></h2>
-<p>Parameters default values (if applicable) are marked red.</p>
-<div class="section" id="configuration">
-<h3>Configuration<a class="headerlink" href="#configuration" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils">
-<colgroup>
-<col width="26%" />
-<col width="12%" />
-<col width="20%" />
-<col width="42%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Command</strong></th>
-<th class="head"><strong>Parmeters</strong></th>
-<th class="head">** Possible values**</th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>gatt-discover-characteristic</strong></td>
-<td> </td>
-<td> </td>
-<td>Discover GATT characteristics</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>uuid</td>
-<td>[UINT16]</td>
-<td>Characteristic UUID</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>start</td>
-<td>[UINT16]</td>
-<td>Discovery start handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>end</td>
-<td>[UINT16]</td>
-<td>Discovery end handle</td>
-</tr>
-<tr class="row-odd"><td><strong>gatt-discover-descriptor</strong></td>
-<td> </td>
-<td> </td>
-<td>Discover GATT descriptors</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>start</td>
-<td>[UINT16]</td>
-<td>Discovery start handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>end</td>
-<td>[UINT16]</td>
-<td>Discovery end handle</td>
-</tr>
-<tr class="row-odd"><td><strong>gatt-discover-service</strong></td>
-<td> </td>
-<td> </td>
-<td>Discover services</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>uuid16</td>
-<td>[UINT16]</td>
-<td>Service UUID</td>
-</tr>
-<tr class="row-even"><td><strong>gatt-discover-full</strong></td>
-<td> </td>
-<td> </td>
-<td>Discover services, characteristic and descriptors</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td><strong>gatt-find-included-services</strong></td>
-<td> </td>
-<td> </td>
-<td>Find included services</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>start</td>
-<td>[UINT16]</td>
-<td>Discovery start handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>end</td>
-<td>[UINT16]</td>
-<td>Discovery end handle</td>
-</tr>
-<tr class="row-even"><td><strong>gatt-exchange-mtu</strong></td>
-<td> </td>
-<td> </td>
-<td>Initiate ATT MTU exchange procedure</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td><strong>gatt-read</strong></td>
-<td> </td>
-<td> </td>
-<td>Read attribute</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>long</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Long read</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>attr</td>
-<td>[UINT16]</td>
-<td>Attribute handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>offset</td>
-<td>[UINT16]</td>
-<td>Long read offset value</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>uuid</td>
-<td>[UINT16]</td>
-<td>Characteristic UUID</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>start</td>
-<td>[UINT16]</td>
-<td>Discovery start handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>end</td>
-<td>[UINT16]</td>
-<td>Discovery end handle</td>
-</tr>
-<tr class="row-even"><td><strong>gatt-notify</strong></td>
-<td> </td>
-<td> </td>
-<td>Send notification or indication to all subscribed peers</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>attr</td>
-<td>[UINT16]</td>
-<td>Attribute handle</td>
-</tr>
-<tr class="row-even"><td><strong>gatt-service-changed</strong></td>
-<td> </td>
-<td> </td>
-<td>Send Services Changed notification</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>start</td>
-<td>[UINT16]</td>
-<td>Start handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>end</td>
-<td>[UINT16]</td>
-<td>End handle</td>
-</tr>
-<tr class="row-odd"><td><strong>gatt-service-visibility</strong></td>
-<td> </td>
-<td> </td>
-<td>Set service visibility</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>handle</td>
-<td>[UINT16]</td>
-<td>Service handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>visibility</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Service visibility</td>
-</tr>
-<tr class="row-even"><td><strong>gatt-show</strong></td>
-<td> </td>
-<td> </td>
-<td>Show remote devices discovered databases structure</td>
-</tr>
-<tr class="row-odd"><td><strong>gatt-show-local</strong></td>
-<td> </td>
-<td> </td>
-<td>Show local database structure</td>
-</tr>
-<tr class="row-even"><td><strong>gatt-write</strong></td>
-<td> </td>
-<td> </td>
-<td>Write attribute</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>conn</td>
-<td>[UINT16]</td>
-<td>Connection handle</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>no_rsp</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use Write Without Response</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>long</td>
-<td>[<code class="docutils literal notranslate"><span class="pre">0</span></code>-1]</td>
-<td>Use Long Write procedure</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>attr</td>
-<td>[UINT16]</td>
-<td>Attribute handle</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>offset</td>
-<td>[UINT16]</td>
-<td>Long write offset value</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>value</td>
-<td>XX:XX:XX…</td>
-<td>Data to write</td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="btshell_advdata.html" class="btn btn-neutral float-right" title="Advertisement Data Fields" accesskey="n">Next: Advertisement Data Fields <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="btshell_GAP.html" class="btn btn-neutral" title="GAP API for btshell" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: GAP API for btshell</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/btshell/btshell_advdata.html b/develop/network/docs/btshell/btshell_advdata.html
deleted file mode 100644
index 495fa4388..000000000
--- a/develop/network/docs/btshell/btshell_advdata.html
+++ /dev/null
@@ -1,455 +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">
-
-
-
-
- <title>Advertisement Data Fields — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="API for btshell app" href="btshell_api.html"/>
- <link rel="next" title="Bluetooth Mesh" href="../mesh/index.html"/>
- <link rel="prev" title="GATT feature API for btshell" href="btshell_GATT.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="btshell_api.html">API for btshell app</a> /
-
- Advertisement Data Fields
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/btshell/btshell_advdata.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="btshell_api.html">btshell Usage API</a><ul class="current">
-<li class="toctree-l3"><a class="reference internal" href="btshell_GAP.html">GAP</a></li>
-<li class="toctree-l3"><a class="reference internal" href="btshell_GATT.html">GATT</a></li>
-<li class="toctree-l3 current"><a class="current reference internal" href="#">Advertisement Data Fields</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="advertisement-data-fields">
-<h1>Advertisement Data Fields<a class="headerlink" href="#advertisement-data-fields" title="Permalink to this headline">¶</a></h1>
-<p>This part defines the advertisement data fields used in the <code class="docutils literal notranslate"><span class="pre">btshell</span></code> app. For a complete list of all data types and
-formats used for Extended Inquiry Response (EIR), Advertising Data (AD), and OOB data blocks, refer to the Supplement
-to the Bluetooth Core Specification, CSSv6, available for download
-<a class="reference external" href="https://www.bluetooth.org/DocMan/handlers/DownloadDoc.ashx?doc_id=302735&_ga=1.133090766.1368218946.1444779486">here</a>.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="3%" />
-<col width="7%" />
-<col width="84%" />
-<col width="6%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Name</strong></th>
-<th class="head"><strong>Definition</strong></th>
-<th class="head"><strong>Details</strong></th>
-<th class="head"><strong>btshell Notes</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>flags</td>
-<td>Indicates basic information about the advertiser.</td>
-<td>Flags used over the LE physical channel are: * Limited Discoverable Mode * General Discoverable Mode * BR/EDR Not Supported * Simultaneous LE and BR/EDR to Same Device Capable (Controller) * Simultaneous LE and BR/EDR to Same Device Capable (Host)</td>
-<td>NimBLE will auto-calculate if set to 0.</td>
-</tr>
-<tr class="row-odd"><td>uuid16</td>
-<td>16-bit Bluetooth Service UUIDs</td>
-<td>Indicates the Service UUID list is incomplete i.e. more 16-bit Service UUIDs available. 16 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.</td>
-<td>Set repeatedly for multiple service UUIDs.</td>
-</tr>
-<tr class="row-even"><td>uuid16_is_complete</td>
-<td>16-bit Bluetooth Service UUIDs</td>
-<td>Indicates the Service UUID list is complete. 16 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.</td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td>uuid32</td>
-<td>32-bit Bluetooth Service UUIDs</td>
-<td>Indicates the Service UUID list is incomplete i.e. more 32-bit Service UUIDs available. 32 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.</td>
-<td>Set repeatedly for multiple service UUIDs.</td>
-</tr>
-<tr class="row-even"><td>uuid32_is_complete</td>
-<td>32-bit Bluetooth Service UUIDs</td>
-<td>Indicates the Service UUID list is complete. 32 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.</td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td>uuid128</td>
-<td>Global 128-bit Service UUIDs</td>
-<td>More 128-bit Service UUIDs available.</td>
-<td>Set repeatedly for multiple service UUIDs.</td>
-</tr>
-<tr class="row-even"><td>uuid128_is_complete</td>
-<td>Global 128-bit Service UUIDs</td>
-<td>Complete list of 128-bit Service UUIDs</td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td>tx_power_level</td>
-<td>TX Power Level</td>
-<td>Indicates the transmitted power level of the packet containing the data type. The TX Power Level data type may be used to calculate path loss on a received packet using the following equation: pathloss = Tx Power Level – RSSI where “RSSI” is the received signal strength, in dBm, of the packet received.</td>
-<td>NimBLE will auto-calculate if set to -128.</td>
-</tr>
-<tr class="row-even"><td>slave_interval_range</td>
-<td>Slave Connection Interval Range</td>
-<td>Contains the Peripheral’s preferred connection interval range, for all logical connections. Size: 4 Octets . The first 2 octets defines the minimum value for the connection interval in the following manner: connIntervalmin = Conn_Interval_Min * 1.25 ms Conn_Interval_Min range: 0x0006 to 0x0C80 Value of 0xFFFF indicates no specific minimum. The other 2 octets defines the maximum value for the connection interval in the following manner: connIntervalmax = Conn_Interval_Max * 1.25 ms Conn_Interval_Max range: 0x0006 to 0x0C80 Conn_Interval_Max shall be equal to or greater than the Conn_Interval_Min. Value of 0xFFFF indicates no specific maximum.</td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td>service_data_uuid16</td>
-<td>Service Data - 16 bit UUID</td>
-<td>Size: 2 or more octets The first 2 octets contain the 16 bit Service UUID followed by additional service data</td>
-<td> </td>
-</tr>
-<tr class="row-even"><td>public_target_address</td>
-<td>Public Target Address</td>
-<td>Defines the address of one or more intended recipients of an advertisement when one or more devices were bonded using a public address. This data type shall exist only once. It may be sent in either the Advertising or Scan Response data, but not both.</td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td>appearance</td>
-<td>Appearance</td>
-<td>Defines the external appearance of the device. The Appearance data type shall exist only once. It may be sent in either the Advertising or Scan Response data, but not both.</td>
-<td> </td>
-</tr>
-<tr class="row-even"><td>advertising_interval</td>
-<td>Advertising Interval</td>
-<td>Contains the advInterval value as defined in the Core specification, Volume 6, Part B, Section 4.4.2.2.</td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td>service_data_uuid32</td>
-<td>Service Data - 32 bit UUID</td>
-<td>Size: 4 or more octets The first 4 octets contain the 32 bit Service UUID followed by additional service data</td>
-<td> </td>
-</tr>
-<tr class="row-even"><td>service_data_uuid128</td>
-<td>Service Data - 128 bit UUID</td>
-<td>Size: 16 or more octets The first 16 octets contain the 128 bit Service UUID followed by additional service data</td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td>uri</td>
-<td>Uniform Resource Identifier (URI)</td>
-<td>Scheme name string and URI as a UTF-8 string</td>
-<td> </td>
-</tr>
-<tr class="row-even"><td>mfg_data</td>
-<td>Manufacturer Specific data</td>
-<td>Size: 2 or more octets The first 2 octets contain the Company Identifier Code followed by additional manufacturer specific data</td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td>eddystone_url</td>
-<td> </td>
-<td> </td>
-<td> </td>
-</tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="../mesh/index.html" class="btn btn-neutral float-right" title="Bluetooth Mesh" accesskey="n">Next: Bluetooth Mesh <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="btshell_GATT.html" class="btn btn-neutral" title="GATT feature API for btshell" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: GATT feature API for btshell</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/btshell/btshell_api.html b/develop/network/docs/btshell/btshell_api.html
deleted file mode 100644
index 7edb21018..000000000
--- a/develop/network/docs/btshell/btshell_api.html
+++ /dev/null
@@ -1,464 +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">
-
-
-
-
- <title>API for btshell app — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="BLE User Guide" href="../index.html"/>
- <link rel="next" title="GAP API for btshell" href="btshell_GAP.html"/>
- <link rel="prev" title="NimBLE Host ATT Client Reference" href="../ble_hs/ble_att.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- API for btshell app
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/btshell/btshell_api.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">btshell Usage API</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="btshell_GAP.html">GAP</a></li>
-<li class="toctree-l3"><a class="reference internal" href="btshell_GATT.html">GATT</a></li>
-<li class="toctree-l3"><a class="reference internal" href="btshell_advdata.html">Advertisement Data Fields</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="../mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="api-for-btshell-app">
-<h1>API for btshell app<a class="headerlink" href="#api-for-btshell-app" title="Permalink to this headline">¶</a></h1>
-<p>“btshell” is one of the sample applications that come with Mynewt. It is a shell application which provides a basic
-interface to the host-side of the BLE stack. “btshell” includes all the possible roles (Central/Peripheral) and they may
-be run simultaneously. You can run btshell on a board and issue commands that make it behave as a central or a peripheral
-with different peers.</p>
-<p><strong>btshell</strong> is a new application that uses shell subsystem introduced in Mynewt 1.1 and has updated commands and
-parameters names. Thanks to support for tab completion commands names are more descriptive and self-explanatory
-without requiring extensive typing.</p>
-<p>Highlighted below are some of the ways you can use the API to establish connections and discover services and
-characteristics from peer devices. For descriptions of the full API, go to the next sections on
-<a class="reference internal" href="btshell_GAP.html"><span class="doc">GAP API for btshell</span></a> and <a class="reference internal" href="btshell_GATT.html"><span class="doc">GATT feature API for btshell</span></a>.</p>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#set-device-address" id="id1">Set device address.</a></li>
-<li><a class="reference internal" href="#initiate-a-direct-connection-to-a-device" id="id2">Initiate a direct connection to a device</a></li>
-<li><a class="reference internal" href="#configure-advertisements-to-include-device-name" id="id3">Configure advertisements to include device name</a></li>
-<li><a class="reference internal" href="#begin-sending-undirected-general-advertisements" id="id4">Begin sending undirected general advertisements</a></li>
-<li><a class="reference internal" href="#show-established-connections" id="id5">Show established connections.</a></li>
-<li><a class="reference internal" href="#discover-and-display-peer-s-services-characteristics-and-descriptors" id="id6">Discover and display peer’s services, characteristics, and descriptors.</a></li>
-<li><a class="reference internal" href="#read-an-attribute-belonging-to-the-peer" id="id7">Read an attribute belonging to the peer</a></li>
-<li><a class="reference internal" href="#write-to-an-attribute-belonging-to-the-peer" id="id8">Write to an attribute belonging to the peer</a></li>
-<li><a class="reference internal" href="#perform-a-passive-scan" id="id9">Perform a passive scan</a></li>
-</ul>
-</div>
-<div class="toctree-wrapper compound">
-</div>
-<div class="section" id="set-device-address">
-<h2><a class="toc-backref" href="#id1">Set device address.</a><a class="headerlink" href="#set-device-address" title="Permalink to this headline">¶</a></h2>
-<p>On startup, btshell has the following identity address configuration:</p>
-<ul class="simple">
-<li>Public address: None</li>
-<li>Random address: None</li>
-</ul>
-<p>The below <code class="docutils literal notranslate"><span class="pre">set</span></code> commands can be used to change the address configuration:</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>set addr_type=public addr=<device-address>
-set addr_type=random addr=<device-address>
-</pre></div>
-</div>
-<p>For example:</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>set addr_type=public addr=01:02:03:04:05:06
-set addr_type=random addr=c1:aa:bb:cc:dd:ee
-</pre></div>
-</div>
-<p>The address configuration can be viewed with the <code class="docutils literal notranslate"><span class="pre">gatt-show-addr</span></code> command, as follows:</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>gatt-show-addr
-public_id_addr=01:02:03:04:05:06 random_id_addr=c1:aa:bb:cc:dd:ee
-</pre></div>
-</div>
-</div>
-<div class="section" id="initiate-a-direct-connection-to-a-device">
-<h2><a class="toc-backref" href="#id2">Initiate a direct connection to a device</a><a class="headerlink" href="#initiate-a-direct-connection-to-a-device" title="Permalink to this headline">¶</a></h2>
-<p>In this case, your board is acting as a central and initiating a connection with another BLE device. The example
-assumes you know the address of the peer, either by scanning for available peers or because you have set up the peer
-yourself.</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span><span class="hll">connect peer_addr=d4:f5:13:53:d2:43
-</span>connection established; handle=1 our_ota_addr_type=0 our_ota_addr=0a:0b:0c:0d:0e:0f out_id_addr_type=0 our_id_addr=0a:0b:0c:0d:0e:0f peer_addr_type=0 peer_addr=43:d2:53:13:f5:d4 conn_itvl=40 conn_latency=0 supervision_timeout=256 encrypted=0 authenticated=0 bonded=0
-</pre></div>
-</div>
-<p>The <code class="docutils literal notranslate"><span class="pre">handle=1</span></code> in the output indicates that it is connection-1.</p>
-</div>
-<div class="section" id="configure-advertisements-to-include-device-name">
-<h2><a class="toc-backref" href="#id3">Configure advertisements to include device name</a><a class="headerlink" href="#configure-advertisements-to-include-device-name" title="Permalink to this headline">¶</a></h2>
-<p>In this case, your board is acting as a peripheral.</p>
-<p>With Extended Advertising enabled (should be executed after advertise-configure):</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>advertise-set-adv-data name=<your-device-name>
-</pre></div>
-</div>
-<p>With Extended Advertising disabled:</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>set-adv-data name=<your-device-name>
-</pre></div>
-</div>
-</div>
-<div class="section" id="begin-sending-undirected-general-advertisements">
-<h2><a class="toc-backref" href="#id4">Begin sending undirected general advertisements</a><a class="headerlink" href="#begin-sending-undirected-general-advertisements" title="Permalink to this headline">¶</a></h2>
-<p>In this case, your board is acting as a peripheral.</p>
-<p>With Extended Advertising enabled:</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>advertise-configure connectable=1 legacy=1 scannable=1
-advertise-start
-</pre></div>
-</div>
-<p>With Extended Advertising disabled:</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>advertise conn=und discov=gen
-</pre></div>
-</div>
-</div>
-<div class="section" id="show-established-connections">
-<h2><a class="toc-backref" href="#id5">Show established connections.</a><a class="headerlink" href="#show-established-connections" title="Permalink to this headline">¶</a></h2>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>gatt-show-conn
-</pre></div>
-</div>
-</div>
-<div class="section" id="discover-and-display-peer-s-services-characteristics-and-descriptors">
-<h2><a class="toc-backref" href="#id6">Discover and display peer’s services, characteristics, and descriptors.</a><a class="headerlink" href="#discover-and-display-peer-s-services-characteristics-and-descriptors" title="Permalink to this headline">¶</a></h2>
-<p>This is how you discover and then display the services of the peer you established earlier across connection-1.</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span><span class="hll">gatt-discover-full conn=1
-</span><span class="hll">gatt-show
-</span>[ts=132425ssb, mod=64 level=2] CONNECTION: handle=1 addr=d4:f5:13:53:d2:43
-[ts=132428ssb, mod=64 level=2] start=1 end=5 uuid=0x1800
-[ts=132433ssb, mod=64 level=2] start=6 end=16 uuid=0x1808
-[ts=132437ssb, mod=64 level=2] start=17 end=31 uuid=0x180a
-[ts=132441ssb, mod=64 level=2] start=32 end=65535 uuid=00000000-0000-1000-1000000000000000
-</pre></div>
-</div>
-</div>
-<div class="section" id="read-an-attribute-belonging-to-the-peer">
-<h2><a class="toc-backref" href="#id7">Read an attribute belonging to the peer</a><a class="headerlink" href="#read-an-attribute-belonging-to-the-peer" title="Permalink to this headline">¶</a></h2>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>gatt-read conn=1 attr=21
-</pre></div>
-</div>
-</div>
-<div class="section" id="write-to-an-attribute-belonging-to-the-peer">
-<h2><a class="toc-backref" href="#id8">Write to an attribute belonging to the peer</a><a class="headerlink" href="#write-to-an-attribute-belonging-to-the-peer" title="Permalink to this headline">¶</a></h2>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>gatt-write conn=1 attr=3 value=0x01:0x02:0x03
-</pre></div>
-</div>
-</div>
-<div class="section" id="perform-a-passive-scan">
-<h2><a class="toc-backref" href="#id9">Perform a passive scan</a><a class="headerlink" href="#perform-a-passive-scan" title="Permalink to this headline">¶</a></h2>
-<p>This is how you tell your board to listen to all advertisements around it. The duration is specified in ms.</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>scan duration=1000 passive=1 filter=no_wl
-</pre></div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="btshell_GAP.html" class="btn btn-neutral float-right" title="GAP API for btshell" accesskey="n">Next: GAP API for btshell <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="../ble_hs/ble_att.html" class="btn btn-neutral" title="NimBLE Host ATT Client Reference" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: NimBLE Host ATT Client Reference</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/index.html b/develop/network/docs/index.html
deleted file mode 100644
index 6d3767937..000000000
--- a/develop/network/docs/index.html
+++ /dev/null
@@ -1,446 +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">
-
-
-
-
- <title>BLE User Guide — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../genindex.html"/>
- <link rel="search" title="Search" href="../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../index.html"/>
- <link rel="next" title="NimBLE Security" href="ble_sec.html"/>
- <link rel="prev" title="JSON" href="../../os/modules/json/json.html"/>
-
-
- <script src="../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- BLE User Guide
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/index.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="current reference internal" href="#">BLE User Guide</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2"><a class="reference internal" href="ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2"><a class="reference internal" href="btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="mesh/index.html">Bluetooth Mesh</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="ble-user-guide">
-<h1>BLE User Guide<a class="headerlink" href="#ble-user-guide" title="Permalink to this headline">¶</a></h1>
-<p>Apache Mynewt offers the world’s first fully open-source Bluetooth Low
-Energy (BLE) or Bluetooth Smart stack fully compliant with Bluetooth 5
-specifications with support for Bluetooth Mesh. It is called NimBLE.</p>
-<p>BLE technology operates in the unlicensed industrial, scientific and
-medical (ISM) band at 2.4 to 2.485 GHz which is available in most
-countries. It uses a spread spectrum, frequency hopping, full-duplex
-signal. BLE FHSS employs 40 2-MHz-wide channels to ensure greater
-reliability over longer distances. It also features 0-dBm (1 mW) power
-output and a typical maximum range of 50 meters. With Bluetooth 5
-specification range can be increased 4 times and speed 2 time.</p>
-<div class="toctree-wrapper compound">
-</div>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#features" id="id1">Features</a></li>
-<li><a class="reference internal" href="#bluetooth-mesh-features" id="id2">Bluetooth Mesh features</a></li>
-<li><a class="reference internal" href="#components" id="id3">Components</a></li>
-<li><a class="reference internal" href="#example-nimble-projects" id="id4">Example NimBLE projects</a></li>
-</ul>
-</div>
-<p>Note that BLE is not compatible with standard Bluetooth.</p>
-<div class="section" id="features">
-<h2><a class="toc-backref" href="#id1">Features</a><a class="headerlink" href="#features" title="Permalink to this headline">¶</a></h2>
-<p>NimBLE complies with Bluetooth Core Specification 5.0 which makes it an
-ideal wireless technology for the Internet of Things (IoT).</p>
-<ul class="simple">
-<li>LE Advertising Extensions</li>
-<li>2Msym/s PHY for higher throughput</li>
-<li>Coded PHY for LE Long Range</li>
-<li>High Duty Cycle Non-Connectable Advertising</li>
-<li>Channel Selection Algorithm #2 to utilize channels in more efficient
-way.</li>
-<li>LE Privacy 1.2 for frequent changes to the device address to make it
-difficult to track for outsiders</li>
-<li>LE Secure Connections featuring FIPS-compliant algorithms.</li>
-<li>LE Data Length Extension for higher throughput</li>
-<li><strong>Coming Soon</strong>: Assigning an Internet Protocol (IP) address
-(complaint with the IPv6 or 6LoWPAN standard) to a Bluetooth device
-through Internet Protocol Support Profile (IPSP)</li>
-</ul>
-<p>The Bluetooth 5 is backward compatible with previous Bluetooth version
-4.2 which is also supported by Apache Mynewt.</p>
-</div>
-<div class="section" id="bluetooth-mesh-features">
-<h2><a class="toc-backref" href="#id2">Bluetooth Mesh features</a><a class="headerlink" href="#bluetooth-mesh-features" title="Permalink to this headline">¶</a></h2>
-<p>Bluetooth Mesh is a great addition to and opens a wide range of new
-possibilities for the IoT connectivity space. NimBLE fully supports the
-following Bluetooth Mesh features:</p>
-<ul class="simple">
-<li>Advertising and GATT bearers</li>
-<li>PB-GATT and PB-ADV provisioning</li>
-<li>Foundation Models (server role)</li>
-<li>Relay support</li>
-<li>GATT Proxy</li>
-</ul>
-</div>
-<div class="section" id="components">
-<h2><a class="toc-backref" href="#id3">Components</a><a class="headerlink" href="#components" title="Permalink to this headline">¶</a></h2>
-<p>A Bluetooth low energy stack (NimBLE included) consists of two
-components with several subcomponents:</p>
-<ul class="simple">
-<li><strong>Controller</strong><ul>
-<li><strong>Physical Layer</strong>: adaptive frequency-hopping Gaussian Frequency
-Shift Keying (GFSK) radio using 40 RF channels (0-39), with 2 MHz
-spacing.</li>
-<li><strong>Link Layer</strong>: with one of five states (Standby, Advertising,
-Scanning, Initiating, Connection states) active at any time</li>
-</ul>
-</li>
-<li><strong>Host</strong><ul>
-<li><strong>Logical Link Control and Adaptation Protocol (L2CAP)</strong>: provides
-logical channels, named L2CAP channels, which are multiplexed over
-one or more logical links to provide packet segmentation and
-reassembly, flow control, error control, streaming, QoS etc.</li>
-<li><strong>Security Manager (SM)</strong>: uses Security Manager Protocol (SMP)
-for pairing and transport specific key distribution for securing
-radio communication</li>
-<li><strong>Attribute protocol (ATT)</strong>: allows a device (<em>Server</em>) to expose
-certain pieces of data, known as <em>Attributes</em>, to another device
-(<em>Client</em>)</li>
-<li><strong>Generic Attribute Profile (GATT)</strong>: a framework for using the
-ATT protocol to exchange attributes encapsulated as
-<em>Characteristics</em> or <em>Services</em></li>
-<li><strong>Generic Access Profile (GAP)</strong>: a base profile which all
-Bluetooth devices implement, which in the case of LE, defines the
-Physical Layer, Link Layer, L2CAP, Security Manager, Attribute
-Protocol and Generic Attribute Profile.</li>
-<li><strong>Host Controller Interface (HCI)</strong>: the interface between the
-host and controller either through software API or by a hardware
-interface such as SPI, UART or USB.</li>
-</ul>
-</li>
-</ul>
-<p>Subsequent chapters in this manual will go into the details of the
-implementation of each component, APIs available, and things to consider
-while designing a NimBLE app.</p>
-</div>
-<div class="section" id="example-nimble-projects">
-<h2><a class="toc-backref" href="#id4">Example NimBLE projects</a><a class="headerlink" href="#example-nimble-projects" title="Permalink to this headline">¶</a></h2>
-<p>Mynewt comes with two built-in projects that allow users to play with
-NimBLE, try the tutorials out with, and see how to use available
-services.</p>
-<ol class="arabic simple">
-<li><strong>btshell</strong> : A simple shell application which provides a basic
-interface to the host-side of the BLE stack.</li>
-<li><strong>bleprph</strong>: A basic peripheral device with no user interface. It
-advertises automatically on startup, and resumes advertising whenever
-a connection is terminated. It supports a maximum of one connection.</li>
-<li><strong>blemesh</strong>: A sample application for Bluetooth Mesh Node using
-on/off model.</li>
-</ol>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="ble_sec.html" class="btn btn-neutral float-right" title="NimBLE Security" accesskey="n">Next: NimBLE Security <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="../../os/modules/json/json.html" class="btn btn-neutral" title="JSON" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: JSON</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/mesh/index.html b/develop/network/docs/mesh/index.html
deleted file mode 100644
index 516b4ce88..000000000
--- a/develop/network/docs/mesh/index.html
+++ /dev/null
@@ -1,433 +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">
-
-
-
-
- <title>Bluetooth Mesh — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="BLE User Guide" href="../index.html"/>
- <link rel="next" title="Sample application" href="sample.html"/>
- <link rel="prev" title="Advertisement Data Fields" href="../btshell/btshell_advdata.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- Bluetooth Mesh
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/mesh/index.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="#">Bluetooth Mesh</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="sample.html">Sample application</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="bluetooth-mesh">
-<h1>Bluetooth Mesh<a class="headerlink" href="#bluetooth-mesh" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-</div>
-<div class="contents local topic" id="contents">
-<ul class="simple">
-<li><a class="reference internal" href="#introduction-to-mesh" id="id1">Introduction to Mesh</a></li>
-<li><a class="reference internal" href="#topology" id="id2">Topology</a></li>
-<li><a class="reference internal" href="#bearers" id="id3">Bearers</a></li>
-<li><a class="reference internal" href="#provisioning" id="id4">Provisioning</a></li>
-<li><a class="reference internal" href="#models" id="id5">Models</a></li>
-<li><a class="reference internal" href="#mesh-node-features-supported-by-apache-mynewt" id="id6">Mesh Node features supported by Apache Mynewt</a></li>
-</ul>
-</div>
-<div class="section" id="introduction-to-mesh">
-<h2><a class="toc-backref" href="#id1">Introduction to Mesh</a><a class="headerlink" href="#introduction-to-mesh" title="Permalink to this headline">¶</a></h2>
-<p>Bluetooth Mesh is a new standard from Bluetooth SIG that was released in 2017. It enables many-to-many device
-communication (as opposed to point-to-point approach in BLE) and is optimised for large-scale networks like building
-automation or sensors network. It utilizes managed flood based approach where only mains-powered nodes relay messages
-making it very power efficient (battery powered low-power nodes that don’t relay messages can operate in mesh network for years).</p>
-<p>Bluetooth Mesh is complementary to Bluetooth specification and requires features from 4.0 release only. This allows
-deployment of networks using hardware already available on the market.</p>
-</div>
-<div class="section" id="topology">
-<h2><a class="toc-backref" href="#id2">Topology</a><a class="headerlink" href="#topology" title="Permalink to this headline">¶</a></h2>
-<div class="figure">
-<img alt="Bluetooth Mesh Topology (source: Mesh Profile Specification 1.0)" src="../../../_images/mesh_topology.jpg" />
-</div>
-<p>Bluetooth Mesh defines few features (roles) for devices in network. Those are:</p>
-<ul class="simple">
-<li>Relay - receive and retransmit mesh messages over the advertising bearer to enable larger networks</li>
-<li>Proxy - receive and retransmit mesh messages between GATT and advertising bearers.</li>
-<li>Low Power - operate within a mesh network at significantly reduced receiver duty cycles only in conjunction with a
-node supporting the Friend feature</li>
-<li>Friend - the ability to help a node supporting the Low Power feature to operate by storing messages destined for those nodes</li>
-</ul>
-</div>
-<div class="section" id="bearers">
-<h2><a class="toc-backref" href="#id3">Bearers</a><a class="headerlink" href="#bearers" title="Permalink to this headline">¶</a></h2>
-<p>Mesh Profile specification allows two kinds of bearers for transmitting data:</p>
-<ul class="simple">
-<li>Advertising Bearer<ul>
-<li>Uses LE advertising to broadcast messages to all nodes that are listening at this time</li>
-<li>Uses non-connectable advertising only</li>
-<li>29 octets of network message</li>
-</ul>
-</li>
-<li>GATT Bearer<ul>
-<li>Uses LE Connections to send messages</li>
-<li>Uses standard GATT service (one for Provisioning and one for Proxy)</li>
-</ul>
-</li>
-</ul>
-</div>
-<div class="section" id="provisioning">
-<h2><a class="toc-backref" href="#id4">Provisioning</a><a class="headerlink" href="#provisioning" title="Permalink to this headline">¶</a></h2>
-<p>Provisioning is a process of adding an unprovisioned device to a mesh network managed by a Provisioner. A Provisioner
-provides the unprovisioned device with provisioning data that allows it to become a mesh node (network key, current IV
-index and unicast address). A Provisioner is typically a smart phone or other mobile computing device.</p>
-</div>
-<div class="section" id="models">
-<h2><a class="toc-backref" href="#id5">Models</a><a class="headerlink" href="#models" title="Permalink to this headline">¶</a></h2>
-<p>Models define basic functionality of nodes on a mesh network. Mesh Profile Specification defines foundation models used
-to configure and manage network. Mesh Model Specification includes models defininig functionality that is standard
-across device types. Those consists of:</p>
-<ul class="simple">
-<li>Generics - root models<ul>
-<li>On/Off</li>
-<li>Level</li>
-<li>Battery Server</li>
-<li>Location</li>
-<li>Client Property</li>
-<li>and others</li>
-</ul>
-</li>
-<li>Sensors - defines a standard way of interfacing with sensors</li>
-<li>Time and Scenes - defines a set of functionalities related to time and saved states on devices</li>
-<li>Lighting - defines a set functionalities related to lighting control</li>
-</ul>
-<p>Complex models e.g. Lighting may contain other models eg Generic On/Off. The following image shows an example of Light
-Lightness Server Model.</p>
-<div class="figure">
-<img alt="Light Lightness Server model (source: Mesh Model Specification 1.0)" src="../../../_images/mesh_lightning_model.jpg" />
-</div>
-</div>
-<div class="section" id="mesh-node-features-supported-by-apache-mynewt">
-<h2><a class="toc-backref" href="#id6">Mesh Node features supported by Apache Mynewt</a><a class="headerlink" href="#mesh-node-features-supported-by-apache-mynewt" title="Permalink to this headline">¶</a></h2>
-<ul class="simple">
-<li>Advertising and GATT bearers</li>
-<li>PB-GATT and PB-ADV provisioning</li>
-<li>Foundation Models (server role)</li>
-<li>Relay support</li>
-<li>GATT Proxy</li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="sample.html" class="btn btn-neutral float-right" title="Sample application" accesskey="n">Next: Sample application <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="../btshell/btshell_advdata.html" class="btn btn-neutral" title="Advertisement Data Fields" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Advertisement Data Fields</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/network/docs/mesh/sample.html b/develop/network/docs/mesh/sample.html
deleted file mode 100644
index 69ec0aed9..000000000
--- a/develop/network/docs/mesh/sample.html
+++ /dev/null
@@ -1,364 +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">
-
-
-
-
- <title>Sample application — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../../genindex.html"/>
- <link rel="search" title="Search" href="../../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../../index.html"/>
- <link rel="up" title="Bluetooth Mesh" href="index.html"/>
- <link rel="next" title="Newt Tool Guide" href="../../../newt/index.html"/>
- <link rel="prev" title="Bluetooth Mesh" href="index.html"/>
-
-
- <script src="../../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">BLE User Guide</a> /
-
- <a href="index.html">Bluetooth Mesh</a> /
-
- Sample application
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-core/edit/master/docs/network/docs/mesh/sample.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../../../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="../index.html">BLE User Guide</a><ul class="current">
-<li class="toctree-l2"><a class="reference internal" href="../ble_sec.html">NimBLE Security</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_setup/ble_setup_intro.html">NimBLE Setup</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../ble_hs/ble_hs.html">NimBLE Host</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../btshell/btshell_api.html">btshell Usage API</a></li>
-<li class="toctree-l2 current"><a class="reference internal" href="index.html">Bluetooth Mesh</a><ul class="current">
-<li class="toctree-l3 current"><a class="current reference internal" href="#">Sample application</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newt/index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="sample-application">
-<h1>Sample application<a class="headerlink" href="#sample-application" title="Permalink to this headline">¶</a></h1>
-<p><strong>blemesh</strong> sample application implements Bluetooth Mesh node that supports On/Off and Level models.</p>
-<p>To build application use following target. Note that since this application uses Non-resolvable Private Address there is
-no need for configuring public address.</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>newt target create blemesh
-newt target set blemesh app=@apache-mynewt-core/apps/blemesh
-newt target set blemesh bsp=@apache-mynewt-core/hw/bsp/nrf52840pdk
-newt target set blemesh build_profile=optimized
-newt target set blemesh syscfg=BLE_MESH_PB_GATT=1:BLE_MESH_DEV_UUID='(uint8_t[16]){0x22, 0x20, 0}'
-</pre></div>
-</div>
-<p>Every device should have unique Device UUID so config amend and rebuild is needed for each of the devices that will be
-added to a network.</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>newt target set blemesh syscfg=BLE_MESH_PB_GATT=1:BLE_MESH_DEV_UUID='(uint8_t[16]){0x22, 0x21, 0}'
-...
-newt target set blemesh syscfg=BLE_MESH_PB_GATT=1:BLE_MESH_DEV_UUID='(uint8_t[16]){0x22, 0x22, 0}'
-...
-newt target set blemesh syscfg=BLE_MESH_PB_GATT=1:BLE_MESH_DEV_UUID='(uint8_t[16]){0x22, 0x23, 0}'
-</pre></div>
-</div>
-<p>GATT bearer is enabled so that it is possible to provision those with Bluetooth Mesh application from Silicon Labs
-(available <a class="reference external" href="https://play.google.com/store/apps/details?id=com.siliconlabs.bluetoothmesh">here</a>) which doesn’t
-support advertising bearer.</p>
-</div>
-
-
- </div>
- </div>
-
- <div class="rst-footer-buttons row" role="navigation" aria-label="footer navigation">
-
- <a href="../../../newt/index.html" class="btn btn-neutral float-right" title="Newt Tool Guide" accesskey="n">Next: Newt Tool Guide <span class="fa fa-arrow-circle-right"></span></a>
-
-
- <a href="index.html" class="btn btn-neutral" title="Bluetooth Mesh" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous: Bluetooth Mesh</a>
-
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../../../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../../../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../../../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../../../_static/js/affix.js"></script>
- <script type="text/javascript" src="../../../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/newt/README.html b/develop/newt/README.html
deleted file mode 100644
index cfcff477f..000000000
--- a/develop/newt/README.html
+++ /dev/null
@@ -1,342 +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">
-
-
-
-
- <title>Mynewt Newt Tool Documentation — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../genindex.html"/>
- <link rel="search" title="Search" href="../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../index.html"/>
-
-
- <script src="../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- Mynewt Newt Tool Documentation
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-newt/edit/master/docs/README.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
- value="/develop"
- selected
- >
- Version: develop (latest - mynewt-documentation)
- </option>
- <option
- value="/latest/os/introduction"
- >
- Version: master (latest - mynewt-site)
- </option>
- <option
- value="/v1_2_0/os/introduction"
- >
- Version: 1.2.0
- </option>
- <option
- value="/v1_1_0/os/introduction">
- Version: 1.1.0
- </option>
- <option
- value="/v1_0_0/os/introduction">
- Version: 1.0.0
- </option>
- <option
- value="/v0_9_0/os/introduction">
- Version: 0_9_0
- </option>
-</select>
- <div class="region region-sidebar">
- <div class="docs-menu">
-
-
-
- <ul>
-<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../get_started/index.html">Setup & Get Started</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts.html">Concepts</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/tutorials.html">Tutorials</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../os/os_user_guide.html">OS User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../network/docs/index.html">BLE User Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="index.html">Newt Tool Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../newtmgr/index.html">Newt Manager Guide</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../mynewt_faq.html">Mynewt OS related FAQ</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../misc/index.html">Appendix</a></li>
-</ul>
-
-
-
- </div>
- </div>
- </div>
- <!-- ENDS STICKY CONTAINER -->
-</div>
-<!-- ENDS .container-sidebar -->
-
- <div class="col-xs-12 col-sm-9">
- <div class="alert alert-info" role="alert">
- <p>
- This is the development version of Apache Mynewt documentation. As such it may not be as complete as the latest
- stable version of the documentation found <a href="/latest/os/introduction/">here</a>.
- </p>
- <p>
- To improve this documentation please visit <a href="https://github.com/apache/mynewt-documentation">https://github.com/apache/mynewt-documentation</a>.
- </p>
-</div>
-
- <div class="">
- <div class="rst-content">
- <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
- <div itemprop="articleBody">
-
- <div class="section" id="mynewt-newt-tool-documentation">
-<h1><a class="toc-backref" href="#id1">Mynewt Newt Tool Documentation</a><a class="headerlink" href="#mynewt-newt-tool-documentation" title="Permalink to this headline">¶</a></h1>
-<p>This folder holds the documentation for the newt tool for the
-<a class="reference external" href="https://mynewt.apache.org/">Apache Mynewt</a> project. It is built using <a class="reference external" href="http://www.sphinx-doc.org/">Sphinx</a>.</p>
-<p>The complete project documentation can be found at <a class="reference external" href="https://github.com/apache/mynewt-documentation">mynewt documentation</a></p>
-<div class="contents topic" id="contents">
-<p class="topic-title first">Contents</p>
-<ul class="simple">
-<li><a class="reference internal" href="#mynewt-newt-tool-documentation" id="id1">Mynewt Newt Tool Documentation</a><ul>
-<li><a class="reference internal" href="#writing-documentation" id="id2">Writing Documentation</a></li>
-<li><a class="reference internal" href="#previewing-changes" id="id3">Previewing Changes</a></li>
-</ul>
-</li>
-</ul>
-</div>
-<div class="section" id="writing-documentation">
-<h2><a class="toc-backref" href="#id2">Writing Documentation</a><a class="headerlink" href="#writing-documentation" title="Permalink to this headline">¶</a></h2>
-<p>See: <a class="reference external" href="https://github.com/apache/mynewt-documentation#writing-documentation">https://github.com/apache/mynewt-documentation#writing-documentation</a></p>
-</div>
-<div class="section" id="previewing-changes">
-<h2><a class="toc-backref" href="#id3">Previewing Changes</a><a class="headerlink" href="#previewing-changes" title="Permalink to this headline">¶</a></h2>
-<p>In order to preview any changes you make you must first install a Sphinx toolchain as
-described at <a class="reference external" href="https://github.com/apache/mynewt-documentation#id3">https://github.com/apache/mynewt-documentation#id3</a>. Then:</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ <span class="nb">cd</span> docs
-$ make clean <span class="o">&&</span> make preview <span class="o">&&</span> <span class="o">(</span><span class="nb">cd</span> _build/html <span class="o">&&</span> python -m SimpleHTTPServer <span class="m">8080</span><span class="o">)</span>
-</pre></div>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
-
- </div>
- </div>
- </div>
- <!-- ENDS CONTENT SECTION -->
- </div>
- <!-- ENDS .content -->
- </div>
- </div>
- <footer>
- <div class="container">
- <div class="row">
- <div class="col-xs-12">
-
- <p class="copyright">Apache Mynewt is available under Apache License, version 2.0.</p>
-
- </div>
- <div class="col-xs-12">
- <div class="logos">
- <img src="../_static/img/asf_logo_wide_small.png" alt="Apache" title="Apache">
- <small class="footnote">
- Apache Mynewt, Mynewt, Apache, the Apache feather logo, and the Apache Mynewt project logo are either
- registered trademarks or trademarks of the Apache Software Foundation in the United States and other countries.
- </small>
- <a href="https://join.slack.com/mynewt/shared_invite/MTkwMTg1ODM1NTg5LTE0OTYxNzQ4NzQtZTU1YmNhYjhkMg">
- <img src="../_static/img/add_to_slack.png" alt="Slack Icon" title="Join our Slack Community" />
- </a>
- </div>
- </div>
- </div>
- </div>
-</footer>
- </div>
- <!-- ENDS #wrapper -->
-
-
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT:'../',
- VERSION:'1.3.0',
- COLLAPSE_INDEX:false,
- FILE_SUFFIX:'.html',
- HAS_SOURCE: true,
- SOURCELINK_SUFFIX: '.txt'
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../_static/js/bootstrap-3.0.3.min.js"></script>
- <script type="text/javascript" src="../_static/js/affix.js"></script>
- <script type="text/javascript" src="../_static/js/main.js"></script>
-
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/develop/newt/command_list/newt_build.html b/develop/newt/command_list/newt_build.html
deleted file mode 100644
index 1117efeb5..000000000
--- a/develop/newt/command_list/newt_build.html
+++ /dev/null
@@ -1,406 +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">
-
-
-
-
- <title>newt build — Apache Mynewt 1.3.0 documentation</title>
-
-
-
-
- <link rel="shortcut icon" href="../../_static/mynewt-logo-only-newt32x32.png"/>
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
-
-
- <link rel="stylesheet" href="../../_static/css/sphinx_theme.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/bootstrap-3.0.3.min.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/v2.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/custom.css" type="text/css" />
-
- <link rel="stylesheet" href="../../_static/css/restructuredtext.css" type="text/css" />
-
-
-
-
- <link rel="stylesheet" href="../../_static/css/overrides.css" type="text/css" />
- <link rel="index" title="Index"
- href="../../genindex.html"/>
- <link rel="search" title="Search" href="../../search.html"/>
- <link rel="top" title="Apache Mynewt 1.3.0 documentation" href="../../index.html"/>
- <link rel="up" title="Command Structure" href="../newt_ops.html"/>
- <link rel="next" title="newt clean" href="newt_clean.html"/>
- <link rel="prev" title="Command Structure" href="../newt_ops.html"/>
-
-
- <script src="../../_static/js/modernizr.min.js"></script>
-
-
- <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="not-front page-documentation" role="document" >
- <div id="wrapper">
- <div class="container">
- <div id="banner" class="row v2-main-banner">
- <a class="logo-cell" href="/">
- <img class="logo" src="../../_static/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.3.0</a> released (December 13, 2017)
- </div>
- </div>
- </div>
-</div>
-
-<header>
- <nav id="navbar" class="navbar navbar-inverse" 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>
- <a href="/"><i class="fa fa-home" style="font-size: larger;"></i></a>
- </li>
- <li class="important">
- <a href="/get_started/quick_start.html">Quick Start</a>
- </li>
- <li>
- <a href="/about/">About</a>
- </li>
- <li>
- <a href="/talks/">Talks</a>
- </li>
- <li class="active">
- <a href="/documentation/">Documentation</a>
- </li>
- <li>
- <a href="/download/">Download</a>
- </li>
- <li>
- <a href="/community/">Community</a>
- </li>
- <li>
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
- </nav>
-</header>
- <!-- STARTS MAIN CONTENT -->
- <div id="main-content">
-
-
-
-
-
-
-<div id="breadcrumb">
- <div class="container">
- <a href="/documentation/">Docs</a> /
-
- <a href="../index.html">Newt Tool Guide</a> /
-
- <a href="../newt_ops.html">Command Structure</a> /
-
- newt build
-
- <div class="sourcelink">
- <a href="https://github.com/apache/mynewt-newt/edit/master/docs/command_list/newt_build.rst" class="icon icon-github"
- rel="nofollow"> Edit on GitHub</a>
-</div>
- </div>
-</div>
- <!-- STARTS CONTAINER -->
- <div class="container">
- <!-- STARTS .content -->
- <div id="content" class="row">
-
- <!-- STARTS .container-sidebar -->
-<div class="container-sidebar col-xs-12 col-sm-3">
- <div id="docSidebar" class="sticky-container">
- <div role="search" class="sphinx-search">
- <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
- <input type="text" name="q" placeholder="Search documentation" class="search-documentation" />
- <input type="hidden" name="check_keywords" value="yes" />
- <input type="hidden" name="area" value="default" />
- </form>
-</div>
-
-<!-- Note: only works when deployed -->
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
- <option
(This diff was longer than 20,000 lines, and has been truncated...)
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services