Windows: Difference between revisions

From flashrom
Jump to navigation Jump to search
No edit summary
Line 84: Line 84:
First you need to install MinGW (on Ubuntu it is enough to install the package mingw32).
First you need to install MinGW (on Ubuntu it is enough to install the package mingw32).
Of course all the normal build utilities are needed like make etc. (usually contained in a package named build-essential or similar).
Of course all the normal build utilities are needed like make etc. (usually contained in a package named build-essential or similar).
libusb and libftdi support has not been tested yet.
If you want to use libusb and libftdi you need to get the headers and static library files (*.a).
You can then compile flashrom with
The latter can either be downloaded pre-built or also cross-compiled.
  $ '''make CC=i586-mingw32msvc-gcc'''
You can then compile flashrom.exe with
which should result in the creation of flashrom.exe.
  $ '''make CC=i586-mingw32msvc-gcc CPPFLAGS="-I.../libusb-headers/ -I.../libftdi-headers/" LDFLAGS="-L.../libusb-static/ -L.../libftdi-static/"
'''
where the '''*-headers''' directories include the libusb and libftdi headers and the '''*-static''' directories contain the static libraries respectively. Relative paths (originating in the flashrom directory) are allowed.

Revision as of 23:55, 30 December 2012

Using flashrom on Windows

Requirements

In order to use flashrom on Windows you must either build it from source as explained below or just download a snapshot from here. If your programmer is COM or LPT-based, there is nothing more to do, because Windows has all drivers needed.

It isn't so easy for USB-based devices, because they needed a special libusb-win32 driver, that must be generated and installed to make it available to the flashrom executable. Because the nature of the generation process, the driver has no digital signature and can't be installed on 64-bit Windows versions without some preparations.

Obtaining libusb-win32

The required installation file can be found on the libusb-win32 project site. Please use the same version that was used for flashrom compilation as indicated by the download path.

Download the file named libusb-win32-bin-x.y.z.t.zip and unpack /libusb-win32-bin-x.y.z.t/bin directory from it.

Making libusb-based driver for your device

  • Attach your USB device and click on Cancel or Close on the Driver Installation Wizard window.
  • Run inf-wizard.exe from the unpacked bin directory. Click on Next.

  • Select your device from the list, click on Next.

  • Do not alter Vendor ID, Product ID and MI. You can alter Manufacturer and Device names, if you want. Click on Next.
  • Select the destination for the newly created driver and click on Save.

  • If you are using 32bit Windows version or 64bit Windows version with unsigned driver installation option enabled, click on Install Now... to install the driver.
  • If you receive an error message instead of a successful driver installation, disable the enforced driver signing (your favorite search engine will give you details about that) and install the driver after that.
  • Detach your device and attach it once again to finish the installation.

Using flashrom

After installing the drivers successfully you can use flashrom without Administrator privileges. Consult the man page about how to use it in general and the options available for your programmer.

Building flashrom on Windows using MinGW/MSYS.

Before you set up a MinGW/MSYS build environment, note that you can find snapshot downloads at http://ra.openbios.org/~idwer/flashrom/mingw/

Requirements

MinGW/MSYS

In order to build flashrom and various of its dependencies, we need a UNIX-like environment on Windows, which is provided by MinGW/MSYS.

  • Download the latest version (20110530 currently) of the automated MinGW installer named mingw-get-inst (double-click the installer *.exe, which will download and install all components).
    • Make sure you enable "MinGW Compiler Suite", "C++ compiler", "MSYS Basic System", and "MinGW Developer Toolkit" in the installer.
    • For simplicity it's recommended to leave the default install location of c:\MinGW unchanged.

Now open a MinGW shell via Start/Programs/MinGW/MinGW Shell and do the following:

$ mingw-get update
$ mingw-get install msys-wget msys-unzip

libusb-win32

libftdi

  • Install libftdi. The easiest method is probably to use the libftdi-0.18_mingw32.zip binaries from here.
    • Extract the ZIP file into a temporary directory.
    • Copy dll/libftdi.dll to /usr/local/bin.
    • Copy lib/libftdi.a and lib/libftdi.dll.a to /usr/local/lib.
    • Copy include/ftdi.h to /usr/local/include.

Building flashrom

Checkout the flashrom source code from svn (e.g. using TortoiseSVN), then:

$ cd flashrom
$ make

Building (cross-compiling) flashrom on Linux for Windows using MinGW.

First you need to install MinGW (on Ubuntu it is enough to install the package mingw32). Of course all the normal build utilities are needed like make etc. (usually contained in a package named build-essential or similar). If you want to use libusb and libftdi you need to get the headers and static library files (*.a). The latter can either be downloaded pre-built or also cross-compiled. You can then compile flashrom.exe with

$ make CC=i586-mingw32msvc-gcc CPPFLAGS="-I.../libusb-headers/ -I.../libftdi-headers/" LDFLAGS="-L.../libusb-static/ -L.../libftdi-static/"

where the *-headers directories include the libusb and libftdi headers and the *-static directories contain the static libraries respectively. Relative paths (originating in the flashrom directory) are allowed.