Features

The main features of this library are:

• It wraps the C functions of DGILib in python functions

• It provides a class to easily log data from the power and gpio interfaces to a .csv file or a plot (using matplotlib)

• It provides a function that wraps atprogram.exe and make.exe so it can compile projects and flash them to a board

The documentation of all the functions can be found in this overview or this list.

Installation

You will need to install pydgilib in a 32-bit Python environment on Windows because DGILib.dll is compiled for 32-bit. Other operating systems are not supported.

$ pip install pydgilib

$ pip install git+https://github.com/EWouters/pydgilib

Getting Started

1. Connect your device that supports DGI

2. Print the serial number of your device:

   >>> from pydgilib import DGILib
   >>> with DGILib() as dgilib:
   ...     print(dgilib.device_sn)
   ...
   b'ATML3138061800001604'

3. Log the current of the board and the states of the gpio pins for one second and write the results to .csv files:

   >>> from pydgilib_extra import DGILibExtra
   >>> with DGILibExtra() as dgilib:
   ...     dgilib.logger.log(1)
   ...

4. Log the current of the board and the states of the gpio pins for one second and show a plot of the results:

   >>> from pydgilib_extra import DGILibExtra, LOGGER_PLOT
   >>> with DGILibExtra(loggers=[LOGGER_PLOT]) as dgilib:
   ...     dgilib.logger.log(1)
   ...
   {48: <pydgilib_extra.dgilib_data.InterfaceData object at 0x00F22A90>, 256: <pydgilib_extra.dgilib_data.InterfaceData object at 0x00F229F0>}