first commit

.gitignore

@@ -0,0 +1,3 @@
+node_modules
+platforms
+.vscode

README.md

@@ -0,0 +1,9 @@
+BLE Heart Rate Demo
+
+Connects to a peripherial providing the [Heart Rate Service](http://goo.gl/wKH3X7).
+
+Works with iOS or Android 4.3+.
+
+    $ cordova platform add android
+    $ cordova plugin add cordova-plugin-ble-central
+    $ cordova run

config.xml

@@ -0,0 +1,14 @@
+<?xml version='1.0' encoding='utf-8'?>
+<widget id="com.megster.example.hrm" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name>HeartRate</name>
+    <description>
+        BLE Heart Rate Monitor Demo
+    </description>
+    <author href="https://github.com/don">
+        Don Coleman
+    </author>
+    <content src="index.html" />
+    <access origin="*" />
+    <plugin name="cordova-plugin-ble-central" spec="~1.2.2" />
+    <engine name="android" spec="~7.1.4" />
+</widget>

hooks/README.md

@@ -0,0 +1,196 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Cordova Hooks
+
+Cordova Hooks represent special scripts which could be added by application and plugin developers or even by your own build system  to customize cordova commands. Hook scripts could be defined by adding them to the special predefined folder (`/hooks`) or via configuration files (`config.xml` and `plugin.xml`) and run serially in the following order: 
+* Application hooks from `/hooks`;
+* Application hooks from `config.xml`;
+* Plugin hooks from `plugins/.../plugin.xml`.
+
+__Remember__: Make your scripts executable.
+
+__Note__: `.cordova/hooks` directory is also supported for backward compatibility, but we don't recommend using it as it is deprecated.
+
+## Supported hook types
+The following hook types are supported:
+
+    after_build/
+    after_compile/
+    after_docs/
+    after_emulate/
+    after_platform_add/
+    after_platform_rm/
+    after_platform_ls/
+    after_plugin_add/
+    after_plugin_ls/
+    after_plugin_rm/
+    after_plugin_search/
+    after_plugin_install/   <-- Plugin hooks defined in plugin.xml are executed exclusively for a plugin being installed
+    after_prepare/
+    after_run/
+    after_serve/
+    before_build/
+    before_compile/
+    before_docs/
+    before_emulate/
+    before_platform_add/
+    before_platform_rm/
+    before_platform_ls/
+    before_plugin_add/
+    before_plugin_ls/
+    before_plugin_rm/
+    before_plugin_search/
+    before_plugin_install/   <-- Plugin hooks defined in plugin.xml are executed exclusively for a plugin being installed
+    before_plugin_uninstall/   <-- Plugin hooks defined in plugin.xml are executed exclusively for a plugin being uninstalled
+    before_prepare/
+    before_run/
+    before_serve/
+    pre_package/ <-- Windows 8 and Windows Phone only.
+
+## Ways to define hooks
+### Via '/hooks' directory
+To execute custom action when corresponding hook type is fired, use hook type as a name for a subfolder inside 'hooks' directory and place you script file here, for example:
+
+    # script file will be automatically executed after each build
+    hooks/after_build/after_build_custom_action.js
+
+
+### Config.xml
+
+Hooks can be defined in project's `config.xml` using `<hook>` elements, for example:
+
+    <hook type="before_build" src="scripts/appBeforeBuild.bat" />
+    <hook type="before_build" src="scripts/appBeforeBuild.js" />
+    <hook type="before_plugin_install" src="scripts/appBeforePluginInstall.js" />
+
+    <platform name="wp8">
+        <hook type="before_build" src="scripts/wp8/appWP8BeforeBuild.bat" />
+        <hook type="before_build" src="scripts/wp8/appWP8BeforeBuild.js" />
+        <hook type="before_plugin_install" src="scripts/wp8/appWP8BeforePluginInstall.js" />
+        ...
+    </platform>
+
+    <platform name="windows8">
+        <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.bat" />
+        <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.js" />
+        <hook type="before_plugin_install" src="scripts/windows8/appWin8BeforePluginInstall.js" />
+        ...
+    </platform>
+
+### Plugin hooks (plugin.xml)
+
+As a plugin developer you can define hook scripts using `<hook>` elements in a `plugin.xml` like that:
+
+    <hook type="before_plugin_install" src="scripts/beforeInstall.js" />
+    <hook type="after_build" src="scripts/afterBuild.js" />
+
+    <platform name="wp8">
+        <hook type="before_plugin_install" src="scripts/wp8BeforeInstall.js" />
+        <hook type="before_build" src="scripts/wp8BeforeBuild.js" />
+        ...
+    </platform>
+
+`before_plugin_install`, `after_plugin_install`, `before_plugin_uninstall` plugin hooks will be fired exclusively for the plugin being installed/uninstalled.
+
+## Script Interface
+
+### Javascript
+
+If you are writing hooks in Javascript you should use the following module definition:
+```javascript
+module.exports = function(context) {
+    ...
+}
+```
+
+You can make your scipts async using Q:
+```javascript
+module.exports = function(context) {
+    var Q = context.requireCordovaModule('q');
+    var deferral = new Q.defer();
+
+    setTimeout(function(){
+    	console.log('hook.js>> end');
+		deferral.resolve();
+    }, 1000);
+
+    return deferral.promise;
+}
+```
+
+`context` object contains hook type, executed script full path, hook options, command-line arguments passed to Cordova and top-level "cordova" object:
+```json
+{
+	"hook": "before_plugin_install",
+	"scriptLocation": "c:\\script\\full\\path\\appBeforePluginInstall.js",
+	"cmdLine": "The\\exact\\command\\cordova\\run\\with arguments",
+	"opts": {
+		"projectRoot":"C:\\path\\to\\the\\project",
+		"cordova": {
+			"platforms": ["wp8"],
+			"plugins": ["com.plugin.withhooks"],
+			"version": "0.21.7-dev"
+		},
+		"plugin": {
+			"id": "com.plugin.withhooks",
+			"pluginInfo": {
+				...
+			},
+			"platform": "wp8",
+			"dir": "C:\\path\\to\\the\\project\\plugins\\com.plugin.withhooks"
+		}
+	},
+	"cordova": {...}
+}
+
+```
+`context.opts.plugin` object will only be passed to plugin hooks scripts.
+
+You can also require additional Cordova modules in your script using `context.requireCordovaModule` in the following way:
+```javascript
+var Q = context.requireCordovaModule('q');
+```
+
+__Note__:  new module loader script interface is used for the `.js` files defined via `config.xml` or `plugin.xml` only. 
+For compatibility reasons hook files specified via `/hooks` folders are run via Node child_process spawn, see 'Non-javascript' section below.
+
+### Non-javascript
+
+Non-javascript scripts are run via Node child_process spawn from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables:
+
+* CORDOVA_VERSION - The version of the Cordova-CLI.
+* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios).
+* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer)
+* CORDOVA_HOOK - Path to the hook that is being executed.
+* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate)
+
+If a script returns a non-zero exit code, then the parent cordova command will be aborted.
+
+## Writing hooks
+
+We highly recommend writting your hooks using Node.js so that they are
+cross-platform. Some good examples are shown here:
+
+[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/)
+
+Also, note that even if you are working on Windows, and in case your hook scripts aren't bat files (which is recommended, if you want your scripts to work in non-Windows operating systems) Cordova CLI will expect a shebang line as the first line for it to know the interpreter it needs to use to launch the script. The shebang line should match the following example:
+
+    #!/usr/bin/env [name_of_interpreter_executable]

jsconfig.json

@@ -0,0 +1 @@
+{}

package-lock.json

@@ -0,0 +1,226 @@
+{
+  "requires": true,
+  "lockfileVersion": 1,
+  "dependencies": {
+    "cordova-android": {
+      "version": "7.1.4",
+      "resolved": "https://registry.npmjs.org/cordova-android/-/cordova-android-7.1.4.tgz",
+      "integrity": "sha512-Rtvu002I83uzfVyCsE6p2krFKVHt9TSAqZUATes+zH+o9cdxYGrLHY+PKCQo4SLCdSMdrkIHCDnQPTYTp/d7+g==",
+      "requires": {
+        "abbrev": "*",
+        "android-versions": "1.4.0",
+        "ansi": "*",
+        "balanced-match": "*",
+        "base64-js": "1.2.0",
+        "big-integer": "1.6.32",
+        "bplist-parser": "*",
+        "brace-expansion": "*",
+        "concat-map": "*",
+        "cordova-common": "2.2.5",
+        "cordova-registry-mapper": "*",
+        "elementtree": "0.1.6",
+        "glob": "5.0.15",
+        "inflight": "*",
+        "inherits": "*",
+        "minimatch": "*",
+        "nopt": "3.0.1",
+        "once": "*",
+        "path-is-absolute": "1.0.1",
+        "plist": "2.1.0",
+        "properties-parser": "0.2.3",
+        "q": "1.4.1",
+        "sax": "0.3.5",
+        "semver": "5.5.0",
+        "shelljs": "0.5.3",
+        "underscore": "*",
+        "unorm": "*",
+        "wrappy": "*",
+        "xmlbuilder": "8.2.2",
+        "xmldom": "*"
+      },
+      "dependencies": {
+        "abbrev": {
+          "version": "1.1.1",
+          "bundled": true
+        },
+        "android-versions": {
+          "version": "1.4.0",
+          "bundled": true,
+          "requires": {
+            "semver": "^5.4.1"
+          }
+        },
+        "ansi": {
+          "version": "0.3.1",
+          "bundled": true
+        },
+        "balanced-match": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "base64-js": {
+          "version": "1.2.0",
+          "bundled": true
+        },
+        "big-integer": {
+          "version": "1.6.32",
+          "bundled": true
+        },
+        "bplist-parser": {
+          "version": "0.1.1",
+          "bundled": true,
+          "requires": {
+            "big-integer": "^1.6.7"
+          }
+        },
+        "brace-expansion": {
+          "version": "1.1.11",
+          "bundled": true,
+          "requires": {
+            "balanced-match": "^1.0.0",
+            "concat-map": "0.0.1"
+          }
+        },
+        "concat-map": {
+          "version": "0.0.1",
+          "bundled": true
+        },
+        "cordova-common": {
+          "version": "2.2.5",
+          "bundled": true,
+          "requires": {
+            "ansi": "^0.3.1",
+            "bplist-parser": "^0.1.0",
+            "cordova-registry-mapper": "^1.1.8",
+            "elementtree": "0.1.6",
+            "glob": "^5.0.13",
+            "minimatch": "^3.0.0",
+            "plist": "^2.1.0",
+            "q": "^1.4.1",
+            "shelljs": "^0.5.3",
+            "underscore": "^1.8.3",
+            "unorm": "^1.3.3"
+          }
+        },
+        "cordova-registry-mapper": {
+          "version": "1.1.15",
+          "bundled": true
+        },
+        "elementtree": {
+          "version": "0.1.6",
+          "bundled": true,
+          "requires": {
+            "sax": "0.3.5"
+          }
+        },
+        "glob": {
+          "version": "5.0.15",
+          "bundled": true,
+          "requires": {
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "2 || 3",
+            "once": "^1.3.0",
+            "path-is-absolute": "^1.0.0"
+          }
+        },
+        "inflight": {
+          "version": "1.0.6",
+          "bundled": true,
+          "requires": {
+            "once": "^1.3.0",
+            "wrappy": "1"
+          }
+        },
+        "inherits": {
+          "version": "2.0.3",
+          "bundled": true
+        },
+        "minimatch": {
+          "version": "3.0.4",
+          "bundled": true,
+          "requires": {
+            "brace-expansion": "^1.1.7"
+          }
+        },
+        "nopt": {
+          "version": "3.0.1",
+          "bundled": true,
+          "requires": {
+            "abbrev": "1"
+          }
+        },
+        "once": {
+          "version": "1.4.0",
+          "bundled": true,
+          "requires": {
+            "wrappy": "1"
+          }
+        },
+        "path-is-absolute": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "plist": {
+          "version": "2.1.0",
+          "bundled": true,
+          "requires": {
+            "base64-js": "1.2.0",
+            "xmlbuilder": "8.2.2",
+            "xmldom": "0.1.x"
+          }
+        },
+        "properties-parser": {
+          "version": "0.2.3",
+          "bundled": true
+        },
+        "q": {
+          "version": "1.4.1",
+          "bundled": true
+        },
+        "sax": {
+          "version": "0.3.5",
+          "bundled": true
+        },
+        "semver": {
+          "version": "5.5.0",
+          "bundled": true
+        },
+        "shelljs": {
+          "version": "0.5.3",
+          "bundled": true
+        },
+        "underscore": {
+          "version": "1.9.1",
+          "bundled": true
+        },
+        "unorm": {
+          "version": "1.4.1",
+          "bundled": true
+        },
+        "wrappy": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "xmlbuilder": {
+          "version": "8.2.2",
+          "bundled": true
+        },
+        "xmldom": {
+          "version": "0.1.27",
+          "bundled": true
+        }
+      }
+    },
+    "cordova-plugin-ble-central": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/cordova-plugin-ble-central/-/cordova-plugin-ble-central-1.2.2.tgz",
+      "integrity": "sha512-81+BD9UQSp8Fuati9bPvKG/6lSGHHtw3JeLxQl8Q85ZS1n3GkSfA3DBMqKRjmOG6OVe4csR+XcO7cd75HMl6Qg=="
+    },
+    "cordova-plugin-compat": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/cordova-plugin-compat/-/cordova-plugin-compat-1.2.0.tgz",
+      "integrity": "sha1-C8ZXVyduvZIMASzpIOJ0F3V2Nz4="
+    }
+  }
+}

package.json

@@ -0,0 +1,13 @@
+{
+  "name": "com.megster.example.hrm",
+  "version": "0.0.1",
+  "displayName": "HeartRate",
+  "cordova": {
+    "platforms": [
+      "android"
+    ]
+  },
+  "dependencies": {
+    "cordova-android": "~7.1.4"
+  }
+}

plugins/android.json

@@ -0,0 +1,15 @@
+{
+  "prepare_queue": {
+    "installed": [],
+    "uninstalled": []
+  },
+  "config_munge": {
+    "files": {}
+  },
+  "installed_plugins": {
+    "cordova-plugin-ble-central": {
+      "PACKAGE_NAME": "com.megster.example.hrm"
+    }
+  },
+  "dependent_plugins": {}
+}

plugins/cordova-plugin-ble-central/CHANGES.txt

@@ -0,0 +1,170 @@
+= 1.2.2 =
+Remove lambda from Peripheral.java to maintain 1.6 source compatibility #602
+Remove showBluetoothSettings for iOS #603
+
+= 1.2.1 =
+Fix EXC_BAD_ACCESS on iOS #389 Thanks claudiovolpato
+Return error if bad device id is passed to disconnect #410
+Better error message when location permission is denied Android #218
+Scan returns an error if location services are disabled Android #527
+Improve autoconnect for iOS #599
+add ble.refreshDeviceCache (Android) #587 Thanks Domvel
+add ble.bondedDevices (Android)
+add ble.connectedPeripheralsWithServices and ble.peripheralsWithIdentifiers (iOS)
+
+= 1.2.0 =
+Added un-scanned Peripheral concept on Android #560 Thanks doug-a-brunner
+Fixed failure to fire callbacks on Android when read or write in flight #561 Thanks doug-a-brunner
+Fixed dangling promises when reconnecting Android #562 Thanks doug-a-brunner
+Added error when starting a scan while another is running Android #565 Thanks doug-a-brunner
+Request MTU Size on Android #568 Thanks Domvel and Algoritma
+Don't prompt user to enable Bluetooth on iOS CBCentralManagerOptionShowPowerAlertKey #580 #174 Thanks H0rst and cairinmichie
+Implement showBluetoothSettings on iOS #591 Thanks cairinmichie
+Improve disconnect logic on Android #582
+
+= 1.1.9 =
+iOS error #558
+
+= 1.1.8 =
+Fix merge conflicts
+
+= 1.1.7 =
+Use same characteristic uuid with different service in iOS #349 Thanks Riccardo Degan (riccardodegan-geekcups)
+ble.read() example #346 Thanks Kelton Temby (ktemby)
+Remove pending stopNotificationCallback for iOS #355 Thanks Georges-Etienne Legendre (legege)
+add missing `resolve` and `reject` callbacks to Promise wrapper #360 Thanks Audrius Jakumavicius
+(aj-dev)
+Fix documentation typo #371 Thanks keanyc
+Fix documentation typo #424 Thanks ChanHyuk-Im
+Fix duplicate symbol when using with with cordova-plugin-ble-peripheral #373 Thanks Luca Torella (lucatorella)
+Add admonition about using with beacons #413 Hugh Barnes (hughbris)
+Handle errors in didUpdateValueForCharacteristic #385 Thanks soyelporras
+Fix spelling error in Android code # Thanks doug-a-brunner
+cordova-plugin-compat deprecated #466 #483 thanks ddugue
+Fix NullPointer exception on scan #504
+Fixed deprecated iOS CBPeripheral RSSI calls and build warning #446 Thanks doug-a-brunner
+Trapped commands that caused iOS API misuse warnings #450 Thanks doug-a-brunner
+Fire callbacks on iOS when device is disconnecting #451 Thanks doug-a-brunner
+Fixed NSInvalidArgumentException when 'undefined' passed to plugin cmds #452 Thanks doug-a-brunner
+Better errors on Android, when trying to read or write to a non-existing service #486 Thanks ddugue
+Add autoConnect support #499 Thanks hypersolution1
+
+= 1.1.4 =
+Prevents scan from removing connecting Peripherals on Android #315 & #341 Thanks mebrunet
+Documentation fixes #330 Thanks motla
+Documenation clarification about Location Services #318 Thanks petrometro
+Ensure peripheral is connected for startNotification and stopNotification on Android #343
+Error message for Android 4.3 devices that don't support BLE #263 Thanks PeacePan
+Must call scan before connect. Update documentation #340
+
+= 1.1.3 =
+NSBluetoothPeripheralUsageDescription #324 Thanks Tim Kim
+
+= 1.1.2 =
+Call connect failure callback for peripheral if user disables Bluetooth #264
+Fix iOS problem with multiple keys in service data #288 Thanks Lebbeous Fogle-Weekley
+Add errorMessage to JSON object that is returned (to connect failure callback) when a peripheral disconnects
+Call gatt.disconnect() before gatt.close() to get problematic devices to disconnect #221, #254, #214
+Include version of JavaScript API with promises #247 Thanks Kelly Campbell
+stopNotification on Android writes DISABLE_NOTIFICATION_VALUE to the descriptor #225 Thanks zjw1918
+
+= 1.1.1 =
+Update advertising data in peripheral while scanning (Android) #253
+
+= 1.1.0 =
+Add documentation about receiving notifications in the background on iOS #169
+Add option to report duplicates during scan #172 Thanks Chris Armstrong
+Read RSSI value from an active BLE connection #171 Thanks Chris Armstrong
+Register for callbacks on Bluetooth state change #136 Thanks Ryan Harvey
+Fix example for write characteristic #195 Thanks Wynout van der Veer
+Fix documentation for write & writeWithoutResponse #193 Thanks Blake Parkinson
+Update CC2650 example #200 Thanks jplourenco
+Connect peripheral with missing ble-flag (Android SDK 23) #226 Thanks PeacePan
+
+= 1.0.6 =
+Fix compile error with Cordova 5.x #219
+
+= 1.0.5 =
+Request Permissions for Android 6.0 (API level 23) #182
+Update documentation for isEnabled #170
+
+= 1.0.4 =
+Fix compile error with ios@4.0.1 #161
+
+= 1.0.3 =
+Don't block UI thread on Android when starting scan #121 Thanks Kelly Campbell
+Return characteristic even if properties don't match #132 #113 Thanks kanayo
+StopNotification for Android fixes #51
+Fix conflicts with the BluetoothSerial plugin #114
+
+= 1.0.2 =
+Update plugin id for examples
+Fix npm keywords
+
+= 1.0.1 =
+Handle services that reuse UUIDs across characteristics #82 #94 Thanks ggordan
+Disconnect cancels pending connections on iOS #93 Thanks rrharvey
+Add dummy browser platform implementation for better PhoneGap developer app support #87 #90 Thanks surajpindoria
+Replace notify in examples with startNotification #63
+Stop notification from stacking on Android #71 Thanks charlesalton
+Connect failure callback returns the peripheral #16
+Better log message for unsupported iOS hardware #60
+Update bluefruitle example to work with new versions of the hardware
+
+= 1.0.0 =
+Change plugin id cordova-plugin-ble-central
+Move to NPM #86
+iOS 9 #62 Thanks Khashayar Pourdeilami
+
+= 0.1.9 =
+Add start of WP8 for PGDA
+
+= 0.1.8 =
+Remove SDK version from config.xml (user is responsible for adding)
+Add tests for plugin
+Fix BluetoothLE example for Adafruit nRF8001 #57
+
+= 0.1.7 =
+Add showBluetoothSettings and enable for Android #43
+Update documentation about UUIDs #38
+
+= 0.1.6 =
+startNotification handles both notifications and indications
+
+= 0.1.5 =
+add startScan and stopScan #40
+update to RFduino example
+
+= 0.1.4 =
+Change Android behavior for leScan without service list
+
+= 0.1.3 =
+Remove NO_RESULT on iOS fixes #32
+
+= 0.1.2 =
+Ensure connect success callback is only called 1x on iOS #30
+Rename notify to startNotification
+Add stopNotification (iOS only)
+
+= 0.1.1 =
+Return reason code when write fails on iOS #29
+
+= 0.1.0 =
+Return advertising data in scan results #6, #7, #18
+Connect success returns service, characteristic and descriptor info #6
+iOS connectCallbackId is stored in Peripheral #17
+Move plugin directory to top level for phonegap build compatibility #20
+Rename writeCommand to writeWithoutResponse #21
+Services callback latch is per peripheral  #19
+Connect callback is per peripheral #17
+Fix iOS crash when scanning 2x #5
+Add ble.isEnabled method #11
+Add RedBearLab example
+Add BatteryService example
+
+= 0.0.2 =
+iOS - fix bug read callback was being called 2x
+iOS - fix bug write callback wasn't being called
+
+= 0.0.1 =
+initial release

plugins/cordova-plugin-ble-central/LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2014-2016 Don Coleman
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

plugins/cordova-plugin-ble-central/examples/battery/README.md

@@ -0,0 +1,16 @@
+## Battery
+
+Read the Battery Level from the [Battery Service 0x180](https://developer.bluetooth.org/gatt/services/Pages/ServiceViewer.aspx?u=org.bluetooth.service.battery_service.xml)
+
+ * Read Battery Level
+
+Hardware
+
+ * Any peripheral with Battery Service
+
+Install
+
+    $ cordova platform add android ios
+    $ cordova plugin add cordova-plugin-ble-central
+    $ cordova run
+    

plugins/cordova-plugin-ble-central/examples/battery/config.xml

@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8'?>
+<widget id="com.megster.battery" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name>Battery Test</name>
+    <description>
+        Cordova Bluetooth Plugin to read Battery Service
+    </description>
+    <author href="https://github.com/don">
+           Don Coleman
+    </author>
+    <content src="index.html" />
+    <access origin="*" />
+    <preference name="orientation" value="portrait" />
+</widget>

plugins/cordova-plugin-ble-central/examples/battery/hooks/README.md

@@ -0,0 +1,83 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Cordova Hooks
+
+This directory may contain scripts used to customize cordova commands. This
+directory used to exist at `.cordova/hooks`, but has now been moved to the
+project root. Any scripts you add to these directories will be executed before
+and after the commands corresponding to the directory name. Useful for
+integrating your own build systems or integrating with version control systems.
+
+__Remember__: Make your scripts executable.
+
+## Hook Directories
+The following subdirectories will be used for hooks:
+
+    after_build/
+    after_compile/
+    after_docs/
+    after_emulate/
+    after_platform_add/
+    after_platform_rm/
+    after_platform_ls/
+    after_plugin_add/
+    after_plugin_ls/
+    after_plugin_rm/
+    after_plugin_search/
+    after_prepare/
+    after_run/
+    after_serve/
+    before_build/
+    before_compile/
+    before_docs/
+    before_emulate/
+    before_platform_add/
+    before_platform_rm/
+    before_platform_ls/
+    before_plugin_add/
+    before_plugin_ls/
+    before_plugin_rm/
+    before_plugin_search/
+    before_prepare/
+    before_run/
+    before_serve/
+    pre_package/ <-- Windows 8 and Windows Phone only.
+
+## Script Interface
+
+All scripts are run from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables:
+
+* CORDOVA_VERSION - The version of the Cordova-CLI.
+* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios).
+* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer)
+* CORDOVA_HOOK - Path to the hook that is being executed.
+* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate)
+
+If a script returns a non-zero exit code, then the parent cordova command will be aborted.
+
+
+## Writing hooks
+
+We highly recommend writting your hooks using Node.js so that they are
+cross-platform. Some good examples are shown here:
+
+[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/)
+

plugins/cordova-plugin-ble-central/examples/battery/www/css/index.css

@@ -0,0 +1,61 @@
+body {
+    font-family: "Helvetica Neue";
+    font-weight: lighter;
+    color: #2a2a2a;
+    background-color: #f0f0ff;
+    
+    -webkit-appearance: none;  
+    -webkit-touch-callout: none;
+    -webkit-tap-highlight-color: rgba(0,0,0,0); 
+    
+    -webkit-touch-callout: none; -webkit-user-select: none;
+}
+
+h1 {
+    text-align: center;
+}
+
+button {
+    margin: 15px;
+    -webkit-appearance:none;    
+    font-size: 1.2em;
+}
+
+#mainPage {
+    text-align:center;
+}
+
+#detailPage {
+    text-align:center;
+    font-size: 2em;
+}
+
+#detailPage div {
+    margin: 20px;
+}
+
+#detailPage button {
+    margin-top: 40px;
+    font-size: 0.6em; /* undo 2em from parent */
+}
+
+ul {
+    list-style: none;
+    border-bottom: 1px solid #d3d3d3;    
+    text-align: left;
+}
+
+li {
+    margin-left: -40px;
+    padding: 5px;        
+    padding-top: 10px;
+    min-height: 50px;
+    border-top: 1px solid #d3d3d3;    
+    font-size: 0.9em;
+}
+
+button {
+    -webkit-appearance: none;
+    font-size: 1.5em;
+    border-radius: 0;
+}

plugins/cordova-plugin-ble-central/examples/battery/www/index.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta name="format-detection" content="telephone=no" />
+        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1" />
+
+        <link rel="stylesheet" type="text/css" href="css/index.css" />
+        <title>SensorTag</title>
+    </head>
+    <body>
+        <div class="app">
+            <p style="text-align:center; padding-top: 20px;">Choose a peripheral with a battery service</p>
+            <div id="mainPage">
+                <ul id="deviceList">
+                </ul>
+                <button id="refreshButton">Refresh</button>
+            </div>
+            <div id="detailPage">
+                <div id="batteryState"></div>
+                <button id="batteryStateButton">Read Battery State</button>
+                <button id="disconnectButton">Disconnect</button>
+            </div>
+        </div>
+        <script type="text/javascript" src="cordova.js"></script>
+        <script type="text/javascript" src="js/index.js"></script>
+        <script type="text/javascript">
+            app.initialize();
+        </script>
+    </body>
+</html>

plugins/cordova-plugin-ble-central/examples/battery/www/js/index.js

@@ -0,0 +1,105 @@
+// (c) 2014 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global mainPage, deviceList, refreshButton */
+/* global detailPage, batteryState, batteryStateButton, disconnectButton */
+/* global ble  */
+/* jshint browser: true , devel: true*/
+'use strict';
+
+var battery = {
+    service: "180F",
+    level: "2A19"
+};
+
+var app = {
+    initialize: function() {
+        this.bindEvents();
+        detailPage.hidden = true;
+    },
+    bindEvents: function() {
+        document.addEventListener('deviceready', this.onDeviceReady, false);
+        refreshButton.addEventListener('touchstart', this.refreshDeviceList, false);
+        batteryStateButton.addEventListener('touchstart', this.readBatteryState, false);
+        disconnectButton.addEventListener('touchstart', this.disconnect, false);
+        deviceList.addEventListener('touchstart', this.connect, false); // assume not scrolling
+    },
+    onDeviceReady: function() {
+        app.refreshDeviceList();
+    },
+    refreshDeviceList: function() {
+        deviceList.innerHTML = ''; // empties the list
+        // scan for all devices
+        ble.scan([], 5, app.onDiscoverDevice, app.onError);
+    },
+    onDiscoverDevice: function(device) {
+
+        console.log(JSON.stringify(device));
+        var listItem = document.createElement('li'),
+            html = '<b>' + device.name + '</b><br/>' +
+                'RSSI: ' + device.rssi + '&nbsp;|&nbsp;' +
+                device.id;
+
+        listItem.dataset.deviceId = device.id;  // TODO
+        listItem.innerHTML = html;
+        deviceList.appendChild(listItem);
+
+    },
+    connect: function(e) {
+        var deviceId = e.target.dataset.deviceId,
+            onConnect = function() {
+
+                // TODO check if we have the battery service
+                // TODO check if the battery service can notify us
+                //ble.startNotification(deviceId, battery.service, battery.level, app.onBatteryLevelChange, app.onError);
+                batteryStateButton.dataset.deviceId = deviceId;
+                disconnectButton.dataset.deviceId = deviceId;
+                app.showDetailPage();
+            };
+
+        ble.connect(deviceId, onConnect, app.onError);
+    },
+    onBatteryLevelChange: function(data) {
+        console.log(data);
+        var message;
+        var a = new Uint8Array(data);
+        batteryState.innerHTML = a[0];
+    },
+    readBatteryState: function(event) {
+        console.log("readBatteryState");
+        var deviceId = event.target.dataset.deviceId;
+        ble.read(deviceId, battery.service, battery.level, app.onReadBatteryLevel, app.onError);
+    },
+    onReadBatteryLevel: function(data) {
+        console.log(data);
+        var message;
+        var a = new Uint8Array(data);
+        batteryState.innerHTML = a[0];
+    },
+    disconnect: function(event) {
+        var deviceId = event.target.dataset.deviceId;
+        ble.disconnect(deviceId, app.showMainPage, app.onError);
+    },
+    showMainPage: function() {
+        mainPage.hidden = false;
+        detailPage.hidden = true;
+    },
+    showDetailPage: function() {
+        mainPage.hidden = true;
+        detailPage.hidden = false;
+    },
+    onError: function(reason) {
+        alert("ERROR: " + reason); // real apps should use notification.alert
+    }
+};

plugins/cordova-plugin-ble-central/examples/bluefruitle/README.md

@@ -0,0 +1,37 @@
+## Adafruit UART
+
+This example will connect to hardware running the Nordic UART service. Many of the Bluetooth LE products from Adafruit run the Nordic UART service. This example will also connect to the [Adafruit Bluefruit LE Friend](https://www.adafruit.com/products/2267), [puck.js](http://puckjs.com), or [BBC Micro:bit](http://microbit.org/) running [Espruino](http://www.espruino.com/).
+
+## Android
+
+	cordova platform add android
+	cordova run android --device
+
+NOTE: Some Android devices have trouble filtering by UUID when scanning. If your Android phone can't find your Bluetooth peripheral, try removing the service filter.
+
+Change 
+
+	ble.scan([bluefruit.serviceUUID], 5, app.onDiscoverDevice, app.onError);
+
+To 
+
+	ble.scan([], 5, app.onDiscoverDevice, app.onError);
+
+## iOS
+
+	cordova platform add ios
+	cordova run ios --device
+	
+Note: Sometimes Xcode can't deploy from the command line. If that happens, open BluefruitLE.xcworkspace and deploy to your phone using Xcode.
+
+    open platforms/ios/BluefruitLE.xcworkspace
+
+## Building a Peripheral
+
+If you have an Arduino Uno and [Adafruit's Bluefruit LE](http://www.adafruit.com/products/1697) breakout board. You can run the [callbackEcho sketch](https://github.com/adafruit/Adafruit_nRF8001/blob/master/examples/callbackEcho/callbackEcho.ino) and see [Adafruit's tutorial](https://learn.adafruit.com/getting-started-with-the-nrf8001-bluefruit-le-breakout/software-uart-service) for setting up the hardware and Arduino code.
+
+Hardware
+
+ * [Arduino](http://www.adafruit.com/products/50)
+ * [BluefruitLE](http://www.adafruit.com/products/1697)
+

plugins/cordova-plugin-ble-central/examples/bluefruitle/config.xml

@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8'?>
+<widget id="com.megster.bluefruitle" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name>BluefruitLE</name>
+    <description>
+        A sample Apache Cordova application connects to the Nordic UART Service.
+    </description>
+    <author href="http://github.com/don">
+        Don Coleman
+    </author>
+    <content src="index.html" />
+    <access origin="*" />
+    <plugin name="cordova-plugin-ble-central" spec="~1.1.4" />
+</widget>

plugins/cordova-plugin-ble-central/examples/bluefruitle/hooks/README.md

@@ -0,0 +1,83 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Cordova Hooks
+
+This directory may contain scripts used to customize cordova commands. This
+directory used to exist at `.cordova/hooks`, but has now been moved to the
+project root. Any scripts you add to these directories will be executed before
+and after the commands corresponding to the directory name. Useful for
+integrating your own build systems or integrating with version control systems.
+
+__Remember__: Make your scripts executable.
+
+## Hook Directories
+The following subdirectories will be used for hooks:
+
+    after_build/
+    after_compile/
+    after_docs/
+    after_emulate/
+    after_platform_add/
+    after_platform_rm/
+    after_platform_ls/
+    after_plugin_add/
+    after_plugin_ls/
+    after_plugin_rm/
+    after_plugin_search/
+    after_prepare/
+    after_run/
+    after_serve/
+    before_build/
+    before_compile/
+    before_docs/
+    before_emulate/
+    before_platform_add/
+    before_platform_rm/
+    before_platform_ls/
+    before_plugin_add/
+    before_plugin_ls/
+    before_plugin_rm/
+    before_plugin_search/
+    before_prepare/
+    before_run/
+    before_serve/
+    pre_package/ <-- Windows 8 and Windows Phone only.
+
+## Script Interface
+
+All scripts are run from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables:
+
+* CORDOVA_VERSION - The version of the Cordova-CLI.
+* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios).
+* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer)
+* CORDOVA_HOOK - Path to the hook that is being executed.
+* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate)
+
+If a script returns a non-zero exit code, then the parent cordova command will be aborted.
+
+
+## Writing hooks
+
+We highly recommend writting your hooks using Node.js so that they are
+cross-platform. Some good examples are shown here:
+
+[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/)
+

plugins/cordova-plugin-ble-central/examples/bluefruitle/www/css/index.css

@@ -0,0 +1,77 @@
+body {
+    font-family: "Helvetica Neue";
+    font-weight: lighter;
+    color: #2a2a2a;
+    background-color: #f0f0ff;
+    
+    -webkit-appearance: none;  
+    -webkit-touch-callout: none;
+    -webkit-tap-highlight-color: rgba(0,0,0,0); 
+    
+    -webkit-touch-callout: none; -webkit-user-select: none;
+}
+
+h1 {
+    text-align: center;
+}
+
+button {
+    margin: 15px;
+    -webkit-appearance:none;    
+    font-size: 1.2em;
+}
+
+/* TODO */
+input[type=range] {
+    width: 100%;
+}
+
+#mainPage {
+    text-align:center;
+}
+
+#detailPage {
+    text-align:center;
+    font-size: 2em;
+}
+
+#detailPage div {
+    margin: 20px;
+}
+
+#detailPage button {
+    margin-top: 40px;
+    font-size: 0.6em; /* undo 2em from parent */
+}
+
+ul {
+    list-style: none;
+    border-bottom: 1px solid #d3d3d3;    
+    text-align: left;
+}
+
+li {
+    margin-left: -40px;
+    padding: 5px;        
+    padding-top: 10px;
+    min-height: 50px;
+    border-top: 1px solid #d3d3d3;    
+    font-size: 0.9em;
+}
+
+button {
+    -webkit-appearance: none;
+    font-size: 1.5em;
+    border-radius: 0;
+}
+
+#resultDiv {
+    font: 16px "Source Sans", helvetica, arial, sans-serif;
+    font-weight: 200;
+    display: block;
+    -webkit-border-radius: 6px;
+    width: 100%;
+    height: 140px;
+    text-align: left;    
+    overflow: auto;
+}

