Add easyUnlockPrivate.getConnection API.

chrome/common/extensions/api/easy_unlock_private.idl

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // <code>chrome.easyUnlockPrivate</code> API that provides hooks to Chrome to
 // be used by Easy Unlock component app.
 namespace easyUnlockPrivate {
   // Signature algorithms supported by the crypto library methods used by
   // Easy Unlock.
   enum SignatureType {
@@ skipping 167 matching lines @@
   // will be empty.
   // If the requested nonce could not be signed, |signedNonce| will be empty.
   // |challenge|: The sign in challenge to be used when signing in the user
   //     currently associated with the Easy Unlock service.
   // |signedNonce|: Nonce signed by Chrome OS TPM, provided as an argument to
   //     the |getSignInChallenge()| function and signed by the TPM key
   //     associated with the user.
   callback SignInChallengeCallback = void(optional ArrayBuffer challenge,
                                           optional ArrayBuffer signedNonce);
 
+  // Callback for |getConnectionInfo()| method.

[Yoyo Zhou, 2015/01/08 20:23:05]

nit: Callback for the ...
I think it's also worth documenting the parameters.

[Tim Song, 2015/01/09 00:31:46]

Done.

+  callback ConnectionInfoCallback = void(
+      long rssi, long transmit_power, long max_transmit_power);
+
   interface Functions {
     // Gets localized strings required to render the API.
     //
     // |callback| : Called with a dictionary mapping names to resource strings.
     // TODO(isherman): This is essentially copied from identity_private.idl.
     //                 Perhaps this should be extracted to a common API instead?
     static void getStrings(GetStringsCallback callback);
 
     // Generates a ECDSA key pair for P256 curve.
     // Public key will be in format recognized by secure wire transport protocol
@@ skipping 110 matching lines @@
     // success, the user session will be started.
     static void trySignInSecret(ArrayBuffer signInSecret,
                                 EmptyCallback callback);
 
     // Retrieves information about the user associated with the Easy unlock
     // service.
     static void getUserInfo(GetUserInfoCallback callback);
 
     // Gets the user's profile image as a bitmap.
     static void getUserImage(DataCallback callback);
+
+    // Gets the connection info for the Bluetooth device identified by
+    // deviceAddress.
+    static void getConnectionInfo(DOMString deviceAddress,
+                                  ConnectionInfoCallback callback);
   };
 
   interface Events {
     // Event fired when the data for the user currently associated with
     // Easy unlock service is updated.
     // |userInfo| The updated user information.
     static void onUserInfoUpdated(UserInfo userInfo);
   };
 };