Difference between revisions of "Windows"

From sigrok
Jump to navigation Jump to search
m
(Update Windows instructions.)
Line 87: Line 87:
=== libglib and pkg-config ===
=== libglib and pkg-config ===


sigrok also needs [http://ftp.gnome.org/pub/gnome/binaries/win32/glib/ libglib >= 2.22.0], which in turn needs [http://ftp.gnome.org/pub/gnome/binaries/win32/dependencies/ pkg-config] . Download the latest versions of the respective Windows binaries and extract them into '''c:\MinGW\msys\1.0\local''':
sigrok also needs [http://ftp.gnome.org/pub/gnome/binaries/win32/glib/ libglib >= 2.22.0], which in turn needs [http://ftp.gnome.org/pub/gnome/binaries/win32/dependencies/ pkg-config] (>= 0.22). Download the latest versions of the respective Windows binaries and extract them into '''c:\MinGW\msys\1.0\local''':


* [http://ftp.gnome.org/pub/gnome/binaries/win32/glib/ glib and glib-dev]
* [http://ftp.gnome.org/pub/gnome/binaries/win32/glib/ glib and glib-dev]
Line 136: Line 136:
=== Python ===
=== Python ===


We also need Python >= 2.5 for running the sigrok [[protocol decoders]] which are written in Python. On Windows, sigrok currently assumes '''Python 2.6.x''' installed in '''c:\Python26'''.
We also need Python >= 3.0 for running the sigrok [[protocol decoders]] which are written in Python. On Windows, sigrok currently assumes '''Python 3.2.x''' installed in '''c:\Python32'''.


* Download and install the [http://python.org/ftp/python/2.6.6/python-2.6.6.msi latest version] (currently 2.6.6) of the [http://python.org/download/ Python Windows installer] (just double-click the *.msi installer file).
* Download and install the [http://python.org/ftp/python/3.2.2/python-3.2.2.msi latest version] (currently 3.2.2) of the [http://python.org/download/ Python Windows installer] (just double-click the *.msi installer file).
** For simplicity it's recommended to leave the default install location of '''c:\Python26''' unchanged.
** For simplicity it's recommended to leave the default install location of '''c:\Python32''' unchanged.


=== Qt ===
=== Qt ===


In order to also build the Qt-based [[GUI|sigrok-gui]], download the [http://qt.nokia.com/downloads#lgpl latest version] (>= 4.5) of the Qt SDK for Windows (LGPL version) and double-click the installer. The download includes the Qt libraries, Qt Creator, Qt Designer, and various other Qt development tools.
In order to also build the Qt-based [[GUI|sigrok-qt]], download the [http://qt.nokia.com/downloads#lgpl latest version] (>= 4.5) of the Qt SDK for Windows (LGPL version) and double-click the installer. The download includes the Qt libraries, Qt Creator, Qt Designer, and various other Qt development tools.


=== GTK+ ===
=== GTK+ ===
Line 166: Line 166:
  $ '''cd sigrok'''
  $ '''cd sigrok'''


Build the libraries and command line tool:
Build libsigrok:


$ '''cd libsigrok'''
  $ '''./autogen.sh'''
  $ '''./autogen.sh'''
  $ '''./configure'''
  $ '''./configure'''
  $ '''make'''
  $ '''make'''
  $ '''make install'''
  $ '''make install'''
$ '''cd ..'''
Build libsigrokdecode:
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''make install'''
$ '''cd ..'''
Build sigrok-cli:
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''make install'''
$ '''cd ..'''


Build the Qt GUI:
Build the Qt GUI:


  $ '''cd gui'''
  $ '''cd sigrok-qt'''
  $ '''/c/QtSDK/Desktop/Qt/4.7.4/mingw/bin/qmake'''
  $ '''/c/QtSDK/Desktop/Qt/4.7.4/mingw/bin/qmake'''
  $ '''make'''
  $ '''make'''
$ '''make install'''
$ '''cd ..'''


Build the GTK+ GUI:
Build the GTK+ GUI:


  $ '''cd gtk'''
  $ '''cd sigrok-gtk'''
  $ '''./autogen.sh'''
  $ '''./autogen.sh'''
  $ '''./configure'''
  $ '''./configure'''
  $ '''make'''
  $ '''make'''
$ '''make install'''
$ '''cd ..'''

Revision as of 13:05, 5 February 2012

sigrok-gui on Windows

Status

We intend to fully support all major operating systems in sigrok, including Windows. However, we're not quite there, yet, various portability issues need to be addressed still. The table below lists the current Windows status of the various hardware drivers.

Logic analyzer Windows status
Saleae Logic libusb-1.0 issues need to be sorted out.
EE Electronics XLA/ESLA100 libusb-1.0 issues need to be sorted out.
ASIX SIGMA Compiles fine using libftdi + libusb-0.1-win32 (not runtime-tested, though).
Openbench Logic Sniffer Serial port portability fixes required (partially implemented, but unfinished).
ZEROPLUS Logic Cube LAP-C Untested, but uses libusb-1.0, so there may be issues.
Link Instruments MSO-19‎ Doesn't compile due to libudev dependency. TODO: Make libudev optional.
ChronoVu LA8 Works fine using libftdi + libusb-0.1-win32.
Demo driver Works fine.

Self-extracting installer

Work in progress.

Currently only the command-line tool sigrok-cli is fully supported, but (for testing purposes) the Qt GUI and the GTK+ GUI are installed, too.

Building from source

This page describes how to build sigrok on Windows.

TortoiseGit

For checking out the sigrok source code you can use TortoiseGit on Windows.

  • Download and install the latest version (for 32bit or 64bit Windows) of TortoiseGit (just double-click the *.msi installer).
  • Download and install the latest version of the "full installer" of MSysGit (double-click the *.exe installer).

MinGW/MSYS

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

  • Download the latest version of the automated MinGW installer named mingw-get-inst (double-click the installer EXE file, 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

autotools

Installing the autotools (if not already done) is as simple as:

$ mingw-get install autoconf automake libtool

Additional files for sigrok

Unfortunately, not all binary packages needed for a sigrok build come with a pkg-config .pc file, thus we provide our own files for simplicity. Extract the following into c:\MinGW\msys\1.0\local:

libglib and pkg-config

sigrok also needs libglib >= 2.22.0, which in turn needs pkg-config (>= 0.22). Download the latest versions of the respective Windows binaries and extract them into c:\MinGW\msys\1.0\local:

Then run:

$ cd /c/MinGW/bin
$ cp libintl-8.dll intl.dll

libusb 1.0

$ git clone git://git.libusb.org/libusb-pbatard.git (or use TortoiseGit)
$ cd libusb-pbatard
$ ./autogen.sh
$ touch configure
$ make
$ make install

libftdi + libusb-0.1-win32

  • Download and execute libusb-win32-devel-filter-1.2.5.0.exe.
  • Download and extract libusb-win32-bin-1.2.5.0.zip.
    • Rename bin/x86/libusb0_x86.dll to libusb0.dll and copy it to /usr/local/bin.
    • Rename include/lusb0_usb.h to usb.h and copy it to /usr/local/include.
    • Copy lib/gcc/libusb.a to /usr/local/lib.
  • Install libftdi. The easiest method is probably to use the libftdi-0.19_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.

zlib

Download the latest versions of the respective Windows binaries and extract them into c:\MinGW\msys\1.0\local:

libzip

$ wget http://nih.at/libzip/libzip-0.10.tar.gz
$ tar xfvz libzip-0.10.tar.gz
$ cd libzip-0.10
$ ./configure --with-zlib=/usr/local
$ make
$ make install

Python

We also need Python >= 3.0 for running the sigrok protocol decoders which are written in Python. On Windows, sigrok currently assumes Python 3.2.x installed in c:\Python32.

  • Download and install the latest version (currently 3.2.2) of the Python Windows installer (just double-click the *.msi installer file).
    • For simplicity it's recommended to leave the default install location of c:\Python32 unchanged.

Qt

In order to also build the Qt-based sigrok-qt, download the latest version (>= 4.5) of the Qt SDK for Windows (LGPL version) and double-click the installer. The download includes the Qt libraries, Qt Creator, Qt Designer, and various other Qt development tools.

GTK+

Download the latest versions of the following Windows binaries and extract them into c:\MinGW\msys\1.0\local:

sigrok

Get the source code:

$ git clone git://sigrok.git.sourceforge.net/gitroot/sigrok/sigrok (or use TortoiseGit)
$ cd sigrok

Build libsigrok:

$ cd libsigrok
$ ./autogen.sh
$ ./configure
$ make
$ make install
$ cd ..

Build libsigrokdecode:

$ cd libsigrokdecode
$ ./autogen.sh
$ ./configure
$ make
$ make install
$ cd ..

Build sigrok-cli:

$ cd sigrok-cli
$ ./autogen.sh
$ ./configure
$ make
$ make install
$ cd ..

Build the Qt GUI:

$ cd sigrok-qt
$ /c/QtSDK/Desktop/Qt/4.7.4/mingw/bin/qmake
$ make
$ make install
$ cd ..

Build the GTK+ GUI:

$ cd sigrok-gtk
$ ./autogen.sh
$ ./configure
$ make
$ make install
$ cd ..