Click here to Skip to main content
11,932,103 members (48,441 online)
Click here to Skip to main content
Add your own
alternative version


17 bookmarked

ST Micro-electronics Device Firmware Upgrade (DFU/DfuSe) from C#

, 12 Mar 2013 CPOL
Rate this:
Please Sign up or sign in to vote.
ST provide a DFU module for their STM32 micro-controllers for firmware upgrade over USB. This is an example of how to use it from C#.


ST Micro-electronics STM32F series micro-controllers have the possibility to be programmed via USB using ST's DFU protocol. Some of their micros have the DFU module in ROM and all can have it in FLASH. DFU is a very handy way to program a micro-controller, particularly when it is in the micro's ROM, but all the example code from ST is in C++ and is somewhat complicated and buggy. ST's version of DFU is called DfuSe (Device firmware upgrade STMicroelectronics Extension).

Using this code, I have been able to implement a scheme whereby the C# application which is communicating with the ST micro-controller based hardware, is able to automatically update the hardware's firmware. So when the C# application is updated, the firmware gets updated too.


ST provides a C++ demo application, which includes the Windows drivers for the DFU device and two DLLs which this application requires (STDFU.dll, STTubeDevice30.dll). I'm not sure of the redistribution terms of the DLLs so you should download them directly from ST by downloading and installing ST's demo package (see below). Then copy the two DLLs into the main solution directory, from where they will be copied into the appropriate bin directory when the solution is built.

ST provides a STDFU library specification (UM0384) and file format document (UM0391) as part of the demo package.

Some of the USB communications has been borrowed from an excellent article on USB HID programming that I found here.

ST's application uses another two DLLs, STDFUFiles.dll and STDFUPRT.dll. These perform higher level functions which are either not performed by my example, or done by the C#. I just wanted to write as much of the code in C# as possible, and minimise time spent trying to decode DLL function calls. I also haven't bothered to implement any more functionality than the bare minimum I needed, but I hope this will provide a starting point for people wanting to do more.

DFU files can be generated from HEX or S19 files by an application which is included in ST's demo package. So you can take the HEX file output from your compiler (e.g., Keil's MDK-ARM) and convert it into a DFU file which can then be programmed into a micro-controller using this application. Normally, this is something you would do with released code, rather than during software development. Using the DFU avoids the need for the production department or service engineer to have a JTAG programmer, and the need to directly access the target hardware as long as the USB port is accessible.

Using the Code

The supplied code is a demo application plus my FirmwareUpdate class which does the hard work of communicating with the hardware. My intention is more that it provides an example of how to implement DFU programming in your own test harness than that it be used standalone. I don't claim to be an expert in USB or P/Invoke, what I am presenting has been patched together by running the C++ demo under a debugger and experimentation.

IFirmwareUpdate is of course an interface class to the FirmwareUpdate class. To do a firmware update, first hook the OnFirmwareUpdateProgress event to an event handler, then call UpdateFirmware with the path of the DFU file. You make like to use ParseDFU_File beforehand to obtain the intended VID and PID of the DFU file so you can check that they are correct for the target hardware.

This code has been tested against a STM32F207's ROM bootloader, a STM32F103 running a FLASH DFU module (as copied from ST's example) in the bottom $3000 bytes to load an application into the FLASH from $08003000 onwards, and another STM32F103 running a slightly different version of ST's DFU example. I have built the project both "x86" and "x64". You will need to install the correct version of the DFU driver, as supplied in the form of an installer EXE file in ST's demo package.

You may notice a function called FindAndDetachHID. This is for use with a HID device (Human Interface Device, such as keyboard or joystick, but also one of the easiest USB classes to use for any kind of low data rate I/O device) which supports the "HID detach" feature. This is basically a special message telling the device to stop being whatever it is, disconnect from the computer, and then re-connect as a DFU device. ST's demo app supports this feature.


  • 19/2/2013: First posted.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Mark McLean (ExpElec)
Engineer Expedition Electrics
United Kingdom United Kingdom
Started programming aged 10 on a ZX81 ("Daddy - what's a program?"), since then have done electronics and software for variety of things, mostly instrumentation, in a variety of languages but these days mostly C for the firmware and C# for the PC. Perhaps the project I'm proudest of was the Z80 based computer entirely hand soldered on veroboard!

You may also be interested in...

Comments and Discussions

QuestionThank You Pin
Denziljr5-Nov-15 23:02
memberDenziljr5-Nov-15 23:02 
SuggestionRead Protection Bit Pin
stukdev2-Nov-15 22:50
memberstukdev2-Nov-15 22:50 
QuestionNeeded C# application for .hex file conversion into DFU(.dfu) file. Pin
Vinod KUmar S N5-Dec-14 0:20
memberVinod KUmar S N5-Dec-14 0:20 
AnswerRe: Needed C# application for .hex file conversion into DFU(.dfu) file. Pin
vivchun8-Apr-15 14:49
membervivchun8-Apr-15 14:49 
Questionwhat IDE to use Pin
Member 112871774-Dec-14 16:21
memberMember 112871774-Dec-14 16:21 
AnswerRe: what IDE to use Pin
Garth J Lancaster4-Dec-14 17:36
memberGarth J Lancaster4-Dec-14 17:36 
GeneralRe: what IDE to use Pin
Member 112871774-Dec-14 18:56
memberMember 112871774-Dec-14 18:56 
News*.hex to *.dfu Pin
ZsirosD22-Jun-13 9:38
memberZsirosD22-Jun-13 9:38 
GeneralMy vote of 5 Pin
jeffataylor6-Mar-13 7:53
memberjeffataylor6-Mar-13 7:53 
Bug_ParentHandle Null pointer. Pin
jeffataylor6-Mar-13 7:45
memberjeffataylor6-Mar-13 7:45 
GeneralRe: _ParentHandle Null pointer. Pin
Mark McLean (ExpElec)7-Mar-13 9:51
memberMark McLean (ExpElec)7-Mar-13 9:51 
QuestionThank you! Pin
jeffataylor5-Mar-13 14:17
memberjeffataylor5-Mar-13 14:17 
GeneralMy vote of 5 Pin
hanzibal24-Mar-13 8:06
memberhanzibal24-Mar-13 8:06 
QuestionHow to download? Pin
jeffataylor1-Mar-13 8:15
memberjeffataylor1-Mar-13 8:15 
AnswerRe: How to download? Pin
klightspeed2-Mar-13 5:30
memberklightspeed2-Mar-13 5:30 
GeneralRe: How to download? Pin
hanzibal23-Mar-13 23:02
memberhanzibal23-Mar-13 23:02 
GeneralRe: How to download? Pin
Mark McLean (ExpElec)5-Mar-13 2:23
memberMark McLean (ExpElec)5-Mar-13 2:23 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.151126.1 | Last Updated 12 Mar 2013
Article Copyright 2013 by Mark McLean (ExpElec)
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid