The Open Automatic Deformation Monitoring System (OpenADMS) is a free and open-source platform for sensor control, observation data processing, and spatial data storage in the Internet of Things (IoT).
The OpenADMS Node software runs on single sensor node instances in a sensor network to obtain the measured data of total stations, digital levels, inclinometers, weather stations, GNSS receivers, and other sensors. The raw data is then processed, analysed, stored, and transmitted. OpenADMS Node can be used to observe objects like:
- bridges, tunnels, dams;
- landslides, cliffs, glaciers;
- construction sites, mining areas;
- churches, monasteries, and other historic buildings.
The software is written in Python 3.6 and has been tested on:
- Microsoft Windows 7 (x86, x86-64)
- FreeBSD 12 (x86-64, ARMv7)
- NetBSD 7 (ARMv7)
- Debian 9, Raspbian Jessie (ARMv7)
- Fedora 25 (x86-64)
- Android 9 (ARM)
The current development version of OpenADMS Node is 0.8 (code name “Hanoi”). For more information, see https://www.dabamos.de/.
Either CPython 3.6+ or PyPy3.5+ has to be installed. OpenADMS Node uses
for dependency management and virtual environments. Make sure that
$ pip3 install -U pipenv
Download the latest release
or clone the master branch with Git. Then, create a virtual environment with
$ git clone https://github.com/dabamos/openadms-node $ cd openadms-node/ $ pipenv lock $ pipenv sync
Run OpenADMS Node from the command line:
$ pipenv run ./openadms.py --config ./config/config.json --with-mqtt-broker --debug
OpenADMS Node also features a graphical launcher. At first, run
Microsoft Windows or install the dependencies manually:
$ pipenv install Gooey
pipenv run ./openadms-launcher.pyw to start the launcher.
The MQTT protocol is used for the message exchange in OpenADMS Node. You can
either use an external MQTT message broker, like
Eclipse Mosquitto, or start the internal one by adding
OpenADMS Node must be configured by a JSON-based text file. Please define modules, serial ports, sensors, etc. in there. The file name of your custom configuration is taken as an argument. For instance, run:
$ pipenv run ./openadms.py --config ./config/example.json
Documentation and Supported Sensors
The documentation is hosted on the
./docs for how to build the documentation from source.
For a list of tested sensors, see https://dabamos.de/sensors/.
Development dependencies must be installed to run test:
$ pipenv install --dev
Execute the unit tests with:
$ pipenv run pytest
These are work in progress. You can run passive checks with pyflakes:
$ pipenv run pyflakes *.py *.pyw core/*.py modules/*.py
OpenADMS is licenced under BSD (2-Clause).