plugins/cordova-plugin-ble-central/examples/bluefruitle/www/index.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta name="format-detection" content="telephone=no" />
+        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1,  target-densitydpi=device-dpi" />
+        
+        <link rel="stylesheet" type="text/css" href="css/index.css" />
+        <title>BluefruitLE</title>
+    </head>
+    <body>
+        <div class="app">
+            <h1>BluefruitLE</h1>
+            <div id="mainPage">
+                <ul id="deviceList">                    
+                </ul>
+                <button id="refreshButton">Refresh</button>
+            </div>
+            <div id="detailPage">
+                <div id="resultDiv"></div>
+                <div>
+                    <input type="text" id="messageInput" value="Hello"/>
+                    <button id="sendButton">Send</button>                    
+                </div>
+                <button id="disconnectButton">Disconnect</button>
+            </div>            
+        </div>
+        <script type="text/javascript" src="cordova.js"></script>
+        <script type="text/javascript" src="js/index.js"></script>
+        <script type="text/javascript">
+            app.initialize();
+        </script>
+    </body>
+</html>

plugins/cordova-plugin-ble-central/examples/bluefruitle/www/js/index.js

@@ -0,0 +1,158 @@
+// (c) 2014 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global mainPage, deviceList, refreshButton */
+/* global detailPage, resultDiv, messageInput, sendButton, disconnectButton */
+/* global ble  */
+/* jshint browser: true , devel: true*/
+'use strict';
+
+// ASCII only
+function bytesToString(buffer) {
+    return String.fromCharCode.apply(null, new Uint8Array(buffer));
+}
+
+// ASCII only
+function stringToBytes(string) {
+    var array = new Uint8Array(string.length);
+    for (var i = 0, l = string.length; i < l; i++) {
+        array[i] = string.charCodeAt(i);
+    }
+    return array.buffer;
+}
+
+// this is Nordic's UART service
+var bluefruit = {
+    serviceUUID: '6e400001-b5a3-f393-e0a9-e50e24dcca9e',
+    txCharacteristic: '6e400002-b5a3-f393-e0a9-e50e24dcca9e', // transmit is from the phone's perspective
+    rxCharacteristic: '6e400003-b5a3-f393-e0a9-e50e24dcca9e'  // receive is from the phone's perspective
+};
+
+var app = {
+    initialize: function() {
+        this.bindEvents();
+        detailPage.hidden = true;
+    },
+    bindEvents: function() {
+        document.addEventListener('deviceready', this.onDeviceReady, false);
+        refreshButton.addEventListener('touchstart', this.refreshDeviceList, false);
+        sendButton.addEventListener('click', this.sendData, false);
+        disconnectButton.addEventListener('touchstart', this.disconnect, false);
+        deviceList.addEventListener('touchstart', this.connect, false); // assume not scrolling
+    },
+    onDeviceReady: function() {
+        app.refreshDeviceList();
+    },
+    refreshDeviceList: function() {
+        deviceList.innerHTML = ''; // empties the list
+        ble.scan([bluefruit.serviceUUID], 5, app.onDiscoverDevice, app.onError);
+        
+        // if Android can't find your device try scanning for all devices
+        // ble.scan([], 5, app.onDiscoverDevice, app.onError);
+    },
+    onDiscoverDevice: function(device) {
+        var listItem = document.createElement('li'),
+            html = '<b>' + device.name + '</b><br/>' +
+                'RSSI: ' + device.rssi + '&nbsp;|&nbsp;' +
+                device.id;
+
+        listItem.dataset.deviceId = device.id;
+        listItem.innerHTML = html;
+        deviceList.appendChild(listItem);
+    },
+    connect: function(e) {
+        var deviceId = e.target.dataset.deviceId,
+            onConnect = function(peripheral) {
+                app.determineWriteType(peripheral);
+
+                // subscribe for incoming data
+                ble.startNotification(deviceId, bluefruit.serviceUUID, bluefruit.rxCharacteristic, app.onData, app.onError);
+                sendButton.dataset.deviceId = deviceId;
+                disconnectButton.dataset.deviceId = deviceId;
+                resultDiv.innerHTML = "";
+                app.showDetailPage();
+            };
+
+        ble.connect(deviceId, onConnect, app.onError);
+    },
+    determineWriteType: function(peripheral) {
+        // Adafruit nRF8001 breakout uses WriteWithoutResponse for the TX characteristic
+        // Newer Bluefruit devices use Write Request for the TX characteristic
+
+        var characteristic = peripheral.characteristics.filter(function(element) {
+            if (element.characteristic.toLowerCase() === bluefruit.txCharacteristic) {
+                return element;
+            }
+        })[0];
+
+        if (characteristic.properties.indexOf('WriteWithoutResponse') > -1) {
+            app.writeWithoutResponse = true;
+        } else {
+            app.writeWithoutResponse = false;
+        }
+
+    },
+    onData: function(data) { // data received from Arduino
+        console.log(data);
+        resultDiv.innerHTML = resultDiv.innerHTML + "Received: " + bytesToString(data) + "<br/>";
+        resultDiv.scrollTop = resultDiv.scrollHeight;
+    },
+    sendData: function(event) { // send data to Arduino
+
+        var success = function() {
+            console.log("success");
+            resultDiv.innerHTML = resultDiv.innerHTML + "Sent: " + messageInput.value + "<br/>";
+            resultDiv.scrollTop = resultDiv.scrollHeight;
+        };
+
+        var failure = function() {
+            alert("Failed writing data to the bluefruit le");
+        };
+
+        var data = stringToBytes(messageInput.value);
+        var deviceId = event.target.dataset.deviceId;
+
+        if (app.writeWithoutResponse) {
+            ble.writeWithoutResponse(
+                deviceId,
+                bluefruit.serviceUUID,
+                bluefruit.txCharacteristic,
+                data, success, failure
+            );
+        } else {
+            ble.write(
+                deviceId,
+                bluefruit.serviceUUID,
+                bluefruit.txCharacteristic,
+                data, success, failure
+            );
+        }
+
+    },
+    disconnect: function(event) {
+        var deviceId = event.target.dataset.deviceId;
+        ble.disconnect(deviceId, app.showMainPage, app.onError);
+    },
+    showMainPage: function() {
+        mainPage.hidden = false;
+        detailPage.hidden = true;
+    },
+    showDetailPage: function() {
+        mainPage.hidden = true;
+        detailPage.hidden = false;
+    },
+    onError: function(reason) {
+        alert("ERROR: " + JSON.stringify(reason)); // real apps should use notification.alert
+    }
+};

plugins/cordova-plugin-ble-central/examples/heartrate/README.md

@@ -0,0 +1,9 @@
+BLE Heart Rate Demo
+
+Connects to a peripherial providing the [Heart Rate Service](http://goo.gl/wKH3X7).
+
+Works with iOS or Android 4.3+.
+
+    $ cordova platform add android
+    $ cordova plugin add cordova-plugin-ble-central
+    $ cordova run

plugins/cordova-plugin-ble-central/examples/heartrate/config.xml

@@ -0,0 +1,12 @@
+<?xml version='1.0' encoding='utf-8'?>
+<widget id="com.megster.example.hrm" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name>HeartRate</name>
+    <description>
+        BLE Heart Rate Monitor Demo
+    </description>
+    <author href="https://github.com/don">
+        Don Coleman
+    </author>
+    <content src="index.html" />
+    <access origin="*" />
+</widget>

plugins/cordova-plugin-ble-central/examples/heartrate/hooks/README.md

@@ -0,0 +1,196 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Cordova Hooks
+
+Cordova Hooks represent special scripts which could be added by application and plugin developers or even by your own build system  to customize cordova commands. Hook scripts could be defined by adding them to the special predefined folder (`/hooks`) or via configuration files (`config.xml` and `plugin.xml`) and run serially in the following order: 
+* Application hooks from `/hooks`;
+* Application hooks from `config.xml`;
+* Plugin hooks from `plugins/.../plugin.xml`.
+
+__Remember__: Make your scripts executable.
+
+__Note__: `.cordova/hooks` directory is also supported for backward compatibility, but we don't recommend using it as it is deprecated.
+
+## Supported hook types
+The following hook types are supported:
+
+    after_build/
+    after_compile/
+    after_docs/
+    after_emulate/
+    after_platform_add/
+    after_platform_rm/
+    after_platform_ls/
+    after_plugin_add/
+    after_plugin_ls/
+    after_plugin_rm/
+    after_plugin_search/
+    after_plugin_install/   <-- Plugin hooks defined in plugin.xml are executed exclusively for a plugin being installed
+    after_prepare/
+    after_run/
+    after_serve/
+    before_build/
+    before_compile/
+    before_docs/
+    before_emulate/
+    before_platform_add/
+    before_platform_rm/
+    before_platform_ls/
+    before_plugin_add/
+    before_plugin_ls/
+    before_plugin_rm/
+    before_plugin_search/
+    before_plugin_install/   <-- Plugin hooks defined in plugin.xml are executed exclusively for a plugin being installed
+    before_plugin_uninstall/   <-- Plugin hooks defined in plugin.xml are executed exclusively for a plugin being uninstalled
+    before_prepare/
+    before_run/
+    before_serve/
+    pre_package/ <-- Windows 8 and Windows Phone only.
+
+## Ways to define hooks
+### Via '/hooks' directory
+To execute custom action when corresponding hook type is fired, use hook type as a name for a subfolder inside 'hooks' directory and place you script file here, for example:
+
+    # script file will be automatically executed after each build
+    hooks/after_build/after_build_custom_action.js
+
+
+### Config.xml
+
+Hooks can be defined in project's `config.xml` using `<hook>` elements, for example:
+
+    <hook type="before_build" src="scripts/appBeforeBuild.bat" />
+    <hook type="before_build" src="scripts/appBeforeBuild.js" />
+    <hook type="before_plugin_install" src="scripts/appBeforePluginInstall.js" />
+
+    <platform name="wp8">
+        <hook type="before_build" src="scripts/wp8/appWP8BeforeBuild.bat" />
+        <hook type="before_build" src="scripts/wp8/appWP8BeforeBuild.js" />
+        <hook type="before_plugin_install" src="scripts/wp8/appWP8BeforePluginInstall.js" />
+        ...
+    </platform>
+
+    <platform name="windows8">
+        <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.bat" />
+        <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.js" />
+        <hook type="before_plugin_install" src="scripts/windows8/appWin8BeforePluginInstall.js" />
+        ...
+    </platform>
+
+### Plugin hooks (plugin.xml)
+
+As a plugin developer you can define hook scripts using `<hook>` elements in a `plugin.xml` like that:
+
+    <hook type="before_plugin_install" src="scripts/beforeInstall.js" />
+    <hook type="after_build" src="scripts/afterBuild.js" />
+
+    <platform name="wp8">
+        <hook type="before_plugin_install" src="scripts/wp8BeforeInstall.js" />
+        <hook type="before_build" src="scripts/wp8BeforeBuild.js" />
+        ...
+    </platform>
+
+`before_plugin_install`, `after_plugin_install`, `before_plugin_uninstall` plugin hooks will be fired exclusively for the plugin being installed/uninstalled.
+
+## Script Interface
+
+### Javascript
+
+If you are writing hooks in Javascript you should use the following module definition:
+```javascript
+module.exports = function(context) {
+    ...
+}
+```
+
+You can make your scipts async using Q:
+```javascript
+module.exports = function(context) {
+    var Q = context.requireCordovaModule('q');
+    var deferral = new Q.defer();
+
+    setTimeout(function(){
+    	console.log('hook.js>> end');
+		deferral.resolve();
+    }, 1000);
+
+    return deferral.promise;
+}
+```
+
+`context` object contains hook type, executed script full path, hook options, command-line arguments passed to Cordova and top-level "cordova" object:
+```json
+{
+	"hook": "before_plugin_install",
+	"scriptLocation": "c:\\script\\full\\path\\appBeforePluginInstall.js",
+	"cmdLine": "The\\exact\\command\\cordova\\run\\with arguments",
+	"opts": {
+		"projectRoot":"C:\\path\\to\\the\\project",
+		"cordova": {
+			"platforms": ["wp8"],
+			"plugins": ["com.plugin.withhooks"],
+			"version": "0.21.7-dev"
+		},
+		"plugin": {
+			"id": "com.plugin.withhooks",
+			"pluginInfo": {
+				...
+			},
+			"platform": "wp8",
+			"dir": "C:\\path\\to\\the\\project\\plugins\\com.plugin.withhooks"
+		}
+	},
+	"cordova": {...}
+}
+
+```
+`context.opts.plugin` object will only be passed to plugin hooks scripts.
+
+You can also require additional Cordova modules in your script using `context.requireCordovaModule` in the following way:
+```javascript
+var Q = context.requireCordovaModule('q');
+```
+
+__Note__:  new module loader script interface is used for the `.js` files defined via `config.xml` or `plugin.xml` only. 
+For compatibility reasons hook files specified via `/hooks` folders are run via Node child_process spawn, see 'Non-javascript' section below.
+
+### Non-javascript
+
+Non-javascript scripts are run via Node child_process spawn from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables:
+
+* CORDOVA_VERSION - The version of the Cordova-CLI.
+* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios).
+* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer)
+* CORDOVA_HOOK - Path to the hook that is being executed.
+* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate)
+
+If a script returns a non-zero exit code, then the parent cordova command will be aborted.
+
+## Writing hooks
+
+We highly recommend writting your hooks using Node.js so that they are
+cross-platform. Some good examples are shown here:
+
+[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/)
+
+Also, note that even if you are working on Windows, and in case your hook scripts aren't bat files (which is recommended, if you want your scripts to work in non-Windows operating systems) Cordova CLI will expect a shebang line as the first line for it to know the interpreter it needs to use to launch the script. The shebang line should match the following example:
+
+    #!/usr/bin/env [name_of_interpreter_executable]

plugins/cordova-plugin-ble-central/examples/heartrate/www/css/index.css

@@ -0,0 +1,27 @@
+* {
+    -webkit-tap-highlight-color: rgba(0,0,0,0); /* make transparent link selection, adjust last value opacity 0 to 1.0 */
+}
+
+body {
+    -webkit-touch-callout: none;                /* prevent callout to copy image, etc when tap to hold */
+    -webkit-text-size-adjust: none;             /* prevent webkit from resizing text to fit */
+    -webkit-user-select: none;                  /* prevent copy paste, to allow, change 'none' to 'text' */
+    font-family:'HelveticaNeue-Light', 'HelveticaNeue', Helvetica, Arial, sans-serif;
+    height:100%;
+    margin:0px;
+    padding:0px;
+    width:100%;
+    text-align: center;
+}
+
+div {
+    padding: 20px;
+}
+
+h1 {
+    font-size:3em;
+}
+
+h2 {
+    font-size:2em;
+}

plugins/cordova-plugin-ble-central/examples/heartrate/www/index.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta name="format-detection" content="telephone=no" />
+        <meta name="msapplication-tap-highlight" content="no" />
+        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width, height=device-height, target-densitydpi=device-dpi" />
+        <link rel="stylesheet" type="text/css" href="css/index.css" />
+        <title>Heart Rate</title>
+    </head>
+    <body>
+        <div>
+            <h2>BLE Heart Rate Demo</h2>
+            <h1 id="beatsPerMinute">...</h1>
+            <div id="statusDiv"></div>
+        </div>
+        <script type="text/javascript" src="cordova.js"></script>
+        <script type="text/javascript" src="js/index.js"></script>
+    </body>
+</html>

plugins/cordova-plugin-ble-central/examples/heartrate/www/js/index.js

@@ -0,0 +1,83 @@
+// (c) 2015 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global ble, statusDiv, beatsPerMinute */
+/* jshint browser: true , devel: true*/
+
+// See BLE heart rate service http://goo.gl/wKH3X7
+var heartRate = {
+    service: '180d',
+    measurement: '2a37'
+};
+
+var app = {
+    initialize: function() {
+        this.bindEvents();
+    },
+    bindEvents: function() {
+        document.addEventListener('deviceready', this.onDeviceReady, false);
+    },
+    onDeviceReady: function() {
+        app.scan();
+    },
+    scan: function() {
+        app.status("Scanning for Heart Rate Monitor");
+
+        var foundHeartRateMonitor = false;
+
+        function onScan(peripheral) {
+            // this is demo code, assume there is only one heart rate monitor
+            console.log("Found " + JSON.stringify(peripheral));
+            foundHeartRateMonitor = true;
+
+            ble.connect(peripheral.id, app.onConnect, app.onDisconnect);
+        }
+
+        function scanFailure(reason) {
+            alert("BLE Scan Failed");
+        }
+
+        ble.scan([heartRate.service], 5, onScan, scanFailure);
+
+        setTimeout(function() {
+            if (!foundHeartRateMonitor) {
+                app.status("Did not find a heart rate monitor.");
+            }
+        }, 5000);
+    },
+    onConnect: function(peripheral) {
+        app.status("Connected to " + peripheral.id);
+        ble.startNotification(peripheral.id, heartRate.service, heartRate.measurement, app.onData, app.onError);
+    },
+    onDisconnect: function(reason) {
+        alert("Disconnected " + reason);
+        beatsPerMinute.innerHTML = "...";
+        app.status("Disconnected");
+    },
+    onData: function(buffer) {
+        // assuming heart rate measurement is Uint8 format, real code should check the flags
+        // See the characteristic specs http://goo.gl/N7S5ZS
+        var data = new Uint8Array(buffer);
+        beatsPerMinute.innerHTML = data[1];
+    },
+    onError: function(reason) {
+        alert("There was an error " + reason);
+    },
+    status: function(message) {
+        console.log(message);
+        statusDiv.innerHTML = message;
+    }
+};
+
+app.initialize();

plugins/cordova-plugin-ble-central/examples/metawear/README.md

@@ -0,0 +1,18 @@
+## MetaWare
+
+Example using mbientlab's [MetaWare](http://mbientlab.com/product/).
+
+Read values from the button press on the MetaWear.
+
+Operate the Motor and Buzzer on the MetaWare.
+
+Hardware
+
+ * [MetaWare](http://mbientlab.com/product/)
+
+Install
+
+    $ cordova platform add android ios
+    $ cordova plugin add cordova-plugin-ble-central
+    $ cordova run
+

plugins/cordova-plugin-ble-central/examples/metawear/config.xml

@@ -0,0 +1,12 @@
+<?xml version='1.0' encoding='utf-8'?>
+<widget id="com.megster.metawear" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name>MetaWear</name>
+    <description>
+        A sample Apache Cordova application that connects to mbientlab's MetaWear.
+    </description>
+    <author href="https://github.com/don">
+        Don Coleman
+    </author>
+    <content src="index.html" />
+    <access origin="*" />
+</widget>

plugins/cordova-plugin-ble-central/examples/metawear/hooks/README.md

@@ -0,0 +1,83 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Cordova Hooks
+
+This directory may contain scripts used to customize cordova commands. This
+directory used to exist at `.cordova/hooks`, but has now been moved to the
+project root. Any scripts you add to these directories will be executed before
+and after the commands corresponding to the directory name. Useful for
+integrating your own build systems or integrating with version control systems.
+
+__Remember__: Make your scripts executable.
+
+## Hook Directories
+The following subdirectories will be used for hooks:
+
+    after_build/
+    after_compile/
+    after_docs/
+    after_emulate/
+    after_platform_add/
+    after_platform_rm/
+    after_platform_ls/
+    after_plugin_add/
+    after_plugin_ls/
+    after_plugin_rm/
+    after_plugin_search/
+    after_prepare/
+    after_run/
+    after_serve/
+    before_build/
+    before_compile/
+    before_docs/
+    before_emulate/
+    before_platform_add/
+    before_platform_rm/
+    before_platform_ls/
+    before_plugin_add/
+    before_plugin_ls/
+    before_plugin_rm/
+    before_plugin_search/
+    before_prepare/
+    before_run/
+    before_serve/
+    pre_package/ <-- Windows 8 and Windows Phone only.
+
+## Script Interface
+
+All scripts are run from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables:
+
+* CORDOVA_VERSION - The version of the Cordova-CLI.
+* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios).
+* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer)
+* CORDOVA_HOOK - Path to the hook that is being executed.
+* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate)
+
+If a script returns a non-zero exit code, then the parent cordova command will be aborted.
+
+
+## Writing hooks
+
+We highly recommend writting your hooks using Node.js so that they are
+cross-platform. Some good examples are shown here:
+
+[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/)
+

plugins/cordova-plugin-ble-central/examples/metawear/www/css/index.css

@@ -0,0 +1,95 @@
+body {
+    font-family: "Helvetica Neue";
+    font-weight: lighter;
+    color: #2a2a2a;
+    background-color: #f0f0ff;
+    
+    -webkit-appearance: none;  
+    -webkit-touch-callout: none;
+    -webkit-tap-highlight-color: rgba(0,0,0,0); 
+    
+    -webkit-touch-callout: none; -webkit-user-select: none;
+}
+
+h1 {
+    text-align: center;
+}
+
+button {
+    margin: 15px;
+    -webkit-appearance:none;    
+    font-size: 1.2em;
+}
+
+/* TODO */
+input[type=range] {
+    width: 100%;
+}
+
+#mainPage {
+    text-align:center;
+}
+
+#detailPage {
+    text-align:center;
+    font-size: 2em;
+}
+
+#detailPage div {
+    margin: 20px;
+}
+
+#detailPage button {
+    margin-top: 40px;
+    font-size: 0.6em; /* undo 2em from parent */
+}
+
+ul {
+    list-style: none;
+    border-bottom: 1px solid #d3d3d3;    
+    text-align: left;
+}
+
+li {
+    margin-left: -40px;
+    padding: 5px;        
+    padding-top: 10px;
+    min-height: 50px;
+    border-top: 1px solid #d3d3d3;    
+    font-size: 0.9em;
+}
+
+button {
+    -webkit-appearance: none;
+    font-size: 1.5em;
+    border-radius: 0;
+}
+
+#resultDiv {
+    font: 16px "Source Sans", helvetica, arial, sans-serif;
+    font-weight: 200;
+    display: block;
+    -webkit-border-radius: 6px;
+    width: 100%;
+    height: 140px;
+    text-align: left;    
+    overflow: auto;
+}
+
+.haptic {
+    font-size: 0.5em;
+}
+
+.buttonDiv {
+    padding: 0px;
+    margin: 0px;
+    font-size: 2em;
+}
+
+#detailPage .haptic button {
+    margin-top: 15px;    
+}
+
+input[type="number"] {
+   width:50px;
+}

plugins/cordova-plugin-ble-central/examples/metawear/www/index.html

@@ -0,0 +1,37 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta name="format-detection" content="telephone=no" />
+        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1" />
+        
+        <link rel="stylesheet" type="text/css" href="css/index.css" />
+        <title>MetaWear</title>
+    </head>
+    <body>
+        <div class="app">
+            <h1>MetaWear</h1>
+            <div id="mainPage">
+                <ul id="deviceList">                    
+                </ul>
+                <button id="refreshButton">Refresh</button>
+            </div>
+            <div id="detailPage">
+                <div id="resultDiv"></div>
+                <div class="haptic">
+                    <label>Pulse Width&nbsp;<input type="number" id="pulseWidthInput" value="500"/></label>&nbsp;ms
+                    <div class="buttonDiv">
+                        <button id="motorButton">Motor</button>
+                        <button id="buzzerButton">Buzzer</button>                    
+                    </div>
+                </div>
+                <button id="disconnectButton">Disconnect</button>
+            </div>            
+        </div>
+        <script type="text/javascript" src="cordova.js"></script>
+        <script type="text/javascript" src="js/index.js"></script>
+        <script type="text/javascript">
+            app.initialize();
+        </script>
+    </body>
+</html>

plugins/cordova-plugin-ble-central/examples/metawear/www/js/index.js

@@ -0,0 +1,156 @@
+// (c) 2014 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global mainPage, deviceList, refreshButton */
+/* global detailPage, resultDiv, pulseWidthInput, motorButton, buzzerButton, disconnectButton */
+/* global ble, cordova */
+/* jshint browser: true , devel: true*/
+'use strict';
+
+// this is MetaWear's UART service
+var metawear = {
+    serviceUUID: "326a9000-85cb-9195-d9dd-464cfbbae75a",
+    txCharacteristic: "326a9001-85cb-9195-d9dd-464cfbbae75a", // transmit is from the phone's perspective
+    rxCharacteristic: "326a9006-85cb-9195-d9dd-464cfbbae75a"  // receive is from the phone's perspective
+};
+
+var app = {
+    deviceId: "",
+    initialize: function() {
+        this.bindEvents();
+        detailPage.hidden = true;
+    },
+    bindEvents: function() {
+        document.addEventListener('deviceready', this.onDeviceReady, false);
+        refreshButton.addEventListener('touchstart', this.refreshDeviceList, false);
+        motorButton.addEventListener('click', this.onMotorButton, false);
+        buzzerButton.addEventListener('click', this.onBuzzerButton, false);
+        disconnectButton.addEventListener('touchstart', this.disconnect, false);
+        deviceList.addEventListener('touchstart', this.connect, false); // assume not scrolling
+    },
+    onDeviceReady: function() {
+        app.refreshDeviceList();
+    },
+    refreshDeviceList: function() {
+        deviceList.innerHTML = ''; // empties the list
+        if (cordova.platformId === 'android') { // Android filtering is broken
+            ble.scan([], 5, app.onDiscoverDevice, app.onError);
+        } else {
+            ble.scan([metawear.serviceUUID], 5, app.onDiscoverDevice, app.onError);
+        }
+    },
+    onDiscoverDevice: function(device) {
+        var listItem = document.createElement('li'),
+            html = '<b>' + device.name + '</b><br/>' +
+                'RSSI: ' + device.rssi + '&nbsp;|&nbsp;' +
+                device.id;
+
+        listItem.dataset.deviceId = device.id;
+        listItem.innerHTML = html;
+        deviceList.appendChild(listItem);
+    },
+    connect: function(e) {
+        app.deviceId = e.target.dataset.deviceId;
+
+        var onConnect = function() {
+            app.enableButtonFeedback(app.subscribeForIncomingData, app.onError);
+            app.showDetailPage();
+        };
+
+        ble.connect(app.deviceId, onConnect, app.onError);
+    },
+    onData: function(buffer) { // data received from MetaWear
+
+        var data = new Uint8Array(buffer);
+        var message = "";
+
+        if (data[0] === 1 && data[1] === 1) { // module = 1, opscode = 1
+            if (data[2] === 1) { // button state
+                message = "Button pressed";
+            } else {
+                message = "Button released";
+            }
+        }
+
+        resultDiv.innerHTML = resultDiv.innerHTML + message + "<br/>";
+        resultDiv.scrollTop = resultDiv.scrollHeight;
+    },
+    writeData: function(buffer, success, failure) { // to to be sent to MetaWear
+
+        if (!success) {
+            success = function() {
+                console.log("success");
+                resultDiv.innerHTML = resultDiv.innerHTML + "Sent: " + JSON.stringify(new Uint8Array(buffer)) + "<br/>";
+                resultDiv.scrollTop = resultDiv.scrollHeight;
+            };
+        }
+
+        if (!failure) {
+            failure = app.onError;
+        }
+
+        ble.writeCommand(app.deviceId, metawear.serviceUUID, metawear.txCharacteristic, buffer, success, failure);
+    },
+    subscribeForIncomingData: function() {
+        ble.startNotification(app.deviceId, metawear.serviceUUID, metawear.rxCharacteristic, app.onData, app.onError);
+    },
+    enableButtonFeedback: function(success, failure) {
+        var data = new Uint8Array(6);
+        data[0] = 0x01; // mechanical switch
+        data[1] = 0x01; // switch state ops code
+        data[2] = 0x01; // enable
+
+        app.writeData(data.buffer, success, failure);
+    },
+    onMotorButton: function(event) {
+        var pulseWidth = pulseWidthInput.value;
+        var data = new Uint8Array(6);
+        data[0] = 0x07; // module
+        data[1] = 0x01; // pulse ops code
+        data[2] = 0x80; // Motor
+        data[3] = pulseWidth & 0xFF; // Pulse Width
+        data[4] = pulseWidth >> 8; // Pulse Width
+        data[5] = 0x00; // Some magic bullshit
+
+        app.writeData(data.buffer);
+    },
+    onBuzzerButton: function(event) {
+        var pulseWidth = pulseWidthInput.value;
+        var data = new Uint8Array(6);
+        data[0] = 0x07; // module
+        data[1] = 0x01; // pulse ops code
+        data[2] = 0xF8; // Buzzer
+        data[3] = pulseWidth & 0xFF; // Pulse Width
+        data[4] = pulseWidth >> 8; // Pulse Width
+        data[5] = 0x01; // Some magic?
+
+        app.writeData(data.buffer);
+    },
+    disconnect: function(event) {
+        ble.disconnect(app.deviceId, app.showMainPage, app.onError);
+        app.deviceId = "";
+    },
+    showMainPage: function() {
+        mainPage.hidden = false;
+        detailPage.hidden = true;
+    },
+    showDetailPage: function() {
+        mainPage.hidden = true;
+        detailPage.hidden = false;
+        resultDiv.innerHTML = "<i>Press the button on the MetaWear</i><br/>";
+    },
+    onError: function(reason) {
+        alert("ERROR: " + reason); // real apps should use notification.alert
+    }
+};

plugins/cordova-plugin-ble-central/examples/redbearlab/README.md

@@ -0,0 +1,18 @@
+## RedBearLab UART
+
+UART example using an Arduino and [RedBear Lab's Bluetooth Shield](http://redbearlab.com/bleshield/) or any of the RedBear Lab boards: [Blend](http://redbearlab.com/blend/), [Blend Micro](http://redbearlab.com/blendmicro/), [nRF51822](http://redbearlab.com/redbearlab-nrf51822/), or [BLE Nano](http://redbearlab.com/blenano/).
+
+Use the [SimpleChat sketch](https://codebender.cc/sketch:37518) on your Arduino hardware.
+
+Hardware
+
+ * [Arduino Uno](http://www.makershed.com/products/arduino-uno-revision-3)
+ * [BLE Shield](http://www.makershed.com/products/bluetooth-low-energy-ble-shield-for-arduino-2-0)
+
+Install
+
+    $ cordova platform add android ios
+    $ cordova plugin add cordova-plugin-ble-central
+    $ cordova run
+
+Once the app is running. Open the serial console to your Arduino. Data sent from the phone will show up in the serial console. Data sent from the Arduino will show up in on the phone.

plugins/cordova-plugin-ble-central/examples/redbearlab/config.xml

@@ -0,0 +1,12 @@
+<?xml version='1.0' encoding='utf-8'?>
+<widget id="com.megster.ble.redbear.chat" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name>RedBear Chat</name>
+    <description>
+        A sample app from a phone to RedBear Labs BLE hardware.
+    </description>
+    <author href="http://github.com/don">
+        Don Coleman
+    </author>
+    <content src="index.html" />
+    <access origin="*" />
+</widget>

plugins/cordova-plugin-ble-central/examples/redbearlab/hooks/README.md

@@ -0,0 +1,83 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Cordova Hooks
+
+This directory may contain scripts used to customize cordova commands. This
+directory used to exist at `.cordova/hooks`, but has now been moved to the
+project root. Any scripts you add to these directories will be executed before
+and after the commands corresponding to the directory name. Useful for
+integrating your own build systems or integrating with version control systems.
+
+__Remember__: Make your scripts executable.
+
+## Hook Directories
+The following subdirectories will be used for hooks:
+
+    after_build/
+    after_compile/
+    after_docs/
+    after_emulate/
+    after_platform_add/
+    after_platform_rm/
+    after_platform_ls/
+    after_plugin_add/
+    after_plugin_ls/
+    after_plugin_rm/
+    after_plugin_search/
+    after_prepare/
+    after_run/
+    after_serve/
+    before_build/
+    before_compile/
+    before_docs/
+    before_emulate/
+    before_platform_add/
+    before_platform_rm/
+    before_platform_ls/
+    before_plugin_add/
+    before_plugin_ls/
+    before_plugin_rm/
+    before_plugin_search/
+    before_prepare/
+    before_run/
+    before_serve/
+    pre_package/ <-- Windows 8 and Windows Phone only.
+
+## Script Interface
+
+All scripts are run from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables:
+
+* CORDOVA_VERSION - The version of the Cordova-CLI.
+* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios).
+* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer)
+* CORDOVA_HOOK - Path to the hook that is being executed.
+* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate)
+
+If a script returns a non-zero exit code, then the parent cordova command will be aborted.
+
+
+## Writing hooks
+
+We highly recommend writting your hooks using Node.js so that they are
+cross-platform. Some good examples are shown here:
+
+[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/)
+

plugins/cordova-plugin-ble-central/examples/redbearlab/www/css/index.css

@@ -0,0 +1,77 @@
+body {
+    font-family: "Helvetica Neue";
+    font-weight: lighter;
+    color: #2a2a2a;
+    background-color: #f0f0ff;
+    
+    -webkit-appearance: none;  
+    -webkit-touch-callout: none;
+    -webkit-tap-highlight-color: rgba(0,0,0,0); 
+    
+    -webkit-touch-callout: none; -webkit-user-select: none;
+}
+
+h1 {
+    text-align: center;
+}
+
+button {
+    margin: 15px;
+    -webkit-appearance:none;    
+    font-size: 1.2em;
+}
+
+/* TODO */
+input[type=range] {
+    width: 100%;
+}
+
+#mainPage {
+    text-align:center;
+}
+
+#detailPage {
+    text-align:center;
+    font-size: 2em;
+}
+
+#detailPage div {
+    margin: 20px;
+}
+
+#detailPage button {
+    margin-top: 40px;
+    font-size: 0.6em; /* undo 2em from parent */
+}
+
+ul {
+    list-style: none;
+    border-bottom: 1px solid #d3d3d3;    
+    text-align: left;
+}
+
+li {
+    margin-left: -40px;
+    padding: 5px;        
+    padding-top: 10px;
+    min-height: 50px;
+    border-top: 1px solid #d3d3d3;    
+    font-size: 0.9em;
+}
+
+button {
+    -webkit-appearance: none;
+    font-size: 1.5em;
+    border-radius: 0;
+}
+
+#resultDiv {
+    font: 16px "Source Sans", helvetica, arial, sans-serif;
+    font-weight: 200;
+    display: block;
+    -webkit-border-radius: 6px;
+    width: 100%;
+    height: 140px;
+    text-align: left;    
+    overflow: auto;
+}

