WebUSB Device Firmware Upgrade example
Switch branches/tags
Nothing to show
Clone or download
devanlai dfu.js: tolerate bitManifestation mismatches
Some devices set bmBitManifestation even if they transition to
dfuMANIFEST_WAIT_RESET instead of returning to dfuIDLE.
Just tolerate their not-actually-manifestation-tolerant behavior.
Latest commit faaafaf Jun 10, 2018

README.md

webdfu

This is a proof-of-concept demo of host USB DFU drivers in Javascript utilizing the WebUSB draft standard to implement USB firmware updates from the browser.

Demos

dfu-util

A demo re-implementing dfu-util functionality in the browser:

https://devanlai.github.io/webdfu/dfu-util/

mbed-download

A demo using WebUSB and the mbed remote compilation API to build and flash boards in one step:

https://devanlai.github.io/webdfu/mbed-download/

Host-side implementation

WebUSB is currently only supported by Chromium / Google Chrome.

For Chrome to communicate with a USB device, it must have permission to access the device and the operating system must be able to load a generic driver that libusb can talk to.

On Linux, that means that the current user must have permission to access the device.

On Windows, that means that an appropriate WinUSB/libusb driver must first be installed. This can be done manually with programs such as Zadig or automatically (sometimes...) with WCID

The javascript DFU driver is ported from the excellent open-source software, dfu-util.

Device-side implementation

The current WebUSB draft no longer requires the device to support additional WebUSB descriptors. However, implementing WebUSB descriptors allows the device to specify a landing page URL for the browser to present to the user when the device is plugged in.

For an example WebUSB-enabled USB DFU bootloader for the STM32F103 series, check out the dapboot project

For mbed DAPLink firmware with WebUSB + DFU added, see this fork:

https://github.com/devanlai/DAPLink/tree/nucleo_webusb

Implemented features

  • Reading the current device firmware (DFU upload)
  • Writing new firmware to a device (DFU download)
  • Switching from the runtime configuration to the DFU bootloader (DFU detach)
  • ST DfuSe download
  • ST DfuSe upload

Planned future features:

  • DfuSe file format support
  • DFU file suffix support
  • Better support for remembering previous DFU configurations and pairing the bootloader/runtime versions of the same device.

Local testing

To test changes locally, you can run a simple HTTPS server. A pre-generated certificate is included for convenience.

python SimpleSecureHTTPServer.py --cert server.pem --port 8000

Note: Don't re-use this certificate outside of your development environment!

For additional tips and information about WebUSB, see this article:

https://developers.google.com/web/updates/2016/03/access-usb-devices-on-the-web#tips