14/21

USING THE ST7 USB DEVICE FIRMWARE UPGRADE DEVELOPMENT KIT (DFU-DK)

4.3.14.3 Parameters

phDevice: pointer to handle returned by the STDFU_Open function

Buffer: Buffer of Data

nBytes: Number of data bytes to be uploaded

nBlock: Number of data blocks to be uploaded

4.3.14.4 Returned value

STDFU_NOERROR in case of success, otherwise (Error Code).

4.3.15 STDFU_Getstatus

4.3.15.1 Prototype

typedef struct

{

UCHAR bStatus;

UCHAR bwPollTimeout[3];

UCHAR bState;

UCHAR iString;

}DFUSTATUS, *PDFUSTATUS;

DWORD STDFU_Getstatus (PHANDLE phDevice, DFUSTATUS *DfuStatus);

4.3.15.2 Description

Issues a GetStatus request to the Control Pipe (Endpoint0).

4.3.15.3 Parameters

phDevice: pointer to handle returned by the STDFU_Open function

DfuStatus: structure containing DFU Status structure

4.3.15.4 Returned value

STDFU_NOERROR in case of success, otherwise (Error Code).

4.3.15.5 Remarks

This function sends a getstatus request and it tests if the device is on a state equal to

STATE_DFU_MANIFEST_WAIT_RESET or STATE_DFU_MANIFEST then it closes the

driver and it waits for a reset from the device in order to return to application mode, if 15 sec-

onds elapse with no device change, it will return a STDFU_TIMEOUTWAITINGFORRESET

error.