IIO Linux kernel tools

Linux^® kernel provides some user space tools that can be used for testing the IIO subsystem.

1 Article purpose

The purpose of this article is to:

• briefly introduce the IIO user space tools that comes with the Linux^® kernel
• provide a few examples using these tools

2 Introduction

These tools use IIO sysfs and character device directly without libiio (See IIO user space interface for further details).

3 Tools

The Linux^® kernel provides the following IIO user space tools:

• lsiio: example application that provides a list of IIO devices and triggers.

root@stm32mp1:~# lsiio
Device 001: 48003000.adc:adc@100
Device 000: 48003000.adc:adc@0
Trigger 018: tim3_ch4
Trigger 007: tim1_ch3
...

• iio_event_monitor: example application that reads events from an IIO device and prints them.
  See How to get ADC analog watchdog events.

root@stm32mp1:~# iio_event_monitor /dev/iio:device0 &
Event: time: 1529352199639112110, type: voltage, channel: 0, evtype: thresh, direction: either
Event: time: ...

• iio_generic_buffer: example application that reads data from buffer.
• iio_utils: set of routines built-in above IIO tools, typically used to access sysfs files.

4 Source code

The Linux^® kernel IIO tools source code can be found under tools/iio directory:

• tools/iio/lsiio.c
• tools/iio/iio_event_monitor.c
• tools/iio/iio_generic_buffer.c
• tools/iio/iio_utils.c

5 Installation on your target

The Linux^® kernel IIO tools aren't embedded by default in OpenSTLinux distribution. They can be compiled independently and then installed on the target. See How to build Linux kernel user space tools.

Industrial I/O Linux subsystem

System File System (See https://en.wikipedia.org/wiki/Sysfs for more details)

Industrial I/O Linux subsystem

System File System (See https://en.wikipedia.org/wiki/Sysfs for more details)