Skip to content

Automatic deformation monitoring system for geodetical and geotechnical control measurements in the Internet of Things.

License

Notifications You must be signed in to change notification settings

dabamos/openadms-node

Repository files navigation

license release ci

OpenADMS Node

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)

OpenADMS Node can either be used with CPython 3.6+ or PyPy3.5+.

The current development version of OpenADMS Node is 0.8 (code name “Hanoi”). For more information, see https://www.dabamos.de/.

Installation

Either CPython 3.6+ or PyPy3.5+ has to be installed. OpenADMS Node uses pipenv for dependency management and virtual environments. Make sure that pipenv is installed:

$ pip3 install -U pipenv

Download the latest release or clone the master branch with Git. Then, create a virtual environment with pipenv:

$ git clone https://github.com/dabamos/openadms-node
$ cd openadms-node/
$ pipenv lock
$ pipenv sync

Run

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 install.bat on Microsoft Windows or install the dependencies manually:

$ pipenv install Gooey

Execute pipenv run ./openadms-launcher.pyw to start the launcher.

Message Broker

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 the parameter --with-mqtt-broker.

Configuration

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 project website. See ./docs for how to build the documentation from source.

For a list of tested sensors, see https://dabamos.de/sensors/.

Running Tests

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

Licence

OpenADMS is licenced under BSD (2-Clause).