plugins/cordova-plugin-ble-central/examples/redbearlab/www/index.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta name="format-detection" content="telephone=no" />
+        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1,  target-densitydpi=device-dpi" />
+
+        <link rel="stylesheet" type="text/css" href="css/index.css" />
+        <title>RedBearLab Chat</title>
+    </head>
+    <body>
+        <div class="app">
+            <h1>RedBearLab</h1>
+            <div id="mainPage">
+                <ul id="deviceList">
+                </ul>
+                <button id="refreshButton">Refresh</button>
+            </div>
+            <div id="detailPage">
+                <div id="resultDiv"></div>
+                <div>
+                    <input type="text" id="messageInput" value="Hello"/>
+                    <button id="sendButton">Send</button>
+                </div>
+                <button id="disconnectButton">Disconnect</button>
+            </div>
+        </div>
+        <script type="text/javascript" src="cordova.js"></script>
+        <script type="text/javascript" src="js/index.js"></script>
+        <script type="text/javascript">
+            app.initialize();
+        </script>
+    </body>
+</html>

plugins/cordova-plugin-ble-central/examples/redbearlab/www/js/index.js

@@ -0,0 +1,124 @@
+// (c) 2014 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global mainPage, deviceList, refreshButton */
+/* global detailPage, resultDiv, messageInput, sendButton, disconnectButton */
+/* global ble, cordova  */
+/* jshint browser: true , devel: true*/
+'use strict';
+
+// ASCII only
+function bytesToString(buffer) {
+    return String.fromCharCode.apply(null, new Uint8Array(buffer));
+}
+
+// ASCII only
+function stringToBytes(string) {
+    var array = new Uint8Array(string.length);
+    for (var i = 0, l = string.length; i < l; i++) {
+        array[i] = string.charCodeAt(i);
+    }
+    return array.buffer;
+}
+
+// this is RedBear Lab's UART service
+var redbear = {
+    serviceUUID: "713D0000-503E-4C75-BA94-3148F18D941E",
+    txCharacteristic: "713D0003-503E-4C75-BA94-3148F18D941E", // transmit is from the phone's perspective
+    rxCharacteristic: "713D0002-503E-4C75-BA94-3148F18D941E"  // receive is from the phone's perspective
+};
+
+var app = {
+    initialize: function() {
+        this.bindEvents();
+        detailPage.hidden = true;
+    },
+    bindEvents: function() {
+        document.addEventListener('deviceready', this.onDeviceReady, false);
+        refreshButton.addEventListener('touchstart', this.refreshDeviceList, false);
+        sendButton.addEventListener('click', this.sendData, false);
+        disconnectButton.addEventListener('touchstart', this.disconnect, false);
+        deviceList.addEventListener('touchstart', this.connect, false); // assume not scrolling
+    },
+    onDeviceReady: function() {
+        app.refreshDeviceList();
+    },
+    refreshDeviceList: function() {
+        deviceList.innerHTML = ''; // empties the list
+        if (cordova.platformId === 'android') { // Android filtering is broken
+            ble.scan([], 5, app.onDiscoverDevice, app.onError);
+        } else {
+            ble.scan([redbear.serviceUUID], 5, app.onDiscoverDevice, app.onError);
+        }
+    },
+    onDiscoverDevice: function(device) {
+        var listItem = document.createElement('li'),
+            html = '<b>' + device.name + '</b><br/>' +
+                'RSSI: ' + device.rssi + '&nbsp;|&nbsp;' +
+                device.id;
+
+        listItem.dataset.deviceId = device.id;
+        listItem.innerHTML = html;
+        deviceList.appendChild(listItem);
+    },
+    connect: function(e) {
+        var deviceId = e.target.dataset.deviceId,
+            onConnect = function() {
+                // subscribe for incoming data
+                ble.startNotification(deviceId, redbear.serviceUUID, redbear.rxCharacteristic, app.onData, app.onError);
+                sendButton.dataset.deviceId = deviceId;
+                disconnectButton.dataset.deviceId = deviceId;
+                app.showDetailPage();
+            };
+
+        ble.connect(deviceId, onConnect, app.onError);
+    },
+    onData: function(data) { // data received from Arduino
+        console.log(data);
+        resultDiv.innerHTML = resultDiv.innerHTML + "Received: " + bytesToString(data) + "<br/>";
+        resultDiv.scrollTop = resultDiv.scrollHeight;
+    },
+    sendData: function(event) { // send data to Arduino
+
+        var success = function() {
+            console.log("success");
+            resultDiv.innerHTML = resultDiv.innerHTML + "Sent: " + messageInput.value + "<br/>";
+            resultDiv.scrollTop = resultDiv.scrollHeight;
+        };
+
+        var failure = function() {
+            alert("Failed writing data to the redbear hardware");
+        };
+
+        var data = stringToBytes(messageInput.value);
+        var deviceId = event.target.dataset.deviceId;
+        ble.writeWithoutResponse(deviceId, redbear.serviceUUID, redbear.txCharacteristic, data, success, failure);
+
+    },
+    disconnect: function(event) {
+        var deviceId = event.target.dataset.deviceId;
+        ble.disconnect(deviceId, app.showMainPage, app.onError);
+    },
+    showMainPage: function() {
+        mainPage.hidden = false;
+        detailPage.hidden = true;
+    },
+    showDetailPage: function() {
+        mainPage.hidden = true;
+        detailPage.hidden = false;
+    },
+    onError: function(reason) {
+        alert("ERROR: " + reason); // real apps should use notification.alert
+    }
+};

plugins/cordova-plugin-ble-central/examples/rfduinoLedButton/README.md

@@ -0,0 +1,16 @@
+## RFduino LED Button
+
+Requires an [RFduino](http://rfudino.com) running the [LED Button sketch](https://github.com/RFduino/RFduino/blob/cfe1a448524f2dafc25f62cccd900484925bba8a/libraries/RFduinoBLE/examples/LedButton/LedButton.ino).
+
+Hardware
+
+ * [RFduino](http://www.rfduino.com/product/rfd22102-rfduino-dip/)
+ * [Button Shield](http://www.rfduino.com/product/rfd22122-rgb-button-shield-for-rfduino/)
+ * [USB Shield](http://www.rfduino.com/product/rfd22124-pcb-usb-shield-for-rfduino/)
+
+
+Install
+
+    $ cordova platform add android ios
+    $ cordova plugin add cordova-plugin-ble-central
+    $ cordova run

plugins/cordova-plugin-ble-central/examples/rfduinoLedButton/config.xml

@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8'?>
+<widget id="com.megster.rfduino.ledbutton" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name>RFduinoLedButton</name>
+    <description>
+        Use Cordova Bluetooth Plugin to control RFduino LED Button Sketch 
+    </description>
+    <author href="https://github.com/don">
+        Don Coleman
+    </author>
+    <content src="index.html" />
+    <access origin="*" />
+    <preference name="orientation" value="portrait" />
+</widget>

plugins/cordova-plugin-ble-central/examples/rfduinoLedButton/hooks/README.md

@@ -0,0 +1,83 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Cordova Hooks
+
+This directory may contain scripts used to customize cordova commands. This
+directory used to exist at `.cordova/hooks`, but has now been moved to the
+project root. Any scripts you add to these directories will be executed before
+and after the commands corresponding to the directory name. Useful for
+integrating your own build systems or integrating with version control systems.
+
+__Remember__: Make your scripts executable.
+
+## Hook Directories
+The following subdirectories will be used for hooks:
+
+    after_build/
+    after_compile/
+    after_docs/
+    after_emulate/
+    after_platform_add/
+    after_platform_rm/
+    after_platform_ls/
+    after_plugin_add/
+    after_plugin_ls/
+    after_plugin_rm/
+    after_plugin_search/
+    after_prepare/
+    after_run/
+    after_serve/
+    before_build/
+    before_compile/
+    before_docs/
+    before_emulate/
+    before_platform_add/
+    before_platform_rm/
+    before_platform_ls/
+    before_plugin_add/
+    before_plugin_ls/
+    before_plugin_rm/
+    before_plugin_search/
+    before_prepare/
+    before_run/
+    before_serve/
+    pre_package/ <-- Windows 8 and Windows Phone only.
+
+## Script Interface
+
+All scripts are run from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables:
+
+* CORDOVA_VERSION - The version of the Cordova-CLI.
+* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios).
+* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer)
+* CORDOVA_HOOK - Path to the hook that is being executed.
+* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate)
+
+If a script returns a non-zero exit code, then the parent cordova command will be aborted.
+
+
+## Writing hooks
+
+We highly recommend writting your hooks using Node.js so that they are
+cross-platform. Some good examples are shown here:
+
+[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/)
+

plugins/cordova-plugin-ble-central/examples/rfduinoLedButton/www/css/index.css

@@ -0,0 +1,61 @@
+body {
+    font-family: "Helvetica Neue";
+    font-weight: lighter;
+    color: #2a2a2a;
+    background-color: #f0f0ff;
+    
+    -webkit-appearance: none;  
+    -webkit-touch-callout: none;
+    -webkit-tap-highlight-color: rgba(0,0,0,0); 
+    
+    -webkit-touch-callout: none; -webkit-user-select: none;
+}
+
+h1 {
+    text-align: center;
+}
+
+button {
+    margin: 15px;
+    -webkit-appearance:none;    
+    font-size: 1.2em;
+}
+
+#mainPage {
+    text-align:center;
+}
+
+#detailPage {
+    text-align:center;
+    font-size: 2em;
+}
+
+#detailPage div {
+    margin: 20px;
+}
+
+#detailPage button {
+    margin-top: 40px;
+    font-size: 0.6em; /* undo 2em from parent */
+}
+
+ul {
+    list-style: none;
+    border-bottom: 1px solid #d3d3d3;    
+    text-align: left;
+}
+
+li {
+    margin-left: -40px;
+    padding: 5px;        
+    padding-top: 10px;
+    min-height: 50px;
+    border-top: 1px solid #d3d3d3;    
+    font-size: 0.9em;
+}
+
+button {
+    -webkit-appearance: none;
+    font-size: 1.5em;
+    border-radius: 0;
+}

plugins/cordova-plugin-ble-central/examples/rfduinoLedButton/www/index.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta name="format-detection" content="telephone=no" />
+        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1,  target-densitydpi=device-dpi" />
+        
+        <link rel="stylesheet" type="text/css" href="css/index.css" />
+        <title>RFduino LED Button</title>
+    </head>
+    <body>
+        <div class="app">
+            <h1>RFduino LED Button</h1>
+            <div id="mainPage">
+                <ul id="deviceList">                    
+                </ul>
+                <button id="refreshButton">Refresh</button>
+            </div>
+            <div id="detailPage">
+                <div id="buttonState">Button Released</div>
+                <div id="ledButton">Hold for LED</div>
+                <button id="disconnectButton">Disconnect</button>
+            </div>            
+        </div>
+        <script type="text/javascript" src="cordova.js"></script>
+        <script type="text/javascript" src="js/index.js"></script>
+        <script type="text/javascript">
+            app.initialize();
+        </script>
+    </body>
+</html>

plugins/cordova-plugin-ble-central/examples/rfduinoLedButton/www/js/index.js

@@ -0,0 +1,186 @@
+// (c) 2014-2015 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global mainPage, deviceList, refreshButton */
+/* global detailPage, buttonState, ledButton, disconnectButton */
+/* global ble, cordova  */
+/* jshint browser: true , devel: true*/
+'use strict';
+
+var arrayBufferToInt = function (ab) {
+    var a = new Uint8Array(ab);
+    return a[0];
+};
+
+var rfduino = {
+    serviceUUID: "2220",
+    receiveCharacteristic: "2221",
+    sendCharacteristic: "2222",
+    disconnectCharacteristic: "2223"
+};
+
+// returns advertising data as hashmap of byte arrays keyed by type
+// advertising data is length, type, data
+// https://www.bluetooth.org/en-us/specification/assigned-numbers/generic-access-profile
+function parseAdvertisingData(bytes) {
+    var length, type, data, i = 0, advertisementData = {};
+
+    while (length !== 0) {
+
+        length = bytes[i] & 0xFF;
+        i++;
+
+        type = bytes[i] & 0xFF;
+        i++;
+
+        data = bytes.slice(i, i + length - 1); // length includes type byte, but not length byte
+        i += length - 2;  // move to end of data
+        i++;
+
+        advertisementData[type] = data;
+    }
+
+    return advertisementData;
+}
+
+// RFduino advertises the sketch its running in the Manufacturer field 0xFF
+// RFduino provides a UART-like service so all sketchs look the same (0x2220)
+// This RFduino "service" name is used to different functions on the boards
+var getRFduinoService = function(scanRecord) {
+    var mfgData;
+
+    if (cordova.platformId === 'ios') {
+        mfgData = arrayBufferToIntArray(scanRecord.kCBAdvDataManufacturerData);
+    } else { // android
+        var ad = parseAdvertisingData(arrayBufferToIntArray(scanRecord));
+        mfgData = ad[0xFF];
+    }
+
+    if (mfgData) {
+      // ignore 1st 2 bytes of mfg data
+      return bytesToString(mfgData.slice(2));
+    } else {
+      return "";
+    }
+};
+
+// Convert ArrayBuffer to int[] for easier processing.
+// If Uint8Array.slice worked, this would be unnecessary
+var arrayBufferToIntArray = function(buffer) {
+    var result;
+
+    if (buffer) {
+        var typedArray = new Uint8Array(buffer);
+        result = [];
+        for (var i = 0; i < typedArray.length; i++) {
+            result[i] = typedArray[i];
+        }
+    }
+
+    return result;
+};
+
+var bytesToString = function (bytes) {
+    var bytesAsString = "";
+    for (var i = 0; i < bytes.length; i++) {
+        bytesAsString += String.fromCharCode(bytes[i]);
+    }
+    return bytesAsString;
+};
+
+var app = {
+    initialize: function() {
+        this.bindEvents();
+        detailPage.hidden = true;
+    },
+    bindEvents: function() {
+        document.addEventListener('deviceready', this.onDeviceReady, false);
+        refreshButton.addEventListener('touchstart', this.refreshDeviceList, false);
+        ledButton.addEventListener('touchstart', this.sendData, false);
+        ledButton.addEventListener('touchend', this.sendData, false);
+        disconnectButton.addEventListener('touchstart', this.disconnect, false);
+        deviceList.addEventListener('touchstart', this.connect, false); // assume not scrolling
+    },
+    onDeviceReady: function() {
+        app.refreshDeviceList();
+    },
+    refreshDeviceList: function() {
+        deviceList.innerHTML = ''; // empties the list
+        ble.scan([rfduino.serviceUUID], 5, app.onDiscoverDevice, app.onError);
+    },
+    onDiscoverDevice: function(device) {
+        var listItem = document.createElement('li'),
+            html = '<b>' + device.name + '</b><br/>' +
+                'RSSI: ' + device.rssi + '&nbsp;|&nbsp;' +
+                'Advertising: ' + getRFduinoService(device.advertising) + '<br/>' +
+                device.id;
+
+        listItem.dataset.deviceId = device.id;
+        listItem.innerHTML = html;
+        deviceList.appendChild(listItem);
+    },
+    connect: function(e) {
+        var deviceId = e.target.dataset.deviceId,
+            onConnect = function() {
+                // subscribe for incoming data
+                ble.startNotification(deviceId, rfduino.serviceUUID, rfduino.receiveCharacteristic, app.onData, app.onError);
+                disconnectButton.dataset.deviceId = deviceId;
+                ledButton.dataset.deviceId = deviceId;
+                app.showDetailPage();
+            };
+
+        ble.connect(deviceId, onConnect, app.onError);
+    },
+    onData: function(data) { // data received from rfduino
+        console.log(data);
+        var buttonValue = arrayBufferToInt(data);
+        if (buttonValue === 1) {
+            buttonState.innerHTML = "Button Pressed";
+        } else {
+            buttonState.innerHTML = "Button Released";
+        }
+    },
+    sendData: function(event) { // send data to rfduino
+
+        var success = function() {
+            console.log("success");
+        };
+
+        var failure = function() {
+            alert("Failed writing data to the rfduino");
+        };
+
+        var data = new Uint8Array(1);
+        data[0] = event.type === 'touchstart' ? 0x1 : 0x0;
+        var deviceId = event.target.dataset.deviceId;
+
+        ble.writeWithoutResponse(deviceId, rfduino.serviceUUID, rfduino.sendCharacteristic, data.buffer, success, failure);
+
+    },
+    disconnect: function(event) {
+        var deviceId = event.target.dataset.deviceId;
+        ble.disconnect(deviceId, app.showMainPage, app.onError);
+    },
+    showMainPage: function() {
+        mainPage.hidden = false;
+        detailPage.hidden = true;
+    },
+    showDetailPage: function() {
+        mainPage.hidden = true;
+        detailPage.hidden = false;
+    },
+    onError: function(reason) {
+        alert("ERROR: " + reason); // real apps should use notification.alert
+    }
+};

plugins/cordova-plugin-ble-central/examples/robosmart/README.md

@@ -0,0 +1,15 @@
+# RoboSmart
+
+Control a [SmartBotics](http://www.smartbotics.com/) RoboSmart Lightbulb from your phone.
+
+Hardware
+
+    * [RoboSmart Lightbulb](http://www.smartbotics.com/#!where-to-buy/c1kf9)
+    
+Install
+
+    $ cordova platform add android ios
+    $ cordova plugin add cordova-plugin-ble-central
+    $ cordova run
+    
+

plugins/cordova-plugin-ble-central/examples/robosmart/config.xml

@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8'?>
+<widget id="com.megster.robosmart" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name>RoboSmart</name>
+    <description>
+        Use Cordova Bluetooth Plugin to control Smartbotics RoboSmart lightbulb
+    </description>
+    <author href="https://github.com/don">
+        Don Coleman
+    </author>
+    <content src="index.html" />
+    <access origin="*" />
+    <preference name="orientation" value="portrait" />    
+</widget>

plugins/cordova-plugin-ble-central/examples/robosmart/hooks/README.md

@@ -0,0 +1,83 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Cordova Hooks
+
+This directory may contain scripts used to customize cordova commands. This
+directory used to exist at `.cordova/hooks`, but has now been moved to the
+project root. Any scripts you add to these directories will be executed before
+and after the commands corresponding to the directory name. Useful for
+integrating your own build systems or integrating with version control systems.
+
+__Remember__: Make your scripts executable.
+
+## Hook Directories
+The following subdirectories will be used for hooks:
+
+    after_build/
+    after_compile/
+    after_docs/
+    after_emulate/
+    after_platform_add/
+    after_platform_rm/
+    after_platform_ls/
+    after_plugin_add/
+    after_plugin_ls/
+    after_plugin_rm/
+    after_plugin_search/
+    after_prepare/
+    after_run/
+    after_serve/
+    before_build/
+    before_compile/
+    before_docs/
+    before_emulate/
+    before_platform_add/
+    before_platform_rm/
+    before_platform_ls/
+    before_plugin_add/
+    before_plugin_ls/
+    before_plugin_rm/
+    before_plugin_search/
+    before_prepare/
+    before_run/
+    before_serve/
+    pre_package/ <-- Windows 8 and Windows Phone only.
+
+## Script Interface
+
+All scripts are run from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables:
+
+* CORDOVA_VERSION - The version of the Cordova-CLI.
+* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios).
+* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer)
+* CORDOVA_HOOK - Path to the hook that is being executed.
+* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate)
+
+If a script returns a non-zero exit code, then the parent cordova command will be aborted.
+
+
+## Writing hooks
+
+We highly recommend writting your hooks using Node.js so that they are
+cross-platform. Some good examples are shown here:
+
+[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/)
+

plugins/cordova-plugin-ble-central/examples/robosmart/www/css/index.css

@@ -0,0 +1,66 @@
+body {
+    font-family: "Helvetica Neue";
+    font-weight: lighter;
+    color: #2a2a2a;
+    background-color: #f0f0ff;
+    
+    -webkit-appearance: none;  
+    -webkit-touch-callout: none;
+    -webkit-tap-highlight-color: rgba(0,0,0,0); 
+    
+    -webkit-touch-callout: none; -webkit-user-select: none;
+}
+
+h1 {
+    text-align: center;
+}
+
+button {
+    margin: 15px;
+    -webkit-appearance:none;    
+    font-size: 1.2em;
+}
+
+/* TODO */
+input[type=range] {
+    width: 100%;
+}
+
+#mainPage {
+    text-align:center;
+}
+
+#detailPage {
+    text-align:center;
+    font-size: 2em;
+}
+
+#detailPage div {
+    margin: 20px;
+}
+
+#detailPage button {
+    margin-top: 40px;
+    font-size: 0.6em; /* undo 2em from parent */
+}
+
+ul {
+    list-style: none;
+    border-bottom: 1px solid #d3d3d3;    
+    text-align: left;
+}
+
+li {
+    margin-left: -40px;
+    padding: 5px;        
+    padding-top: 10px;
+    min-height: 50px;
+    border-top: 1px solid #d3d3d3;    
+    font-size: 0.9em;
+}
+
+button {
+    -webkit-appearance: none;
+    font-size: 1.5em;
+    border-radius: 0;
+}

plugins/cordova-plugin-ble-central/examples/robosmart/www/index.html

@@ -0,0 +1,37 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta name="format-detection" content="telephone=no" />
+        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1,  target-densitydpi=device-dpi" />
+        
+        <link rel="stylesheet" type="text/css" href="css/index.css" />
+        <title>RoboSmart</title>
+    </head>
+    <body>
+        <div class="app">
+            <h1>RoboSmart</h1>
+            <div id="mainPage">
+                <ul id="deviceList">                    
+                </ul>
+                <button id="refreshButton">Refresh</button>
+            </div>
+            <div id="detailPage">
+                <!-- Topcoat Switch would look nicer http://topcoat.io/topcoat/topcoat-mobile-light.html#switch -->
+                <div>
+                    <input type="checkbox" id="lightSwitch" name="lightSwitch" class="switch" />
+                    <label for="lightSwitch">Switch</label>
+                </div>
+                <div class="rangeDiv">
+                    <input type="range" min="0" max="255" value="0" name="dimmer" id="dimmer" class="topcoat-range"/>
+                </div>
+                <button id="disconnectButton">Disconnect</button>
+            </div>            
+        </div>
+        <script type="text/javascript" src="cordova.js"></script>
+        <script type="text/javascript" src="js/index.js"></script>
+        <script type="text/javascript">
+            app.initialize();
+        </script>
+    </body>
+</html>

plugins/cordova-plugin-ble-central/examples/robosmart/www/js/index.js

@@ -0,0 +1,157 @@
+// (c) 2014 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global mainPage, deviceList, refreshButton */
+/* global detailPage, lightSwitch, dimmer, disconnectButton */
+/* global cordova, ble  */
+/* jshint browser: true , devel: true*/
+'use strict';
+
+var arrayBufferToInt = function (ab) {
+    var a = new Uint8Array(ab);
+    return a[0];
+};
+
+var robosmart = {
+    service: 'FF10',
+    lightSwitch: 'FF11',
+    brightness: 'FF12',
+    powerConsumed: 'FF16',
+    name: 'FF17',
+    description: 'FF18',
+    room: 'FF19',
+    locationName: 'FF1b',
+    locationGps: 'FF1d',
+    disconnect: 'FF1a',
+};
+
+var app = {
+    initialize: function() {
+        this.bindEvents();
+        detailPage.hidden = true;
+    },
+    bindEvents: function() {
+        document.addEventListener('deviceready', this.onDeviceReady, false);
+        refreshButton.addEventListener('touchstart', this.refreshDeviceList, false);
+        lightSwitch.addEventListener('change', this.setOnOff, false);
+        dimmer.addEventListener('change', this.setBrightness, false);
+        disconnectButton.addEventListener('touchstart', this.disconnect, false);
+        deviceList.addEventListener('touchstart', this.connect, false); // assume not scrolling
+    },
+    onDeviceReady: function() {
+        app.refreshDeviceList();
+    },
+    refreshDeviceList: function() {
+        deviceList.innerHTML = ''; // empties the list
+
+        if (cordova.platformId === 'android') {
+            // Bug: Android can't find RoboSmart when scanning for service
+            ble.scan([], 5, app.onDiscoverDevice, app.onError);
+        } else {
+            ble.scan([robosmart.service], 5, app.onDiscoverDevice, app.onError);
+        }
+    },
+    onDiscoverDevice: function(device) {
+        var listItem = document.createElement('li'),
+            html = '<b>' + device.name + '</b><br/>' +
+                'RSSI: ' + device.rssi + '&nbsp;|&nbsp;' +
+                device.id;
+
+        listItem.dataset.deviceId = device.id;
+        listItem.innerHTML = html;
+        deviceList.appendChild(listItem);
+    },
+    connect: function(e) {
+        var deviceId = e.target.dataset.deviceId,
+            onConnect = function() {
+                // subscribe for power consumption notifications
+                disconnectButton.dataset.deviceId = deviceId;
+                lightSwitch.dataset.deviceId = deviceId;
+                dimmer.dataset.deviceId = deviceId;
+                app.showDetailPage();
+                app.syncUI(deviceId);
+            };
+
+        ble.connect(deviceId, onConnect, app.onError);
+    },
+    setOnOff: function(event) { // send data to robosmart
+
+        var success = function() {
+            console.log("success");
+        };
+
+        var failure = function() {
+            alert("Failed writing data to the robosmart");
+        };
+
+        var data = new Uint8Array(1);
+        data[0] = event.target.checked ? 0x1 : 0x0;
+        var deviceId = event.target.dataset.deviceId;
+
+        ble.write(deviceId, robosmart.service, robosmart.lightSwitch, data.buffer, success, failure);
+    },
+    setBrightness: function(event) { // send data to robosmart
+
+        var success = function() {
+            // if the light was off and brightness is adjusted, the light will turn on
+            lightSwitch.checked = true;
+            console.log("success");
+        };
+
+        var failure = function() {
+            alert("Failed writing data to the robosmart");
+        };
+
+        var deviceId = event.target.dataset.deviceId;
+
+        // pass the brightness from the slider to the light
+        var brightness = new Uint8Array(1);
+        brightness[0] = event.target.value;
+
+        ble.write(deviceId, robosmart.service, robosmart.brightness, brightness.buffer, success, failure);
+    },
+    syncUI: function(deviceId) {
+
+        var switchCallback = function(data) {
+            lightSwitch.checked = arrayBufferToInt(data) === 0x1;
+        };
+
+        var dimmerCallback = function(data) {
+            dimmer.value = arrayBufferToInt(data);
+        };
+
+        var failure = function(reason) {
+            console.log("Error syncing UI with the current state " + reason);
+        };
+
+        ble.read(deviceId, robosmart.service, robosmart.lightSwitch, switchCallback, failure);
+        ble.read(deviceId, robosmart.service, robosmart.brightness, dimmerCallback, failure);
+
+    },
+    disconnect: function(event) {
+        var deviceId = event.target.dataset.deviceId;
+        ble.disconnect(deviceId, app.showMainPage, app.onError);
+    },
+    showMainPage: function() {
+        mainPage.hidden = false;
+        detailPage.hidden = true;
+    },
+    showDetailPage: function() {
+        mainPage.hidden = true;
+        detailPage.hidden = false;
+    },
+    onError: function(reason) {
+        alert("ERROR: " + reason); // real apps should use notification.alert
+    }
+};

plugins/cordova-plugin-ble-central/examples/sensortag/README.md

@@ -0,0 +1,17 @@
+## SensorTag
+
+Interact with the [TI SensorTag](http://www.ti.com/tool/cc2541dk-sensor)
+
+ * Read Button Presses
+ * Read Accelerometer Data
+
+Hardware
+
+ * [TI SensorTag](http://www.ti.com/tool/cc2541dk-sensor)
+
+Install
+
+    $ cordova platform add android ios
+    $ cordova plugin add cordova-plugin-ble-central
+    $ cordova run
+    

plugins/cordova-plugin-ble-central/examples/sensortag/config.xml

@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8'?>
+<widget id="com.megster.sensortag" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name>SensorTag</name>
+    <description>
+        Use Cordova Bluetooth Plugin to read values from TI SensorTag
+    </description>
+    <author href="https://github.com/don">
+           Don Coleman
+    </author>
+    <content src="index.html" />
+    <access origin="*" />
+    <preference name="orientation" value="portrait" />    
+</widget>

plugins/cordova-plugin-ble-central/examples/sensortag/hooks/README.md

@@ -0,0 +1,83 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Cordova Hooks
+
+This directory may contain scripts used to customize cordova commands. This
+directory used to exist at `.cordova/hooks`, but has now been moved to the
+project root. Any scripts you add to these directories will be executed before
+and after the commands corresponding to the directory name. Useful for
+integrating your own build systems or integrating with version control systems.
+
+__Remember__: Make your scripts executable.
+
+## Hook Directories
+The following subdirectories will be used for hooks:
+
+    after_build/
+    after_compile/
+    after_docs/
+    after_emulate/
+    after_platform_add/
+    after_platform_rm/
+    after_platform_ls/
+    after_plugin_add/
+    after_plugin_ls/
+    after_plugin_rm/
+    after_plugin_search/
+    after_prepare/
+    after_run/
+    after_serve/
+    before_build/
+    before_compile/
+    before_docs/
+    before_emulate/
+    before_platform_add/
+    before_platform_rm/
+    before_platform_ls/
+    before_plugin_add/
+    before_plugin_ls/
+    before_plugin_rm/
+    before_plugin_search/
+    before_prepare/
+    before_run/
+    before_serve/
+    pre_package/ <-- Windows 8 and Windows Phone only.
+
+## Script Interface
+
+All scripts are run from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables:
+
+* CORDOVA_VERSION - The version of the Cordova-CLI.
+* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios).
+* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer)
+* CORDOVA_HOOK - Path to the hook that is being executed.
+* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate)
+
+If a script returns a non-zero exit code, then the parent cordova command will be aborted.
+
+
+## Writing hooks
+
+We highly recommend writting your hooks using Node.js so that they are
+cross-platform. Some good examples are shown here:
+
+[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/)
+

plugins/cordova-plugin-ble-central/examples/sensortag/www/css/index.css

@@ -0,0 +1,61 @@
+body {
+    font-family: "Helvetica Neue";
+    font-weight: lighter;
+    color: #2a2a2a;
+    background-color: #f0f0ff;
+    
+    -webkit-appearance: none;  
+    -webkit-touch-callout: none;
+    -webkit-tap-highlight-color: rgba(0,0,0,0); 
+    
+    -webkit-touch-callout: none; -webkit-user-select: none;
+}
+
+h1 {
+    text-align: center;
+}
+
+button {
+    margin: 15px;
+    -webkit-appearance:none;    
+    font-size: 1.2em;
+}
+
+#mainPage {
+    text-align:center;
+}
+
+#detailPage {
+    text-align:center;
+    font-size: 2em;
+}
+
+#detailPage div {
+    margin: 20px;
+}
+
+#detailPage button {
+    margin-top: 40px;
+    font-size: 0.6em; /* undo 2em from parent */
+}
+
+ul {
+    list-style: none;
+    border-bottom: 1px solid #d3d3d3;    
+    text-align: left;
+}
+
+li {
+    margin-left: -40px;
+    padding: 5px;        
+    padding-top: 10px;
+    min-height: 50px;
+    border-top: 1px solid #d3d3d3;    
+    font-size: 0.9em;
+}
+
+button {
+    -webkit-appearance: none;
+    font-size: 1.5em;
+    border-radius: 0;
+}

plugins/cordova-plugin-ble-central/examples/sensortag/www/index.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta name="format-detection" content="telephone=no" />
+        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1" />
+
+        <link rel="stylesheet" type="text/css" href="css/index.css" />
+        <title>SensorTag</title>
+    </head>
+    <body>
+        <div class="app">
+            <h1>SensorTag</h1>
+            <div id="mainPage">
+                <ul id="deviceList">
+                </ul>
+                <button id="refreshButton">Refresh</button>
+            </div>
+            <div id="detailPage">
+                <div id="accelerometerData">waiting...</div>
+                <div id="buttonState"></div>
+                <button id="disconnectButton">Disconnect</button>
+            </div>
+        </div>
+        <script type="text/javascript" src="cordova.js"></script>
+        <script type="text/javascript" src="js/index.js"></script>
+        <script type="text/javascript">
+            app.initialize();
+        </script>
+    </body>
+</html>

plugins/cordova-plugin-ble-central/examples/sensortag/www/js/index.js

