Instrument/BaylibreAcme: Add IIO-based ACME instr.

Browse Source

Add BaylibreAcmeInstrument, a new instrument providing support for the
Baylibre ACME board as a wrapper for the IIO interface. This class
provides better access to the ACME hardware (e.g. the ability to control
the sampling frequency) and to the retrieved samples than what the other
instrument, AcmeCapeInstrument, provides. Furthermore, it removes an
unnecessary and limiting dependency by interfacing directly with the IIO
drivers instead of relying on an intermediate script ("iio-capture") potentially
introducing unexpected bugs. Finally, it allows handling multiple probes
(the ACME can have up to 8) through an easy-to-use single instance of this
class instead of having to have an instance of AcmeCapeInstrument per channel
potentially (untested) leading to race conditions between the underlying
scripts for accessing the hardware.

This commit does not overwrite AcmeCapeInstrument as
BaylibreAcmeInstrument does not provide interface compatibility with
that class. Anyhow, we believe that anything that can be achieved with
AcmeCapeInstrument can be done with BaylibreAcmeInstrument (the
reciprocal is not true) so that BaylibreAcmeInstrument might eventually
replace AcmeCapeInstrument.

Add BaylibreAcmeInstrument documentation detailing the class interface
and the ACME instrument itself and discussing the way it works and its
potential limitations.

...

This commit is contained in:

Pierre-Clement Tosi

2018-06-28 21:33:47 +01:00

committed by Marc Bonnici

parent 30dc161f12

commit 63d2fb53fc

11 changed files with 1219 additions and 10 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

BIN

doc/images/instrumentation/baylibre_acme/bottleneck.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 46 KiB

BIN

doc/images/instrumentation/baylibre_acme/buffer.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 140 KiB

BIN

doc/images/instrumentation/baylibre_acme/cape.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 1.1 MiB

BIN

doc/images/instrumentation/baylibre_acme/ina226_circuit.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 70 KiB

BIN

doc/images/instrumentation/baylibre_acme/ina226_functional.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 42 KiB

BIN

doc/images/instrumentation/baylibre_acme/int_time.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 132 KiB