Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A toolset for recording trails between waypoints by tagging tags against readers.
Python Other
Pull request Compare This branch is 1 commit behind sparkslabs:master.
Latest commit 6ae55ba @sparkslabs sparkslabs Move even temporary logs out of /var/run
Had missed that /var/run had been changed to enforce ephemeral nature
by many distros in recent years (but not all unices), meaning while the
logs generated in /var/run are ephemeral and will be cleaned up, they're
not persistent. For the moment moved to /var/log. /var/spool perhaps
better choice in longer term.
Failed to load latest commit information.
debian Move even temporary logs out of /var/run
docs Overview of piotf Waypoint Packages.
etc Waypoint ubuntu service created/resilience changes
scripts Move even temporary logs out of /var/run


A toolset for recording trails between waypoints by tagging tags against readers.

This is a package that is aimed at getting a codebase suitable for running a basic IOT enhanced event.

The aim of this package is as follows: * You should have installed a working Ubuntu 12.04 box * You should be able to install this package * You should be able to configure running profiles in /etc/waypointservice * Dependent on these profiles, when this box starts up it should start up a process that configures the process as tag reader node or as an collation node, or both. * This should be able to happen without human interaction - except for initial configuration

Currently the package does most of these points, except for configuration. Installation of the debian package for this codebase will result in a waypointservice that starts up at boot, and allows for plug and play with both readers and actuators.

DEPENDENCIES / Installation thereof

Requirements required for this to work: sudo apt-get install git sudo apt-get install python-dev sudo apt-get install swig sudo apt-get install cython sudo apt-get install libusb-dev sudo apt-get install python-serial

Kamaelia + Axon: git clone cd kamaelia cd Code/Python/Axon sudo python install cd ../Kamaelia sudo python install


git clone
cd cd python-rfidtag
sudo python install

If not enabled on the box, enable ssh - this simplifies managing an installation.


The preferred installation approach is to install the dependencies and then install the debian package.

Manual installation

Inside the waypoint tarball: sudo python install

Then: sudo waypoint.mkdirs


The touchatad/tikitag readers require root privileges so must be run as follows: sudo waypoint_reader

This will only work if a reader is plugged in. It furthermore currently has a dependency on there also being an arduino plugged.

Assuming the hardware is OK, this will log tagged data to:

* /var/log/waypointservice/tagsread.log

The format of that file is "\n" delimited JSON array objects of format: * Timestamp (float value) * tag id as a decimal integer value * Defined reader id

Configuration of reader

At present the reader ID is not configurable without modification of the code. In practice this means modifying /usr/[local/]bin/waypoint_reader in a hopefully obvious way. This will change shortly. To give an idea of complexity of change, the entirety of that file is presented here:

from waypoint.reader import TagReaderClient

# All the arguments here should be externally configurable
TagReaderClient(collator_ip = "",
                collator_port = 1600,

It should be obvious from the above and how this would need changing.


Installation as a collator / etc (see docs/todo.txt)


Something went wrong with that request. Please try again.