@@ -0,0 +1,141 @@
+// (c) 2014 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global mainPage, deviceList, refreshButton */
+/* global detailPage, accelerometerData, buttonState, disconnectButton */
+/* global ble  */
+/* jshint browser: true , devel: true*/
+'use strict';
+
+// http://processors.wiki.ti.com/index.php/SensorTag_User_Guide#Simple_Key_Service
+var button = {
+    service: "FFE0",
+    data: "FFE1", // Bit 2: side key, Bit 1- right key, Bit 0 –left key
+};
+
+
+// http://processors.wiki.ti.com/index.php/SensorTag_User_Guide#Accelerometer_2
+var accelerometer = {
+    service: "F000AA10-0451-4000-B000-000000000000",
+    data: "F000AA11-0451-4000-B000-000000000000", // read/notify 3 bytes X : Y : Z
+    configuration: "F000AA12-0451-4000-B000-000000000000", // read/write 1 byte
+    period: "F000AA13-0451-4000-B000-000000000000" // read/write 1 byte Period = [Input*10]ms
+};
+
+var app = {
+    initialize: function() {
+        this.bindEvents();
+        detailPage.hidden = true;
+    },
+    bindEvents: function() {
+        document.addEventListener('deviceready', this.onDeviceReady, false);
+        refreshButton.addEventListener('touchstart', this.refreshDeviceList, false);
+        disconnectButton.addEventListener('touchstart', this.disconnect, false);
+        deviceList.addEventListener('touchstart', this.connect, false); // assume not scrolling
+    },
+    onDeviceReady: function() {
+        app.refreshDeviceList();
+    },
+    refreshDeviceList: function() {
+        deviceList.innerHTML = ''; // empties the list
+        // scan for all devices
+        ble.scan([], 5, app.onDiscoverDevice, app.onError);
+    },
+    onDiscoverDevice: function(device) {
+
+        // we're not limiting scanning by services, so filter
+        // the list for devices with "Sensor" in the name
+        if (device.name.match(/sensor/i)) {
+
+            var listItem = document.createElement('li'),
+                html = '<b>' + device.name + '</b><br/>' +
+                    'RSSI: ' + device.rssi + '&nbsp;|&nbsp;' +
+                    device.id;
+
+            listItem.dataset.deviceId = device.id;  // TODO
+            listItem.innerHTML = html;
+            deviceList.appendChild(listItem);
+
+        }
+    },
+    connect: function(e) {
+        var deviceId = e.target.dataset.deviceId,
+            onConnect = function() {
+
+                ble.startNotification(deviceId, button.service, button.data, app.onButtonData, app.onError);
+                // subscribing for incoming data
+                ble.startNotification(deviceId, accelerometer.service, accelerometer.data, app.onAccelerometerData, app.onError);
+                // turn accelerometer on
+                var configData = new Uint8Array(1);
+                configData[0] = 0xFF;
+                ble.write(deviceId, accelerometer.service, accelerometer.configuration, configData.buffer, 
+                    function() { console.log("Started accelerometer."); },app.onError);
+                disconnectButton.dataset.deviceId = deviceId;
+                app.showDetailPage();
+            };
+
+        ble.connect(deviceId, onConnect, app.onError);
+    },
+    onButtonData: function(data) {
+        console.log(data);
+        var message;
+        var a = new Uint8Array(data);
+        switch(a[0]) { // should really check the bits in case bit 3 is set too
+        case 0:
+            message = "No buttons are pressed";
+            break;
+        case 1:
+            message = "Right button is pressed";
+            break;
+        case 2:
+            message = "Left button is pressed";
+            break;
+        case 3:
+            message = "Both buttons are pressed";
+            break;
+        default:
+            message = "Error";
+        }
+
+        buttonState.innerHTML = message;
+    },
+    onAccelerometerData: function(data) {
+        console.log(data);
+        var message;
+        var a = new Uint8Array(data);
+
+        // TODO get a template to line this up
+        // TODO round or format numbers for better display
+        message = "X: " + a[0]/64 + "<br/>" +
+                  "Y: " + a[1]/64 + "<br/>" +
+                  "Z: " + a[2]/64 * -1;
+
+        accelerometerData.innerHTML = message;
+    },
+    disconnect: function(event) {
+        var deviceId = event.target.dataset.deviceId;
+        ble.disconnect(deviceId, app.showMainPage, app.onError);
+    },
+    showMainPage: function() {
+        mainPage.hidden = false;
+        detailPage.hidden = true;
+    },
+    showDetailPage: function() {
+        mainPage.hidden = true;
+        detailPage.hidden = false;
+    },
+    onError: function(reason) {
+        alert("ERROR: " + reason); // real apps should use notification.alert
+    }
+};

plugins/cordova-plugin-ble-central/examples/sensortag_cc2650/README.md

@@ -0,0 +1,18 @@
+## SensorTag
+
+Interact with the [TI CC2650 SensorTag](http://www.ti.com/tool/CC2650STK)
+
+ * Read Button Presses
+ * Read Accelerometer/Magnetometer/Gyroscope Data
+ * Read Barometer/Temperature Data
+
+Hardware
+
+ * [TI CC2650 SensorTag](http://www.ti.com/tool/CC2650STK)
+
+Install
+
+    $ cordova platform add android ios
+    $ cordova plugin add cordova-plugin-ble-central
+    $ cordova run
+    

plugins/cordova-plugin-ble-central/examples/sensortag_cc2650/config.xml

@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8'?>
+<widget id="com.yertnamreg.sensortag.cc2650" version="0.0.2" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name>CC2650 SensorTag</name>
+    <description>
+        Use Cordova Bluetooth Plugin to read values from TI CC2650 SensorTag
+    </description>
+    <author href="https://github.com/treygerman">
+           Trey German
+    </author>
+    <content src="index.html" />
+    <access origin="*" />
+    <preference name="orientation" value="portrait" />
+</widget>

plugins/cordova-plugin-ble-central/examples/sensortag_cc2650/hooks/README.md

@@ -0,0 +1,83 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Cordova Hooks
+
+This directory may contain scripts used to customize cordova commands. This
+directory used to exist at `.cordova/hooks`, but has now been moved to the
+project root. Any scripts you add to these directories will be executed before
+and after the commands corresponding to the directory name. Useful for
+integrating your own build systems or integrating with version control systems.
+
+__Remember__: Make your scripts executable.
+
+## Hook Directories
+The following subdirectories will be used for hooks:
+
+    after_build/
+    after_compile/
+    after_docs/
+    after_emulate/
+    after_platform_add/
+    after_platform_rm/
+    after_platform_ls/
+    after_plugin_add/
+    after_plugin_ls/
+    after_plugin_rm/
+    after_plugin_search/
+    after_prepare/
+    after_run/
+    after_serve/
+    before_build/
+    before_compile/
+    before_docs/
+    before_emulate/
+    before_platform_add/
+    before_platform_rm/
+    before_platform_ls/
+    before_plugin_add/
+    before_plugin_ls/
+    before_plugin_rm/
+    before_plugin_search/
+    before_prepare/
+    before_run/
+    before_serve/
+    pre_package/ <-- Windows 8 and Windows Phone only.
+
+## Script Interface
+
+All scripts are run from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables:
+
+* CORDOVA_VERSION - The version of the Cordova-CLI.
+* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios).
+* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer)
+* CORDOVA_HOOK - Path to the hook that is being executed.
+* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate)
+
+If a script returns a non-zero exit code, then the parent cordova command will be aborted.
+
+
+## Writing hooks
+
+We highly recommend writting your hooks using Node.js so that they are
+cross-platform. Some good examples are shown here:
+
+[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/)
+

plugins/cordova-plugin-ble-central/examples/sensortag_cc2650/www/css/index.css

@@ -0,0 +1,61 @@
+body {
+    font-family: "Helvetica Neue";
+    font-weight: lighter;
+    color: #2a2a2a;
+    background-color: #f0f0ff;
+    
+    -webkit-appearance: none;  
+    -webkit-touch-callout: none;
+    -webkit-tap-highlight-color: rgba(0,0,0,0); 
+    
+    -webkit-touch-callout: none; -webkit-user-select: none;
+}
+
+h1 {
+    text-align: center;
+}
+
+button {
+    margin: 15px;
+    -webkit-appearance:none;    
+    font-size: 1.2em;
+}
+
+#mainPage {
+    text-align:center;
+}
+
+#detailPage {
+    text-align:center;
+    font-size: 1em;
+}
+
+#detailPage div {
+    margin: 20px;
+}
+
+#detailPage button {
+    margin-top: 40px;
+    font-size: 0.6em; /* undo 2em from parent */
+}
+
+ul {
+    list-style: none;
+    border-bottom: 1px solid #d3d3d3;    
+    text-align: left;
+}
+
+li {
+    margin-left: -40px;
+    padding: 5px;        
+    padding-top: 10px;
+    min-height: 50px;
+    border-top: 1px solid #d3d3d3;    
+    font-size: 0.9em;
+}
+
+button {
+    -webkit-appearance: none;
+    font-size: 1.5em;
+    border-radius: 0;
+}

plugins/cordova-plugin-ble-central/examples/sensortag_cc2650/www/index.html

@@ -0,0 +1,32 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta name="format-detection" content="telephone=no" />
+        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1" />
+
+        <link rel="stylesheet" type="text/css" href="css/index.css" />
+        <title>SensorTag</title>
+    </head>
+    <body>
+        <div class="app">
+            <h1>SensorTag</h1>
+            <div id="mainPage">
+                <ul id="deviceList">
+                </ul>
+                <button id="refreshButton">Refresh</button>
+            </div>
+            <div id="detailPage">
+                <div id="accelerometerData">waiting...</div>
+                <div id="barometerData">waiting...</div>
+                <div id="buttonState"></div>
+                <button id="disconnectButton">Disconnect</button>
+            </div>
+        </div>
+        <script type="text/javascript" src="cordova.js"></script>
+        <script type="text/javascript" src="js/index.js"></script>
+        <script type="text/javascript">
+            app.initialize();
+        </script>
+    </body>
+</html>

plugins/cordova-plugin-ble-central/examples/sensortag_cc2650/www/js/index.js

@@ -0,0 +1,216 @@
+// (c) 2014 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global mainPage, deviceList, refreshButton */
+/* global detailPage, accelerometerData, buttonState, disconnectButton */
+/* global ble  */
+/* jshint browser: true , devel: true*/
+'use strict';
+
+// http://processors.wiki.ti.com/index.php/SensorTag_User_Guide#Simple_Key_Service
+var button = {
+    service: "FFE0",
+    data: "FFE1", // Bit 2: side key, Bit 1- right key, Bit 0 –left key
+};
+
+//http://processors.wiki.ti.com/index.php/CC2650_SensorTag_User%27s_Guide
+var accelerometer = {
+    service: "F000AA80-0451-4000-B000-000000000000",
+    data: "F000AA81-0451-4000-B000-000000000000", // read/notify 3 bytes X : Y : Z
+    notification:"F0002902-0451-4000-B000-000000000000",
+    configuration: "F000AA82-0451-4000-B000-000000000000", // read/write 1 byte
+    period: "F000AA83-0451-4000-B000-000000000000" // read/write 1 byte Period = [Input*10]ms
+};
+
+var barometer = {
+    service: "F000AA40-0451-4000-B000-000000000000",
+    data: "F000AA41-0451-4000-B000-000000000000",
+    notification: "F0002902-0451-4000-B000-000000000000",
+    configuration: "F000AA42-0451-4000-B000-000000000000",
+    period: "F000AA43-0451-4000-B000-000000000000"
+
+};
+
+// button bitmask
+var LEFT_BUTTON = 1;  // 0001
+var RIGHT_BUTTON = 2; // 0010
+var REED_SWITCH = 4;  // 0100
+
+var app = {
+    initialize: function() {
+        this.bindEvents();
+        detailPage.hidden = true;
+    },
+    bindEvents: function() {
+        document.addEventListener('deviceready', this.onDeviceReady, false);
+        refreshButton.addEventListener('touchstart', this.refreshDeviceList, false);
+        disconnectButton.addEventListener('touchstart', this.disconnect, false);
+        deviceList.addEventListener('touchstart', this.connect, false); // assume not scrolling
+    },
+    onDeviceReady: function() {
+        app.refreshDeviceList();
+    },
+    refreshDeviceList: function() {
+        deviceList.innerHTML = ''; // empties the list
+        // scan for CC2560 SensorTags
+        ble.scan(['AA80'], 5, app.onDiscoverDevice, app.onError);
+    },
+    onDiscoverDevice: function(device) {
+        var listItem = document.createElement('li'),
+            html = '<b>' + device.name + '</b><br/>' +
+                'RSSI: ' + device.rssi + '&nbsp;|&nbsp;' +
+                device.id;
+
+        listItem.dataset.deviceId = device.id;  // TODO
+        listItem.innerHTML = html;
+        deviceList.appendChild(listItem);
+    },
+    connect: function(e) {
+        var deviceId = e.target.dataset.deviceId,
+            onConnect = function() {
+
+                //Subscribe to button service
+                ble.startNotification(deviceId, button.service, button.data, app.onButtonData, app.onError);
+                //Subscribe to accelerometer service
+                ble.startNotification(deviceId, accelerometer.service, accelerometer.data, app.onAccelerometerData, app.onError);
+                //Subscribe to barometer service
+                ble.startNotification(deviceId, barometer.service, barometer.data, app.onBarometerData, app.onError);
+
+
+                // turn accelerometer on
+                var configData = new Uint16Array(1);
+                //Turn on gyro, accel, and mag, 2G range, Disable wake on motion
+                configData[0] = 0x007F;
+                ble.write(deviceId, accelerometer.service, accelerometer.configuration, configData.buffer,
+                    function() { console.log("Started accelerometer."); },app.onError);
+
+                var periodData = new Uint8Array(1);
+                periodData[0] = 0x0A;
+                ble.write(deviceId, accelerometer.service, accelerometer.period, periodData.buffer,
+                    function() { console.log("Configured accelerometer period."); },app.onError);
+
+                //Turn on barometer
+                var barometerConfig = new Uint8Array(1);
+                barometerConfig[0] = 0x01;
+                ble.write(deviceId, barometer.service, barometer.configuration, barometerConfig.buffer,
+                    function() { console.log("Started barometer."); },app.onError);
+
+                //Associate the deviceID with the disconnect button
+                disconnectButton.dataset.deviceId = deviceId;
+                app.showDetailPage();
+            };
+
+        ble.connect(deviceId, onConnect, app.onError);
+    },
+    onButtonData: function(data) {
+        console.log(data);
+        var state = new Uint8Array(data);
+        var message = '';
+
+        if (state === 0) {
+            message = 'No buttons are pressed.';
+        }
+
+        if (state & LEFT_BUTTON) {
+            message += 'Left button is pressed.<br/>';
+        }
+
+        if (state & RIGHT_BUTTON) {
+            message += 'Right button is pressed.<br/>';
+        }
+
+        if (state & REED_SWITCH) {
+            message += 'Reed switch is activated.<br/>';
+        }
+
+        buttonState.innerHTML = message;
+    },
+
+    sensorMpu9250GyroConvert: function(data){
+        return data / (65536/500);
+    },
+
+    sensorMpu9250AccConvert: function(data){
+        // Change  /2 to match accel range...i.e. 16 g would be /16
+        return data / (32768 / 2);
+    },
+
+    onAccelerometerData: function(data) {
+        console.log(data);
+        var message;
+        var a = new Int16Array(data);
+
+        //0 gyro x
+        //1 gyro y
+        //2 gyro z
+        //3 accel x
+        //4 accel y
+        //5 accel z
+        //6 mag x
+        //7 mag y
+        //8 mag z
+
+        // TODO get a template to line this up
+        // TODO round or format numbers for better display
+        message = "Gyro <br/>"+
+                  "X: " + app.sensorMpu9250GyroConvert(a[0]) + "<br/>" +
+                  "Y: " + app.sensorMpu9250GyroConvert(a[1]) + "<br/>" +
+                  "Z: " + app.sensorMpu9250GyroConvert(a[2]) + "<br/>" +
+                  "Accel <br/>"+
+                  "X: " + app.sensorMpu9250AccConvert(a[3]) + "<br/>" +
+                  "Y: " + app.sensorMpu9250AccConvert(a[4]) + "<br/>" +
+                  "Z: " + app.sensorMpu9250AccConvert(a[5]) + "<br/>" +
+                  "Mag <br/>"+
+                  "X: " + a[6] + "<br/>" +
+                  "Y: " + a[7] + "<br/>" +
+                  "Z: " + a[8] + "<br/>" ;
+
+        accelerometerData.innerHTML = message;
+    },
+    sensorBarometerConvert: function(data){
+        return (data / 100);
+
+    },
+    onBarometerData: function(data) {
+         console.log(data);
+         var message;
+         var a = new Uint8Array(data);
+
+         //0-2 Temp
+         //3-5 Pressure
+         message =  "Temperature <br/>" +
+                    app.sensorBarometerConvert( a[0] | (a[1] << 8) | (a[2] << 16)) + "°C <br/>" +
+                    "Pressure <br/>" +
+                    app.sensorBarometerConvert( a[3] | (a[4] << 8) | (a[5] << 16)) + "hPa <br/>" ;
+
+
+        barometerData.innerHTML = message;
+
+    },
+    disconnect: function(event) {
+        var deviceId = event.target.dataset.deviceId;
+        ble.disconnect(deviceId, app.showMainPage, app.onError);
+    },
+    showMainPage: function() {
+        mainPage.hidden = false;
+        detailPage.hidden = true;
+    },
+    showDetailPage: function() {
+        mainPage.hidden = true;
+        detailPage.hidden = false;
+    },
+    onError: function(reason) {
+        alert("ERROR: " + reason); // real apps should use notification.alert
+    }
+};

plugins/cordova-plugin-ble-central/package.json

@@ -0,0 +1,64 @@
+{
+  "_from": "cordova-plugin-ble-central",
+  "_id": "cordova-plugin-ble-central@1.2.2",
+  "_inBundle": false,
+  "_integrity": "sha512-81+BD9UQSp8Fuati9bPvKG/6lSGHHtw3JeLxQl8Q85ZS1n3GkSfA3DBMqKRjmOG6OVe4csR+XcO7cd75HMl6Qg==",
+  "_location": "/cordova-plugin-ble-central",
+  "_phantomChildren": {},
+  "_requested": {
+    "type": "tag",
+    "registry": true,
+    "raw": "cordova-plugin-ble-central",
+    "name": "cordova-plugin-ble-central",
+    "escapedName": "cordova-plugin-ble-central",
+    "rawSpec": "",
+    "saveSpec": null,
+    "fetchSpec": "latest"
+  },
+  "_requiredBy": [
+    "#USER",
+    "/"
+  ],
+  "_resolved": "https://registry.npmjs.org/cordova-plugin-ble-central/-/cordova-plugin-ble-central-1.2.2.tgz",
+  "_shasum": "22f4ed72c2fb0b7ef0e7eb983a419e7aaf07eb21",
+  "_spec": "cordova-plugin-ble-central",
+  "_where": "/Users/young/Develop/wifi-ble-client",
+  "author": {
+    "name": "Don Coleman",
+    "email": "don.coleman@gmail.com"
+  },
+  "bugs": {
+    "url": "https://github.com/don/cordova-plugin-ble-central/issues"
+  },
+  "bundleDependencies": false,
+  "cordova": {
+    "id": "cordova-plugin-ble-central",
+    "platforms": [
+      "ios",
+      "android",
+      "wp8"
+    ]
+  },
+  "deprecated": false,
+  "description": "Bluetooth Low Energy (BLE) Central Plugin",
+  "homepage": "https://github.com/don/cordova-plugin-ble-central#readme",
+  "keywords": [
+    "cordova",
+    "bluetooth",
+    "ble",
+    "bluetoothle",
+    "bluetooth le",
+    "low energy",
+    "smart",
+    "ecosystem:cordova",
+    "cordova-ios",
+    "cordova-android"
+  ],
+  "license": "Apache-2.0",
+  "name": "cordova-plugin-ble-central",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/don/cordova-plugin-ble-central.git"
+  },
+  "version": "1.2.2"
+}

plugins/cordova-plugin-ble-central/plugin.xml

@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="utf-8"?>
+<plugin
+    xmlns="http://www.phonegap.com/ns/plugins/1.0"
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    id="cordova-plugin-ble-central"
+    version="1.2.2">
+
+    <name>BLE</name>
+    <description>Bluetooth Low Energy (BLE) Central Plugin</description>
+    <license>Apache 2.0</license>
+    <keywords>bluetooth, BLE, bluetooth low energy, bluetooth smart</keywords>
+
+    <repo>https://github.com/don/cordova-plugin-ble-central.git</repo>
+    <issue>https://github.com/don/cordova-plugin-ble-central/issues</issue>
+
+    <dependency id="cordova-plugin-compat" version="^1.2.0" />
+
+    <js-module src="www/ble.js" name="ble">
+        <clobbers target="ble" />
+    </js-module>
+
+    <platform name="ios">
+
+        <config-file target="config.xml" parent="/widget">
+            <feature name="BLE">
+                <param name="ios-package" value="BLECentralPlugin" onload="true"/>
+            </feature>
+        </config-file>
+
+        <header-file src="src/ios/BLECentralPlugin.h" target-dir="BLECentralPlugin" />
+        <source-file src="src/ios/BLECentralPlugin.m" target-dir="BLECentralPlugin" />
+
+        <header-file src="src/ios/CBPeripheral+Extensions.h" target-dir="BLECentralPlugin" />
+        <source-file src="src/ios/CBPeripheral+Extensions.m" target-dir="BLECentralPlugin" />
+
+        <header-file src="src/ios/BLECommandContext.h" target-dir="BLECentralPlugin" />
+        <source-file src="src/ios/BLECommandContext.m" target-dir="BLECentralPlugin" />
+
+        <!-- frameworks -->
+        <framework src="CoreBluetooth.framework" />
+
+        <preference name="BLUETOOTH_USAGE_DESCRIPTION" default=" " />
+        <config-file target="*-Info.plist" parent="NSBluetoothPeripheralUsageDescription">
+            <string>$BLUETOOTH_USAGE_DESCRIPTION</string>
+        </config-file>
+    </platform>
+
+    <platform name="android">
+        <config-file target="res/xml/config.xml" parent="/widget">
+            <feature name="BLE">
+                <param name="android-package" value="com.megster.cordova.ble.central.BLECentralPlugin"/>
+            </feature>
+        </config-file>
+
+        <config-file target="AndroidManifest.xml" parent="/manifest">
+            <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
+            <uses-permission android:name="android.permission.BLUETOOTH"/>
+            <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
+        </config-file>
+
+        <source-file src="src/android/BLECentralPlugin.java"
+            target-dir="src/com/megster/cordova/ble/central"/>
+        <source-file src="src/android/BLECommand.java"
+            target-dir="src/com/megster/cordova/ble/central"/>
+        <source-file src="src/android/Peripheral.java"
+            target-dir="src/com/megster/cordova/ble/central"/>
+        <source-file src="src/android/Helper.java"
+            target-dir="src/com/megster/cordova/ble/central"/>
+        <source-file src="src/android/UUIDHelper.java"
+            target-dir="src/com/megster/cordova/ble/central"/>
+
+    </platform>
+
+    <platform name="browser">
+        <js-module src="src/browser/BLECentralPlugin.js" name="BLECentralPlugin">
+            <merges target="ble" />
+        </js-module>
+    </platform>
+
+    <platform name="wp8">
+        <config-file target="config.xml" parent="/*">
+            <feature name="BLE">
+                <param name="wp-package" value="BLECentralPlugin"/>
+            </feature>
+        </config-file>
+
+         <config-file target="Properties/WMAppManifest.xml" parent="/Deployment/App/Capabilities">
+             <Capability Name="ID_CAP_PROXIMITY" />
+         </config-file>
+
+         <source-file src="src/wp/BLECentralPlugin.cs" />
+
+    </platform>
+</plugin>

plugins/cordova-plugin-ble-central/src/android/BLECentralPlugin.java

