17/21

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

5 EXAMPLE VENDOR UPGRADE SOFTWARE (DFU DEMONSTRATOR)

This section describes the DFU demonstrator software, as previously mentioned, this applica-

tion is divided into two distinct modules: a protocol dynamic link library and a graphical user in-

terface.

5.1 ST7DFUPRT PROGRAMMING INTERFACE

5.1.1 Overview

This DLL is in charge of the protocol layer management between the firmware image (stored

on local disk) and data sent/received to/from the ST7 USB device through the ST7DFU.dll ge-

neric module by means of DFU requests to the Control Pipe (Endpoint0).

The main features of this DLL are the following :

– Reading & decoding the new firmware image (processing the suffix and useful binary data ).

– Writing & coding the old firmware image.

– Performing the firmware upgrade operations by responding to all DFU interface states and

the transitions between them.

– Sending to upper layers status, errors, warning messages and progress.

The firmware image will encapsulate the following information : target Addresses, data record

sizes, useful data and a suffix.

The purpose of the DFU suffix is to allow the host software to detect and prevent attempts to

download incompatible firmware.

For more details about the DFU File suffix and how to compute the CRC please refer to Device

Class Specification for DFU Version 1.0 , Appendix B.

Note: Due to the fact that all functions exported by this DLL take a longer time than other mod-

ules, its structure will be based on (mainly asynchronous) processes and threaded code.

5.1.2 Programming Interface

This is the application programming interface of the STDFUPRT.dll module. The documenta-

tion describes the interface in C language .

5.1.2.1 ST_ImageFromDFUFile

Prototype

DWORD WINAPI ST_ImageFromDFUFile(

CHAR * pPathFile,

UCHAR * pBuffer,

UINT * pVid,

UINT * pPid,

UINT * pBcd );

Description