added setPin method to android

Author: gregor-nomnio

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "editor.formatOnSave": false
+}

readme.md

@@ -62,6 +62,7 @@ This plugin allows you to interact with Bluetooth LE devices on Android, iOS, an
   - [requestPermission](#requestpermission)
   - [isLocationEnabled](#islocationenabled)
   - [requestLocation](#requestlocation)
+  - [setPin](#setPin)
 - [Peripheral Life Cycle](#peripheral-life-cycle)
   - [Initilization](#initilization)
   - [Notifications](#notifications)
@@ -245,6 +246,7 @@ Neither Android nor iOS support Bluetooth on emulators, so you'll need to test o
 * [bluetoothle.stopAdvertising](#stopadvertising)
 * [bluetoothle.respond](#respond)
 * [bluetoothle.notify](#notify)
+* [bluetoothle.setPin](#setPin) (Android)
 * [bluetoothle.encodedStringToBytes](#encodedstringtobytes)
 * [bluetoothle.bytesToEncodedString](#bytestoencodedstring)
 * [bluetoothle.stringToBytes](#stringtobytes)
@@ -286,6 +288,7 @@ Whenever the error callback is executed, the return object will contain the erro
 * isNotConnected - Device isn't connected (Don't call discover or any read/write operations)
 * isDisconnected - Device is disconnected (Don't call disconnect)
 * isBonded - Operation is unsupported. (Is the device Android?)
+* setPin - Operation is unsupported. (Is the device Android?)
 
 For example:
 ```javascript
@@ -1559,7 +1562,32 @@ bluetoothle.isBonded(isBondedSuccess, isBondedError, params);
 }
 ```
 
+### setPin ###
+Set PIN if required by the pairing process. Android support only.
 
+```javascript
+bluetoothle.setPin(success, error, params);
+```
+
+#### Params ####
+* address = The address/identifier provided by the scan's return object
+* pin = Pairing PIN code
+
+```javascript
+{
+  "address": "5A:94:4B:38:B3:FD",
+  "pin": "1234"
+}
+```
+
+##### Success #####
+* status => string
+
+```javascript
+{
+  "status": "pinSet",
+}
+```
 
 ### wasConnected ###
 Determine whether the device was connected, or error if not initialized.

src/android/BluetoothLePlugin.java

@@ -129,6 +129,7 @@ public class BluetoothLePlugin extends CordovaPlugin {
   private final String keyDiscoveredState = "discoveredState";
   private final String keyConnectionPriority = "connectionPriority";
   private final String keyMtu = "mtu";
+  private final String keyPin = "pin";
 
   //Write Types
   private final String writeTypeNoResponse = "noResponse";
@@ -421,6 +422,8 @@ public boolean execute(String action, final JSONArray args, final CallbackContex
       respondAction(args, callbackContext);
     } else if ("notify".equals(action)) {
       notifyAction(args, callbackContext);
+    } else if ("setPin".equals(action)) {
+      setPinAction(args, callbackContext);
     } else {
       return false;
     }
@@ -2767,6 +2770,66 @@ private void requestConnectionPriorityAction(JSONArray args, CallbackContext cal
     }
   }
 
+  private void setPinAction(JSONArray args, CallbackContext callbackContext) {
+    Log.d("BLE","set pin");
+    if (mPairingRequestReceiver!=null) {
+      cordova.getActivity().unregisterReceiver(mPairingRequestReceiver);
+    }
+
+    if (isNotInitialized(callbackContext, true)) {
+      return;
+    }
+
+    JSONObject obj = getArgsObject(args);
+    if (isNotArgsObject(obj, callbackContext)) {
+      return;
+    }
+    
+    String address = getAddress(obj);
+    if (isNotAddress(address, callbackContext)) {
+      return;
+    }
+
+    String pin = getPin(obj);
+    if (pin==null) {
+      return;
+    }
+    
+    Log.d("BLE","set pin "  + address  + " " + pin);
+    JSONObject returnObj = new JSONObject();
+    try {
+      mPairingRequestReceiver = new BroadcastReceiver() {
+        @Override
+        public void onReceive(Context context, Intent intent) {
+          Log.d("BLE", "on receive");
+          String action = intent.getAction();
+          if (BluetoothDevice.ACTION_PAIRING_REQUEST.equals(action)) {
+            BluetoothDevice bluetoothDevice = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
+            if(bluetoothDevice.getAddress().equalsIgnoreCase(address)){
+              int type = intent.getIntExtra(BluetoothDevice.EXTRA_PAIRING_VARIANT, BluetoothDevice.ERROR);
+              if (type == BluetoothDevice.PAIRING_VARIANT_PIN) {
+                bluetoothDevice.setPin(pin.getBytes());
+                abortBroadcast();
+              }
+            }
+          }
+        }
+      };
+      IntentFilter intentFilter = new IntentFilter(BluetoothDevice.ACTION_PAIRING_REQUEST);
+      intentFilter.setPriority(IntentFilter.SYSTEM_HIGH_PRIORITY);
+      cordova.getActivity().registerReceiver(mPairingRequestReceiver, intentFilter);
+      addProperty(returnObj, keyStatus, "pinSet");
+      callbackContext.success(returnObj);
+    } catch (Exception e) {
+      Log.d("BLE","exception " + e.getMessage());
+      addProperty(returnObj, keyError, "setPin");
+      addProperty(returnObj, keyMessage, "Failed to set pin");
+      callbackContext.error(returnObj);
+    }
+    return;
+
+  }
+
   @Override
   public void onDestroy() {
     super.onDestroy();
@@ -2777,6 +2840,9 @@ public void onDestroy() {
     if (isBondReceiverRegistered) {
       cordova.getActivity().unregisterReceiver(mBondReceiver);
     }
+    if(mPairingRequestReceiver!=null){
+      cordova.getActivity().unregisterReceiver(mPairingRequestReceiver);
+    }
   }
 
   private BroadcastReceiver mReceiver = new BroadcastReceiver() {
@@ -2888,6 +2954,8 @@ public void onReceive(Context context, Intent intent) {
       }
     }
   };
+  
+  private BroadcastReceiver mPairingRequestReceiver;
 
   @Override
   public void onActivityResult(int requestCode, int resultCode, Intent intent) {
@@ -3903,6 +3971,12 @@ private JSONObject getPermissions(BluetoothGattDescriptor descriptor) {
     return permissionsObject;
   }
 
+  private String getPin(JSONObject obj) {
+    //Get the pin string from arguments
+    String pin = obj.optString(keyPin, null);
+    return pin;
+  }
+
   //Bluetooth callback for connecting, discovering, reading and writing
   private BluetoothGattCallback bluetoothGattCallback = new BluetoothGattCallback() {
     @Override

types/index.d.ts

@@ -540,6 +540,18 @@ declare namespace BluetoothlePlugin {
             error: (error: Error) => void,
             params: NotifyParams): void;
 
+        /**
+         * Set pin if required to pair with a device. Android support only.
+         * @param success   The success callback that is passed with device's status and sent value
+         * @param error     The callback that will be triggered when the bond operation fails
+         * @param params    The set pin params
+         *
+         */
+        setPin(
+            success: (result: { status:Status }) => void,
+            error: (error: Error) => void,
+            params: { address: string, pin:string }): void;
+
         /**
          * Helper function to convert a base64 encoded string from a characteristic or descriptor value into a uint8Array object
          * @param  value Encoded string which need t be encoded

www/bluetoothle.js

@@ -141,6 +141,9 @@ var bluetoothle = {
   notify: function(successCallback, errorCallback, params) {
     cordova.exec(successCallback, errorCallback, bluetoothleName, "notify", [params]);
   },
+  setPin: function(successCallback, errorCallback, params) {
+    cordova.exec(successCallback, errorCallback, bluetoothleName, "setPin", [params]);
+  },
   encodedStringToBytes: function(string) {
     var data = atob(string);
     var bytes = new Uint8Array(data.length);