sensed 0.1.3

A sensor network server and client library.

sensed is a sensor network daemon that acts as a provider for sensor and node data. Uses a simple protocol based around MessagePack.

What is this thing?

Please the the wiki article on the subject.

Requirements

As sensed makes use of the typing module, Python 3.5 or newer is required. Beyond that, all dependencies are in the included requirements.txt file.

How do I install this thing?

The PyPI version can be installed as usual:

$ sudo pip3 install sensed

If you need the development version (you’ll probably know if you do), do the git-pip dance:

$ git clone http://github.com/sli/sensed
$ cd sensed
$ sudo pip install -e .

How do I use this thing?

First, see the --help output:

$ python3 sensed.py --help
Usage: sensed.py [OPTIONS]

Options:
  -c, --config TEXT   Configuration file for this instance.
  -n, --name TEXT     Name of his sensed instance. Default: sensed
  -S, --sensors TEXT  Sensor modules to load and enable.
  -i, --host TEXT     IP or hostname to bind to. Default: 0.0.0.0
  -p, --port INTEGER  Port to bind to. Default: 3000
  -V, --verbose       Enable verbose output (debugging)
  -t, --test          Enable test mode.
  --help              Show this message and exit.

Next, you’ll probably want to take a look at the example config file. As you’ll no doubt notice, a configuration file is not required.

The client library is included in this version of sensed.

Testing mode?

Testing mode simply tells sensed to send preconfigured test data from the sensor modules rather than query real sensors. Perhaps surprisingly, this allows you to test your sensor network infrastructure and your senselog implementation before deployment.

License

Distributed under the MIT License (MIT). See LICENSE for details.