@@ -0,0 +1,719 @@
+// (c) 2014-2016 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package com.megster.cordova.ble.central;
+
+import android.Manifest;
+import android.app.Activity;
+import android.bluetooth.BluetoothAdapter;
+import android.bluetooth.BluetoothDevice;
+import android.bluetooth.BluetoothGattCharacteristic;
+import android.bluetooth.BluetoothManager;
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.content.IntentFilter;
+import android.os.Handler;
+import android.os.Build;
+
+import android.provider.Settings;
+import org.apache.cordova.CallbackContext;
+import org.apache.cordova.CordovaArgs;
+import org.apache.cordova.CordovaPlugin;
+import org.apache.cordova.LOG;
+import org.apache.cordova.PermissionHelper;
+import org.apache.cordova.PluginResult;
+import org.json.JSONArray;
+import org.json.JSONObject;
+import org.json.JSONException;
+
+import java.util.*;
+
+import static android.bluetooth.BluetoothDevice.DEVICE_TYPE_DUAL;
+import static android.bluetooth.BluetoothDevice.DEVICE_TYPE_LE;
+
+public class BLECentralPlugin extends CordovaPlugin implements BluetoothAdapter.LeScanCallback {
+    // actions
+    private static final String SCAN = "scan";
+    private static final String START_SCAN = "startScan";
+    private static final String STOP_SCAN = "stopScan";
+    private static final String START_SCAN_WITH_OPTIONS = "startScanWithOptions";
+    private static final String BONDED_DEVICES = "bondedDevices";
+    private static final String LIST = "list";
+
+    private static final String CONNECT = "connect";
+    private static final String AUTOCONNECT = "autoConnect";
+    private static final String DISCONNECT = "disconnect";
+
+    private static final String REQUEST_MTU = "requestMtu";
+    private static final String REFRESH_DEVICE_CACHE = "refreshDeviceCache";
+
+    private static final String READ = "read";
+    private static final String WRITE = "write";
+    private static final String WRITE_WITHOUT_RESPONSE = "writeWithoutResponse";
+
+    private static final String READ_RSSI = "readRSSI";
+
+    private static final String START_NOTIFICATION = "startNotification"; // register for characteristic notification
+    private static final String STOP_NOTIFICATION = "stopNotification"; // remove characteristic notification
+
+    private static final String IS_ENABLED = "isEnabled";
+    private static final String IS_CONNECTED  = "isConnected";
+
+    private static final String SETTINGS = "showBluetoothSettings";
+    private static final String ENABLE = "enable";
+
+    private static final String START_STATE_NOTIFICATIONS = "startStateNotifications";
+    private static final String STOP_STATE_NOTIFICATIONS = "stopStateNotifications";
+
+    // callbacks
+    CallbackContext discoverCallback;
+    private CallbackContext enableBluetoothCallback;
+
+    private static final String TAG = "BLEPlugin";
+    private static final int REQUEST_ENABLE_BLUETOOTH = 1;
+
+    BluetoothAdapter bluetoothAdapter;
+
+    // key is the MAC Address
+    Map<String, Peripheral> peripherals = new LinkedHashMap<String, Peripheral>();
+
+    // scan options
+    boolean reportDuplicates = false;
+
+    // Android 23 requires new permissions for BluetoothLeScanner.startScan()
+    private static final String ACCESS_COARSE_LOCATION = Manifest.permission.ACCESS_COARSE_LOCATION;
+    private static final int REQUEST_ACCESS_COARSE_LOCATION = 2;
+    private CallbackContext permissionCallback;
+    private UUID[] serviceUUIDs;
+    private int scanSeconds;
+
+    // Bluetooth state notification
+    CallbackContext stateCallback;
+    BroadcastReceiver stateReceiver;
+    Map<Integer, String> bluetoothStates = new Hashtable<Integer, String>() {{
+        put(BluetoothAdapter.STATE_OFF, "off");
+        put(BluetoothAdapter.STATE_TURNING_OFF, "turningOff");
+        put(BluetoothAdapter.STATE_ON, "on");
+        put(BluetoothAdapter.STATE_TURNING_ON, "turningOn");
+    }};
+
+    public void onDestroy() {
+        removeStateListener();
+    }
+
+    public void onReset() {
+        removeStateListener();
+    }
+
+    @Override
+    public boolean execute(String action, CordovaArgs args, CallbackContext callbackContext) throws JSONException {
+        LOG.d(TAG, "action = " + action);
+
+        if (bluetoothAdapter == null) {
+            Activity activity = cordova.getActivity();
+            boolean hardwareSupportsBLE = activity.getApplicationContext()
+                                            .getPackageManager()
+                                            .hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE) &&
+                                            Build.VERSION.SDK_INT >= 18;
+            if (!hardwareSupportsBLE) {
+              LOG.w(TAG, "This hardware does not support Bluetooth Low Energy.");
+              callbackContext.error("This hardware does not support Bluetooth Low Energy.");
+              return false;
+            }
+            BluetoothManager bluetoothManager = (BluetoothManager) activity.getSystemService(Context.BLUETOOTH_SERVICE);
+            bluetoothAdapter = bluetoothManager.getAdapter();
+        }
+
+        boolean validAction = true;
+
+        if (action.equals(SCAN)) {
+
+            UUID[] serviceUUIDs = parseServiceUUIDList(args.getJSONArray(0));
+            int scanSeconds = args.getInt(1);
+            resetScanOptions();
+            findLowEnergyDevices(callbackContext, serviceUUIDs, scanSeconds);
+
+        } else if (action.equals(START_SCAN)) {
+
+            UUID[] serviceUUIDs = parseServiceUUIDList(args.getJSONArray(0));
+            resetScanOptions();
+            findLowEnergyDevices(callbackContext, serviceUUIDs, -1);
+
+        } else if (action.equals(STOP_SCAN)) {
+
+            bluetoothAdapter.stopLeScan(this);
+            callbackContext.success();
+
+        } else if (action.equals(LIST)) {
+
+            listKnownDevices(callbackContext);
+
+        } else if (action.equals(CONNECT)) {
+
+            String macAddress = args.getString(0);
+            connect(callbackContext, macAddress);
+
+        } else if (action.equals(AUTOCONNECT)) {
+
+            String macAddress = args.getString(0);
+            autoConnect(callbackContext, macAddress);
+
+        } else if (action.equals(DISCONNECT)) {
+
+            String macAddress = args.getString(0);
+            disconnect(callbackContext, macAddress);
+
+        } else if (action.equals(REQUEST_MTU)) {
+
+            String macAddress = args.getString(0);
+            int mtuValue = args.getInt(1);
+            requestMtu(callbackContext, macAddress, mtuValue);
+
+        } else if (action.equals(REFRESH_DEVICE_CACHE)) {
+
+            String macAddress = args.getString(0);
+            long timeoutMillis = args.getLong(1);
+
+            refreshDeviceCache(callbackContext, macAddress, timeoutMillis);
+
+        } else if (action.equals(READ)) {
+
+            String macAddress = args.getString(0);
+            UUID serviceUUID = uuidFromString(args.getString(1));
+            UUID characteristicUUID = uuidFromString(args.getString(2));
+            read(callbackContext, macAddress, serviceUUID, characteristicUUID);
+
+        } else if (action.equals(READ_RSSI)) {
+
+            String macAddress = args.getString(0);
+            readRSSI(callbackContext, macAddress);
+
+        } else if (action.equals(WRITE)) {
+
+            String macAddress = args.getString(0);
+            UUID serviceUUID = uuidFromString(args.getString(1));
+            UUID characteristicUUID = uuidFromString(args.getString(2));
+            byte[] data = args.getArrayBuffer(3);
+            int type = BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT;
+            write(callbackContext, macAddress, serviceUUID, characteristicUUID, data, type);
+
+        } else if (action.equals(WRITE_WITHOUT_RESPONSE)) {
+
+            String macAddress = args.getString(0);
+            UUID serviceUUID = uuidFromString(args.getString(1));
+            UUID characteristicUUID = uuidFromString(args.getString(2));
+            byte[] data = args.getArrayBuffer(3);
+            int type = BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE;
+            write(callbackContext, macAddress, serviceUUID, characteristicUUID, data, type);
+
+        } else if (action.equals(START_NOTIFICATION)) {
+
+            String macAddress = args.getString(0);
+            UUID serviceUUID = uuidFromString(args.getString(1));
+            UUID characteristicUUID = uuidFromString(args.getString(2));
+            registerNotifyCallback(callbackContext, macAddress, serviceUUID, characteristicUUID);
+
+        } else if (action.equals(STOP_NOTIFICATION)) {
+
+            String macAddress = args.getString(0);
+            UUID serviceUUID = uuidFromString(args.getString(1));
+            UUID characteristicUUID = uuidFromString(args.getString(2));
+            removeNotifyCallback(callbackContext, macAddress, serviceUUID, characteristicUUID);
+
+        } else if (action.equals(IS_ENABLED)) {
+
+            if (bluetoothAdapter.isEnabled()) {
+                callbackContext.success();
+            } else {
+                callbackContext.error("Bluetooth is disabled.");
+            }
+
+        } else if (action.equals(IS_CONNECTED)) {
+
+            String macAddress = args.getString(0);
+
+            if (peripherals.containsKey(macAddress) && peripherals.get(macAddress).isConnected()) {
+                callbackContext.success();
+            } else {
+                callbackContext.error("Not connected.");
+            }
+
+        } else if (action.equals(SETTINGS)) {
+
+            Intent intent = new Intent(Settings.ACTION_BLUETOOTH_SETTINGS);
+            cordova.getActivity().startActivity(intent);
+            callbackContext.success();
+
+        } else if (action.equals(ENABLE)) {
+
+            enableBluetoothCallback = callbackContext;
+            Intent intent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
+            cordova.startActivityForResult(this, intent, REQUEST_ENABLE_BLUETOOTH);
+
+        } else if (action.equals(START_STATE_NOTIFICATIONS)) {
+
+            if (this.stateCallback != null) {
+                callbackContext.error("State callback already registered.");
+            } else {
+                this.stateCallback = callbackContext;
+                addStateListener();
+                sendBluetoothStateChange(bluetoothAdapter.getState());
+            }
+
+        } else if (action.equals(STOP_STATE_NOTIFICATIONS)) {
+
+            if (this.stateCallback != null) {
+                // Clear callback in JavaScript without actually calling it
+                PluginResult result = new PluginResult(PluginResult.Status.NO_RESULT);
+                result.setKeepCallback(false);
+                this.stateCallback.sendPluginResult(result);
+                this.stateCallback = null;
+            }
+            removeStateListener();
+            callbackContext.success();
+
+        } else if (action.equals(START_SCAN_WITH_OPTIONS)) {
+            UUID[] serviceUUIDs = parseServiceUUIDList(args.getJSONArray(0));
+            JSONObject options = args.getJSONObject(1);
+
+            resetScanOptions();
+            this.reportDuplicates = options.optBoolean("reportDuplicates", false);
+            findLowEnergyDevices(callbackContext, serviceUUIDs, -1);
+
+        } else if (action.equals(BONDED_DEVICES)) {
+
+            getBondedDevices(callbackContext);
+
+        } else {
+
+            validAction = false;
+
+        }
+
+        return validAction;
+    }
+
+    private void getBondedDevices(CallbackContext callbackContext) {
+        JSONArray bonded = new JSONArray();
+        Set<BluetoothDevice> bondedDevices =  bluetoothAdapter.getBondedDevices();
+
+        for (BluetoothDevice device : bondedDevices) {
+            device.getBondState();
+            int type = device.getType();
+
+            // just low energy devices (filters out classic and unknown devices)
+            if (type == DEVICE_TYPE_LE || type == DEVICE_TYPE_DUAL) {
+                Peripheral p = new Peripheral(device);
+                bonded.put(p.asJSONObject());
+            }
+        }
+
+        callbackContext.success(bonded);
+    }
+
+    private UUID[] parseServiceUUIDList(JSONArray jsonArray) throws JSONException {
+        List<UUID> serviceUUIDs = new ArrayList<UUID>();
+
+        for(int i = 0; i < jsonArray.length(); i++){
+            String uuidString = jsonArray.getString(i);
+            serviceUUIDs.add(uuidFromString(uuidString));
+        }
+
+        return serviceUUIDs.toArray(new UUID[jsonArray.length()]);
+    }
+
+    private void onBluetoothStateChange(Intent intent) {
+        final String action = intent.getAction();
+
+        if (action.equals(BluetoothAdapter.ACTION_STATE_CHANGED)) {
+            final int state = intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR);
+            sendBluetoothStateChange(state);
+        }
+    }
+
+    private void sendBluetoothStateChange(int state) {
+        if (this.stateCallback != null) {
+            PluginResult result = new PluginResult(PluginResult.Status.OK, this.bluetoothStates.get(state));
+            result.setKeepCallback(true);
+            this.stateCallback.sendPluginResult(result);
+        }
+    }
+
+    private void addStateListener() {
+        if (this.stateReceiver == null) {
+            this.stateReceiver = new BroadcastReceiver() {
+                @Override
+                public void onReceive(Context context, Intent intent) {
+                    onBluetoothStateChange(intent);
+                }
+            };
+        }
+
+        try {
+            IntentFilter intentFilter = new IntentFilter(BluetoothAdapter.ACTION_STATE_CHANGED);
+            webView.getContext().registerReceiver(this.stateReceiver, intentFilter);
+        } catch (Exception e) {
+            LOG.e(TAG, "Error registering state receiver: " + e.getMessage(), e);
+        }
+    }
+
+    private void removeStateListener() {
+        if (this.stateReceiver != null) {
+            try {
+                webView.getContext().unregisterReceiver(this.stateReceiver);
+            } catch (Exception e) {
+                LOG.e(TAG, "Error unregistering state receiver: " + e.getMessage(), e);
+            }
+        }
+        this.stateCallback = null;
+        this.stateReceiver = null;
+    }
+
+    private void connect(CallbackContext callbackContext, String macAddress) {
+        if (!peripherals.containsKey(macAddress) && BLECentralPlugin.this.bluetoothAdapter.checkBluetoothAddress(macAddress)) {
+            BluetoothDevice device = BLECentralPlugin.this.bluetoothAdapter.getRemoteDevice(macAddress);
+            Peripheral peripheral = new Peripheral(device);
+            peripherals.put(macAddress, peripheral);
+        }
+
+        Peripheral peripheral = peripherals.get(macAddress);
+        if (peripheral != null) {
+            peripheral.connect(callbackContext, cordova.getActivity(), false);
+        } else {
+            callbackContext.error("Peripheral " + macAddress + " not found.");
+        }
+
+    }
+
+    private void autoConnect(CallbackContext callbackContext, String macAddress) {
+        Peripheral peripheral = peripherals.get(macAddress);
+
+        // allow auto-connect to connect to devices without scanning
+        if (peripheral == null) {
+            if (BluetoothAdapter.checkBluetoothAddress(macAddress)) {
+                BluetoothDevice device = bluetoothAdapter.getRemoteDevice(macAddress);
+                peripheral = new Peripheral(device);
+                peripherals.put(device.getAddress(), peripheral);
+            } else {
+                callbackContext.error(macAddress + " is not a valid MAC address.");
+                return;
+            }
+        }
+
+        peripheral.connect(callbackContext, cordova.getActivity(), true);
+
+    }
+
+    private void disconnect(CallbackContext callbackContext, String macAddress) {
+
+        Peripheral peripheral = peripherals.get(macAddress);
+        if (peripheral != null) {
+            peripheral.disconnect();
+            callbackContext.success();
+        } else {
+            String message = "Peripheral " + macAddress + " not found.";
+            LOG.w(TAG, message);
+            callbackContext.error(message);
+        }
+
+    }
+
+    private void requestMtu(CallbackContext callbackContext, String macAddress, int mtuValue) {
+
+        Peripheral peripheral = peripherals.get(macAddress);
+        if (peripheral != null) {
+            peripheral.requestMtu(mtuValue);
+        }
+        callbackContext.success();
+    }
+
+    private void refreshDeviceCache(CallbackContext callbackContext, String macAddress, long timeoutMillis) {
+
+        Peripheral peripheral = peripherals.get(macAddress);
+
+        if (peripheral != null) {
+            peripheral.refreshDeviceCache(callbackContext, timeoutMillis);
+        } else {
+            String message = "Peripheral " + macAddress + " not found.";
+            LOG.w(TAG, message);
+            callbackContext.error(message);
+        }
+    }
+
+    private void read(CallbackContext callbackContext, String macAddress, UUID serviceUUID, UUID characteristicUUID) {
+
+        Peripheral peripheral = peripherals.get(macAddress);
+
+        if (peripheral == null) {
+            callbackContext.error("Peripheral " + macAddress + " not found.");
+            return;
+        }
+
+        if (!peripheral.isConnected()) {
+            callbackContext.error("Peripheral " + macAddress + " is not connected.");
+            return;
+        }
+
+        //peripheral.readCharacteristic(callbackContext, serviceUUID, characteristicUUID);
+        peripheral.queueRead(callbackContext, serviceUUID, characteristicUUID);
+
+    }
+
+    private void readRSSI(CallbackContext callbackContext, String macAddress) {
+
+        Peripheral peripheral = peripherals.get(macAddress);
+
+        if (peripheral == null) {
+            callbackContext.error("Peripheral " + macAddress + " not found.");
+            return;
+        }
+
+        if (!peripheral.isConnected()) {
+            callbackContext.error("Peripheral " + macAddress + " is not connected.");
+            return;
+        }
+        peripheral.queueReadRSSI(callbackContext);
+    }
+
+    private void write(CallbackContext callbackContext, String macAddress, UUID serviceUUID, UUID characteristicUUID,
+                       byte[] data, int writeType) {
+
+        Peripheral peripheral = peripherals.get(macAddress);
+
+        if (peripheral == null) {
+            callbackContext.error("Peripheral " + macAddress + " not found.");
+            return;
+        }
+
+        if (!peripheral.isConnected()) {
+            callbackContext.error("Peripheral " + macAddress + " is not connected.");
+            return;
+        }
+
+        //peripheral.writeCharacteristic(callbackContext, serviceUUID, characteristicUUID, data, writeType);
+        peripheral.queueWrite(callbackContext, serviceUUID, characteristicUUID, data, writeType);
+
+    }
+
+    private void registerNotifyCallback(CallbackContext callbackContext, String macAddress, UUID serviceUUID, UUID characteristicUUID) {
+
+        Peripheral peripheral = peripherals.get(macAddress);
+        if (peripheral != null) {
+
+            if (!peripheral.isConnected()) {
+                callbackContext.error("Peripheral " + macAddress + " is not connected.");
+                return;
+            }
+
+            //peripheral.setOnDataCallback(serviceUUID, characteristicUUID, callbackContext);
+            peripheral.queueRegisterNotifyCallback(callbackContext, serviceUUID, characteristicUUID);
+
+        } else {
+
+            callbackContext.error("Peripheral " + macAddress + " not found");
+
+        }
+
+    }
+
+    private void removeNotifyCallback(CallbackContext callbackContext, String macAddress, UUID serviceUUID, UUID characteristicUUID) {
+
+        Peripheral peripheral = peripherals.get(macAddress);
+        if (peripheral != null) {
+
+            if (!peripheral.isConnected()) {
+                callbackContext.error("Peripheral " + macAddress + " is not connected.");
+                return;
+            }
+
+            peripheral.queueRemoveNotifyCallback(callbackContext, serviceUUID, characteristicUUID);
+
+        } else {
+
+            callbackContext.error("Peripheral " + macAddress + " not found");
+
+        }
+
+    }
+
+    private void findLowEnergyDevices(CallbackContext callbackContext, UUID[] serviceUUIDs, int scanSeconds) {
+
+        if (!locationServicesEnabled()) {
+            callbackContext.error("Location Services are disabled");
+            return;
+        }
+
+        if(!PermissionHelper.hasPermission(this, ACCESS_COARSE_LOCATION)) {
+            // save info so we can call this method again after permissions are granted
+            permissionCallback = callbackContext;
+            this.serviceUUIDs = serviceUUIDs;
+            this.scanSeconds = scanSeconds;
+            PermissionHelper.requestPermission(this, REQUEST_ACCESS_COARSE_LOCATION, ACCESS_COARSE_LOCATION);
+            return;
+        }
+
+        // return error if already scanning
+        if (bluetoothAdapter.isDiscovering()) {
+            LOG.w(TAG, "Tried to start scan while already running.");
+            callbackContext.error("Tried to start scan while already running.");
+            return;
+        }
+
+        // clear non-connected cached peripherals
+        for(Iterator<Map.Entry<String, Peripheral>> iterator = peripherals.entrySet().iterator(); iterator.hasNext(); ) {
+            Map.Entry<String, Peripheral> entry = iterator.next();
+            Peripheral device = entry.getValue();
+            boolean connecting = device.isConnecting();
+            if (connecting){
+                LOG.d(TAG, "Not removing connecting device: " + device.getDevice().getAddress());
+            }
+            if(!entry.getValue().isConnected() && !connecting) {
+                iterator.remove();
+            }
+        }
+
+        discoverCallback = callbackContext;
+
+        if (serviceUUIDs != null && serviceUUIDs.length > 0) {
+            bluetoothAdapter.startLeScan(serviceUUIDs, this);
+        } else {
+            bluetoothAdapter.startLeScan(this);
+        }
+
+        if (scanSeconds > 0) {
+            Handler handler = new Handler();
+            handler.postDelayed(new Runnable() {
+                @Override
+                public void run() {
+                    LOG.d(TAG, "Stopping Scan");
+                    BLECentralPlugin.this.bluetoothAdapter.stopLeScan(BLECentralPlugin.this);
+                }
+            }, scanSeconds * 1000);
+        }
+
+        PluginResult result = new PluginResult(PluginResult.Status.NO_RESULT);
+        result.setKeepCallback(true);
+        callbackContext.sendPluginResult(result);
+    }
+
+    private boolean locationServicesEnabled() {
+        int locationMode = 0;
+        try {
+            locationMode = Settings.Secure.getInt(cordova.getActivity().getContentResolver(), Settings.Secure.LOCATION_MODE);
+        } catch (Settings.SettingNotFoundException e) {
+            LOG.e(TAG, "Location Mode Setting Not Found", e);
+        }
+        return (locationMode > 0);
+    }
+
+    private void listKnownDevices(CallbackContext callbackContext) {
+
+        JSONArray json = new JSONArray();
+
+        // do we care about consistent order? will peripherals.values() be in order?
+        for (Map.Entry<String, Peripheral> entry : peripherals.entrySet()) {
+            Peripheral peripheral = entry.getValue();
+            if (!peripheral.isUnscanned()) {
+                json.put(peripheral.asJSONObject());
+            }
+        }
+
+        PluginResult result = new PluginResult(PluginResult.Status.OK, json);
+        callbackContext.sendPluginResult(result);
+    }
+
+    @Override
+    public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord) {
+
+        String address = device.getAddress();
+        boolean alreadyReported = peripherals.containsKey(address) && !peripherals.get(address).isUnscanned();
+
+        if (!alreadyReported) {
+
+            Peripheral peripheral = new Peripheral(device, rssi, scanRecord);
+            peripherals.put(device.getAddress(), peripheral);
+
+            if (discoverCallback != null) {
+                PluginResult result = new PluginResult(PluginResult.Status.OK, peripheral.asJSONObject());
+                result.setKeepCallback(true);
+                discoverCallback.sendPluginResult(result);
+            }
+
+        } else {
+            Peripheral peripheral = peripherals.get(address);
+            peripheral.update(rssi, scanRecord);
+            if (reportDuplicates && discoverCallback != null) {
+                PluginResult result = new PluginResult(PluginResult.Status.OK, peripheral.asJSONObject());
+                result.setKeepCallback(true);
+                discoverCallback.sendPluginResult(result);
+            }
+        }
+    }
+
+    @Override
+    public void onActivityResult(int requestCode, int resultCode, Intent data) {
+
+        if (requestCode == REQUEST_ENABLE_BLUETOOTH) {
+
+            if (resultCode == Activity.RESULT_OK) {
+                LOG.d(TAG, "User enabled Bluetooth");
+                if (enableBluetoothCallback != null) {
+                    enableBluetoothCallback.success();
+                }
+            } else {
+                LOG.d(TAG, "User did *NOT* enable Bluetooth");
+                if (enableBluetoothCallback != null) {
+                    enableBluetoothCallback.error("User did not enable Bluetooth");
+                }
+            }
+
+            enableBluetoothCallback = null;
+        }
+    }
+
+    /* @Override */
+    public void onRequestPermissionResult(int requestCode, String[] permissions, int[] grantResults) {
+        for(int result:grantResults) {
+            if(result == PackageManager.PERMISSION_DENIED) {
+                LOG.d(TAG, "User *rejected* Coarse Location Access");
+                this.permissionCallback.error("Location permission not granted.");
+                return;
+            }
+        }
+
+        switch(requestCode) {
+            case REQUEST_ACCESS_COARSE_LOCATION:
+                LOG.d(TAG, "User granted Coarse Location Access");
+                findLowEnergyDevices(permissionCallback, serviceUUIDs, scanSeconds);
+                this.permissionCallback = null;
+                this.serviceUUIDs = null;
+                this.scanSeconds = -1;
+                break;
+        }
+    }
+
+    private UUID uuidFromString(String uuid) {
+        return UUIDHelper.uuidFromString(uuid);
+    }
+
+    /**
+     * Reset the BLE scanning options
+     */
+    private void resetScanOptions() {
+        this.reportDuplicates = false;
+    }
+
+}

plugins/cordova-plugin-ble-central/src/android/BLECommand.java

@@ -0,0 +1,61 @@
+package com.megster.cordova.ble.central;
+
+import org.apache.cordova.CallbackContext;
+
+import java.util.UUID;
+
+/**
+ * Android BLE stack is async but doesn't queue commands, so it ignore additional commands when processing. WTF?
+ * This is an object to encapsulate the command data for queuing
+ */
+class BLECommand {
+    // Types
+    public static int READ = 10000;
+    public static int REGISTER_NOTIFY = 10001;
+    public static int REMOVE_NOTIFY = 10002;
+    public static int READ_RSSI = 10003;
+    // BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE
+    // BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT
+
+    private CallbackContext callbackContext;
+    private UUID serviceUUID;
+    private UUID characteristicUUID;
+    private byte[] data;
+    private int type;
+
+
+    public BLECommand(CallbackContext callbackContext, UUID serviceUUID, UUID characteristicUUID, int type) {
+        this.callbackContext = callbackContext;
+        this.serviceUUID = serviceUUID;
+        this.characteristicUUID = characteristicUUID;
+        this.type = type;
+    }
+
+    public BLECommand(CallbackContext callbackContext, UUID serviceUUID, UUID characteristicUUID, byte[] data, int type) {
+        this.callbackContext = callbackContext;
+        this.serviceUUID = serviceUUID;
+        this.characteristicUUID = characteristicUUID;
+        this.data = data;
+        this.type = type;
+    }
+
+    public int getType() {
+        return type;
+    }
+
+    public CallbackContext getCallbackContext() {
+        return callbackContext;
+    }
+
+    public UUID getServiceUUID() {
+        return serviceUUID;
+    }
+
+    public UUID getCharacteristicUUID() {
+        return characteristicUUID;
+    }
+
+    public byte[] getData() {
+        return data;
+    }
+}

plugins/cordova-plugin-ble-central/src/android/Helper.java

@@ -0,0 +1,158 @@
+// (c) 2104 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package com.megster.cordova.ble.central;
+
+import android.bluetooth.BluetoothGattCharacteristic;
+import android.bluetooth.BluetoothGattDescriptor;
+import org.json.JSONArray;
+
+public class Helper {
+
+    public static JSONArray decodeProperties(BluetoothGattCharacteristic characteristic) {
+
+        // NOTE: props strings need to be consistent across iOS and Android
+        JSONArray props = new JSONArray();
+        int properties = characteristic.getProperties();
+
+        if ((properties & BluetoothGattCharacteristic.PROPERTY_BROADCAST) != 0x0 ) {
+            props.put("Broadcast");
+        }
+
+        if ((properties & BluetoothGattCharacteristic.PROPERTY_READ) != 0x0 ) {
+            props.put("Read");
+        }
+
+        if ((properties & BluetoothGattCharacteristic.PROPERTY_WRITE_NO_RESPONSE) != 0x0 ) {
+            props.put("WriteWithoutResponse");
+        }
+
+        if ((properties & BluetoothGattCharacteristic.PROPERTY_WRITE) != 0x0 ) {
+            props.put("Write");
+        }
+
+        if ((properties & BluetoothGattCharacteristic.PROPERTY_NOTIFY) != 0x0 ) {
+            props.put("Notify");
+        }
+
+        if ((properties & BluetoothGattCharacteristic.PROPERTY_INDICATE) != 0x0 ) {
+            props.put("Indicate");
+        }
+
+        if ((properties & BluetoothGattCharacteristic.PROPERTY_SIGNED_WRITE) != 0x0 ) {
+            // Android calls this "write with signature", using iOS name for now
+            props.put("AuthenticateSignedWrites");
+        }
+
+        if ((properties & BluetoothGattCharacteristic.PROPERTY_EXTENDED_PROPS) != 0x0 ) {
+            props.put("ExtendedProperties");
+        }
+
+//      iOS only?
+//
+//            if ((p & CBCharacteristicPropertyNotifyEncryptionRequired) != 0x0) {  // 0x100
+//                [props addObject:@"NotifyEncryptionRequired"];
+//            }
+//
+//            if ((p & CBCharacteristicPropertyIndicateEncryptionRequired) != 0x0) { // 0x200
+//                [props addObject:@"IndicateEncryptionRequired"];
+//            }
+
+        return props;
+    }
+
+    public static JSONArray decodePermissions(BluetoothGattCharacteristic characteristic) {
+
+        // NOTE: props strings need to be consistent across iOS and Android
+        JSONArray props = new JSONArray();
+        int permissions = characteristic.getPermissions();
+
+        if ((permissions & BluetoothGattCharacteristic.PERMISSION_READ) != 0x0 ) {
+            props.put("Read");
+        }
+
+        if ((permissions & BluetoothGattCharacteristic.PERMISSION_WRITE) != 0x0 ) {
+            props.put("Write");
+        }
+
+        if ((permissions & BluetoothGattCharacteristic.PERMISSION_READ_ENCRYPTED) != 0x0 ) {
+            props.put("ReadEncrypted");
+        }
+
+        if ((permissions & BluetoothGattCharacteristic.PERMISSION_WRITE_ENCRYPTED) != 0x0 ) {
+            props.put("WriteEncrypted");
+        }
+
+        if ((permissions & BluetoothGattCharacteristic.PERMISSION_READ_ENCRYPTED_MITM) != 0x0 ) {
+            props.put("ReadEncryptedMITM");
+        }
+
+        if ((permissions & BluetoothGattCharacteristic.PERMISSION_WRITE_ENCRYPTED_MITM) != 0x0 ) {
+            props.put("WriteEncryptedMITM");
+        }
+
+        if ((permissions & BluetoothGattCharacteristic.PERMISSION_WRITE_SIGNED) != 0x0 ) {
+            props.put("WriteSigned");
+        }
+
+        if ((permissions & BluetoothGattCharacteristic.PERMISSION_WRITE_SIGNED_MITM) != 0x0 ) {
+            props.put("WriteSignedMITM");
+        }
+
+        return props;
+    }
+
+    public static JSONArray decodePermissions(BluetoothGattDescriptor descriptor) {
+
+        // NOTE: props strings need to be consistent across iOS and Android
+        JSONArray props = new JSONArray();
+        int permissions = descriptor.getPermissions();
+
+        if ((permissions & BluetoothGattDescriptor.PERMISSION_READ) != 0x0 ) {
+            props.put("Read");
+        }
+
+        if ((permissions & BluetoothGattDescriptor.PERMISSION_WRITE) != 0x0 ) {
+            props.put("Write");
+        }
+
+        if ((permissions & BluetoothGattDescriptor.PERMISSION_READ_ENCRYPTED) != 0x0 ) {
+            props.put("ReadEncrypted");
+        }
+
+        if ((permissions & BluetoothGattDescriptor.PERMISSION_WRITE_ENCRYPTED) != 0x0 ) {
+            props.put("WriteEncrypted");
+        }
+
+        if ((permissions & BluetoothGattDescriptor.PERMISSION_READ_ENCRYPTED_MITM) != 0x0 ) {
+            props.put("ReadEncryptedMITM");
+        }
+
+        if ((permissions & BluetoothGattDescriptor.PERMISSION_WRITE_ENCRYPTED_MITM) != 0x0 ) {
+            props.put("WriteEncryptedMITM");
+        }
+
+        if ((permissions & BluetoothGattDescriptor.PERMISSION_WRITE_SIGNED) != 0x0 ) {
+            props.put("WriteSigned");
+        }
+
+        if ((permissions & BluetoothGattDescriptor.PERMISSION_WRITE_SIGNED_MITM) != 0x0 ) {
+            props.put("WriteSignedMITM");
+        }
+
+        return props;
+    }
+
+}
+

plugins/cordova-plugin-ble-central/src/android/Peripheral.java

