arc: bluetooth: Add gatt client functionality

components/arc/common/bluetooth.mojom

 // Copyright 2016 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.
 
 module arc.mojom;
 
 [Extensible]
 enum BluetoothAdapterState {
   OFF = 0,
   ON
@@ skipping 110 matching lines @@
   BluetoothServiceRecord service_record;
   BluetoothScanMode adapter_scan_mode;
   array<BluetoothAddress> bonded_devices;
   uint32 discovery_timeout;
   string remote_friendly_name;
   int32 remote_rssi;
   BluetoothRemoteVersion remote_version;
   BluetoothLocalLEFeatures local_le_features;
 };
 
+// Bluetooth GATT types
+[Extensible]
+enum BluetoothGattStatus {

[rkc, 2016/06/07 02:34:31]

Document where the values that we're assigning to these enums are coming from.

[puthik_chromium, 2016/06/08 23:59:51]

Done.

+  GATT_SUCCESS = 0,
+  GATT_READ_NOT_PERMITTED = 0x2,
+  GATT_WRITE_NOT_PERMITTED = 0x3,
+  GATT_INSUFFICIENT_AUTHENTICATION = 0x5,
+  GATT_REQUEST_NOT_SUPPORTED = 0x6,
+  GATT_INVALID_OFFSET = 0x7,
+  GATT_INVALID_ATTRIBUTE_LENGTH = 0xd,
+  GATT_INSUFFICIENT_ENCRYPTION = 0xf,
+  GATT_CONNECTION_CONGESTED = 0x8f,
+  GATT_FAILURE = 0x101,
+};
+
+struct BluetoothGattID {
+  BluetoothUUID uuid;
+  uint8 inst_id;
+};
+
+struct BluetoothGattServiceID {
+  BluetoothGattID id;
+  uint8 is_primary;
+};
+
+struct BluetoothGattValue {
+  BluetoothGattStatus status;
+  uint32 len;
+  uint32 type;
+  array<uint8> value;
+};
+
+// Copy from Bluetooth Assigned Numbers Document, Generic Access Profile
+// https://www.bluetooth.com/specifications/assigned-numbers/generic-access-profile
+[Extensible]
+enum BluetoothAdvertisingDataType {
+  DATA_TYPE_FLAGS = 0x01,
+  DATA_TYPE_SERVICE_UUIDS_128_BIT_COMPLETE = 0x07,
+  DATA_TYPE_LOCAL_NAME_COMPLETE = 0x09,
+  DATA_TYPE_TX_POWER_LEVEL = 0x0A,
+  DATA_TYPE_SERVICE_DATA = 0x16,
+  DATA_TYPE_MANUFACTURER_SPECIFIC_DATA = 0xff,
+};
+
+// Copy from Bluetooth Core v4.2 Volume 3 Part C Chapter 11
+// and Bluetooth Core Specification Supplement v6 Part A Chapter 1
+// https://www.bluetooth.com/specifications/adopted-specifications
+union BluetoothAdvertisingData {
+  uint8 flags;
+  array<BluetoothUUID> service_uuids;
+  string local_name;
+  uint8 tx_power_level;
+  BluetoothServiceData service_data;
+  array<uint8> manufacture_data;
+  array<uint8> other_data;
+};
+
+struct BluetoothServiceData {
+  uint16 uuid_16bit;
+  array<uint8> data;
+};
+
+[Extensible]
+enum BluetoothGattDBAttributeType {
+  BTGATT_DB_PRIMARY_SERVICE = 0,
+  BTGATT_DB_SECONDARY_SERVICE,
+  BTGATT_DB_INCLUDED_SERVICE,
+  BTGATT_DB_CHARACTERISTIC,
+  BTGATT_DB_DESCRIPTOR,
+};
+
+struct BluetoothGattDBElement {
+    uint8 id;
+    BluetoothUUID uuid;
+    BluetoothGattDBAttributeType type;
+    uint16 attribute_handle;
+
+    /*
+     * If |type| is |BTGATT_DB_PRIMARY_SERVICE|, or
+     * |BTGATT_DB_SECONDARY_SERVICE|, this contains the start and end attribute
+     * handles.

[rkc, 2016/06/07 02:34:31]

Here you're saying that they contain the starting and ending attribute handles,
but later you're populating these with the first and last 'characteristic'
handles. If this were the first and last attribute handles, then the last handle
would be either a characteristic or descriptor handle.

Either fix the implementation to match the comment, or change the comment to
match the implementation. Whichever is the correct thing to do :)

[puthik_chromium, 2016/06/08 00:56:19]

The comment is correct because I copy from Android N.[1] So I changed the
implementation to match the comment. Note that Android didn't use these 2
variables anywhere.[2]

[1]
http://cs/android/hardware/libhardware/include/hardware/bt_common_types.h?l=60
[2]
http://cs/android/packages/apps/Bluetooth/src/com/android/bluetooth/gatt/Gatt...

+     */
+    uint16 start_handle;
+    uint16 end_handle;
+
+    /*
+     * If |type| is |BTGATT_DB_CHARACTERISTIC|, this contains the properties of
+     * the characteristic.
+     */
+    uint8 properties;
+};
+
 interface BluetoothHost {
   EnableAdapter() => (BluetoothAdapterState state);
   DisableAdapter() => (BluetoothAdapterState state);
   GetAdapterProperty(BluetoothPropertyType type);
   SetAdapterProperty(BluetoothProperty property);
   GetRemoteDeviceProperty(BluetoothAddress remote_addr,
                           BluetoothPropertyType type);
   SetRemoteDeviceProperty(BluetoothAddress remote_addr,
                           BluetoothProperty property);
   GetRemoteServiceRecord(BluetoothAddress remote_addr,
                          BluetoothUUID uuid);
   GetRemoteServices(BluetoothAddress remote_addr);
   StartDiscovery();
   CancelDiscovery();
   CreateBond(BluetoothAddress addr, int32 transport);
   RemoveBond(BluetoothAddress addr);
   CancelBond(BluetoothAddress addr);
 
   GetConnectionState(BluetoothAddress addr) => (bool connected);
+
+  // Bluetooth Gatt Client functions
+  [MinVersion=1] StartLEScan();
+  [MinVersion=1] StopLEScan();
+  [MinVersion=1] ConnectLEDevice(BluetoothAddress remote_addr);
+  [MinVersion=1] DisconnectLEDevice(BluetoothAddress remote_addr);
+  [MinVersion=1] SearchService(BluetoothAddress remote_addr);
+  [MinVersion=1] GetGattDB(BluetoothAddress remote_addr);
+  [MinVersion=1] StartLEListen() => (BluetoothGattStatus status);
+  [MinVersion=1] StopLEListen() => (BluetoothGattStatus status);
+  [MinVersion=1] ReadGattCharacteristic(BluetoothAddress remote_addr,
+                                        BluetoothGattServiceID service_id,
+                                        BluetoothGattID char_id)
+      => (BluetoothGattValue value);
+  [MinVersion=1] WriteGattCharacteristic(BluetoothAddress remote_addr,
+                                         BluetoothGattServiceID service_id,
+                                         BluetoothGattID char_id,
+                                         BluetoothGattValue value)
+      => (BluetoothGattStatus status);
+  [MinVersion=1] ReadGattDescriptor(BluetoothAddress remote_addr,
+                                    BluetoothGattServiceID service_id,
+                                    BluetoothGattID char_id,
+                                    BluetoothGattID desc_id)
+      => (BluetoothGattValue value);
+  [MinVersion=1] WriteGattDescriptor(BluetoothAddress remote_addr,
+                                     BluetoothGattServiceID service_id,
+                                     BluetoothGattID char_id,
+                                     BluetoothGattID desc_id,
+                                     BluetoothGattValue value)
+      => (BluetoothGattStatus status);
+  [MinVersion=1] RegisterForGattNotification(BluetoothAddress remote_addr,
+                                             BluetoothGattServiceID service_id,
+                                             BluetoothGattID char_id)
+      => (BluetoothGattStatus status);
+  [MinVersion=1] DeregisterForGattNotification(BluetoothAddress remote_addr,
+                                               BluetoothGattServiceID service_id,
+                                               BluetoothGattID char_id)
+      => (BluetoothGattStatus status);
+  [MinVersion=1] ReadRemoteRssi(BluetoothAddress remote_addr)
+      => (int32 rssi);
+
 };
 
 interface BluetoothInstance {
   Init(BluetoothHost host_ptr);
 
   OnAdapterProperties(BluetoothStatus status,
                       array<BluetoothProperty> properties);
   OnRemoteDeviceProperties(BluetoothStatus status,
                            BluetoothAddress address,
                            array<BluetoothProperty> properties);
   OnDeviceFound(array<BluetoothProperty> properties);
   OnDiscoveryStateChanged(BluetoothDiscoveryState state);
   OnBondStateChanged(BluetoothStatus status,
                      BluetoothAddress remote_addr,
                      BluetoothBondState state);
   OnAclStateChanged(BluetoothStatus status,
                     BluetoothAddress remote_addr,
                     BluetoothAclState state);
+
+  // Bluetooth Gatt Client callbacks
+  [MinVersion=1] OnLEDeviceFound(BluetoothAddress addr,
+                                 int32 rssi,
+                                 array<BluetoothAdvertisingData> adv_data);
+  [MinVersion=1] OnLEConnectionStateChange(BluetoothAddress remote_addr,
+                                           bool connected);
+  [MinVersion=1] OnSearchComplete(BluetoothAddress remote_addr,
+                                  BluetoothGattStatus status);
+  [MinVersion=1] OnGetGattDB(BluetoothAddress remote_addr,
+                             array<BluetoothGattDBElement> db);
+  [MinVersion=1] OnServicesRemoved(BluetoothAddress remote_addr,
+                                   uint16 start_handle,
+                                   uint16 end_handle);
+  [MinVersion=1] OnServicesAdded(BluetoothAddress remote_addr,
+                                 array<BluetoothGattDBElement> db);
 };