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:02:57 UTC

[03/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/init/definitions/init_defs/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/init/definitions/init_defs/index.html b/develop/network/ble/ble_hs/init/definitions/init_defs/index.html
new file mode 100644
index 0000000..a0e02af
--- /dev/null
+++ b/develop/network/ble/ble_hs/init/definitions/init_defs/index.html
@@ -0,0 +1,701 @@
+<!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/init/definitions/init_defs/">
+        <link rel="shortcut icon" href="../../../../../../img/favicon.ico">
+
+	<title>Init and config 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="Init and config 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 and config</a>
+  
+  
+    <ul>
+          
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ./
+">Definitions</a>
+  
+  
+    <ul>
+          
+              
+                
+    <li class="active">
+      <a href="./">Init and config definitions</a>
+    </li>
+
+              
+          
+    </ul>
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ../../functions/ble_hs_init/
+">Functions</a>
+  
+  
+    </li>
+
+              
+          
+    </ul>
+  
+    </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="../../../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>&raquo; <a href="../../init/">Init and config</a></li>
+        
+      
+        
+          <li>&raquo; Definitions</li>
+        
+      
+      
+        <li>&raquo; Init and config definitions</li>
+      
+    
+    
+  </ul>
+</div>
+                            </div>
+                        </div>
+                        
+                            <h2 id="other-definitions"><font color="#F2853F" style="font-size:24pt">Other definitions</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #177500">/* Defines the IO capabilities for the local device. */</span>
+<span style="color: #633820">#define BLE_HS_IO_DISPLAY_ONLY              0x00</span>
+<span style="color: #633820">#define BLE_HS_IO_DISPLAY_YESNO             0x01</span>
+<span style="color: #633820">#define BLE_HS_IO_KEYBOARD_ONLY             0x02</span>
+<span style="color: #633820">#define BLE_HS_IO_NO_INPUT_OUTPUT           0x03</span>
+<span style="color: #633820">#define BLE_HS_IO_KEYBOARD_DISPLAY          0x04</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_hs_cfg</span> {
+    <span style="color: #177500">/*** HCI settings. */</span>
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * An HCI buffer is a &quot;flat&quot; 260-byte buffer.  HCI buffers are used by the</span>
+<span style="color: #177500">     * controller to send unsolicited events to the host.</span>
+<span style="color: #177500">     *</span>
+<span style="color: #177500">     * HCI buffers can get tied up when the controller sends lots of</span>
+<span style="color: #177500">     * asynchronous / unsolicited events (i.e., non-acks).  When the controller</span>
+<span style="color: #177500">     * needs to send one of these events, it allocates an HCI buffer, fills it</span>
+<span style="color: #177500">     * with the event payload, and puts it on a host queue.  If the controller</span>
+<span style="color: #177500">     * sends a quick burst of these events, the buffer pool may be exhausted,</span>
+<span style="color: #177500">     * preventing the host from sending an HCI command to the controller.</span>
+<span style="color: #177500">     *</span>
+<span style="color: #177500">     * Every time the controller sends a non-ack HCI event to the host, it also</span>
+<span style="color: #177500">     * allocates an OS event (it is unfortunate that these are both called</span>
+<span style="color: #177500">     * &quot;events&quot;).  The OS event is put on the host-parent-task&#39;s event queue;</span>
+<span style="color: #177500">     * it is what wakes up the host-parent-task and indicates that an HCI event</span>
+<span style="color: #177500">     * needs to be processsed.  The pool of OS events is allocated with the</span>
+<span style="color: #177500">     * same number of elements as the HCI buffer pool.</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">max_hci_bufs</span>;
+
+    <span style="color: #177500">/*** Connection settings. */</span>
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * The maximum number of concurrent connections.  This is set</span>
+<span style="color: #177500">     * automatically according to the build-time option</span>
+<span style="color: #177500">     * NIMBLE_OPT_MAX_CONNECTIONS.</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">max_connections</span>;
+
+    <span style="color: #177500">/*** GATT server settings. */</span>
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * These are acquired at service registration time and never freed.  You</span>
+<span style="color: #177500">     * need one of these for every service that you register.</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">max_services</span>;
+
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * The total number of in-RAM client characteristic configuration</span>
+<span style="color: #177500">     * descriptors (CCCDs).  One of these is consumed each time a peer</span>
+<span style="color: #177500">     * subscribes to notifications or indications for a characteristic that</span>
+<span style="color: #177500">     * your device serves.  In addition, at service registration time, the host</span>
+<span style="color: #177500">     * uses one of these for each characteristic that supports notifications or</span>
+<span style="color: #177500">     * indications.  So, the formula which guarantees no resource exhaustion</span>
+<span style="color: #177500">     * is:</span>
+<span style="color: #177500">     *     (num-subscribable-characteristics) * (max-connections + 1)</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">max_client_configs</span>;
+
+    <span style="color: #177500">/*** GATT client settings. */</span>
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * The maximum number of concurrent GATT client procedures.  When you</span>
+<span style="color: #177500">     * initiate a GATT procedure (e.g., read a characteristic, discover</span>
+<span style="color: #177500">     * services, etc.), one of these is consumed.  The resource is freed when</span>
+<span style="color: #177500">     * the procedure completes.</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">max_gattc_procs</span>;
+
+    <span style="color: #177500">/*** ATT server settings. */</span>
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * The total number of local ATT attributes.  Attributes are consumed at</span>
+<span style="color: #177500">     * service registration time and are never freed.  Attributes are used by</span>
+<span style="color: #177500">     * GATT server entities: services, characteristics, and descriptors</span>
+<span style="color: #177500">     * according to the following formula:</span>
+<span style="color: #177500">     *     (num-services + (num-characteristics * 2) + num-descriptors)</span>
+<span style="color: #177500">     *</span>
+<span style="color: #177500">     * Every characteristic that supports indications or notifications</span>
+<span style="color: #177500">     * automatically gets a descriptor.  All other descriptors are specified by</span>
+<span style="color: #177500">     * the application at service registration time.</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">max_attrs</span>;
+
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * A GATT server uses these when a peer performs a &quot;write long</span>
+<span style="color: #177500">     * characteristic values&quot; or &quot;write long characteristic descriptors&quot;</span>
+<span style="color: #177500">     * procedure.  One of these resources is consumed each time a peer sends a</span>
+<span style="color: #177500">     * partial write.  These procedures are not used often.</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">max_prep_entries</span>;
+
+    <span style="color: #177500">/*** L2CAP settings. */</span>
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * Each connection requires three L2CAP channels (signal, ATT, and security</span>
+<span style="color: #177500">     * manager).  In addition, the nimble host may allow channels to be created</span>
+<span style="color: #177500">     * &quot;on the fly&quot; (connection-oriented channels).  This functionality is not</span>
+<span style="color: #177500">     * available at the moment, so a safe formula to use is:</span>
+<span style="color: #177500">     *     (max-connections * 3)</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">max_l2cap_chans</span>;
+
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * The maximum number of concurrent L2CAP signalling procedures.  Only one</span>
+<span style="color: #177500">     * L2CAP signalling procedure is supported: slave-initiated connection</span>
+<span style="color: #177500">     * update.  You will never need more of these than the max number of</span>
+<span style="color: #177500">     * connections.</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">max_l2cap_sig_procs</span>;
+
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * The maximum number of concurrent security manager procedures.  Security</span>
+<span style="color: #177500">     * manager procedures include pairing and restoration of a bonded link.</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">max_l2cap_sm_procs</span>;
+
+    <span style="color: #177500">/*** Security manager settings. */</span>
+    <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">sm_io_cap</span>;
+    <span style="color: #A90D91">unsigned</span> <span style="color: #000000">sm_oob_data_flag</span>:<span style="color: #1C01CE">1</span>;
+    <span style="color: #A90D91">unsigned</span> <span style="color: #000000">sm_bonding</span>:<span style="color: #1C01CE">1</span>;
+    <span style="color: #A90D91">unsigned</span> <span style="color: #000000">sm_mitm</span>:<span style="color: #1C01CE">1</span>;
+    <span style="color: #A90D91">unsigned</span> <span style="color: #000000">sm_sc</span>:<span style="color: #1C01CE">1</span>;
+    <span style="color: #A90D91">unsigned</span> <span style="color: #000000">sm_keypress</span>:<span style="color: #1C01CE">1</span>;
+    <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">sm_our_key_dist</span>;
+    <span style="color: #A90D91">uint8_t</span> <span style="color: #000000">sm_their_key_dist</span>;
+
+    <span style="color: #177500">/*** Store settings. */</span>
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * These function callbacks handle persistence of sercurity material</span>
+<span style="color: #177500">     * (bonding).</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #000000">ble_store_read_fn</span> <span style="color: #000000">*store_read_cb</span>;
+    <span style="color: #000000">ble_store_write_fn</span> <span style="color: #000000">*store_write_cb</span>;
+    <span style="color: #000000">ble_store_delete_fn</span> <span style="color: #000000">*store_delete_cb</span>;
+
+    <span style="color: #177500">/*** privacy settings */</span>
+    <span style="color: #177500">/**</span>
+<span style="color: #177500">     * The frequency at which new resovlable private addresses are generated.</span>
+<span style="color: #177500">     * Units are seconds.</span>
+<span style="color: #177500">     */</span>
+    <span style="color: #A90D91">uint16_t</span> <span style="color: #000000">rpa_timeout</span>;
+};
+</pre></div>
+
+
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">extern</span> <span style="color: #A90D91">const</span> <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_hs_cfg</span> <span style="color: #000000">ble_hs_cfg_dflt</span>;
+</pre></div>
+                        
+                        <div class="row">
+                            
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+    <li>
+    
+    <a href=../../init/>
+        <span class="fa fa-arrow-left"></span>
+        Previous: Init and config
+    </a>
+    
+    </li>
+    <li class="pull-right">
+    
+    <a href=../../functions/ble_hs_init/>
+        Next: ble_hs_init
+        <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 &copy; 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/init/functions/ble_hs_init/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/init/functions/ble_hs_init/index.html b/develop/network/ble/ble_hs/init/functions/ble_hs_init/index.html
new file mode 100644
index 0000000..88b82cc
--- /dev/null
+++ b/develop/network/ble/ble_hs/init/functions/ble_hs_init/index.html
@@ -0,0 +1,610 @@
+<!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/init/functions/ble_hs_init/">
+        <link rel="shortcut icon" href="../../../../../../img/favicon.ico">
+
+	<title>ble_hs_init - 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_hs_init">
+
+
+        
+
+
+
+
+
+
+<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 and config</a>
+  
+  
+    <ul>
+          
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ../../definitions/init_defs/
+">Definitions</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ./
+">Functions</a>
+  
+  
+    <ul>
+          
+              
+                
+    <li class="active">
+      <a href="./">ble_hs_init</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../ble_hs_start/">ble_hs_start</a>
+    </li>
+
+              
+          
+    </ul>
+  
+    </li>
+
+              
+          
+    </ul>
+  
+    </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="../../../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>&raquo; <a href="../../init/">Init and config</a></li>
+        
+      
+        
+          <li>&raquo; Functions</li>
+        
+      
+      
+        <li>&raquo; ble_hs_init</li>
+      
+    
+    
+  </ul>
+</div>
+                            </div>
+                        </div>
+                        
+                            <h2 id="ble95hs95init"><font color="#F2853F" style="font-size:24pt">ble_hs_init</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">int</span>
+<span style="color: #000000">ble_hs_init</span>(<span style="color: #A90D91">struct</span> <span style="color: #000000">os_eventq</span> <span style="color: #000000">*app_evq</span>, <span style="color: #A90D91">struct</span> <span style="color: #000000">ble_hs_cfg</span> <span style="color: #000000">*cfg</span>)
+</pre></div>
+
+
+<h3 id="description">Description</h3>
+<p>Initializes the NimBLE host.  This function must be called before the OS is started.  The NimBLE stack requires an application task to function.  One application task in particular is designated as the "host parent task".  In addition to application-specific work, the host parent task does work for NimBLE by processing events generated by the host. </p>
+<h3 id="parameters">Parameters</h3>
+<table>
+<thead>
+<tr>
+<th><em>Parameter</em></th>
+<th><em>Description</em></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>app_evq</td>
+<td>The event queue associated with the host parent task.</td>
+</tr>
+<tr>
+<td>cfg</td>
+<td>The set of configuration settings to initialize the host with.  Specify null for defaults.</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><a href="../../../ble_hs_return_codes/#return-codes-core">BLE host core return code</a></td>
+<td>Unexpected error.</td>
+</tr>
+</tbody>
+</table>
+                        
+                        <div class="row">
+                            
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+    <li>
+    
+    <a href=../../definitions/init_defs/>
+        <span class="fa fa-arrow-left"></span>
+        Previous: Init and config definitions
+    </a>
+    
+    </li>
+    <li class="pull-right">
+    
+    <a href=../ble_hs_start/>
+        Next: ble_hs_start
+        <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 &copy; 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/init/functions/ble_hs_start/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/init/functions/ble_hs_start/index.html b/develop/network/ble/ble_hs/init/functions/ble_hs_start/index.html
new file mode 100644
index 0000000..18ac31f
--- /dev/null
+++ b/develop/network/ble/ble_hs/init/functions/ble_hs_start/index.html
@@ -0,0 +1,593 @@
+<!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/init/functions/ble_hs_start/">
+        <link rel="shortcut icon" href="../../../../../../img/favicon.ico">
+
+	<title>ble_hs_start - 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_hs_start">
+
+
+        
+
+
+
+
+
+
+<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 and config</a>
+  
+  
+    <ul>
+          
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ../../definitions/init_defs/
+">Definitions</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ../ble_hs_init/
+">Functions</a>
+  
+  
+    <ul>
+          
+              
+                
+    <li >
+      <a href="../ble_hs_init/">ble_hs_init</a>
+    </li>
+
+              
+          
+              
+                
+    <li class="active">
+      <a href="./">ble_hs_start</a>
+    </li>
+
+              
+          
+    </ul>
+  
+    </li>
+
+              
+          
+    </ul>
+  
+    </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="../../../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>&raquo; <a href="../../init/">Init and config</a></li>
+        
+      
+        
+          <li>&raquo; <a href="../ble_hs_init/">Functions</a></li>
+        
+      
+      
+        <li>&raquo; ble_hs_start</li>
+      
+    
+    
+  </ul>
+</div>
+                            </div>
+                        </div>
+                        
+                            <h2 id="ble95hs95start"><font color="#F2853F" style="font-size:24pt">ble_hs_start</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">int</span>
+<span style="color: #000000">ble_hs_start</span>(<span style="color: #A90D91">void</span>)
+</pre></div>
+
+
+<h3 id="description">Description</h3>
+<p>Synchronizes the host with the controller by sending a sequence of HCI commands.  This function must be called before any other host functionality is used, but it must be called after both the host and controller are initialized.  Typically, the host-parent-task calls this function at the top of its task routine. </p>
+<h3 id="parameters">Parameters</h3>
+<p>None</p>
+<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><a href="../../../ble_hs_return_codes/#return-codes-core">BLE host core return code</a></td>
+<td>Unexpected error.</td>
+</tr>
+</tbody>
+</table>
+                        
+                        <div class="row">
+                            
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+    <li>
+    
+    <a href=../ble_hs_init/>
+        <span class="fa fa-arrow-left"></span>
+        Previous: ble_hs_init
+    </a>
+    
+    </li>
+    <li class="pull-right">
+    
+    <a href=../../../ble_gap/ble_gap/>
+        Next: GAP
+        <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 &copy; 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/init/init/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/init/init/index.html b/develop/network/ble/ble_hs/init/init/index.html
new file mode 100644
index 0000000..8858f99
--- /dev/null
+++ b/develop/network/ble/ble_hs/init/init/index.html
@@ -0,0 +1,571 @@
+<!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/init/init/">
+        <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 class="active"><a href="./">Init and config</a>
+  
+  
+    <ul>
+          
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ../definitions/init_defs/
+">Definitions</a>
+  
+  
+    </li>
+
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ../functions/ble_hs_init/
+">Functions</a>
+  
+  
+    </li>
+
+              
+          
+    </ul>
+  
+    </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="../../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>&raquo; <a href="../../ble_hs/">NimBLE Host API</a></li>
+        
+      
+        
+          <li>&raquo; Init and config</li>
+        
+      
+      
+    
+    
+  </ul>
+</div>
+                            </div>
+                        </div>
+                        
+                            <h2 id="nimble-host-init-and-config-reference"><font color="F2853F" style="font-size:24pt">NimBLE Host Init and Config Reference</font></h2>
+<h3 id="introduction">Introduction</h3>
+<p>This section is a reference on initializing and configuring the NimBLE host.</p>
+<h3 id="header">Header</h3>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #633820">#include &quot;host/ble_hs.h&quot;</span>
+</pre></div>
+
+
+<h3 id="definitions">Definitions</h3>
+<p><a href="../definitions/init_defs/">BLE host init and config 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_hs_init/">ble_hs_init</a></td>
+<td>Initializes the NimBLE host.</td>
+</tr>
+<tr>
+<td><a href="../functions/ble_hs_start/">ble_hs_start</a></td>
+<td>Synchronizes the host with the controller by sending a sequence of HCI commands.</td>
+</tr>
+</tbody>
+</table>
+                        
+                        <div class="row">
+                            
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+    <li>
+    
+    <a href=../../ble_hs_return_codes/>
+        <span class="fa fa-arrow-left"></span>
+        Previous: Return codes
+    </a>
+    
+    </li>
+    <li class="pull-right">
+    
+    <a href=../definitions/init_defs/>
+        Next: Init and config 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 &copy; 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/other/functions/ble_eddystone_set_adv_data_uid/index.html
----------------------------------------------------------------------
diff --git a/develop/network/ble/ble_hs/other/functions/ble_eddystone_set_adv_data_uid/index.html b/develop/network/ble/ble_hs/other/functions/ble_eddystone_set_adv_data_uid/index.html
new file mode 100644
index 0000000..3fc3cbe
--- /dev/null
+++ b/develop/network/ble/ble_hs/other/functions/ble_eddystone_set_adv_data_uid/index.html
@@ -0,0 +1,629 @@
+<!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/other/functions/ble_eddystone_set_adv_data_uid/">
+        <link rel="shortcut icon" href="../../../../../../img/favicon.ico">
+
+	<title>ble_eddystone_set_adv_data_uid - 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_eddystone_set_adv_data_uid">
+
+
+        
+
+
+
+
+
+
+<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="../../other/">Other</a>
+  
+  
+    <ul>
+          
+              
+          
+              
+                
+  
+  
+    <li><a href="
+  ./
+">Functions</a>
+  
+  
+    <ul>
+          
+              
+                
+    <li class="active">
+      <a href="./">ble_eddystone_set_adv_data_uid</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../ble_uuid_16_to_128/">ble_uuid_16_to_128</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../ble_ibeacon_set_adv_data/">ble_ibeacon_set_adv_data</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../ble_eddystone_set_adv_data_url/">ble_eddystone_set_adv_data_url</a>
+    </li>
+
+              
+          
+              
+                
+    <li >
+      <a href="../ble_uuid_128_to_16/">ble_uuid_128_to_16</a>
+    </li>
+
+              
+          
+    </ul>
+  
+    </li>
+
+              
+          
+    </ul>
+  
+    </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>&raquo; <a href="../../other/">Other</a></li>
+        
+      
+        
+          <li>&raquo; Functions</li>
+        
+      
+      
+        <li>&raquo; ble_eddystone_set_adv_data_uid</li>
+      
+    
+    
+  </ul>
+</div>
+                            </div>
+                        </div>
+                        
+                            <h2 id="ble95eddystone95set95adv95data95uid"><font color="#F2853F" style="font-size:24pt">ble_eddystone_set_adv_data_uid</font></h2>
+<div class="codehilite" style="background: #ffffff"><pre style="line-height: 125%"><span style="color: #A90D91">int</span>
+<span style="color: #000000">ble_eddystone_set_adv_data_uid</span>(<span style="color: #A90D91">struct</span> <span style="color: #000000">ble_hs_adv_fields</span> <span style="color: #000000">*adv_fields</span>, <span style="color: #A90D91">void</span> <span style="color: #000000">*uid</span>)
+</pre></div>
+
+
+<h3 id="description">Description</h3>
+<p>Configures the device to advertise eddystone UID beacons. </p>
+<h3 id="parameters">Parameters</h3>
+<table>
+<thead>
+<tr>
+<th><em>Parameter</em></th>
+<th><em>Description</em></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>adv_fields</td>
+<td>The base advertisement fields to transform into an eddystone beacon.  All configured fields are preserved; you probably want to clear this struct before calling this function.</td>
+</tr>
+<tr>
+<td>uid</td>
+<td>The 16-byte UID to advertise.</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_EBUSY</td>
+<td>Advertising is in progress.</td>
+</tr>
+<tr>
+<td>BLE_HS_EMSGSIZE</td>
+<td>The specified data is too large to fit in an advertisement.</td>
+</tr>
+<tr>
+<td><a href="../../../ble_hs_return_codes/#return-codes-core">BLE host core return code</a></td>
+<td>Unexpected error.</td>
+</tr>
+</tbody>
+</table>
+                        
+                        <div class="row">
+                            
+
+
+
+<ul class="nav nav-pills" style="margin-bottom: 10px">
+    <li>
+    
+    <a href=../../other/>
+        <span class="fa fa-arrow-left"></span>
+        Previous: Other
+    </a>
+    
+    </li>
+    <li class="pull-right">
+    
+    <a href=../ble_uuid_16_to_128/>
+        Next: ble_uuid_16_to_128
+        <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 &copy; 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