Difference between revisions of "Linux"

From sigrok
Jump to navigation Jump to search
(→‎Requirements: python 3 is now required)
(→‎Installing the build-dependencies: fixed the python installation command for fedora)
Line 37: Line 37:
Fedora:
Fedora:


  $ '''yum install gcc-c++ libtool glib2-devel libftdi-devel libusb1-devel libzip-devel qt-devel python-devel'''
  $ '''yum install gcc-c++ libtool glib2-devel libftdi-devel libusb1-devel libzip-devel qt-devel python3-devel'''


=== Building ===
=== Building ===

Revision as of 17:57, 4 January 2012

sigrok-gui on Linux

This page describes how to build/install sigrok on Linux.

Distribution packages

There are no distribution packages, yet, but some are being worked on.

Building from source

Requirements

  • git (for cloning the source code repository)
  • gcc, g++, make, ...
  • autoconf, automake, libtool, pkg-config
  • libglib >= 2.22.0
  • libusb >= 1.0.5
  • libzip >= 0.8
  • libftdi (optional, only required for some devices)
  • libudev >= 151 (optional, only required for some devices)
  • Python >= 3.0
  • Qt + Qt Creator >= 4.5 (optional, only required for building/editing the GUI)

Installing the build-dependencies

On most Linux distributions there are pre-built packages for the sigrok dependencies (if not, you have to build the packages from source). The installation using a package manager is usually pretty simple.

Debian/Ubuntu:

$ sudo apt-get install git-core gcc g++ make autoconf automake libtool pkg-config \
  libglib2.0-dev libftdi-dev libudev-dev libusb-1.0-0-dev libzip-dev python-dev qtcreator qt4-designer qt4-dev-tools libqt4-dev

Fedora:

$ yum install gcc-c++ libtool glib2-devel libftdi-devel libusb1-devel libzip-devel qt-devel python3-devel

Building

First, checkout the sources:

$ git clone git://sigrok.git.sourceforge.net/gitroot/sigrok/sigrok
$ cd sigrok

Then you need to build libsigrok:

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

The same applies to libsigrokdecode:

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

Then, for building the GUI (Note: The GUI is not yet usable!):

$ cd gui
$ qmake
$ make

If you get warnings claiming potential symbol conflicts when running qmake, you are likely invoking qmake-qt4. Try running qmake-qt4 to force the correct version.

Pitfalls

If you get this error:

sigrok-cli: error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Then you have to rebuild the links to your shared libraries:

$ sudo ldconfig /usr/local/lib

Testing

Scan for devices:

$ sigrok-cli -D
The following devices were found:
ID    Device
0     Zeroplus Logic Cube with 32 probes
demo  Demo device with 8 probes

Get 10 samples from device 0 (Zeroplus Logic Cube in this example):

$ sigrok-cli -d 0 --samples 10

See Command-line for further usage.