Add serial bulk reads.

chrome/common/extensions/api/experimental_serial.idl

 // Copyright (c) 2012 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.
 
 // File-level comment to appease parser. Eventually this will not be necessary.
 
 namespace experimental.serial {
 
   callback GetPortsCallback = void (DOMString[] ports);
 
@@ skipping 12 matching lines @@
     long connectionId;
   };
 
   callback OpenCallback = void (OpenInfo openInfo);
 
   // Returns true if operation was successful.
   callback CloseCallback = void (boolean result);
 
   dictionary ReadInfo {
     // The number of bytes received, or a negative number if an error occurred.
+    // This number will be smaller than the number of bytes requested in the
+    // original read call if the call would need to block to read that number
+    // of bytes.
     long bytesRead;
 
     // The data received.
     ArrayBuffer data;
   };
 
   callback ReadCallback = void (ReadInfo readInfo);
 
   dictionary WriteInfo {
     // The number of bytes written.
@@ skipping 50 matching lines @@
                      OpenCallback callback);
 
     // Closes an open connection.
     // |connectionId| : The id of the opened connection.
     // |callback| : Called when the connection has been closed.
     static void close(long connectionId,
                       CloseCallback callback);
 
     // Reads a byte from the given connection.
     // |connectionId| : The id of the connection.
-    // |callback| : Called when the byte has been read or the read blocked.
+    // |bytesToRead| : The number of bytes to read.
+    // |callback| : Called when all the requested bytes have been read or
+    //              when the read blocks.
     static void read(long connectionId,
+                     long bytesToRead,
                      ReadCallback callback);
 
     // Writes a string to the given connection.
     // |connectionId| : The id of the connection.
     // |data| : The string to write.
     // |callback| : Called when the string has been written.
     static void write(long connectionId,
                       ArrayBuffer data,
                       WriteCallback callback);
 
     // Flushes all bytes in the given connection's input and output buffers.
     // |connectionId| : The id of the connection.
     // |callback| : Called when the flush is complete.
     static void flush(long connectionId,
                       FlushCallback callback);
 
     static void getControlSignals(long connectionId,
                                   GetControlSignalsCallback callback);
 
     static void setControlSignals(long connectionId,
                                   ControlSignalOptions options,
                                   SetControlSignalsCallback callback);
   };
 
 };