service/gatt_client.h

   1 //
   2 //  Copyright (C) 2015 Google, Inc.
   3 //
   4 //  Licensed under the Apache License, Version 2.0 (the "License");
   5 //  you may not use this file except in compliance with the License.
   6 //  You may obtain a copy of the License at:
   7 //
   8 //  http://www.apache.org/licenses/LICENSE-2.0
   9 //
  10 //  Unless required by applicable law or agreed to in writing, software
  11 //  distributed under the License is distributed on an "AS IS" BASIS,
  12 //  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 //  See the License for the specific language governing permissions and
  14 //  limitations under the License.
  15 //
  16
  17 #pragma once
  18
  19 #include <mutex>
  20 #include <unordered_map>
  21
  22 #include <base/macros.h>
  23
  24 #include "service/bluetooth_instance.h"
  25 #include "service/common/bluetooth/uuid.h"
  26 #include "service/hal/bluetooth_gatt_interface.h"
  27
  28 namespace bluetooth {
  29
  30 // A GattClient instance represents an application's handle to perform GATT
  31 // client-role operations. Instances cannot be created directly and should be
  32 // obtained through the factory.
  33 class GattClient : public BluetoothInstance {
  34  public:
  35   ~GattClient() override;
  36
  37   // BluetoothClientInstace overrides:
  38   const UUID& GetAppIdentifier() const override;
  39   int GetInstanceId() const override;
  40
  41  private:
  42   friend class GattClientFactory;
  43
  44   // Constructor shouldn't be called directly as instances are meant to be
  45   // obtained from the factory.
  46   GattClient(const UUID& uuid, int client_id);
  47
  48   // See getters above for documentation.
  49   UUID app_identifier_;
  50   int client_id_;
  51
  52   DISALLOW_COPY_AND_ASSIGN(GattClient);
  53 };
  54
  55 // GattClientFactory is used to register and obtain a per-application GattClient
  56 // instance. Users should call RegisterClient to obtain their own unique
  57 // GattClient instance that has been registered with the Bluetooth stack.
  58 class GattClientFactory : public BluetoothInstanceFactory,
  59                           private hal::BluetoothGattInterface::ClientObserver {
  60  public:
  61   // Don't construct/destruct directly except in tests. Instead, obtain a handle
  62   // from an Adapter instance.
  63   GattClientFactory();
  64   ~GattClientFactory() override;
  65
  66   // BluetoothInstanceFactory override:
  67   bool RegisterInstance(const UUID& uuid,
  68                         const RegisterCallback& callback) override;
  69
  70  private:
  71   // hal::BluetoothGattInterface::ClientObserver override:
  72   void RegisterClientCallback(
  73       hal::BluetoothGattInterface* gatt_iface,
  74       int status, int client_id,
  75       const bt_uuid_t& app_uuid) override;
  76
  77   // Map of pending calls to register.
  78   std::mutex pending_calls_lock_;
  79   std::unordered_map<UUID, RegisterCallback> pending_calls_;
  80
  81   DISALLOW_COPY_AND_ASSIGN(GattClientFactory);
  82 };
  83
  84 }  // namespace bluetooth