device/devices_app/usb/public/interfaces/device_manager.mojom

   1 // Copyright 2015 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 module device.usb;
   6
   7 import "device.mojom";
   8
   9 enum OpenDeviceError {
  10   // Opening the device succeeded.
  11   OK,
  12
  13   // The device could not be opened because the request GUID is unknown.
  14   NOT_FOUND,
  15
  16   // The operating system denied access to the device.
  17   ACCESS_DENIED,
  18 };
  19
  20 struct DeviceFilter {
  21   bool has_vendor_id;
  22   uint16 vendor_id;
  23
  24   bool has_product_id;
  25   uint16 product_id;
  26
  27   bool has_class_code;
  28   uint8 class_code;
  29
  30   bool has_subclass_code;
  31   uint8 subclass_code;
  32
  33   bool has_protocol_code;
  34   uint8 protocol_code;
  35 };
  36
  37 struct EnumerationOptions {
  38   array<DeviceFilter> filters;
  39 };
  40
  41 struct DeviceChangeNotification {
  42   array<DeviceInfo> devices_added;
  43   array<string> devices_removed;
  44 };
  45
  46 interface DeviceManager {
  47   // Retrieves information about all devices available to the DeviceManager
  48   // implementation.
  49   GetDevices(EnumerationOptions options) => (array<DeviceInfo> results);
  50
  51   // Retrieves information about changes to the set of devices available to the
  52   // DeviceManager since the last call to this method. The first call will
  53   // return the set of all devices available. Device added and removed between
  54   // calls will not be included.
  55   GetDeviceChanges() => (DeviceChangeNotification changes);
  56
  57   // Attempts to open a device given its GUID.
  58   OpenDevice(string guid, Device& device_request) => (OpenDeviceError error);
  59 };