| OLD | NEW |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef DEVICE_USB_USB_DEVICE_HANDLE_H_ | 5 #ifndef DEVICE_USB_USB_DEVICE_HANDLE_H_ |
| 6 #define DEVICE_USB_USB_DEVICE_HANDLE_H_ | 6 #define DEVICE_USB_USB_DEVICE_HANDLE_H_ |
| 7 | 7 |
| 8 #include <map> | 8 #include <map> |
| 9 #include <vector> | 9 #include <vector> |
| 10 | 10 |
| (...skipping 12 matching lines...) Expand all Loading... |
| 23 USB_TRANSFER_COMPLETED = 0, | 23 USB_TRANSFER_COMPLETED = 0, |
| 24 USB_TRANSFER_ERROR, | 24 USB_TRANSFER_ERROR, |
| 25 USB_TRANSFER_TIMEOUT, | 25 USB_TRANSFER_TIMEOUT, |
| 26 USB_TRANSFER_CANCELLED, | 26 USB_TRANSFER_CANCELLED, |
| 27 USB_TRANSFER_STALLED, | 27 USB_TRANSFER_STALLED, |
| 28 USB_TRANSFER_DISCONNECT, | 28 USB_TRANSFER_DISCONNECT, |
| 29 USB_TRANSFER_OVERFLOW, | 29 USB_TRANSFER_OVERFLOW, |
| 30 USB_TRANSFER_LENGTH_SHORT, | 30 USB_TRANSFER_LENGTH_SHORT, |
| 31 }; | 31 }; |
| 32 | 32 |
| 33 typedef base::Callback< | |
| 34 void(UsbTransferStatus, scoped_refptr<net::IOBuffer>, size_t)> | |
| 35 UsbTransferCallback; | |
| 36 | |
| 37 // UsbDeviceHandle class provides basic I/O related functionalities. | 33 // UsbDeviceHandle class provides basic I/O related functionalities. |
| 38 class UsbDeviceHandle : public base::RefCountedThreadSafe<UsbDeviceHandle> { | 34 class UsbDeviceHandle : public base::RefCountedThreadSafe<UsbDeviceHandle> { |
| 39 public: | 35 public: |
| 36 using ResultCallback = base::Callback<void(bool)>; |
| 37 using TransferCallback = base::Callback< |
| 38 void(UsbTransferStatus, scoped_refptr<net::IOBuffer>, size_t)>; |
| 39 |
| 40 enum TransferRequestType { STANDARD, CLASS, VENDOR, RESERVED }; | 40 enum TransferRequestType { STANDARD, CLASS, VENDOR, RESERVED }; |
| 41 enum TransferRecipient { DEVICE, INTERFACE, ENDPOINT, OTHER }; | 41 enum TransferRecipient { DEVICE, INTERFACE, ENDPOINT, OTHER }; |
| 42 | 42 |
| 43 virtual scoped_refptr<UsbDevice> GetDevice() const = 0; | 43 virtual scoped_refptr<UsbDevice> GetDevice() const = 0; |
| 44 | 44 |
| 45 // Notifies UsbDevice to drop the reference of this object; cancels all the | 45 // Notifies UsbDevice to drop the reference of this object; cancels all the |
| 46 // flying transfers. | 46 // flying transfers. |
| 47 // It is possible that the object has no other reference after this call. So | 47 // It is possible that the object has no other reference after this call. So |
| 48 // if it is called using a raw pointer, it could be invalidated. | 48 // if it is called using a raw pointer, it could be invalidated. |
| 49 // The platform device handle will be closed when UsbDeviceHandle destructs. | 49 // The platform device handle will be closed when UsbDeviceHandle destructs. |
| 50 virtual void Close() = 0; | 50 virtual void Close() = 0; |
| 51 | 51 |
| 52 // Device manipulation operations. These methods are blocking and must be | 52 // Device manipulation operations. |
| 53 // called on FILE thread. | 53 virtual void SetConfiguration(int configuration_value, |
| 54 virtual bool SetConfiguration(int configuration_value) = 0; | 54 const ResultCallback& callback) = 0; |
| 55 virtual bool ClaimInterface(int interface_number) = 0; | 55 virtual void ClaimInterface(int interface_number, |
| 56 const ResultCallback& callback) = 0; |
| 56 virtual bool ReleaseInterface(int interface_number) = 0; | 57 virtual bool ReleaseInterface(int interface_number) = 0; |
| 57 virtual bool SetInterfaceAlternateSetting(int interface_number, | 58 virtual void SetInterfaceAlternateSetting(int interface_number, |
| 58 int alternate_setting) = 0; | 59 int alternate_setting, |
| 59 virtual bool ResetDevice() = 0; | 60 const ResultCallback& callback) = 0; |
| 61 virtual void ResetDevice(const ResultCallback& callback) = 0; |
| 60 | 62 |
| 61 // Gets the string descriptor with the given index from the device, or returns | |
| 62 // false. This method is blocking and must be called on the FILE thread. | |
| 63 virtual bool GetStringDescriptor(uint8 string_id, base::string16* string) = 0; | |
| 64 | |
| 65 // Async IO. Can be called on any thread. | |
| 66 virtual void ControlTransfer(UsbEndpointDirection direction, | 63 virtual void ControlTransfer(UsbEndpointDirection direction, |
| 67 TransferRequestType request_type, | 64 TransferRequestType request_type, |
| 68 TransferRecipient recipient, | 65 TransferRecipient recipient, |
| 69 uint8 request, | 66 uint8 request, |
| 70 uint16 value, | 67 uint16 value, |
| 71 uint16 index, | 68 uint16 index, |
| 72 net::IOBuffer* buffer, | 69 net::IOBuffer* buffer, |
| 73 size_t length, | 70 size_t length, |
| 74 unsigned int timeout, | 71 unsigned int timeout, |
| 75 const UsbTransferCallback& callback) = 0; | 72 const TransferCallback& callback) = 0; |
| 76 | 73 |
| 77 virtual void BulkTransfer(UsbEndpointDirection direction, | 74 virtual void BulkTransfer(UsbEndpointDirection direction, |
| 78 uint8 endpoint, | 75 uint8 endpoint, |
| 79 net::IOBuffer* buffer, | 76 net::IOBuffer* buffer, |
| 80 size_t length, | 77 size_t length, |
| 81 unsigned int timeout, | 78 unsigned int timeout, |
| 82 const UsbTransferCallback& callback) = 0; | 79 const TransferCallback& callback) = 0; |
| 83 | 80 |
| 84 virtual void InterruptTransfer(UsbEndpointDirection direction, | 81 virtual void InterruptTransfer(UsbEndpointDirection direction, |
| 85 uint8 endpoint, | 82 uint8 endpoint, |
| 86 net::IOBuffer* buffer, | 83 net::IOBuffer* buffer, |
| 87 size_t length, | 84 size_t length, |
| 88 unsigned int timeout, | 85 unsigned int timeout, |
| 89 const UsbTransferCallback& callback) = 0; | 86 const TransferCallback& callback) = 0; |
| 90 | 87 |
| 91 virtual void IsochronousTransfer(UsbEndpointDirection direction, | 88 virtual void IsochronousTransfer(UsbEndpointDirection direction, |
| 92 uint8 endpoint, | 89 uint8 endpoint, |
| 93 net::IOBuffer* buffer, | 90 net::IOBuffer* buffer, |
| 94 size_t length, | 91 size_t length, |
| 95 unsigned int packets, | 92 unsigned int packets, |
| 96 unsigned int packet_length, | 93 unsigned int packet_length, |
| 97 unsigned int timeout, | 94 unsigned int timeout, |
| 98 const UsbTransferCallback& callback) = 0; | 95 const TransferCallback& callback) = 0; |
| 99 | 96 |
| 100 protected: | 97 protected: |
| 101 friend class base::RefCountedThreadSafe<UsbDeviceHandle>; | 98 friend class base::RefCountedThreadSafe<UsbDeviceHandle>; |
| 102 | 99 |
| 103 UsbDeviceHandle() {}; | 100 UsbDeviceHandle() {}; |
| 104 | 101 |
| 105 virtual ~UsbDeviceHandle() {}; | 102 virtual ~UsbDeviceHandle() {}; |
| 106 | 103 |
| 107 DISALLOW_COPY_AND_ASSIGN(UsbDeviceHandle); | 104 DISALLOW_COPY_AND_ASSIGN(UsbDeviceHandle); |
| 108 }; | 105 }; |
| 109 | 106 |
| 110 } // namespace device | 107 } // namespace device |
| 111 | 108 |
| 112 #endif // DEVICE_USB_USB_DEVICE_HANDLE_H_ | 109 #endif // DEVICE_USB_USB_DEVICE_HANDLE_H_ |
| OLD | NEW |