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.