Skip to content
Daniel Berenguer edited this page Jul 28, 2016 · 20 revisions

Introduction

panStamp provides a set of tools written in python compatible with our [SWAP protocol](Simple Wireless Abstract Protocol). These tools can be used to configure, monitor, control and automate SWAP networks from a computer close to the wireless network or remotely via IP. Theses tools can also be used to develop new control applications or simply create custom automation scripts to add logic relationship between nodes or push sensor data to the cloud. panStamp's python resources are also useful to integrate SWAP into third-party applications such as automation software, graphic interfaces, databases, etc.

This package consists of the following Python modules and applications:

  • pyswap - Python module adding support for SWAP to the rest of applications
  • swapdmt - GUI version of our SWAP Device Management Tool
  • swapdmt-cmd - command-line version of our SWAP Device Management Tool
  • lagarto - Lagarto open automation software

Installation on Debian-like distros

Starting from version 2.4, the Python tools are provided with an install script for Debian-like distributions (Debian, Ubuntu, Raspbian, ...). This script can be used on any Linux OS with support for "apt-get" installations and can be easily ported to other Linux OS's by changing "apt-get" and the package names by the corresponding calls for the specific distribution. The script also relies on Python setuptools (easy_install) for the installation of all the Python modules.

Important note : this install script does not install wxPython. If you want to use swapdmt-gui you will have to install wxPython manually. The rest of application should work after completing the following guide:

1- Download or "git clone" the latest Python tools from github.

2- Unzip the compressed file and enter the "python" directory from a terminal

unzip panstamp_python_version.zip
cd python

3- Once in "python", run the bash script "debian-install.sh" as superuser

sudo sh debian-install.sh

This process usually takes some minutes on most computers and around ten minutes on a Raspberry PI. This will install all the necessary packages, including ZeroMQ, python-dev, python-setuptools and the rest of Python modules and bindings.

Installation on other platforms

Read README.txt to see how to install the Python applications and modules step by step.