// 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. #include "device/bluetooth/dbus/bluetooth_gatt_descriptor_service_provider.h" #include #include #include "base/bind.h" #include "base/logging.h" #include "base/macros.h" #include "base/memory/weak_ptr.h" #include "base/strings/string_util.h" #include "base/threading/platform_thread.h" #include "dbus/exported_object.h" #include "dbus/message.h" #include "device/bluetooth/dbus/bluez_dbus_manager.h" #include "device/bluetooth/dbus/fake_bluetooth_gatt_descriptor_service_provider.h" #include "third_party/cros_system_api/dbus/service_constants.h" namespace bluez { namespace { const char kErrorInvalidArgs[] = "org.freedesktop.DBus.Error.InvalidArgs"; const char kErrorPropertyReadOnly[] = "org.freedesktop.DBus.Error.PropertyReadOnly"; const char kErrorFailed[] = "org.freedesktop.DBus.Error.Failed"; } // namespace // The BluetoothGattDescriptorServiceProvider implementation used in production. class BluetoothGattDescriptorServiceProviderImpl : public BluetoothGattDescriptorServiceProvider { public: BluetoothGattDescriptorServiceProviderImpl( dbus::Bus* bus, const dbus::ObjectPath& object_path, Delegate* delegate, const std::string& uuid, const std::vector& permissions, const dbus::ObjectPath& characteristic_path) : origin_thread_id_(base::PlatformThread::CurrentId()), uuid_(uuid), bus_(bus), delegate_(delegate), object_path_(object_path), characteristic_path_(characteristic_path), weak_ptr_factory_(this) { VLOG(1) << "Created Bluetooth GATT characteristic descriptor: " << object_path.value() << " UUID: " << uuid; DCHECK(bus_); DCHECK(delegate_); DCHECK(!uuid_.empty()); DCHECK(object_path_.IsValid()); DCHECK(characteristic_path_.IsValid()); DCHECK(base::StartsWith(object_path_.value(), characteristic_path_.value() + "/", base::CompareCase::SENSITIVE)); exported_object_ = bus_->GetExportedObject(object_path_); exported_object_->ExportMethod( dbus::kDBusPropertiesInterface, dbus::kDBusPropertiesGet, base::Bind(&BluetoothGattDescriptorServiceProviderImpl::Get, weak_ptr_factory_.GetWeakPtr()), base::Bind(&BluetoothGattDescriptorServiceProviderImpl::OnExported, weak_ptr_factory_.GetWeakPtr())); exported_object_->ExportMethod( dbus::kDBusPropertiesInterface, dbus::kDBusPropertiesSet, base::Bind(&BluetoothGattDescriptorServiceProviderImpl::Set, weak_ptr_factory_.GetWeakPtr()), base::Bind(&BluetoothGattDescriptorServiceProviderImpl::OnExported, weak_ptr_factory_.GetWeakPtr())); exported_object_->ExportMethod( dbus::kDBusPropertiesInterface, dbus::kDBusPropertiesGetAll, base::Bind(&BluetoothGattDescriptorServiceProviderImpl::GetAll, weak_ptr_factory_.GetWeakPtr()), base::Bind(&BluetoothGattDescriptorServiceProviderImpl::OnExported, weak_ptr_factory_.GetWeakPtr())); } ~BluetoothGattDescriptorServiceProviderImpl() override { VLOG(1) << "Cleaning up Bluetooth GATT characteristic descriptor: " << object_path_.value(); bus_->UnregisterExportedObject(object_path_); } // BluetoothGattDescriptorServiceProvider override. void SendValueChanged(const std::vector& value) override { VLOG(2) << "Emitting a PropertiesChanged signal for descriptor value."; dbus::Signal signal(dbus::kDBusPropertiesInterface, dbus::kDBusPropertiesChangedSignal); dbus::MessageWriter writer(&signal); dbus::MessageWriter array_writer(NULL); dbus::MessageWriter dict_entry_writer(NULL); dbus::MessageWriter variant_writer(NULL); // interface_name writer.AppendString( bluetooth_gatt_descriptor::kBluetoothGattDescriptorInterface); // changed_properties writer.OpenArray("{sv}", &array_writer); array_writer.OpenDictEntry(&dict_entry_writer); dict_entry_writer.AppendString(bluetooth_gatt_descriptor::kValueProperty); dict_entry_writer.OpenVariant("ay", &variant_writer); variant_writer.AppendArrayOfBytes(value.data(), value.size()); dict_entry_writer.CloseContainer(&variant_writer); array_writer.CloseContainer(&dict_entry_writer); writer.CloseContainer(&array_writer); // invalidated_properties. writer.OpenArray("s", &array_writer); writer.CloseContainer(&array_writer); exported_object_->SendSignal(&signal); } private: // Returns true if the current thread is on the origin thread. bool OnOriginThread() { return base::PlatformThread::CurrentId() == origin_thread_id_; } // Called by dbus:: when the Bluetooth daemon fetches a single property of // the descriptor. void Get(dbus::MethodCall* method_call, dbus::ExportedObject::ResponseSender response_sender) { VLOG(2) << "BluetoothGattDescriptorServiceProvider::Get: " << object_path_.value(); DCHECK(OnOriginThread()); dbus::MessageReader reader(method_call); std::string interface_name; std::string property_name; if (!reader.PopString(&interface_name) || !reader.PopString(&property_name) || reader.HasMoreData()) { scoped_ptr error_response = dbus::ErrorResponse::FromMethodCall(method_call, kErrorInvalidArgs, "Expected 'ss'."); response_sender.Run(std::move(error_response)); return; } // Only the GATT descriptor interface is supported. if (interface_name != bluetooth_gatt_descriptor::kBluetoothGattDescriptorInterface) { scoped_ptr error_response = dbus::ErrorResponse::FromMethodCall( method_call, kErrorInvalidArgs, "No such interface: '" + interface_name + "'."); response_sender.Run(std::move(error_response)); return; } // If getting the "Value" property, obtain the value from the delegate. if (property_name == bluetooth_gatt_descriptor::kValueProperty) { DCHECK(delegate_); delegate_->GetDescriptorValue( base::Bind(&BluetoothGattDescriptorServiceProviderImpl::OnGet, weak_ptr_factory_.GetWeakPtr(), method_call, response_sender), base::Bind(&BluetoothGattDescriptorServiceProviderImpl::OnFailure, weak_ptr_factory_.GetWeakPtr(), method_call, response_sender)); return; } scoped_ptr response = dbus::Response::FromMethodCall(method_call); dbus::MessageWriter writer(response.get()); dbus::MessageWriter variant_writer(NULL); // TODO(armansito): Process the "Permissions" property below. if (property_name == bluetooth_gatt_descriptor::kUUIDProperty) { writer.OpenVariant("s", &variant_writer); variant_writer.AppendString(uuid_); writer.CloseContainer(&variant_writer); } else if (property_name == bluetooth_gatt_descriptor::kCharacteristicProperty) { writer.OpenVariant("o", &variant_writer); variant_writer.AppendObjectPath(characteristic_path_); writer.CloseContainer(&variant_writer); } else { response = dbus::ErrorResponse::FromMethodCall( method_call, kErrorInvalidArgs, "No such property: '" + property_name + "'."); } response_sender.Run(std::move(response)); } // Called by dbus:: when the Bluetooth daemon sets a single property of the // descriptor. void Set(dbus::MethodCall* method_call, dbus::ExportedObject::ResponseSender response_sender) { VLOG(2) << "BluetoothGattDescriptorServiceProvider::Set: " << object_path_.value(); DCHECK(OnOriginThread()); dbus::MessageReader reader(method_call); std::string interface_name; std::string property_name; dbus::MessageReader variant_reader(NULL); if (!reader.PopString(&interface_name) || !reader.PopString(&property_name) || !reader.PopVariant(&variant_reader) || reader.HasMoreData()) { scoped_ptr error_response = dbus::ErrorResponse::FromMethodCall(method_call, kErrorInvalidArgs, "Expected 'ssv'."); response_sender.Run(std::move(error_response)); return; } // Only the GATT descriptor interface is allowed. if (interface_name != bluetooth_gatt_descriptor::kBluetoothGattDescriptorInterface) { scoped_ptr error_response = dbus::ErrorResponse::FromMethodCall( method_call, kErrorInvalidArgs, "No such interface: '" + interface_name + "'."); response_sender.Run(std::move(error_response)); return; } // Only the "Value" property is writeable. if (property_name != bluetooth_gatt_descriptor::kValueProperty) { std::string error_name; std::string error_message; if (property_name == bluetooth_gatt_descriptor::kUUIDProperty || property_name == bluetooth_gatt_descriptor::kCharacteristicProperty) { error_name = kErrorPropertyReadOnly; error_message = "Read-only property: '" + property_name + "'."; } else { error_name = kErrorInvalidArgs; error_message = "No such property: '" + property_name + "'."; } scoped_ptr error_response = dbus::ErrorResponse::FromMethodCall(method_call, error_name, error_message); response_sender.Run(std::move(error_response)); return; } // Obtain the value. const uint8_t* bytes = NULL; size_t length = 0; if (!variant_reader.PopArrayOfBytes(&bytes, &length)) { scoped_ptr error_response = dbus::ErrorResponse::FromMethodCall( method_call, kErrorInvalidArgs, "Property '" + property_name + "' has type 'ay'."); response_sender.Run(std::move(error_response)); return; } // Pass the set request onto the delegate. std::vector value(bytes, bytes + length); DCHECK(delegate_); delegate_->SetDescriptorValue( value, base::Bind(&BluetoothGattDescriptorServiceProviderImpl::OnSet, weak_ptr_factory_.GetWeakPtr(), method_call, response_sender), base::Bind(&BluetoothGattDescriptorServiceProviderImpl::OnFailure, weak_ptr_factory_.GetWeakPtr(), method_call, response_sender)); } // Called by dbus:: when the Bluetooth daemon fetches all properties of the // descriptor. void GetAll(dbus::MethodCall* method_call, dbus::ExportedObject::ResponseSender response_sender) { VLOG(2) << "BluetoothGattDescriptorServiceProvider::GetAll: " << object_path_.value(); DCHECK(OnOriginThread()); dbus::MessageReader reader(method_call); std::string interface_name; if (!reader.PopString(&interface_name) || reader.HasMoreData()) { scoped_ptr error_response = dbus::ErrorResponse::FromMethodCall(method_call, kErrorInvalidArgs, "Expected 's'."); response_sender.Run(std::move(error_response)); return; } // Only the GATT descriptor interface is supported. if (interface_name != bluetooth_gatt_descriptor::kBluetoothGattDescriptorInterface) { scoped_ptr error_response = dbus::ErrorResponse::FromMethodCall( method_call, kErrorInvalidArgs, "No such interface: '" + interface_name + "'."); response_sender.Run(std::move(error_response)); return; } // Try to obtain the value from the delegate. We will construct the // response in the success callback. DCHECK(delegate_); delegate_->GetDescriptorValue( base::Bind(&BluetoothGattDescriptorServiceProviderImpl::OnGetAll, weak_ptr_factory_.GetWeakPtr(), method_call, response_sender), base::Bind(&BluetoothGattDescriptorServiceProviderImpl::OnFailure, weak_ptr_factory_.GetWeakPtr(), method_call, response_sender)); } // Called by dbus:: when a method is exported. void OnExported(const std::string& interface_name, const std::string& method_name, bool success) { LOG_IF(WARNING, !success) << "Failed to export " << interface_name << "." << method_name; } // Called by the Delegate in response to a method to call to get all // properties, in which the delegate has successfully returned the // descriptor value. void OnGetAll(dbus::MethodCall* method_call, dbus::ExportedObject::ResponseSender response_sender, const std::vector& value) { VLOG(2) << "Descriptor value obtained from delegate. Responding to " << "GetAll."; scoped_ptr response = dbus::Response::FromMethodCall(method_call); dbus::MessageWriter writer(response.get()); dbus::MessageWriter array_writer(NULL); dbus::MessageWriter dict_entry_writer(NULL); dbus::MessageWriter variant_writer(NULL); writer.OpenArray("{sv}", &array_writer); array_writer.OpenDictEntry(&dict_entry_writer); dict_entry_writer.AppendString(bluetooth_gatt_descriptor::kUUIDProperty); dict_entry_writer.AppendVariantOfString(uuid_); array_writer.CloseContainer(&dict_entry_writer); array_writer.OpenDictEntry(&dict_entry_writer); dict_entry_writer.AppendString( bluetooth_gatt_descriptor::kCharacteristicProperty); dict_entry_writer.AppendVariantOfObjectPath(characteristic_path_); array_writer.CloseContainer(&dict_entry_writer); array_writer.OpenDictEntry(&dict_entry_writer); dict_entry_writer.AppendString(bluetooth_gatt_descriptor::kValueProperty); dict_entry_writer.OpenVariant("ay", &variant_writer); variant_writer.AppendArrayOfBytes(value.data(), value.size()); dict_entry_writer.CloseContainer(&variant_writer); array_writer.CloseContainer(&dict_entry_writer); // TODO(armansito): Process "Permissions" property. writer.CloseContainer(&array_writer); response_sender.Run(std::move(response)); } // Called by the Delegate in response to a successful method call to get the // descriptor value. void OnGet(dbus::MethodCall* method_call, dbus::ExportedObject::ResponseSender response_sender, const std::vector& value) { VLOG(2) << "Returning descriptor value obtained from delegate."; scoped_ptr response = dbus::Response::FromMethodCall(method_call); dbus::MessageWriter writer(response.get()); dbus::MessageWriter variant_writer(NULL); writer.OpenVariant("ay", &variant_writer); variant_writer.AppendArrayOfBytes(value.data(), value.size()); writer.CloseContainer(&variant_writer); response_sender.Run(std::move(response)); } // Called by the Delegate in response to a successful method call to set the // descriptor value. void OnSet(dbus::MethodCall* method_call, dbus::ExportedObject::ResponseSender response_sender) { VLOG(2) << "Successfully set descriptor value. Return success."; response_sender.Run(dbus::Response::FromMethodCall(method_call)); } // Called by the Delegate in response to a failed method call to get or set // the descriptor value. void OnFailure(dbus::MethodCall* method_call, dbus::ExportedObject::ResponseSender response_sender) { VLOG(2) << "Failed to get/set descriptor value. Report error."; scoped_ptr error_response = dbus::ErrorResponse::FromMethodCall( method_call, kErrorFailed, "Failed to get/set descriptor value."); response_sender.Run(std::move(error_response)); } // Origin thread (i.e. the UI thread in production). base::PlatformThreadId origin_thread_id_; // 128-bit descriptor UUID of this object. std::string uuid_; // D-Bus bus object is exported on, not owned by this object and must // outlive it. dbus::Bus* bus_; // Incoming methods to get and set the "Value" property are passed on to the // delegate and callbacks passed to generate a reply. |delegate_| is generally // the object that owns this one and must outlive it. Delegate* delegate_; // D-Bus object path of object we are exporting, kept so we can unregister // again in our destructor. dbus::ObjectPath object_path_; // Object path of the GATT characteristic that the exported descriptor belongs // to. dbus::ObjectPath characteristic_path_; // D-Bus object we are exporting, owned by this object. scoped_refptr exported_object_; // Weak pointer factory for generating 'this' pointers that might live longer // than we do. // Note: This should remain the last member so it'll be destroyed and // invalidate its weak pointers before any other members are destroyed. base::WeakPtrFactory weak_ptr_factory_; DISALLOW_COPY_AND_ASSIGN(BluetoothGattDescriptorServiceProviderImpl); }; BluetoothGattDescriptorServiceProvider:: BluetoothGattDescriptorServiceProvider() {} BluetoothGattDescriptorServiceProvider:: ~BluetoothGattDescriptorServiceProvider() {} // static BluetoothGattDescriptorServiceProvider* BluetoothGattDescriptorServiceProvider::Create( dbus::Bus* bus, const dbus::ObjectPath& object_path, Delegate* delegate, const std::string& uuid, const std::vector& permissions, const dbus::ObjectPath& characteristic_path) { if (!bluez::BluezDBusManager::Get()->IsUsingStub()) { return new BluetoothGattDescriptorServiceProviderImpl( bus, object_path, delegate, uuid, permissions, characteristic_path); } return new FakeBluetoothGattDescriptorServiceProvider( object_path, delegate, uuid, permissions, characteristic_path); } } // namespace bluez