15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef CHROME_BROWSER_USB_USB_SERVICE_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CHROME_BROWSER_USB_USB_SERVICE_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <map> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <utility> 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <vector> 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 13558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch#include "base/memory/singleton.h" 144311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch#include "chrome/browser/usb/usb_device.h" 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles)namespace base { 17a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) 18a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles)template <class T> class DeleteHelper; 19558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 20a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles)} // namespace base 21a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) 22a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles)template <typename T> struct DefaultSingletonTraits; 23a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles)class UsbContext; 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The USB service handles creating and managing an event handler thread that is 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// used to manage and dispatch USB events. It is also responsbile for device 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// discovery on the system, which allows it to re-use device handles to prevent 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// competition for the same USB device. 29558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdochclass UsbService { 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 314311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch typedef scoped_ptr<std::vector<scoped_refptr<UsbDevice> > > 32a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) ScopedDeviceVector; 334311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch 34a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) // Must be called on FILE thread. 35558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch static UsbService* GetInstance(); 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Find all of the devices attached to the system that are identified by 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |vendor_id| and |product_id|, inserting them into |devices|. Clears 392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // |devices| before use. Calls |callback| once |devices| is populated. 404311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch // The result will be sorted by id in increasing order. Must be called on 414311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch // FILE thread. 42a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) void FindDevices( 43a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const uint16 vendor_id, 44a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const uint16 product_id, 45a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) int interface_id, 46a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const base::Callback<void(ScopedDeviceVector vector)>& callback); 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 484311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch // Get all of the devices attached to the system, inserting them into 494311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch // |devices|. Clears |devices| before use. The result will be sorted by id 504311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch // in increasing order. Must be called on FILE thread. 514311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch void GetDevices(std::vector<scoped_refptr<UsbDevice> >* devices); 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 53a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) private: 54558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch friend struct DefaultSingletonTraits<UsbService>; 55a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) friend class base::DeleteHelper<UsbService>; 56558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 574311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch UsbService(); 584311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch virtual ~UsbService(); 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Return true if |device|'s vendor and product identifiers match |vendor_id| 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // and |product_id|. 624311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch static bool DeviceMatches(scoped_refptr<UsbDevice> device, 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const uint16 vendor_id, 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const uint16 product_id); 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 66a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) // This method is called when permission broker replied our request. 67a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) // We will simply relay it to FILE thread. 68a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) void OnRequestUsbAccessReplied( 69a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const uint16 vendor_id, 70a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const uint16 product_id, 71a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const base::Callback<void(ScopedDeviceVector vector)>& callback, 72a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) bool success); 73a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) 742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // FindDevicesImpl is called by FindDevices on ChromeOS after the permission 75a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) // broker has signaled that permission has been granted to access the 762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // underlying device nodes. On other platforms, it is called directly by 772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // FindDevices. 78a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) void FindDevicesImpl( 79a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const uint16 vendor_id, 80a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const uint16 product_id, 81a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const base::Callback<void(ScopedDeviceVector vector)>& callback, 82a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) bool success); 832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 844311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch // Enumerate USB devices from OS and Update devices_ map. 854311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch void RefreshDevices(); 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 87a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) scoped_refptr<UsbContext> context_; 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 894311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch // The map from PlatformUsbDevices to UsbDevices. 904311e82a78ceafbe0585f51d4c8a86df9f21aa0dBen Murdoch typedef std::map<PlatformUsbDevice, scoped_refptr<UsbDevice> > DeviceMap; 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DeviceMap devices_; 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(UsbService); 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // CHROME_BROWSER_USB_USB_SERVICE_H_ 97