IDashDevice

Interface for controlling a device.

Note that this object initially represents a device factory. i.e. it is an object which has the ability to create instances of a real device object internally to GDA for the purpose of executing various commands.

Contents

Properties

Property Description
Name Gets the name of this device.
SerialNumber Gets the device serial number.
Description Gets the device description.
UsbVid Gets the device USB PID.
UsbPid Gets the device USB PID.

Public Methods

Function Description
DownloadSetup Start a setup download for this device.
UploadSetup Start a setup upload for this device (programs opened setup into the device).
UploadFirmware Start a firmware upload for this device.
EraseLog Start an Erase Log operation for this device.
UploadSetupUnattended Upload a setup without interactive prompts.

Properties

Name

Gets the name of this device.

BSTR Name

SerialNumber

Gets the device serial number.

BSTR SerialNumber

Description

Gets the device description.

BSTR Description

UsbVid

Gets the device USB PID.

int UsbVid

UsbPid

Gets the device USB PID.

int UsbPid

Public Methods

Method: DownloadSetup

Start a setup download for this device.

HRESULT DownloadSetup([in] BSTR filename, [in, optional] VARIANT options, [out, retval] IDashJob **retval)

Method: UploadSetup

Start a setup upload for this device (programs opened setup into the device).

HRESULT UploadSetup([in] BSTR filename, [in, optional] VARIANT options, [out, retval] IDashJob **retval)

Method: UploadFirmware

Start a firmware upload for this device.

HRESULT UploadFirmware([in] BSTR filename, [in, optional] VARIANT options, [out, retval] IDashJob **retval)

Method: EraseLog

Start an Erase Log operation for this device.

HRESULT EraseLog([in, optional] VARIANT options, [out, retval] IDashJob **retval)

Method: UploadSetupUnattended

Upload a setup without interactive prompts.

HRESULT UploadSetupUnattended([in] BSTR filename, [in, optional] VARIANT options, [out, retval] IDashJob **retval)

enableSetupDownload (default false).

checkFirmwareUpdate defaults to false. Setting it, acceptFirmwareUpdate, acceptEraseLog or rawSetup to true fails the job before device access. allowDisplayMismatch defaults to false; when true, a mismatch that the interactive uploader permits confirming is accepted with a warning.

Returns

S_OK when the job is created, E_INVALIDARG for an empty filename, E_POINTER for a null output, or a COM error if the setup cannot be opened. An unapproved display-type mismatch, nonempty log or excessive RAM requirement fails without a confirmation dialog.

A rejected job does not erase logs or program the device.

Keep the application and job references until completion or confirmed cancellation. Legacy versions do not expose this method; clients must check its DISPID before use.