You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mynewt.apache.org by ad...@apache.org on 2016/04/26 23:02:27 UTC
[5/7] incubator-mynewt-site git commit: Lots of HAL additions by P
Dietrich. This closes #73. BLE security blurb added. Docker container and
quick start docs cleaned up
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/ble_intro/index.html
----------------------------------------------------------------------
diff --git a/network/ble/ble_intro/index.html b/network/ble/ble_intro/index.html
index 2bde884..b670a80 100644
--- a/network/ble/ble_intro/index.html
+++ b/network/ble/ble_intro/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../nimble_setup/">Set up application</a>
</li>
@@ -484,8 +494,8 @@
</li>
<li class="pull-right">
- <a href=../nimble_setup/>
- Next: Set up application
+ <a href=../ble_sec/>
+ Next: NimBLE Security
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/ble_sec/index.html
----------------------------------------------------------------------
diff --git a/network/ble/ble_sec/index.html b/network/ble/ble_sec/index.html
new file mode 100644
index 0000000..703b628
--- /dev/null
+++ b/network/ble/ble_sec/index.html
@@ -0,0 +1,541 @@
+<!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">
+
+
+ <link rel="canonical" href="http://mynewt.apache.org/network/ble/ble_sec/">
+ <link rel="shortcut icon" href="../../../img/favicon.ico">
+
+ <title>NimBLE Security - Apache Mynewt</title>
+
+ <link href="../../../css/bootstrap-3.0.3.min.css" rel="stylesheet">
+ <link href="../../../css/font-awesome-4.0.3.css" rel="stylesheet">
+ <link rel="stylesheet" href="../../../css/highlight.css">
+ <link href="../../../css/base.css" rel="stylesheet">
+ <link href="../../../css/custom.css" rel="stylesheet">
+ <link href='https://fonts.googleapis.com/css?family=Roboto:400,500,700,900,300,100' rel='stylesheet' type='text/css'>
+ <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
+ <link href="../../../extra.css" rel="stylesheet">
+
+ <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
+ <script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
+ <![endif]-->
+
+
+ <script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-72162311-1', 'mynewt.incubator.apache.org');
+ ga('send', 'pageview');
+ </script>
+
+ </head>
+
+
+ <body class="NimBLE Security">
+
+
+ <div id="navbar" class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="logo-container">
+ <img src="/img/logo.svg">
+ </div>
+ <div class="container-fluid">
+ <!-- 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="/">Home</a>
+ </li>
+ <li>
+ <a href="/about/">About</a>
+ </li>
+ <li class="dropdown">
+ <a href="/documentation/" class="dropdown-toggle" data-toggle="dropdown">Docs <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+
+
+
+
+ <li >
+ <a href="../../../documentation/">
+ Overview
+ </a>
+ </li>
+
+
+
+
+
+
+
+
+
+ <li class="active">
+ <a href="../../../os/get_started/introduction/">
+ Mynewt OS Manual
+ </a>
+ </li>
+
+
+
+ <li >
+ <a href="../../../newt/newt_intro/">
+ Newt Tool Manual
+ </a>
+ </li>
+
+
+
+ <li >
+ <a href="../../../newtmgr/overview/">
+ Newt Manager Manual
+ </a>
+ </li>
+
+
+
+ <li >
+ <a href="../../../os/tutorials/how_to_edit_docs/">
+ Appendix
+ </a>
+ </li>
+
+
+ </ul>
+ </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>
+</div>
+
+
+
+ <div class="container-fluid">
+
+ <div class="row sm-extra-padding">
+ <div id="docSidebar" class="col-md-3 bg-grey sidebar-container"><div class="bs-sidebar hidden-print" role="complementary">
+ <div class="sidebar-top">
+ <img class="hidden-xs hidden-sm logo-small" src="/img/logo.svg" alt="MyNewt" title="MyNewt">
+ <div class="small" role="search">
+ <form id ="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+ <div class="form-group">
+ <input type="text" name="q" placeholder="Search documentation" />
+ <button class="search-button" type="submit"><i class="fa fa-search"></i></button>
+ </div>
+ </form>
+ </div>
+ </div>
+ <ul class="nav bs-sidenav">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../os/get_started/introduction/
+">Mynewt OS Manual</a>
+
+
+ <ul class="current-toc">
+
+
+
+
+ <li>
+ <a href="../../../os/get_started/introduction/">Introduction</a>
+ </li>
+
+
+
+
+
+
+
+
+ <li ><a href="../../../os/get_started/get_started/">Quick Start</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../os/get_started/vocabulary/">Concepts</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../os/tutorials/tutorials/">Tutorials</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../os/os_user_guide/">OS User Guide</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../ble_intro/
+">BLE User Guide</a>
+
+
+ <ul class="current-toc">
+
+
+
+
+ <li>
+ <a href="../ble_intro/">NimBLE Introduction</a>
+ </li>
+
+
+
+
+
+
+
+ <li class="active">
+ NimBLE Security
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../nimble_setup/">Set up application</a>
+ </li>
+
+
+
+
+
+
+
+
+ <li ><a href="../ini_stack/ble_ini_intro/">Initialize stack</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../bletiny_api/">API for bletiny app</a></li>
+
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../newt/newt_intro/
+">Newt Tool Manual</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../newtmgr/overview/
+">Newt Manager Manual</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../os/tutorials/how_to_edit_docs/
+">Appendix</a>
+
+
+ </li>
+
+
+
+ </ul>
+</div></div>
+
+ <div class="show-sidebar-container">
+ <button class="show-sidebar">Docs Menu</button>
+ </div>
+
+ <div class="col-md-offset-3 col-md-9 documentation-viewer" role="main">
+ <div class="row doc-header">
+ <div class="col-sm-6">
+
+<ul class="nav nav-pills">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="active" role="presentation"><a href="../../../os/get_started/introduction/">Mynewt OS</a></li>
+
+
+
+ <li role="presentation"><a href="../../../newt/newt_intro/">Newt Tool</a></li>
+
+
+
+ <li role="presentation"><a href="../../../newtmgr/overview/">Newt Mgr</a></li>
+
+
+
+
+</ul>
+ </div>
+ <div class="col-sm-6">
+ <div role="navigation" aria-label="breadcrumbs navigation">
+ <ul class="wy-breadcrumbs">
+ <li><a href="/documentation/">Docs</a></li>
+
+
+
+ <li>» <a href="../../../os/get_started/introduction/">Mynewt OS Manual</a></li>
+
+
+
+ <li>» <a href="../ble_intro/">BLE User Guide</a></li>
+
+
+
+ <li>» NimBLE Security</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h2 id="ble-security">BLE Security<a class="headerlink" href="#ble-security" title="Permanent link">¶</a></h2>
+<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>
+<li>
+<p><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. </p>
+</li>
+<li>
+<p><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. <font color="#F2853F"><em>Bonding is currently a roadmap item for Apache Mynewt.</em> </font></p>
+</li>
+<li>
+<p><strong>Device authentication</strong>: Verification that the two devices have the same keys (verify device identity)</p>
+</li>
+<li>
+<p><strong>Encryption</strong>: Keeps message confidential. Encryption in Bluetooth LE uses AES-CCM cryptography and is performed in the <em>Controller</em>.</p>
+</li>
+<li>
+<p><strong>Message integrity</strong>: Protects against message forgeries.</p>
+</li>
+</ul>
+<p>Bluetooth LE uses four association models depending on the I/O capabilities of the devices. <font color="#F2853F"><em>Apache Mynewt has first implemented support for "Just Works" only.</em></font></p>
+<ul>
+<li>
+<p><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.</p>
+</li>
+<li>
+<p><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.</p>
+</li>
+<li>
+<p><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.</p>
+</li>
+<li>
+<p><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.</p>
+</li>
+</ul>
+<h3 id="key-generation">Key Generation<a class="headerlink" href="#key-generation" title="Permanent link">¶</a></h3>
+<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>
+<h3 id="privacy-feature">Privacy Feature<a class="headerlink" href="#privacy-feature" title="Permanent link">¶</a></h3>
+<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. <font color="#F2853F"><em>Privacy support is currently a roadmap item for Apache Mynewt.</em></font></p>
+<p>There are two variants of the privacy feature. </p>
+<ul>
+<li>
+<p>In the first variant, private addresses are resolved and generated by the <em>Host</em>.</p>
+</li>
+<li>
+<p>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.</p>
+</li>
+</ul>
+<p>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.</p>
+<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.</p>
+<p>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 class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../ble_intro/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: NimBLE Introduction
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../nimble_setup/>
+ Next: Set up application
+ <span class="fa fa-arrow-right"></span>
+ </a>
+
+ </li>
+</ul>
+ </div>
+ <div class="row">
+ <footer>
+ <div class="row">
+ <div class="col-md-12">
+
+ <p class="copyright">Copyright © 2015 The Apache Software Foundation, Licensed under the Apache License, Version 2.0 Apache and the Apache feather logo are trademarks of The Apache Software Foundation.<br>The Apache Software Foundation Apache Incubator</p>
+
+ </div>
+ </div>
+ <div class="copyright-logos">
+ <div class="row">
+ <div class="col-xs-6 text-right">
+ <img src="/img/apache-feather.png" alt="Apache" title="Apache">
+ </div>
+ <div class="col-xs-6 text-left">
+ <img src="/img/apache-logo.png" alt="Apache Incubator" title="Apache Incubator">
+ </div>
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-md-12">
+ <small class="footnote">
+ MyNewt is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
+ </small>
+ </div>
+ </div>
+</footer>
+ </div>
+ </div>
+ </div>
+
+
+ </div>
+
+ <script src="../../../js/jquery-1.10.2.min.js"></script>
+ <script src="../../../js/bootstrap-3.0.3.min.js"></script>
+ <script src="../../../js/highlight.pack.js"></script>
+ <script src="../../../js/base.js"></script>
+ <script src="../../../js/custom.js"></script>
+
+ </body>
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/bletiny/bletiny_GAP/index.html
----------------------------------------------------------------------
diff --git a/network/ble/bletiny/bletiny_GAP/index.html b/network/ble/bletiny/bletiny_GAP/index.html
index 80df843..32c40c8 100644
--- a/network/ble/bletiny/bletiny_GAP/index.html
+++ b/network/ble/bletiny/bletiny_GAP/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/bletiny/bletiny_GATT/index.html
----------------------------------------------------------------------
diff --git a/network/ble/bletiny/bletiny_GATT/index.html b/network/ble/bletiny/bletiny_GATT/index.html
index 8519ef8..d50d000 100644
--- a/network/ble/bletiny/bletiny_GATT/index.html
+++ b/network/ble/bletiny/bletiny_GATT/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/bletiny/bletiny_advdata/index.html
----------------------------------------------------------------------
diff --git a/network/ble/bletiny/bletiny_advdata/index.html b/network/ble/bletiny/bletiny_advdata/index.html
index eb64db7..f9b5b8e 100644
--- a/network/ble/bletiny/bletiny_advdata/index.html
+++ b/network/ble/bletiny/bletiny_advdata/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/bletiny_api/index.html
----------------------------------------------------------------------
diff --git a/network/ble/bletiny_api/index.html b/network/ble/bletiny_api/index.html
index 9987d83..bd15dc9 100644
--- a/network/ble/bletiny_api/index.html
+++ b/network/ble/bletiny_api/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/ini_stack/ble_add_cpu/index.html
----------------------------------------------------------------------
diff --git a/network/ble/ini_stack/ble_add_cpu/index.html b/network/ble/ini_stack/ble_add_cpu/index.html
index 71af09a..cf911d6 100644
--- a/network/ble/ini_stack/ble_add_cpu/index.html
+++ b/network/ble/ini_stack/ble_add_cpu/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/ini_stack/ble_consolepkg/index.html
----------------------------------------------------------------------
diff --git a/network/ble/ini_stack/ble_consolepkg/index.html b/network/ble/ini_stack/ble_consolepkg/index.html
index e762938..6e2967a 100644
--- a/network/ble/ini_stack/ble_consolepkg/index.html
+++ b/network/ble/ini_stack/ble_consolepkg/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/ini_stack/ble_controller_ini/index.html
----------------------------------------------------------------------
diff --git a/network/ble/ini_stack/ble_controller_ini/index.html b/network/ble/ini_stack/ble_controller_ini/index.html
index 2a4592a..0a48228 100644
--- a/network/ble/ini_stack/ble_controller_ini/index.html
+++ b/network/ble/ini_stack/ble_controller_ini/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/ini_stack/ble_devadd/index.html
----------------------------------------------------------------------
diff --git a/network/ble/ini_stack/ble_devadd/index.html b/network/ble/ini_stack/ble_devadd/index.html
index ebeab35..a5dbc34 100644
--- a/network/ble/ini_stack/ble_devadd/index.html
+++ b/network/ble/ini_stack/ble_devadd/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/ini_stack/ble_host_ini/index.html
----------------------------------------------------------------------
diff --git a/network/ble/ini_stack/ble_host_ini/index.html b/network/ble/ini_stack/ble_host_ini/index.html
index 5027fd6..59d0a6c 100644
--- a/network/ble/ini_stack/ble_host_ini/index.html
+++ b/network/ble/ini_stack/ble_host_ini/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/ini_stack/ble_ini_intro/index.html
----------------------------------------------------------------------
diff --git a/network/ble/ini_stack/ble_ini_intro/index.html b/network/ble/ini_stack/ble_ini_intro/index.html
index 5d0c175..0a87f12 100644
--- a/network/ble/ini_stack/ble_ini_intro/index.html
+++ b/network/ble/ini_stack/ble_ini_intro/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/ini_stack/ble_mempool/index.html
----------------------------------------------------------------------
diff --git a/network/ble/ini_stack/ble_mempool/index.html b/network/ble/ini_stack/ble_mempool/index.html
index 7f2e523..ac12d7d 100644
--- a/network/ble/ini_stack/ble_mempool/index.html
+++ b/network/ble/ini_stack/ble_mempool/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/ini_stack/ble_statpkg/index.html
----------------------------------------------------------------------
diff --git a/network/ble/ini_stack/ble_statpkg/index.html b/network/ble/ini_stack/ble_statpkg/index.html
index 86fac0b..c9dc84f 100644
--- a/network/ble/ini_stack/ble_statpkg/index.html
+++ b/network/ble/ini_stack/ble_statpkg/index.html
@@ -266,6 +266,16 @@
<li>
+ <a href="../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
<a href="../../nimble_setup/">Set up application</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/network/ble/nimble_setup/index.html
----------------------------------------------------------------------
diff --git a/network/ble/nimble_setup/index.html b/network/ble/nimble_setup/index.html
index 31e0cc6..c906f15 100644
--- a/network/ble/nimble_setup/index.html
+++ b/network/ble/nimble_setup/index.html
@@ -265,6 +265,16 @@
+ <li>
+ <a href="../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+
+
<li class="active">
Set up application
</li>
@@ -610,9 +620,9 @@ apache-mynewt-core's example Nimble apps. These apps can be found at the below
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../ble_intro/>
+ <a href=../ble_sec/>
<span class="fa fa-arrow-left"></span>
- Previous: NimBLE Introduction
+ Previous: NimBLE Security
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/core_os/porting/port_bsp/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/porting/port_bsp/index.html b/os/core_os/porting/port_bsp/index.html
index 352eb4b..fc99802 100644
--- a/os/core_os/porting/port_bsp/index.html
+++ b/os/core_os/porting/port_bsp/index.html
@@ -633,6 +633,10 @@ name that describes the board/system you are creating.</p>
<td>A header file to include definitions required by system from the BSP</td>
</tr>
<tr>
+<td>include/bsp/bsp_sysid.h</td>
+<td>A header file to enumerate the devices in your BSP</td>
+</tr>
+<tr>
<td>src/os_bsp.c</td>
<td>A C source file to provide functions required by the OS from your BSP</td>
</tr>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/get_started/docker/index.html
----------------------------------------------------------------------
diff --git a/os/get_started/docker/index.html b/os/get_started/docker/index.html
index 5610fd2..8f2ce7b 100644
--- a/os/get_started/docker/index.html
+++ b/os/get_started/docker/index.html
@@ -418,6 +418,7 @@ 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>The 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>
<p><br></p>
<h3 id="install-docker">Install Docker<a class="headerlink" href="#install-docker" title="Permanent link">¶</a></h3>
<p>Install docker for your platform. <a href="https://docs.docker.com/mac/">Mac OS X</a> / <a href="https://docs.docker.com/windows/">Windows</a> / <a href="https://docs.docker.com/linux/">Linux</a></p>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/get_started/native_tools/index.html
----------------------------------------------------------------------
diff --git a/os/get_started/native_tools/index.html b/os/get_started/native_tools/index.html
index 9a15280..56f53e9 100644
--- a/os/get_started/native_tools/index.html
+++ b/os/get_started/native_tools/index.html
@@ -476,7 +476,7 @@ Setting up gdb (7.7.1-0ubuntu5~14.04.2) ...
<p><br></p>
-<p>At this point you have installed all the necessary software to build and test code on a simluator running on your Mac or Linux. Proceed to the <a href="#build-test-code-on-simulator">Build test code on simulator</a> section.</p>
+<p>At this point you have installed all the necessary software to build and test code on a simluator running on your Mac or Linux. Proceed to the <a href="../project_create/">Create Your First Project</a> section.</p>
<div class="row">
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/modules/hal/hal/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal/index.html b/os/modules/hal/hal/index.html
index 482535f..200d7af 100644
--- a/os/modules/hal/hal/index.html
+++ b/os/modules/hal/hal/index.html
@@ -326,6 +326,16 @@
+ <li>
+ <a href="../hal_architecture/">Architecture</a>
+ </li>
+
+
+
+
+
+
+
<li><a href="
../hal_api/
@@ -340,7 +350,7 @@
<li>
- <a href="../hal_in_libraries/">Using</a>
+ <a href="../hal_in_libraries/">Using HAL</a>
</li>
@@ -350,7 +360,7 @@
<li>
- <a href="../hal_creation/">Creating</a>
+ <a href="../hal_creation/">Creating HAL</a>
</li>
@@ -608,6 +618,9 @@ consult the MCU implementation and see if the specific HAL interface you are
using is in the <code>mcu/xxx/src/hal_xxxx.c</code> implementation. Finally, you
can build your project and ensure that there are no unresolved hal_xxx
externals.</p>
+<h3 id="hal-architecture">HAL Architecture<a class="headerlink" href="#hal-architecture" title="Permanent link">¶</a></h3>
+<p>Visit the <a href="../hal_architecture/">HAL architecture</a> page to get a understanding
+of our current hal and its evolution.</p>
<h3 id="implementing-hal-interfaces">Implementing HAL Interfaces<a class="headerlink" href="#implementing-hal-interfaces" title="Permanent link">¶</a></h3>
<p>It might be that a specific HAL interface is not supported on your MCU or
platform. See the specific HAL documentation for that interface for tips
@@ -629,8 +642,8 @@ on implementing this for your MCU.</p>
</li>
<li class="pull-right">
- <a href=../hal_api/>
- Next: Summary
+ <a href=../hal_architecture/>
+ Next: Architecture
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/modules/hal/hal_adc/hal_adc/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_adc/hal_adc/index.html b/os/modules/hal/hal_adc/hal_adc/index.html
new file mode 100644
index 0000000..c72a149
--- /dev/null
+++ b/os/modules/hal/hal_adc/hal_adc/index.html
@@ -0,0 +1,805 @@
+<!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">
+
+
+ <link rel="canonical" href="http://mynewt.apache.org/os/modules/hal/hal_adc/hal_adc/">
+ <link rel="shortcut icon" href="../../../../../img/favicon.ico">
+
+ <title>ADC - Apache Mynewt</title>
+
+ <link href="../../../../../css/bootstrap-3.0.3.min.css" rel="stylesheet">
+ <link href="../../../../../css/font-awesome-4.0.3.css" rel="stylesheet">
+ <link rel="stylesheet" href="../../../../../css/highlight.css">
+ <link href="../../../../../css/base.css" rel="stylesheet">
+ <link href="../../../../../css/custom.css" rel="stylesheet">
+ <link href='https://fonts.googleapis.com/css?family=Roboto:400,500,700,900,300,100' rel='stylesheet' type='text/css'>
+ <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
+ <link href="../../../../../extra.css" rel="stylesheet">
+
+ <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
+ <script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
+ <![endif]-->
+
+
+ <script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-72162311-1', 'mynewt.incubator.apache.org');
+ ga('send', 'pageview');
+ </script>
+
+ </head>
+
+
+ <body class="ADC">
+
+
+ <div id="navbar" class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="logo-container">
+ <img src="/img/logo.svg">
+ </div>
+ <div class="container-fluid">
+ <!-- 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="/">Home</a>
+ </li>
+ <li>
+ <a href="/about/">About</a>
+ </li>
+ <li class="dropdown">
+ <a href="/documentation/" class="dropdown-toggle" data-toggle="dropdown">Docs <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+
+
+
+
+ <li >
+ <a href="../../../../../documentation/">
+ Overview
+ </a>
+ </li>
+
+
+
+
+
+
+
+
+
+ <li class="active">
+ <a href="../../../../get_started/introduction/">
+ Mynewt OS Manual
+ </a>
+ </li>
+
+
+
+ <li >
+ <a href="../../../../../newt/newt_intro/">
+ Newt Tool Manual
+ </a>
+ </li>
+
+
+
+ <li >
+ <a href="../../../../../newtmgr/overview/">
+ Newt Manager Manual
+ </a>
+ </li>
+
+
+
+ <li >
+ <a href="../../../../tutorials/how_to_edit_docs/">
+ Appendix
+ </a>
+ </li>
+
+
+ </ul>
+ </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>
+</div>
+
+
+
+ <div class="container-fluid">
+
+ <div class="row sm-extra-padding">
+ <div id="docSidebar" class="col-md-3 bg-grey sidebar-container"><div class="bs-sidebar hidden-print" role="complementary">
+ <div class="sidebar-top">
+ <img class="hidden-xs hidden-sm logo-small" src="/img/logo.svg" alt="MyNewt" title="MyNewt">
+ <div class="small" role="search">
+ <form id ="rtd-search-form" class="wy-form" action="../../../../../search.html" method="get">
+ <div class="form-group">
+ <input type="text" name="q" placeholder="Search documentation" />
+ <button class="search-button" type="submit"><i class="fa fa-search"></i></button>
+ </div>
+ </form>
+ </div>
+ </div>
+ <ul class="nav bs-sidenav">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../../get_started/introduction/
+">Mynewt OS Manual</a>
+
+
+ <ul class="current-toc">
+
+
+
+
+ <li>
+ <a href="../../../../get_started/introduction/">Introduction</a>
+ </li>
+
+
+
+
+
+
+
+
+ <li ><a href="../../../../get_started/get_started/">Quick Start</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../../get_started/vocabulary/">Concepts</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../../tutorials/tutorials/">Tutorials</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../../os_user_guide/">OS User Guide</a></li>
+
+
+ <ul class="current-toc">
+
+
+
+
+
+
+
+ <li ><a href="../../../../core_os/mynewt_os/">OS Core</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../../core_os/porting/port_os/">Porting to your Platform</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../console/console/">Console</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../shell/shell/">Shell</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../bootloader/bootloader/">Bootloader</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+
+
+ ../../../fs/fs/fs/
+
+">File System</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../hal/">Hardware Abstraction Layer</a></li>
+
+
+ <ul class="current-toc">
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_architecture/">Architecture</a>
+ </li>
+
+
+
+
+
+
+
+
+ <li><a href="
+ ../../hal_api/
+">API</a>
+
+
+ <ul class="current-toc">
+
+
+
+
+ <li>
+ <a href="../../hal_api/">Summary</a>
+ </li>
+
+
+
+
+
+
+
+ <li class="active">
+ ADC
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_cputime/hal_cpu_timer/">CPU timer</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_dac/hal_dac/">DAC</a>
+ </li>
+
+
+
+
+
+
+
+
+ <li><a href="
+ ../../hal_flash/hal_flash/
+">Flash memory</a>
+
+
+ </li>
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_gpio/hal_gpio/">GPIO</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_i2c/hal_i2c/">I2C</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_pwm/hal_pwm/">PWM</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_spi/hal_spi/">SPI</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_system/hal_sys/">System</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_uart/hal_uart/">UART</a>
+ </li>
+
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_in_libraries/">Using HAL</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_creation/">Creating HAL</a>
+ </li>
+
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../testutil/testutil/">Test Utilities</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../imgmgr/imgmgr/">Image Manager</a></li>
+
+
+ </li>
+
+
+
+
+
+
+ <li>
+ <a href="../../../baselibc/">Baselibc library</a>
+ </li>
+
+
+
+
+
+
+
+
+ <li ><a href="../../../elua/elua/">Embedded Lua</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../json/json/">JSON</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../stats/stats/">Stats</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../logs/logs/">Logs</a></li>
+
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../../../network/ble/ble_intro/
+">BLE User Guide</a>
+
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../../../newt/newt_intro/
+">Newt Tool Manual</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../../../newtmgr/overview/
+">Newt Manager Manual</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../../tutorials/how_to_edit_docs/
+">Appendix</a>
+
+
+ </li>
+
+
+
+ </ul>
+</div></div>
+
+ <div class="show-sidebar-container">
+ <button class="show-sidebar">Docs Menu</button>
+ </div>
+
+ <div class="col-md-offset-3 col-md-9 documentation-viewer" role="main">
+ <div class="row doc-header">
+ <div class="col-sm-6">
+
+<ul class="nav nav-pills">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="active" role="presentation"><a href="../../../../get_started/introduction/">Mynewt OS</a></li>
+
+
+
+ <li role="presentation"><a href="../../../../../newt/newt_intro/">Newt Tool</a></li>
+
+
+
+ <li role="presentation"><a href="../../../../../newtmgr/overview/">Newt Mgr</a></li>
+
+
+
+
+</ul>
+ </div>
+ <div class="col-sm-6">
+ <div role="navigation" aria-label="breadcrumbs navigation">
+ <ul class="wy-breadcrumbs">
+ <li><a href="/documentation/">Docs</a></li>
+
+
+
+ <li>» <a href="../../hal/">Hardware Abstraction Layer</a></li>
+
+
+
+ <li>» <a href="../../hal_api/">API</a></li>
+
+
+
+ <li>» ADC</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h1 id="hal_adc">hal_adc<a class="headerlink" href="#hal_adc" title="Permanent link">¶</a></h1>
+<p>The hardware independent interface to Analog To Digital Controllers</p>
+<h3 id="description">Description<a class="headerlink" href="#description" title="Permanent link">¶</a></h3>
+<p>Analog to Digital converters (ADCs) read analog values (voltage) and convert
+them to digital values to be used in your applications. For a description
+of ADC, see <a href="https://en.wikipedia.org/wiki/Analog-to-digital_converter">wikipedia</a></p>
+<h3 id="definition">Definition<a class="headerlink" href="#definition" title="Permanent link">¶</a></h3>
+<p><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_adc.h">hal_adc.h</a></p>
+<h3 id="hal_adcs-theory-of-operation">HAL_ADCs Theory Of Operation<a class="headerlink" href="#hal_adcs-theory-of-operation" title="Permanent link">¶</a></h3>
+<p>ADCs have different conversion rates, resolution (bits) and reference voltages.</p>
+<p>The HAL_ADC has APIs to allow the application or library to query the capabilities
+of a specific ADC.</p>
+<table>
+<thead>
+<tr>
+<th><strong>Method Name</strong></th>
+<th><strong> Description </strong></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>hal_adc_get_bits</td>
+<td>gets the resolution of the ADC in bits. For example if the ADC is 10 bits, a read will return a value from 0 through 2^10 - 1 = 1023.</td>
+</tr>
+<tr>
+<td>hal_adc_get_ref_mv</td>
+<td>gets the underlying reference voltage for the ADC in millivolts. For example, if the ADC is 10 bits and the reference voltage is 5000 mV a ADC reading of 1023 corresponds to 5V; a ADC reading of 0 corresponds to 0 volts.</td>
+</tr>
+</tbody>
+</table>
+<p>Given this information, the application or library could convert any reading
+to millivolts. Since this is a common operation, the HAL_ADC API has a helper
+function to perform this function: <code>hal_adc_to_mv()</code>.</p>
+<p>The current HAL_ADC API provides a blocking read command to initiate an ADC
+conversion, and return the result of that conversion. Conversion time is
+hardware dependent, but this is not an instantaneous operation. Libraries
+can use the <a href="../../hal_cputime/hal_cpu_timer/">hal_cputime</a> APIs to
+time conversions if that is relevant to the application.</p>
+<p>Future HAL_ADC APIs will include periodic ADC conversion, non-blocking ADC
+conversion and direct-to-memory DMA conversion. </p>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../../hal_api/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: Summary
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../../hal_cputime/hal_cpu_timer/>
+ Next: CPU timer
+ <span class="fa fa-arrow-right"></span>
+ </a>
+
+ </li>
+</ul>
+ </div>
+ <div class="row">
+ <footer>
+ <div class="row">
+ <div class="col-md-12">
+
+ <p class="copyright">Copyright © 2015 The Apache Software Foundation, Licensed under the Apache License, Version 2.0 Apache and the Apache feather logo are trademarks of The Apache Software Foundation.<br>The Apache Software Foundation Apache Incubator</p>
+
+ </div>
+ </div>
+ <div class="copyright-logos">
+ <div class="row">
+ <div class="col-xs-6 text-right">
+ <img src="/img/apache-feather.png" alt="Apache" title="Apache">
+ </div>
+ <div class="col-xs-6 text-left">
+ <img src="/img/apache-logo.png" alt="Apache Incubator" title="Apache Incubator">
+ </div>
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-md-12">
+ <small class="footnote">
+ MyNewt is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
+ </small>
+ </div>
+ </div>
+</footer>
+ </div>
+ </div>
+ </div>
+
+
+ </div>
+
+ <script src="../../../../../js/jquery-1.10.2.min.js"></script>
+ <script src="../../../../../js/bootstrap-3.0.3.min.js"></script>
+ <script src="../../../../../js/highlight.pack.js"></script>
+ <script src="../../../../../js/base.js"></script>
+ <script src="../../../../../js/custom.js"></script>
+
+ </body>
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/modules/hal/hal_api/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_api/index.html b/os/modules/hal/hal_api/index.html
index fb88453..408f354 100644
--- a/os/modules/hal/hal_api/index.html
+++ b/os/modules/hal/hal_api/index.html
@@ -326,6 +326,16 @@
+ <li>
+ <a href="../hal_architecture/">Architecture</a>
+ </li>
+
+
+
+
+
+
+
<li><a href="
./
@@ -348,7 +358,27 @@
<li>
- <a href="../hal_gpio/hal_gpio/">GPIO</a>
+ <a href="../hal_adc/hal_adc/">ADC</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../hal_cputime/hal_cpu_timer/">CPU timer</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../hal_dac/hal_dac/">DAC</a>
</li>
@@ -371,7 +401,7 @@
<li>
- <a href="../hal_cputime/hal_cpu_timer/">CPU timer</a>
+ <a href="../hal_gpio/hal_gpio/">GPIO</a>
</li>
@@ -381,7 +411,27 @@
<li>
- <a href="../hal_uart/hal_uart/">UART</a>
+ <a href="../hal_i2c/hal_i2c/">I2C</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../hal_pwm/hal_pwm/">PWM</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../hal_spi/hal_spi/">SPI</a>
</li>
@@ -397,6 +447,16 @@
+
+
+
+ <li>
+ <a href="../hal_uart/hal_uart/">UART</a>
+ </li>
+
+
+
+
</ul>
</li>
@@ -407,7 +467,7 @@
<li>
- <a href="../hal_in_libraries/">Using</a>
+ <a href="../hal_in_libraries/">Using HAL</a>
</li>
@@ -417,7 +477,7 @@
<li>
- <a href="../hal_creation/">Creating</a>
+ <a href="../hal_creation/">Creating HAL</a>
</li>
@@ -649,19 +709,24 @@ description of the interfaces are shown below.</p>
</thead>
<tbody>
<tr>
+<td><a href="../hal_adc/hal_adc/">adc</a></td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_adc.h">hal_adc.h</a></td>
+<td>An interface for controlling Analog To Digital Converters.</td>
+</tr>
+<tr>
<td><a href="../hal_cputime/hal_cpu_timer/">cputime</a></td>
<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_cputime.h">hal_cputime.h</a></td>
<td>An interface for getting the CPU uptime, an interface to set arbitrary timers based on the CPU time, and an interface for a blocking delay if CPU time.</td>
</tr>
<tr>
-<td><a href="../hal_flash/hal_flash/">flash</a></td>
-<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_flash.h">hal_flash.h</a></td>
-<td>A blocking interface to access flash memory</td>
+<td><a href="../hal_dac/hal_dac/">dac</a></td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_dac.h">hal_dac.h</a></td>
+<td>An interface for controlling Digital to Analog Converters.</td>
</tr>
<tr>
-<td><a href="../hal_flash/hal_flash_int/">flash_int</a></td>
-<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_flash_int.h">hal_flash_int.h</a></td>
-<td>The underlying API that the flash drivers implement. If you are writing a new flash driver, this is how you hook it into the HAL.</td>
+<td><a href="../hal_flash/hal_flash/">flash</a></td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_flash.h">hal_flash.h</a></td>
+<td>A blocking interface to access flash memory.</td>
</tr>
<tr>
<td><a href="../hal_flash/hal_flash_map/">flash map</a></td>
@@ -671,7 +736,22 @@ description of the interfaces are shown below.</p>
<tr>
<td><a href="../hal_gpio/hal_gpio/">gpio</a></td>
<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_gpio.h">hal_gpio.h</a></td>
-<td>An interface for manipulating General Purpose Inputs and Outputs</td>
+<td>An interface for manipulating General Purpose Inputs and Outputs.</td>
+</tr>
+<tr>
+<td><a href="../hal_i2c/hal_i2c/">i2c</a></td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_i2c.h">hal_i2c.h</a></td>
+<td>An interface for controlling Inter-Integrated-Circuit (i2c) devices.</td>
+</tr>
+<tr>
+<td><a href="../hal_pwm/hal_pwm/">pwm</a></td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_pwm.h">hal_pwm.h</a></td>
+<td>An interface for controlling Pulse Width Modulator Devices.</td>
+</tr>
+<tr>
+<td><a href="../hal_spi/hal_spi/">spi</a></td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_spi.h">hal_spi.h</a></td>
+<td>An interface for controlling Serial Peripheral Interface (SPI) devices.</td>
</tr>
<tr>
<td><a href="../hal_system/hal_sys/">system</a></td>
@@ -681,7 +761,7 @@ description of the interfaces are shown below.</p>
<tr>
<td><a href="../hal_uart/hal_uart/">uart</a></td>
<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_uart.h">hal_uart.h</a></td>
-<td>An interface for communicating via asyncrhonous serial interface</td>
+<td>An interface for communicating via asynchronous serial interface .</td>
</tr>
</tbody>
</table>
@@ -694,16 +774,16 @@ description of the interfaces are shown below.</p>
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../hal/>
+ <a href=../hal_architecture/>
<span class="fa fa-arrow-left"></span>
- Previous: Hardware Abstraction Layer
+ Previous: Architecture
</a>
</li>
<li class="pull-right">
- <a href=../hal_gpio/hal_gpio/>
- Next: GPIO
+ <a href=../hal_adc/hal_adc/>
+ Next: ADC
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/modules/hal/hal_architecture/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_architecture/index.html b/os/modules/hal/hal_architecture/index.html
new file mode 100644
index 0000000..0a0385c
--- /dev/null
+++ b/os/modules/hal/hal_architecture/index.html
@@ -0,0 +1,653 @@
+<!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">
+
+
+ <link rel="canonical" href="http://mynewt.apache.org/os/modules/hal/hal_architecture/">
+ <link rel="shortcut icon" href="../../../../img/favicon.ico">
+
+ <title>Architecture - Apache Mynewt</title>
+
+ <link href="../../../../css/bootstrap-3.0.3.min.css" rel="stylesheet">
+ <link href="../../../../css/font-awesome-4.0.3.css" rel="stylesheet">
+ <link rel="stylesheet" href="../../../../css/highlight.css">
+ <link href="../../../../css/base.css" rel="stylesheet">
+ <link href="../../../../css/custom.css" rel="stylesheet">
+ <link href='https://fonts.googleapis.com/css?family=Roboto:400,500,700,900,300,100' rel='stylesheet' type='text/css'>
+ <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
+ <link href="../../../../extra.css" rel="stylesheet">
+
+ <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
+ <script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
+ <![endif]-->
+
+
+ <script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-72162311-1', 'mynewt.incubator.apache.org');
+ ga('send', 'pageview');
+ </script>
+
+ </head>
+
+
+ <body class="Architecture">
+
+
+ <div id="navbar" class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="logo-container">
+ <img src="/img/logo.svg">
+ </div>
+ <div class="container-fluid">
+ <!-- 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="/">Home</a>
+ </li>
+ <li>
+ <a href="/about/">About</a>
+ </li>
+ <li class="dropdown">
+ <a href="/documentation/" class="dropdown-toggle" data-toggle="dropdown">Docs <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+
+
+
+
+ <li >
+ <a href="../../../../documentation/">
+ Overview
+ </a>
+ </li>
+
+
+
+
+
+
+
+
+
+ <li class="active">
+ <a href="../../../get_started/introduction/">
+ Mynewt OS Manual
+ </a>
+ </li>
+
+
+
+ <li >
+ <a href="../../../../newt/newt_intro/">
+ Newt Tool Manual
+ </a>
+ </li>
+
+
+
+ <li >
+ <a href="../../../../newtmgr/overview/">
+ Newt Manager Manual
+ </a>
+ </li>
+
+
+
+ <li >
+ <a href="../../../tutorials/how_to_edit_docs/">
+ Appendix
+ </a>
+ </li>
+
+
+ </ul>
+ </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>
+</div>
+
+
+
+ <div class="container-fluid">
+
+ <div class="row sm-extra-padding">
+ <div id="docSidebar" class="col-md-3 bg-grey sidebar-container"><div class="bs-sidebar hidden-print" role="complementary">
+ <div class="sidebar-top">
+ <img class="hidden-xs hidden-sm logo-small" src="/img/logo.svg" alt="MyNewt" title="MyNewt">
+ <div class="small" role="search">
+ <form id ="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
+ <div class="form-group">
+ <input type="text" name="q" placeholder="Search documentation" />
+ <button class="search-button" type="submit"><i class="fa fa-search"></i></button>
+ </div>
+ </form>
+ </div>
+ </div>
+ <ul class="nav bs-sidenav">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../get_started/introduction/
+">Mynewt OS Manual</a>
+
+
+ <ul class="current-toc">
+
+
+
+
+ <li>
+ <a href="../../../get_started/introduction/">Introduction</a>
+ </li>
+
+
+
+
+
+
+
+
+ <li ><a href="../../../get_started/get_started/">Quick Start</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../get_started/vocabulary/">Concepts</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../tutorials/tutorials/">Tutorials</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../os_user_guide/">OS User Guide</a></li>
+
+
+ <ul class="current-toc">
+
+
+
+
+
+
+
+ <li ><a href="../../../core_os/mynewt_os/">OS Core</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../core_os/porting/port_os/">Porting to your Platform</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../console/console/">Console</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../shell/shell/">Shell</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../bootloader/bootloader/">Bootloader</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+
+
+ ../../fs/fs/fs/
+
+">File System</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../hal/">Hardware Abstraction Layer</a></li>
+
+
+ <ul class="current-toc">
+
+
+
+
+
+
+ <li class="active">
+ Architecture
+ </li>
+
+
+
+
+
+
+
+
+ <li><a href="
+ ../hal_api/
+">API</a>
+
+
+ </li>
+
+
+
+
+
+
+ <li>
+ <a href="../hal_in_libraries/">Using HAL</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../hal_creation/">Creating HAL</a>
+ </li>
+
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../testutil/testutil/">Test Utilities</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../imgmgr/imgmgr/">Image Manager</a></li>
+
+
+ </li>
+
+
+
+
+
+
+ <li>
+ <a href="../../baselibc/">Baselibc library</a>
+ </li>
+
+
+
+
+
+
+
+
+ <li ><a href="../../elua/elua/">Embedded Lua</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../json/json/">JSON</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../stats/stats/">Stats</a></li>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../logs/logs/">Logs</a></li>
+
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../../network/ble/ble_intro/
+">BLE User Guide</a>
+
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../../newt/newt_intro/
+">Newt Tool Manual</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../../newtmgr/overview/
+">Newt Manager Manual</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../tutorials/how_to_edit_docs/
+">Appendix</a>
+
+
+ </li>
+
+
+
+ </ul>
+</div></div>
+
+ <div class="show-sidebar-container">
+ <button class="show-sidebar">Docs Menu</button>
+ </div>
+
+ <div class="col-md-offset-3 col-md-9 documentation-viewer" role="main">
+ <div class="row doc-header">
+ <div class="col-sm-6">
+
+<ul class="nav nav-pills">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="active" role="presentation"><a href="../../../get_started/introduction/">Mynewt OS</a></li>
+
+
+
+ <li role="presentation"><a href="../../../../newt/newt_intro/">Newt Tool</a></li>
+
+
+
+ <li role="presentation"><a href="../../../../newtmgr/overview/">Newt Mgr</a></li>
+
+
+
+
+</ul>
+ </div>
+ <div class="col-sm-6">
+ <div role="navigation" aria-label="breadcrumbs navigation">
+ <ul class="wy-breadcrumbs">
+ <li><a href="/documentation/">Docs</a></li>
+
+
+
+ <li>» <a href="../../../os_user_guide/">OS User Guide</a></li>
+
+
+
+ <li>» <a href="../hal/">Hardware Abstraction Layer</a></li>
+
+
+
+ <li>» Architecture</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h1 id="hardware-abstraction-layer">Hardware Abstraction Layer<a class="headerlink" href="#hardware-abstraction-layer" title="Permanent link">¶</a></h1>
+<p>This page presents a picture of the HAL architecture in its current state. The
+Mynewt is pre-1.0, and we expect significant changes to the HAL as we add
+support for more functionality and platforms. </p>
+<p><img alt="HAL architecture" src="../hal_drawing.png" /></p>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../hal/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: Hardware Abstraction Layer
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../hal_api/>
+ Next: Summary
+ <span class="fa fa-arrow-right"></span>
+ </a>
+
+ </li>
+</ul>
+ </div>
+ <div class="row">
+ <footer>
+ <div class="row">
+ <div class="col-md-12">
+
+ <p class="copyright">Copyright © 2015 The Apache Software Foundation, Licensed under the Apache License, Version 2.0 Apache and the Apache feather logo are trademarks of The Apache Software Foundation.<br>The Apache Software Foundation Apache Incubator</p>
+
+ </div>
+ </div>
+ <div class="copyright-logos">
+ <div class="row">
+ <div class="col-xs-6 text-right">
+ <img src="/img/apache-feather.png" alt="Apache" title="Apache">
+ </div>
+ <div class="col-xs-6 text-left">
+ <img src="/img/apache-logo.png" alt="Apache Incubator" title="Apache Incubator">
+ </div>
+ </div>
+ </div>
+ <div class="row">
+ <div class="col-md-12">
+ <small class="footnote">
+ MyNewt is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
+ </small>
+ </div>
+ </div>
+</footer>
+ </div>
+ </div>
+ </div>
+
+
+ </div>
+
+ <script src="../../../../js/jquery-1.10.2.min.js"></script>
+ <script src="../../../../js/bootstrap-3.0.3.min.js"></script>
+ <script src="../../../../js/highlight.pack.js"></script>
+ <script src="../../../../js/base.js"></script>
+ <script src="../../../../js/custom.js"></script>
+
+ </body>
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/modules/hal/hal_cputime/hal_cpu_timer/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_cputime/hal_cpu_timer/index.html b/os/modules/hal/hal_cputime/hal_cpu_timer/index.html
index 4b80e22..062b8e5 100644
--- a/os/modules/hal/hal_cputime/hal_cpu_timer/index.html
+++ b/os/modules/hal/hal_cputime/hal_cpu_timer/index.html
@@ -326,6 +326,16 @@
+ <li>
+ <a href="../../hal_architecture/">Architecture</a>
+ </li>
+
+
+
+
+
+
+
<li><a href="
../../hal_api/
@@ -348,7 +358,27 @@
<li>
- <a href="../../hal_gpio/hal_gpio/">GPIO</a>
+ <a href="../../hal_adc/hal_adc/">ADC</a>
+ </li>
+
+
+
+
+
+
+
+ <li class="active">
+ CPU timer
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_dac/hal_dac/">DAC</a>
</li>
@@ -370,8 +400,8 @@
- <li class="active">
- CPU timer
+ <li>
+ <a href="../../hal_gpio/hal_gpio/">GPIO</a>
</li>
@@ -381,7 +411,27 @@
<li>
- <a href="../../hal_uart/hal_uart/">UART</a>
+ <a href="../../hal_i2c/hal_i2c/">I2C</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_pwm/hal_pwm/">PWM</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_spi/hal_spi/">SPI</a>
</li>
@@ -397,6 +447,16 @@
+
+
+
+ <li>
+ <a href="../../hal_uart/hal_uart/">UART</a>
+ </li>
+
+
+
+
</ul>
</li>
@@ -407,7 +467,7 @@
<li>
- <a href="../../hal_in_libraries/">Using</a>
+ <a href="../../hal_in_libraries/">Using HAL</a>
</li>
@@ -417,7 +477,7 @@
<li>
- <a href="../../hal_creation/">Creating</a>
+ <a href="../../hal_creation/">Creating HAL</a>
</li>
@@ -666,16 +726,16 @@ may be sufficient and would </p>
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../hal_flash/hal_flash_map/>
+ <a href=../../hal_adc/hal_adc/>
<span class="fa fa-arrow-left"></span>
- Previous: flash_map
+ Previous: ADC
</a>
</li>
<li class="pull-right">
- <a href=../../hal_uart/hal_uart/>
- Next: UART
+ <a href=../../hal_dac/hal_dac/>
+ Next: DAC
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/modules/hal/hal_creation/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_creation/index.html b/os/modules/hal/hal_creation/index.html
index 27b8591..577d6a8 100644
--- a/os/modules/hal/hal_creation/index.html
+++ b/os/modules/hal/hal_creation/index.html
@@ -9,7 +9,7 @@
<link rel="canonical" href="http://mynewt.apache.org/os/modules/hal/hal_creation/">
<link rel="shortcut icon" href="../../../../img/favicon.ico">
- <title>Creating - Apache Mynewt</title>
+ <title>Creating HAL - Apache Mynewt</title>
<link href="../../../../css/bootstrap-3.0.3.min.css" rel="stylesheet">
<link href="../../../../css/font-awesome-4.0.3.css" rel="stylesheet">
@@ -40,7 +40,7 @@
</head>
- <body class="Creating">
+ <body class="Creating HAL">
<div id="navbar" class="navbar navbar-default navbar-fixed-top" role="navigation">
@@ -326,6 +326,16 @@
+ <li>
+ <a href="../hal_architecture/">Architecture</a>
+ </li>
+
+
+
+
+
+
+
<li><a href="
../hal_api/
@@ -340,7 +350,7 @@
<li>
- <a href="../hal_in_libraries/">Using</a>
+ <a href="../hal_in_libraries/">Using HAL</a>
</li>
@@ -350,7 +360,7 @@
<li class="active">
- Creating
+ Creating HAL
</li>
@@ -560,7 +570,7 @@
- <li>» Creating</li>
+ <li>» Creating HAL</li>
@@ -598,6 +608,29 @@ a <strong>direct HAL</strong> <code>hal_foo.h</code>, there can be many implemen
<p>For example, support there is an ADC attached directly to the MCU and an ADC
that is attached via SPI. There would be no way in this simple paradigm
to use both these devices from the HAL API at the same time.</p>
+<p>Current Direct HAL interfaces include:</p>
+<table>
+<thead>
+<tr>
+<th><strong>Hal Name</strong></th>
+<th><strong> Interface File </strong></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>[hal_gpio]</td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_gpio.h">hal_gpio.h</a></td>
+</tr>
+<tr>
+<td>[hal_uart]</td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_uart.h">hal_uart.h</a></td>
+</tr>
+<tr>
+<td>[hal_cputime]</td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_cputime.h">hal_cputime.h</a></td>
+</tr>
+</tbody>
+</table>
<p>This brings up the second paradigm.</p>
<h2 id="indirect-hal-interface">Indirect HAL Interface<a class="headerlink" href="#indirect-hal-interface" title="Permanent link">¶</a></h2>
<p>The second paradigm, <strong>indirect HAL</strong> preserves the simple function
@@ -681,6 +714,41 @@ to have that many <code>hal_gpio_int</code> structures around to basically call
same functions. In Mynewt today, the hal_gpio is a <strong>direct HAL</strong> and does
not have this overhead. More HAL paradigms may be added in the future to address
the flexibility of the <strong>indirect HAL</strong> with the memory efficiency of the <strong>direct HAL</strong></p>
+<p>Current Indirect HAL interfaces include:</p>
+<table>
+<thead>
+<tr>
+<th><strong>Hal Name</strong></th>
+<th><strong> Interface File </strong></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>hal_adc_int</td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_adc_int.h">hal_adc_int.h</a></td>
+</tr>
+<tr>
+<td>hal_dac</td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_dac_int.h">hal_dac_int.h</a></td>
+</tr>
+<tr>
+<td>hal_flash_int</td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_flash_int.h">hal_flash_int.h</a></td>
+</tr>
+<tr>
+<td>hal_pwm_int</td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_pwm_int.h">hal_pwm_int.h</a></td>
+</tr>
+<tr>
+<td>hal_i2c_int</td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_i2c_int.h">hal_i2c_int.h</a></td>
+</tr>
+<tr>
+<td>hal_spi_int</td>
+<td><a href="https://github.com/apache/incubator-mynewt-larva/blob/master/hw/hal/include/hal/hal_spi_int.h">hal_spi_int.h</a></td>
+</tr>
+</tbody>
+</table>
<div class="row">
@@ -692,7 +760,7 @@ the flexibility of the <strong>indirect HAL</strong> with the memory efficiency
<a href=../hal_in_libraries/>
<span class="fa fa-arrow-left"></span>
- Previous: Using
+ Previous: Using HAL
</a>
</li>