Archived!

• 2022-May-9: This repo has been archived, since the dfu-util is no longer used as an isolated Apio package. Use the Tools-oss-cad-suite package instead

---

toolchain-dfu

Apio package that contains the dfu-util utility for programming the Fomu board

Instead of compiling the dfu-util from scratch, the scripts just download the already compiled files from the amazing fpga-toolchain project and create the apio packages

How to create a new release

This information is for developers

• Clone the toolchain-dfu
• Open the build.sh file
• Change the VERSION variable to the new version for the Apio package (For example VERSION=2020.10.6)

# -- dfu apio package version
VERSION=2020.11.24

• Set the dfu version to include in the apio package

# -- fpga-toolchain version to download
# -- nightly-20201124
SRC_VER="nightly-20201124"

• Save the file
• Execute the building script for all the architectures you want to create

It will download the executables from the fpga-toolchain project and package them for apio

The apio target architectures are:

• linux_x86_64: For linux 64-bits
• windows_amd64: for windows 64-bits
• darwin: For Mac (Not available for windows 32-bits)

Example: Building the package for Linux

bash build linux_x86_64

• The apio packages are stored in the local releases folder
• Create the new release of toolchain-dfu in Github
  The tag and name of the release should start with the letter v and have three numbers separated by a colon. Ex: v2020.11.24
• Upload the apio packages from the releases local folder
• Apio should upgrade to the new version with the install command:

apio install dfu

• You can check that the new version is installed with:

apio install -l

Authors

• Carlos Venegas
• Juan González (Obijuan)

Credits

• The dfu-util has been developed by Harald Welte and Tormod Volden

• The fpga-toolchain project has been developed by Edward Bordin

• The building scripts are based on the Tools-systems by

  • Jesús Arroyo Torrens
  • Juan González-Gómez (Obijuan)