Install and compile Heimdall

Linux

Fedora

$ su -c 'yum groupinstall "Development Tools"'
$ su -c 'yum install libusb1-devel qt-devel'

After this step follow instructions for generic linux given below

Debian based

These instructions are for Debian based distributions including Ubuntu and LinuxMint.

$ sudo apt-get install build-essential pkg-config zlib1g-dev libusb-dev libqt4-dev qt4-qmake autoconf libtool libusb-1.0-0-dev

After this step follow instructions for compiling for generic linux below. Alternatively users with Ubuntu (and Ubuntu based) systems can follow the instructions at https://launchpad.net/~modycz/+archive/heimdall

Arch Linux

Heimdall is available in the AUR (AUR/heimdall). If you have yaourt or pacaur you can compile and install simply using

$ yaourt -S heimdall

or

$ pacaur -S heimdall

Generic Linux Instructions

These are distro-independent instructions.

Installing prerequisites

Use your favourite package manager to install (the development version if your distro has seperate "-dev" packages)of the following pre-requisites:

1. gcc/g++
2. make(automake)
3. libc(glibc)
4. libusb
5. qt

Downloading and Installing

$ git clone git://github.com/Benjamin-Dobell/Heimdall.git
$ cd Heimdall/libpit
$ ./autogen.sh
$ ./configure
$ make
$ cd ../heimdall
$ ./autogen.sh
$ ./configure
$ make
$ su -c 'make install'
$ cd ../heimdall-frontend/
$ qmake-qt4 heimdall-frontend.pro
$ make
$ su -c 'make install'

If you get a message like “RCC: Warning: No resources in ‘mainwindow.qrc’” during qmake-qt4, you can ignore it. It is not an actual error and Heimdall will work just fine.

You can now run Heimdall from the command line by running either

$ heimdall

or

$ heimdall-frontend

OSX

Installing prerequisites

• First make sure you have installed XCode and pkgconfig.
  • There are several different ways you can install pkgconfig, the simplest option is to use Homebrew.

$ brew install pkgconfig

• Open a terminal and navigate to the directory you downloaded, or extracted, Heimdall to.
• Install libusb >= 1.0:
  • The simplest option is to use Homebrew.

$ brew install libusb

• • Alternatively you may download and compile from: http://www.libusb.org/
• Enter the following commands to compile libpit.

$ cd libpit
$ ./configure
$ make
$ cd ..

• • NOTE: There is no need to run "sudo make install".

Installing heimdall

• Enter the following commands to compile and install Heimdall:

$ cd heimdall
$ export CC=/usr/bin/clang CXX=/usr/bin/clang++
$ ./configure
$ make
$ sudo make install
$ cd ..

• • NOTE: The export line is needed to overcome a compile error with 1.4RC and will hopefully be unnecessary soon.
  • NOTE: Do not be alarmed if the sudo make install ends with: make[2]: Nothing to be done for `install-data-hook'
• If you haven't installed the driver before, enter the following:

$ cd OSX
$ sudo ./install-kext.sh

Installing the Frontend

• First make sure you have installed XCode from your OS X install DVD.
• You'll also need Qt 4.7 or later, available from: http://qt.nokia.com/downloads/
• Open a terminal and navigate to the directory you extracted Heimdall to.
• Enter the following commands to compile and install Heimdall Frontend:

$ cd heimdall-frontend
$ qmake heimdall-frontend.pro

• Open Finder and navigate to the heimdall-frontend sub-directory. Open the newly created XCode project.
• From the menu bar select Build -> Build. This outputs heimdall-frontend to /Applications

Windows

Installing prerequisites

• Ensure that you have both a version of Visual Studio 2010 with C++ support and Qt Developer Framework 4.7 (or newer) installed on your system.
  • A free version (Visual C++ 2010 Express) can be downloaded from Microsoft's website:
    • http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-cpp-express
  • Qt can also be downloaded freely from Nokia's website:
    • http://qt.nokia.com/downloads/

Installing Heimdall

1. Open Heimdall/msvc2010.sln
2. From the Solutions Configuration drop-down change from "Debug" to "Release".
3. In the Solution Explorer right-click on the heimdall-frontend project and chose "Build".
4. Depending on how you've installed Qt on your system you may need to copy "QtCore4.dll, "QtGui4.dll" and "QtXml4.dll" from your Qt bin/ sub-directory to Heimdall's Win32/Release sub-directory.
5. Heimdall Frontend can then be run from Win32/Release or command line can be used to run Heimdall (command line) from the same directory.