Implement support for the OOB Pairing APIs.

chromeos/dbus/bluetooth_out_of_band_client.h

+// Copyright (c) 2012 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.
+
+#ifndef CHROMEOS_DBUS_BLUETOOTH_OUT_OF_BAND_CLIENT_H_
+#define CHROMEOS_DBUS_BLUETOOTH_OUT_OF_BAND_CLIENT_H_
+#pragma once
+
+#include <string>
+
+#include "base/callback.h"
+#include "chromeos/chromeos_export.h"
+#include "chromeos/dbus/dbus_client_implementation_type.h"
+#include "dbus/object_path.h"
+
+namespace dbus {
+class Bus;
+}  // namespace dbus
+
+namespace chromeos {
+
+const size_t kBluetoothOutOfBandPairingDataSize = 16;
+
+// A simple structure representing the data required to perform Out Of Band
+// Pairing.  See
+// http://mclean-linsky.net/joel/cv/Simple%20Pairing_WP_V10r00.pdf
+struct BluetoothOutOfBandPairingData {
+  // Simple Pairing Hash C.
+  uint8_t hash[kBluetoothOutOfBandPairingDataSize];
+
+  // Simple Pairing Randomizer R.
+  uint8_t randomizer[kBluetoothOutOfBandPairingDataSize];
+};
+
+// BluetoothOutOfBandClient is used to manage Out Of Band Pairing
+// Data for the local adapter and remote devices.
+class CHROMEOS_EXPORT BluetoothOutOfBandClient {
+ public:
+  virtual ~BluetoothOutOfBandClient();
+
+  typedef base::Callback<void(const BluetoothOutOfBandPairingData& data,
+      bool success)> DataCallback;
+
+  typedef base::Callback<void(bool success)> SuccessCallback;
+
+  // Reads the local Out Of Band Pairing Data and return it in |callback|.
+  virtual void ReadLocalData(
+      const dbus::ObjectPath& object_path,
+      const DataCallback& callback) = 0;
+
+  // Sets the Out Of Band Pairing Data for the device at |address| to |data|,
+  // indicating success via |callback|.  Makes a copy of |data|.
+  virtual void AddRemoteData(
+      const dbus::ObjectPath& object_path,
+      const std::string& address,
+      const BluetoothOutOfBandPairingData& data,
+      const SuccessCallback& callback) = 0;
+
+  // Clears the Out Of Band Pairing Data for the device at |address|, indicating
+  // success via |callback|.
+  virtual void RemoveRemoteData(
+      const dbus::ObjectPath& object_path,
+      const std::string& address,
+      const SuccessCallback& callback) = 0;
+
+  // Creates the instance.
+  static BluetoothOutOfBandClient* Create(
+      DBusClientImplementationType type,
+      dbus::Bus* bus);
+
+ protected:
+  BluetoothOutOfBandClient();
+
+ private:
+  DISALLOW_COPY_AND_ASSIGN(BluetoothOutOfBandClient);
+};
+
+}  // namespace chromeos
+
+#endif  // CHROMEOS_DBUS_BLUETOOTH_OUT_OF_BAND_CLIENT_H_