libsigrok with IIO

Summary

IIO is a generic transport protocol, tools and libraries used to transport Industrial Input/Output measurements.

In order to use the Sigrok facility to record and visualize IIO devices data, a Generic IIO driver was added to the libsigrok source code.

This git repository is a fork of the official sigrok source code with the following goals :

• Add Generic IIO support to actual distributed version for libsigrok, 0.3.0
• Upstream a clean IIO support the the future libsigrok releases

How to use

To specify your IIO device, you may either :

• only specify the generic-iio driver if the IIO devices are on the local machine
• specify the IP or Hostname after the generic-iio as :

sigrok-cli -d generic-iio:conn=baylibre-acme.local

• specify an XML file as :

sigrok-cli -d generic-iio:conn=my-context-file.xml

For PulseView, you cannot specify a conn variable, so you can use some Environment variables as :

IIOD_REMOTE=baylibre-acme.local pulseview

Ubuntu

Ubuntu Xenial 16.04

Replace the distribution libsigrok by adding the following PPA :

sudo add-apt-repository ppa:sigrok-iio/ppa

Then update and install the new libsigrok package :

sudo apt update
sudo apt install sigrok-cli

This should trigger installation of a libsigrok_iio package.

Running sigrok-cli should show the generic-iio package :

sigrok-cli -V
...
Supported hardware drivers:
...
  generic-iio          Generic IIO wrapper
...

Ubuntu Trusty 14.04

The installation depends on the official sigrok PPA archive, then the sigrok-iio PPA :

sudo add-apt-repository ppa:daniel-elstner/sigrok
sudo add-apt-repository ppa:sigrok-iio/ppa

Then update and install the new libsigrok package :

sudo apt update
sudo apt install sigrok-cli

Running sigrok-cli should show the generic-iio package :

sigrok-cli -V
...
Supported hardware drivers:
...
  generic-iio          Generic IIO wrapper
...

Local build and install

This method depends on the following libraries you should compile and install before :

• libiio version 0.6.0 : https://github.com/analogdevicesinc/libiio/archive/v0.6.tar.gz
• system provided libraries : pkg-config libglib2.0-dev libzip-dev

And optionally (to support other sigrok devices) :

• system provided libraries : libftdi-dev libusb-1.0-0-dev
• libserialport version 0.1.x : http://sigrok.org/download/source/libserialport/libserialport-0.1.1.tar.gz

Download and extract the release tarball, then :

$ ./configure
$ make
$ sudo make install

Make sure the configure script shows :

  - generic-iio..................... yes

In order to use the distribution's sigrok-cli or pulseview, you may use LD_LIBRARY_PATH to use the previously built shared library, like :

$ LD_LIBRARY_PATH=/usr/local/bin sigrok-cli -V

or

$ LD_LIBRARY_PATH=/usr/local/bin pulseview

By building a full sigrok install

Please look at the http://www.sigrok.org/wiki/Building and replace the tarballs or git checkout by the one provided here.

See :

• https://github.com/baylibre-acme/libsigrok/branches
• https://github.com/baylibre-acme/libsigrok/releases

Support status

0.3.0

• Almost supported, each device exported as channel group
• Need testing over more IIO devices

Releases :

• libsigrok-0.3.0-iio1

PPA Ubuntu archive :

• https://launchpad.net/~sigrok-iio/+archive/ubuntu/ppa

0.4.0

• Work ongoing on branch libsigrok-0.4.x-iio, is aligned on 0.3.x work, will serve as base for master work
• 0.4.x version is not packaged on Debian/ubuntu

Master

• Discution were started on the early 0.4.0 version, must be rebased on the 0.3.0 architecture and integrated in the official libsigrok source repository

Contact & Help

Feel free to report Issues and submit Pull Requests.