@@ -0,0 +1,880 @@
+// (c) 2104 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package com.megster.cordova.ble.central;
+
+import android.app.Activity;
+
+import android.bluetooth.*;
+import android.os.Build;
+import android.os.Handler;
+import android.util.Base64;
+import org.apache.cordova.CallbackContext;
+import org.apache.cordova.LOG;
+import org.apache.cordova.PluginResult;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.*;
+import java.util.concurrent.ConcurrentLinkedQueue;
+
+import java.lang.reflect.Method;
+
+/**
+ * Peripheral wraps the BluetoothDevice and provides methods to convert to JSON.
+ */
+public class Peripheral extends BluetoothGattCallback {
+
+    // 0x2902 org.bluetooth.descriptor.gatt.client_characteristic_configuration.xml
+    //public final static UUID CLIENT_CHARACTERISTIC_CONFIGURATION_UUID = UUID.fromString("00002902-0000-1000-8000-00805F9B34FB");
+    public final static UUID CLIENT_CHARACTERISTIC_CONFIGURATION_UUID = UUIDHelper.uuidFromString("2902");
+    private static final String TAG = "Peripheral";
+
+    private static final int FAKE_PERIPHERAL_RSSI = 0x7FFFFFFF;
+
+    private BluetoothDevice device;
+    private byte[] advertisingData;
+    private int advertisingRSSI;
+    private boolean autoconnect = false;
+    private boolean connected = false;
+    private boolean connecting = false;
+    private ConcurrentLinkedQueue<BLECommand> commandQueue = new ConcurrentLinkedQueue<BLECommand>();
+    private boolean bleProcessing;
+
+    BluetoothGatt gatt;
+
+    private CallbackContext connectCallback;
+    private CallbackContext refreshCallback;
+    private CallbackContext readCallback;
+    private CallbackContext writeCallback;
+    private Activity currentActivity;
+
+    private Map<String, CallbackContext> notificationCallbacks = new HashMap<String, CallbackContext>();
+
+    public Peripheral(BluetoothDevice device) {
+
+        LOG.d(TAG, "Creating un-scanned peripheral entry for address: " + device.getAddress());
+
+        this.device = device;
+        this.advertisingRSSI = FAKE_PERIPHERAL_RSSI;
+        this.advertisingData = null;
+
+    }
+
+    public Peripheral(BluetoothDevice device, int advertisingRSSI, byte[] scanRecord) {
+
+        this.device = device;
+        this.advertisingRSSI = advertisingRSSI;
+        this.advertisingData = scanRecord;
+
+    }
+
+    private void gattConnect() {
+
+        if (gatt != null) {
+            gatt.disconnect();
+            gatt.close();
+            gatt = null;
+        }
+        connected = false;
+        connecting = true;
+        queueCleanup();
+        callbackCleanup();
+
+        BluetoothDevice device = getDevice();
+        if (Build.VERSION.SDK_INT < 23) {
+            gatt = device.connectGatt(currentActivity, autoconnect, this);
+        } else {
+            gatt = device.connectGatt(currentActivity, autoconnect, this, BluetoothDevice.TRANSPORT_LE);
+        }
+
+    }
+
+    public void connect(CallbackContext callbackContext, Activity activity, boolean auto) {
+        currentActivity = activity;
+        autoconnect = auto;
+        connectCallback = callbackContext;
+
+        gattConnect();
+
+        PluginResult result = new PluginResult(PluginResult.Status.NO_RESULT);
+        result.setKeepCallback(true);
+        callbackContext.sendPluginResult(result);
+    }
+
+    // the app requested the central disconnect from the peripheral
+    // disconnect the gatt, do not call connectCallback.error
+    public void disconnect() {
+        connected = false;
+        connecting = false;
+
+        if (gatt != null) {
+            gatt.disconnect();
+            gatt.close();
+            gatt = null;
+        }
+        queueCleanup();
+        callbackCleanup();
+    }
+
+    // the peripheral disconnected
+    // always call connectCallback.error to notify the app
+    private void peripheralDisconnected() {
+        connected = false;
+        connecting = false;
+
+        // don't remove the gatt for autoconnect
+        if (!autoconnect && gatt != null) {
+            gatt.disconnect();
+            gatt.close();
+            gatt = null;
+        }
+
+        sendDisconnectMessage();
+
+        queueCleanup();
+        callbackCleanup();
+    }
+
+    // notify the phone that the peripheral disconnected
+    private void sendDisconnectMessage() {
+        if (connectCallback != null) {
+            JSONObject message = this.asJSONObject("Peripheral Disconnected");
+            if (autoconnect) {
+                PluginResult result = new PluginResult(PluginResult.Status.ERROR, message);
+                result.setKeepCallback(true);
+                connectCallback.sendPluginResult(result);
+            } else {
+                connectCallback.error(message);
+                connectCallback = null;
+            }
+        }
+    }
+
+    @Override
+    public void onMtuChanged(BluetoothGatt gatt, int mtu, int status) {
+        LOG.d(TAG, "mtu=" + mtu + ", status=" + status);
+        super.onMtuChanged(gatt, mtu, status);
+    }
+
+    public void requestMtu(int mtuValue) {
+        if (gatt != null) {
+            LOG.d(TAG, "requestMtu mtu=" + mtuValue);
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+                gatt.requestMtu(mtuValue);
+            }
+        }
+    }
+
+    /**
+     * Uses reflection to refresh the device cache. This *might* be helpful if a peripheral changes
+     * services or characteristics and does not correctly implement Service Changed 0x2a05
+     * on Generic Attribute Service 0x1801.
+     *
+     * Since this uses an undocumented API it's not guaranteed to work.
+     *
+     */
+    public void refreshDeviceCache(CallbackContext callback, final long timeoutMillis) {
+        LOG.d(TAG, "refreshDeviceCache");
+
+        boolean success = false;
+        if (gatt != null) {
+            try {
+                final Method refresh = gatt.getClass().getMethod("refresh");
+                if (refresh != null) {
+                    success = (Boolean)refresh.invoke(gatt);
+                    if (success) {
+                        this.refreshCallback = callback;
+                        Handler handler = new Handler();
+                        handler.postDelayed(new Runnable() {
+                            @Override
+                            public void run() {
+                                LOG.d(TAG, "Waiting " + timeoutMillis + " milliseconds before discovering services");
+                                gatt.discoverServices();
+                            }
+                        }, timeoutMillis);
+                    }
+                } else {
+                    LOG.w(TAG, "Refresh method not found on gatt");
+                }
+            } catch(Exception e) {
+                LOG.e(TAG, "refreshDeviceCache Failed", e);
+            }
+        }
+
+        if (!success) {
+            callback.error("Service refresh failed");
+        }
+    }
+
+    public boolean isUnscanned() {
+        return advertisingData == null;
+    }
+
+    public JSONObject asJSONObject()  {
+
+        JSONObject json = new JSONObject();
+
+        try {
+            json.put("name", device.getName());
+            json.put("id", device.getAddress()); // mac address
+            if (advertisingData != null) {
+                json.put("advertising", byteArrayToJSON(advertisingData));
+            }
+            // TODO real RSSI if we have it, else
+            if (advertisingRSSI != FAKE_PERIPHERAL_RSSI) {
+                json.put("rssi", advertisingRSSI);
+            }
+        } catch (JSONException e) { // this shouldn't happen
+            e.printStackTrace();
+        }
+
+        return json;
+    }
+
+    public JSONObject asJSONObject(String errorMessage)  {
+
+        JSONObject json = new JSONObject();
+
+        try {
+            json.put("name", device.getName());
+            json.put("id", device.getAddress()); // mac address
+            json.put("errorMessage", errorMessage);
+        } catch (JSONException e) { // this shouldn't happen
+            e.printStackTrace();
+        }
+
+        return json;
+    }
+
+    public JSONObject asJSONObject(BluetoothGatt gatt) {
+
+        JSONObject json = asJSONObject();
+
+        try {
+            JSONArray servicesArray = new JSONArray();
+            JSONArray characteristicsArray = new JSONArray();
+            json.put("services", servicesArray);
+            json.put("characteristics", characteristicsArray);
+
+            if (connected && gatt != null) {
+                for (BluetoothGattService service : gatt.getServices()) {
+                    servicesArray.put(UUIDHelper.uuidToString(service.getUuid()));
+
+                    for (BluetoothGattCharacteristic characteristic : service.getCharacteristics()) {
+                        JSONObject characteristicsJSON = new JSONObject();
+                        characteristicsArray.put(characteristicsJSON);
+
+                        characteristicsJSON.put("service", UUIDHelper.uuidToString(service.getUuid()));
+                        characteristicsJSON.put("characteristic", UUIDHelper.uuidToString(characteristic.getUuid()));
+                        //characteristicsJSON.put("instanceId", characteristic.getInstanceId());
+
+                        characteristicsJSON.put("properties", Helper.decodeProperties(characteristic));
+                            // characteristicsJSON.put("propertiesValue", characteristic.getProperties());
+
+                        if (characteristic.getPermissions() > 0) {
+                            characteristicsJSON.put("permissions", Helper.decodePermissions(characteristic));
+                            // characteristicsJSON.put("permissionsValue", characteristic.getPermissions());
+                        }
+
+                        JSONArray descriptorsArray = new JSONArray();
+
+                        for (BluetoothGattDescriptor descriptor: characteristic.getDescriptors()) {
+                            JSONObject descriptorJSON = new JSONObject();
+                            descriptorJSON.put("uuid", UUIDHelper.uuidToString(descriptor.getUuid()));
+                            descriptorJSON.put("value", descriptor.getValue()); // always blank
+
+                            if (descriptor.getPermissions() > 0) {
+                                descriptorJSON.put("permissions", Helper.decodePermissions(descriptor));
+                                // descriptorJSON.put("permissionsValue", descriptor.getPermissions());
+                            }
+                            descriptorsArray.put(descriptorJSON);
+                        }
+                        if (descriptorsArray.length() > 0) {
+                            characteristicsJSON.put("descriptors", descriptorsArray);
+                        }
+                    }
+                }
+            }
+        } catch (JSONException e) { // TODO better error handling
+            e.printStackTrace();
+        }
+
+        return json;
+    }
+
+    static JSONObject byteArrayToJSON(byte[] bytes) throws JSONException {
+        JSONObject object = new JSONObject();
+        object.put("CDVType", "ArrayBuffer");
+        object.put("data", Base64.encodeToString(bytes, Base64.NO_WRAP));
+        return object;
+    }
+
+    public boolean isConnected() {
+        return connected;
+    }
+
+    public boolean isConnecting() {
+        return connecting;
+    }
+
+    public BluetoothDevice getDevice() {
+        return device;
+    }
+
+    @Override
+    public void onServicesDiscovered(BluetoothGatt gatt, int status) {
+        super.onServicesDiscovered(gatt, status);
+
+        // refreshCallback is a kludge for refreshing services, if it exists, it temporarily
+        // overrides the connect callback. Unfortunately this edge case make the code confusing.
+
+        if (status == BluetoothGatt.GATT_SUCCESS) {
+            PluginResult result = new PluginResult(PluginResult.Status.OK, this.asJSONObject(gatt));
+            result.setKeepCallback(true);
+            if (refreshCallback != null) {
+                refreshCallback.sendPluginResult(result);
+                refreshCallback = null;
+            } else {
+                connectCallback.sendPluginResult(result);
+            }
+        } else {
+            LOG.e(TAG, "Service discovery failed. status = " + status);
+            if (refreshCallback != null) {
+                refreshCallback.error(this.asJSONObject("Service discovery failed"));
+                refreshCallback = null;
+            } else {
+                connectCallback.error(this.asJSONObject("Service discovery failed"));
+                disconnect();
+            }
+        }
+    }
+
+    @Override
+    public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
+
+        this.gatt = gatt;
+
+        if (newState == BluetoothGatt.STATE_CONNECTED) {
+            LOG.d(TAG, "onConnectionStateChange CONNECTED");
+            connected = true;
+            connecting = false;
+            gatt.discoverServices();
+
+        } else {  // Disconnected
+            LOG.d(TAG, "onConnectionStateChange DISCONNECTED");
+            connected = false;
+            peripheralDisconnected();
+
+        }
+
+    }
+
+    @Override
+    public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {
+        super.onCharacteristicChanged(gatt, characteristic);
+        LOG.d(TAG, "onCharacteristicChanged " + characteristic);
+
+        CallbackContext callback = notificationCallbacks.get(generateHashKey(characteristic));
+
+        if (callback != null) {
+            PluginResult result = new PluginResult(PluginResult.Status.OK, characteristic.getValue());
+            result.setKeepCallback(true);
+            callback.sendPluginResult(result);
+        }
+    }
+
+    @Override
+    public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
+        super.onCharacteristicRead(gatt, characteristic, status);
+        LOG.d(TAG, "onCharacteristicRead " + characteristic);
+
+        synchronized(this) {
+            if (readCallback != null) {
+                if (status == BluetoothGatt.GATT_SUCCESS) {
+                    readCallback.success(characteristic.getValue());
+                } else {
+                    readCallback.error("Error reading " + characteristic.getUuid() + " status=" + status);
+                }
+
+                readCallback = null;
+            }
+        }
+
+        commandCompleted();
+    }
+
+    @Override
+    public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
+        super.onCharacteristicWrite(gatt, characteristic, status);
+        LOG.d(TAG, "onCharacteristicWrite " + characteristic);
+
+        synchronized(this) {
+            if (writeCallback != null) {
+                if (status == BluetoothGatt.GATT_SUCCESS) {
+                    writeCallback.success();
+                } else {
+                    writeCallback.error(status);
+                }
+
+                writeCallback = null;
+            }
+        }
+
+        commandCompleted();
+    }
+
+    @Override
+    public void onDescriptorWrite(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) {
+        super.onDescriptorWrite(gatt, descriptor, status);
+        LOG.d(TAG, "onDescriptorWrite " + descriptor);
+        commandCompleted();
+    }
+
+
+    @Override
+    public void onReadRemoteRssi(BluetoothGatt gatt, int rssi, int status) {
+        super.onReadRemoteRssi(gatt, rssi, status);
+        synchronized(this) {
+            if (readCallback != null) {
+                if (status == BluetoothGatt.GATT_SUCCESS) {
+                    updateRssi(rssi);
+                    readCallback.success(rssi);
+                } else {
+                    readCallback.error("Error reading RSSI status=" + status);
+                }
+
+                readCallback = null;
+            }
+        }
+        commandCompleted();
+    }
+
+    // Update rssi and scanRecord.
+    public void update(int rssi, byte[] scanRecord) {
+        this.advertisingRSSI = rssi;
+        this.advertisingData = scanRecord;
+    }
+
+    public void updateRssi(int rssi) {
+        advertisingRSSI = rssi;
+    }
+
+    // This seems way too complicated
+    private void registerNotifyCallback(CallbackContext callbackContext, UUID serviceUUID, UUID characteristicUUID) {
+
+        boolean success = false;
+
+        if (gatt == null) {
+            callbackContext.error("BluetoothGatt is null");
+            return;
+        }
+
+        BluetoothGattService service = gatt.getService(serviceUUID);
+        BluetoothGattCharacteristic characteristic = findNotifyCharacteristic(service, characteristicUUID);
+        String key = generateHashKey(serviceUUID, characteristic);
+
+        if (characteristic != null) {
+
+            notificationCallbacks.put(key, callbackContext);
+
+            if (gatt.setCharacteristicNotification(characteristic, true)) {
+
+                // Why doesn't setCharacteristicNotification write the descriptor?
+                BluetoothGattDescriptor descriptor = characteristic.getDescriptor(CLIENT_CHARACTERISTIC_CONFIGURATION_UUID);
+                if (descriptor != null) {
+
+                    // prefer notify over indicate
+                    if ((characteristic.getProperties() & BluetoothGattCharacteristic.PROPERTY_NOTIFY) != 0) {
+                        descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);
+                    } else if ((characteristic.getProperties() & BluetoothGattCharacteristic.PROPERTY_INDICATE) != 0) {
+                        descriptor.setValue(BluetoothGattDescriptor.ENABLE_INDICATION_VALUE);
+                    } else {
+                        LOG.w(TAG, "Characteristic " + characteristicUUID + " does not have NOTIFY or INDICATE property set");
+                    }
+
+                    if (gatt.writeDescriptor(descriptor)) {
+                        success = true;
+                    } else {
+                        callbackContext.error("Failed to set client characteristic notification for " + characteristicUUID);
+                    }
+
+                } else {
+                    callbackContext.error("Set notification failed for " + characteristicUUID);
+                }
+
+            } else {
+                callbackContext.error("Failed to register notification for " + characteristicUUID);
+            }
+
+        } else {
+            callbackContext.error("Characteristic " + characteristicUUID + " not found");
+        }
+
+        if (!success) {
+            commandCompleted();
+        }
+    }
+
+    private void removeNotifyCallback(CallbackContext callbackContext, UUID serviceUUID, UUID characteristicUUID) {
+
+        if (gatt == null) {
+            callbackContext.error("BluetoothGatt is null");
+            return;
+        }
+
+        BluetoothGattService service = gatt.getService(serviceUUID);
+        BluetoothGattCharacteristic characteristic = findNotifyCharacteristic(service, characteristicUUID);
+        String key = generateHashKey(serviceUUID, characteristic);
+
+        if (characteristic != null) {
+
+            notificationCallbacks.remove(key);
+
+            if (gatt.setCharacteristicNotification(characteristic, false)) {
+                BluetoothGattDescriptor descriptor = characteristic.getDescriptor(CLIENT_CHARACTERISTIC_CONFIGURATION_UUID);
+                if (descriptor != null) {
+                    descriptor.setValue(BluetoothGattDescriptor.DISABLE_NOTIFICATION_VALUE);
+                    gatt.writeDescriptor(descriptor);
+                }
+                callbackContext.success();
+            } else {
+                // TODO we can probably ignore and return success anyway since we removed the notification callback
+                callbackContext.error("Failed to stop notification for " + characteristicUUID);
+            }
+
+        } else {
+            callbackContext.error("Characteristic " + characteristicUUID + " not found");
+        }
+
+        commandCompleted();
+
+    }
+
+    // Some devices reuse UUIDs across characteristics, so we can't use service.getCharacteristic(characteristicUUID)
+    // instead check the UUID and properties for each characteristic in the service until we find the best match
+    // This function prefers Notify over Indicate
+    private BluetoothGattCharacteristic findNotifyCharacteristic(BluetoothGattService service, UUID characteristicUUID) {
+        BluetoothGattCharacteristic characteristic = null;
+
+        // Check for Notify first
+        List<BluetoothGattCharacteristic> characteristics = service.getCharacteristics();
+        for (BluetoothGattCharacteristic c : characteristics) {
+            if ((c.getProperties() & BluetoothGattCharacteristic.PROPERTY_NOTIFY) != 0 && characteristicUUID.equals(c.getUuid())) {
+                characteristic = c;
+                break;
+            }
+        }
+
+        if (characteristic != null) return characteristic;
+
+        // If there wasn't Notify Characteristic, check for Indicate
+        for (BluetoothGattCharacteristic c : characteristics) {
+            if ((c.getProperties() & BluetoothGattCharacteristic.PROPERTY_INDICATE) != 0 && characteristicUUID.equals(c.getUuid())) {
+                characteristic = c;
+                break;
+            }
+        }
+
+        // As a last resort, try and find ANY characteristic with this UUID, even if it doesn't have the correct properties
+        if (characteristic == null) {
+            characteristic = service.getCharacteristic(characteristicUUID);
+        }
+
+        return characteristic;
+    }
+
+    private void readCharacteristic(CallbackContext callbackContext, UUID serviceUUID, UUID characteristicUUID) {
+
+        boolean success = false;
+
+        if (gatt == null) {
+            callbackContext.error("BluetoothGatt is null");
+            return;
+        }
+
+        BluetoothGattService service = gatt.getService(serviceUUID);
+
+        if (service == null) {
+            callbackContext.error("Service " + serviceUUID + " not found.");
+            return;
+        }
+
+        BluetoothGattCharacteristic characteristic = findReadableCharacteristic(service, characteristicUUID);
+
+        if (characteristic == null) {
+            callbackContext.error("Characteristic " + characteristicUUID + " not found.");
+        } else {
+            synchronized(this) {
+                readCallback = callbackContext;
+                if (gatt.readCharacteristic(characteristic)) {
+                    success = true;
+                } else {
+                    readCallback = null;
+                    callbackContext.error("Read failed");
+                }
+            }
+        }
+
+        if (!success) {
+            commandCompleted();
+        }
+
+    }
+
+    private void readRSSI(CallbackContext callbackContext) {
+
+        boolean success = false;
+
+        if (gatt == null) {
+            callbackContext.error("BluetoothGatt is null");
+            return;
+        }
+
+        synchronized(this) {
+            readCallback = callbackContext;
+
+            if (gatt.readRemoteRssi()) {
+                success = true;
+            } else {
+                readCallback = null;
+                callbackContext.error("Read RSSI failed");
+            }
+        }
+
+        if (!success) {
+            commandCompleted();
+        }
+
+    }
+
+    // Some peripherals re-use UUIDs for multiple characteristics so we need to check the properties
+    // and UUID of all characteristics instead of using service.getCharacteristic(characteristicUUID)
+    private BluetoothGattCharacteristic findReadableCharacteristic(BluetoothGattService service, UUID characteristicUUID) {
+        BluetoothGattCharacteristic characteristic = null;
+
+        int read = BluetoothGattCharacteristic.PROPERTY_READ;
+
+        List<BluetoothGattCharacteristic> characteristics = service.getCharacteristics();
+        for (BluetoothGattCharacteristic c : characteristics) {
+            if ((c.getProperties() & read) != 0 && characteristicUUID.equals(c.getUuid())) {
+                characteristic = c;
+                break;
+            }
+        }
+
+        // As a last resort, try and find ANY characteristic with this UUID, even if it doesn't have the correct properties
+        if (characteristic == null) {
+            characteristic = service.getCharacteristic(characteristicUUID);
+        }
+
+        return characteristic;
+    }
+
+    private void writeCharacteristic(CallbackContext callbackContext, UUID serviceUUID, UUID characteristicUUID, byte[] data, int writeType) {
+
+        boolean success = false;
+
+        if (gatt == null) {
+            callbackContext.error("BluetoothGatt is null");
+            return;
+        }
+
+        BluetoothGattService service = gatt.getService(serviceUUID);
+
+        if (service == null) {
+            callbackContext.error("Service " + serviceUUID + " not found.");
+            return;
+        }
+
+        BluetoothGattCharacteristic characteristic = findWritableCharacteristic(service, characteristicUUID, writeType);
+
+        if (characteristic == null) {
+            callbackContext.error("Characteristic " + characteristicUUID + " not found.");
+        } else {
+            characteristic.setValue(data);
+            characteristic.setWriteType(writeType);
+            synchronized(this) {
+                writeCallback = callbackContext;
+
+                if (gatt.writeCharacteristic(characteristic)) {
+                    success = true;
+                } else {
+                    writeCallback = null;
+                    callbackContext.error("Write failed");
+                }
+            }
+        }
+
+        if (!success) {
+            commandCompleted();
+        }
+
+    }
+
+    // Some peripherals re-use UUIDs for multiple characteristics so we need to check the properties
+    // and UUID of all characteristics instead of using service.getCharacteristic(characteristicUUID)
+    private BluetoothGattCharacteristic findWritableCharacteristic(BluetoothGattService service, UUID characteristicUUID, int writeType) {
+        BluetoothGattCharacteristic characteristic = null;
+
+        // get write property
+        int writeProperty = BluetoothGattCharacteristic.PROPERTY_WRITE;
+        if (writeType == BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE) {
+            writeProperty = BluetoothGattCharacteristic.PROPERTY_WRITE_NO_RESPONSE;
+        }
+
+        List<BluetoothGattCharacteristic> characteristics = service.getCharacteristics();
+        for (BluetoothGattCharacteristic c : characteristics) {
+            if ((c.getProperties() & writeProperty) != 0 && characteristicUUID.equals(c.getUuid())) {
+                characteristic = c;
+                break;
+            }
+        }
+
+        // As a last resort, try and find ANY characteristic with this UUID, even if it doesn't have the correct properties
+        if (characteristic == null) {
+            characteristic = service.getCharacteristic(characteristicUUID);
+        }
+
+        return characteristic;
+    }
+
+    public void queueRead(CallbackContext callbackContext, UUID serviceUUID, UUID characteristicUUID) {
+        BLECommand command = new BLECommand(callbackContext, serviceUUID, characteristicUUID, BLECommand.READ);
+        queueCommand(command);
+    }
+
+    public void queueWrite(CallbackContext callbackContext, UUID serviceUUID, UUID characteristicUUID, byte[] data, int writeType) {
+        BLECommand command = new BLECommand(callbackContext, serviceUUID, characteristicUUID, data, writeType);
+        queueCommand(command);
+    }
+
+    public void queueRegisterNotifyCallback(CallbackContext callbackContext, UUID serviceUUID, UUID characteristicUUID) {
+        BLECommand command = new BLECommand(callbackContext, serviceUUID, characteristicUUID, BLECommand.REGISTER_NOTIFY);
+        queueCommand(command);
+    }
+
+    public void queueRemoveNotifyCallback(CallbackContext callbackContext, UUID serviceUUID, UUID characteristicUUID) {
+        BLECommand command = new BLECommand(callbackContext, serviceUUID, characteristicUUID, BLECommand.REMOVE_NOTIFY);
+        queueCommand(command);
+    }
+
+
+    public void queueReadRSSI(CallbackContext callbackContext) {
+        BLECommand command = new BLECommand(callbackContext, null, null, BLECommand.READ_RSSI);
+        queueCommand(command);
+    }
+
+    private void queueCleanup() {
+        bleProcessing = false;
+        BLECommand command;
+        for (;;) {
+            command = commandQueue.poll();
+            if (command != null) {
+                command.getCallbackContext().error("Peripheral Disconnected");
+            }
+            else {
+                break;
+            }
+        }
+    }
+
+    private void callbackCleanup() {
+        synchronized(this) {
+            if (readCallback != null) {
+                readCallback.error(this.asJSONObject("Peripheral Disconnected"));
+                readCallback = null;
+                commandCompleted();
+            }
+            if (writeCallback != null) {
+                writeCallback.error(this.asJSONObject("Peripheral Disconnected"));
+                writeCallback = null;
+                commandCompleted();
+            }
+        }
+    }
+
+    // add a new command to the queue
+    private void queueCommand(BLECommand command) {
+        LOG.d(TAG,"Queuing Command " + command);
+        commandQueue.add(command);
+
+        PluginResult result = new PluginResult(PluginResult.Status.NO_RESULT);
+        result.setKeepCallback(true);
+        command.getCallbackContext().sendPluginResult(result);
+
+        if (!bleProcessing) {
+            processCommands();
+        }
+    }
+
+    // command finished, queue the next command
+    private void commandCompleted() {
+        LOG.d(TAG,"Processing Complete");
+        bleProcessing = false;
+        processCommands();
+    }
+
+    // process the queue
+    private void processCommands() {
+        LOG.d(TAG,"Processing Commands");
+
+        if (bleProcessing) { return; }
+
+        BLECommand command = commandQueue.poll();
+        if (command != null) {
+            if (command.getType() == BLECommand.READ) {
+                LOG.d(TAG,"Read " + command.getCharacteristicUUID());
+                bleProcessing = true;
+                readCharacteristic(command.getCallbackContext(), command.getServiceUUID(), command.getCharacteristicUUID());
+            } else if (command.getType() == BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT) {
+                LOG.d(TAG,"Write " + command.getCharacteristicUUID());
+                bleProcessing = true;
+                writeCharacteristic(command.getCallbackContext(), command.getServiceUUID(), command.getCharacteristicUUID(), command.getData(), command.getType());
+            } else if (command.getType() == BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE) {
+                LOG.d(TAG,"Write No Response " + command.getCharacteristicUUID());
+                bleProcessing = true;
+                writeCharacteristic(command.getCallbackContext(), command.getServiceUUID(), command.getCharacteristicUUID(), command.getData(), command.getType());
+            } else if (command.getType() == BLECommand.REGISTER_NOTIFY) {
+                LOG.d(TAG,"Register Notify " + command.getCharacteristicUUID());
+                bleProcessing = true;
+                registerNotifyCallback(command.getCallbackContext(), command.getServiceUUID(), command.getCharacteristicUUID());
+            } else if (command.getType() == BLECommand.REMOVE_NOTIFY) {
+                LOG.d(TAG,"Remove Notify " + command.getCharacteristicUUID());
+                bleProcessing = true;
+                removeNotifyCallback(command.getCallbackContext(), command.getServiceUUID(), command.getCharacteristicUUID());
+            } else if (command.getType() == BLECommand.READ_RSSI) {
+                LOG.d(TAG,"Read RSSI");
+                bleProcessing = true;
+                readRSSI(command.getCallbackContext());
+            } else {
+                // this shouldn't happen
+                throw new RuntimeException("Unexpected BLE Command type " + command.getType());
+            }
+        } else {
+            LOG.d(TAG, "Command Queue is empty.");
+        }
+
+    }
+
+    private String generateHashKey(BluetoothGattCharacteristic characteristic) {
+        return generateHashKey(characteristic.getService().getUuid(), characteristic);
+    }
+
+    private String generateHashKey(UUID serviceUUID, BluetoothGattCharacteristic characteristic) {
+        return String.valueOf(serviceUUID) + "|" + characteristic.getUuid() + "|" + characteristic.getInstanceId();
+    }
+
+}

plugins/cordova-plugin-ble-central/src/android/UUIDHelper.java

@@ -0,0 +1,47 @@
+// (c) 2104 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package com.megster.cordova.ble.central;
+
+import java.util.UUID;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class UUIDHelper {
+
+    // base UUID used to build 128 bit Bluetooth UUIDs
+    public static final String UUID_BASE = "0000XXXX-0000-1000-8000-00805f9b34fb";
+
+    // handle 16 and 128 bit UUIDs
+    public static UUID uuidFromString(String uuid) {
+
+        if (uuid.length() == 4) {
+            uuid = UUID_BASE.replace("XXXX", uuid);
+        }
+        return UUID.fromString(uuid);
+    }
+
+    // return 16 bit UUIDs where possible
+    public static String uuidToString(UUID uuid) {
+        String longUUID = uuid.toString();
+        Pattern pattern = Pattern.compile("0000(.{4})-0000-1000-8000-00805f9b34fb", Pattern.CASE_INSENSITIVE);
+        Matcher matcher = pattern.matcher(longUUID);
+        if (matcher.matches()) {
+            // 16 bit UUID
+            return matcher.group(1);
+        } else {
+            return longUUID;
+        }
+    }
+}

plugins/cordova-plugin-ble-central/src/browser/BLECentralPlugin.js

