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/08 21:03:00 UTC
[06/16] incubator-mynewt-site git commit: BLE Host API added. Project
Blinky documentation for Primo corrected. This closes #104 and #105.
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/e98b0c12/develop/network/ble/ble_hs/ble_gattc/functions/ble_gattc_write_reliable/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gattc/functions/ble_gattc_write_reliable/index.html b/develop/network/ble/ble_hs/ble_gattc/functions/ble_gattc_write_reliable/index.html
new file mode 100644
index 0000000..30773c4
--- /dev/null
+++ b/develop/network/ble/ble_hs/ble_gattc/functions/ble_gattc_write_reliable/index.html
@@ -0,0 +1,736 @@
+<!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_gattc/functions/ble_gattc_write_reliable/">
+ <link rel="shortcut icon" href="../../../../../../img/favicon.ico">
+
+ <title>ble_gattc_write_reliable - 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_gattc_write_reliable">
+
+
+
+
+
+
+
+
+
+<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/">GATT client</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../definitions/ble_gattc_defs/
+">Definitions</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../ble_gattc/
+">Functions</a>
+
+
+ <ul>
+
+
+
+ <li >
+ <a href="../../ble_gattc/">ble_gattc</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_disc_all_chrs/">ble_gattc_disc_all_chrs</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_disc_all_dscs/">ble_gattc_disc_all_dscs</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_disc_all_svcs/">ble_gattc_disc_all_svcs</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_disc_chrs_by_uuid/">ble_gattc_disc_chrs_by_uuid</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_disc_svc_by_uuid/">ble_gattc_disc_svc_by_uuid</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_exchange_mtu/">ble_gattc_exchange_mtu</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_find_inc_svcs/">ble_gattc_find_inc_svcs</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_notify/">ble_gattc_notify</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_notify_custom/">ble_gattc_notify_custom</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_read/">ble_gattc_read</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_read_by_uuid/">ble_gattc_read_by_uuid</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_read_long/">ble_gattc_read_long</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_read_mult/">ble_gattc_read_mult</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_write/">ble_gattc_write</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_write_long/">ble_gattc_write_long</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gattc_write_no_rsp/">ble_gattc_write_no_rsp</a>
+ </li>
+
+
+
+
+
+ <li class="active">
+ <a href="./">ble_gattc_write_reliable</a>
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+ </ul>
+
+ </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="../../../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_gattc/">GATT client</a></li>
+
+
+
+ <li>» <a href="../../ble_gattc/">Functions</a></li>
+
+
+
+ <li>» ble_gattc_write_reliable</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h2 id="ble95gattc95write95reliable"><font color="#F2853F" style="font-size:24pt">ble_gattc_write_reliable</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">int</span>
+<span style="color: #000000">ble_gattc_write_reliable</span>(<span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>,
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_attr</span> <span style="color: #000000">*attrs</span>,
+ <span style="color: #A90D91">int</span> <span style="color: #000000">num_attrs</span>, <span style="color: #000000">ble_gatt_reliable_attr_fn</span> <span style="color: #000000">*cb</span>,
+ <span style="color: #A90D91">void</span> <span style="color: #000000">*cb_arg</span>)
+</pre></div>
+
+
+<h3 id="description">Description</h3>
+<p>Initiates GATT procedure: Reliable Writes. </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 connection over which to execute the procedure.</td>
+</tr>
+<tr>
+<td>attrs</td>
+<td>An array of attribute descriptors; specifies which characteristics to write to and what data to write to them.</td>
+</tr>
+<tr>
+<td>num_attrs</td>
+<td>The number of characteristics to write; equal to the number of elements in the 'attrs' array.</td>
+</tr>
+<tr>
+<td>cb</td>
+<td>The function to call to report procedure status updates; null for no callback.</td>
+</tr>
+<tr>
+<td>cb_arg</td>
+<td>The optional argument to pass to the callback function.</td>
+</tr>
+</tbody>
+</table>
+<h3 id="returned-values">Returned values</h3>
+<p>None</p>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../ble_gattc_write_no_rsp/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: ble_gattc_write_no_rsp
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../../../ble_gatts/ble_gatts/>
+ Next: GATT server
+ <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/e98b0c12/develop/network/ble/ble_hs/ble_gatts/ble_gatts/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gatts/ble_gatts/index.html b/develop/network/ble/ble_hs/ble_gatts/ble_gatts/index.html
new file mode 100644
index 0000000..b02335a
--- /dev/null
+++ b/develop/network/ble/ble_hs/ble_gatts/ble_gatts/index.html
@@ -0,0 +1,579 @@
+<!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_gatts/ble_gatts/">
+ <link rel="shortcut icon" href="../../../../../img/favicon.ico">
+
+ <title>toc - 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="toc">
+
+
+
+
+
+
+
+
+
+<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 class="active"><a href="./">GATT server</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="
+ ../definitions/ble_gatts_defs/
+">Definitions</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../functions/ble_gatts_find_chr/
+">Functions</a>
+
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../ble_hs_id/ble_hs_id/">Identity</a>
+
+
+ </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>» GATT server</li>
+
+
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h2 id="nimble-host-gatt-client-reference"><font color="F2853F" style="font-size:24pt">NimBLE Host GATT Client Reference</font></h2>
+<h3 id="introduction">Introduction</h3>
+<p>The Generic Attribute Profile (GATT) manages all activities involving services, characteristics, and descriptors. The server half of the GATT API handles registration and responding to GATT clients.</p>
+<h3 id="header">Header</h3>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #633820">#include "host/ble_hs.h"</span>
+</pre></div>
+
+
+<h3 id="definitions">Definitions</h3>
+<p><a href="../definitions/ble_gatts_defs/">BLE host GATT server definitions</a></p>
+<h3 id="functions">Functions</h3>
+<table>
+<thead>
+<tr>
+<th>Function</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="../functions/ble_gatts_find_chr/">ble_gatts_find_chr</a></td>
+<td>Retrieves the pair of attribute handles associated with a local GATT characteristic.</td>
+</tr>
+<tr>
+<td><a href="../functions/ble_gatts_find_dsc/">ble_gatts_find_dsc</a></td>
+<td>Retrieves the attribute handle associated with a local GATT descriptor.</td>
+</tr>
+<tr>
+<td><a href="../functions/ble_gatts_find_svc/">ble_gatts_find_svc</a></td>
+<td>Retrieves the attribute handle associated with a local GATT service.</td>
+</tr>
+<tr>
+<td><a href="../functions/ble_gatts_register_svcs/">ble_gatts_register_svcs</a></td>
+<td>Registers a set of services, characteristics, and descriptors to be accessed by GATT clients.</td>
+</tr>
+</tbody>
+</table>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../../ble_gattc/functions/ble_gattc_write_reliable/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: ble_gattc_write_reliable
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../definitions/ble_gatts_defs/>
+ Next: GATT server definitions
+ <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/e98b0c12/develop/network/ble/ble_hs/ble_gatts/definitions/ble_gatts_defs/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gatts/definitions/ble_gatts_defs/index.html b/develop/network/ble/ble_hs/ble_gatts/definitions/ble_gatts_defs/index.html
new file mode 100644
index 0000000..c5e957e
--- /dev/null
+++ b/develop/network/ble/ble_hs/ble_gatts/definitions/ble_gatts_defs/index.html
@@ -0,0 +1,741 @@
+<!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_gatts/definitions/ble_gatts_defs/">
+ <link rel="shortcut icon" href="../../../../../../img/favicon.ico">
+
+ <title>GATT server 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="GATT server 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/">GATT server</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="
+ ./
+">Definitions</a>
+
+
+ <ul>
+
+
+
+ <li class="active">
+ <a href="./">GATT server definitions</a>
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../functions/ble_gatts_find_chr/
+">Functions</a>
+
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../ble_hs_id/ble_hs_id/">Identity</a>
+
+
+ </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_gatts/">GATT server</a></li>
+
+
+
+ <li>» Definitions</li>
+
+
+
+ <li>» GATT server definitions</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h2 id="gatt-client-definitionsfont"><font color="#F2853F" style="font-size:24pt">GATT Client Definitions/font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">typedef</span> <span style="color: #A90D91">int</span> <span style="color: #000000">ble_gatt_access_fn</span>(<span style="color: #A90D91">uint16_t</span> <span style="color: #000000">conn_handle</span>, <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">attr_handle</span>,
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">op</span>, <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_access_ctxt</span> <span style="color: #000000">*ctxt</span>,
+ <span style="color: #A90D91">void</span> <span style="color: #000000">*arg</span>);
+</pre></div>
+
+
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">typedef</span> <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">ble_gatt_chr_flags</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_gatt_chr_def</span> {
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * Pointer to first element in a uint8_t[16]; use the BLE_UUID16 macro for</span>
+<span style="color: #177500"> * 16-bit UUIDs; NULL if there are no more characteristics in the service.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">*uuid128</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * Callback that gets executed when this characteristic is read or</span>
+<span style="color: #177500"> * written.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #000000">ble_gatt_access_fn</span> <span style="color: #000000">*access_cb</span>;
+
+ <span style="color: #177500">/** Optional argument for callback. */</span>
+ <span style="color: #A90D91">void</span> <span style="color: #000000">*arg</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * Array of this characteristic's descriptors. NULL if no descriptors.</span>
+<span style="color: #177500"> * Do not include CCCD; it gets added automatically if this</span>
+<span style="color: #177500"> * characteristic's notify or indicate flag is set.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_dsc_def</span> <span style="color: #000000">*descriptors</span>;
+
+ <span style="color: #177500">/** Specifies the set of permitted operations for this characteristic. */</span>
+ <span style="color: #000000">ble_gatt_chr_flags</span> <span style="color: #000000">flags</span>;
+
+ <span style="color: #177500">/** </span>
+<span style="color: #177500"> * At registration time, this is filled in with the characteristic's value</span>
+<span style="color: #177500"> * attribute handle.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">*</span> <span style="color: #A90D91">const</span> <span style="color: #000000">val_handle</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_gatt_svc_def</span> {
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * One of the following:</span>
+<span style="color: #177500"> * o BLE_GATT_SVC_TYPE_PRIMARY - primary service</span>
+<span style="color: #177500"> * o BLE_GATT_SVC_TYPE_SECONDARY - secondary service</span>
+<span style="color: #177500"> * o 0 - No more services in this array.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">type</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * Pointer to first element in a uint8_t[16]; use the BLE_UUID16 macro for</span>
+<span style="color: #177500"> * 16-bit UUIDs.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">*uuid128</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * Array of pointers to other service definitions. These services are</span>
+<span style="color: #177500"> * reported as "included services" during service discovery. Terminate the</span>
+<span style="color: #177500"> * array with NULL.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_svc_def</span> <span style="color: #000000">**includes</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * Array of characteristic definitions corresponding to characteristics</span>
+<span style="color: #177500"> * belonging to this service.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_chr_def</span> <span style="color: #000000">*characteristics</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_gatt_access_ctxt</span> {
+ <span style="color: #A90D91">union</span> {
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The characteristic definition corresponding to the characteristic</span>
+<span style="color: #177500"> * being accessed. This is what the app registered at startup.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_chr_def</span> <span style="color: #000000">*chr</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The descriptor definition corresponding to the descriptor being</span>
+<span style="color: #177500"> * accessed. This is what the app registered at startup.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_dsc_def</span> <span style="color: #000000">*dsc</span>;
+ };
+
+ <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_att_svr_access_ctxt</span> <span style="color: #000000">*att</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_gatt_dsc_def</span> {
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The first element in a uint8_t[16]; use the BLE_UUID16 macro for 16-bit</span>
+<span style="color: #177500"> * UUIDs; NULL if there are no more descriptors in the characteristic.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">*uuid128</span>;
+
+ <span style="color: #177500">/** Specifies the set of permitted operations for this descriptor. */</span>
+ <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">att_flags</span>;
+
+ <span style="color: #177500">/** Callback that gets executed when the descriptor is read or written. */</span>
+ <span style="color: #000000">ble_gatt_access_fn</span> <span style="color: #000000">*access_cb</span>;
+
+ <span style="color: #177500">/** Optional argument for callback. */</span>
+ <span style="color: #A90D91">void</span> <span style="color: #000000">*arg</span>;
+};
+</pre></div>
+
+
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #177500">/**</span>
+<span style="color: #177500"> * Context passed to the registration callback; represents the GATT service,</span>
+<span style="color: #177500"> * characteristic, or descriptor being registered.</span>
+<span style="color: #177500"> */</span>
+<span style="color: #A90D91">union</span> <span style="color: #000000">ble_gatt_register_ctxt</span> {
+ <span style="color: #177500">/** Service; valid if op == BLE_GATT_REGISTER_OP_SVC. */</span>
+ <span style="color: #A90D91">struct</span> {
+ <span style="color: #177500">/** The ATT handle of the service definition attribute. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">handle</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The service definition representing the service being</span>
+<span style="color: #177500"> * registered.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_svc_def</span> <span style="color: #000000">*svc_def</span>;
+ } <span style="color: #000000">svc</span>;
+
+ <span style="color: #177500">/** Characteristic; valid if op == BLE_GATT_REGISTER_OP_CHR. */</span>
+ <span style="color: #A90D91">struct</span> {
+ <span style="color: #177500">/** The ATT handle of the characteristic definition attribute. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">def_handle</span>;
+
+ <span style="color: #177500">/** The ATT handle of the characteristic value attribute. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">val_handle</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The characteristic definition representing the characteristic being</span>
+<span style="color: #177500"> * registered.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_chr_def</span> <span style="color: #000000">*chr_def</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The service definition corresponding to the characteristic's parent</span>
+<span style="color: #177500"> * service.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_svc_def</span> <span style="color: #000000">*svc_def</span>;
+ } <span style="color: #000000">chr</span>;
+
+ <span style="color: #177500">/** Descriptor; valid if op == BLE_GATT_REGISTER_OP_DSC. */</span>
+ <span style="color: #A90D91">struct</span> {
+ <span style="color: #177500">/** The ATT handle of the descriptor definition attribute. */</span>
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">handle</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The descriptor definition corresponding to the descriptor being</span>
+<span style="color: #177500"> * registered.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_dsc_def</span> <span style="color: #000000">*dsc_def</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The characteristic definition corresponding to the descriptor's</span>
+<span style="color: #177500"> * parent characteristic.</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_chr_def</span> <span style="color: #000000">*chr_def</span>;
+
+ <span style="color: #177500">/**</span>
+<span style="color: #177500"> * The service definition corresponding to the descriptor's grandparent</span>
+<span style="color: #177500"> * service</span>
+<span style="color: #177500"> */</span>
+ <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_gatt_svc_def</span> <span style="color: #000000">*svc_def</span>;
+ } <span style="color: #000000">dsc</span>;
+};
+</pre></div>
+
+
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">typedef</span> <span style="color: #A90D91">void</span> <span style="color: #000000">ble_gatt_register_fn</span>(<span style="color: #A90D91">uint8_t</span> <span style="color: #000000">op</span>,
+ <span style="color: #A90D91">union</span> <span style="color: #000000">ble_gatt_register_ctxt</span> <span style="color: #000000">*ctxt</span>,
+ <span style="color: #A90D91">void</span> <span style="color: #000000">*arg</span>);
+</pre></div>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../../ble_gatts/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: GATT server
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../../functions/ble_gatts_find_chr/>
+ Next: ble_gatts_find_chr
+ <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/e98b0c12/develop/network/ble/ble_hs/ble_gatts/functions/ble_gatts_find_chr/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/ble_gatts/functions/ble_gatts_find_chr/index.html b/develop/network/ble/ble_hs/ble_gatts/functions/ble_gatts_find_chr/index.html
new file mode 100644
index 0000000..0d473ce
--- /dev/null
+++ b/develop/network/ble/ble_hs/ble_gatts/functions/ble_gatts_find_chr/index.html
@@ -0,0 +1,635 @@
+<!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_gatts/functions/ble_gatts_find_chr/">
+ <link rel="shortcut icon" href="../../../../../../img/favicon.ico">
+
+ <title>ble_gatts_find_chr - 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_gatts_find_chr">
+
+
+
+
+
+
+
+
+
+<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/">GATT server</a>
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="
+ ../../definitions/ble_gatts_defs/
+">Definitions</a>
+
+
+ </li>
+
+
+
+
+
+
+
+ <li><a href="
+ ./
+">Functions</a>
+
+
+ <ul>
+
+
+
+ <li class="active">
+ <a href="./">ble_gatts_find_chr</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gatts_find_dsc/">ble_gatts_find_dsc</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gatts_find_svc/">ble_gatts_find_svc</a>
+ </li>
+
+
+
+
+
+ <li >
+ <a href="../ble_gatts_register_svcs/">ble_gatts_register_svcs</a>
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+ </ul>
+
+ </li>
+
+
+
+
+
+
+
+ <li ><a href="../../../ble_hs_id/ble_hs_id/">Identity</a>
+
+
+ </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_gatts/">GATT server</a></li>
+
+
+
+ <li>» Functions</li>
+
+
+
+ <li>» ble_gatts_find_chr</li>
+
+
+
+ </ul>
+</div>
+ </div>
+ </div>
+
+ <h2 id="ble95gatts95find95chr"><font color="#F2853F" style="font-size:24pt">ble_gatts_find_chr</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">int</span>
+<span style="color: #000000">ble_gatts_find_chr</span>(<span style="color: #A90D91">const</span> <span style="color: #A90D91">void</span> <span style="color: #000000">*svc_uuid128</span>, <span style="color: #A90D91">const</span> <span style="color: #A90D91">void</span> <span style="color: #000000">*chr_uuid128</span>,
+ <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">*out_def_handle</span>, <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">*out_val_handle</span>)
+</pre></div>
+
+
+<h3 id="description">Description</h3>
+<p>Retrieves the pair of attribute handles associated with a local GATT characteristic. </p>
+<h3 id="parameters">Parameters</h3>
+<table>
+<thead>
+<tr>
+<th><em>Parameter</em></th>
+<th><em>Description</em></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>svc_uuid128</td>
+<td>The UUID of the parent service.</td>
+</tr>
+<tr>
+<td>chr_uuid128</td>
+<td>The UUID of the characteristic to look up.</td>
+</tr>
+<tr>
+<td>out_def_handle</td>
+<td>On success, populated with the handle of the characteristic definition attribute. Pass null if you don't need this value.</td>
+</tr>
+<tr>
+<td>out_val_handle</td>
+<td>On success, populated with the handle of the characteristic value attribute. Pass null if you don't need this value.</td>
+</tr>
+</tbody>
+</table>
+<h3 id="returned-values">Returned values</h3>
+<table>
+<thead>
+<tr>
+<th><em>Value</em></th>
+<th><em>Condition</em></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>0</td>
+<td>Success.</td>
+</tr>
+<tr>
+<td>BLE_HS_ENOENT</td>
+<td>The specified service or characteristic could not be found.</td>
+</tr>
+</tbody>
+</table>
+
+ <div class="row">
+
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+ <li>
+
+ <a href=../../definitions/ble_gatts_defs/>
+ <span class="fa fa-arrow-left"></span>
+ Previous: GATT server definitions
+ </a>
+
+ </li>
+ <li class="pull-right">
+
+ <a href=../ble_gatts_find_dsc/>
+ Next: ble_gatts_find_dsc
+ <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