Add support for sending a USB SET_CONFIGURATION request.

extensions/common/api/usb.idl

 // 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.
 
 // Use the <code>chrome.usb</code> API to interact with connected USB
 // devices. This API provides access to USB operations from within the context
 // of an app. Using this API, apps can function as drivers for hardware devices.
 //
 // Errors generated by this API are reported by setting
 // $(ref:runtime.lastError) and executing the function's regular callback. The
@@ skipping 192 matching lines @@
     // Filter the list of devices presented to the user. If multiple filters are
     // provided devices matching any filter will be displayed.
     DeviceFilter[]? filters;
   };
 
   callback VoidCallback = void ();
   callback GetDevicesCallback = void (Device[] devices);
   callback RequestAccessCallback = void (boolean success);
   callback OpenDeviceCallback = void (ConnectionHandle handle);
   callback FindDevicesCallback = void (ConnectionHandle[] handles);
+  callback SetConfigurationCallback = void (boolean success);
   callback GetConfigurationCallback = void (ConfigDescriptor config);
   callback ListInterfacesCallback = void (InterfaceDescriptor[] descriptors);
   callback CloseDeviceCallback = void ();
   callback TransferCallback = void (TransferResultInfo info);
   callback ResetDeviceCallback = void(boolean success);
 
   interface Functions {
     // Enumerates connected USB devices.
     // |options|: The properties to search for on target devices.
     static void getDevices(EnumerateDevicesOptions options,
@@ skipping 38 matching lines @@
     // |options|: The properties to search for on target devices.
     static void findDevices(EnumerateDevicesAndRequestAccessOptions options,
                             FindDevicesCallback callback);
 
     // Closes a connection handle. Invoking operations on a handle after it
     // has been closed is a safe operation but causes no action to be taken.
     // |handle|: The $(ref:ConnectionHandle) to close.
     static void closeDevice(ConnectionHandle handle,
                             optional CloseDeviceCallback callback);
 
+    // Select a device configuration.
+    //
+    // This function effectively resets the device by selecting one of the
+    // device's available configurations. Only configuration values greater
+    // than <code>0</code> are valid however some buggy devices have a working
+    // configuration <code>0</code> and so this value is allowed.
+    // |handle|: An open connection to the device.
+    static void setConfiguration(ConnectionHandle handle,
+                                 long configurationValue,
+                                 SetConfigurationCallback callback);
+
     // Gets the configuration descriptor for the currently selected
     // configuration.
     // |handle|: An open connection to the device.
     static void getConfiguration(ConnectionHandle handle,
                                  GetConfigurationCallback callback);
 
     // Lists all interfaces on a USB device.
     // |handle|: An open connection to the device.
     static void listInterfaces(ConnectionHandle handle,
                                ListInterfacesCallback callback);
@@ skipping 76 matching lines @@
     // device. Permission may have been granted at install time, when the user
     // accepted an optional permission (see $(ref:permissions.request)), or
     // through $(ref:getUserSelectedDevices).
     static void onDeviceAdded(Device device);
 
     // Event generated when a device is removed from the system. See
     // $(ref:onDeviceAdded) for which events are delivered.
     static void onDeviceRemoved(Device device);
   };
 };