Merge pull request #261 from randdusing/queue

Queue

Author: randdusing

CHANGELOG.md

@@ -1,3 +1,9 @@
+## master - 2016-03-30
+- wasConnected helper function
+- Improved subscribe with Android. No longer need to specify whether notification or indication
+- Read/write queueing for Android
+- Everything now runs on the single WebCore thread with Android. It should prevent issues with race conditions. I still need to verify there are no changes in performance.
+
 ## 4.0.0 - 2016-03-30
 - Update OS X
 - Fix initializePeripheral issue when not passing parameters on iOS.

plugin.xml

@@ -19,6 +19,7 @@
       </feature>
     </config-file>
     <source-file src="src/android/BluetoothLePlugin.java" target-dir="src/com/randdusing/bluetoothle" />
+    <source-file src="src/android/Operation.java" target-dir="src/com/randdusing/bluetoothle" />
     <config-file target="AndroidManifest.xml" parent="/manifest">
       <uses-permission android:name="android.permission.BLUETOOTH"/>
       <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>

readme.md

@@ -36,7 +36,6 @@ I'm available for hire on Bluetooth Low Energy, Ionic and Cordova projects. This
 ## To Do ##
 
 * Expand Windows support
-* Operation queueing on Android (possibly). See Queuing section below.
 * Improved notifications on peripheral/server role between Android and iOS
 * Code refactoring. It's getting pretty messy.
 
@@ -45,7 +44,7 @@ I'm available for hire on Bluetooth Low Energy, Ionic and Cordova projects. This
 
 Check out ng-cordova-bluetoothle [here!](https://github.com/randdusing/ng-cordova-bluetoothle)
 
-If timeouts or queueing is needed, please check out the Angular wrapper and its example. I don't plan to implement queuing within the plugin itself anymore.
+If timeouts are needed, please check out the Angular wrapper and its example.
 
 
 ## Installation ##
@@ -80,10 +79,7 @@ Discovery works differently between Android and iOS. In Android, a single functi
 
 
 ## Queuing (Android) ##
-Android commands must be queued. I recommend using promises like in the AngularJS wrapper to queue from the app level. There are a few issues when trying to queue from the plugin level, so I'm still determining how to implement it:
-1. Queuing needs to be done at a "global" level rather than per connection.
-2. Timeouts would be needed so that the queue would continue processing if onCharacteristicRead, onCharacteristicWrite, etc are never called.
-3. Queue would need to be "cleaned" if a device disconnects.
+Read and write queueing has been added to the master branch and will be part of the 4.1.0 release. If you'd like to try it out, install the plugin directly from GitHub using: ```cordova plugin https://github.com/randdusing/cordova-plugin-bluetoothle```
 
 
 ## UUIDs ##