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/07/23 21:38:43 UTC
[4/6] incubator-mynewt-site git commit: Updated BLE Host API. This
closes #108
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_att/ble_att/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_att/ble_att/index.html b/develop/network/ble/ble_hs/ble_att/ble_att/index.html
index 986338f..3613d6d 100644
--- a/develop/network/ble/ble_hs/ble_att/ble_att/index.html
+++ b/develop/network/ble/ble_hs/ble_att/ble_att/index.html
@@ -348,18 +348,10 @@
- <li >
- <a href="../definitions/ble_att_defs/">Definitions</a>
- </li>
-
-
-
-
-
<li><a href="
- ../functions/ble_att_svr_write_local/
+ ../functions/ble_att_mtu/
">Functions</a>
@@ -489,8 +481,7 @@
<h3 id="definitions">Definitions</h3>
-<p><a href="../definitions/ble_att_defs/">BLE host ATT definitions</a></p>
-<h3 id="functions">Functions</h3>
+<p>None.</p>
<table>
<thead>
<tr>
@@ -500,8 +491,12 @@
</thead>
<tbody>
<tr>
+<td><a href="../functions/ble_att_mtu/">ble_att_mtu</a></td>
+<td>Retrieves the ATT MTU of the specified connection.</td>
+</tr>
+<tr>
<td><a href="../functions/ble_att_set_preferred_mtu/">ble_att_set_preferred_mtu</a></td>
-<td>Sets the preferred ATT MTU; the device will indicate this value in all subsequent ATT MTU exchanges.</td>
+<td>Sets the preferred ATT MTU; the device will indicate this value in all subseqeunt ATT MTU exchanges.</td>
</tr>
<tr>
<td><a href="../functions/ble_att_svr_read_local/">ble_att_svr_read_local</a></td>
@@ -522,16 +517,16 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../ble_hs_id/functions/ble_hs_id_gen_rnd/>
+ <a href=../../ble_hs_id/functions/ble_hs_id_set_rnd/>
<span class="fa fa-arrow-left"></span>
- Previous: ble_hs_id_gen_rnd
+ Previous: ble_hs_id_set_rnd
</a>
</li>
<li class="pull-right">
- <a href=../definitions/ble_att_defs/>
- Next: Definitions
+ <a href=../functions/ble_att_mtu/>
+ Next: ble_att_mtu
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_att/definitions/ble_att_defs/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_att/definitions/ble_att_defs/index.html b/develop/network/ble/ble_hs/ble_att/definitions/ble_att_defs/index.html
deleted file mode 100644
index e858d24..0000000
--- a/develop/network/ble/ble_hs/ble_att/definitions/ble_att_defs/index.html
+++ /dev/null
@@ -1,625 +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/network/ble/ble_hs/ble_att/definitions/ble_att_defs/">
- <link rel="shortcut icon" href="../../../../../../img/favicon.ico">
-
- <title>Definitions - 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="Definitions">
-
-
-
-
-
-
-
-
-
-<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="/latest/os/introduction">Documentation</a>
- </li>
- <li
- class=""
->
- <a href="/download/">Download</a>
- </li>
- <li
- class=""
->
- <a href="/community/">Community</a>
- </li>
- <li
- class=""
->
- <a href="/events/">Events</a>
- </li>
- </ul>
-
- <!-- Search, Navigation and Repo links -->
- <ul class="nav navbar-nav navbar-right">
-
- </ul>
- </div>
- </div>
-</nav>
-
-
-
- <div class="container">
-
- <div class="row">
- <div class="col-md-3 v2-sidebar"><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 class="doc-version">
-<select class="form-control" onchange="if (this.value) window.location.href=this.value">
-
- <option
- value="/develop/os/introduction"
- selected="selected"
- >
- Version: develop
- </option>
-
- <option
- value="/v0_9_0/os/introduction"
-
- >
- Version: 0.9.0 (latest)
- </option>
-
-</select>
-</li>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- <li ><a href="../../../../../../os/introduction/">Mynewt Documentation</a>
-
-
- <ul>
-
-
-
-
-
-
-
- <li ><a href="../../../../../../os/get_started/get_started/">Basic Setup</a>
-
-
- </li>
-
-
-
-
-
- <li >
- <a href="../../../../../../os/get_started/vocabulary/">Concepts</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../../../../os/tutorials/tutorials/">Tutorials</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../../../../os/os_user_guide/">OS User Guide</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li><a href="
- ../../../../ble_intro/
-">BLE User Guide</a>
-
-
- <ul>
-
-
-
- <li >
- <a href="../../../../ble_intro/">NimBLE Introduction</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../../../ble_sec/">NimBLE Security</a>
- </li>
-
-
-
-
-
- <li >
- <a href="../../../../nimble_setup/">Set up application</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../../ini_stack/ble_ini_intro/">Initialize stack</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../ble_hs/">NimBLE Host API</a>
-
-
- <ul>
-
-
-
-
-
- <li >
- <a href="../../../ble_hs_return_codes/">Return codes</a>
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../init/init/">Init and config</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../ble_gap/ble_gap/">GAP</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../ble_gattc/ble_gattc/">GATT client</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../ble_gatts/ble_gatts/">GATT server</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../ble_hs_id/ble_hs_id/">Identity</a>
-
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../ble_att/">ATT</a>
-
-
- <ul>
-
-
-
-
-
- <li class="active">
- <a href="./">Definitions</a>
- </li>
-
-
-
-
-
-
-
- <li><a href="
- ../../functions/ble_att_svr_write_local/
-">Functions</a>
-
-
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../other/other/">Other</a>
-
-
- </li>
-
-
-
- </ul>
-
- </li>
-
-
-
-
-
-
-
- <li ><a href="../../../../bletiny_api/">bletiny app Usage API</a>
-
-
- </li>
-
-
-
- </ul>
-
- </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="/develop/os/introduction">Docs</a></li>
-
-
-
- <li>» <a href="../../../ble_hs/">NimBLE Host API</a></li>
-
-
-
- <li>» <a href="../../ble_att/">ATT</a></li>
-
-
-
- <li>» Definitions</li>
-
-
-
- </ul>
-</div>
- </div>
- </div>
-
- <h2 id="att-definitions"><font color="#F2853F" style="font-size:24pt">ATT Definitions</font></h2>
-<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #177500">/**</span>
-<span style="color: #177500"> * Context for an access to an ATT attribute. When a client reads or writes a</span>
-<span style="color: #177500"> * locally registered attribute, an instance of this struct gets passed to the</span>
-<span style="color: #177500"> * access callback.</span>
-<span style="color: #177500"> */</span>
-<span style="color: #A90D91">struct</span> <span style="color: #000000">ble_att_svr_access_ctxt</span> {
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * The ATT operation being performed dictates which field in this union is</span>
-<span style="color: #177500"> * valid. If a read is being performed, the read field is valid.</span>
-<span style="color: #177500"> * Otherwise, a write is being performed, in which case the write field is</span>
-<span style="color: #177500"> * valid.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">union</span> {
- <span style="color: #177500">/** Context for reads of ATT attributes. */</span>
- <span style="color: #A90D91">struct</span> {
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * (stack --> app)</span>
-<span style="color: #177500"> * The offset within the attribute that the client is reading from.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">offset</span>;
-
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * (stack --> app)</span>
-<span style="color: #177500"> * Maximum number of data bytes the stack can send in the read</span>
-<span style="color: #177500"> * response. This is based on the connection's ATT MTU.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">max_data_len</span>;
-
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * (stack --> app)</span>
-<span style="color: #177500"> * A buffer that the app can use to write the characteristic</span>
-<span style="color: #177500"> * response value to. This buffer can hold up to max_data_len</span>
-<span style="color: #177500"> * bytes.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">*buf</span>;
-
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * (app --> stack)</span>
-<span style="color: #177500"> * App points this at the characteristic data to respond with.</span>
-<span style="color: #177500"> * Initially this points to "buf".</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">const</span> <span style="color: #A90D91">void</span> <span style="color: #000000">*data</span>;
-
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * (app --> stack)</span>
-<span style="color: #177500"> * App fills this with the number of data bytes contained in</span>
-<span style="color: #177500"> * characteristic response.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">len</span>;
- } <span style="color: #000000">read</span>;
-
- <span style="color: #177500">/** Context for writes of ATT attributes. */</span>
- <span style="color: #A90D91">struct</span> {
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * (stack --> app)</span>
-<span style="color: #177500"> * The data that the peer is writing to the characteristic.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">const</span> <span style="color: #A90D91">void</span> <span style="color: #000000">*data</span>;
-
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * (stack --> app)</span>
-<span style="color: #177500"> * The offset within the attribute that the client is writing to.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">offset</span>;
-
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * (stack --> app)</span>
-<span style="color: #177500"> * The number of bytes of characteristic data being written.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">int</span> <span style="color: #000000">len</span>;
- } <span style="color: #000000">write</span>;
- };
-};
-</pre></div>
-
- <div class="row">
-
-
-
-
-<ul class="nav nav-pills" style="margin-bottom: 10px">
- <li>
-
- <a href=../../ble_att/>
- <span class="fa fa-arrow-left"></span>
- Previous: ATT
- </a>
-
- </li>
- <li class="pull-right">
-
- <a href=../../functions/ble_att_svr_write_local/>
- Next: ble_att_svr_write_local
- <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/df4054b9/develop/network/ble/ble_hs/ble_att/functions/ble_att_mtu/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_att/functions/ble_att_mtu/index.html b/develop/network/ble/ble_hs/ble_att/functions/ble_att_mtu/index.html
new file mode 100644
index 0000000..6c47e9f
--- /dev/null
+++ b/develop/network/ble/ble_hs/ble_att/functions/ble_att_mtu/index.html
@@ -0,0 +1,603 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+
+ <link rel="canonical" href="http://mynewt.apache.org/network/ble/ble_hs/ble_att/functions/ble_att_mtu/">
+ <link rel="shortcut icon" href="../../../../../../img/favicon.ico">
+
+ <title>ble_att_mtu - 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_att_mtu">
+
+
+
+
+
+
+
+
+
+<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="/latest/os/introduction">Documentation</a>
+ </li>
+ <li
+ class=""
+>
+ <a href="/download/">Download</a>
+ </li>
+ <li
+ class=""
+>
+ <a href="/community/">Community</a>
+ </li>
+ <li
+ class=""
+>
+ <a href="/events/">Events</a>
+ </li>
+ </ul>
+
+ <!-- Search, Navigation and Repo links -->
+ <ul class="nav navbar-nav navbar-right">
+
+ </ul>
+ </div>
+ </div>
+</nav>
+
+
+
+ <div class="container">
+
+ <div class="row">
+ <div class="col-md-3 v2-sidebar"><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 class="doc-version">
+<select class="form-control" onchange="if (this.value) window.location.href=this.value">
+
+ <option
+ value="/develop/os/introduction"
+ selected="selected"
+ >
+ Version: develop
+ </option>
+
+ <option
+ value="/v0_9_0/os/introduction"
+
+ >
+ Version: 0.9.0 (latest)
+ </option>
+
+</select>
+</li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li ><a href="../../../../../../os/introduction/">Mynewt Documentation</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li ><a href="../../../../../../os/get_started/get_started/">Basic Setup</a>
+
+
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../../../../../../os/get_started/vocabulary/">Concepts</a>
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../../../../os/tutorials/tutorials/">Tutorials</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../../../../os/os_user_guide/">OS User Guide</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../../../ble_intro/
+">BLE User Guide</a>
+
+
+ <ul>
+
+
+
+ <li >
+ <a href="../../../../ble_intro/">NimBLE Introduction</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../../../../ble_sec/">NimBLE Security</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../../../../nimble_setup/">Set up application</a>
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../../ini_stack/ble_ini_intro/">Initialize stack</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../ble_hs/">NimBLE Host API</a>
+
+
+ <ul>
+
+
+
+
+
+ <li >
+ <a href="../../../ble_hs_return_codes/">Return codes</a>
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../init/init/">Init and config</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../ble_gap/ble_gap/">GAP</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../ble_gattc/ble_gattc/">GATT client</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../ble_gatts/ble_gatts/">GATT server</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../ble_hs_id/ble_hs_id/">Identity</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../ble_att/">ATT</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="
+ ./
+">Functions</a>
+
+
+ <ul>
+
+
+
+ <li class="active">
+ <a href="./">ble_att_mtu</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_att_set_preferred_mtu/">ble_att_set_preferred_mtu</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_att_svr_read_local/">ble_att_svr_read_local</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_att_svr_write_local/">ble_att_svr_write_local</a>
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../other/other/">Other</a>
+
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../../bletiny_api/">bletiny app Usage API</a>
+
+
+ </li>
+
+
+
+ </ul>
+
+ </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="/develop/os/introduction">Docs</a></li>
+
+
+
+ <li>» <a href="../../ble_att/">ATT</a></li>
+
+
+
+ <li>» Functions</li>
+
+
+
+ <li>» ble_att_mtu</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h2 id="ble95att95mtu"><font color="#F2853F" style="font-size:24pt">ble_att_mtu</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">uint16_t</span>
+<span style="color: #000000">ble_att_mtu</span>(<span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>)
+</pre></div>
+
+
+<h3 id="description">Description</h3>
+<p>Retrieves the ATT MTU of the specified connection. If an MTU exchange for this connection has occurred, the MTU is the lower of the two peers' preferred values. Otherwise, the MTU is the default value of 23.</p>
+<h3 id="parameters">Parameters</h3>
+<table>
+<thead>
+<tr>
+<th><em>Parameter</em></th>
+<th><em>Description</em></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>conn_handle</td>
+<td>The handle of the connection to query.</td>
+</tr>
+</tbody>
+</table>
+<h3 id="returned-values">Returned values</h3>
+<p>The specified connection's ATT MTU.</p>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../../ble_att/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: ATT
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../ble_att_set_preferred_mtu/>
+ Next: ble_att_set_preferred_mtu
+ <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/df4054b9/develop/network/ble/ble_hs/ble_att/functions/ble_att_set_preferred_mtu/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_att/functions/ble_att_set_preferred_mtu/index.html b/develop/network/ble/ble_hs/ble_att/functions/ble_att_set_preferred_mtu/index.html
index 4ab9116..decdf08 100644
--- a/develop/network/ble/ble_hs/ble_att/functions/ble_att_set_preferred_mtu/index.html
+++ b/develop/network/ble/ble_hs/ble_att/functions/ble_att_set_preferred_mtu/index.html
@@ -348,18 +348,10 @@
- <li >
- <a href="../../definitions/ble_att_defs/">Definitions</a>
- </li>
-
-
-
-
-
<li><a href="
- ../ble_att_svr_write_local/
+ ../ble_att_mtu/
">Functions</a>
@@ -368,7 +360,7 @@
<li >
- <a href="../ble_att_svr_write_local/">ble_att_svr_write_local</a>
+ <a href="../ble_att_mtu/">ble_att_mtu</a>
</li>
@@ -389,6 +381,14 @@
+
+
+ <li >
+ <a href="../ble_att_svr_write_local/">ble_att_svr_write_local</a>
+ </li>
+
+
+
</ul>
</li>
@@ -496,7 +496,7 @@
- <li>» <a href="../ble_att_svr_write_local/">Functions</a></li>
+ <li>» <a href="../ble_att_mtu/">Functions</a></li>
@@ -516,7 +516,7 @@
<h3 id="description">Description</h3>
-<p>Sets the preferred ATT MTU; the device will indicate this value in all subsequent ATT MTU exchanges. The ATT MTU of a connection is equal to the lower of the two peers' preferred MTU values. The ATT MTU is what dictates the maximum size of any message sent during a GATT procedure. The specified MTU must be within the following range: [23, BLE_ATT_MTU_MAX]. 23 is a minimum imposed by the Bluetooth specification; BLE_ATT_MTU_MAX is a NimBLE compile-time setting. </p>
+<p>Sets the preferred ATT MTU; the device will indicate this value in all subseqeunt ATT MTU exchanges. The ATT MTU of a connection is equal to the lower of the two peers' preferred MTU values. The ATT MTU is what dictates the maximum size of any message sent during a GATT procedure. The specified MTU must be within the following range: [23, BLE_ATT_MTU_MAX]. 23 is a minimum imposed by the Bluetooth specification; BLE_ATT_MTU_MAX is a NimBLE compile-time setting.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
@@ -528,7 +528,7 @@
<tbody>
<tr>
<td>mtu</td>
-<td>The preferred ATT MTU</td>
+<td>The preferred ATT MTU.</td>
</tr>
</tbody>
</table>
@@ -543,11 +543,11 @@
<tbody>
<tr>
<td>0</td>
-<td>Success</td>
+<td>Success.</td>
</tr>
<tr>
<td>BLE_HS_EINVAL</td>
-<td>The specified value is not within the allowed range</td>
+<td>The specifeid value is not within the allowed range.</td>
</tr>
</tbody>
</table>
@@ -560,9 +560,9 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../ble_att_svr_write_local/>
+ <a href=../ble_att_mtu/>
<span class="fa fa-arrow-left"></span>
- Previous: ble_att_svr_write_local
+ Previous: ble_att_mtu
</a>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_att/functions/ble_att_svr_read_local/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_att/functions/ble_att_svr_read_local/index.html b/develop/network/ble/ble_hs/ble_att/functions/ble_att_svr_read_local/index.html
index 6681aad..666f1a0 100644
--- a/develop/network/ble/ble_hs/ble_att/functions/ble_att_svr_read_local/index.html
+++ b/develop/network/ble/ble_hs/ble_att/functions/ble_att_svr_read_local/index.html
@@ -348,18 +348,10 @@
- <li >
- <a href="../../definitions/ble_att_defs/">Definitions</a>
- </li>
-
-
-
-
-
<li><a href="
- ../ble_att_svr_write_local/
+ ../ble_att_mtu/
">Functions</a>
@@ -368,7 +360,7 @@
<li >
- <a href="../ble_att_svr_write_local/">ble_att_svr_write_local</a>
+ <a href="../ble_att_mtu/">ble_att_mtu</a>
</li>
@@ -389,6 +381,14 @@
+
+
+ <li >
+ <a href="../ble_att_svr_write_local/">ble_att_svr_write_local</a>
+ </li>
+
+
+
</ul>
</li>
@@ -496,7 +496,7 @@
- <li>» <a href="../ble_att_svr_write_local/">Functions</a></li>
+ <li>» <a href="../ble_att_mtu/">Functions</a></li>
@@ -512,15 +512,14 @@
<h2 id="ble95att95svr95read95local"><font color="#F2853F" style="font-size:24pt">ble_att_svr_read_local</font></h2>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">int</span>
<span style="color: #000000">ble_att_svr_read_local</span>(
- <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">attr_handle</span>,
- <span style="color: #A90D91">const</span> <span style="color: #A90D91">void</span> <span style="color: #000000">**out_data</span>,
- <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">*out_attr_len</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">attr_handle</span>,
+ <span style="color: #A90D91">struct</span> <span style="color: #000000">os_mbuf</span> <span style="color: #000000">**out_om</span>
)
</pre></div>
<h3 id="description">Description</h3>
-<p>Reads a locally registered attribute. If the specified attribute handle corresponds to a GATT characteristic value or descriptor, the read is performed by calling the registered GATT access callback. </p>
+<p>Reads a locally registered attribute. If the specified attribute handle coresponds to a GATT characteristic value or descriptor, the read is performed by calling the registered GATT access callback.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
@@ -535,12 +534,8 @@
<td>The 16-bit handle of the attribute to read.</td>
</tr>
<tr>
-<td>out_data</td>
-<td>On success, this points to the attribute data just read.</td>
-</tr>
-<tr>
-<td>out_attr_len</td>
-<td>On success, this points to the number of bytes of attribute data just read.</td>
+<td>out_om</td>
+<td>On success, this is made to point to a newly-allocated mbuf containing the attribute data read.</td>
</tr>
</tbody>
</table>
@@ -555,11 +550,11 @@
<tbody>
<tr>
<td>0</td>
-<td>Success</td>
+<td>Success.</td>
</tr>
<tr>
<td><a href="../../../ble_hs_return_codes/#return-codes-att">ATT return code</a></td>
-<td>NimBLE host ATT return code if the attribute access callback reports failure.</td>
+<td>The attribute access callback reports failure.</td>
</tr>
<tr>
<td><a href="../../../ble_hs_return_codes/#return-codes-core">Core return code</a></td>
@@ -584,8 +579,8 @@
</li>
<li class="pull-right">
- <a href=../../../other/other/>
- Next: Other
+ <a href=../ble_att_svr_write_local/>
+ Next: ble_att_svr_write_local
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_att/functions/ble_att_svr_write_local/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_att/functions/ble_att_svr_write_local/index.html b/develop/network/ble/ble_hs/ble_att/functions/ble_att_svr_write_local/index.html
index 6c3f527..3f38e18 100644
--- a/develop/network/ble/ble_hs/ble_att/functions/ble_att_svr_write_local/index.html
+++ b/develop/network/ble/ble_hs/ble_att/functions/ble_att_svr_write_local/index.html
@@ -348,18 +348,10 @@
- <li >
- <a href="../../definitions/ble_att_defs/">Definitions</a>
- </li>
-
-
-
-
-
<li><a href="
- ./
+ ../ble_att_mtu/
">Functions</a>
@@ -367,8 +359,8 @@
- <li class="active">
- <a href="./">ble_att_svr_write_local</a>
+ <li >
+ <a href="../ble_att_mtu/">ble_att_mtu</a>
</li>
@@ -389,6 +381,14 @@
+
+
+ <li class="active">
+ <a href="./">ble_att_svr_write_local</a>
+ </li>
+
+
+
</ul>
</li>
@@ -496,7 +496,7 @@
- <li>» Functions</li>
+ <li>» <a href="../ble_att_mtu/">Functions</a></li>
@@ -512,15 +512,14 @@
<h2 id="ble95att95svr95write95local"><font color="#F2853F" style="font-size:24pt">ble_att_svr_write_local</font></h2>
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">int</span>
<span style="color: #000000">ble_att_svr_write_local</span>(
- <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">attr_handle</span>,
- <span style="color: #A90D91">const</span> <span style="color: #A90D91">void</span> <span style="color: #000000">*data</span>,
- <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">data_len</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">attr_handle</span>,
+ <span style="color: #A90D91">struct</span> <span style="color: #000000">os_mbuf</span> <span style="color: #000000">**om</span>
)
</pre></div>
<h3 id="description">Description</h3>
-<p>Writes a locally registered attribute. If the specified attribute handle corresponds to a GATT characteristic value or descriptor, the write is performed by calling the registered GATT access callback. </p>
+<p>Writes a locally registered attribute. This function consumes the supplied mbuf regardless of the outcome. If the specified attribute handle coresponds to a GATT characteristic value or descriptor, the write is performed by calling the registered GATT access callback.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
@@ -535,12 +534,8 @@
<td>The 16-bit handle of the attribute to write.</td>
</tr>
<tr>
-<td>data</td>
-<td>Buffer containing the data to write to the attribute.</td>
-</tr>
-<tr>
-<td>data_len</td>
-<td>The number of bytes to write.</td>
+<td>om</td>
+<td>The value to write to the attribute. Double indirection is used to effect a transfer of ownership from the caller.</td>
</tr>
</tbody>
</table>
@@ -555,11 +550,11 @@
<tbody>
<tr>
<td>0</td>
-<td>Success</td>
+<td>Success.</td>
</tr>
<tr>
<td><a href="../../../ble_hs_return_codes/#return-codes-att">ATT return code</a></td>
-<td>NimBLE host att return code if the attribute access callback reports failure.</td>
+<td>The attribute access callback reports failure.</td>
</tr>
<tr>
<td><a href="../../../ble_hs_return_codes/#return-codes-core">Core return code</a></td>
@@ -576,16 +571,16 @@
<ul class="nav nav-pills" style="margin-bottom: 10px">
<li>
- <a href=../../definitions/ble_att_defs/>
+ <a href=../ble_att_svr_read_local/>
<span class="fa fa-arrow-left"></span>
- Previous: Definitions
+ Previous: ble_att_svr_read_local
</a>
</li>
<li class="pull-right">
- <a href=../ble_att_set_preferred_mtu/>
- Next: ble_att_set_preferred_mtu
+ <a href=../../../other/other/>
+ Next: Other
<span class="fa fa-arrow-right"></span>
</a>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/ble_gap/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/ble_gap/index.html b/develop/network/ble/ble_hs/ble_gap/ble_gap/index.html
index 8d0daf7..ef963a4 100644
--- a/develop/network/ble/ble_hs/ble_gap/ble_gap/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/ble_gap/index.html
@@ -536,6 +536,10 @@
<td>Searches for a connection with the specified handle.</td>
</tr>
<tr>
+<td><a href="../functions/ble_gap_conn_rssi/">ble_gap_conn_rssi</a></td>
+<td>Retrieves the most-recently measured RSSI for the specified connection.</td>
+</tr>
+<tr>
<td><a href="../functions/ble_gap_connect/">ble_gap_connect</a></td>
<td>Initiates a connect procedure.</td>
</tr>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/definitions/ble_gap_defs/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/definitions/ble_gap_defs/index.html b/develop/network/ble/ble_hs/ble_gap/definitions/ble_gap_defs/index.html
index 3969342..c489c54 100644
--- a/develop/network/ble/ble_hs/ble_gap/definitions/ble_gap_defs/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/definitions/ble_gap_defs/index.html
@@ -515,7 +515,9 @@
<span style="color: #633820">#define BLE_GAP_EVENT_ADV_COMPLETE 9</span>
<span style="color: #633820">#define BLE_GAP_EVENT_ENC_CHANGE 10</span>
<span style="color: #633820">#define BLE_GAP_EVENT_PASSKEY_ACTION 11</span>
-<span style="color: #633820">#define BLE_GAP_EVENT_NOTIFY 12</span>
+<span style="color: #633820">#define BLE_GAP_EVENT_NOTIFY_RX 12</span>
+<span style="color: #633820">#define BLE_GAP_EVENT_NOTIFY_TX 13</span>
+<span style="color: #633820">#define BLE_GAP_EVENT_SUBSCRIBE 14</span>
</pre></div>
@@ -550,11 +552,8 @@
<span style="color: #177500"> */</span>
<span style="color: #A90D91">int</span> <span style="color: #000000">status</span>;
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * Information about the established connection. Only valid on</span>
-<span style="color: #177500"> * success.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_conn_desc</span> <span style="color: #000000">conn</span>;
+ <span style="color: #177500">/** The handle of the relevant connection. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>;
} <span style="color: #000000">connect</span>;
<span style="color: #177500">/**</span>
@@ -569,7 +568,7 @@
<span style="color: #177500"> */</span>
<span style="color: #A90D91">int</span> <span style="color: #000000">reason</span>;
- <span style="color: #177500">/** Information about the terminated connection. */</span>
+ <span style="color: #177500">/** Information about the connection prior to termination. */</span>
<span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_conn_desc</span> <span style="color: #000000">conn</span>;
} <span style="color: #000000">disconnect</span>;
@@ -581,8 +580,11 @@
<span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_disc_desc</span> <span style="color: #000000">disc</span>;
<span style="color: #177500">/**</span>
-<span style="color: #177500"> * Represents an attempt to update a connection's parameters. Valid</span>
-<span style="color: #177500"> * for the following event types:</span>
+<span style="color: #177500"> * Represents an attempt to update a connection's parameters. If the</span>
+<span style="color: #177500"> * attempt was successful, the connection's descriptor reflects the</span>
+<span style="color: #177500"> * updated parameters.</span>
+<span style="color: #177500"> *</span>
+<span style="color: #177500"> * Valid for the following event types:</span>
<span style="color: #177500"> * o BLE_GAP_EVENT_CONN_UPDATE</span>
<span style="color: #177500"> */</span>
<span style="color: #A90D91">struct</span> {
@@ -594,12 +596,8 @@
<span style="color: #177500"> */</span>
<span style="color: #A90D91">int</span> <span style="color: #000000">status</span>;
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * Information about the relevant connection. If the connection</span>
-<span style="color: #177500"> * update attempt was successful, this descriptor contains the</span>
-<span style="color: #177500"> * updated parameters.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_conn_desc</span> <span style="color: #000000">conn</span>;
+ <span style="color: #177500">/** The handle of the relevant connection. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>;
} <span style="color: #000000">conn_update</span>;
<span style="color: #177500">/**</span>
@@ -609,10 +607,12 @@
<span style="color: #177500"> * o L2CAP Connection Parameter Update Procedure</span>
<span style="color: #177500"> * o Link-Layer Connection Parameters Request Procedure</span>
<span style="color: #177500"> *</span>
+<span style="color: #177500"> * To reject the request, return a non-zero HCI error code. The value</span>
+<span style="color: #177500"> * returned is the reject reason given to the controller.</span>
+<span style="color: #177500"> *</span>
<span style="color: #177500"> * Valid for the following event types:</span>
<span style="color: #177500"> * o BLE_GAP_EVENT_L2CAP_UPDATE_REQ</span>
<span style="color: #177500"> * o BLE_GAP_EVENT_CONN_UPDATE_REQ</span>
-<span style="color: #177500"> * </span>
<span style="color: #177500"> */</span>
<span style="color: #A90D91">struct</span> {
<span style="color: #177500">/**</span>
@@ -629,8 +629,8 @@
<span style="color: #177500"> */</span>
<span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_upd_params</span> <span style="color: #000000">*self_params</span>;
- <span style="color: #177500">/** Information about the relevant connection. */</span>
- <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_conn_desc</span> <span style="color: #000000">conn</span>;
+ <span style="color: #177500">/** The handle of the relevant connection. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>;
} <span style="color: #000000">conn_update_req</span>;
<span style="color: #177500">/**</span>
@@ -644,13 +644,16 @@
<span style="color: #177500"> */</span>
<span style="color: #A90D91">int</span> <span style="color: #000000">status</span>;
- <span style="color: #177500">/** Information about the relevant connection. */</span>
- <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_conn_desc</span> <span style="color: #000000">conn</span>;
+ <span style="color: #177500">/** The handle of the relevant connection. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>;
} <span style="color: #000000">term_failure</span>;
<span style="color: #177500">/**</span>
<span style="color: #177500"> * Represents an attempt to change the encrypted state of a</span>
-<span style="color: #177500"> * connection. Valid for the following event types:</span>
+<span style="color: #177500"> * connection. If the attempt was successful, the connection</span>
+<span style="color: #177500"> * descriptor reflects the updated encrypted state.</span>
+<span style="color: #177500"> *</span>
+<span style="color: #177500"> * Valid for the following event types:</span>
<span style="color: #177500"> * o BLE_GAP_EVENT_ENC_CHANGE</span>
<span style="color: #177500"> */</span>
<span style="color: #A90D91">struct</span> {
@@ -662,16 +665,13 @@
<span style="color: #177500"> */</span>
<span style="color: #A90D91">int</span> <span style="color: #000000">status</span>;
- <span style="color: #177500">/**</span>
-<span style="color: #177500"> * Information about the relevant connection. If the encryption</span>
-<span style="color: #177500"> * state change attempt was successful, this descriptor reflects</span>
-<span style="color: #177500"> * the updated state.</span>
-<span style="color: #177500"> */</span>
- <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_conn_desc</span> <span style="color: #000000">conn</span>;
+ <span style="color: #177500">/** The handle of the relevant connection. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>;
} <span style="color: #000000">enc_change</span>;
<span style="color: #177500">/**</span>
<span style="color: #177500"> * Represents a passkey query needed to complete a pairing procedure.</span>
+<span style="color: #177500"> *</span>
<span style="color: #177500"> * Valid for the following event types:</span>
<span style="color: #177500"> * o BLE_GAP_EVENT_PASSKEY_ACTION</span>
<span style="color: #177500"> */</span>
@@ -679,41 +679,148 @@
<span style="color: #177500">/** Contains details about the passkey query. */</span>
<span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_passkey_params</span> <span style="color: #000000">params</span>;
- <span style="color: #177500">/** Information about the relevant connection. */</span>
- <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_conn_desc</span> <span style="color: #000000">conn</span>;
+ <span style="color: #177500">/** The handle of the relevant connection. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>;
} <span style="color: #000000">passkey</span>;
<span style="color: #177500">/**</span>
<span style="color: #177500"> * Represents a received ATT notification or indication.</span>
+<span style="color: #177500"> *</span>
<span style="color: #177500"> * Valid for the following event types:</span>
-<span style="color: #177500"> * o BLE_GAP_EVENT_NOTIFY</span>
+<span style="color: #177500"> * o BLE_GAP_EVENT_NOTIFY_RX</span>
<span style="color: #177500"> */</span>
<span style="color: #A90D91">struct</span> {
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The contents of the notification or indication. If the</span>
+<span style="color: #177500"> * application wishes to retain this mbuf for later use, it must</span>
+<span style="color: #177500"> * set this pointer to NULL to prevent the stack from freeing it.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">struct</span> <span style="color: #000000">os_mbuf</span> <span style="color: #000000">*om</span>;
+
<span style="color: #177500">/** The handle of the relevant ATT attribute. */</span>
<span style="color: #A90D91">uint16_t</span> <span style="color: #000000">attr_handle</span>;
- <span style="color: #177500">/** The contents of the notification or indication. */</span>
- <span style="color: #A90D91">void</span> <span style="color: #000000">*attr_data</span>;
+ <span style="color: #177500">/** The handle of the relevant connection. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>;
- <span style="color: #177500">/** The number of data bytes contained in the message. */</span>
- <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">attr_len</span>;
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * Whether the received command is a notification or an</span>
+<span style="color: #177500"> * indication;</span>
+<span style="color: #177500"> * o 0: Notification;</span>
+<span style="color: #177500"> * o 1: Indication.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">indication</span>:<span style="color: #1C01CE">1</span>;
+ } <span style="color: #000000">notify_rx</span>;
- <span style="color: #177500">/** Information about the relevant connection. */</span>
- <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_conn_desc</span> <span style="color: #000000">conn</span>;
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * Represents a transmitted ATT notification or indication, or a</span>
+<span style="color: #177500"> * completed indication transaction.</span>
+<span style="color: #177500"> *</span>
+<span style="color: #177500"> * Valid for the following event types:</span>
+<span style="color: #177500"> * o BLE_GAP_EVENT_NOTIFY_TX</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">struct</span> {
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The status of the notification or indication transaction;</span>
+<span style="color: #177500"> * o 0: Command successfully sent;</span>
+<span style="color: #177500"> * o BLE_HS_EDONE: Confirmation (indication ack) received;</span>
+<span style="color: #177500"> * o BLE_HS_ETIMEOUT: Confirmation (indication ack) never</span>
+<span style="color: #177500"> * received;</span>
+<span style="color: #177500"> * o Other return code: Error.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">int</span> <span style="color: #000000">status</span>;
+
+ <span style="color: #177500">/** The handle of the relevant connection. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>;
+
+ <span style="color: #177500">/** The handle of the relevant characterstic value. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">attr_handle</span>;
<span style="color: #177500">/**</span>
-<span style="color: #177500"> * Whether the received command is a notification or an</span>
+<span style="color: #177500"> * Whether the transmitted command is a notification or an</span>
<span style="color: #177500"> * indication;</span>
<span style="color: #177500"> * o 0: Notification;</span>
<span style="color: #177500"> * o 1: Indication.</span>
<span style="color: #177500"> */</span>
- <span style="color: #A90D91">unsigned</span> <span style="color: #000000">indication</span>:<span style="color: #1C01CE">1</span>;
- } <span style="color: #000000">notify</span>;
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">indication</span>:<span style="color: #1C01CE">1</span>;
+ } <span style="color: #000000">notify_tx</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * Represents a state change in a peer's subscription status. In this</span>
+<span style="color: #177500"> * comment, the term "update" is used to refer to either a notification</span>
+<span style="color: #177500"> * or an indication. This event is triggered by any of the following</span>
+<span style="color: #177500"> * occurrences:</span>
+<span style="color: #177500"> * o Peer enables or disables updates via a CCCD write.</span>
+<span style="color: #177500"> * o Connection is about to be terminated and the peer is</span>
+<span style="color: #177500"> * subscribed to updates.</span>
+<span style="color: #177500"> * o Peer is now subscribed to updates after its state was restored</span>
+<span style="color: #177500"> * from persistence. This happens when bonding is restored.</span>
+<span style="color: #177500"> *</span>
+<span style="color: #177500"> * Valid for the following event types:</span>
+<span style="color: #177500"> * o BLE_GAP_EVENT_SUBSCRIBE</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">struct</span> {
+ <span style="color: #177500">/** The handle of the relevant connection. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>;
+
+ <span style="color: #177500">/** The value handle of the relevant characteristic. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">attr_handle</span>;
+
+ <span style="color: #177500">/** One of the BLE_GAP_SUBSCRIBE_REASON codes. */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">reason</span>;
+
+ <span style="color: #177500">/** Whether the peer was previously subscribed to notifications. */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">prev_notify</span>:<span style="color: #1C01CE">1</span>;
+
+ <span style="color: #177500">/** Whether the peer is currently subscribed to notifications. */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">cur_notify</span>:<span style="color: #1C01CE">1</span>;
+
+ <span style="color: #177500">/** Whether the peer was previously subscribed to indications. */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">prev_indicate</span>:<span style="color: #1C01CE">1</span>;
+
+ <span style="color: #177500">/** Whether the peer is currently subscribed to indications. */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">cur_indicate</span>:<span style="color: #1C01CE">1</span>;
+ } <span style="color: #000000">subscribe</span>;
};
};
</pre></div>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #633820">#define BLE_GAP_CONN_MODE_NON 0</span>
+<span style="color: #633820">#define BLE_GAP_CONN_MODE_DIR 1</span>
+<span style="color: #633820">#define BLE_GAP_CONN_MODE_UND 2</span>
+</pre></div>
+
+
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #633820">#define BLE_GAP_DISC_MODE_NON 0</span>
+<span style="color: #633820">#define BLE_GAP_DISC_MODE_LTD 1</span>
+<span style="color: #633820">#define BLE_GAP_DISC_MODE_GEN 2</span>
+</pre></div>
+
+
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_white_entry</span> {
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">addr_type</span>;
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">addr</span>[<span style="color: #1C01CE">6</span>];
+};
+</pre></div>
+
+
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #177500">/*** Reason codes for the subscribe GAP event. */</span>
+
+<span style="color: #177500">/** Peer's CCCD subscription state changed due to a descriptor write. */</span>
+<span style="color: #633820">#define BLE_GAP_SUBSCRIBE_REASON_WRITE 1</span>
+
+<span style="color: #177500">/** Peer's CCCD subscription state cleared due to connection termination. */</span>
+<span style="color: #633820">#define BLE_GAP_SUBSCRIBE_REASON_TERM 2</span>
+
+<span style="color: #177500">/**</span>
+<span style="color: #177500"> * Peer's CCCD subscription state changed due to restore from persistence</span>
+<span style="color: #177500"> * (bonding restored).</span>
+<span style="color: #177500"> */</span>
+<span style="color: #633820">#define BLE_GAP_SUBSCRIBE_REASON_RESTORE 3</span>
+</pre></div>
+
+
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_sec_state</span> {
<span style="color: #A90D91">unsigned</span> <span style="color: #000000">encrypted</span>:<span style="color: #1C01CE">1</span>;
<span style="color: #A90D91">unsigned</span> <span style="color: #000000">authenticated</span>:<span style="color: #1C01CE">1</span>;
@@ -753,6 +860,11 @@
</pre></div>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #633820">#define BLE_GAP_ROLE_MASTER 0</span>
+<span style="color: #633820">#define BLE_GAP_ROLE_SLAVE 1</span>
+</pre></div>
+
+
<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_conn_desc</span> {
<span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_sec_state</span> <span style="color: #000000">sec_state</span>;
<span style="color: #A90D91">uint8_t</span> <span style="color: #000000">peer_ota_addr</span>[<span style="color: #1C01CE">6</span>];
@@ -813,6 +925,28 @@
<span style="color: #A90D91">uint32_t</span> <span style="color: #000000">numcmp</span>;
};
</pre></div>
+
+
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_disc_desc</span> {
+ <span style="color: #177500">/*** Common fields. */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">event_type</span>;
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">addr_type</span>;
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">length_data</span>;
+ <span style="color: #A90D91">int8_t</span> <span style="color: #000000">rssi</span>;
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">addr</span>[<span style="color: #1C01CE">6</span>];
+
+ <span style="color: #177500">/*** LE advertising report fields; both null if no data present. */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">*data</span>;
+ <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_hs_adv_fields</span> <span style="color: #000000">*fields</span>;
+
+ <span style="color: #177500">/***</span>
+<span style="color: #177500"> * LE direct advertising report fields; direct_addr_type is</span>
+<span style="color: #177500"> * BLE_GAP_ADDR_TYPE_NONE if direct address fields are not present.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">direct_addr_type</span>;
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">direct_addr</span>[<span style="color: #1C01CE">6</span>];
+};
+</pre></div>
<div class="row">
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_active/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_active/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_active/index.html
index ac5e3b8..7eddbf2 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_active/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_active/index.html
@@ -633,7 +633,7 @@
<h3 id="description">Description</h3>
-<p>Indicates whether an advertisement procedure is currently in progress. </p>
+<p>Indicates whether an advertisement procedure is currently in progress.</p>
<h3 id="parameters">Parameters</h3>
<p>None</p>
<h3 id="returned-values">Returned values</h3>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_rsp_set_fields/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_rsp_set_fields/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_rsp_set_fields/index.html
index 89605c3..d381364 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_rsp_set_fields/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_rsp_set_fields/index.html
@@ -633,7 +633,7 @@
<h3 id="description">Description</h3>
-<p>Configures the data to include in subsequent scan responses. </p>
+<p>Configures the data to include in subsequent scan responses.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_set_fields/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_set_fields/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_set_fields/index.html
index 19878a2..290138e 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_set_fields/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_set_fields/index.html
@@ -633,7 +633,7 @@
<h3 id="description">Description</h3>
-<p>Configures the data to include in subsequent advertisements. </p>
+<p>Configures the data to include in subsequent advertisements.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_start/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_start/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_start/index.html
index 82175f8..33265d4 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_start/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_start/index.html
@@ -641,7 +641,7 @@
<h3 id="description">Description</h3>
-<p>Initiates advertising. </p>
+<p>Initiates advertising.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_stop/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_stop/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_stop/index.html
index 8fbce52..090d929 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_stop/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_adv_stop/index.html
@@ -633,7 +633,7 @@
<h3 id="description">Description</h3>
-<p>Stops the currently-active advertising procedure. A success return code indicates that advertising has been fully aborted; a new advertising procedure can be initiated immediately. </p>
+<p>Stops the currently-active advertising procedure. A success return code indicates that advertising has been fully aborted; a new advertising procedure can be initiated immediately.</p>
<h3 id="parameters">Parameters</h3>
<p>None</p>
<h3 id="returned-values">Returned values</h3>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_active/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_active/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_active/index.html
index b4d0e98..ad816f2 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_active/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_active/index.html
@@ -633,7 +633,7 @@
<h3 id="description">Description</h3>
-<p>Indicates whether a connect procedure is currently in progress. </p>
+<p>Indicates whether a connect procedure is currently in progress.</p>
<h3 id="parameters">Parameters</h3>
<p>None</p>
<h3 id="returned-values">Returned values</h3>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_cancel/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_cancel/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_cancel/index.html
index df77cb6..7049f45 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_cancel/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_cancel/index.html
@@ -633,7 +633,7 @@
<h3 id="description">Description</h3>
-<p>Aborts a connect procedure in progress. </p>
+<p>Aborts a connect procedure in progress.</p>
<h3 id="parameters">Parameters</h3>
<p>None</p>
<h3 id="returned-values">Returned values</h3>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_find/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_find/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_find/index.html
index ce90c4b..e50380c 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_find/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_find/index.html
@@ -636,7 +636,7 @@
<h3 id="description">Description</h3>
-<p>Searches for a connection with the specified handle. If a matching connection is found, the supplied connection descriptor is filled correspondingly. </p>
+<p>Searches for a connection with the specified handle. If a matching connection is found, the supplied connection descriptor is filled correspondingly.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_rssi/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_rssi/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_rssi/index.html
index e4524d7..8a621c4 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_rssi/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_conn_rssi/index.html
@@ -636,7 +636,7 @@
<h3 id="description">Description</h3>
-<p>Retrieves the most-recently measured RSSI for the specified connection. A connection's RSSI is updated whenever a data channel PDU is received. </p>
+<p>Retrieves the most-recently measured RSSI for the specified connection. A connection's RSSI is updated whenever a data channel PDU is received.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_connect/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_connect/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_connect/index.html
index 50ec8b0..269a0c5 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_connect/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_connect/index.html
@@ -632,6 +632,7 @@
<span style="color: #A90D91">uint8_t</span> <span style="color: #000000">own_addr_type</span>,
<span style="color: #A90D91">uint8_t</span> <span style="color: #000000">peer_addr_type</span>,
<span style="color: #A90D91">const</span> <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">*peer_addr</span>,
+ <span style="color: #A90D91">int32_t</span> <span style="color: #000000">duration_ms</span>,
<span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gap_conn_params</span> <span style="color: #000000">*conn_params</span>,
<span style="color: #000000">ble_gap_event_fn</span> <span style="color: #000000">*cb</span>,
<span style="color: #A90D91">void</span> <span style="color: #000000">*cb_arg</span>
@@ -640,7 +641,7 @@
<h3 id="description">Description</h3>
-<p>Initiates a connect procedure. </p>
+<p>Initiates a connect procedure.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc/index.html
index 6caa1ea..f039ac0 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc/index.html
@@ -639,7 +639,7 @@
<h3 id="description">Description</h3>
-<p>Performs the Limited or General Discovery Procedures. </p>
+<p>Performs the Limited or General Discovery Procedures.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc_active/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc_active/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc_active/index.html
index 0e46b25..11ac30e 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc_active/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc_active/index.html
@@ -633,7 +633,7 @@
<h3 id="description">Description</h3>
-<p>Indicates whether a discovery procedure is currently in progress. </p>
+<p>Indicates whether a discovery procedure is currently in progress.</p>
<h3 id="parameters">Parameters</h3>
<p>None</p>
<h3 id="returned-values">Returned values</h3>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc_cancel/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc_cancel/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc_cancel/index.html
index eee7379..6ed6025 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc_cancel/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_disc_cancel/index.html
@@ -633,7 +633,7 @@
<h3 id="description">Description</h3>
-<p>Cancels the discovery procedure currently in progress. A success return code indicates that scanning has been fully aborted; a new discovery or connect procedure can be initiated immediately. </p>
+<p>Cancels the discovery procedure currently in progress. A success return code indicates that scanning has been fully aborted; a new discovery or connect procedure can be initiated immediately.</p>
<h3 id="parameters">Parameters</h3>
<p>None</p>
<h3 id="returned-values">Returned values</h3>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_security_initiate/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_security_initiate/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_security_initiate/index.html
index 22adcbb..311695b 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_security_initiate/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_security_initiate/index.html
@@ -633,7 +633,7 @@
<h3 id="description">Description</h3>
-<p>Initiates the GAP encryption procedure. </p>
+<p>Initiates the GAP encryption procedure.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_terminate/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_terminate/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_terminate/index.html
index 6cdc196..686b9d4 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_terminate/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_terminate/index.html
@@ -636,7 +636,7 @@
<h3 id="description">Description</h3>
-<p>Terminates an established connection. </p>
+<p>Terminates an established connection.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_update_params/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_update_params/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_update_params/index.html
index 3495e3c..465a953 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_update_params/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_update_params/index.html
@@ -636,7 +636,7 @@
<h3 id="description">Description</h3>
-<p>Initiates a connection parameter update procedure. </p>
+<p>Initiates a connection parameter update procedure.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/df4054b9/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_wl_set/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_wl_set/index.html b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_wl_set/index.html
index e274547..95677fc 100644
--- a/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_wl_set/index.html
+++ b/develop/network/ble/ble_hs/ble_gap/functions/ble_gap_wl_set/index.html
@@ -636,7 +636,7 @@
<h3 id="description">Description</h3>
-<p>Overwrites the controller's white list with the specified contents. </p>
+<p>Overwrites the controller's white list with the specified contents.</p>
<h3 id="parameters">Parameters</h3>
<table>
<thead>