bluetooth: Add control for reading/writing of characteristics to internals page.

device/bluetooth/public/interfaces/device.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 bluetooth.mojom;
 
 import "device/bluetooth/public/interfaces/uuid.mojom";
 
 // Values representing the possible properties of a characteristic, which
 // define how the characteristic can be used. Each of these properties serve
 // a role as defined in the Bluetooth Specification.
 // |EXTENDED_PROPERTIES| is a special property that, if present,
 // indicates that there is a characteristic descriptor (namely the
 // "Characteristic Extended Properties Descriptor" with UUID 0x2900) that
 // contains additional properties pertaining to the characteristic.
 // The properties |RELIABLE_WRITE| and |WRITABLE_AUXILIARIES| are retrieved from
 // that characteristic.
+// TODO(crbug.com/684168): Remove assignment of values when this is automated.
 enum Property {
   NONE = 0,
   BROADCAST = 1,
   READ = 2,
   WRITE_WITHOUT_RESPONSE = 4,
   WRITE = 8,
   NOTIFY = 16,
   INDICATE = 32,
   AUTHENTICATED_SIGNED_WRITES = 64,
   EXTENDED_PROPERTIES = 128,
   RELIABLE_WRITE = 256,
   WRITABLE_AUXILIARIES = 512,
   READ_ENCRYPTED = 1024,
   WRITE_ENCRYPTED = 2048,
   READ_ENCRYPTED_AUTHENTICATED = 4096,
   WRITE_ENCRYPTED_AUTHENTICATED = 8192
 };
 
+// Values representing read, write, and encryption permissions for a
+// characteristic's value. While attribute permissions for all GATT
+// definitions have been set by the Bluetooth specification, characteristic
+// value permissions are left up to the higher-level profile.
+//
+// Attribute permissions are distinct from the characteristic properties. For
+// example, a characteristic may have the property |PROPERTY_READ| to make
+// clients know that it is possible to read the characteristic value and have
+// the permission |PERMISSION_READ_ENCRYPTED| to require a secure connection.
+// It is up to the application to properly specify the permissions and
+// properties for a local characteristic.
+// TODO(rkc): Currently BlueZ infers permissions for characteristics from
+// the properties. Once this is fixed, we will start sending the permissions
+// for characteristics to BlueZ. Till then permissions for characteristics
+// are unimplemented.
+// TODO(crbug.com/684168): Remove assignment of values when this is automated.
+enum Permission {
+  NONE = 0,
+  READ = 1,
+  WRITE = 2,
+  READ_ENCRYPTED = 4,
+  WRITE_ENCRYPTED = 8,
+  READ_ENCRYPTED_AUTHENTICATED = 16,
+  WRITE_ENCRYPTED_AUTHENTICATED = 32
+};
+
+enum GattResult {
+  SUCCESS,
+  UNKNOWN,
+  FAILED,
+  IN_PROGRESS,
+  INVALID_LENGTH,
+  NOT_PERMITTED,
+  NOT_AUTHORIZED,
+  NOT_PAIRED,
+  NOT_SUPPORTED,
+  SERVICE_NOT_FOUND,
+  CHARACTERISTIC_NOT_FOUND
+};
+
 // TODO(crbug.com/657632): Remove when numerical values can be optional.
 struct RSSIWrapper {
   int8 value;
 };
 
 struct DeviceInfo {
   string? name;
   string name_for_display;
   string address;
   bool is_gatt_connected;
   RSSIWrapper? rssi;
 };
 
 struct ServiceInfo {
   string id;
   UUID uuid;
   bool is_primary;
 };
 
 struct CharacteristicInfo {
   string id;
   UUID uuid;
   uint32 properties;
+  uint32 permissions;
+  array<uint8> last_known_value;
 };
 
 interface Device {
   // Disconnects and deletes the Device.
   Disconnect();
 
   // Gets basic information about the device. Returns null, if no device is
   // available.
   GetInfo() => (DeviceInfo? info);
 
   // Gets the GATT Services in this device's GATT Server.
   GetServices() => (array<ServiceInfo> services);
 
   // Gets the GATT Characteristics in the GATT Service with |service_id|.
   GetCharacteristics(string service_id) =>
       (array<CharacteristicInfo> characteristics);
+
+  // Reads the value for the GATT Characteristic with |characteristic_id| in
+  // the GATT Service with |service_id|.
+  ReadValueForCharacteristic(string service_id, string characteristic_id) =>
+      (GattResult result, array<uint8>? value);
+
+  // Writes the |value| to the GATT Characteristic with |characteristic_id| in
+  // the GATT Service with |service_id|.
+  WriteValueForCharacteristic(string service_id, string characteristic_id,
+      array<uint8> value) => (GattResult result);
 };