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/05/29 00:23:11 UTC
[3/6] incubator-mynewt-site git commit: Added blehci project
tutorial. Fixed typos from pull request #89
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/network/ble/nimble_setup/index.html
----------------------------------------------------------------------
diff --git a/network/ble/nimble_setup/index.html b/network/ble/nimble_setup/index.html
index 07f2cd8..becce97 100644
--- a/network/ble/nimble_setup/index.html
+++ b/network/ble/nimble_setup/index.html
@@ -337,7 +337,7 @@
<p>This tutorial explains how to set up an application using the NimBLE stack. The end result will be a framework that you can use to create your own BLE application using the nimble stack.</p>
<p>This tutorial assumes that you have already installed the newt tool and are familiar with its concepts.</p>
<h3 id="create-the-application-directory">Create the application directory</h3>
-<p>You start by creating a project space for your own application work using the Newt tool (<code>my_proj1</code> in this example) and installing all the additional apps and libraries available by adding the repo <code>apache-mynewt-core</code>. See the tutorial on <a href="../../../os/tutorials/add_repos/">adding a repo</a> for more on working with repos.</p>
+<p>You start by creating a project space for your own application work using the Newt tool (<code>my_proj1</code> in this example) and installing all the additional apps and libraries available by adding the repo <code>apache-mynewt-core</code>. See the tutorial on <a href="../../os/tutorials/add_repos.md">adding a repo</a> for more on working with repos.</p>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">~/dev$ newt new my_proj1
Downloading project skeleton from apache/incubator-mynewt-blinky...
Installing skeleton in my_proj1...
@@ -514,7 +514,7 @@ App successfully built: /Users/wes/dev/my_proj1/bin/ble_tgt/apps/ble_app/ble_app
<h3 id="conclusion">Conclusion</h3>
<p>You now have a fully functional BLE app (never mind the fact that it doesn't
actually do anything yet!). With all the necessary infrastructure in place,
-you can now start turning this into a real applicaiton. Additional tutorials
+you can now start turning this into a real application. Additional tutorials
with focus on adding application-layer functionality to your Nimble application
will be coming soon. In the meantime, you might get some inspiration from
apache-mynewt-core's example Nimble apps. These apps can be found at the below locations, relative to your project's base directory:</p>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/newt/install/newt_linux/index.html
----------------------------------------------------------------------
diff --git a/newt/install/newt_linux/index.html b/newt/install/newt_linux/index.html
index 9358f3e..d8e4ae7 100644
--- a/newt/install/newt_linux/index.html
+++ b/newt/install/newt_linux/index.html
@@ -360,7 +360,7 @@
<h4 id="2-install-go-the-programming-language">2. Install Go, the programming language</h4>
<ul>
<li>
-<p>Go language enviroment dictates a directory structure. Known in Go parlanace as workspace, it must contain three sibling directories with the directory names src, pkg and bin, as explained below. </p>
+<p>Go language environment dictates a directory structure. Known in Go parlanace as workspace, it must contain three sibling directories with the directory names src, pkg and bin, as explained below. </p>
<ul>
<li>
<p>src contains Go source files organized into packages (one package per directory),</p>
@@ -392,7 +392,7 @@
<p><br></p>
<ul>
<li>
-<p>Next, install Go. When installed, Go offers you as a developer a language enviroment (to compile Go code), construct Go packages (to assemble Go packages) and import Go code (from github). In the next step, you will use the Go commands to import <em>newt</em> repo into your local Go environment.</p>
+<p>Next, install Go. When installed, Go offers you as a developer a language environment (to compile Go code), construct Go packages (to assemble Go packages) and import Go code (from github). In the next step, you will use the Go commands to import <em>newt</em> repo into your local Go environment.</p>
<p><strong>Note</strong>: The Newt tool requires Go version 1.5 or later. It uses the support for "vendoring" that was added in Go 1.5. Depending on the Ubuntu version you have, the following may install an earlier version. In that case, download the latest package of Go 1.5 or 1.6 from <a href="https://golang.org/dl/">https://golang.org/dl/</a>. You can search for more detailed instructions such as installing Go 1.6 on Ubuntu 14.04 which can be found at <a href="https://www.digitalocean.com/community/tutorials/how-to-install-go-1-6-on-ubuntu-14-04">https://www.digitalocean.com/community/tutorials/how-to-install-go-1-6-on-ubuntu-14-04</a>.</p>
</li>
</ul>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/newt/install/newt_mac/index.html
----------------------------------------------------------------------
diff --git a/newt/install/newt_mac/index.html b/newt/install/newt_mac/index.html
index 427cdc5..090c8d2 100644
--- a/newt/install/newt_mac/index.html
+++ b/newt/install/newt_mac/index.html
@@ -363,7 +363,7 @@
<h4 id="2-install-go-the-programming-language">2. Install Go, the programming language</h4>
<ul>
<li>
-<p>Go language enviroment dictates a directory structure. Known in Go parlanace as workspace, it must contain three sibling directories with the directory names src, pkg and bin, as explained below. </p>
+<p>Go language environment dictates a directory structure. Known in Go parlanace as workspace, it must contain three sibling directories with the directory names src, pkg and bin, as explained below. </p>
<ul>
<li>
<p>src contains Go source files organized into packages (one package per directory),</p>
@@ -395,7 +395,7 @@
<p><br></p>
<ul>
-<li>Next, using <em>brew</em>, install Go. When installed, Go offers you as a developer a language enviroment (to compile Go code), construct Go packages (to assemble Go packages) and import Go code (from github). In the next step, you will use the Go commands to import <em>newt</em> repo into your local Go environment.</li>
+<li>Next, using <em>brew</em>, install Go. When installed, Go offers you as a developer a language environment (to compile Go code), construct Go packages (to assemble Go packages) and import Go code (from github). In the next step, you will use the Go commands to import <em>newt</em> repo into your local Go environment.</li>
</ul>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> $ brew install go
==>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/core_os/mbuf/mbuf/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/mbuf/mbuf/index.html b/os/core_os/mbuf/mbuf/index.html
index df93868..bf30c56 100644
--- a/os/core_os/mbuf/mbuf/index.html
+++ b/os/core_os/mbuf/mbuf/index.html
@@ -766,7 +766,7 @@
}
}
- <span style="color: #177500">/* Free passed in packet (mbuf chain) since we dont need it anymore */</span>
+ <span style="color: #177500">/* Free passed in packet (mbuf chain) since we don't need it anymore */</span>
<span style="color: #000000">os_mbuf_free_chain</span>(<span style="color: #000000">om</span>);
}
</pre></div>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/core_os/memory_pool/os_memblock_get/index.html
----------------------------------------------------------------------
diff --git a/os/core_os/memory_pool/os_memblock_get/index.html b/os/core_os/memory_pool/os_memblock_get/index.html
index ccbd1df..da08da3 100644
--- a/os/core_os/memory_pool/os_memblock_get/index.html
+++ b/os/core_os/memory_pool/os_memblock_get/index.html
@@ -658,7 +658,7 @@
</pre></div>
-<p>Allocate an element from the memory pool. If succesful, you'll get a pointer to allocated element. If there are no elements available, you'll get NULL as response.</p>
+<p>Allocate an element from the memory pool. If successful, you'll get a pointer to allocated element. If there are no elements available, you'll get NULL as response.</p>
<h4 id="arguments">Arguments</h4>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/get_started/vocabulary/index.html
----------------------------------------------------------------------
diff --git a/os/get_started/vocabulary/index.html b/os/get_started/vocabulary/index.html
index 718f3ef..86a3638 100644
--- a/os/get_started/vocabulary/index.html
+++ b/os/get_started/vocabulary/index.html
@@ -380,7 +380,7 @@ makes it very clean and easy to write re-usable components, which can describe t
Dependencies and APIs to the rest of the system.</p>
<h3 id="target">Target</h3>
<p>A target in Apache Mynewt is very similar to a target in <em>make</em>. It is the collection
-of parameters that must be passed to Newt in order to generate a reproducable build. A
+of parameters that must be passed to Newt in order to generate a reproducible build. A
target represents the top of the build tree, and any packages or parameters specified at
the target level, cascade down to all dependencies.</p>
<p>Targets are also packages, and are stored in the <code>targets/</code> directory at the base
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/modules/fs/fs/fs_unlink/index.html
----------------------------------------------------------------------
diff --git a/os/modules/fs/fs/fs_unlink/index.html b/os/modules/fs/fs/fs_unlink/index.html
index 2dc0b0d..76c98c6 100644
--- a/os/modules/fs/fs/fs_unlink/index.html
+++ b/os/modules/fs/fs/fs_unlink/index.html
@@ -672,7 +672,7 @@
</pre></div>
-<p>Unlinks the file or directory at the specified path. This is the function to use if you want to delete a file or directory from the disk. If the path refers to a directory, all the directory's descendants are recursively unlinked. Any open file handles refering to an unlinked file remain valid, and can be read from and written to as long as they remain open.</p>
+<p>Unlinks the file or directory at the specified path. This is the function to use if you want to delete a file or directory from the disk. If the path refers to a directory, all the directory's descendants are recursively unlinked. Any open file handles referring to an unlinked file remain valid, and can be read from and written to as long as they remain open.</p>
<h4 id="arguments">Arguments</h4>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/modules/fs/nffs/nffs_internals/index.html
----------------------------------------------------------------------
diff --git a/os/modules/fs/nffs/nffs_internals/index.html b/os/modules/fs/nffs/nffs_internals/index.html
index 7c4b7dd..a97a146 100644
--- a/os/modules/fs/nffs/nffs_internals/index.html
+++ b/os/modules/fs/nffs/nffs_internals/index.html
@@ -742,7 +742,7 @@ follows:</p>
<li>Verify the object's integrity via a crc16 check. If invalid, the object is discarded and the procedure restarts on the next object in the area.</li>
<li>Convert the disk object into its corresponding RAM representation and insert it into the hash table. If the object is an inode, its reference count is initialized to 1, indicating ownership by its parent directory.</li>
<li>If an object with the same ID is already present, then one supersedes the other. Accept the object with the greater sequence number and discard the other.</li>
-<li>If the object references a nonexistant inode (parent directory in the case of an inode; owning file in the case of a data block), insert a temporary "dummy" inode into the hash table so that inter-object links can be maintained until the absent inode is eventually restored. Dummy inodes are identified by a reference count of 0.</li>
+<li>If the object references a nonexistent inode (parent directory in the case of an inode; owning file in the case of a data block), insert a temporary "dummy" inode into the hash table so that inter-object links can be maintained until the absent inode is eventually restored. Dummy inodes are identified by a reference count of 0.</li>
<li>If a delete record for an inode is encountered, the inode's parent pointer is set to null to indicate that it should be removed from RAM.</li>
</ol>
<p>If nffs encounters an object that cannot be identified (i.e., its magic number is not valid), it scans the remainder of the flash area for the next valid magic number. Upon encountering a valid object, nffs resumes the procedure described above.</p>
@@ -812,7 +812,7 @@ follows:</p>
</ol>
<p>Appended data can only be written to the end of the file. That is, "holes" are not supported.</p>
<h1 id="garbage-collection">Garbage collection</h1>
-<p>When the file system is too full to accomodate a write operation, the system must perform garbage collection to make room. The garbage collection procedure is described below:</p>
+<p>When the file system is too full to accommodate a write operation, the system must perform garbage collection to make room. The garbage collection procedure is described below:</p>
<ul>
<li>The non-scratch area with the lowest garbage collection sequence number is selected as the "source area." If there are other areas with the same sequence number, the one with the smallest flash offset is selected. </li>
<li>The source area's ID is written to the scratch area's header, transforming it into a non-scratch ID. This former scratch area is now known as the "destination area."</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/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
index 7d9f027..1c3eeb7 100644
--- a/os/modules/hal/hal_i2c/hal_i2c/index.html
+++ b/os/modules/hal/hal_i2c/hal_i2c/index.html
@@ -671,7 +671,7 @@ in the data structure and ensure that address is a value between 0-127.</p>
</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
+<code>0b1000110</code>, which 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>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/modules/imgmgr/imgr_ver_str/index.html
----------------------------------------------------------------------
diff --git a/os/modules/imgmgr/imgr_ver_str/index.html b/os/modules/imgmgr/imgr_ver_str/index.html
index b22a2c6..22115a1 100644
--- a/os/modules/imgmgr/imgr_ver_str/index.html
+++ b/os/modules/imgmgr/imgr_ver_str/index.html
@@ -498,7 +498,7 @@
</pre></div>
-<p>Takes the version string from <code>ver</code> and formats that into a printable string to <code>dst</code>. Caller must make sure that <code>dst</code> contains enough space to hold maximum lenght version string. The convenience defininition for max length version string is named <code>IMGMGR_MAX_VER_STR</code>.</p>
+<p>Takes the version string from <code>ver</code> and formats that into a printable string to <code>dst</code>. Caller must make sure that <code>dst</code> contains enough space to hold maximum length version string. The convenience defininition for max length version string is named <code>IMGMGR_MAX_VER_STR</code>.</p>
<h4 id="arguments">Arguments</h4>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/os_user_guide/index.html
----------------------------------------------------------------------
diff --git a/os/os_user_guide/index.html b/os/os_user_guide/index.html
index 9673a1a..3edd2ea 100644
--- a/os/os_user_guide/index.html
+++ b/os/os_user_guide/index.html
@@ -458,9 +458,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../tutorials/ibeacon/>
+ <a href=../tutorials/blehci_project/>
<span class="fa fa-arrow-left"></span>
- Previous: BLE iBeacon
+ Previous: BLE HCI interface
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/tutorials/STM32F303/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/STM32F303/index.html b/os/tutorials/STM32F303/index.html
index 40f9fb2..e1ee975 100644
--- a/os/tutorials/STM32F303/index.html
+++ b/os/tutorials/STM32F303/index.html
@@ -244,8 +244,11 @@
- <li >
- <a href="../add_repos/">Add repo to project</a>
+
+
+ <li ><a href="../repo/add_repos/">Work with repositories</a>
+
+
</li>
@@ -253,7 +256,7 @@
<li >
- <a href="../create_repo/">Create a repo</a>
+ <a href="../unit_test/">Write a Test Suite for a Package</a>
</li>
@@ -261,7 +264,7 @@
<li >
- <a href="../upgrade_repo/">Upgrade a repo</a>
+ <a href="../air_quality_sensor/">Air-quality Sensor project</a>
</li>
@@ -269,7 +272,7 @@
<li >
- <a href="../bletiny_project/">Use BLE app to check stats via console</a>
+ <a href="../event_queue/">Add task to manage multiple events</a>
</li>
@@ -293,15 +296,18 @@
<li >
- <a href="../unit_test/">Write a Test Suite for a Package</a>
+ <a href="../bletiny_project/">BLE app to check stats via console</a>
</li>
- <li >
- <a href="../air_quality_sensor/">Air-quality Sensor project</a>
+
+
+ <li ><a href="../bleprph/bleprph-intro/">BLE peripheral project</a>
+
+
</li>
@@ -309,18 +315,7 @@
<li >
- <a href="../event_queue/">Add task to manage multiple events</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../bleprph/bleprph-intro/">BLE peripheral project</a>
-
-
+ <a href="../ibeacon/">BLE iBeacon</a>
</li>
@@ -328,7 +323,7 @@
<li >
- <a href="../ibeacon/">BLE iBeacon</a>
+ <a href="../blehci_project/">BLE HCI interface</a>
</li>
@@ -577,7 +572,7 @@ App successfully built: ~/dev/myproj/bin/stmf3_boot/apps/boot/boot.elf
the <code>newt create-image</code> command to perform this action. Here we assign this
image an arbitrary version <code>1.2.3</code>.</p>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt create-image stmf3_blinky 1.2.3
-App image succesfully generated: ~/dev/myproj/bin/stmf3_blinky/apps/blinky/blinky.img
+App image successfully generated: ~/dev/myproj/bin/stmf3_blinky/apps/blinky/blinky.img
Build manifest:~/dev/myproj/bin/stmf3_blinky/apps/blinky/manifest.json
</pre></div>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/tutorials/add_repos/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/add_repos/index.html b/os/tutorials/add_repos/index.html
deleted file mode 100644
index 446f931..0000000
--- a/os/tutorials/add_repos/index.html
+++ /dev/null
@@ -1,711 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta http-equiv="X-UA-Compatible" content="IE=edge">
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
-
-
- <link rel="canonical" href="http://mynewt.apache.org/os/tutorials/add_repos/">
- <link rel="shortcut icon" href="../../../img/favicon.ico">
-
- <title>Add repo to project - 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="../../../css/v2.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', 'auto');
- ga('send', 'pageview');
- </script>
-
- </head>
-
-
- <body class="Add repo to project">
-
-
-
-
-
-
-
-
-
-<nav id="navbar" class="navbar navbar-inverse navbar-fixed-top" role="navigation">
- <div class="container">
- <!-- Collapsed navigation -->
- <div class="navbar-header">
- <!-- Expander button -->
- <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
- <span class="sr-only">Toggle navigation</span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- </button>
-
- </div>
-
- <!-- Expanded navigation -->
- <div class="navbar-collapse collapse">
- <!-- Main navigation -->
- <ul class="nav navbar-nav navbar-right">
- <li
- class=""
->
- <a href="/">Home</a>
- </li>
- <li
- class="important"
->
- <a href="/quick-start/">Quick Start</a>
- </li>
- <li
- class=""
->
- <a href="/about/">About</a>
- </li>
- <li
- class="active"
->
- <a href="/os/introduction/">Documentation</a>
- </li>
- <li
- class=""
->
- <a href="/download/">Download</a>
- </li>
- <li
- class=""
->
- <a href="/community/">Community</a>
- </li>
- <li
- class=""
->
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
-</nav>
-
-
-
- <div class="container">
-
- <div class="row">
- <div class="col-md-3 v2-sidebar"><div id="docSidebar" class="hidden-print" role="complementary">
- <div class="top">
- <img class="hidden-xs hidden-sm logo-small" src="/img/logo.svg" alt="MyNewt" title="MyNewt">
- <div role="search">
- <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
- <div class="form-group">
- <input type="text" name="q" class="form-control" placeholder="Search documentation" />
- </div>
- </form>
- </div>
- </div>
- <ul class="toc-nav">
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- <li ><a href="../../introduction/">Mynewt Documentation</a>
-
-
- <ul>
-
-
-
-
-
-
-
- <li ><a href="../../get_started/get_started/">Basic Setup</a>
-
-
- </li>
-
-
-
-
-
- <li >
- <a href="../../get_started/vocabulary/">Concepts</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../tutorials/">Tutorials</a>
-
-
- <ul>
-
-
-
-
-
-
-
- <li><a href="
- ../arduino_zero/
-">Project Blinky</a>
-
-
- </li>
-
-
-
-
-
- <li class="active">
- <a href="./">Add repo to project</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../create_repo/">Create a repo</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../upgrade_repo/">Upgrade a repo</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../bletiny_project/">Use BLE app to check stats via console</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../project-slinky/">Enable remote comms on sim device</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../project-target-slinky/">Enable remote comms on STM32 board</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../unit_test/">Write a Test Suite for a Package</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../air_quality_sensor/">Air-quality Sensor project</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../event_queue/">Add task to manage multiple events</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../bleprph/bleprph-intro/">BLE peripheral project</a>
-
-
- </li>
-
-
-
-
-
- <li >
- <a href="../ibeacon/">BLE iBeacon</a>
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../os_user_guide/">OS User Guide</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li><a href="
- ../../../network/ble/ble_intro/
-">BLE User Guide</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../newt/newt_intro/">Newt Tool Guide</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../newtmgr/overview/">Newt Manager Guide</a>
-
-
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
-
-
-
-
- <li><a href="
- ../../../faq/how_to_edit_docs/
-">Appendix</a>
-
-
- </li>
-
-
-
- </ul>
-</div></div>
-
- <div class="show-sidebar-container">
- <button class="show-sidebar">Docs Menu</button>
- </div>
-
- <div class="col-md-9" role="main">
- <div class="row doc-header">
- <div class="col-sm-12">
- <div role="navigation" aria-label="breadcrumbs navigation">
- <ul class="wy-breadcrumbs pull-right">
- <li><a href="/documentation/">Docs</a></li>
-
-
-
- <li>» <a href="../../introduction/">Mynewt Documentation</a></li>
-
-
-
- <li>» <a href="../tutorials/">Tutorials</a></li>
-
-
-
- <li>» Add repo to project</li>
-
-
-
- </ul>
-</div>
- </div>
- </div>
-
- <h2 id="adding-repositories-to-your-project">Adding Repositories to your Project</h2>
-<h3 id="what-is-a-repository">What is a Repository</h3>
-<p>A repository is a version-ed Mynewt project, which is a collection of Mynewt packages organized in a specific way for redistribution. </p>
-<p>What differentiates a repository from a Mynewt project is the presence of a
-<code>repository.yml</code> file describing the repository. This will be described
-below. For a basic understanding of repositories you may read the <a href="../../../newt/newt_intro/">Newt Tool Manual</a> and <a href="../create_repo/">How to create repos</a>.</p>
-<p><strong>Note:</strong> For the remainder of this document we'll use the term repo as shorthand for a Mynewt repository.</p>
-<p>Repos are useful because they are an organized way for the community to share Mynewt packages and projects. In fact, the Mynewt-core is distributed as a repo.</p>
-<p><br></p>
-<h3 id="why-does-mynewt-need-additional-repos">Why does Mynewt need additional repos?</h3>
-<p>Repos add functionality not included in the Mynewt core. New repos might be created for several reasons.</p>
-<ul>
-<li><strong>Expertise</strong>. Individuals or organizations may have expertise that they want
-to share in the form of repos. For example a chip vendor may
-create a repo to hold the Mynewt support for their chips.</li>
-<li><strong>Non-Core component</strong>. Some components, although very useful to Mynewt users
-are not core to all Mynewt users. These are likely candidates to be held in
-different repos.</li>
-<li><strong>Software licensing</strong>. Some software have licenses that make them incompatible
-with the ASF (Apache Software Foundation) license policies. These may be
-valuable components to some Mynewt users, but cannot be contained in the <code>apache-Mynewt-core</code>.</li>
-</ul>
-<p><br></p>
-<h3 id="what-repos-are-in-my-project">What Repos are in my Project</h3>
-<p>The list of repos used by your project are contained within the
-<code>project.yml</code> file. An example can be seen by creating a new project:</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ mkdir ~/dev
-$ cd ~/dev
-$ newt new myproj
-$ cd myproj
-</pre></div>
-
-
-<p><br></p>
-<p>View the <code>project.yml</code> section and you will see a line describing the repos:</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">project.repositories:
- - apache-Mynewt-core
-</pre></div>
-
-
-<p><br> </p>
-<p>By default, this newly created project uses a single repo called
-<code>apache-Mynewt-core</code>. </p>
-<p>If you wish to add additional repos, you would add
-additional lines to the <code>project.repositories</code> variable like this.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">project.repositories:
- - apache-Mynewt-core
-<span style="background-color: #ffffcc"> - another_repo_named_x
-</span></pre></div>
-
-
-<p><br></p>
-<h3 id="repo-descriptors">Repo Descriptors</h3>
-<p>In addition to the repo name, the <code>project.yml</code> file must also contain
-a repo descriptor for each repository you include that gives <code>newt</code>
-information on obtaining the repo.</p>
-<p>In the same <code>myproj</code> above you will see the following repo descriptor.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">repository.apache-Mynewt-core:
- type: github
- vers: 0-latest
- user: apache
- repo: incubator-mynewt-core
-</pre></div>
-
-
-<p>A repo descriptor starts with <code>repository.<name>.</code>. In this example, the
-descriptor specifies the information for the <code>apache-Mynewt-core</code>.</p>
-<p><br></p>
-<p>The fields within the descriptor have the following definitions:</p>
-<ul>
-<li>
-<p><strong>type</strong> -- The type of code storage the repo uses. The current version
-of <code>newt</code> only supports github. Future versions may support generic git or other
-code storage mechanisms.</p>
-</li>
-<li>
-<p><strong>vers</strong> -- The version of the repo to use for your project. A source
-code repository contains many versions of the source. This field is used to
-specify the one to use for this project. See the section on versions below
-for a detailed description of the format of this field.</p>
-</li>
-<li>
-<p><strong>user</strong> -- The username for the repo. On github, this is the name
-after <code>github.com</code> in the repo path. Consider the repository
-<code>https://github.com/apache/incubator-mynewt-core</code>. It has username <code>apache</code>. </p>
-</li>
-<li>
-<p><strong>repo</strong> -- The name of the repo. On github, this is the name after
-the username described above. Consider the repository
-<code>https://github.com/apache/incubator-mynewt-core</code>. It has username
-<code>incubator-mynewt-core</code>. This is a path to the source control
-and should not be confused with the name of the repo that you used in the
-<code>repository.<name></code> declaration above. That name is contained elsewhere
-within the repo. See Below.</p>
-</li>
-</ul>
-<p><br></p>
-<h3 id="adding-existing-repos-to-my-project">Adding Existing Repos to my Project</h3>
-<p>To add a new repo to your project, you have to complete two steps.</p>
-<ul>
-<li>
-<p>Edit the <code>project.yml</code> file and add a new repo descriptor. The previous
-section includes information on the field required in your repo descriptor.</p>
-</li>
-<li>
-<p>Edit the <code>project/yml</code> file and add a new line to the <code>project.repositories</code>
-variable with the name of the repo you are adding. </p>
-</li>
-</ul>
-<p>An example of a <code>project.yml</code> file with two repositories is shown below:</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">project.name: "my_project"
-
-project.repositories:
- - apache-Mynewt-core
- - Mynewt_arduino_zero
-
-# Use github's distribution mechanism for core ASF libraries.
-# This provides mirroring automatically for us.
-#
-repository.apache-Mynewt-core:
- type: github
- vers: 0-latest
- user: apache
- repo: incubator-mynewt-core
-
-# a special repo to hold hardware specific stuff for arduino zero
-repository.Mynewt_arduino_zero:
- type: github
- vers: 0-latest
- user: runtimeinc
- repo: Mynewt_arduino_zero
-</pre></div>
-
-
-<p><br></p>
-<h3 id="what-version-of-the-repo-to-use">What Version of the Repo to use</h3>
-<p>Mynewt repos are version-ed artifacts. They are stored in source control
-systems like github. The repo descriptor in your <code>project.yml</code> file must
-specify the version of the repo you will accept into your project.</p>
-<p>For now, we are at the beginnings of Mynewt. For testing and evaluation
-please use <code>0-latest</code> in the <code>vers</code> field in your repo descriptor.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"> vers:0-latest
-</pre></div>
-
-
-<p>See <a href="../create_repo">Create a Repo</a> for a description of the versioning system and all the possible ways to specify a version to use.</p>
-<p><br></p>
-<h3 id="identifying-a-repo">Identifying a Repo</h3>
-<p>A repo contains Mynewt packages organized in a specific way and stored in one of the supported code storage methods described above. In other words, it is a Mynewt project with an additional file <code>repository.yml</code> which describes the repo for use by <code>newt</code> (and humans browsing them). It contains a mapping of version numbers to the actual github branches containing the source code.</p>
-<p>Note that the <code>repository.yml</code> file lives only in the master branch of the git
-repository. <code>Newt</code> will always fetch this file from the master branch and then
-use that to determine the actual branch required depending on the version
-specified in your <code>project.yml</code> file. Special care should be taken to ensure that this file exists only in the master branch.</p>
-<p>Here is the <code>repository.yml</code> file from the apache-Mynewt-core:</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">repo.name: apache-mynewt-core
-repo.versions:
- "0.7.9": "Mynewt_0_8_0_b2_tag"
- "0-latest": "0.7.9"
- "0.8-latest": "0.7.9"
-</pre></div>
-
-
-<p><br></p>
-<p>It contains the following:</p>
-<ul>
-<li><strong>repo.name</strong> The external name that is used to include the library in
-your <code>project.yml</code> file. This is the name you in include in the <code>project.repositories</code> variable when adding this repository to your project.</li>
-<li><strong>repo.versions</strong> A description of what versions to give the user depending
-on the settings in their <code>project.yml</code> file. </li>
-</ul>
-<p><br></p>
-<h3 id="repo-version">Repo Version</h3>
-<p>The repo version number resolves to an actual git branch depending on the mapping specified in <code>repository.yml</code> for that repo. The version field argument in your <code>project.yml</code> file supports multiple formats for flexibility:</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><major_num>.<minor_num>.<revision_num>
-</pre></div>
-
-
-<p>or</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><major_num>.<minor_num>-<stability string>
-</pre></div>
-
-
-<p>or </p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><major_num>-<stability string>
-</pre></div>
-
-
-<p><br></p>
-<p>The stability string can be one of 3 pre-defined stability values.</p>
-<ol>
-<li>stable -- A stable release version of the repository</li>
-<li>dev -- A development version from the repository</li>
-<li>latest -- The latest from the repository</li>
-</ol>
-<p>In your <code>project.yml</code> file you can specify different combinations of
-the version number and stability value. For example:</p>
-<ul>
-<li><code>0-latest</code> -- The latest version with major number 0</li>
-<li><code>1.2-stable</code> -- The latest stable version with major and minor number 1.2</li>
-<li><code>1.2-dev</code> -- The development version from 1.2</li>
-<li><code>1.1.1</code> -- a specific version 1.1.1</li>
-</ul>
-<p>You cannot specify a stability string with a fully numbered version, e.g.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">1.2.8-stable
-</pre></div>
-
-
-<p><br></p>
-<h3 id="repo-versions-available">Repo Versions Available</h3>
-<p>A <code>repository.yml</code> file contains information to match a version request
-into a git branch to fetch for your project.</p>
-<p>It's up to the repository maintainer to map these to branches of the
-repository. For example, let's say in a fictitious repository the following are
-defined.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">repo.versions:
- "0.8.0": "xxx_branch_0_8_0"
- "1.0.0": "xxx_branch_1_0_0"
- "1.0.2": "xxx_branch_1_0_2"
- "1.1.1": "xxx_branch_1_1_0"
- "1.1.2": "xxx_branch_1_1_2"
- "1.2.0": "xxx_branch_1_2_0"
- "1.2.1": "xxx_branch_1_2_1"
- "1.2-dev": "1.2.1"
- "1-dev": "1.2-dev"
- "1.2-stable": "1.2.0"
- "0-latest": "0.8.0"
- "1-latest": "1-dev"
- ....
-</pre></div>
-
-
-<p>When the <code>project.yml</code> file asks for <code>1.2-stable</code> it is resolved to version
-<code>1.2.0</code> (perhaps <code>1.2.1</code> is not stable yet), which in turn resolves to a specific
-branch <code>xxx_branch_1_2_0</code>. This is the branch that <code>newt</code> fetches into
-your project. </p>
-<p><strong>Note:</strong> Make sure a repo version exists in the <code>repository.yml</code> file of a repo you wish to add. Otherwise Newt will not be able to resolve the version and will fail to fetch the repo into your project.</p>
-<p><br></p>
-<h3 id="how-to-find-out-what-repos-are-available-for-mynewt-components">How to find out what Repos are available for Mynewt components</h3>
-<p>Currently, there is no <code>newt</code> command to locate/search Mynewt package
-repositories. However, since the <code>newt</code> tool supports only github,
-searching github by keyword is a satisfactory option until a search
-tool is created.</p>
-<p>When searching github, recall that a Mynewt repository must
-have a <code>repository.yml</code> file in its root directory. If you don't see
-that file, it's not a Mynewt repository and can't be included in your
-project via the newt tool. </p>
-<p>Once you find a repository, the github URL and <code>repository.yml</code> file
-should give you all the information to add it to your <code>project.yml</code> file.</p>
-<p><br></p>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../blinky_sram_olimex/>
- <span class="fa fa-arrow-left"></span>
- Previous: Run Blinky from SRAM, no bootloader
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../create_repo/>
- Next: Create a repo
- <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/22b7d022/os/tutorials/air_quality_sensor/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/air_quality_sensor/index.html b/os/tutorials/air_quality_sensor/index.html
index 8e228ec..d32f94d 100644
--- a/os/tutorials/air_quality_sensor/index.html
+++ b/os/tutorials/air_quality_sensor/index.html
@@ -200,8 +200,11 @@
- <li >
- <a href="../add_repos/">Add repo to project</a>
+
+
+ <li ><a href="../repo/add_repos/">Work with repositories</a>
+
+
</li>
@@ -209,15 +212,15 @@
<li >
- <a href="../create_repo/">Create a repo</a>
+ <a href="../unit_test/">Write a Test Suite for a Package</a>
</li>
- <li >
- <a href="../upgrade_repo/">Upgrade a repo</a>
+ <li class="active">
+ <a href="./">Air-quality Sensor project</a>
</li>
@@ -225,7 +228,7 @@
<li >
- <a href="../bletiny_project/">Use BLE app to check stats via console</a>
+ <a href="../event_queue/">Add task to manage multiple events</a>
</li>
@@ -249,15 +252,18 @@
<li >
- <a href="../unit_test/">Write a Test Suite for a Package</a>
+ <a href="../bletiny_project/">BLE app to check stats via console</a>
</li>
- <li class="active">
- <a href="./">Air-quality Sensor project</a>
+
+
+ <li ><a href="../bleprph/bleprph-intro/">BLE peripheral project</a>
+
+
</li>
@@ -265,18 +271,7 @@
<li >
- <a href="../event_queue/">Add task to manage multiple events</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../bleprph/bleprph-intro/">BLE peripheral project</a>
-
-
+ <a href="../ibeacon/">BLE iBeacon</a>
</li>
@@ -284,7 +279,7 @@
<li >
- <a href="../ibeacon/">BLE iBeacon</a>
+ <a href="../blehci_project/">BLE HCI interface</a>
</li>
@@ -516,7 +511,7 @@ exit status 1
<p>Ah. Forgot to create an image out of the blinky binary. Note that every time you want to build and load a new firmware image to target board, you need to run 'create-image' on it.</p>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">[user@IsMyLaptop:~/src/air_quality]$ newt create-image blink_f3 0.0.1
-App image succesfully generated: /Users/user/src/air_quality/bin/blink_f3/apps/blinky/blinky.img
+App image successfully generated: /Users/user/src/air_quality/bin/blink_f3/apps/blinky/blinky.img
Build manifest: /Users/user/src/air_quality/bin/blink_f3/apps/blinky/manifest.json
[user@IsMyLaptop:~/src/air_quality]$ newt load blink_f3 0.0.1
</pre></div>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/tutorials/arduino_zero/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/arduino_zero/index.html b/os/tutorials/arduino_zero/index.html
index f7906d8..e98adc3 100644
--- a/os/tutorials/arduino_zero/index.html
+++ b/os/tutorials/arduino_zero/index.html
@@ -244,8 +244,11 @@
- <li >
- <a href="../add_repos/">Add repo to project</a>
+
+
+ <li ><a href="../repo/add_repos/">Work with repositories</a>
+
+
</li>
@@ -253,7 +256,7 @@
<li >
- <a href="../create_repo/">Create a repo</a>
+ <a href="../unit_test/">Write a Test Suite for a Package</a>
</li>
@@ -261,7 +264,7 @@
<li >
- <a href="../upgrade_repo/">Upgrade a repo</a>
+ <a href="../air_quality_sensor/">Air-quality Sensor project</a>
</li>
@@ -269,7 +272,7 @@
<li >
- <a href="../bletiny_project/">Use BLE app to check stats via console</a>
+ <a href="../event_queue/">Add task to manage multiple events</a>
</li>
@@ -293,15 +296,18 @@
<li >
- <a href="../unit_test/">Write a Test Suite for a Package</a>
+ <a href="../bletiny_project/">BLE app to check stats via console</a>
</li>
- <li >
- <a href="../air_quality_sensor/">Air-quality Sensor project</a>
+
+
+ <li ><a href="../bleprph/bleprph-intro/">BLE peripheral project</a>
+
+
</li>
@@ -309,18 +315,7 @@
<li >
- <a href="../event_queue/">Add task to manage multiple events</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../bleprph/bleprph-intro/">BLE peripheral project</a>
-
-
+ <a href="../ibeacon/">BLE iBeacon</a>
</li>
@@ -328,7 +323,7 @@
<li >
- <a href="../ibeacon/">BLE iBeacon</a>
+ <a href="../blehci_project/">BLE HCI interface</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/tutorials/blehci_project/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/blehci_project/index.html b/os/tutorials/blehci_project/index.html
new file mode 100644
index 0000000..105bba7
--- /dev/null
+++ b/os/tutorials/blehci_project/index.html
@@ -0,0 +1,608 @@
+<!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/tutorials/blehci_project/">
+ <link rel="shortcut icon" href="../../../img/favicon.ico">
+
+ <title>BLE HCI interface - 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="../../../css/v2.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', 'auto');
+ ga('send', 'pageview');
+ </script>
+
+ </head>
+
+
+ <body class="BLE HCI interface">
+
+
+
+
+
+
+
+
+
+<nav id="navbar" class="navbar navbar-inverse navbar-fixed-top" role="navigation">
+ <div class="container">
+ <!-- Collapsed navigation -->
+ <div class="navbar-header">
+ <!-- Expander button -->
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+
+ </div>
+
+ <!-- Expanded navigation -->
+ <div class="navbar-collapse collapse">
+ <!-- Main navigation -->
+ <ul class="nav navbar-nav navbar-right">
+ <li
+ class=""
+>
+ <a href="/">Home</a>
+ </li>
+ <li
+ class="important"
+>
+ <a href="/quick-start/">Quick Start</a>
+ </li>
+ <li
+ class=""
+>
+ <a href="/about/">About</a>
+ </li>
+ <li
+ class="active"
+>
+ <a href="/os/introduction/">Documentation</a>
+ </li>
+ <li
+ class=""
+>
+ <a href="/download/">Download</a>
+ </li>
+ <li
+ class=""
+>
+ <a href="/community/">Community</a>
+ </li>
+ <li
+ class=""
+>
+ <a href="/events/">Events</a>
+ </li>
+ </ul>
+
+ <!-- Search, Navigation and Repo links -->
+ <ul class="nav navbar-nav navbar-right">
+
+ </ul>
+ </div>
+ </div>
+</nav>
+
+
+
+ <div class="container">
+
+ <div class="row">
+ <div class="col-md-3 v2-sidebar"><div id="docSidebar" class="hidden-print" role="complementary">
+ <div class="top">
+ <img class="hidden-xs hidden-sm logo-small" src="/img/logo.svg" alt="MyNewt" title="MyNewt">
+ <div role="search">
+ <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+ <div class="form-group">
+ <input type="text" name="q" class="form-control" placeholder="Search documentation" />
+ </div>
+ </form>
+ </div>
+ </div>
+ <ul class="toc-nav">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li ><a href="../../introduction/">Mynewt Documentation</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li ><a href="../../get_started/get_started/">Basic Setup</a>
+
+
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../../get_started/vocabulary/">Concepts</a>
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../tutorials/">Tutorials</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="
+ ../arduino_zero/
+">Project Blinky</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../repo/add_repos/">Work with repositories</a>
+
+
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../unit_test/">Write a Test Suite for a Package</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../air_quality_sensor/">Air-quality Sensor project</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../event_queue/">Add task to manage multiple events</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../project-slinky/">Enable remote comms on sim device</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../project-target-slinky/">Enable remote comms on STM32 board</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../bletiny_project/">BLE app to check stats via console</a>
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../bleprph/bleprph-intro/">BLE peripheral project</a>
+
+
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ibeacon/">BLE iBeacon</a>
+ </li>
+
+
+
+
+
+ <li class="active">
+ <a href="./">BLE HCI interface</a>
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../os_user_guide/">OS User Guide</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../network/ble/ble_intro/
+">BLE User Guide</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../newt/newt_intro/">Newt Tool Guide</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../newtmgr/overview/">Newt Manager Guide</a>
+
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../faq/how_to_edit_docs/
+">Appendix</a>
+
+
+ </li>
+
+
+
+ </ul>
+</div></div>
+
+ <div class="show-sidebar-container">
+ <button class="show-sidebar">Docs Menu</button>
+ </div>
+
+ <div class="col-md-9" role="main">
+ <div class="row doc-header">
+ <div class="col-sm-12">
+ <div role="navigation" aria-label="breadcrumbs navigation">
+ <ul class="wy-breadcrumbs pull-right">
+ <li><a href="/documentation/">Docs</a></li>
+
+
+
+ <li>» <a href="../../introduction/">Mynewt Documentation</a></li>
+
+
+
+ <li>» <a href="../tutorials/">Tutorials</a></li>
+
+
+
+ <li>» BLE HCI interface</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h2 id="use-hci-access-to-nimble-controller">Use HCI access to NimBLE controller</h2>
+<p><br></p>
+<p>This tutorial explains how to use the example application <code>blehci</code> included in the NimBLE stack to talk to the Mynewt NimBLE controller via the Host Controller Interface. You may build the Mynewt image using a laptop running any OS of your choice - Mac, Linux, or Windows.</p>
+<p>The host used in this specific example is the BlueZ Bluetooth stack. Since BlueZ is a Bluetooth stack for Linux kernel-based family of operating system, the tutorial expects a computer running Linux OS and with BlueZ installed to talk to the board with the Mynewt image.</p>
+<p><br></p>
+<h3 id="pre-requisites">Pre-Requisites</h3>
+<ul>
+<li>Ensure you have installed <a href="../../../newt/install/newt_mac/">newt</a> and that the
+newt command is in your system path. </li>
+<li>You must have Internet connectivity to fetch remote Mynewt components.</li>
+<li>If you are not using the Docker container for newt and other tools, you must <a href="../../get_started/native_tools/">install the compiler tools</a> to
+support native compiling to build the project this tutorial creates. </li>
+<li>You have a board with BLE radio that is supported by Mynewt. We will use an nRF52 Dev board in this tutorial.</li>
+<li>USB TTL Serial Cable that supports hardware flow control such as ones found at <a href="http://www.ftdichip.com/Products/Cables/USBTTLSerial.htm">http://www.ftdichip.com/Products/Cables/USBTTLSerial.htm</a> to establish a serial USB connection between the board and the laptop.</li>
+<li>You have installed a BLE host such as BlueZ on a Linux machine to talk to the nrf52 board running Mynewt. Use <code>sudo apt-get install bluez</code> to install it on your Linux machine. </li>
+</ul>
+<p><br></p>
+<h3 id="create-a-project">Create a project</h3>
+<p>Use the Newt tool to create a new project directory containing a skeletal Mynewt framework. Change into the newly created directory. Make sure the downloaded version is 0.9.0 or later.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt new blehciproj
+Downloading project skeleton from apache/incubator-mynewt-blinky...
+Installing skeleton in blehciproj ...
+Project blehciproj successfully created.
+$ cd mblehciproj
+
+$ newt install -v
+apache-mynewt-core
+Downloading repository description for apache-mynewt-core... success!
+...
+apache-mynewt-core successfully installed version 0.9.0-none
+</pre></div>
+
+
+<p><br></p>
+<h3 id="create-targets">Create targets</h3>
+<p>You will create two targets - one for the bootloader, the other for the application. Then you will add the definitions for them. Note that you are using the example app <code>blehci</code> for the application target. Set the bsp correctly (nrf52pdk or nrf52dk depending on whether the board is the preview kit or the dev kit, respectively).</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt target create nrf52_boot
+$ newt target set nrf52_boot app=@apache-mynewt-core/apps/boot
+$ newt target set nrf52_boot bsp=@apache-mynewt-core/hw/bsp/nrf52dk
+$ newt target set nrf52_boot build_profile=optimized
+</pre></div>
+
+
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt target create myble2
+$ newt target set myble2 bsp=@apache-mynewt-core/hw/bsp/nrf52dk
+$ newt target set myble2 app=@apache-mynewt-core/apps/blehci
+$ newt target set myble2 build_profile=optimized
+</pre></div>
+
+
+<p><br></p>
+<p>Check that the targets are defined correctly.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt target show
+ targets/my_blinky_sim
+ app=apps/blinky
+ bsp=@apache-mynewt-core/hw/bsp/native
+ build_profile=debug
+ targets/myble2
+ app=@apache-mynewt-core/apps/blehci
+ bsp=@apache-mynewt-core/hw/bsp/nrf52dk
+ build_profile=optimized
+ targets/nrf52_boot
+ app=@apache-mynewt-core/apps/boot
+ bsp=@apache-mynewt-core/hw/bsp/nrf52dk
+ build_profile=optimized
+</pre></div>
+
+
+<p><br></p>
+<h3 id="build-targets">Build targets</h3>
+<p>Then build the two targets.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt build nrf52_boot
+<snip>
+App successfully built: ./bin/nrf52_boot/apps/boot/boot.elf
+$ newt build myble2
+Compiling hci_common.c
+Compiling util.c
+Archiving nimble.a
+Compiling os.c
+<snip>
+</pre></div>
+
+
+<p><br></p>
+<h3 id="create-the-app-image">Create the app image</h3>
+<p>Generate a signed application image for the <code>myble2</code> target. The version number is arbitrary.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt create-image myble2 1.0.0
+App image succesfully generated: ./bin/makerbeacon/apps/bletiny/bletiny.img
+Build manifest: ./bin/makerbeacon/apps/bletiny/manifest.json
+</pre></div>
+
+
+<p><br></p>
+<h3 id="load-the-image">Load the image</h3>
+<p>Make sure the USB connector is in place and the power LED on the board is lit. Use the Power ON/OFF switch to reset the board after loading the image.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt -v load myble
+</pre></div>
+
+
+<p><br></p>
+<h3 id="establish-serial-connection">Establish serial connection</h3>
+<p>Attach a serial port to your board by connecting the USB TTL Serial Cable. This should create /dev/ttyUSB0 (or similar) on your machine. </p>
+<p><strong>Note</strong> Certain Linux OS versions have been observed to detect the nrf52 board as a mass storage device and the console access doesn\u2019t work properly. In that case try powering the nrf52 board from your monitor or something other than your Linux computer/laptop when you set up the serial port for HCI communication.</p>
+<p><br></p>
+<h3 id="open-bluetooth-monitor-btmon">Open Bluetooth monitor btmon</h3>
+<p><code>btmon</code> is a BlueZ test tool to display all HCI commands and events in a human readable format. Start the btmon tool in a terminal window. </p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ sudo btmon
+[sudo] password for admin:
+Bluetooth monitor ver 5.37
+</pre></div>
+
+
+<p><br></p>
+<h3 id="attach-the-blehci-device-to-bluez">Attach the blehci device to BlueZ</h3>
+<p>In a different terminal, attach the blehci device to the BlueZ daemon (substitute the correct /dev filename for ttyUSB0).</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ sudo btattach -B /dev/ttyUSB0 -S 115200
+Attaching BR/EDR controller to /dev/ttyUSB0
+Switched line discipline from 0 to 15
+Device index 1 attached
+</pre></div>
+
+
+<p><br></p>
+<h3 id="start-btmgmt-to-send-commands">Start btmgmt to send commands</h3>
+<p>In a third terminal, start btmgmt. This tool allows you to send commands to the blehci controller. Use the index number that shows up when you <code>btattach</code> in the previous step.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ sudo btmgmt --index 1
+[sudo] password for admin:
+</pre></div>
+
+
+<p>Set your device address (you can substitute any static random address here).</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">[hci1]# static-addr cc:11:11:11:11:11
+Static address successfully set
+</pre></div>
+
+
+<p>Initialize the controller.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">[hci1]# power on
+hci1 Set Powered complete, settings: powered le static-addr
+</pre></div>
+
+
+<p>Begin scanning.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">[hci1]# find -l
+Discovery started
+hci1 type 6 discovering on
+hci1 dev_found: 58:EF:77:C8:8D:17 type LE Random rssi -78 flags 0x0000
+AD flags 0x06
+eir_len 23
+<snip>
+</pre></div>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../ibeacon/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: BLE iBeacon
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../../os_user_guide/>
+ Next: OS User Guide
+ <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/22b7d022/os/tutorials/bleprph/bleprph-adv/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/bleprph/bleprph-adv/index.html b/os/tutorials/bleprph/bleprph-adv/index.html
index f660271..2aa4512 100644
--- a/os/tutorials/bleprph/bleprph-adv/index.html
+++ b/os/tutorials/bleprph/bleprph-adv/index.html
@@ -200,8 +200,11 @@
- <li >
- <a href="../../add_repos/">Add repo to project</a>
+
+
+ <li ><a href="../../repo/add_repos/">Work with repositories</a>
+
+
</li>
@@ -209,7 +212,7 @@
<li >
- <a href="../../create_repo/">Create a repo</a>
+ <a href="../../unit_test/">Write a Test Suite for a Package</a>
</li>
@@ -217,7 +220,7 @@
<li >
- <a href="../../upgrade_repo/">Upgrade a repo</a>
+ <a href="../../air_quality_sensor/">Air-quality Sensor project</a>
</li>
@@ -225,7 +228,7 @@
<li >
- <a href="../../bletiny_project/">Use BLE app to check stats via console</a>
+ <a href="../../event_queue/">Add task to manage multiple events</a>
</li>
@@ -249,23 +252,7 @@
<li >
- <a href="../../unit_test/">Write a Test Suite for a Package</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../air_quality_sensor/">Air-quality Sensor project</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../event_queue/">Add task to manage multiple events</a>
+ <a href="../../bletiny_project/">BLE app to check stats via console</a>
</li>
@@ -327,6 +314,14 @@
+
+
+ <li >
+ <a href="../../blehci_project/">BLE HCI interface</a>
+ </li>
+
+
+
</ul>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/tutorials/bleprph/bleprph-chr-access/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/bleprph/bleprph-chr-access/index.html b/os/tutorials/bleprph/bleprph-chr-access/index.html
index b375a94..f19ece0 100644
--- a/os/tutorials/bleprph/bleprph-chr-access/index.html
+++ b/os/tutorials/bleprph/bleprph-chr-access/index.html
@@ -200,8 +200,11 @@
- <li >
- <a href="../../add_repos/">Add repo to project</a>
+
+
+ <li ><a href="../../repo/add_repos/">Work with repositories</a>
+
+
</li>
@@ -209,7 +212,7 @@
<li >
- <a href="../../create_repo/">Create a repo</a>
+ <a href="../../unit_test/">Write a Test Suite for a Package</a>
</li>
@@ -217,7 +220,7 @@
<li >
- <a href="../../upgrade_repo/">Upgrade a repo</a>
+ <a href="../../air_quality_sensor/">Air-quality Sensor project</a>
</li>
@@ -225,7 +228,7 @@
<li >
- <a href="../../bletiny_project/">Use BLE app to check stats via console</a>
+ <a href="../../event_queue/">Add task to manage multiple events</a>
</li>
@@ -249,23 +252,7 @@
<li >
- <a href="../../unit_test/">Write a Test Suite for a Package</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../air_quality_sensor/">Air-quality Sensor project</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../event_queue/">Add task to manage multiple events</a>
+ <a href="../../bletiny_project/">BLE app to check stats via console</a>
</li>
@@ -327,6 +314,14 @@
+
+
+ <li >
+ <a href="../../blehci_project/">BLE HCI interface</a>
+ </li>
+
+
+
</ul>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/tutorials/bleprph/bleprph-conn/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/bleprph/bleprph-conn/index.html b/os/tutorials/bleprph/bleprph-conn/index.html
index b19f6ea..a8829dd 100644
--- a/os/tutorials/bleprph/bleprph-conn/index.html
+++ b/os/tutorials/bleprph/bleprph-conn/index.html
@@ -200,8 +200,11 @@
- <li >
- <a href="../../add_repos/">Add repo to project</a>
+
+
+ <li ><a href="../../repo/add_repos/">Work with repositories</a>
+
+
</li>
@@ -209,7 +212,7 @@
<li >
- <a href="../../create_repo/">Create a repo</a>
+ <a href="../../unit_test/">Write a Test Suite for a Package</a>
</li>
@@ -217,7 +220,7 @@
<li >
- <a href="../../upgrade_repo/">Upgrade a repo</a>
+ <a href="../../air_quality_sensor/">Air-quality Sensor project</a>
</li>
@@ -225,7 +228,7 @@
<li >
- <a href="../../bletiny_project/">Use BLE app to check stats via console</a>
+ <a href="../../event_queue/">Add task to manage multiple events</a>
</li>
@@ -249,23 +252,7 @@
<li >
- <a href="../../unit_test/">Write a Test Suite for a Package</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../air_quality_sensor/">Air-quality Sensor project</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../event_queue/">Add task to manage multiple events</a>
+ <a href="../../bletiny_project/">BLE app to check stats via console</a>
</li>
@@ -327,6 +314,14 @@
+
+
+ <li >
+ <a href="../../blehci_project/">BLE HCI interface</a>
+ </li>
+
+
+
</ul>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/tutorials/bleprph/bleprph-intro/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/bleprph/bleprph-intro/index.html b/os/tutorials/bleprph/bleprph-intro/index.html
index 0198c24..6356742 100644
--- a/os/tutorials/bleprph/bleprph-intro/index.html
+++ b/os/tutorials/bleprph/bleprph-intro/index.html
@@ -200,8 +200,11 @@
- <li >
- <a href="../../add_repos/">Add repo to project</a>
+
+
+ <li ><a href="../../repo/add_repos/">Work with repositories</a>
+
+
</li>
@@ -209,7 +212,7 @@
<li >
- <a href="../../create_repo/">Create a repo</a>
+ <a href="../../unit_test/">Write a Test Suite for a Package</a>
</li>
@@ -217,7 +220,7 @@
<li >
- <a href="../../upgrade_repo/">Upgrade a repo</a>
+ <a href="../../air_quality_sensor/">Air-quality Sensor project</a>
</li>
@@ -225,7 +228,7 @@
<li >
- <a href="../../bletiny_project/">Use BLE app to check stats via console</a>
+ <a href="../../event_queue/">Add task to manage multiple events</a>
</li>
@@ -249,23 +252,7 @@
<li >
- <a href="../../unit_test/">Write a Test Suite for a Package</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../air_quality_sensor/">Air-quality Sensor project</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../event_queue/">Add task to manage multiple events</a>
+ <a href="../../bletiny_project/">BLE app to check stats via console</a>
</li>
@@ -327,6 +314,14 @@
+
+
+ <li >
+ <a href="../../blehci_project/">BLE HCI interface</a>
+ </li>
+
+
+
</ul>
</li>
@@ -466,9 +461,9 @@ from the Bluetooth Developer's site before proceeding.</p>
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../event_queue/>
+ <a href=../../bletiny_project/>
<span class="fa fa-arrow-left"></span>
- Previous: Add task to manage multiple events
+ Previous: BLE app to check stats via console
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/tutorials/bleprph/bleprph-svc-reg/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/bleprph/bleprph-svc-reg/index.html b/os/tutorials/bleprph/bleprph-svc-reg/index.html
index 69c52b1..8330fa7 100644
--- a/os/tutorials/bleprph/bleprph-svc-reg/index.html
+++ b/os/tutorials/bleprph/bleprph-svc-reg/index.html
@@ -200,8 +200,11 @@
- <li >
- <a href="../../add_repos/">Add repo to project</a>
+
+
+ <li ><a href="../../repo/add_repos/">Work with repositories</a>
+
+
</li>
@@ -209,7 +212,7 @@
<li >
- <a href="../../create_repo/">Create a repo</a>
+ <a href="../../unit_test/">Write a Test Suite for a Package</a>
</li>
@@ -217,7 +220,7 @@
<li >
- <a href="../../upgrade_repo/">Upgrade a repo</a>
+ <a href="../../air_quality_sensor/">Air-quality Sensor project</a>
</li>
@@ -225,7 +228,7 @@
<li >
- <a href="../../bletiny_project/">Use BLE app to check stats via console</a>
+ <a href="../../event_queue/">Add task to manage multiple events</a>
</li>
@@ -249,23 +252,7 @@
<li >
- <a href="../../unit_test/">Write a Test Suite for a Package</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../air_quality_sensor/">Air-quality Sensor project</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../event_queue/">Add task to manage multiple events</a>
+ <a href="../../bletiny_project/">BLE app to check stats via console</a>
</li>
@@ -327,6 +314,14 @@
+
+
+ <li >
+ <a href="../../blehci_project/">BLE HCI interface</a>
+ </li>
+
+
+
</ul>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/22b7d022/os/tutorials/bletiny_project/index.html
----------------------------------------------------------------------
diff --git a/os/tutorials/bletiny_project/index.html b/os/tutorials/bletiny_project/index.html
index 93e33f6..0e25753 100644
--- a/os/tutorials/bletiny_project/index.html
+++ b/os/tutorials/bletiny_project/index.html
@@ -9,7 +9,7 @@
<link rel="canonical" href="http://mynewt.apache.org/os/tutorials/bletiny_project/">
<link rel="shortcut icon" href="../../../img/favicon.ico">
- <title>Use BLE app to check stats via console - Apache Mynewt</title>
+ <title>BLE app to check stats via console - 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">
@@ -41,7 +41,7 @@
</head>
- <body class="Use BLE app to check stats via console">
+ <body class="BLE app to check stats via console">
@@ -200,8 +200,11 @@
- <li >
- <a href="../add_repos/">Add repo to project</a>
+
+
+ <li ><a href="../repo/add_repos/">Work with repositories</a>
+
+
</li>
@@ -209,7 +212,7 @@
<li >
- <a href="../create_repo/">Create a repo</a>
+ <a href="../unit_test/">Write a Test Suite for a Package</a>
</li>
@@ -217,15 +220,15 @@
<li >
- <a href="../upgrade_repo/">Upgrade a repo</a>
+ <a href="../air_quality_sensor/">Air-quality Sensor project</a>
</li>
- <li class="active">
- <a href="./">Use BLE app to check stats via console</a>
+ <li >
+ <a href="../event_queue/">Add task to manage multiple events</a>
</li>
@@ -248,16 +251,19 @@
- <li >
- <a href="../unit_test/">Write a Test Suite for a Package</a>
+ <li class="active">
+ <a href="./">BLE app to check stats via console</a>
</li>
- <li >
- <a href="../air_quality_sensor/">Air-quality Sensor project</a>
+
+
+ <li ><a href="../bleprph/bleprph-intro/">BLE peripheral project</a>
+
+
</li>
@@ -265,18 +271,7 @@
<li >
- <a href="../event_queue/">Add task to manage multiple events</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../bleprph/bleprph-intro/">BLE peripheral project</a>
-
-
+ <a href="../ibeacon/">BLE iBeacon</a>
</li>
@@ -284,7 +279,7 @@
<li >
- <a href="../ibeacon/">BLE iBeacon</a>
+ <a href="../blehci_project/">BLE HCI interface</a>
</li>
@@ -384,7 +379,7 @@
- <li>» Use BLE app to check stats via console</li>
+ <li>» BLE app to check stats via console</li>
@@ -425,20 +420,24 @@ apache-mynewt-core successfully installed version 0.7.9-none
<p><br></p>
-<h3 id="create-a-target">Create a target</h3>
+<h3 id="create-targets">Create targets</h3>
+<p>You will create two targets - one for the bootloader, the other for the application.</p>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt target create myble
Target targets/myble successfully created
+$ newt target create nrf52_boot
+Target targets/myble successfully created
$ newt target show
targets/my_blinky_sim
app=apps/blinky
bsp=@apache-mynewt-core/hw/bsp/native
build_profile=debug
targets/myble
+targets/nrf52_boot
</pre></div>
<p><br></p>
-<p>Define the target further. Note that you are using the example app <code>bletiny</code>. </p>
+<p>Define the targets further. Note that you are using the example app <code>bletiny</code> for the application target. Set the bsp correctly (nrf52pdk or nrf52dk depending on whether the board is the preview kit or the dev kit, respectively). </p>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt target set myble bsp=@apache-mynewt-core/hw/bsp/nrf52pdk
Target targets/myble successfully set target.bsp to @apache-mynewt-core/hw/bsp/nrf52pdk
$ newt target set myble app=@apache-mynewt-core/apps/bletiny
@@ -447,7 +446,19 @@ $ newt target set myble build_profile=optimized
Target targets/myble successfully set target.build_profile to optimized
$ newt target set myble cflags=-DSTATS_NAME_ENABLE
Target targets/myble successfully set pkg.cflags to DSTATS_NAME_ENABLE
-$ newt target show
+</pre></div>
+
+
+<p>Use the same <code>newt target set</code> command to set the following definition for the bootloader target.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">targets/nrf52_boot
+ app=@apache-mynewt-core/apps/boot
+ bsp=@apache-mynewt-core/hw/bsp/nrf52pdk
+ build_profile=optimized
+</pre></div>
+
+
+<p>You should have the following targets by the end of this step.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt target show
targets/my_blinky_sim
app=apps/blinky
bsp=@apache-mynewt-core/hw/bsp/native
@@ -457,12 +468,19 @@ targets/myble
bsp=@apache-mynewt-core/hw/bsp/nrf52pdk
build_profile=optimized
cflags=-DSTATS_NAME_ENABLE
+targets/nrf52_boot
+ app=@apache-mynewt-core/apps/boot
+ bsp=@apache-mynewt-core/hw/bsp/nrf52pdk
+ build_profile=optimized
</pre></div>
-<p><br></p>
-<p>Then build the target.</p>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt build myble
+<h3 id="build-targets">Build targets</h3>
+<p>Then build the two targets.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt build nrf52_boot
+<snip>
+App successfully built: ./bin/nrf52_boot/apps/boot/boot.elf
+$ newt build myble
Compiling hci_common.c
Compiling util.c
Archiving nimble.a
@@ -472,6 +490,15 @@ Compiling os.c
<p><br></p>
+<h3 id="create-the-app-image">Create the app image</h3>
+<p>Generate a signed application image for the <code>myble</code> target. The version number is arbitrary.</p>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt create-image myble 1.0.0
+App image succesfully generated: ./bin/makerbeacon/apps/bletiny/bletiny.img
+Build manifest: ./bin/makerbeacon/apps/bletiny/manifest.json
+</pre></div>
+
+
+<p><br></p>
<h3 id="load-the-image">Load the image</h3>
<p>Make sure the USB connector is in place and the power LED on the board is lit. Use the Power ON/OFF switch to reset the board after loading the image.</p>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%">$ newt load myble
@@ -567,16 +594,16 @@ GAP procedure initiated: discovery; disc_mode=2 filter_policyLE advertising repo
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../upgrade_repo/>
+ <a href=../project-target-slinky/>
<span class="fa fa-arrow-left"></span>
- Previous: Upgrade a repo
+ Previous: Enable remote comms on STM32 board
</a>
</li>
<li class="pull-right">
- <a href=../project-slinky/>
- Next: Enable remote comms on sim device
+ <a href=../bleprph/bleprph-intro/>
+ Next: BLE peripheral project
<span class="fa fa-arrow-right"></span>
</a>