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(hal::BluetoothGattInterface* gatt_iface, 73 int status, int client_id, 74 const bt_uuid_t& app_uuid) override; 75 76 // Map of pending calls to register. 77 std::mutex pending_calls_lock_; 78 std::unordered_map<UUID, RegisterCallback> pending_calls_; 79 80 DISALLOW_COPY_AND_ASSIGN(GattClientFactory); 81 }; 82 83 } // namespace bluetooth 84