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.
A demo re-implementing dfu-util functionality in the browser:
https://devanlai.github.io/webdfu/dfu-util/
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/
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.
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
- 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
- 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.
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