Quick Start — Analog Devices Hardware Python Interfaces 0.0.8 documentation

# Quick Start

Before installing pyadi-iio make sure you have libiio and its python bindings installed. Since libiio v0.21, the libiio python bindings have been available on pypi and conda. The conda package includes the built library but the pypi install will require that it is installed beforehand. If you install pyadi-iio directly from pypi or conda they will automatically install the python bindings for libiio (pylibiio).

Note

libiio does not currently have a pip installer, but releases are available on GitHub along with the source. For releases v0.19+ of libiio, when building from source the -DPYTHON_BINDINGS=ON flag is required

pyadi-iio can by installed from pip

    (sudo) pip install pyadi-iio

or by grabbing the source directly

    git clone https://github.com/analogdevicesinc/pyadi-iio.git
    cd pyadi-iio
    (sudo) python3 setup.py install

To install the optional dependencies for JESD debugging and control

    (sudo) pip install pyadi-iio[jesd]

Note that this is only needed for the ADRV9009-ZU11EG multi-SOM configuration.

Note

On Linux the libiio python bindings are sometimes installed in locations not on path. On Ubuntu this is a common fix

    export PYTHONPATH=$PYTHONPATH:/usr/lib/python{PYTHON VERSION}/site-packages

## Install Checks

For check for libiio with the following from a command prompt or terminal:

    dave@hal:~$ python3
    Python 3.6.8 (default, Jan 14 2019, 11:02:34)
    [GCC 8.0.1 20180414 (experimental) [trunk revision 259383]] on linux
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import iio
    >>> iio.version
    (0, 18, 'eec5616')

If that worked, try the follow to see if pyadi-iio is there:

    dave@hal:~$ python3
    Python 3.6.8 (default, Jan 14 2019, 11:02:34)
    [GCC 8.0.1 20180414 (experimental) [trunk revision 259383]] on linux
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import adi
    >>> adi.__version__
    '0.0.5'
    >>> adi.name
    'Analog Devices Hardware Interfaces'