@@ -0,0 +1,78 @@
+function notSupported() {
+    console.log('BLE is not supported on the browser');
+}
+
+module.exports = {
+    scan: function(services, seconds, success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    startScan: function(services, success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    stopScan: function(success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    startScanWithOptions: function(services, options, success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    connect: function(device_id, connectSuccess, connectFailure) {
+        notSupported();
+        if (connectFailure) connectFailure();
+    },
+    disconnect: function(device_id, connectSuccess, connectFailure) {
+        notSupported();
+        if (connectFailure) connectFailure();
+    },
+    read: function(device_id, service_uuid, characteristic_uuid, success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    readRSSI: function(device_id, success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    write: function(device_id, service_uuid, characteristic_uuid, data, success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    writeWithoutResponse: function(device_id, service_uuid, characteristic_uuid, data, success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    startNotification: function(device_id, service_uuid, characteristic_uuid, success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    stopNotifcation: function(device_id, service_uuid, characteristic_uuid, success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    isEnabled: function(success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    isConnected: function(device_id, success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    showBluetoothSettings: function(success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    enable: function(success, failure) {
+        notSupported();
+        if (failure) failure();
+    },
+    startStateNotifications: function(success, failure) {
+      notSupported();
+      if (failure) failure();
+    },
+    stopStateNotifications: function(success, failure) {
+      notSupported();
+      if (failure) failure();
+    }
+};

plugins/cordova-plugin-ble-central/src/ios/BLECentralPlugin.h

@@ -0,0 +1,73 @@
+//
+//  BLECentralPlugin.h
+//  BLE Central Cordova Plugin
+//
+//  (c) 2104 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef BLECentralPlugin_h
+#define BLECentralPlugin_h
+
+#import <Cordova/CDV.h>
+#import <CoreBluetooth/CoreBluetooth.h>
+#import "BLECommandContext.h"
+#import "CBPeripheral+Extensions.h"
+
+@interface BLECentralPlugin : CDVPlugin <CBCentralManagerDelegate, CBPeripheralDelegate> {
+    NSString* discoverPeripheralCallbackId;
+    NSString* stateCallbackId;
+    NSMutableDictionary* connectCallbacks;
+    NSMutableDictionary *readCallbacks;
+    NSMutableDictionary *writeCallbacks;
+    NSMutableDictionary *notificationCallbacks;
+    NSMutableDictionary *startNotificationCallbacks;
+    NSMutableDictionary *stopNotificationCallbacks;
+    NSMutableDictionary *connectCallbackLatches;
+    NSMutableDictionary *readRSSICallbacks;
+}
+
+@property (strong, nonatomic) NSMutableSet *peripherals;
+@property (strong, nonatomic) CBCentralManager *manager;
+
+- (void)scan:(CDVInvokedUrlCommand *)command;
+- (void)startScan:(CDVInvokedUrlCommand *)command;
+- (void)startScanWithOptions:(CDVInvokedUrlCommand *)command;
+- (void)stopScan:(CDVInvokedUrlCommand *)command;
+- (void)connectedPeripheralsWithServices:(CDVInvokedUrlCommand*)command;
+- (void)peripheralsWithIdentifiers:(CDVInvokedUrlCommand*)command;
+
+- (void)connect:(CDVInvokedUrlCommand *)command;
+- (void)autoConnect:(CDVInvokedUrlCommand *)command;
+- (void)disconnect:(CDVInvokedUrlCommand *)command;
+
+- (void)read:(CDVInvokedUrlCommand *)command;
+- (void)write:(CDVInvokedUrlCommand *)command;
+- (void)writeWithoutResponse:(CDVInvokedUrlCommand *)command;
+
+- (void)startNotification:(CDVInvokedUrlCommand *)command;
+- (void)stopNotification:(CDVInvokedUrlCommand *)command;
+
+- (void)isEnabled:(CDVInvokedUrlCommand *)command;
+- (void)isConnected:(CDVInvokedUrlCommand *)command;
+
+- (void)startStateNotifications:(CDVInvokedUrlCommand *)command;
+- (void)stopStateNotifications:(CDVInvokedUrlCommand *)command;
+
+- (void)onReset;
+
+- (void)readRSSI:(CDVInvokedUrlCommand *)command;
+
+@end
+
+#endif

plugins/cordova-plugin-ble-central/src/ios/BLECentralPlugin.m

@@ -0,0 +1,944 @@
+//
+//  BLECentralPlugin.m
+//  BLE Central Cordova Plugin
+//
+//  (c) 2104-2018 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#import "BLECentralPlugin.h"
+#import <Cordova/CDV.h>
+
+@interface BLECentralPlugin() {
+    NSDictionary *bluetoothStates;
+}
+- (CBPeripheral *)findPeripheralByUUID:(NSString *)uuid;
+- (void)stopScanTimer:(NSTimer *)timer;
+@end
+
+@implementation BLECentralPlugin
+
+@synthesize manager;
+@synthesize peripherals;
+
+- (void)pluginInitialize {
+    NSLog(@"Cordova BLE Central Plugin");
+    NSLog(@"(c)2014-2016 Don Coleman");
+
+    [super pluginInitialize];
+
+    peripherals = [NSMutableSet new];
+    manager = [[CBCentralManager alloc] initWithDelegate:self queue:nil options:@{CBCentralManagerOptionShowPowerAlertKey: @NO}];
+
+    connectCallbacks = [NSMutableDictionary new];
+    connectCallbackLatches = [NSMutableDictionary new];
+    readCallbacks = [NSMutableDictionary new];
+    writeCallbacks = [NSMutableDictionary new];
+    notificationCallbacks = [NSMutableDictionary new];
+    startNotificationCallbacks = [NSMutableDictionary new];
+    stopNotificationCallbacks = [NSMutableDictionary new];
+    bluetoothStates = [NSDictionary dictionaryWithObjectsAndKeys:
+                       @"unknown", @(CBCentralManagerStateUnknown),
+                       @"resetting", @(CBCentralManagerStateResetting),
+                       @"unsupported", @(CBCentralManagerStateUnsupported),
+                       @"unauthorized", @(CBCentralManagerStateUnauthorized),
+                       @"off", @(CBCentralManagerStatePoweredOff),
+                       @"on", @(CBCentralManagerStatePoweredOn),
+                       nil];
+    readRSSICallbacks = [NSMutableDictionary new];
+}
+
+#pragma mark - Cordova Plugin Methods
+
+// TODO add timeout
+- (void)connect:(CDVInvokedUrlCommand *)command {
+    NSLog(@"connect");
+    NSString *uuid = [command argumentAtIndex:0];
+
+    CBPeripheral *peripheral = [self findPeripheralByUUID:uuid];
+
+    if (peripheral) {
+        NSLog(@"Connecting to peripheral with UUID : %@", uuid);
+
+        [connectCallbacks setObject:[command.callbackId copy] forKey:[peripheral uuidAsString]];
+        [manager connectPeripheral:peripheral options:nil];
+    } else {
+        NSString *error = [NSString stringWithFormat:@"Could not find peripheral %@.", uuid];
+        NSLog(@"%@", error);
+        CDVPluginResult *pluginResult = nil;
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:error];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+    }
+
+}
+
+// This works different than Android. iOS needs to know about the peripheral UUID
+// If not scanning, try connectedPeripheralsWIthServices or peripheralsWithIdentifiers
+- (void)autoConnect:(CDVInvokedUrlCommand *)command {
+    NSLog(@"autoConnect");
+    NSString *uuid = [command argumentAtIndex:0];
+    
+    CBPeripheral *peripheral = [self findPeripheralByUUID:uuid];
+    
+    if (peripheral) {
+        NSLog(@"Autoconnecting to peripheral with UUID : %@", uuid);
+        
+        [connectCallbacks setObject:[command.callbackId copy] forKey:[peripheral uuidAsString]];
+        [manager connectPeripheral:peripheral options:nil];
+    } else {
+        NSString *error = [NSString stringWithFormat:@"Could not find peripheral %@.", uuid];
+        NSLog(@"%@", error);
+        CDVPluginResult *pluginResult = nil;
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:error];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+    }
+    
+}
+
+// disconnect: function (device_id, success, failure) {
+- (void)disconnect:(CDVInvokedUrlCommand*)command {
+    NSLog(@"disconnect");
+
+    NSString *uuid = [command argumentAtIndex:0];
+    CBPeripheral *peripheral = [self findPeripheralByUUID:uuid];
+
+    if (!peripheral) {
+        NSString *message = [NSString stringWithFormat:@"Peripheral %@ not found", uuid];
+        NSLog(@"%@", message);
+        CDVPluginResult *pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:message];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+
+    } else {
+
+        [connectCallbacks removeObjectForKey:uuid];
+        [self cleanupOperationCallbacks:peripheral withResult:[CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Peripheral disconnected"]];
+
+        if (peripheral && peripheral.state != CBPeripheralStateDisconnected) {
+            [manager cancelPeripheralConnection:peripheral];
+        }
+
+        CDVPluginResult *pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+    }
+}
+
+// read: function (device_id, service_uuid, characteristic_uuid, success, failure) {
+- (void)read:(CDVInvokedUrlCommand*)command {
+    NSLog(@"read");
+
+    BLECommandContext *context = [self getData:command prop:CBCharacteristicPropertyRead];
+    if (context) {
+        CBPeripheral *peripheral = [context peripheral];
+        if ([peripheral state] != CBPeripheralStateConnected) {
+            CDVPluginResult *pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Peripheral is not connected"];
+            [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+            return;
+        }
+        CBCharacteristic *characteristic = [context characteristic];
+
+        NSString *key = [self keyForPeripheral: peripheral andCharacteristic:characteristic];
+        [readCallbacks setObject:[command.callbackId copy] forKey:key];
+
+        [peripheral readValueForCharacteristic:characteristic];  // callback sends value
+    }
+}
+
+// write: function (device_id, service_uuid, characteristic_uuid, value, success, failure) {
+- (void)write:(CDVInvokedUrlCommand*)command {
+    BLECommandContext *context = [self getData:command prop:CBCharacteristicPropertyWrite];
+    NSData *message = [command argumentAtIndex:3]; // This is binary
+    if (context) {
+        if (message != nil) {
+            CBPeripheral *peripheral = [context peripheral];
+            if ([peripheral state] != CBPeripheralStateConnected) {
+                CDVPluginResult *pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Peripheral is not connected"];
+                [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+                return;
+            }
+            CBCharacteristic *characteristic = [context characteristic];
+
+            NSString *key = [self keyForPeripheral: peripheral andCharacteristic:characteristic];
+            [writeCallbacks setObject:[command.callbackId copy] forKey:key];
+
+            // TODO need to check the max length
+            [peripheral writeValue:message forCharacteristic:characteristic type:CBCharacteristicWriteWithResponse];
+
+            // response is sent from didWriteValueForCharacteristic
+        } else {
+            CDVPluginResult *pluginResult = nil;
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"message was null"];
+            [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+        }
+    }
+}
+
+// writeWithoutResponse: function (device_id, service_uuid, characteristic_uuid, value, success, failure) {
+- (void)writeWithoutResponse:(CDVInvokedUrlCommand*)command {
+    NSLog(@"writeWithoutResponse");
+
+    BLECommandContext *context = [self getData:command prop:CBCharacteristicPropertyWriteWithoutResponse];
+    NSData *message = [command argumentAtIndex:3]; // This is binary
+
+    if (context) {
+        CDVPluginResult *pluginResult = nil;
+        if (message != nil) {
+            CBPeripheral *peripheral = [context peripheral];
+            if ([peripheral state] != CBPeripheralStateConnected) {
+                CDVPluginResult *pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Peripheral is not connected"];
+                [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+                return;
+            }
+            CBCharacteristic *characteristic = [context characteristic];
+
+            // TODO need to check the max length
+            [peripheral writeValue:message forCharacteristic:characteristic type:CBCharacteristicWriteWithoutResponse];
+
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+        } else {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"message was null"];
+        }
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+    }
+}
+
+// success callback is called on notification
+// notify: function (device_id, service_uuid, characteristic_uuid, success, failure) {
+- (void)startNotification:(CDVInvokedUrlCommand*)command {
+    NSLog(@"registering for notification");
+
+    BLECommandContext *context = [self getData:command prop:CBCharacteristicPropertyNotify]; // TODO name this better
+
+    if (context) {
+        CBPeripheral *peripheral = [context peripheral];
+        if ([peripheral state] != CBPeripheralStateConnected) {
+            CDVPluginResult *pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Peripheral is not connected"];
+            [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+            return;
+        }
+        CBCharacteristic *characteristic = [context characteristic];
+
+        NSString *key = [self keyForPeripheral: peripheral andCharacteristic:characteristic];
+        NSString *callback = [command.callbackId copy];
+        [startNotificationCallbacks setObject: callback forKey: key];
+        [stopNotificationCallbacks removeObjectForKey:key];
+
+        [peripheral setNotifyValue:YES forCharacteristic:characteristic];
+
+    }
+
+}
+
+// stopNotification: function (device_id, service_uuid, characteristic_uuid, success, failure) {
+- (void)stopNotification:(CDVInvokedUrlCommand*)command {
+    NSLog(@"stop notification");
+
+    BLECommandContext *context = [self getData:command prop:CBCharacteristicPropertyNotify];
+
+    if (context) {
+        CBPeripheral *peripheral = [context peripheral];    // FIXME is setNotifyValue:NO legal to call on a peripheral not connected?
+        CBCharacteristic *characteristic = [context characteristic];
+
+        NSString *key = [self keyForPeripheral: peripheral andCharacteristic:characteristic];
+        NSString *callback = [command.callbackId copy];
+        [stopNotificationCallbacks setObject: callback forKey: key];
+
+        [peripheral setNotifyValue:NO forCharacteristic:characteristic];
+        // callback sent from peripheral:didUpdateNotificationStateForCharacteristic:error:
+
+    }
+}
+
+- (void)isEnabled:(CDVInvokedUrlCommand*)command {
+    CDVPluginResult *pluginResult = nil;
+    int bluetoothState = [manager state];
+
+    BOOL enabled = bluetoothState == CBCentralManagerStatePoweredOn;
+
+    if (enabled) {
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+    } else {
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:bluetoothState];
+    }
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+}
+
+- (void)scan:(CDVInvokedUrlCommand*)command {
+    NSLog(@"scan");
+    discoverPeripheralCallbackId = [command.callbackId copy];
+
+    NSArray<NSString *> *serviceUUIDStrings = [command argumentAtIndex:0];
+    NSNumber *timeoutSeconds = [command argumentAtIndex:1];
+    NSArray<CBUUID *> *serviceUUIDs = [self uuidStringsToCBUUIDs:serviceUUIDStrings];
+
+    [manager scanForPeripheralsWithServices:serviceUUIDs options:nil];
+
+    [NSTimer scheduledTimerWithTimeInterval:[timeoutSeconds floatValue]
+                                     target:self
+                                   selector:@selector(stopScanTimer:)
+                                   userInfo:[command.callbackId copy]
+                                    repeats:NO];
+}
+
+- (void)startScan:(CDVInvokedUrlCommand*)command {
+    NSLog(@"startScan");
+    discoverPeripheralCallbackId = [command.callbackId copy];
+    NSArray<NSString *> *serviceUUIDStrings = [command argumentAtIndex:0];
+    NSArray<CBUUID *> *serviceUUIDs = [self uuidStringsToCBUUIDs:serviceUUIDStrings];
+
+    [manager scanForPeripheralsWithServices:serviceUUIDs options:nil];
+}
+
+- (void)startScanWithOptions:(CDVInvokedUrlCommand*)command {
+    NSLog(@"startScanWithOptions");
+    discoverPeripheralCallbackId = [command.callbackId copy];
+    NSArray<NSString *> *serviceUUIDStrings = [command argumentAtIndex:0];
+    NSArray<CBUUID *> *serviceUUIDs = [self uuidStringsToCBUUIDs:serviceUUIDStrings];
+    NSDictionary *options = command.arguments[1];
+
+    NSMutableDictionary *scanOptions = [NSMutableDictionary new];
+    NSNumber *reportDuplicates = [options valueForKey: @"reportDuplicates"];
+    if (reportDuplicates) {
+        [scanOptions setValue:reportDuplicates
+                       forKey:CBCentralManagerScanOptionAllowDuplicatesKey];
+    }
+
+    [manager scanForPeripheralsWithServices:serviceUUIDs options:scanOptions];
+}
+
+- (void)stopScan:(CDVInvokedUrlCommand*)command {
+    NSLog(@"stopScan");
+
+    [manager stopScan];
+
+    if (discoverPeripheralCallbackId) {
+        discoverPeripheralCallbackId = nil;
+    }
+
+    CDVPluginResult *pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+}
+
+
+- (void)isConnected:(CDVInvokedUrlCommand*)command {
+    CDVPluginResult *pluginResult = nil;
+    CBPeripheral *peripheral = [self findPeripheralByUUID:[command argumentAtIndex:0]];
+
+    if (peripheral && peripheral.state == CBPeripheralStateConnected) {
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+    } else {
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Not connected"];
+    }
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+}
+
+- (void)startStateNotifications:(CDVInvokedUrlCommand *)command {
+    CDVPluginResult *pluginResult = nil;
+
+    if (stateCallbackId == nil) {
+        stateCallbackId = [command.callbackId copy];
+        int bluetoothState = [manager state];
+        NSString *state = [bluetoothStates objectForKey:[NSNumber numberWithInt:bluetoothState]];
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:state];
+        [pluginResult setKeepCallbackAsBool:TRUE];
+        NSLog(@"Start state notifications on callback %@", stateCallbackId);
+    } else {
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"State callback already registered"];
+    }
+
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+}
+
+- (void)stopStateNotifications:(CDVInvokedUrlCommand *)command {
+    CDVPluginResult *pluginResult = nil;
+
+    if (stateCallbackId != nil) {
+        // Call with NO_RESULT so Cordova.js will delete the callback without actually calling it
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_NO_RESULT];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:stateCallbackId];
+        stateCallbackId = nil;
+    }
+
+    pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+}
+
+- (void)onReset {
+    stateCallbackId = nil;
+}
+
+- (void)readRSSI:(CDVInvokedUrlCommand*)command {
+    NSLog(@"readRSSI");
+    NSString *uuid = [command argumentAtIndex:0];
+
+    CBPeripheral *peripheral = [self findPeripheralByUUID:uuid];
+
+    if (peripheral && peripheral.state == CBPeripheralStateConnected) {
+        [readRSSICallbacks setObject:[command.callbackId copy] forKey:[peripheral uuidAsString]];
+        [peripheral readRSSI];
+    } else {
+        NSString *error = [NSString stringWithFormat:@"Need to be connected to peripheral %@ to read RSSI.", uuid];
+        NSLog(@"%@", error);
+        CDVPluginResult *pluginResult = nil;
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:error];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+    }
+}
+
+// Returns a list of the peripherals (containing any of the specified services) currently connected to the system.
+// https://developer.apple.com/documentation/corebluetooth/cbcentralmanager/1518924-retrieveconnectedperipheralswith?language=objc
+- (void)connectedPeripheralsWithServices:(CDVInvokedUrlCommand*)command {
+    NSLog(@"connectedPeripheralsWithServices");
+    NSArray *serviceUUIDStrings = [command argumentAtIndex:0];
+    NSArray<CBUUID *> *serviceUUIDs = [self uuidStringsToCBUUIDs:serviceUUIDStrings];
+
+    NSArray<CBPeripheral *> *connectedPeripherals = [manager retrieveConnectedPeripheralsWithServices:serviceUUIDs];
+    NSMutableArray<NSDictionary *> *connected = [NSMutableArray new];
+
+    for (CBPeripheral *peripheral in connectedPeripherals) {
+        [peripherals addObject:peripheral];
+        [connected addObject:[peripheral asDictionary]];
+    }
+
+    CDVPluginResult *pluginResult = nil;
+    pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArray:connected];
+    NSLog(@"Connected peripherals with services %@ %@", serviceUUIDStrings, connected);
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+}
+
+// Returns a list of known peripherals by their identifiers.
+// https://developer.apple.com/documentation/corebluetooth/cbcentralmanager/1519127-retrieveperipheralswithidentifie?language=objc
+- (void)peripheralsWithIdentifiers:(CDVInvokedUrlCommand*)command {
+    NSLog(@"peripheralsWithIdentifiers");
+    NSArray *identifierUUIDStrings = [command argumentAtIndex:0];
+    NSArray<NSUUID *> *identifiers = [self uuidStringsToNSUUIDs:identifierUUIDStrings];
+    
+    NSArray<CBPeripheral *> *foundPeripherals = [manager retrievePeripheralsWithIdentifiers:identifiers];
+    // TODO are any of these connected?
+    NSMutableArray<NSDictionary *> *found = [NSMutableArray new];
+    
+    for (CBPeripheral *peripheral in foundPeripherals) {
+        [peripherals addObject:peripheral];   // TODO do we save these?
+        [found addObject:[peripheral asDictionary]];
+    }
+    
+    CDVPluginResult *pluginResult = nil;
+    pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArray:found];
+    NSLog(@"Peripherals with identifiers %@ %@", identifierUUIDStrings, found);
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+}
+
+
+#pragma mark - timers
+
+-(void)stopScanTimer:(NSTimer *)timer {
+    NSLog(@"stopScanTimer");
+
+    [manager stopScan];
+
+    if (discoverPeripheralCallbackId) {
+        discoverPeripheralCallbackId = nil;
+    }
+}
+
+#pragma mark - CBCentralManagerDelegate
+
+- (void)centralManager:(CBCentralManager *)central didDiscoverPeripheral:(CBPeripheral *)peripheral advertisementData:(NSDictionary *)advertisementData RSSI:(NSNumber *)RSSI {
+
+    [peripherals addObject:peripheral];
+    [peripheral setAdvertisementData:advertisementData RSSI:RSSI];
+
+    if (discoverPeripheralCallbackId) {
+        CDVPluginResult *pluginResult = nil;
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[peripheral asDictionary]];
+        NSLog(@"Discovered %@", [peripheral asDictionary]);
+        [pluginResult setKeepCallbackAsBool:TRUE];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:discoverPeripheralCallbackId];
+    }
+}
+
+- (void)centralManagerDidUpdateState:(CBCentralManager *)central
+{
+    NSLog(@"Status of CoreBluetooth central manager changed %ld %@", (long)central.state, [self centralManagerStateToString: central.state]);
+
+    if (central.state == CBCentralManagerStateUnsupported)
+    {
+        NSLog(@"=============================================================");
+        NSLog(@"WARNING: This hardware does not support Bluetooth Low Energy.");
+        NSLog(@"=============================================================");
+    }
+
+    if (stateCallbackId != nil) {
+        CDVPluginResult *pluginResult = nil;
+        NSString *state = [bluetoothStates objectForKey:@(central.state)];
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:state];
+        [pluginResult setKeepCallbackAsBool:TRUE];
+        NSLog(@"Report Bluetooth state \"%@\" on callback %@", state, stateCallbackId);
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:stateCallbackId];
+    }
+
+    // check and handle disconnected peripherals
+    for (CBPeripheral *peripheral in peripherals) {
+        if (peripheral.state == CBPeripheralStateDisconnected) {
+            [self centralManager:central didDisconnectPeripheral:peripheral error:nil];
+        }
+    }
+}
+
+- (void)centralManager:(CBCentralManager *)central didConnectPeripheral:(CBPeripheral *)peripheral {
+    NSLog(@"didConnectPeripheral");
+
+    peripheral.delegate = self;
+
+    // NOTE: it's inefficient to discover all services
+    [peripheral discoverServices:nil];
+
+    // NOTE: not calling connect success until characteristics are discovered
+}
+
+- (void)centralManager:(CBCentralManager *)central didDisconnectPeripheral:(CBPeripheral *)peripheral error:(NSError *)error {
+    NSLog(@"didDisconnectPeripheral");
+
+    NSString *connectCallbackId = [connectCallbacks valueForKey:[peripheral uuidAsString]];
+    [connectCallbacks removeObjectForKey:[peripheral uuidAsString]];
+    [self cleanupOperationCallbacks:peripheral withResult:[CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Peripheral disconnected"]];
+
+    if (connectCallbackId) {
+
+        NSMutableDictionary *dict = [NSMutableDictionary dictionaryWithDictionary:[peripheral asDictionary]];
+
+        // add error info
+        [dict setObject:@"Peripheral Disconnected" forKey:@"errorMessage"];
+        if (error) {
+            [dict setObject:[error localizedDescription] forKey:@"errorDescription"];
+        }
+        // remove extra junk
+        [dict removeObjectForKey:@"rssi"];
+        [dict removeObjectForKey:@"advertising"];
+        [dict removeObjectForKey:@"services"];
+
+        CDVPluginResult *pluginResult = nil;
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsDictionary:dict];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:connectCallbackId];
+    }
+}
+
+- (void)centralManager:(CBCentralManager *)central didFailToConnectPeripheral:(CBPeripheral *)peripheral error:(NSError *)error {
+    NSLog(@"didFailToConnectPeripheral");
+
+    NSString *connectCallbackId = [connectCallbacks valueForKey:[peripheral uuidAsString]];
+    [connectCallbacks removeObjectForKey:[peripheral uuidAsString]];
+    [self cleanupOperationCallbacks:peripheral withResult:[CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Peripheral disconnected"]];
+
+    CDVPluginResult *pluginResult = nil;
+    pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsDictionary:[peripheral asDictionary]];
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:connectCallbackId];
+}
+
+#pragma mark CBPeripheralDelegate
+
+- (void)peripheral:(CBPeripheral *)peripheral didDiscoverServices:(NSError *)error {
+    NSLog(@"didDiscoverServices");
+
+    // save the services to tell when all characteristics have been discovered
+    NSMutableSet *servicesForPeriperal = [NSMutableSet new];
+    [servicesForPeriperal addObjectsFromArray:peripheral.services];
+    [connectCallbackLatches setObject:servicesForPeriperal forKey:[peripheral uuidAsString]];
+
+    for (CBService *service in peripheral.services) {
+        [peripheral discoverCharacteristics:nil forService:service]; // discover all is slow
+    }
+}
+
+- (void)peripheral:(CBPeripheral *)peripheral didDiscoverCharacteristicsForService:(CBService *)service error:(NSError *)error {
+    NSLog(@"didDiscoverCharacteristicsForService");
+
+    NSString *peripheralUUIDString = [peripheral uuidAsString];
+    NSString *connectCallbackId = [connectCallbacks valueForKey:peripheralUUIDString];
+    NSMutableSet *latch = [connectCallbackLatches valueForKey:peripheralUUIDString];
+
+    [latch removeObject:service];
+
+    if ([latch count] == 0) {
+        // Call success callback for connect
+        if (connectCallbackId) {
+            CDVPluginResult *pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:[peripheral asDictionary]];
+            [pluginResult setKeepCallbackAsBool:TRUE];
+            [self.commandDelegate sendPluginResult:pluginResult callbackId:connectCallbackId];
+        }
+        [connectCallbackLatches removeObjectForKey:peripheralUUIDString];
+    }
+
+    NSLog(@"Found characteristics for service %@", service);
+    for (CBCharacteristic *characteristic in service.characteristics) {
+        NSLog(@"Characteristic %@", characteristic);
+    }
+}
+
+- (void)peripheral:(CBPeripheral *)peripheral didUpdateValueForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error {
+    NSLog(@"didUpdateValueForCharacteristic");
+
+    NSString *key = [self keyForPeripheral: peripheral andCharacteristic:characteristic];
+    NSString *notifyCallbackId = [notificationCallbacks objectForKey:key];
+
+    if (notifyCallbackId) {
+        NSData *data = characteristic.value; // send RAW data to Javascript
+
+        CDVPluginResult *pluginResult = nil;
+        if (error) {
+            NSLog(@"%@", error);
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:[error localizedDescription]];
+        } else {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArrayBuffer:data];
+        }
+
+        [pluginResult setKeepCallbackAsBool:TRUE]; // keep for notification
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:notifyCallbackId];
+    }
+
+    NSString *readCallbackId = [readCallbacks objectForKey:key];
+
+    if(readCallbackId) {
+        NSData *data = characteristic.value; // send RAW data to Javascript
+        CDVPluginResult *pluginResult = nil;
+        
+        if (error) {
+            NSLog(@"%@", error);
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:[error localizedDescription]];
+        } else {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArrayBuffer:data];
+        }
+        
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:readCallbackId];
+
+        [readCallbacks removeObjectForKey:key];
+    }
+}
+
+- (void)peripheral:(CBPeripheral *)peripheral didUpdateNotificationStateForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error {
+    NSString *key = [self keyForPeripheral: peripheral andCharacteristic:characteristic];
+    NSString *startNotificationCallbackId = [startNotificationCallbacks objectForKey:key];
+    NSString *stopNotificationCallbackId = [stopNotificationCallbacks objectForKey:key];
+
+    CDVPluginResult *pluginResult = nil;
+
+    // we always call the stopNotificationCallbackId if we have a callback
+    // we only call the notificationCallbackId on errors and if there is no stopNotificationCallbackId
+
+    if (stopNotificationCallbackId) {
+        if (error) {
+            NSLog(@"%@", error);
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:[error localizedDescription]];
+        } else {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+        }
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:stopNotificationCallbackId];
+        [stopNotificationCallbacks removeObjectForKey:key];
+        [notificationCallbacks removeObjectForKey:key];
+        NSAssert(![startNotificationCallbacks objectForKey:key], @"%@ existed in both start and stop notification callback dicts!", key);
+    }
+    
+    if (startNotificationCallbackId) {
+        if (error) {
+            NSLog(@"%@", error);
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:[error localizedDescription]];
+            [self.commandDelegate sendPluginResult:pluginResult callbackId:startNotificationCallbackId];
+            [startNotificationCallbacks removeObjectForKey:key];
+        } else {
+            // notification start succeeded, move the callback to the value notifications dict
+            [notificationCallbacks setObject:startNotificationCallbackId forKey:key];
+            [startNotificationCallbacks removeObjectForKey:key];
+        }
+    }
+}
+
+
+- (void)peripheral:(CBPeripheral *)peripheral didWriteValueForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error {
+    // This is the callback for write
+
+    NSString *key = [self keyForPeripheral: peripheral andCharacteristic:characteristic];
+    NSString *writeCallbackId = [writeCallbacks objectForKey:key];
+
+    if (writeCallbackId) {
+        CDVPluginResult *pluginResult = nil;
+        if (error) {
+            NSLog(@"%@", error);
+            pluginResult = [CDVPluginResult
+                resultWithStatus:CDVCommandStatus_ERROR
+                messageAsString:[error localizedDescription]
+            ];
+        } else {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+        }
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:writeCallbackId];
+        [writeCallbacks removeObjectForKey:key];
+    }
+
+}
+
+- (void)peripheral:(CBPeripheral*)peripheral didReadRSSI:(NSNumber*)rssi error:(NSError*)error {
+    NSLog(@"didReadRSSI %@", rssi);
+    NSString *key = [peripheral uuidAsString];
+    NSString *readRSSICallbackId = [readRSSICallbacks objectForKey: key];
+    [peripheral setSavedRSSI:rssi];
+    if (readRSSICallbackId) {
+        CDVPluginResult* pluginResult = nil;
+        if (error) {
+            NSLog(@"%@", error);
+            pluginResult = [CDVPluginResult
+                resultWithStatus:CDVCommandStatus_ERROR
+                messageAsString:[error localizedDescription]];
+        } else {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK
+                messageAsInt: (int) [rssi integerValue]];
+        }
+        [self.commandDelegate sendPluginResult:pluginResult callbackId: readRSSICallbackId];
+        [readRSSICallbacks removeObjectForKey:readRSSICallbackId];
+    }
+}
+
+#pragma mark - internal implemetation
+
+- (CBPeripheral*)findPeripheralByUUID:(NSString*)uuid {
+    CBPeripheral *peripheral = nil;
+
+    for (CBPeripheral *p in peripherals) {
+
+        NSString* other = p.identifier.UUIDString;
+
+        if ([uuid isEqualToString:other]) {
+            peripheral = p;
+            break;
+        }
+    }
+    return peripheral;
+}
+
+// RedBearLab
+-(CBService *) findServiceFromUUID:(CBUUID *)UUID p:(CBPeripheral *)p {
+    for(int i = 0; i < p.services.count; i++) {
+        CBService *s = [p.services objectAtIndex:i];
+        if ([self compareCBUUID:s.UUID UUID2:UUID])
+            return s;
+    }
+
+    return nil; //Service not found on this peripheral
+}
+
+// Find a characteristic in service with a specific property
+-(CBCharacteristic *) findCharacteristicFromUUID:(CBUUID *)UUID service:(CBService*)service prop:(CBCharacteristicProperties)prop {
+    NSLog(@"Looking for %@ with properties %lu", UUID, (unsigned long)prop);
+    for(int i=0; i < service.characteristics.count; i++)
+    {
+        CBCharacteristic *c = [service.characteristics objectAtIndex:i];
+        if ((c.properties & prop) != 0x0 && [c.UUID.UUIDString isEqualToString: UUID.UUIDString]) {
+            return c;
+        }
+    }
+   return nil; //Characteristic with prop not found on this service
+}
+
+// Find a characteristic in service by UUID
+-(CBCharacteristic *) findCharacteristicFromUUID:(CBUUID *)UUID service:(CBService*)service {
+    NSLog(@"Looking for %@", UUID);
+    for(int i=0; i < service.characteristics.count; i++)
+    {
+        CBCharacteristic *c = [service.characteristics objectAtIndex:i];
+        if ([c.UUID.UUIDString isEqualToString: UUID.UUIDString]) {
+            return c;
+        }
+    }
+   return nil; //Characteristic not found on this service
+}
+
+// RedBearLab
+-(int) compareCBUUID:(CBUUID *) UUID1 UUID2:(CBUUID *)UUID2 {
+    char b1[16];
+    char b2[16];
+    [UUID1.data getBytes:b1 length:16];
+    [UUID2.data getBytes:b2 length:16];
+
+    if (memcmp(b1, b2, UUID1.data.length) == 0)
+        return 1;
+    else
+        return 0;
+}
+
+// expecting deviceUUID, serviceUUID, characteristicUUID in command.arguments
+-(BLECommandContext*) getData:(CDVInvokedUrlCommand*)command prop:(CBCharacteristicProperties)prop {
+    NSLog(@"getData");
+
+    CDVPluginResult *pluginResult = nil;
+
+    NSString *deviceUUIDString = [command argumentAtIndex:0];
+    NSString *serviceUUIDString = [command argumentAtIndex:1];
+    NSString *characteristicUUIDString = [command argumentAtIndex:2];
+
+    CBUUID *serviceUUID = [CBUUID UUIDWithString:serviceUUIDString];
+    CBUUID *characteristicUUID = [CBUUID UUIDWithString:characteristicUUIDString];
+
+    CBPeripheral *peripheral = [self findPeripheralByUUID:deviceUUIDString];
+
+    if (!peripheral) {
+
+        NSLog(@"Could not find peripheral with UUID %@", deviceUUIDString);
+
+        NSString *errorMessage = [NSString stringWithFormat:@"Could not find peripheral with UUID %@", deviceUUIDString];
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:errorMessage];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+
+        return nil;
+    }
+
+    CBService *service = [self findServiceFromUUID:serviceUUID p:peripheral];
+
+    if (!service)
+    {
+        NSLog(@"Could not find service with UUID %@ on peripheral with UUID %@",
+              serviceUUIDString,
+              peripheral.identifier.UUIDString);
+
+
+        NSString *errorMessage = [NSString stringWithFormat:@"Could not find service with UUID %@ on peripheral with UUID %@",
+                                  serviceUUIDString,
+                                  peripheral.identifier.UUIDString];
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:errorMessage];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+
+        return nil;
+    }
+
+    CBCharacteristic *characteristic = [self findCharacteristicFromUUID:characteristicUUID service:service prop:prop];
+
+    // Special handling for INDICATE. If charateristic with notify is not found, check for indicate.
+    if (prop == CBCharacteristicPropertyNotify && !characteristic) {
+        characteristic = [self findCharacteristicFromUUID:characteristicUUID service:service prop:CBCharacteristicPropertyIndicate];
+    }
+
+    // As a last resort, try and find ANY characteristic with this UUID, even if it doesn't have the correct properties
+    if (!characteristic) {
+        characteristic = [self findCharacteristicFromUUID:characteristicUUID service:service];
+    }
+
+    if (!characteristic)
+    {
+        NSLog(@"Could not find characteristic with UUID %@ on service with UUID %@ on peripheral with UUID %@",
+              characteristicUUIDString,
+              serviceUUIDString,
+              peripheral.identifier.UUIDString);
+
+        NSString *errorMessage = [NSString stringWithFormat:
+                                  @"Could not find characteristic with UUID %@ on service with UUID %@ on peripheral with UUID %@",
+                                  characteristicUUIDString,
+                                  serviceUUIDString,
+                                  peripheral.identifier.UUIDString];
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:errorMessage];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+
+        return nil;
+    }
+
+    BLECommandContext *context = [[BLECommandContext alloc] init];
+    [context setPeripheral:peripheral];
+    [context setService:service];
+    [context setCharacteristic:characteristic];
+    return context;
+}
+
+-(NSString *) keyForPeripheral: (CBPeripheral *)peripheral andCharacteristic:(CBCharacteristic *)characteristic {
+    return [NSString stringWithFormat:@"%@|%@|%@", [peripheral uuidAsString], [characteristic.service UUID], [characteristic UUID]];
+}
+
++(BOOL) isKey: (NSString *)key forPeripheral:(CBPeripheral *)peripheral {
+    NSArray *keyArray = [key componentsSeparatedByString: @"|"];
+    return [[peripheral uuidAsString] compare:keyArray[0]] == NSOrderedSame;
+}
+
+-(void) cleanupOperationCallbacks: (CBPeripheral *)peripheral withResult:(CDVPluginResult *) result {
+    for(id key in readCallbacks.allKeys) {
+        if([BLECentralPlugin isKey:key forPeripheral:peripheral]) {
+            NSString *callbackId = [readCallbacks valueForKey:key];
+            [self.commandDelegate sendPluginResult:result callbackId:callbackId];
+            [readCallbacks removeObjectForKey:key];
+            NSLog(@"Cleared read callback %@ for key %@", callbackId, key);
+        }
+    }
+    for(id key in writeCallbacks.allKeys) {
+        if([BLECentralPlugin isKey:key forPeripheral:peripheral]) {
+            NSString *callbackId = [writeCallbacks valueForKey:key];
+            [self.commandDelegate sendPluginResult:result callbackId:callbackId];
+            [writeCallbacks removeObjectForKey:key];
+            NSLog(@"Cleared write callback %@ for key %@", callbackId, key);
+        }
+    }
+    for(id key in startNotificationCallbacks.allKeys) {
+        if([BLECentralPlugin isKey:key forPeripheral:peripheral]) {
+            NSString *callbackId = [startNotificationCallbacks valueForKey:key];
+            [self.commandDelegate sendPluginResult:result callbackId:callbackId];
+            [startNotificationCallbacks removeObjectForKey:key];
+            NSLog(@"Cleared start notification callback %@ for key %@", callbackId, key);
+        }
+    }
+    for(id key in stopNotificationCallbacks.allKeys) {
+        if([BLECentralPlugin isKey:key forPeripheral:peripheral]) {
+            NSString *callbackId = [stopNotificationCallbacks valueForKey:key];
+            [self.commandDelegate sendPluginResult:result callbackId:callbackId];
+            [stopNotificationCallbacks removeObjectForKey:key];
+            NSLog(@"Cleared stop notification callback %@ for key %@", callbackId, key);
+        }
+    }
+    [notificationCallbacks removeAllObjects];
+}
+
+#pragma mark - util
+
+- (NSString*) centralManagerStateToString: (int)state {
+    switch(state)
+    {
+        case CBCentralManagerStateUnknown:
+            return @"State unknown (CBCentralManagerStateUnknown)";
+        case CBCentralManagerStateResetting:
+            return @"State resetting (CBCentralManagerStateUnknown)";
+        case CBCentralManagerStateUnsupported:
+            return @"State BLE unsupported (CBCentralManagerStateResetting)";
+        case CBCentralManagerStateUnauthorized:
+            return @"State unauthorized (CBCentralManagerStateUnauthorized)";
+        case CBCentralManagerStatePoweredOff:
+            return @"State BLE powered off (CBCentralManagerStatePoweredOff)";
+        case CBCentralManagerStatePoweredOn:
+            return @"State powered up and ready (CBCentralManagerStatePoweredOn)";
+        default:
+            return @"State unknown";
+    }
+
+    return @"Unknown state";
+}
+
+- (NSArray<CBUUID *> *) uuidStringsToCBUUIDs: (NSArray<NSString *> *)uuidStrings {
+    NSMutableArray *uuids = [NSMutableArray new];
+    for (int i = 0; i < [uuidStrings count]; i++) {
+        CBUUID *uuid = [CBUUID UUIDWithString:[uuidStrings objectAtIndex: i]];
+        [uuids addObject:uuid];
+    }
+    return uuids;
+}
+
+- (NSArray<NSUUID *> *) uuidStringsToNSUUIDs: (NSArray<NSString *> *)uuidStrings {
+    NSMutableArray *uuids = [NSMutableArray new];
+    for (int i = 0; i < [uuidStrings count]; i++) {
+        NSUUID *uuid = [[NSUUID alloc]initWithUUIDString:[uuidStrings objectAtIndex: i]];
+        [uuids addObject:uuid];
+    }
+    return uuids;
+}
+
+@end

plugins/cordova-plugin-ble-central/src/ios/BLECommandContext.h

@@ -0,0 +1,16 @@
+//
+//  BLECommandContext
+//  Holds peripherial, service and characteristic
+//
+
+#import <Foundation/Foundation.h>
+#import <CoreBluetooth/CoreBluetooth.h>
+
+@interface BLECommandContext : NSObject
+
+@property CBPeripheral *peripheral;
+@property CBService *service;
+@property CBCharacteristic *characteristic;
+
+@end
+

plugins/cordova-plugin-ble-central/src/ios/BLECommandContext.m

@@ -0,0 +1,10 @@
+//
+//  BLECommandContext.m
+//  Holds peripherial, service and characteristic
+//
+
+#import "BLECommandContext.h"
+
+@implementation BLECommandContext
+
+@end

plugins/cordova-plugin-ble-central/src/ios/CBPeripheral+Extensions.h

@@ -0,0 +1,37 @@
+//
+//  CBPeripheral+Extensions.h
+//  BLE Central Cordova Plugin
+//
+//  (c) 2104 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#import <objc/runtime.h>
+#import <Foundation/Foundation.h>
+#import <CoreBluetooth/CoreBluetooth.h>
+#import <Cordova/CDV.h>
+
+
+@interface CBPeripheral(com_megster_ble_extension)
+
+@property (nonatomic, retain) NSDictionary *advertising;
+@property (nonatomic, retain) NSNumber *savedRSSI;
+
+-(void)setAdvertisementData:(NSDictionary *)advertisementData RSSI:(NSNumber*)rssi;
+-(NSDictionary *)asDictionary;
+-(NSString *)uuidAsString;
+
+@end
+
+
+

plugins/cordova-plugin-ble-central/src/ios/CBPeripheral+Extensions.m

@@ -0,0 +1,271 @@
+//
+//  CBPeripheral+Extensions.m
+//  BLE Central Cordova Plugin
+//
+//  (c) 2104 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#import "CBPeripheral+Extensions.h"
+
+static char ADVERTISING_IDENTIFER;
+static char SAVED_RSSI_IDENTIFER;
+
+static NSDictionary *dataToArrayBuffer(NSData* data) {
+    return @{
+             @"CDVType" : @"ArrayBuffer",
+             @"data" :[data base64EncodedStringWithOptions:0]
+             };
+}
+
+@implementation CBPeripheral(com_megster_ble_extension)
+
+-(NSString *)uuidAsString {
+    if (self.identifier.UUIDString) {
+        return self.identifier.UUIDString;
+    } else {
+        return @"";
+    }
+}
+
+
+-(NSDictionary *)asDictionary {
+    NSString *uuidString = NULL;
+    if (self.identifier.UUIDString) {
+        uuidString = self.identifier.UUIDString;
+    } else {
+        uuidString = @"";
+    }
+
+    NSMutableDictionary *dictionary = [NSMutableDictionary dictionary];
+    [dictionary setObject: uuidString forKey: @"id"];
+
+    if ([self name]) {
+        [dictionary setObject: [self name] forKey: @"name"];
+    }
+
+    if ([self savedRSSI]) {
+        [dictionary setObject: [self savedRSSI] forKey: @"rssi"];
+    }
+
+    if ([self advertising]) {
+        [dictionary setObject: [self advertising] forKey: @"advertising"];
+    }
+
+    if([[self services] count] > 0) {
+        [self serviceAndCharacteristicInfo: dictionary];
+    }
+
+    return dictionary;
+}
+
+// AdvertisementData is from didDiscoverPeripheral. RFduino advertises a service name in the Mfg Data Field.
+-(void)setAdvertisementData:(NSDictionary *)advertisementData RSSI:(NSNumber *)rssi {
+    [self setAdvertising:[self serializableAdvertisementData: advertisementData]];
+    [self setSavedRSSI: rssi];
+}
+
+// Translates the Advertisement Data from didDiscoverPeripheral into a structure that can be serialized as JSON
+//
+// This version keeps the iOS constants for keys, future versions could create more friendly keys
+//
+// Advertisement Data from a Peripheral could look something like
+//
+// advertising = {
+//     kCBAdvDataChannel = 39;
+//     kCBAdvDataIsConnectable = 1;
+//     kCBAdvDataLocalName = foo;
+//     kCBAdvDataManufacturerData = {
+//         CDVType = ArrayBuffer;
+//         data = "AABoZWxsbw==";
+//     };
+//     kCBAdvDataServiceData = {
+//         FED8 = {
+//             CDVType = ArrayBuffer;
+//             data = "ACAAYWJjBw==";
+//         };
+//     };
+//     kCBAdvDataServiceUUIDs = (
+//         FED8
+//     );
+//     kCBAdvDataTxPowerLevel = 32;
+//};
+- (NSDictionary *) serializableAdvertisementData: (NSDictionary *) advertisementData {
+    NSMutableDictionary *dict = [advertisementData mutableCopy];
+
+    // Service Data is a dictionary of CBUUID and NSData
+    // Convert to String keys with Array Buffer values
+    NSMutableDictionary *serviceData = [dict objectForKey:CBAdvertisementDataServiceDataKey];
+    if (serviceData) {
+        NSLog(@"%@", serviceData);
+
+        for (CBUUID *key in [serviceData allKeys]) {
+            [serviceData setObject:dataToArrayBuffer([serviceData objectForKey:key]) forKey:[key UUIDString]];
+            [serviceData removeObjectForKey:key];
+        }
+    }
+
+    // Create a new list of Service UUIDs as Strings instead of CBUUIDs
+    NSMutableArray *serviceUUIDs = [dict objectForKey:CBAdvertisementDataServiceUUIDsKey];
+    NSMutableArray *serviceUUIDStrings;
+    if (serviceUUIDs) {
+        serviceUUIDStrings = [[NSMutableArray alloc] initWithCapacity:serviceUUIDs.count];
+
+        for (CBUUID *uuid in serviceUUIDs) {
+            [serviceUUIDStrings addObject:[uuid UUIDString]];
+        }
+
+        // replace the UUID list with list of strings
+        [dict removeObjectForKey:CBAdvertisementDataServiceUUIDsKey];
+        [dict setObject:serviceUUIDStrings forKey:CBAdvertisementDataServiceUUIDsKey];
+
+    }
+
+    // Solicited Services UUIDs is an array of CBUUIDs, convert into Strings
+    NSMutableArray *solicitiedServiceUUIDs = [dict objectForKey:CBAdvertisementDataSolicitedServiceUUIDsKey];
+    NSMutableArray *solicitiedServiceUUIDStrings;
+    if (solicitiedServiceUUIDs) {
+        // NSLog(@"%@", solicitiedServiceUUIDs);
+        solicitiedServiceUUIDStrings = [[NSMutableArray alloc] initWithCapacity:solicitiedServiceUUIDs.count];
+
+        for (CBUUID *uuid in solicitiedServiceUUIDs) {
+            [solicitiedServiceUUIDStrings addObject:[uuid UUIDString]];
+        }
+
+        // replace the UUID list with list of strings
+        [dict removeObjectForKey:CBAdvertisementDataSolicitedServiceUUIDsKey];
+        [dict setObject:solicitiedServiceUUIDStrings forKey:CBAdvertisementDataSolicitedServiceUUIDsKey];
+    }
+
+    // Convert the manufacturer data
+    NSData *mfgData = [dict objectForKey:CBAdvertisementDataManufacturerDataKey];
+    if (mfgData) {
+        [dict setObject:dataToArrayBuffer([dict objectForKey:CBAdvertisementDataManufacturerDataKey]) forKey:CBAdvertisementDataManufacturerDataKey];
+    }
+
+    return dict;
+}
+
+// Put the service, characteristic, and descriptor data in a format that will serialize through JSON
+// sending a list of services and a list of characteristics
+- (void) serviceAndCharacteristicInfo: (NSMutableDictionary *) info {
+    NSMutableArray *serviceList = [NSMutableArray new];
+    NSMutableArray *characteristicList = [NSMutableArray new];
+
+    // This can move into the CBPeripherial Extension
+    for (CBService *service in [self services]) {
+        [serviceList addObject:[[service UUID] UUIDString]];
+        for (CBCharacteristic *characteristic in service.characteristics) {
+            NSMutableDictionary *characteristicDictionary = [NSMutableDictionary new];
+            [characteristicDictionary setObject:[[service UUID] UUIDString] forKey:@"service"];
+            [characteristicDictionary setObject:[[characteristic UUID] UUIDString] forKey:@"characteristic"];
+
+            if ([characteristic value]) {
+                [characteristicDictionary setObject:dataToArrayBuffer([characteristic value]) forKey:@"value"];
+            }
+            if ([characteristic properties]) {
+                //[characteristicDictionary setObject:[NSNumber numberWithInt:[characteristic properties]] forKey:@"propertiesValue"];
+                [characteristicDictionary setObject:[self decodeCharacteristicProperties:characteristic] forKey:@"properties"];
+            }
+            // permissions only exist on CBMutableCharacteristics
+            [characteristicDictionary setObject:[NSNumber numberWithBool:[characteristic isNotifying]] forKey:@"isNotifying"];
+            [characteristicList addObject:characteristicDictionary];
+
+            // descriptors always seem to be nil, probably a bug here
+            NSMutableArray *descriptorList = [NSMutableArray new];
+            for (CBDescriptor *descriptor in characteristic.descriptors) {
+                NSMutableDictionary *descriptorDictionary = [NSMutableDictionary new];
+                [descriptorDictionary setObject:[[descriptor UUID] UUIDString] forKey:@"descriptor"];
+                if ([descriptor value]) { // should always have a value?
+                    [descriptorDictionary setObject:[descriptor value] forKey:@"value"];
+                }
+                [descriptorList addObject:descriptorDictionary];
+            }
+            if ([descriptorList count] > 0) {
+                [characteristicDictionary setObject:descriptorList forKey:@"descriptors"];
+            }
+
+        }
+    }
+
+    [info setObject:serviceList forKey:@"services"];
+    [info setObject:characteristicList forKey:@"characteristics"];
+}
+
+-(NSArray *) decodeCharacteristicProperties: (CBCharacteristic *) characteristic {
+    NSMutableArray *props = [NSMutableArray new];
+
+    CBCharacteristicProperties p = [characteristic properties];
+
+    // NOTE: props strings need to be consistent across iOS and Android
+    if ((p & CBCharacteristicPropertyBroadcast) != 0x0) {
+        [props addObject:@"Broadcast"];
+    }
+
+    if ((p & CBCharacteristicPropertyRead) != 0x0) {
+        [props addObject:@"Read"];
+    }
+
+    if ((p & CBCharacteristicPropertyWriteWithoutResponse) != 0x0) {
+        [props addObject:@"WriteWithoutResponse"];
+    }
+
+    if ((p & CBCharacteristicPropertyWrite) != 0x0) {
+        [props addObject:@"Write"];
+    }
+
+    if ((p & CBCharacteristicPropertyNotify) != 0x0) {
+        [props addObject:@"Notify"];
+    }
+
+    if ((p & CBCharacteristicPropertyIndicate) != 0x0) {
+        [props addObject:@"Indicate"];
+    }
+
+    if ((p & CBCharacteristicPropertyAuthenticatedSignedWrites) != 0x0) {
+        [props addObject:@"AutheticateSignedWrites"];
+    }
+
+    if ((p & CBCharacteristicPropertyExtendedProperties) != 0x0) {
+        [props addObject:@"ExtendedProperties"];
+    }
+
+    if ((p & CBCharacteristicPropertyNotifyEncryptionRequired) != 0x0) {
+        [props addObject:@"NotifyEncryptionRequired"];
+    }
+
+    if ((p & CBCharacteristicPropertyIndicateEncryptionRequired) != 0x0) {
+        [props addObject:@"IndicateEncryptionRequired"];
+    }
+
+    return props;
+}
+
+-(void)setAdvertising:(NSDictionary *)newAdvertisingValue{
+    objc_setAssociatedObject(self, &ADVERTISING_IDENTIFER, newAdvertisingValue, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
+}
+
+-(NSString*)advertising{
+    return objc_getAssociatedObject(self, &ADVERTISING_IDENTIFER);
+}
+
+
+-(void)setSavedRSSI:(NSNumber *)newSavedRSSIValue {
+    objc_setAssociatedObject(self, &SAVED_RSSI_IDENTIFER, newSavedRSSIValue, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
+}
+
+-(NSString*)savedRSSI{
+    return objc_getAssociatedObject(self, &SAVED_RSSI_IDENTIFER);
+}
+
+@end

plugins/cordova-plugin-ble-central/src/wp/BLECentralPlugin.cs

@@ -0,0 +1,132 @@
+//
+//  BLE Central Cordova Plugin
+//
+//  (c) 2105 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+using System;
+using System.Linq;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Runtime.Serialization;
+using Windows.Networking.Proximity;
+using WPCordovaClassLib.Cordova;
+using WPCordovaClassLib.Cordova.Commands;
+using WPCordovaClassLib.Cordova.JSON;
+using Microsoft.Phone.Tasks;
+
+using Windows.Networking;
+using System.Text;
+using System.Threading;
+
+public class BLECentralPlugin : BaseCommand
+{
+
+    private void notImplemented()
+    {
+      DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, "Not Implemented"));
+    }
+
+    public void scan(string args)
+    {
+      notImplemented();
+    }
+    public void startScan(string args)
+    {
+      notImplemented();
+    }
+    public void stopScan(string args)
+    {
+      notImplemented();
+    }
+    public void startScanWithOptions(string args)
+    {
+      notImplemented();
+    }
+    public void connect(string args)
+    {
+      notImplemented();
+    }
+    public void disconnect(string args)
+    {
+      notImplemented();
+    }
+    public void read(string args)
+    {
+      notImplemented();
+    }
+    public void readRSSI(string args) 
+    {
+      notImplemented();
+    }
+    public void write(string args)
+    {
+      notImplemented();
+    }
+    public void writeWithoutResponse(string args)
+    {
+      notImplemented();
+    }
+    public void startNotification(string args)
+    {
+      notImplemented();
+    }
+    public void stopNotification(string args)
+    {
+      notImplemented();
+    }
+    public void isConnected(string args)
+    {
+      notImplemented();
+    }
+
+    public async void isEnabled(string args)
+    {
+        string callbackId = JsonHelper.Deserialize<string[]>(args)[0];
+
+        // This is a bad way to do this, improve later
+        // See if we can determine in the Connection Manager
+        // https://msdn.microsoft.com/library/windows/apps/jj207007(v=vs.105).aspx
+        PeerFinder.AlternateIdentities["Bluetooth:Paired"] = "";
+
+        try
+        {
+            var peers = await PeerFinder.FindAllPeersAsync();
+
+            // Handle the result of the FindAllPeersAsync call
+        }
+        catch (Exception ex)
+        {
+            if ((uint)ex.HResult == 0x8007048F)
+            {
+                DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR), callbackId);
+            }
+            else
+            {
+                DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, ex.Message), callbackId);
+            }
+        }
+
+        DispatchCommandResult(new PluginResult(PluginResult.Status.OK), callbackId);
+    }
+
+    public void showBluetoothSettings(string args)
+    {
+        ConnectionSettingsTask connectionSettingsTask = new ConnectionSettingsTask();
+        connectionSettingsTask.ConnectionSettingsType = ConnectionSettingsType.Bluetooth;
+        connectionSettingsTask.Show();
+        DispatchCommandResult(new PluginResult(PluginResult.Status.OK));
+    }
+
+}

