https://github.com/xmos/lib_dfu
Device Firmware Upgrade (DFU) Library
https://github.com/xmos/lib_dfu
dfu i2c usb xcore xcore-200 xcore-ai xmos
Last synced: 7 days ago
JSON representation
Device Firmware Upgrade (DFU) Library
- Host: GitHub
- URL: https://github.com/xmos/lib_dfu
- Owner: xmos
- License: other
- Created: 2019-12-11T17:06:19.000Z (over 6 years ago)
- Default Branch: develop
- Last Pushed: 2026-04-08T14:24:39.000Z (2 months ago)
- Last Synced: 2026-04-08T16:23:01.080Z (2 months ago)
- Topics: dfu, i2c, usb, xcore, xcore-200, xcore-ai, xmos
- Language: C
- Homepage: https://www.xmos.com/libraries/lib_dfu
- Size: 3.97 MB
- Stars: 0
- Watchers: 2
- Forks: 4
- Open Issues: 15
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.rst
- License: LICENSE.rst
Awesome Lists containing this project
README
:orphan:
##############################################
lib_dfu: Device Firmware Upgrade (DFU) Library
##############################################
:vendor: XMOS
:version: 2.1.0
:scope: General Use
:description: Device firmware upgrade over a serial interface
:category: General Purpose
:keywords: Utility, USB, Serial interface
:devices: xcore-200, xcore.ai
*******
Summary
*******
The Device Firmware Upgrade (DFU) library provides functionality to
facilitate firmware updates over almost any transport physical layer. It includes
support for handling DFU packets, managing firmware images, and ensuring
the integrity of the update process.
********
Features
********
- One upgrade slot
- Support USB DFU spec v1.1
- Support for custom transport layers
************
Known issues
************
- USB example reports several warnings such as "port "XS1_PORT_1F" on tile[0] is not connected to any pins in this package.",
this is normal on small packages that do not have all the pins bonded out.
- The ``lib_device_control`` client handling currently consumes an additional thread as it is not distributable.
- For DFU over I2C the bus speed of up to 100kbps is supported. This is also supported with no clock stretching for all commands except ``upload``.
- DFU_ABORT request is supported in upload but not in download.
****************
Development repo
****************
* `lib_dfu `_ (https://www.github.com/xmos/lib_dfu)
**************
Required tools
**************
* XMOS XTC Tools: 15.3.1 or later
*********************************
Required libraries (dependencies)
*********************************
* `lib_logging `_ (https://www.xmos.com/libraries/lib_logging)
* `lib_xassert `_ (https://www.xmos.com/libraries/lib_xassert)
*************************
Related application notes
*************************
* `AN02019 - Device Firmware Upgrade over USB `_ (https://www.xmos.com/application-notes/an02019)
*******
Support
*******
This package is supported by XMOS Ltd. Issues can be raised against the software at
`www.xmos.com/support `_ or using GitHub `issues `_.