From 0aae0472a57befc5cebbeafe07d3587cc6185d65 Mon Sep 17 00:00:00 2001
From: Jeffrey Yasskin <jyasskin@google.com>
Date: Thu, 2 Apr 2015 19:12:20 -0700
Subject: [PATCH 1/2] Add an example of using advertising data to read an
 iBeacon.

Working on #75.
---
 index.html | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/index.html b/index.html
index 15961b6..c734456 100644
--- a/index.html
+++ b/index.html
@@ -976,6 +976,34 @@ <h2><a>BluetoothDevice</a></h2>
         <section>
           <h2><a>BluetoothAdvertisingData</a></h2>
 
+          <aside class="example">
+            To retrieve a device and read the iBeacon data out of it,
+            a developer could use the following code.
+            Note that this API currently doesn't provide a way
+            to request devices with certain manufacturer data,
+            so the iBeacon will need to rotate its advertisements to include a known service
+            in order for users to select this device in the <code>requestDevice</code> dialog.
+
+            <pre class="highlight">var known_service = "A service in the iBeacon's GATT server";
+return navigator.bluetooth.requestDevice([{services: [known_service]}])
+.then(device => {
+  var rssi = device.adData.rssi;
+  var appleData = new DataView(device.adData.manufacturerData.get(0x004C));
+  if (appleData.getUint16(0, true) !== 0x1502) {
+    return {isBeacon: false};
+  }
+  var uuidArray = new Uint8Array(appleData.buffer, 2, 16);
+  var major = appleData.getUint16(18, false);
+  var minor = appleData.getUint16(20, false);
+  var txPowerAt1m = -appleData.getInt8(22);
+  return {isBeacon: true,
+          uuidArray,
+          major,
+          minor,
+          pathLossVs1m: txPowerAt1m - rssi};
+});</pre>
+          </aside>
+
           <p>
             To <dfn>create a <a>BluetoothAdvertisingData</a></dfn>
             from a <a>Bluetooth device</a> <var>device</var>

From 165651aeffd0ae90760782e53254ce2785d5ae46 Mon Sep 17 00:00:00 2001
From: Jeffrey Yasskin <jyasskin@google.com>
Date: Fri, 3 Apr 2015 11:49:15 -0700
Subject: [PATCH 2/2] Fix @scheib's comments.

---
 index.html | 67 +++++++++++++++++++++++++++++++-----------------------
 1 file changed, 39 insertions(+), 28 deletions(-)

diff --git a/index.html b/index.html
index c734456..c0ca0d0 100644
--- a/index.html
+++ b/index.html
@@ -976,34 +976,6 @@ <h2><a>BluetoothDevice</a></h2>
         <section>
           <h2><a>BluetoothAdvertisingData</a></h2>
 
-          <aside class="example">
-            To retrieve a device and read the iBeacon data out of it,
-            a developer could use the following code.
-            Note that this API currently doesn't provide a way
-            to request devices with certain manufacturer data,
-            so the iBeacon will need to rotate its advertisements to include a known service
-            in order for users to select this device in the <code>requestDevice</code> dialog.
-
-            <pre class="highlight">var known_service = "A service in the iBeacon's GATT server";
-return navigator.bluetooth.requestDevice([{services: [known_service]}])
-.then(device => {
-  var rssi = device.adData.rssi;
-  var appleData = new DataView(device.adData.manufacturerData.get(0x004C));
-  if (appleData.getUint16(0, true) !== 0x1502) {
-    return {isBeacon: false};
-  }
-  var uuidArray = new Uint8Array(appleData.buffer, 2, 16);
-  var major = appleData.getUint16(18, false);
-  var minor = appleData.getUint16(20, false);
-  var txPowerAt1m = -appleData.getInt8(22);
-  return {isBeacon: true,
-          uuidArray,
-          major,
-          minor,
-          pathLossVs1m: txPowerAt1m - rssi};
-});</pre>
-          </aside>
-
           <p>
             To <dfn>create a <a>BluetoothAdvertisingData</a></dfn>
             from a <a>Bluetooth device</a> <var>device</var>
@@ -1089,6 +1061,45 @@ <h2><a>BluetoothAdvertisingData</a></h2>
             <dt>readonly attribute Map serviceData</dt>
             <dd>Maps <a>UUID</a>s to <a>ArrayBuffer</a>s.</dd>
           </dl>
+
+          <aside class="example">
+            <p>
+              To retrieve a device and read the iBeacon data out of it,
+              a developer could use the following code.
+              Note that this API currently doesn't provide a way
+              to request devices with certain manufacturer data,
+              so the iBeacon will need to rotate its advertisements to include a known service
+              in order for users to select this device in the <code>requestDevice</code> dialog.
+            </p>
+
+            <pre class="highlight">var known_service = "A service in the iBeacon's GATT server";
+return navigator.bluetooth.requestDevice([{services: [known_service]}])
+.then(device => {
+  var rssi = device.adData.rssi;
+  var appleData = new DataView(device.adData.manufacturerData.get(<a
+               href="https://www.bluetooth.org/en-us/specification/assigned-numbers/company-identifiers"
+               title="Apple, Inc.'s Company Identifier">0x004C</a>));
+  if (appleData.byteLength != 23 ||
+      appleData.getUint16(0, false) !== 0x0215) {
+    return {isBeacon: false};
+  }
+  var uuidArray = new Uint8Array(appleData.buffer, 2, 16);
+  var major = appleData.getUint16(18, false);
+  var minor = appleData.getUint16(20, false);
+  var txPowerAt1m = -appleData.getInt8(22);
+  return {isBeacon: true,
+          uuidArray,
+          major,
+          minor,
+          pathLossVs1m: txPowerAt1m - rssi};
+});</pre>
+
+            <p>
+              The format of iBeacon advertisements was derived from
+              <a href="http://www.warski.org/blog/2014/01/how-ibeacons-work/">How do iBeacons work?</a>
+              by Adam Warski.
+            </p>
+          </aside>
         </section>
       </section>
     </section>