Difference between revisions of "IIO Linux kernel tools"

[quality revision] [quality revision]
m
m
 

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

1 Article purpose[edit]

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[edit]

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

3 Tools[edit]

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
...
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[edit]

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

5 Installation on your target[edit]

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.

6 References[edit]

  1. tools/iio , Linux® IIO tools source code
Template:ArticleMainWriter Template:ReviewersList Template:ArticleApprovedVersion


'''Summary''' <br>
Linux<sup>&reg;</sup> kernel provides some user space tools that can be used for testing the [[IIO overview|IIO subsystem]].

== Article purpose ==
The purpose of this article is to:
* briefly introduce the IIO user space tools that comes with the Linux<sup>&reg;</sup> kernel
* provide a few examples using these tools

== Introduction ==
These tools use IIO sysfs and character device directly without [[IIO libiio|libiio]] (See [[IIO_overview#User_space_interface|IIO user space interface]] for further details).

== Tools ==
The Linux<sup>&reg;</sup> kernel provides the following [[IIO overview|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.<br/>See [[How_to_use_the_IIO_user_space_interface#How_to_get_ADC_analog_watchdog_events|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.

== Source code ==
The Linux<sup>&reg;</sup> kernel IIO tools source code can be found under tools/iio<ref name="iio tools source">{{CodeSource | Linux kernel | tools/iio}}, Linux<sup>&reg;</sup> IIO tools source code</ref> directory:
* {{CodeSource | Linux kernel | tools/iio/lsiio.c}}
* {{CodeSource | Linux kernel | tools/iio/iio_event_monitor.c}}
* {{CodeSource | Linux kernel | tools/iio/iio_generic_buffer.c}}
* {{CodeSource | Linux kernel | tools/iio/iio_utils.c}}

== Installation on your target ==
The Linux<sup>&reg;</sup> 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]].

==References==<references />

<noinclude>
{{ArticleMainWriter|FabriceG}}
{{ReviewersList|ArnaudP, OlivierM, ErwanLR}}
{{ArticleApprovedVersion | FabriceG | ErwanLR | No previous approved version | BrunoB - 11Oct'18 - 9166 | 11Oct'18}}
[[Category:IIO|3]][[Category:IIO|3]]
{{PublicationRequestId | 9166 | 2018-10-11 | BrunoB}}</noinclude>
Line 1: Line 1:
'''Summary''' <br>
 
 
Linux<sup>&reg;</sup> kernel provides some user space tools that can be used for testing the [[IIO overview|IIO subsystem]].
 
Linux<sup>&reg;</sup> kernel provides some user space tools that can be used for testing the [[IIO overview|IIO subsystem]].
   
Line 40: Line 39:
   
 
<noinclude>
 
<noinclude>
{{ArticleMainWriter|FabriceG}}
 
{{ReviewersList|ArnaudP, OlivierM, ErwanLR}}
 
{{ArticleApprovedVersion | FabriceG | ErwanLR | No previous approved version | BrunoB - 11Oct'18 - 9166 | 11Oct'18}}
 
 
[[Category:IIO|3]]
 
[[Category:IIO|3]]
  +
{{PublicationRequestId | 9166 | 2018-10-11 | BrunoB}}
 
</noinclude>
 
</noinclude>

Attachments

Discussions