CrustyAuklet / python-aardvark

Python library for the Total Phase Aardvark I2C/SPI host adapter

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Python binding for Total Phase Aardvark

BuildStatus PyPiVersion Python versions

The Total Phase Aardvark is an USB I2C/SPI host adapter.

Rationale

The manufacturer already provides an python binding. So why a new one? This is correct, but the python binding you can find in the aardvark-linux-api package is very C oriented. Eg. you need to pass arrays as method parameters, which are then modified by the binding. Instead, this binding tries to be more pythonic.

Features

  • simple, pythonic interface
  • CLI tool for easy testing
  • I2C and SPI support
  • GPIO support
  • support for control signals like target power and internal I2C pullups
  • Support for Linux, Windows and OSX

(Still) Missing Features

  • more documentation (please bear with me)

Documentation

You can find the most up to date documentation at: http://pyaardvark.rtfd.org

Requirements

You need an either a x86 or an amd64 machine. This is because the binding uses a binary-only module supplied by the manufacturer, Total Phase. Linux, Windows, and OSX is supported.

Contributing

Contributions are always welcome. You may send patches directly (eg. git send-email), do a github pull request or just file an issue.

If you are doing code changes or additions please:

  • respect the coding style (eg. PEP8),
  • provide well-formed commit message (see this blog post.)
  • add a Signed-off-by line (eg. git commit -s)
  • test your commits (pip2 install nose 'mock<=1.0.1' && nosetests)

License

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

About

Python library for the Total Phase Aardvark I2C/SPI host adapter

License:GNU Lesser General Public License v2.1


Languages

Language:Python 100.0%