Building dfu-util from source

# How to build dfu-util from source

## Prerequisites for building from git

### Mac OS X

First install MacPorts (and if you are on 10.6 or older, the Java Developer Package) and then run:

    	sudo port install libusb-devel git-core

### FreeBSD

    	sudo pkg_add -r git pkgconf

### Ubuntu and Debian and derivatives

    	sudo apt-get build-dep dfu-util
    	sudo apt-get install libusb-1.0-0-dev

## Get the source code and build it

The first time you will have to clone the git repository:

    	git clone git://gitorious.org/dfu-util/dfu-util.git
    	cd dfu-util

If you later want to update to latest git version, just run this:

    	make maintainer-clean
    	git pull

To build the source:

    	./autogen.sh
    	./configure  # on most systems
    	make

If you are building on Mac OS X, replace the ./configure command with:

    	./configure --libdir=/opt/local/lib --includedir=/opt/local/include  # on MacOSX only

Your dfu-util binary will be inside the src folder. Use it from there, or install it to /usr/local/bin by running "sudo make install".

## Cross-building for Windows

Windows binaries can be built in a MinGW environment, on a Windows computer or cross-hosted in another OS. To build it on a Debian or Ubuntu host, first install build dependencies:

    	sudo apt-get build-dep libusb-1.0-0 dfu-util
    	sudo apt-get install mingw32

The below example builds dfu-util 0.8 and libusb 1.0.19 from unpacked release tarballs. If you instead build from git, you will have to run "./autogen.sh" before running the "./configure" steps.

    mkdir -p build
    cd libusb-1.0.19
    PKG_CONFIG_PATH=$PWD/../build/lib/pkgconfig ./configure \
        --host=i586-mingw32msvc --prefix=$PWD/../build
    # WINVER workaround needed for 1.0.19 only
    make CFLAGS="-DWINVER=0x0501"
    make install
    cd ..

    cd dfu-util-0.8
    PKG_CONFIG_PATH=$PWD/../build/lib/pkgconfig ./configure \
        --host=i586-mingw32msvc --prefix=$PWD/../build
    make
    make install
    cd ..

The build files will now be in build/bin.

## Building on Windows using MinGW

This assumes using release tarballs or having run ./autogen.sh on the git sources.

    cd libusb-1.0.19
    ./configure --prefix=$HOME
    # WINVER workaround needed for 1.0.19 only
    # MKDIR_P setting should not really be needed...
    make CFLAGS="-DWINVER=0x0501" MKDIR_P="mkdir -p"
    make install
    cd ..

    cd dfu-util-0.8
    ./configure USB_CFLAGS="-I$HOME/include/libusb-1.0" \
                USB_LIBS="-L $HOME/lib -lusb-1.0" PKG_CONFIG=true
    make
    make install
    cd ..

To link libusb statically into dfu-util.exe use instead of "make":

    make LDFLAGS=-static

The built executables (and DLL) will now be under $HOME/bin.

[Back to dfu-util main page]