plugins/cordova-plugin-ble-central/tests/plugin.xml

@@ -0,0 +1,11 @@
+<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+    xmlns:rim="http://www.blackberry.com/ns/widgets"
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    id="com.megster.cordova.ble.tests"
+    version="0.1.9-dev">
+    <name>Bluetooth Low Energy Plugin Tests</name>
+    <license>Apache 2.0</license>
+
+    <js-module src="tests.js" name="tests">
+    </js-module>
+</plugin>

plugins/cordova-plugin-ble-central/tests/tests.js

@@ -0,0 +1,71 @@
+exports.defineAutoTests = function () {
+
+    describe('BLE object', function () {
+        it("ble should exist", function () {
+            expect(ble).toBeDefined();
+        });
+
+        it("should contain a startScan function", function () {
+            expect(typeof ble.startScan).toBeDefined();
+            expect(typeof ble.startScan).toBe("function");
+        });
+    });
+
+};
+
+exports.defineManualTests = function (contentEl, createActionButton) {
+
+    createActionButton('Is Bluetooth Enabled?', function() {
+
+        ble.isEnabled(
+            function() {
+                console.log("Bluetooth is enabled");
+            },
+            function() {
+                console.log("Bluetooth is *not* enabled");
+            }
+        );
+    });
+
+
+    if (cordova.platformId !== 'ios') {
+
+        // not supported on iOS
+        createActionButton('Show Bluetooth Settings', function() {
+            ble.showBluetoothSettings();
+        });
+
+        // not supported on iOS
+        createActionButton('Enable Bluetooth', function() {
+
+            ble.enable(
+                function() {
+                    console.log("Bluetooth is enabled");
+                },
+                function() {
+                    console.log("The user did *not* enable Bluetooth");
+                }
+            );
+        });
+
+    }
+
+    createActionButton('Scan', function() {
+
+        var scanSeconds = 5;
+        console.log("Scanning for BLE peripherals for " + scanSeconds + " seconds.");
+        ble.startScan([], function(device) {
+            console.log(JSON.stringify(device));
+        }, function(reason) {
+            console.log("BLE Scan failed " + reason);
+        });
+
+        setTimeout(ble.stopScan,
+            scanSeconds * 1000,
+            function() { console.log("Scan complete"); },
+            function() { console.log("stopScan failed"); }
+        );
+
+    });
+
+};

plugins/cordova-plugin-ble-central/www/ble.js

@@ -0,0 +1,308 @@
+// (c) 2014-2016 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global cordova, module */
+"use strict";
+
+var stringToArrayBuffer = function(str) {
+    var ret = new Uint8Array(str.length);
+    for (var i = 0; i < str.length; i++) {
+        ret[i] = str.charCodeAt(i);
+    }
+    return ret.buffer;
+};
+
+var base64ToArrayBuffer = function(b64) {
+    return stringToArrayBuffer(atob(b64));
+};
+
+function massageMessageNativeToJs(message) {
+    if (message.CDVType == 'ArrayBuffer') {
+        message = base64ToArrayBuffer(message.data);
+    }
+    return message;
+}
+
+// Cordova 3.6 doesn't unwrap ArrayBuffers in nested data structures
+// https://github.com/apache/cordova-js/blob/94291706945c42fd47fa632ed30f5eb811080e95/src/ios/exec.js#L107-L122
+function convertToNativeJS(object) {
+    Object.keys(object).forEach(function (key) {
+        var value = object[key];
+        object[key] = massageMessageNativeToJs(value);
+        if (typeof(value) === 'object') {
+            convertToNativeJS(value);
+        }
+    });
+}
+
+// set of auto-connected device ids
+var autoconnected = {};
+
+module.exports = {
+
+    scan: function (services, seconds, success, failure) {
+        var successWrapper = function(peripheral) {
+            convertToNativeJS(peripheral);
+            success(peripheral);
+        };
+        cordova.exec(successWrapper, failure, 'BLE', 'scan', [services, seconds]);
+    },
+
+    startScan: function (services, success, failure) {
+        var successWrapper = function(peripheral) {
+            convertToNativeJS(peripheral);
+            success(peripheral);
+        };
+        cordova.exec(successWrapper, failure, 'BLE', 'startScan', [services]);
+    },
+
+    stopScan: function (success, failure) {
+        cordova.exec(success, failure, 'BLE', 'stopScan', []);
+    },
+
+    startScanWithOptions: function(services, options, success, failure) {
+        var successWrapper = function(peripheral) {
+            convertToNativeJS(peripheral);
+            success(peripheral);
+        };
+        options = options || {};
+        cordova.exec(successWrapper, failure, 'BLE', 'startScanWithOptions', [services, options]);
+    },
+
+    // iOS only
+    connectedPeripheralsWithServices: function(services, success, failure) {
+        cordova.exec(success, failure, 'BLE', 'connectedPeripheralsWithServices', [services]);
+    },
+
+    // iOS only
+    peripheralsWithIdentifiers: function(identifiers, success, failure) {
+        cordova.exec(success, failure, 'BLE', 'peripheralsWithIdentifiers', [identifiers]);
+    },
+
+    // Android only
+    bondedDevices: function(success, failure) {
+        cordova.exec(success, failure, 'BLE', 'bondedDevices', []);
+    },
+
+    // this will probably be removed
+    list: function (success, failure) {
+        cordova.exec(success, failure, 'BLE', 'list', []);
+    },
+
+    connect: function (device_id, success, failure) {
+        // wrap success so nested array buffers in advertising info are handled correctly
+        var successWrapper = function(peripheral) {
+            convertToNativeJS(peripheral);
+            success(peripheral);
+        };
+        cordova.exec(successWrapper, failure, 'BLE', 'connect', [device_id]);    
+    },
+
+    autoConnect: function (deviceId, connectCallback, disconnectCallback) {
+        var disconnectCallbackWrapper;
+        autoconnected[deviceId] = true;
+
+        // wrap connectCallback so nested array buffers in advertising info are handled correctly
+        var connectCallbackWrapper = function(peripheral) {
+            convertToNativeJS(peripheral);
+            connectCallback(peripheral);
+        };
+
+        // iOS needs to reconnect on disconnect, unless ble.disconnect was called. 
+        if (cordova.platformId === 'ios') {
+            disconnectCallbackWrapper = function(peripheral) {
+                // let the app know the peripheral disconnected
+                disconnectCallback(peripheral);
+    
+                // reconnect if we have a peripheral.id and the user didn't call disconnect
+                if (peripheral.id && autoconnected[peripheral.id]) {
+                    cordova.exec(connectCallbackWrapper, disconnectCallbackWrapper, 'BLE', 'autoConnect', [deviceId]);
+                }
+            };    
+        } else {  // no wrapper for Android
+            disconnectCallbackWrapper = disconnectCallback; 
+        }
+
+        cordova.exec(connectCallbackWrapper, disconnectCallbackWrapper, 'BLE', 'autoConnect', [deviceId]);
+    },
+
+    disconnect: function (device_id, success, failure) {
+        try {
+            delete autoconnected[device_id];
+        } catch(e) {
+            // ignore error
+        }
+        cordova.exec(success, failure, 'BLE', 'disconnect', [device_id]);
+    },
+
+    requestMtu: function (device_id, mtu,  success, failure) {
+        cordova.exec(success, failure, 'BLE', 'requestMtu', [device_id, mtu]);
+    },
+
+    refreshDeviceCache: function(deviceId, timeoutMillis, success, failure) {
+        var successWrapper = function(peripheral) {
+            convertToNativeJS(peripheral);
+            success(peripheral);
+        };
+        cordova.exec(successWrapper, failure, 'BLE', 'refreshDeviceCache', [deviceId, timeoutMillis]);
+    },
+
+    // characteristic value comes back as ArrayBuffer in the success callback
+    read: function (device_id, service_uuid, characteristic_uuid, success, failure) {
+        cordova.exec(success, failure, 'BLE', 'read', [device_id, service_uuid, characteristic_uuid]);
+    },
+
+    // RSSI value comes back as an integer
+    readRSSI: function(device_id, success, failure) {
+        cordova.exec(success, failure, 'BLE', 'readRSSI', [device_id]);
+    },
+
+    // value must be an ArrayBuffer
+    write: function (device_id, service_uuid, characteristic_uuid, value, success, failure) {
+        cordova.exec(success, failure, 'BLE', 'write', [device_id, service_uuid, characteristic_uuid, value]);
+    },
+
+    // value must be an ArrayBuffer
+    writeWithoutResponse: function (device_id, service_uuid, characteristic_uuid, value, success, failure) {
+        cordova.exec(success, failure, 'BLE', 'writeWithoutResponse', [device_id, service_uuid, characteristic_uuid, value]);
+    },
+
+    // value must be an ArrayBuffer
+    writeCommand: function (device_id, service_uuid, characteristic_uuid, value, success, failure) {
+        console.log("WARNING: writeCommand is deprecated, use writeWithoutResponse");
+        cordova.exec(success, failure, 'BLE', 'writeWithoutResponse', [device_id, service_uuid, characteristic_uuid, value]);
+    },
+
+    // success callback is called on notification
+    notify: function (device_id, service_uuid, characteristic_uuid, success, failure) {
+        console.log("WARNING: notify is deprecated, use startNotification");
+        cordova.exec(success, failure, 'BLE', 'startNotification', [device_id, service_uuid, characteristic_uuid]);
+    },
+
+    // success callback is called on notification
+    startNotification: function (device_id, service_uuid, characteristic_uuid, success, failure) {
+        cordova.exec(success, failure, 'BLE', 'startNotification', [device_id, service_uuid, characteristic_uuid]);
+    },
+
+    // success callback is called when the descriptor 0x2902 is written
+    stopNotification: function (device_id, service_uuid, characteristic_uuid, success, failure) {
+        cordova.exec(success, failure, 'BLE', 'stopNotification', [device_id, service_uuid, characteristic_uuid]);
+    },
+
+    isConnected: function (device_id, success, failure) {
+        cordova.exec(success, failure, 'BLE', 'isConnected', [device_id]);
+    },
+
+    isEnabled: function (success, failure) {
+        cordova.exec(success, failure, 'BLE', 'isEnabled', []);
+    },
+
+    enable: function (success, failure) {
+        cordova.exec(success, failure, "BLE", "enable", []);
+    },
+
+    showBluetoothSettings: function (success, failure) {
+        cordova.exec(success, failure, "BLE", "showBluetoothSettings", []);
+    },
+
+    startStateNotifications: function (success, failure) {
+        cordova.exec(success, failure, "BLE", "startStateNotifications", []);
+    },
+
+    stopStateNotifications: function (success, failure) {
+        cordova.exec(success, failure, "BLE", "stopStateNotifications", []);
+    }
+
+};
+
+module.exports.withPromises = {
+    scan: module.exports.scan,
+    startScan: module.exports.startScan,
+    startScanWithOptions: module.exports.startScanWithOptions,
+    connect: module.exports.connect,
+    startNotification: module.exports.startNotification,
+    startStateNotifications: module.exports.startStateNotifications,
+
+    stopScan: function() {
+        return new Promise(function(resolve, reject) {
+            module.exports.stopScan(resolve, reject);
+        });
+    },
+
+    disconnect: function(device_id) {
+        return new Promise(function(resolve, reject) {
+            module.exports.disconnect(device_id, resolve, reject);
+        });
+    },
+
+    read: function(device_id, service_uuid, characteristic_uuid) {
+        return new Promise(function(resolve, reject) {
+            module.exports.read(device_id, service_uuid, characteristic_uuid, resolve, reject);
+        });
+    },
+
+    write: function(device_id, service_uuid, characteristic_uuid, value) {
+        return new Promise(function(resolve, reject) {
+            module.exports.write(device_id, service_uuid, characteristic_uuid, value, resolve, reject);
+        });
+    },
+
+    writeWithoutResponse: function (device_id, service_uuid, characteristic_uuid, value) {
+        return new Promise(function(resolve, reject) {
+            module.exports.writeWithoutResponse(device_id, service_uuid, characteristic_uuid, value, resolve, reject);
+        });
+    },
+
+    stopNotification: function (device_id, service_uuid, characteristic_uuid) {
+        return new Promise(function(resolve, reject) {
+            module.exports.stopNotification(device_id, service_uuid, characteristic_uuid, resolve, reject);
+        });
+    },
+
+    isConnected: function (device_id) {
+        return new Promise(function(resolve, reject) {
+            module.exports.isConnected(device_id, resolve, reject);
+        });
+    },
+
+    isEnabled: function () {
+        return new Promise(function(resolve, reject) {
+            module.exports.isEnabled(resolve, reject);
+        });
+    },
+
+    enable: function () {
+        return new Promise(function(resolve, reject) {
+            module.exports.enable(resolve, reject);
+        });
+    },
+
+    showBluetoothSettings: function () {
+        return new Promise(function(resolve, reject) {
+            module.exports.showBluetoothSettings(resolve, reject);
+        });
+    },
+
+    stopStateNotifications: function () {
+        return new Promise(function(resolve, reject) {
+            module.exports.stopStateNotifications(resolve, reject);
+        });
+    },
+
+    readRSSI: function(device_id) {
+        return new Promise(function(resolve, reject) {
+            module.exports.readRSSI(device_id, resolve, reject);
+        });
+    }
+};

plugins/cordova-plugin-compat/README.md

@@ -0,0 +1,35 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+
+cordova-plugin-compat
+------------------------
+
+This repo is for remaining backwards compatible with previous versions of Cordova.
+
+## Deprecated
+
+> This plugin is no longer being worked on as the functionality provided by this plugin is now included in cordova-android 6.3.0. You should upgrade your application to use version 1.2.0 of this plugin. It will detect whether or not the plugin is required based on the version of cordova-android your app uses.
+
+## USAGE
+
+Your plugin can depend on this plugin and use it to handle the new run time permissions Android 6.0.0 (cordova-android 5.0.0) introduced. 
+
+View [this commit](https://github.com/apache/cordova-plugin-camera/commit/a9c18710f23e86f5b7f8918dfab7c87a85064870) to see how to depend on `cordova-plugin-compat`. View [this file](https://github.com/apache/cordova-plugin-camera/blob/master/src/android/CameraLauncher.java) to see how `PermissionHelper` is being used to request and store permissions. Read more about Android permissions at http://cordova.apache.org/docs/en/latest/guide/platforms/android/plugin.html#android-permissions.

plugins/cordova-plugin-compat/RELEASENOTES.md

@@ -0,0 +1,33 @@
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Release Notes
+
+### 1.2.0 (Sep 18, 2017)
+* [CB-12730](https://issues.apache.org/jira/browse/CB-12730) Integrate this plugin into `cordova-android@6.3.0` and deprecate this plugin as it is no longer needed.
+* [CB-12730](https://issues.apache.org/jira/browse/CB-12730) Prevent plugin from installing with `cordova-android >= 6.3.0`
+
+### 1.1.0 (Nov 02, 2016)
+* [CB-11625](https://issues.apache.org/jira/browse/CB-11625) Adding the `BuildConfig` fetching code as a backup to using a new preference
+* Add github pull request template
+
+### 1.0.0 (Apr 15, 2016)
+* Initial release
+* Moved `PermissionHelper.java` into `src`

plugins/cordova-plugin-compat/package.json

@@ -0,0 +1,65 @@
+{
+  "_from": "cordova-plugin-compat@^1.2.0",
+  "_id": "cordova-plugin-compat@1.2.0",
+  "_inBundle": false,
+  "_integrity": "sha1-C8ZXVyduvZIMASzpIOJ0F3V2Nz4=",
+  "_location": "/cordova-plugin-compat",
+  "_phantomChildren": {},
+  "_requested": {
+    "type": "range",
+    "registry": true,
+    "raw": "cordova-plugin-compat@^1.2.0",
+    "name": "cordova-plugin-compat",
+    "escapedName": "cordova-plugin-compat",
+    "rawSpec": "^1.2.0",
+    "saveSpec": null,
+    "fetchSpec": "^1.2.0"
+  },
+  "_requiredBy": [
+    "#USER",
+    "/"
+  ],
+  "_resolved": "https://registry.npmjs.org/cordova-plugin-compat/-/cordova-plugin-compat-1.2.0.tgz",
+  "_shasum": "0bc65757276ebd920c012ce920e274177576373e",
+  "_spec": "cordova-plugin-compat@^1.2.0",
+  "_where": "/Users/young/Develop/wifi-ble-client",
+  "author": {
+    "name": "Apache Software Foundation"
+  },
+  "bugs": {
+    "url": "https://github.com/apache/cordova-plugin-compat/issues"
+  },
+  "bundleDependencies": false,
+  "cordova": {
+    "id": "cordova-plugin-compat",
+    "platforms": [
+      "android"
+    ]
+  },
+  "deprecated": false,
+  "description": "[DEPRECATED] This repo is for remaining backwards compatible with previous versions of Cordova.",
+  "engines": {
+    "cordovaDependencies": {
+      "<1.2.0": {
+        "cordova": ">=5.0.0"
+      },
+      ">=1.2.0": {
+        "cordova": ">=5.0.0",
+        "cordova-android": "<6.3.0"
+      }
+    }
+  },
+  "homepage": "http://github.com/apache/cordova-plugin-compat#readme",
+  "keywords": [
+    "ecosystem:cordova",
+    "ecosystem:phonegap",
+    "cordova-android"
+  ],
+  "license": "Apache-2.0",
+  "name": "cordova-plugin-compat",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/apache/cordova-plugin-compat.git"
+  },
+  "version": "1.2.0"
+}

plugins/cordova-plugin-compat/plugin.xml

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+<plugin 
+  xmlns="http://cordova.apache.org/ns/plugins/1.0" id="cordova-plugin-compat" version="1.2.0">
+  <name>Compat</name>
+  <description>[DEPRECATED] Cordova Compatibility Plugin</description>
+  <license>Apache 2.0</license>
+  <keywords>cordova,compat</keywords>
+  <repo>https://git-wip-us.apache.org/repos/asf/cordova-plugin-compat.git</repo>
+  <engines>
+    <engine name="cordova" version=">=5.0.0"/>
+    <engine name="cordova-android" version="
+      <6.3.0"/>
+    </engines>
+    <!-- android -->
+    <platform name="android">
+      <source-file src="src/android/PermissionHelper.java" target-dir="src/org/apache/cordova" />
+      <source-file src="src/android/BuildHelper.java" target-dir="src/org/apache/cordova" />
+    </platform>
+  </plugin>

plugins/cordova-plugin-compat/src/android/BuildHelper.java

@@ -0,0 +1,70 @@
+/*
+       Licensed to the Apache Software Foundation (ASF) under one
+       or more contributor license agreements.  See the NOTICE file
+       distributed with this work for additional information
+       regarding copyright ownership.  The ASF licenses this file
+       to you under the Apache License, Version 2.0 (the
+       "License"); you may not use this file except in compliance
+       with the License.  You may obtain a copy of the License at
+
+         http://www.apache.org/licenses/LICENSE-2.0
+
+       Unless required by applicable law or agreed to in writing,
+       software distributed under the License is distributed on an
+       "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+       KIND, either express or implied.  See the License for the
+       specific language governing permissions and limitations
+       under the License.
+*/
+
+package org.apache.cordova;
+
+/*
+ * This is a utility class that allows us to get the BuildConfig variable, which is required
+ * for the use of different providers.  This is not guaranteed to work, and it's better for this
+ * to be set in the build step in config.xml
+ *
+ */
+
+import android.app.Activity;
+import android.content.Context;
+
+import java.lang.reflect.Field;
+
+
+public class BuildHelper {
+
+
+    private static String TAG="BuildHelper";
+
+    /*
+     * This needs to be implemented if you wish to use the Camera Plugin or other plugins
+     * that read the Build Configuration.
+     *
+     * Thanks to Phil@Medtronic and Graham Borland for finding the answer and posting it to
+     * StackOverflow.  This is annoying as hell!  However, this method does not work with
+     * ProGuard, and you should use the config.xml to define the application_id
+     *
+     */
+
+    public static Object getBuildConfigValue(Context ctx, String key)
+    {
+        try
+        {
+            Class<?> clazz = Class.forName(ctx.getPackageName() + ".BuildConfig");
+            Field field = clazz.getField(key);
+            return field.get(null);
+        } catch (ClassNotFoundException e) {
+            LOG.d(TAG, "Unable to get the BuildConfig, is this built with ANT?");
+            e.printStackTrace();
+        } catch (NoSuchFieldException e) {
+            LOG.d(TAG, key + " is not a valid field. Check your build.gradle");
+        } catch (IllegalAccessException e) {
+            LOG.d(TAG, "Illegal Access Exception: Let's print a stack trace.");
+            e.printStackTrace();
+        }
+
+        return null;
+    }
+
+}

plugins/cordova-plugin-compat/src/android/PermissionHelper.java

@@ -0,0 +1,138 @@
+/*
+       Licensed to the Apache Software Foundation (ASF) under one
+       or more contributor license agreements.  See the NOTICE file
+       distributed with this work for additional information
+       regarding copyright ownership.  The ASF licenses this file
+       to you under the Apache License, Version 2.0 (the
+       "License"); you may not use this file except in compliance
+       with the License.  You may obtain a copy of the License at
+
+         http://www.apache.org/licenses/LICENSE-2.0
+
+       Unless required by applicable law or agreed to in writing,
+       software distributed under the License is distributed on an
+       "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+       KIND, either express or implied.  See the License for the
+       specific language governing permissions and limitations
+       under the License.
+*/
+package org.apache.cordova;
+
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.util.Arrays;
+
+import org.apache.cordova.CordovaInterface;
+import org.apache.cordova.CordovaPlugin;
+import org.apache.cordova.LOG;
+
+import android.content.pm.PackageManager;
+
+/**
+ * This class provides reflective methods for permission requesting and checking so that plugins
+ * written for cordova-android 5.0.0+ can still compile with earlier cordova-android versions.
+ */
+public class PermissionHelper {
+    private static final String LOG_TAG = "CordovaPermissionHelper";
+
+    /**
+     * Requests a "dangerous" permission for the application at runtime. This is a helper method
+     * alternative to cordovaInterface.requestPermission() that does not require the project to be
+     * built with cordova-android 5.0.0+
+     *
+     * @param plugin        The plugin the permission is being requested for
+     * @param requestCode   A requestCode to be passed to the plugin's onRequestPermissionResult()
+     *                      along with the result of the permission request
+     * @param permission    The permission to be requested
+     */
+    public static void requestPermission(CordovaPlugin plugin, int requestCode, String permission) {
+        PermissionHelper.requestPermissions(plugin, requestCode, new String[] {permission});
+    }
+
+    /**
+     * Requests "dangerous" permissions for the application at runtime. This is a helper method
+     * alternative to cordovaInterface.requestPermissions() that does not require the project to be
+     * built with cordova-android 5.0.0+
+     *
+     * @param plugin        The plugin the permissions are being requested for
+     * @param requestCode   A requestCode to be passed to the plugin's onRequestPermissionResult()
+     *                      along with the result of the permissions request
+     * @param permissions   The permissions to be requested
+     */
+    public static void requestPermissions(CordovaPlugin plugin, int requestCode, String[] permissions) {
+        try {
+            Method requestPermission = CordovaInterface.class.getDeclaredMethod(
+                    "requestPermissions", CordovaPlugin.class, int.class, String[].class);
+
+            // If there is no exception, then this is cordova-android 5.0.0+
+            requestPermission.invoke(plugin.cordova, plugin, requestCode, permissions);
+        } catch (NoSuchMethodException noSuchMethodException) {
+            // cordova-android version is less than 5.0.0, so permission is implicitly granted
+            LOG.d(LOG_TAG, "No need to request permissions " + Arrays.toString(permissions));
+
+            // Notify the plugin that all were granted by using more reflection
+            deliverPermissionResult(plugin, requestCode, permissions);
+        } catch (IllegalAccessException illegalAccessException) {
+            // Should never be caught; this is a public method
+            LOG.e(LOG_TAG, "IllegalAccessException when requesting permissions " + Arrays.toString(permissions), illegalAccessException);
+        } catch(InvocationTargetException invocationTargetException) {
+            // This method does not throw any exceptions, so this should never be caught
+            LOG.e(LOG_TAG, "invocationTargetException when requesting permissions " + Arrays.toString(permissions), invocationTargetException);
+        }
+    }
+
+    /**
+     * Checks at runtime to see if the application has been granted a permission. This is a helper
+     * method alternative to cordovaInterface.hasPermission() that does not require the project to
+     * be built with cordova-android 5.0.0+
+     *
+     * @param plugin        The plugin the permission is being checked against
+     * @param permission    The permission to be checked
+     *
+     * @return              True if the permission has already been granted and false otherwise
+     */
+    public static boolean hasPermission(CordovaPlugin plugin, String permission) {
+        try {
+            Method hasPermission = CordovaInterface.class.getDeclaredMethod("hasPermission", String.class);
+
+            // If there is no exception, then this is cordova-android 5.0.0+
+            return (Boolean) hasPermission.invoke(plugin.cordova, permission);
+        } catch (NoSuchMethodException noSuchMethodException) {
+            // cordova-android version is less than 5.0.0, so permission is implicitly granted
+            LOG.d(LOG_TAG, "No need to check for permission " + permission);
+            return true;
+        } catch (IllegalAccessException illegalAccessException) {
+            // Should never be caught; this is a public method
+            LOG.e(LOG_TAG, "IllegalAccessException when checking permission " + permission, illegalAccessException);
+        } catch(InvocationTargetException invocationTargetException) {
+            // This method does not throw any exceptions, so this should never be caught
+            LOG.e(LOG_TAG, "invocationTargetException when checking permission " + permission, invocationTargetException);
+        }
+        return false;
+    }
+
+    private static void deliverPermissionResult(CordovaPlugin plugin, int requestCode, String[] permissions) {
+        // Generate the request results
+        int[] requestResults = new int[permissions.length];
+        Arrays.fill(requestResults, PackageManager.PERMISSION_GRANTED);
+
+        try {
+            Method onRequestPermissionResult = CordovaPlugin.class.getDeclaredMethod(
+                    "onRequestPermissionResult", int.class, String[].class, int[].class);
+
+            onRequestPermissionResult.invoke(plugin, requestCode, permissions, requestResults);
+        } catch (NoSuchMethodException noSuchMethodException) {
+            // Should never be caught since the plugin must be written for cordova-android 5.0.0+ if it
+            // made it to this point
+            LOG.e(LOG_TAG, "NoSuchMethodException when delivering permissions results", noSuchMethodException);
+        } catch (IllegalAccessException illegalAccessException) {
+            // Should never be caught; this is a public method
+            LOG.e(LOG_TAG, "IllegalAccessException when delivering permissions results", illegalAccessException);
+        } catch(InvocationTargetException invocationTargetException) {
+            // This method may throw a JSONException. We are just duplicating cordova-android's
+            // exception handling behavior here; all it does is log the exception in CordovaActivity,
+            // print the stacktrace, and ignore it
+            LOG.e(LOG_TAG, "InvocationTargetException when delivering permissions results", invocationTargetException);
+        }
+    }
+}

plugins/fetch.json

@@ -0,0 +1,18 @@
+{
+  "cordova-plugin-ble-central": {
+    "source": {
+      "type": "registry",
+      "id": "cordova-plugin-ble-central"
+    },
+    "is_top_level": true,
+    "variables": {}
+  },
+  "cordova-plugin-compat": {
+    "source": {
+      "type": "registry",
+      "id": "cordova-plugin-compat@^1.2.0"
+    },
+    "is_top_level": false,
+    "variables": {}
+  }
+}

typings/cordova-typings.d.ts

@@ -0,0 +1,2 @@
+
+/// <reference path="../.vscode/typings/cordova/cordova.d.ts"/>

www/css/index.css

@@ -0,0 +1,27 @@
+* {
+    -webkit-tap-highlight-color: rgba(0,0,0,0); /* make transparent link selection, adjust last value opacity 0 to 1.0 */
+}
+
+body {
+    -webkit-touch-callout: none;                /* prevent callout to copy image, etc when tap to hold */
+    -webkit-text-size-adjust: none;             /* prevent webkit from resizing text to fit */
+    -webkit-user-select: none;                  /* prevent copy paste, to allow, change 'none' to 'text' */
+    font-family:'HelveticaNeue-Light', 'HelveticaNeue', Helvetica, Arial, sans-serif;
+    height:100%;
+    margin:0px;
+    padding:0px;
+    width:100%;
+    text-align: center;
+}
+
+div {
+    padding: 20px;
+}
+
+h1 {
+    font-size:3em;
+}
+
+h2 {
+    font-size:2em;
+}

www/index.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <meta name="format-detection" content="telephone=no" />
+        <meta name="msapplication-tap-highlight" content="no" />
+        <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width, height=device-height, target-densitydpi=device-dpi" />
+        <link rel="stylesheet" type="text/css" href="css/index.css" />
+        <title>Heart Rate</title>
+    </head>
+    <body>
+        <div>
+            <h2>BLE Heart Rate Demo</h2>
+            <h1 id="beatsPerMinute">...</h1>
+            <div id="statusDiv"></div>
+        </div>
+        <script type="text/javascript" src="cordova.js"></script>
+        <script type="text/javascript" src="js/index.js"></script>
+    </body>
+</html>

www/js/index.js

@@ -0,0 +1,104 @@
+// (c) 2015 Don Coleman
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/* global ble, statusDiv, beatsPerMinute */
+/* jshint browser: true , devel: true*/
+
+// See BLE heart rate service http://goo.gl/wKH3X7
+var heartRate = {
+  service: "180d",
+  measurement: "2a37"
+};
+
+function stringToBytes(string) {
+    var array = new Uint8Array(string.length);
+    for (var i = 0, l = string.length; i < l; i++) {
+        array[i] = string.charCodeAt(i);
+     }
+     return array.buffer;
+ }
+
+var app = {
+  initialize: function() {
+    this.bindEvents();
+  },
+  bindEvents: function() {
+    document.addEventListener("deviceready", this.onDeviceReady, false);
+  },
+  onDeviceReady: function() {
+    app.scan();
+  },
+  scan: function() {
+    app.status("Scanning for Heart Rate Monitor");
+
+    var found = false;
+
+    function onScan(device) {
+      // this is demo code, assume there is only one heart rate monitor
+      console.log("Found " + JSON.stringify(device));
+      found = true;
+      if (device.name == "wifitest") {
+        ble.connect(device.id, app.onConnect, app.onDisconnect);
+      }
+    }
+
+    function scanFailure(reason) {
+      alert("BLE Scan Failed");
+    }
+
+    ble.scan([], 5, onScan, scanFailure);
+
+    setTimeout(function() {
+      if (!found) {
+        app.status("Did not find a wifi config service.");
+      }
+    }, 5000);
+  },
+  onConnect: function(peripheral) {
+    app.status("Connected to " + peripheral.id);
+    var data = stringToBytes("test");
+    ble.write(
+      peripheral.id,
+      "ffffffff-ffff-ffff-ffff-fffffffffff0",
+      "ffffffff-ffff-ffff-ffff-fffffffffff1",
+      data,
+      function() {
+        console.log("success");
+      },
+      function(error) {
+        console.log(error);
+      }
+    );
+  },
+  onDisconnect: function(reason) {
+    alert("Disconnected " + reason);
+    beatsPerMinute.innerHTML = "...";
+    app.status("Disconnected");
+  },
+  onData: function(buffer) {
+    // assuming heart rate measurement is Uint8 format, real code should check the flags
+    // See the characteristic specs http://goo.gl/N7S5ZS
+    var data = new Uint8Array(buffer);
+    beatsPerMinute.innerHTML = data[1];
+  },
+  onError: function(reason) {
+    alert("There was an error " + reason);
+  },
+  status: function(message) {
+    console.log(message);
+    statusDiv.innerHTML = message;
+  }
+};
+
+app.initialize();