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:24 UTC
[2/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/os/modules/hal/hal_flash/hal_flash/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_flash/hal_flash/index.html b/os/modules/hal/hal_flash/hal_flash/index.html
index 047db14..0c6ae53 100644
--- a/os/modules/hal/hal_flash/hal_flash/index.html
+++ b/os/modules/hal/hal_flash/hal_flash/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>
+ <a href="../../hal_cputime/hal_cpu_timer/">CPU timer</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_dac/hal_dac/">DAC</a>
</li>
@@ -405,7 +435,7 @@
<li>
- <a href="../../hal_cputime/hal_cpu_timer/">CPU timer</a>
+ <a href="../../hal_gpio/hal_gpio/">GPIO</a>
</li>
@@ -415,7 +445,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>
@@ -431,6 +481,16 @@
+
+
+
+ <li>
+ <a href="../../hal_uart/hal_uart/">UART</a>
+ </li>
+
+
+
+
</ul>
</li>
@@ -441,7 +501,7 @@
<li>
- <a href="../../hal_in_libraries/">Using</a>
+ <a href="../../hal_in_libraries/">Using HAL</a>
</li>
@@ -451,7 +511,7 @@
<li>
- <a href="../../hal_creation/">Creating</a>
+ <a href="../../hal_creation/">Creating HAL</a>
</li>
@@ -680,9 +740,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../hal_gpio/hal_gpio/>
+ <a href=../../hal_dac/hal_dac/>
<span class="fa fa-arrow-left"></span>
- Previous: GPIO
+ Previous: DAC
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/modules/hal/hal_flash/hal_flash_int/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_flash/hal_flash_int/index.html b/os/modules/hal/hal_flash/hal_flash_int/index.html
index b004571..f777275 100644
--- a/os/modules/hal/hal_flash/hal_flash_int/index.html
+++ b/os/modules/hal/hal_flash/hal_flash_int/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>
+ <a href="../../hal_cputime/hal_cpu_timer/">CPU timer</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_dac/hal_dac/">DAC</a>
</li>
@@ -405,7 +435,7 @@
<li>
- <a href="../../hal_cputime/hal_cpu_timer/">CPU timer</a>
+ <a href="../../hal_gpio/hal_gpio/">GPIO</a>
</li>
@@ -415,7 +445,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>
@@ -431,6 +481,16 @@
+
+
+
+ <li>
+ <a href="../../hal_uart/hal_uart/">UART</a>
+ </li>
+
+
+
+
</ul>
</li>
@@ -441,7 +501,7 @@
<li>
- <a href="../../hal_in_libraries/">Using</a>
+ <a href="../../hal_in_libraries/">Using HAL</a>
</li>
@@ -451,7 +511,7 @@
<li>
- <a href="../../hal_creation/">Creating</a>
+ <a href="../../hal_creation/">Creating HAL</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/modules/hal/hal_flash/hal_flash_map/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_flash/hal_flash_map/index.html b/os/modules/hal/hal_flash/hal_flash_map/index.html
index 25b9c92..664eb02 100644
--- a/os/modules/hal/hal_flash/hal_flash_map/index.html
+++ b/os/modules/hal/hal_flash/hal_flash_map/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>
+ <a href="../../hal_cputime/hal_cpu_timer/">CPU timer</a>
+ </li>
+
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_dac/hal_dac/">DAC</a>
</li>
@@ -405,7 +435,7 @@
<li>
- <a href="../../hal_cputime/hal_cpu_timer/">CPU timer</a>
+ <a href="../../hal_gpio/hal_gpio/">GPIO</a>
</li>
@@ -415,7 +445,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>
@@ -431,6 +481,16 @@
+
+
+
+ <li>
+ <a href="../../hal_uart/hal_uart/">UART</a>
+ </li>
+
+
+
+
</ul>
</li>
@@ -441,7 +501,7 @@
<li>
- <a href="../../hal_in_libraries/">Using</a>
+ <a href="../../hal_in_libraries/">Using HAL</a>
</li>
@@ -451,7 +511,7 @@
<li>
- <a href="../../hal_creation/">Creating</a>
+ <a href="../../hal_creation/">Creating HAL</a>
</li>
@@ -688,8 +748,8 @@
</li>
<li class="pull-right">
- <a href=../../hal_cputime/hal_cpu_timer/>
- Next: CPU timer
+ <a href=../../hal_gpio/hal_gpio/>
+ Next: GPIO
<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_gpio/hal_gpio/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_gpio/hal_gpio/index.html b/os/modules/hal/hal_gpio/hal_gpio/index.html
index f61925a..ceeb28b 100644
--- a/os/modules/hal/hal_gpio/hal_gpio/index.html
+++ b/os/modules/hal/hal_gpio/hal_gpio/index.html
@@ -326,6 +326,16 @@
+ <li>
+ <a href="../../hal_architecture/">Architecture</a>
+ </li>
+
+
+
+
+
+
+
<li><a href="
../../hal_api/
@@ -347,8 +357,28 @@
- <li class="active">
- GPIO
+ <li>
+ <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>
@@ -370,8 +400,18 @@
+ <li class="active">
+ GPIO
+ </li>
+
+
+
+
+
+
+
<li>
- <a href="../../hal_cputime/hal_cpu_timer/">CPU timer</a>
+ <a href="../../hal_i2c/hal_i2c/">I2C</a>
</li>
@@ -381,7 +421,17 @@
<li>
- <a href="../../hal_uart/hal_uart/">UART</a>
+ <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>
@@ -681,16 +741,16 @@ Examine how <code>task1_handler</code> initializes and toggles the GPIO to contr
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../hal_api/>
+ <a href=../../hal_flash/hal_flash_map/>
<span class="fa fa-arrow-left"></span>
- Previous: Summary
+ Previous: flash_map
</a>
</li>
<li class="pull-right">
- <a href=../../hal_flash/hal_flash/>
- Next: Overview
+ <a href=../../hal_i2c/hal_i2c/>
+ Next: I2C
<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_i2c/hal_i2c/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_i2c/hal_i2c/index.html b/os/modules/hal/hal_i2c/hal_i2c/index.html
new file mode 100644
index 0000000..cb89496
--- /dev/null
+++ b/os/modules/hal/hal_i2c/hal_i2c/index.html
@@ -0,0 +1,854 @@
+<!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_i2c/hal_i2c/">
+ <link rel="shortcut icon" href="../../../../../img/favicon.ico">
+
+ <title>I2C - 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="I2C">
+
+
+ <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>
+ <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>
+
+
+
+
+
+
+
+
+ <li><a href="
+ ../../hal_flash/hal_flash/
+">Flash memory</a>
+
+
+ </li>
+
+
+
+
+
+
+ <li>
+ <a href="../../hal_gpio/hal_gpio/">GPIO</a>
+ </li>
+
+
+
+
+
+
+
+ <li class="active">
+ I2C
+ </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>» I2C</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h1 id="hal_i2c">hal_i2c<a class="headerlink" href="#hal_i2c" title="Permanent link">¶</a></h1>
+<p>The hardware independent interface to I2C Devices.</p>
+<h3 id="description">Description<a class="headerlink" href="#description" title="Permanent link">¶</a></h3>
+<p>An Inter-Integrated Circuit (I²C ] I-squared-C) bus is a multi-master,
+multi-save serial interface used to connect components on a circuit board
+and often peripherals devices located off the circuit board.</p>
+<p>I2C is often though of as a 2-wire protocol because it uses two wires (SDA, SCL)
+to send data between devices. </p>
+<p>For a detailed description of I2C, see the <a href="https://en.wikipedia.org/wiki/I²C">I²C wikipedia page</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_i2c.h">hal_i2c.h</a></p>
+<h3 id="hal_i2c-theory-of-operation">HAL_I2C Theory Of Operation<a class="headerlink" href="#hal_i2c-theory-of-operation" title="Permanent link">¶</a></h3>
+<p>An I²C transaction typically involves acquiring the bus, sending and/or receiving
+data and release the bus. The bus acquisition portion is important because
+the bus is typically multi-master so other devices may be trying to read/write
+the same peripheral. </p>
+<p>HAL_I2C implements a master interface to the I²C bus. Typical usage of the
+interface would involve the following steps.</p>
+<ol>
+<li>initialize an I²C device using <code>hal_i2c_init</code></li>
+<li>when you want to perform an I²C transaction:<ol>
+<li>Issue the <code>hal_i2c_begin()</code> command. </li>
+<li>Issue one or more <code>hal_i2c_read</code> and/or <code>hal_i2c_write</code> commands</li>
+<li>Issue the <code>hal_i2c_end()</code> command.</li>
+</ol>
+</li>
+</ol>
+<p>An addition API was added called <code>hal_i2c_probe</code>. This command combines
+<code>hal_i2c_begin()</code>, <code>hal_i2c_read</code>, and <code>hal_i2c_end()</code> to try to read 0-bytes
+from a specific bus address. its intended to provide an easy way to probe
+the bus for a specific device. NOTE: if the device is write-only, it will
+not appear with this command.</p>
+<h3 id="hal_i2c-data">HAL_I2C Data<a class="headerlink" href="#hal_i2c-data" title="Permanent link">¶</a></h3>
+<p>Data to read/write is passed to the hal_i2c APIs via the </p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">struct hal_i2c_master_data {
+ uint8_t address; /* destination address */
+ uint16_t len; /* number of bytes to transmit or receive */
+ uint8_t *buffer; /* data buffer for transmit or receive */
+};
+</pre></div>
+
+
+<p><code>buffer</code> is a pointer to the data to send. <code>len</code> is the number of bytes
+to send over the bus. <code>address</code> is a 7-bit bus address of the device.</p>
+<p>When I²C builds its address, it uses the 7-bit address plus a 1-bit R/W
+(read/write) indicator to identify the device and direction of the
+transaction. Thus when using this API, you should use a 7-bit address
+in the data structure and ensure that address is a value between 0-127.</p>
+<p>As an example, consider an I²C device address that looks like this:</p>
+<table>
+<thead>
+<tr>
+<th>B7</th>
+<th>B6</th>
+<th>B5</th>
+<th>B4</th>
+<th>B3</th>
+<th>B2</th>
+<th>B1</th>
+<th>B0</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>1</td>
+<td>0</td>
+<td>0</td>
+<td>0</td>
+<td>1</td>
+<td>1</td>
+<td>0</td>
+<td>R/W</td>
+</tr>
+<tr>
+<td>MSB</td>
+<td></td>
+<td></td>
+<td></td>
+<td></td>
+<td></td>
+<td></td>
+<td>LSB</td>
+</tr>
+</tbody>
+</table>
+<p>In the HAL_I2C API you would communicate with this device with address
+<code>0b1000110</code>, whic is hex 0x46 or decimal 70. The I²C drive would add the R/W bit
+and transmit it as hex 0x8D or 0x8D depending whether it was a read or
+write command.</p>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../../hal_gpio/hal_gpio/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: GPIO
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../../hal_pwm/hal_pwm/>
+ Next: PWM
+ <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_in_libraries/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_in_libraries/index.html b/os/modules/hal/hal_in_libraries/index.html
index c4cfeeb..bee7489 100644
--- a/os/modules/hal/hal_in_libraries/index.html
+++ b/os/modules/hal/hal_in_libraries/index.html
@@ -9,7 +9,7 @@
<link rel="canonical" href="http://mynewt.apache.org/os/modules/hal/hal_in_libraries/">
<link rel="shortcut icon" href="../../../../img/favicon.ico">
- <title>Using - Apache Mynewt</title>
+ <title>Using 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="Using">
+ <body class="Using 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 class="active">
- Using
+ Using HAL
</li>
@@ -350,7 +360,7 @@
<li>
- <a href="../hal_creation/">Creating</a>
+ <a href="../hal_creation/">Creating HAL</a>
</li>
@@ -560,7 +570,7 @@
- <li>» Using</li>
+ <li>» Using HAL</li>
@@ -641,16 +651,16 @@ to the correct physical pin in their system.</p>
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../hal_system/hal_sys/>
+ <a href=../hal_uart/hal_uart/>
<span class="fa fa-arrow-left"></span>
- Previous: System
+ Previous: UART
</a>
</li>
<li class="pull-right">
<a href=../hal_creation/>
- Next: Creating
+ Next: Creating HAL
<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_pwm/hal_pwm/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_pwm/hal_pwm/index.html b/os/modules/hal/hal_pwm/hal_pwm/index.html
new file mode 100644
index 0000000..657866e
--- /dev/null
+++ b/os/modules/hal/hal_pwm/hal_pwm/index.html
@@ -0,0 +1,824 @@
+<!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_pwm/hal_pwm/">
+ <link rel="shortcut icon" href="../../../../../img/favicon.ico">
+
+ <title>PWM - 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="PWM">
+
+
+ <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>
+ <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>
+
+
+
+
+
+
+
+
+ <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 class="active">
+ PWM
+ </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>» PWM</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h1 id="hal_pwm">hal_pwm<a class="headerlink" href="#hal_pwm" title="Permanent link">¶</a></h1>
+<p>The hardware independent interface to Pulse Width Modulators</p>
+<h3 id="description">Description<a class="headerlink" href="#description" title="Permanent link">¶</a></h3>
+<p>Pulse Width Modulators (PWMs) are hardware devices that output digital waveforms
+with programmable duty cycle and frequency. They use a digital waveform
+but can contiuously adjust the amount of power delivered to their load via
+duty cycle. They are often used to create analog waveforms via low pass filter,
+drive LEDs at various intensities, and control DC or servo motors.</p>
+<p>For a description of PSM, see <a href="https://en.wikipedia.org/wiki/Pulse-width_modulation">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_pwm.h">hal_pwm.h</a></p>
+<h3 id="hal_pwm-theory-of-operation">HAL_PWM Theory Of Operation<a class="headerlink" href="#hal_pwm-theory-of-operation" title="Permanent link">¶</a></h3>
+<p>The HAL_PWM interface was designed with some specific use cases in mind. It
+was also designed to exploit a subset of the functionality provided by
+common PWM controllers.</p>
+<p>Fundamentally, a PWM has at it root an N-bit COUNTER, a CLOCK source, one or
+more CAPTURE registers, and sometimes a TOP register.</p>
+<p>The clock source feeds the COUNTER register which is continuously counting
+(up or down), When the COUNTER is less than the value of the CAPTURE
+register, the PWM outputs a logic HIGH. When the counter is greater than
+the CAPTURE register the PWM outputs logic LOW. When the counter reaches the TOP
+register, it wraps back to zero. If the PWM has no TOP register, it simply
+wraps back to zero after reaching 2^N-1.</p>
+<p>The HAL_PWM abstracts this implementation and provides methods to set the
+PWM frequency and duty cycle. The frequency is the rate at which the counter
+wraps back to zero. The duty cycle is the fraction of time the PWM is in
+logic HIGH state.</p>
+<p>The HAL_PWM API provides a few methods to get information on the PWM.</p>
+<table>
+<thead>
+<tr>
+<th><strong>Method Name</strong></th>
+<th><strong> Description </strong></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>hal_pwm_get_source_clock_freq</td>
+<td>gets the frequency of the CLOCK that is driving the COUNTER</td>
+</tr>
+<tr>
+<td>hal_pwm_get_resolution_bits</td>
+<td>gets the number of bits in the COUNTER</td>
+</tr>
+</tbody>
+</table>
+<p>To use a PWM via HAL_PWM, follow these simple steps.</p>
+<p>1) initialize a PWM using <code>hal_pwm_init</code> -- this binds the driver to the device
+for the specific PWM you are using
+2) Optionally set the frequency of the PWM using <code>hal_pwm_set_frequency</code>
+-- PWMs that support a TOP register have fine control over their frequency
+settings. If this command is not supported by the PWM it will return an error
+and its likely that there is no TOP register; the frequency resolution is not
+finely adjustable. See the BSP for coarse adjustment of the PWM frequency.<br />
+3) Enable the PWM to output a specific duty cycle using the
+<code>hal_pwm_enable_duty_cycle</code> API</p>
+<p>To change the duty cycle dynamically, just issue another
+<code>hal_pwm_enable_duty_cycle</code> command.</p>
+<p>To disable the PWM waveform, use <code>hal_pwm_disable</code>.</p>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../../hal_i2c/hal_i2c/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: I2C
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../../hal_spi/hal_spi/>
+ Next: SPI
+ <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_spi/hal_spi/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_spi/hal_spi/index.html b/os/modules/hal/hal_spi/hal_spi/index.html
new file mode 100644
index 0000000..68f4e33
--- /dev/null
+++ b/os/modules/hal/hal_spi/hal_spi/index.html
@@ -0,0 +1,830 @@
+<!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_spi/hal_spi/">
+ <link rel="shortcut icon" href="../../../../../img/favicon.ico">
+
+ <title>SPI - 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="SPI">
+
+
+ <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>
+ <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>
+
+
+
+
+
+
+
+
+ <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 class="active">
+ SPI
+ </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>» SPI</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h1 id="hal_spi">hal_spi<a class="headerlink" href="#hal_spi" title="Permanent link">¶</a></h1>
+<p>SPI (Serial Peripheral Interface) is a synchronous 4-wire serial interface
+commonly used to connect components in embedded systems.</p>
+<p>For a detailed description of SPI, see <a href="https://en.wikipedia.org/wiki/Serial_Peripheral_Interface_Bus">Wikipedia</a>.</p>
+<h3 id="description">Description<a class="headerlink" href="#description" title="Permanent link">¶</a></h3>
+<p>The Mynewt HAL interface supports the SPI master functionality only. Future
+version will support SPI slave functionality.</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_spi.h">hal_spi.h</a></p>
+<h3 id="hal_spi-theory-of-operation">HAL_SPI Theory Of Operation<a class="headerlink" href="#hal_spi-theory-of-operation" title="Permanent link">¶</a></h3>
+<p>SPI is called a 4-wire interface because of the 4 signals, MISO, MOSI, CLK,
+and SS. The SS signal (slave select) is an active low signal that activates
+a SPI slave device. This is how a master "addresses" a particular slave
+device. Often this signal is also referred to as "chip select" as it
+selects particular slave device for communications.</p>
+<p>The Mynewt SPI HAL has blocking transfers. This means that the API call
+to transfer a byte will wait until the byte completes transmissions before
+the function returns.</p>
+<p>Since SPI is generally a shared communications bus, the hal_spi API allows
+SPI runtime configuration to be compatible with the data format and speed of the
+slave device. See the <code>hal_spi_config</code> method in the API above for a
+description of the available settings. These settings are critical to the
+operation of the slave device.</p>
+<p>The Mynewt SPI HAL does not include built-in SS signaling. Its up to the
+hal_spi user to control their own SS pins. Typically applications will do
+this with GPIO.</p>
+<p>An example of this would look like this (error handling excluded for brevity):</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> /* each device may have different settings */
+ extern struct hal_spi_settings dev1;
+ extern struct hal_spi_settings dev2;
+
+ gpio_init_out(SS_DEV_1, 1);
+ gpio_init_out(SS_DEV_2, 1);
+ hal_spi *pspi = hal_spi_init(SPI0);
+
+ ...
+ /* write a single byte (0) to device 1 */
+ hal_spi_config(pspi, &dev1);
+ gpio_clear(SS_DEV_1)
+ rc = hal_spi_transfer(pspi, 0)
+ gpio_set(SS_DEV_1)
+
+ /* read a single byte from device 2 */
+ hal_spi_config(pspi, &dev2);
+ gpio_clear(SS_DEV_2)
+ val = hal_spi_transfer(pspi, 0)
+ gpio_set(SS_DEV_2)
+</pre></div>
+
+
+<p>Depending on the device's operation, it may be necessary or more efficient
+to write or read multiple bytes in a single transaction. An example is
+shown below</p>
+<p>```no-highlight</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">void spi_write_buf(struct hal_spi *pspi, uint8_t *buf, int len) {
+ char *ptr = buf;
+
+ hal_spi_config(pspi, &dev2);
+ gpio_clear(SS_DEV_2)
+ while(len-- > 0) {
+ val = hal_spi_transfer(pspi, (uint16_t) *ptr++)
+ }
+ gpio_set(SS_DEV_2)
+}
+</pre></div>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../../hal_pwm/hal_pwm/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: PWM
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../../hal_system/hal_sys/>
+ Next: System
+ <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_system/hal_sys/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_system/hal_sys/index.html b/os/modules/hal/hal_system/hal_sys/index.html
index 39788b3..93a2777 100644
--- a/os/modules/hal/hal_system/hal_sys/index.html
+++ b/os/modules/hal/hal_system/hal_sys/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>
+ <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>
@@ -646,16 +706,16 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../hal_uart/hal_uart/>
+ <a href=../../hal_spi/hal_spi/>
<span class="fa fa-arrow-left"></span>
- Previous: UART
+ Previous: SPI
</a>
</li>
<li class="pull-right">
- <a href=../../hal_in_libraries/>
- Next: Using
+ <a href=../../hal_uart/hal_uart/>
+ Next: UART
<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_uart/hal_uart/index.html
----------------------------------------------------------------------
diff --git a/os/modules/hal/hal_uart/hal_uart/index.html b/os/modules/hal/hal_uart/hal_uart/index.html
index e6b0f5a..721f8ca 100644
--- a/os/modules/hal/hal_uart/hal_uart/index.html
+++ b/os/modules/hal/hal_uart/hal_uart/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>
+ <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>
@@ -380,8 +410,28 @@
- <li class="active">
- UART
+ <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>
@@ -397,6 +447,16 @@
+
+
+
+ <li class="active">
+ UART
+ </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>
@@ -665,16 +725,16 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../hal_cputime/hal_cpu_timer/>
+ <a href=../../hal_system/hal_sys/>
<span class="fa fa-arrow-left"></span>
- Previous: CPU timer
+ Previous: System
</a>
</li>
<li class="pull-right">
- <a href=../../hal_system/hal_sys/>
- Next: System
+ <a href=../../hal_in_libraries/>
+ Next: Using HAL
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/modules/testutil/testutil/index.html
----------------------------------------------------------------------
diff --git a/os/modules/testutil/testutil/index.html b/os/modules/testutil/testutil/index.html
index ea29c4f..58e8213 100644
--- a/os/modules/testutil/testutil/index.html
+++ b/os/modules/testutil/testutil/index.html
@@ -635,7 +635,7 @@ This should be populated before <code>tu_init()</code> is called.</p>
<a href=../../hal/hal_creation/>
<span class="fa fa-arrow-left"></span>
- Previous: Creating
+ Previous: Creating HAL
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/tutorials/arduino_zero/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/arduino_zero/index.html b/os/tutorials/arduino_zero/index.html
index fc5e44a..44efff7 100644
--- a/os/tutorials/arduino_zero/index.html
+++ b/os/tutorials/arduino_zero/index.html
@@ -510,15 +510,17 @@
<p>You will need the following equipment</p>
<ul>
<li>An Arduino Zero board. NOTE: There are many flavors of Arduino. Ensure that
-you have an Arduino Zero. See below for the verions of Arduino Zero that are
+you have an Arduino Zero. See below for the versions of Arduino Zero that are
compatible with this tutorial</li>
<li>A computer that can connect to the Arduino Zero over USB</li>
<li>A USB cable (Type A to micro B) that can connect the computer to the Arduino</li>
<li>The Mynewt Release</li>
</ul>
-<p>This tutorial has been tested on the following two Arduino Zero boards - Zero and Zero-Pro.</p>
-<p><img src="https://www.arduino.cc/en/uploads/Main/Zero_Usb_Ports.jpg" alt="Drawing" style="width: 400px;"/>
-<img src="http://www.arduino.org//images/products/ArduinoZeroPro-flat-org.jpg" alt="Drawing" style="width: 330px;"/></p>
+<p>This tutorial has been tested on the following three Arduino Zero boards - Zero, M0 Pro, and Zero-Pro.</p>
+<p><img src="https://www.arduino.cc/en/uploads/Main/Zero_Usb_Ports.jpg" alt="Drawing" style="width: 390px;"/>
+<img src="http://www.arduino.org/images/products/Arduino-M0Pro-flat.jpg" alt="Drawing" style="width: 310px;"/>
+<img src="http://www.arduino.org//images/products/ArduinoZeroPro-flat-org.jpg" alt="Drawing" style="width: 310px;"/></p>
+<p>Mynewt has not been tested on Arduino M0 which has no internal debugger support.</p>
<h3 id="install-mynewt-and-newt">Install Mynewt and Newt<a class="headerlink" href="#install-mynewt-and-newt" title="Permanent link">¶</a></h3>
<ul>
<li>If you have not already done so, install Newt as shown in the <a href="../../../newt/install/newt_mac/">Newt install tutorial</a></li>
@@ -579,7 +581,7 @@ $ newt target set arduino_boot build_profile=optimized
<p><br></p>
-<p>If you have an Arduino Zero Pro, you have to set the following next:</p>
+<p>If you have an Arduino Zero Pro or M0 Pro, you have to set the following next:</p>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt target set arduino_boot features=arduino_zero_pro
</pre></div>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/a946b6be/os/tutorials/tutorials/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/tutorials/index.html b/os/tutorials/tutorials/index.html
index 88f1b0b..f63c3cb 100644
--- a/os/tutorials/tutorials/index.html
+++ b/os/tutorials/tutorials/index.html
@@ -502,16 +502,44 @@
<h2 id="tutorials">Tutorials<a class="headerlink" href="#tutorials" title="Permanent link">¶</a></h2>
<p>If the introduction to Mynewt has piqued your interest and you want to familiarize yourself with some of its functionality, this series of tutorials is for you. The lessons are aimed at the beginner. </p>
-<p>Here is a sampler of the tutorials available. New ones are being constantly added and can be seen in the navigation bar on the left.</p>
+<p>The full list of tutorials can be seen in the navigation bar on the left. New ones are being constantly added and will show up there automatically.</p>
+<h3 id="prerequisites">Prerequisites:<a class="headerlink" href="#prerequisites" title="Permanent link">¶</a></h3>
+<ul>
+<li>You have installed Docker container of Newt tool and toolchains or you have installed them natively on your machine</li>
+<li>You have created a new project space (directory structure) and populated it with the core code repository (apache-mynewt-core) or know how to as explained in ../get_started/project_create.</li>
+</ul>
+<h3 id="tutorial-categories">Tutorial categories:<a class="headerlink" href="#tutorial-categories" title="Permanent link">¶</a></h3>
+<p>The tutorials fall into a few broad categories. Some examples in each category are listed below.</p>
+<ul>
+<li>
+<p>Making an LED blink (the "Hello World" equivalent in the electronics world)</p>
<ul>
<li><a href="../arduino_zero/">Blinky on Arduino Zero hardware</a></li>
<li><a href="../olimex/">Blinky on Olimex/STM32F407ZGT6 Cortex-M4 hardware</a></li>
<li><a href="../STM32F303/">Blinky on STM32F3 discovery kit from ST Micro</a></li>
<li><a href="../nRF52/">Blinky on nRF52 Development Kit from Nordic Semiconductor</a> <strong>Note:</strong> This supports BLE.</li>
-<li><a href="../unit_test/">Add a unit Test for a Package</a></li>
-<li><a href="../air_quality_sensor/">Add an air-quality sensor</a> </li>
-<li><a href="../add_repos/">Additional Repositories</a></li>
-<li><a href="../event_queue/">A task to manage multiple events</a></li>
+</ul>
+</li>
+<li>
+<p>Navigating the code and adding functionality </p>
+<ul>
+<li><a href="../add_repos/">Adding more repositories to your project</a></li>
+<li><a href="../unit_test/">Adding a unit test for a package</a></li>
+<li><a href="../event_queue/">Adding task to manage multiple events</a></li>
+</ul>
+</li>
+<li>
+<p>Bluetooth Low Energy</p>
+<ul>
+<li><a href="../bletiny_project/">Running the example BLE app included in the repo</a></li>
+</ul>
+</li>
+<li>
+<p>Using NewtMgr </p>
+<ul>
+<li><a href="../project-slinky/">Enabling remote communication with a device running Mynewt OS</a></li>
+</ul>
+</li>
</ul>
<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 href="../../../community/">here</a>.</p>
<p><br></p>