sbIDeviceFirmwareUpdater.idl

Go to the documentation of this file.

/*
//
// BEGIN SONGBIRD GPL
// 
// This file is part of the Songbird web player.
//
// Copyright(c) 2005-2009 POTI, Inc.
// http://songbirdnest.com
// 
// This file may be licensed under the terms of of the
// GNU General Public License Version 2 (the "GPL").
// 
// Software distributed under the License is distributed 
// on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either 
// express or implied. See the GPL for the specific language 
// governing rights and limitations.
//
// You should have received a copy of the GPL along with this 
// program. If not, go to http://www.gnu.org/licenses/gpl.html
// or write to the Free Software Foundation, Inc., 
// 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
// 
// END SONGBIRD GPL
//
*/

#include "nsISupports.idl"

interface sbIDevice;
interface sbIDeviceEventListener;
interface sbIDeviceFirmwareHandler;
interface sbIDeviceFirmwareUpdate;

[scriptable, uuid(f6ad23c7-bd65-4fee-8536-0b47b493109e)]
interface sbIDeviceFirmwareUpdater : nsISupports
{
  void checkForUpdate(in sbIDevice aDevice, 
                      in unsigned long aDeviceVendorID,
                      in unsigned long aDeviceProductID,
                      in sbIDeviceEventListener aListener);

  void downloadUpdate(in sbIDevice aDevice, 
                      in boolean aVerifyFirmwareUpdate,
                      in sbIDeviceEventListener aListener);

  void verifyUpdate(in sbIDevice aDevice,
                    in sbIDeviceFirmwareUpdate aFirmwareUpdate,
                    in sbIDeviceEventListener aListener);

  void applyUpdate(in sbIDevice aDevice,
                   in sbIDeviceFirmwareUpdate aFirmwareUpdate,
                   in sbIDeviceEventListener aListener);

  void recoveryUpdate(in sbIDevice aDevice,
                      in sbIDeviceFirmwareUpdate aFirmwareUpdate,
                      in unsigned long aDeviceVendorID,
                      in unsigned long aDeviceProductID,
                      in sbIDeviceEventListener aListener);

  boolean continueUpdate(in sbIDevice aDevice, 
                         in sbIDeviceEventListener aListener);

  void finalizeUpdate(in sbIDevice aDevice);

  void verifyDevice(in sbIDevice aDevice,
                    in sbIDeviceEventListener aListener);
  
  void registerHandler(in sbIDeviceFirmwareHandler aFirmwareHandler);

  void unregisterHandler(in sbIDeviceFirmwareHandler aFirmwareHandler);

  boolean hasHandler(in sbIDevice aDevice, 
                     in unsigned long aDeviceVendorID,
                     in unsigned long aDeviceProductID);

  sbIDeviceFirmwareHandler getHandler(in sbIDevice aDevice, 
                                      in unsigned long aDeviceVendorID,
                                      in unsigned long aDeviceProductID);

  sbIDeviceFirmwareHandler getActiveHandler(in sbIDevice aDevice);

  void cancel(in sbIDevice aDevice);

  void requireRecovery(in sbIDevice aDevice);
};